Skip to content

Relax server schema gate to unblock sync with older YAOS plugin schemas - #60

Merged
kavinsood merged 1 commit into
mainfrom
copilot/fix-min-schema-version
Jul 8, 2026
Merged

Relax server schema gate to unblock sync with older YAOS plugin schemas#60
kavinsood merged 1 commit into
mainfrom
copilot/fix-min-schema-version

Conversation

Copilot AI commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Current server deployments can reject sync with This server requires schema version 3 or newer even when clients are on the latest plugin release path, creating a hard compatibility stop. This change redefines server schema compatibility as a bounded range instead of an exact minimum-only gate.

  • Schema compatibility change

    • Lowered SERVER_MIN_SCHEMA_VERSION from 3 to 1 in server/src/version.ts.
    • Kept SERVER_MAX_SCHEMA_VERSION at 3 so the server still advertises the current schema ceiling.
  • Guard logic updated for range semantics

    • Updated scripts/guard-schema-version.mjs to enforce:
      • SERVER_MAX_SCHEMA_VERSION === EXPECTED_SCHEMA_VERSION
      • SERVER_MIN_SCHEMA_VERSION <= EXPECTED_SCHEMA_VERSION
      • SERVER_MIN_SCHEMA_VERSION <= SERVER_MAX_SCHEMA_VERSION
    • This preserves drift protection while allowing intentional backward-compatible windows.
  • Engineering docs aligned with runtime behavior

    • Updated docs/engineering/schema-version-guard.md to reflect range-based validation and new pass/fail expectations.
// server/src/version.ts
export const SERVER_MIN_SCHEMA_VERSION = 1;
export const SERVER_MAX_SCHEMA_VERSION = 3;

Copilot AI changed the title Fix unable-to-sync schema compatibility check Relax server schema gate to unblock sync with older YAOS plugin schemas Jul 8, 2026
Copilot AI requested a review from kavinsood July 8, 2026 08:40
@kavinsood
kavinsood marked this pull request as ready for review July 8, 2026 09:37
@kavinsood
kavinsood merged commit e3d73d6 into main Jul 8, 2026
2 checks passed
@kavinsood
kavinsood deleted the copilot/fix-min-schema-version branch July 8, 2026 09:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants