@oddessentials/repo-standards 5.1.0 → 5.2.0

package/README.md

@@ -106,6 +106,11 @@ The `version` field indicates schema compatibility:
 - `4` — Stable API contract with `getStandards()`, `getSchema()`, `STANDARDS_VERSION` exports; Node 22 LTS alignment.
 - `5` — Adds automated version-guard guidance for repositories using semantic-release; schema aligned to package major version 5.
 
+To keep `config/standards.json` in sync with semantic-release major bumps, use
+`scripts/sync-standards-version.cjs` during the semantic-release prepare step
+and commit the updated files. This updates the schema version and README
+references in one place.
+
 Consumers should ignore unknown fields for forward compatibility.
 
 ---

package/dist/config/standards.csharp-dotnet.azure-devops.json

@@ -235,6 +235,28 @@
           "verification": "Run the guard and confirm it fails when <Version> or <VersionPrefix> changes in props/csproj files."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".editorconfig"
+          ],
+          "exampleTools": [
+            "dotnet format",
+            "GitVersion"
+          ],
+          "notes": "Use .editorconfig to exclude auto-generated files from formatting. GitVersion may generate or modify files that shouldn't be reformatted. Add glob patterns for generated code directories (e.g., **/obj/**, **/bin/**).",
+          "verification": "Run 'dotnet format --verify-no-changes' and confirm generated files are excluded."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.csharp-dotnet.github-actions.json

@@ -235,6 +235,28 @@
           "verification": "Run the guard and confirm it fails when <Version> or <VersionPrefix> changes in props/csproj files."
         }
       },
+      {
+        "ciHints": {
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".editorconfig"
+          ],
+          "exampleTools": [
+            "dotnet format",
+            "GitVersion"
+          ],
+          "notes": "Use .editorconfig to exclude auto-generated files from formatting. GitVersion may generate or modify files that shouldn't be reformatted. Add glob patterns for generated code directories (e.g., **/obj/**, **/bin/**).",
+          "verification": "Run 'dotnet format --verify-no-changes' and confirm generated files are excluded."
+        }
+      },
       {
         "ciHints": {
           "github-actions": {

package/dist/config/standards.csharp-dotnet.json

@@ -262,6 +262,32 @@
           "verification": "Run the guard and confirm it fails when <Version> or <VersionPrefix> changes in props/csproj files."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          },
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".editorconfig"
+          ],
+          "exampleTools": [
+            "dotnet format",
+            "GitVersion"
+          ],
+          "notes": "Use .editorconfig to exclude auto-generated files from formatting. GitVersion may generate or modify files that shouldn't be reformatted. Add glob patterns for generated code directories (e.g., **/obj/**, **/bin/**).",
+          "verification": "Run 'dotnet format --verify-no-changes' and confirm generated files are excluded."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.go.azure-devops.json

@@ -229,6 +229,28 @@
           "verification": "Run the guard and confirm it fails when VERSION or version constants change outside release automation."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".golangci.yml"
+          ],
+          "exampleTools": [
+            "gofmt",
+            "goreleaser"
+          ],
+          "notes": "Go formatting (gofmt) only affects .go files, so CHANGELOG.md is automatically excluded. If using code generators, exclude generated directories in .golangci.yml skip-dirs.",
+          "verification": "Run 'gofmt -d .' and confirm generated code directories are excluded."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.go.github-actions.json

@@ -229,6 +229,28 @@
           "verification": "Run the guard and confirm it fails when VERSION or version constants change outside release automation."
         }
       },
+      {
+        "ciHints": {
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".golangci.yml"
+          ],
+          "exampleTools": [
+            "gofmt",
+            "goreleaser"
+          ],
+          "notes": "Go formatting (gofmt) only affects .go files, so CHANGELOG.md is automatically excluded. If using code generators, exclude generated directories in .golangci.yml skip-dirs.",
+          "verification": "Run 'gofmt -d .' and confirm generated code directories are excluded."
+        }
+      },
       {
         "ciHints": {
           "github-actions": {

package/dist/config/standards.go.json

@@ -256,6 +256,32 @@
           "verification": "Run the guard and confirm it fails when VERSION or version constants change outside release automation."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          },
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".golangci.yml"
+          ],
+          "exampleTools": [
+            "gofmt",
+            "goreleaser"
+          ],
+          "notes": "Go formatting (gofmt) only affects .go files, so CHANGELOG.md is automatically excluded. If using code generators, exclude generated directories in .golangci.yml skip-dirs.",
+          "verification": "Run 'gofmt -d .' and confirm generated code directories are excluded."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.json

@@ -1001,6 +1001,95 @@
           }
         }
       },
+      {
+        "appliesTo": {
+          "stacks": [
+            "typescript-js",
+            "csharp-dotnet",
+            "python",
+            "rust",
+            "go"
+          ]
+        },
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          },
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "enforcement": "required",
+        "executionStage": "pre-commit",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "severity": "error",
+        "stackHints": {
+          "csharp-dotnet": {
+            "exampleConfigFiles": [
+              ".editorconfig"
+            ],
+            "exampleTools": [
+              "dotnet format",
+              "GitVersion"
+            ],
+            "notes": "Use .editorconfig to exclude auto-generated files from formatting. GitVersion may generate or modify files that shouldn't be reformatted. Add glob patterns for generated code directories (e.g., **/obj/**, **/bin/**).",
+            "verification": "Run 'dotnet format --verify-no-changes' and confirm generated files are excluded."
+          },
+          "go": {
+            "exampleConfigFiles": [
+              ".golangci.yml"
+            ],
+            "exampleTools": [
+              "gofmt",
+              "goreleaser"
+            ],
+            "notes": "Go formatting (gofmt) only affects .go files, so CHANGELOG.md is automatically excluded. If using code generators, exclude generated directories in .golangci.yml skip-dirs.",
+            "verification": "Run 'gofmt -d .' and confirm generated code directories are excluded."
+          },
+          "python": {
+            "exampleConfigFiles": [
+              "pyproject.toml"
+            ],
+            "exampleTools": [
+              "black",
+              "ruff",
+              "bumpversion"
+            ],
+            "notes": "In pyproject.toml [tool.black] or [tool.ruff], add extend-exclude patterns for auto-generated files like CHANGELOG.md. Some versioning tools generate or modify files that should not be reformatted.",
+            "verification": "Run 'black --check .' or 'ruff format --check' and confirm generated files are excluded."
+          },
+          "rust": {
+            "exampleConfigFiles": [
+              "rustfmt.toml"
+            ],
+            "exampleTools": [
+              "rustfmt",
+              "cargo-release"
+            ],
+            "notes": "Rust rarely has auto-generated source files, but if using tools that generate Rust code, exclude those directories in rustfmt.toml. CHANGELOG.md isn't checked by rustfmt (it only checks .rs files).",
+            "verification": "Run 'cargo fmt --check' and confirm it passes after releases."
+          },
+          "typescript-js": {
+            "exampleConfigFiles": [
+              ".prettierignore",
+              ".releaserc.json"
+            ],
+            "exampleTools": [
+              "prettier",
+              "semantic-release"
+            ],
+            "notes": "Add CHANGELOG.md and package-lock.json to .prettierignore. These files are auto-generated by semantic-release and npm respectively. Without this exclusion, format:check fails after releases because the generated format differs from Prettier's expected style. Document each exclusion with a comment explaining it's auto-generated.",
+            "requiredFiles": [
+              ".prettierignore"
+            ],
+            "verification": "Run 'npm run format:check' and confirm CHANGELOG.md is not checked. Review .prettierignore and confirm auto-generated files are listed with explanatory comments."
+          }
+        }
+      },
       {
         "appliesTo": {
           "stacks": [

package/dist/config/standards.python.azure-devops.json

@@ -243,6 +243,29 @@
           "verification": "Run the guard and confirm it fails when version lines change in pyproject.toml or setup.cfg."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            "pyproject.toml"
+          ],
+          "exampleTools": [
+            "black",
+            "ruff",
+            "bumpversion"
+          ],
+          "notes": "In pyproject.toml [tool.black] or [tool.ruff], add extend-exclude patterns for auto-generated files like CHANGELOG.md. Some versioning tools generate or modify files that should not be reformatted.",
+          "verification": "Run 'black --check .' or 'ruff format --check' and confirm generated files are excluded."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.python.github-actions.json

@@ -243,6 +243,29 @@
           "verification": "Run the guard and confirm it fails when version lines change in pyproject.toml or setup.cfg."
         }
       },
+      {
+        "ciHints": {
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            "pyproject.toml"
+          ],
+          "exampleTools": [
+            "black",
+            "ruff",
+            "bumpversion"
+          ],
+          "notes": "In pyproject.toml [tool.black] or [tool.ruff], add extend-exclude patterns for auto-generated files like CHANGELOG.md. Some versioning tools generate or modify files that should not be reformatted.",
+          "verification": "Run 'black --check .' or 'ruff format --check' and confirm generated files are excluded."
+        }
+      },
       {
         "ciHints": {
           "github-actions": {

package/dist/config/standards.python.json

@@ -270,6 +270,33 @@
           "verification": "Run the guard and confirm it fails when version lines change in pyproject.toml or setup.cfg."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          },
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            "pyproject.toml"
+          ],
+          "exampleTools": [
+            "black",
+            "ruff",
+            "bumpversion"
+          ],
+          "notes": "In pyproject.toml [tool.black] or [tool.ruff], add extend-exclude patterns for auto-generated files like CHANGELOG.md. Some versioning tools generate or modify files that should not be reformatted.",
+          "verification": "Run 'black --check .' or 'ruff format --check' and confirm generated files are excluded."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.rust.azure-devops.json

@@ -234,6 +234,28 @@
           "verification": "Run the guard and confirm it fails when Cargo.toml version changes."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            "rustfmt.toml"
+          ],
+          "exampleTools": [
+            "rustfmt",
+            "cargo-release"
+          ],
+          "notes": "Rust rarely has auto-generated source files, but if using tools that generate Rust code, exclude those directories in rustfmt.toml. CHANGELOG.md isn't checked by rustfmt (it only checks .rs files).",
+          "verification": "Run 'cargo fmt --check' and confirm it passes after releases."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.rust.github-actions.json

@@ -234,6 +234,28 @@
           "verification": "Run the guard and confirm it fails when Cargo.toml version changes."
         }
       },
+      {
+        "ciHints": {
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            "rustfmt.toml"
+          ],
+          "exampleTools": [
+            "rustfmt",
+            "cargo-release"
+          ],
+          "notes": "Rust rarely has auto-generated source files, but if using tools that generate Rust code, exclude those directories in rustfmt.toml. CHANGELOG.md isn't checked by rustfmt (it only checks .rs files).",
+          "verification": "Run 'cargo fmt --check' and confirm it passes after releases."
+        }
+      },
       {
         "ciHints": {
           "github-actions": {

package/dist/config/standards.rust.json

@@ -261,6 +261,32 @@
           "verification": "Run the guard and confirm it fails when Cargo.toml version changes."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          },
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            "rustfmt.toml"
+          ],
+          "exampleTools": [
+            "rustfmt",
+            "cargo-release"
+          ],
+          "notes": "Rust rarely has auto-generated source files, but if using tools that generate Rust code, exclude those directories in rustfmt.toml. CHANGELOG.md isn't checked by rustfmt (it only checks .rs files).",
+          "verification": "Run 'cargo fmt --check' and confirm it passes after releases."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.typescript-js.azure-devops.json

@@ -256,6 +256,32 @@
           "verification": "Run the guard with the PR base ref (for example, origin/main) and confirm it fails when package.json version changes."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".prettierignore",
+            ".releaserc.json"
+          ],
+          "exampleTools": [
+            "prettier",
+            "semantic-release"
+          ],
+          "notes": "Add CHANGELOG.md and package-lock.json to .prettierignore. These files are auto-generated by semantic-release and npm respectively. Without this exclusion, format:check fails after releases because the generated format differs from Prettier's expected style. Document each exclusion with a comment explaining it's auto-generated.",
+          "requiredFiles": [
+            ".prettierignore"
+          ],
+          "verification": "Run 'npm run format:check' and confirm CHANGELOG.md is not checked. Review .prettierignore and confirm auto-generated files are listed with explanatory comments."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/config/standards.typescript-js.github-actions.json

@@ -256,6 +256,32 @@
           "verification": "Run the guard with the PR base ref (for example, origin/main) and confirm it fails when package.json version changes."
         }
       },
+      {
+        "ciHints": {
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".prettierignore",
+            ".releaserc.json"
+          ],
+          "exampleTools": [
+            "prettier",
+            "semantic-release"
+          ],
+          "notes": "Add CHANGELOG.md and package-lock.json to .prettierignore. These files are auto-generated by semantic-release and npm respectively. Without this exclusion, format:check fails after releases because the generated format differs from Prettier's expected style. Document each exclusion with a comment explaining it's auto-generated.",
+          "requiredFiles": [
+            ".prettierignore"
+          ],
+          "verification": "Run 'npm run format:check' and confirm CHANGELOG.md is not checked. Review .prettierignore and confirm auto-generated files are listed with explanatory comments."
+        }
+      },
       {
         "ciHints": {
           "github-actions": {

package/dist/config/standards.typescript-js.json

@@ -283,6 +283,36 @@
           "verification": "Run the guard with the PR base ref (for example, origin/main) and confirm it fails when package.json version changes."
         }
       },
+      {
+        "ciHints": {
+          "azure-devops": {
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts.",
+            "stage": "quality"
+          },
+          "github-actions": {
+            "job": "ci",
+            "notes": "Ensure format:check step uses ignore file that excludes release artifacts."
+          }
+        },
+        "description": "Exclude auto-generated release artifacts (CHANGELOG.md, package-lock.json, etc.) from code formatters to prevent CI failures. Release automation tools generate files that may not conform to your formatter's style, causing format checks to fail on subsequent CI runs.",
+        "id": "release-artifact-exclusion",
+        "label": "Release Artifact Formatter Exclusion",
+        "stack": {
+          "exampleConfigFiles": [
+            ".prettierignore",
+            ".releaserc.json"
+          ],
+          "exampleTools": [
+            "prettier",
+            "semantic-release"
+          ],
+          "notes": "Add CHANGELOG.md and package-lock.json to .prettierignore. These files are auto-generated by semantic-release and npm respectively. Without this exclusion, format:check fails after releases because the generated format differs from Prettier's expected style. Document each exclusion with a comment explaining it's auto-generated.",
+          "requiredFiles": [
+            ".prettierignore"
+          ],
+          "verification": "Run 'npm run format:check' and confirm CHANGELOG.md is not checked. Review .prettierignore and confirm auto-generated files are listed with explanatory comments."
+        }
+      },
       {
         "ciHints": {
           "azure-devops": {

package/dist/index.cjs

@@ -41,7 +41,7 @@ var import_node_fs = require("fs");
 var import_node_path = require("path");
 
 // src/version.ts
-var STANDARDS_VERSION = "5.0.0";
+var STANDARDS_VERSION = "5.1.0";
 var STANDARDS_SCHEMA_VERSION = 5;
 
 // src/index.ts

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../node_modules/tsup/assets/cjs_shims.js","../src/version.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { readFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport type {\n  MasterJson,\n  StackChecklistJson,\n  StackId,\n  CiSystem,\n} from \"./types.js\";\nimport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from \"./version.js\";\n\n// Re-export types for consumers\nexport type { MasterJson, StackChecklistJson, StackId, CiSystem };\n\n// Re-export version info (stable API contract)\nexport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };\n\n// ESM equivalent of __dirname\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Path to config directory:\n// - When running from src/ (dev/test): use repo root config/\n// - When running from dist/ (installed): use dist/config/\nconst isDevMode = __dirname.includes(\"src\");\nconst configDir = isDevMode\n  ? join(__dirname, \"..\", \"config\")\n  : join(__dirname, \"config\");\n\n/** Load the master spec JSON from the packaged dist directory */\nexport function loadMasterSpec(): MasterJson {\n  const filePath = join(configDir, \"standards.json\");\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** Load a stack-specific checklist (optionally filtered by CI system) */\nexport function loadBaseline(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  const suffix = ci ? `.${ci}` : \"\";\n  const file = `standards.${stack}${suffix}.json`;\n  const filePath = join(configDir, file);\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** List all supported stacks (derived from the master spec) */\nexport function listSupportedStacks(): readonly StackId[] {\n  const spec = loadMasterSpec();\n  return Object.keys(spec.stacks) as StackId[];\n}\n\n/** List all supported CI systems (derived from the master spec) */\nexport function listSupportedCiSystems(): readonly CiSystem[] {\n  const spec = loadMasterSpec();\n  return spec.ciSystems as CiSystem[];\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadBaseline - loads stack-specific standards checklist.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getStandards(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  return loadBaseline(stack, ci);\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadMasterSpec - loads the master standards schema.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getSchema(): MasterJson {\n  return loadMasterSpec();\n}\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * AUTO-GENERATED at build time by scripts/build.ts\n * DO NOT EDIT MANUALLY\n *\n * This module provides version information for the repo-standards package.\n * Consumers should import from here instead of package.json to avoid\n * ESM/CJS interop issues.\n */\n\nexport const STANDARDS_VERSION = '5.0.0';\nexport const STANDARDS_SCHEMA_VERSION = 5;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,IAAM,mBAAmB,MACvB,OAAO,aAAa,cAChB,IAAI,IAAI,QAAQ,UAAU,EAAE,EAAE,OAC7B,SAAS,iBAAiB,SAAS,cAAc,QAAQ,YAAY,MAAM,WAC1E,SAAS,cAAc,MACvB,IAAI,IAAI,WAAW,SAAS,OAAO,EAAE;AAEtC,IAAM,gBAAgC,iCAAiB;;;ADZ9D,sBAA8B;AAC9B,qBAA6B;AAC7B,uBAA8B;;;AEOvB,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;;;AFQxC,IAAMA,kBAAa,+BAAc,aAAe;AAChD,IAAM,gBAAY,0BAAQA,WAAU;AAKpC,IAAM,YAAY,UAAU,SAAS,KAAK;AAC1C,IAAM,YAAY,gBACd,uBAAK,WAAW,MAAM,QAAQ,QAC9B,uBAAK,WAAW,QAAQ;AAGrB,SAAS,iBAA6B;AAC3C,QAAM,eAAW,uBAAK,WAAW,gBAAgB;AACjD,SAAO,KAAK,UAAM,6BAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,aACd,OACA,IACoB;AACpB,QAAM,SAAS,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAM,OAAO,aAAa,KAAK,GAAG,MAAM;AACxC,QAAM,eAAW,uBAAK,WAAW,IAAI;AACrC,SAAO,KAAK,UAAM,6BAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,sBAA0C;AACxD,QAAM,OAAO,eAAe;AAC5B,SAAO,OAAO,KAAK,KAAK,MAAM;AAChC;AAGO,SAAS,yBAA8C;AAC5D,QAAM,OAAO,eAAe;AAC5B,SAAO,KAAK;AACd;AAOO,SAAS,aACd,OACA,IACoB;AACpB,SAAO,aAAa,OAAO,EAAE;AAC/B;AAOO,SAAS,YAAwB;AACtC,SAAO,eAAe;AACxB;","names":["__filename"]}
+{"version":3,"sources":["../src/index.ts","../node_modules/tsup/assets/cjs_shims.js","../src/version.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { readFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport type {\n  MasterJson,\n  StackChecklistJson,\n  StackId,\n  CiSystem,\n} from \"./types.js\";\nimport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from \"./version.js\";\n\n// Re-export types for consumers\nexport type { MasterJson, StackChecklistJson, StackId, CiSystem };\n\n// Re-export version info (stable API contract)\nexport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };\n\n// ESM equivalent of __dirname\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Path to config directory:\n// - When running from src/ (dev/test): use repo root config/\n// - When running from dist/ (installed): use dist/config/\nconst isDevMode = __dirname.includes(\"src\");\nconst configDir = isDevMode\n  ? join(__dirname, \"..\", \"config\")\n  : join(__dirname, \"config\");\n\n/** Load the master spec JSON from the packaged dist directory */\nexport function loadMasterSpec(): MasterJson {\n  const filePath = join(configDir, \"standards.json\");\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** Load a stack-specific checklist (optionally filtered by CI system) */\nexport function loadBaseline(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  const suffix = ci ? `.${ci}` : \"\";\n  const file = `standards.${stack}${suffix}.json`;\n  const filePath = join(configDir, file);\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** List all supported stacks (derived from the master spec) */\nexport function listSupportedStacks(): readonly StackId[] {\n  const spec = loadMasterSpec();\n  return Object.keys(spec.stacks) as StackId[];\n}\n\n/** List all supported CI systems (derived from the master spec) */\nexport function listSupportedCiSystems(): readonly CiSystem[] {\n  const spec = loadMasterSpec();\n  return spec.ciSystems as CiSystem[];\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadBaseline - loads stack-specific standards checklist.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getStandards(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  return loadBaseline(stack, ci);\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadMasterSpec - loads the master standards schema.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getSchema(): MasterJson {\n  return loadMasterSpec();\n}\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * AUTO-GENERATED at build time by scripts/build.ts\n * DO NOT EDIT MANUALLY\n *\n * This module provides version information for the repo-standards package.\n * Consumers should import from here instead of package.json to avoid\n * ESM/CJS interop issues.\n */\n\nexport const STANDARDS_VERSION = '5.1.0';\nexport const STANDARDS_SCHEMA_VERSION = 5;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACKA,IAAM,mBAAmB,MACvB,OAAO,aAAa,cAChB,IAAI,IAAI,QAAQ,UAAU,EAAE,EAAE,OAC7B,SAAS,iBAAiB,SAAS,cAAc,QAAQ,YAAY,MAAM,WAC1E,SAAS,cAAc,MACvB,IAAI,IAAI,WAAW,SAAS,OAAO,EAAE;AAEtC,IAAM,gBAAgC,iCAAiB;;;ADZ9D,sBAA8B;AAC9B,qBAA6B;AAC7B,uBAA8B;;;AEOvB,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;;;AFQxC,IAAMA,kBAAa,+BAAc,aAAe;AAChD,IAAM,gBAAY,0BAAQA,WAAU;AAKpC,IAAM,YAAY,UAAU,SAAS,KAAK;AAC1C,IAAM,YAAY,gBACd,uBAAK,WAAW,MAAM,QAAQ,QAC9B,uBAAK,WAAW,QAAQ;AAGrB,SAAS,iBAA6B;AAC3C,QAAM,eAAW,uBAAK,WAAW,gBAAgB;AACjD,SAAO,KAAK,UAAM,6BAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,aACd,OACA,IACoB;AACpB,QAAM,SAAS,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAM,OAAO,aAAa,KAAK,GAAG,MAAM;AACxC,QAAM,eAAW,uBAAK,WAAW,IAAI;AACrC,SAAO,KAAK,UAAM,6BAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,sBAA0C;AACxD,QAAM,OAAO,eAAe;AAC5B,SAAO,OAAO,KAAK,KAAK,MAAM;AAChC;AAGO,SAAS,yBAA8C;AAC5D,QAAM,OAAO,eAAe;AAC5B,SAAO,KAAK;AACd;AAOO,SAAS,aACd,OACA,IACoB;AACpB,SAAO,aAAa,OAAO,EAAE;AAC/B;AAOO,SAAS,YAAwB;AACtC,SAAO,eAAe;AACxB;","names":["__filename"]}

package/dist/index.d.cts

@@ -156,7 +156,7 @@ interface StackChecklistJson {
  * Consumers should import from here instead of package.json to avoid
  * ESM/CJS interop issues.
  */
-declare const STANDARDS_VERSION = "5.0.0";
+declare const STANDARDS_VERSION = "5.1.0";
 declare const STANDARDS_SCHEMA_VERSION = 5;
 
 /** Load the master spec JSON from the packaged dist directory */

package/dist/index.d.ts

@@ -156,7 +156,7 @@ interface StackChecklistJson {
  * Consumers should import from here instead of package.json to avoid
  * ESM/CJS interop issues.
  */
-declare const STANDARDS_VERSION = "5.0.0";
+declare const STANDARDS_VERSION = "5.1.0";
 declare const STANDARDS_SCHEMA_VERSION = 5;
 
 /** Load the master spec JSON from the packaged dist directory */

package/dist/index.js

@@ -4,7 +4,7 @@ import { readFileSync } from "fs";
 import { join, dirname } from "path";
 
 // src/version.ts
-var STANDARDS_VERSION = "5.0.0";
+var STANDARDS_VERSION = "5.1.0";
 var STANDARDS_SCHEMA_VERSION = 5;
 
 // src/index.ts

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/version.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { readFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport type {\n  MasterJson,\n  StackChecklistJson,\n  StackId,\n  CiSystem,\n} from \"./types.js\";\nimport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from \"./version.js\";\n\n// Re-export types for consumers\nexport type { MasterJson, StackChecklistJson, StackId, CiSystem };\n\n// Re-export version info (stable API contract)\nexport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };\n\n// ESM equivalent of __dirname\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Path to config directory:\n// - When running from src/ (dev/test): use repo root config/\n// - When running from dist/ (installed): use dist/config/\nconst isDevMode = __dirname.includes(\"src\");\nconst configDir = isDevMode\n  ? join(__dirname, \"..\", \"config\")\n  : join(__dirname, \"config\");\n\n/** Load the master spec JSON from the packaged dist directory */\nexport function loadMasterSpec(): MasterJson {\n  const filePath = join(configDir, \"standards.json\");\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** Load a stack-specific checklist (optionally filtered by CI system) */\nexport function loadBaseline(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  const suffix = ci ? `.${ci}` : \"\";\n  const file = `standards.${stack}${suffix}.json`;\n  const filePath = join(configDir, file);\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** List all supported stacks (derived from the master spec) */\nexport function listSupportedStacks(): readonly StackId[] {\n  const spec = loadMasterSpec();\n  return Object.keys(spec.stacks) as StackId[];\n}\n\n/** List all supported CI systems (derived from the master spec) */\nexport function listSupportedCiSystems(): readonly CiSystem[] {\n  const spec = loadMasterSpec();\n  return spec.ciSystems as CiSystem[];\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadBaseline - loads stack-specific standards checklist.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getStandards(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  return loadBaseline(stack, ci);\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadMasterSpec - loads the master standards schema.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getSchema(): MasterJson {\n  return loadMasterSpec();\n}\n","/**\n * AUTO-GENERATED at build time by scripts/build.ts\n * DO NOT EDIT MANUALLY\n *\n * This module provides version information for the repo-standards package.\n * Consumers should import from here instead of package.json to avoid\n * ESM/CJS interop issues.\n */\n\nexport const STANDARDS_VERSION = '5.0.0';\nexport const STANDARDS_SCHEMA_VERSION = 5;\n"],"mappings":";AAAA,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,MAAM,eAAe;;;ACOvB,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;;;ADQxC,IAAMA,cAAa,cAAc,YAAY,GAAG;AAChD,IAAMC,aAAY,QAAQD,WAAU;AAKpC,IAAM,YAAYC,WAAU,SAAS,KAAK;AAC1C,IAAM,YAAY,YACd,KAAKA,YAAW,MAAM,QAAQ,IAC9B,KAAKA,YAAW,QAAQ;AAGrB,SAAS,iBAA6B;AAC3C,QAAM,WAAW,KAAK,WAAW,gBAAgB;AACjD,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,aACd,OACA,IACoB;AACpB,QAAM,SAAS,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAM,OAAO,aAAa,KAAK,GAAG,MAAM;AACxC,QAAM,WAAW,KAAK,WAAW,IAAI;AACrC,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,sBAA0C;AACxD,QAAM,OAAO,eAAe;AAC5B,SAAO,OAAO,KAAK,KAAK,MAAM;AAChC;AAGO,SAAS,yBAA8C;AAC5D,QAAM,OAAO,eAAe;AAC5B,SAAO,KAAK;AACd;AAOO,SAAS,aACd,OACA,IACoB;AACpB,SAAO,aAAa,OAAO,EAAE;AAC/B;AAOO,SAAS,YAAwB;AACtC,SAAO,eAAe;AACxB;","names":["__filename","__dirname"]}
+{"version":3,"sources":["../src/index.ts","../src/version.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { readFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport type {\n  MasterJson,\n  StackChecklistJson,\n  StackId,\n  CiSystem,\n} from \"./types.js\";\nimport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from \"./version.js\";\n\n// Re-export types for consumers\nexport type { MasterJson, StackChecklistJson, StackId, CiSystem };\n\n// Re-export version info (stable API contract)\nexport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };\n\n// ESM equivalent of __dirname\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Path to config directory:\n// - When running from src/ (dev/test): use repo root config/\n// - When running from dist/ (installed): use dist/config/\nconst isDevMode = __dirname.includes(\"src\");\nconst configDir = isDevMode\n  ? join(__dirname, \"..\", \"config\")\n  : join(__dirname, \"config\");\n\n/** Load the master spec JSON from the packaged dist directory */\nexport function loadMasterSpec(): MasterJson {\n  const filePath = join(configDir, \"standards.json\");\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** Load a stack-specific checklist (optionally filtered by CI system) */\nexport function loadBaseline(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  const suffix = ci ? `.${ci}` : \"\";\n  const file = `standards.${stack}${suffix}.json`;\n  const filePath = join(configDir, file);\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** List all supported stacks (derived from the master spec) */\nexport function listSupportedStacks(): readonly StackId[] {\n  const spec = loadMasterSpec();\n  return Object.keys(spec.stacks) as StackId[];\n}\n\n/** List all supported CI systems (derived from the master spec) */\nexport function listSupportedCiSystems(): readonly CiSystem[] {\n  const spec = loadMasterSpec();\n  return spec.ciSystems as CiSystem[];\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadBaseline - loads stack-specific standards checklist.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getStandards(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  return loadBaseline(stack, ci);\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadMasterSpec - loads the master standards schema.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getSchema(): MasterJson {\n  return loadMasterSpec();\n}\n","/**\n * AUTO-GENERATED at build time by scripts/build.ts\n * DO NOT EDIT MANUALLY\n *\n * This module provides version information for the repo-standards package.\n * Consumers should import from here instead of package.json to avoid\n * ESM/CJS interop issues.\n */\n\nexport const STANDARDS_VERSION = '5.1.0';\nexport const STANDARDS_SCHEMA_VERSION = 5;\n"],"mappings":";AAAA,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,MAAM,eAAe;;;ACOvB,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;;;ADQxC,IAAMA,cAAa,cAAc,YAAY,GAAG;AAChD,IAAMC,aAAY,QAAQD,WAAU;AAKpC,IAAM,YAAYC,WAAU,SAAS,KAAK;AAC1C,IAAM,YAAY,YACd,KAAKA,YAAW,MAAM,QAAQ,IAC9B,KAAKA,YAAW,QAAQ;AAGrB,SAAS,iBAA6B;AAC3C,QAAM,WAAW,KAAK,WAAW,gBAAgB;AACjD,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,aACd,OACA,IACoB;AACpB,QAAM,SAAS,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAM,OAAO,aAAa,KAAK,GAAG,MAAM;AACxC,QAAM,WAAW,KAAK,WAAW,IAAI;AACrC,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,sBAA0C;AACxD,QAAM,OAAO,eAAe;AAC5B,SAAO,OAAO,KAAK,KAAK,MAAM;AAChC;AAGO,SAAS,yBAA8C;AAC5D,QAAM,OAAO,eAAe;AAC5B,SAAO,KAAK;AACd;AAOO,SAAS,aACd,OACA,IACoB;AACpB,SAAO,aAAa,OAAO,EAAE;AAC/B;AAOO,SAAS,YAAwB;AACtC,SAAO,eAAe;AACxB;","names":["__filename","__dirname"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oddessentials/repo-standards",
   "private": false,
-  "version": "5.1.0",
+  "version": "5.2.0",
   "description": "Standards and CI filtering utilities for multi-stack repository governance.",
   "type": "module",
   "bin": {

package/scripts/sync-standards-version.cjs

@@ -0,0 +1,72 @@
+/**
+ * Syncs standards.json schema version (and README references) to the provided
+ * semantic-release version. Intended for @semantic-release/exec prepare step.
+ */
+const fs = require("fs");
+const path = require("path");
+
+const rootDir = process.cwd();
+const pkgPath = path.join(rootDir, "package.json");
+const standardsPath = path.join(rootDir, "config", "standards.json");
+const readmePath = path.join(rootDir, "README.md");
+
+const providedVersion = process.argv[2];
+const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+const standards = JSON.parse(fs.readFileSync(standardsPath, "utf8"));
+
+const versionSource = providedVersion ?? pkg.version;
+const nextMajor = parseInt(versionSource.split(".")[0], 10);
+
+if (Number.isNaN(nextMajor)) {
+  console.error(
+    `[sync-standards] Unable to parse major version from ${versionSource}`,
+  );
+  process.exit(1);
+}
+
+if (nextMajor <= standards.version) {
+  console.log(
+    `[sync-standards] standards.json version ${standards.version} already >= ${nextMajor}; no update needed.`,
+  );
+  process.exit(0);
+}
+
+standards.version = nextMajor;
+fs.writeFileSync(standardsPath, JSON.stringify(standards, null, 2) + "\n");
+console.log(
+  `[sync-standards] Updated standards.json schema version to ${nextMajor}`,
+);
+
+if (!fs.existsSync(readmePath)) {
+  console.warn("[sync-standards] README.md not found; skipping README update");
+  process.exit(0);
+}
+
+let readme = fs.readFileSync(readmePath, "utf8");
+const currentLineRegex = /version\s+—\s+schema version \(currently `\d+`\)/;
+if (currentLineRegex.test(readme)) {
+  readme = readme.replace(
+    currentLineRegex,
+    `version — schema version (currently \`${nextMajor}\`)`,
+  );
+} else {
+  console.warn(
+    "[sync-standards] README current schema version line not found; skipping update",
+  );
+}
+
+const versionEntry = `- \`${nextMajor}\` — Schema version aligned to package major version ${nextMajor}.`;
+if (!readme.includes(`- \`${nextMajor}\` —`)) {
+  const anchor =
+    "Consumers should ignore unknown fields for forward compatibility.";
+  if (readme.includes(anchor)) {
+    readme = readme.replace(anchor, `${versionEntry}\n\n${anchor}`);
+  } else {
+    console.warn(
+      "[sync-standards] README schema version list anchor not found; skipping list update",
+    );
+  }
+}
+
+fs.writeFileSync(readmePath, readme);
+console.log("[sync-standards] Updated README schema version references");

package/scripts/validate-schema.ts

@@ -10,6 +10,7 @@ import path from "node:path";
 const rootDir = process.cwd();
 const configPath = path.join(rootDir, "config", "standards.json");
 const schemaPath = path.join(rootDir, "config", "standards.schema.json");
+const readmePath = path.join(rootDir, "README.md");
 
 interface ValidationResult {
   valid: boolean;
@@ -53,6 +54,42 @@ interface Config {
   };
 }
 
+/**
+ * Validate README schema version references match standards.json version
+ */
+function validateReadmeSchemaVersion(
+  config: Config,
+  readmeRaw?: string,
+): ValidationResult {
+  if (!readmeRaw) {
+    return {
+      valid: false,
+      errors: ["README.md not provided for version consistency check"],
+    };
+  }
+
+  const errors: string[] = [];
+  const actualVersion = config.version;
+
+  const currentMatch = readmeRaw.match(/version.*\(currently `(\d+)`\)/i);
+  if (!currentMatch) {
+    errors.push("README.md missing current schema version reference");
+  } else if (Number(currentMatch[1]) !== actualVersion) {
+    errors.push(
+      `README.md current schema version (${currentMatch[1]}) does not match standards.json (${actualVersion})`,
+    );
+  }
+
+  const listPattern = new RegExp(`-\\s*\`${actualVersion}\`\\s*—`);
+  if (!listPattern.test(readmeRaw)) {
+    errors.push(
+      `README.md schema version list does not include current version ${actualVersion}`,
+    );
+  }
+
+  return { valid: errors.length === 0, errors };
+}
+
 /**
  * Validate config against JSON Schema using Ajv
  */
@@ -254,6 +291,7 @@ export function normalizeConfig(config: unknown): string {
 export function validateStandardsConfig(
   configRaw: string,
   schemaRaw: string,
+  readmeRaw?: string,
 ): ValidationResult {
   let config: Config;
   let schema: unknown;
@@ -281,6 +319,7 @@ export function validateStandardsConfig(
     validateCiHintKeys(config),
     validateCoverageThreshold(config),
     validateExecutionStageCoverage(config),
+    validateReadmeSchemaVersion(config, readmeRaw),
   ];
 
   const allErrors = results.flatMap((r) => r.errors);
@@ -304,10 +343,16 @@ export function validateStandardsSchema(): void {
     process.exit(1);
   }
 
+  if (!fs.existsSync(readmePath)) {
+    console.error(`README file not found: ${readmePath}`);
+    process.exit(1);
+  }
+
   const configRaw = fs.readFileSync(configPath, "utf8");
   const schemaRaw = fs.readFileSync(schemaPath, "utf8");
+  const readmeRaw = fs.readFileSync(readmePath, "utf8");
 
-  const result = validateStandardsConfig(configRaw, schemaRaw);
+  const result = validateStandardsConfig(configRaw, schemaRaw, readmeRaw);
 
   if (!result.valid) {
     console.error("Schema validation failed:");
@@ -324,6 +369,7 @@ export function validateStandardsSchema(): void {
   console.log("✓ All ciHints keys are valid ciSystems");
   console.log("✓ Coverage threshold semantics are valid");
   console.log("✓ All items have valid executionStage");
+  console.log("✓ README schema version references are aligned");
 }
 
 // CLI entry point