@oddessentials/repo-standards 2.0.1 → 3.0.0

package/README.md

@@ -6,7 +6,7 @@
 
 **@oddessentials/repo-standards**
 
-This package defines a **single, authoritative JSON specification** for repository quality standards across multiple stacks (TypeScript/JS, C#/.NET, Python), plus deterministic tooling to generate **stack- and CI-specific views**.
+This package defines a **single, authoritative JSON specification** for repository quality standards across multiple stacks (TypeScript/JS, C#/.NET, Python, Rust, and Go), plus deterministic tooling to generate **stack- and CI-specific views**.
 
 It is designed to be:
 
@@ -101,7 +101,7 @@ Each checklist item includes:
 The `version` field indicates schema compatibility:
 
 - `1` — Original schema
-- `2` — Adds `bazelHints`, `meta.bazelIntegration` for Bazel support, `anyOfFiles`, `pinningNotes`
+- `2` — Adds `bazelHints`, `meta.executorHints.bazel` for Bazel support, `anyOfFiles`, `pinningNotes`, enforcement/severity levels, ratio-based coverage thresholds, Rust/Go stacks. Enforces strict validation with `additionalProperties: false`.
 
 Consumers should ignore unknown fields for forward compatibility.
 
@@ -217,7 +217,7 @@ build:ci --test_output=errors
 To disable Bazel hints for a repo that contains Bazel files but uses npm for quality checks:
 
 ```json
-{ "meta": { "bazelIntegration": { "enabled": false } } }
+{ "meta": { "executorHints": { "bazel": { "enabled": false } } } }
 ```
 
 ---

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

@@ -561,48 +561,52 @@
     "azure-devops"
   ],
   "meta": {
-    "bazelIntegration": {
-      "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
-      "ciContract": {
-        "configFlag": "--config=ci (define in .bazelrc)",
-        "deterministicFlags": [
-          "--nokeep_going",
-          "--test_output=errors"
-        ],
-        "remoteCache": "Optional; not required for CI",
-        "versionPinning": "Use .bazelversion file for Bazelisk"
-      },
-      "description": "Bazel build executor support for quality checks. All hints are ADVISORY—stack-native commands remain the default execution path.",
-      "detectionRules": {
-        "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
-        "optionalMarkers": [
-          ".bazelrc",
-          ".bazelversion"
-        ],
-        "rootMarkers": [
-          "MODULE.bazel",
-          "WORKSPACE.bazel",
-          "WORKSPACE"
-        ]
-      },
-      "optOut": {
-        "configPath": "meta.bazelIntegration.enabled",
-        "description": "Set meta.bazelIntegration.enabled = false in repo config to disable Bazel hints"
-      },
-      "targetConventions": {
-        "build": "bazel build //...",
-        "coverage": "bazel coverage //...",
-        "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
-        "format": "bazel run //tools/format:check",
-        "lint": "//tools/lint:lint or bazel test //... with lint aspects",
-        "test": "bazel test //..."
-      }
-    },
     "complexityChecks": {
       "description": "When supported by the stack, run cyclomatic complexity or similar metrics in CI as a warning-only check initially.",
       "enabledByDefault": true
     },
+    "coverageThresholdDescription": "Expressed as a ratio (0-1), e.g., 0.8 = 80% coverage. Must be between 0 and 1.",
+    "coverageThresholdUnit": "ratio",
     "defaultCoverageThreshold": 0.8,
+    "executorHints": {
+      "bazel": {
+        "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
+        "ciContract": {
+          "configFlag": "--config=ci (define in .bazelrc)",
+          "deterministicFlags": [
+            "--nokeep_going",
+            "--test_output=errors"
+          ],
+          "remoteCache": "Optional; not required for CI",
+          "versionPinning": "Use .bazelversion file for Bazelisk"
+        },
+        "detectionRules": {
+          "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
+          "optionalMarkers": [
+            ".bazelrc",
+            ".bazelversion"
+          ],
+          "rootMarkers": [
+            "MODULE.bazel",
+            "WORKSPACE.bazel",
+            "WORKSPACE"
+          ]
+        },
+        "optOut": {
+          "configPath": "meta.executorHints.bazel.enabled",
+          "description": "Set meta.executorHints.bazel.enabled = false in repo config to disable Bazel hints"
+        },
+        "targetConventions": {
+          "build": "bazel build //...",
+          "coverage": "bazel coverage //...",
+          "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
+          "format": "bazel run //tools/format:check",
+          "lint": "//tools/lint:lint or bazel test //... with lint aspects",
+          "test": "bazel test //..."
+        }
+      },
+      "description": "Advisory execution substrate hints. Bazel is the first supported executor; future monorepo executors may follow the same pattern."
+    },
     "migrationGuide": [
       {
         "description": "Start by adding pre-commit hooks and core formatting/linting so developers get fast feedback without touching CI.",

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

@@ -561,48 +561,52 @@
     "github-actions"
   ],
   "meta": {
-    "bazelIntegration": {
-      "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
-      "ciContract": {
-        "configFlag": "--config=ci (define in .bazelrc)",
-        "deterministicFlags": [
-          "--nokeep_going",
-          "--test_output=errors"
-        ],
-        "remoteCache": "Optional; not required for CI",
-        "versionPinning": "Use .bazelversion file for Bazelisk"
-      },
-      "description": "Bazel build executor support for quality checks. All hints are ADVISORY—stack-native commands remain the default execution path.",
-      "detectionRules": {
-        "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
-        "optionalMarkers": [
-          ".bazelrc",
-          ".bazelversion"
-        ],
-        "rootMarkers": [
-          "MODULE.bazel",
-          "WORKSPACE.bazel",
-          "WORKSPACE"
-        ]
-      },
-      "optOut": {
-        "configPath": "meta.bazelIntegration.enabled",
-        "description": "Set meta.bazelIntegration.enabled = false in repo config to disable Bazel hints"
-      },
-      "targetConventions": {
-        "build": "bazel build //...",
-        "coverage": "bazel coverage //...",
-        "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
-        "format": "bazel run //tools/format:check",
-        "lint": "//tools/lint:lint or bazel test //... with lint aspects",
-        "test": "bazel test //..."
-      }
-    },
     "complexityChecks": {
       "description": "When supported by the stack, run cyclomatic complexity or similar metrics in CI as a warning-only check initially.",
       "enabledByDefault": true
     },
+    "coverageThresholdDescription": "Expressed as a ratio (0-1), e.g., 0.8 = 80% coverage. Must be between 0 and 1.",
+    "coverageThresholdUnit": "ratio",
     "defaultCoverageThreshold": 0.8,
+    "executorHints": {
+      "bazel": {
+        "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
+        "ciContract": {
+          "configFlag": "--config=ci (define in .bazelrc)",
+          "deterministicFlags": [
+            "--nokeep_going",
+            "--test_output=errors"
+          ],
+          "remoteCache": "Optional; not required for CI",
+          "versionPinning": "Use .bazelversion file for Bazelisk"
+        },
+        "detectionRules": {
+          "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
+          "optionalMarkers": [
+            ".bazelrc",
+            ".bazelversion"
+          ],
+          "rootMarkers": [
+            "MODULE.bazel",
+            "WORKSPACE.bazel",
+            "WORKSPACE"
+          ]
+        },
+        "optOut": {
+          "configPath": "meta.executorHints.bazel.enabled",
+          "description": "Set meta.executorHints.bazel.enabled = false in repo config to disable Bazel hints"
+        },
+        "targetConventions": {
+          "build": "bazel build //...",
+          "coverage": "bazel coverage //...",
+          "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
+          "format": "bazel run //tools/format:check",
+          "lint": "//tools/lint:lint or bazel test //... with lint aspects",
+          "test": "bazel test //..."
+        }
+      },
+      "description": "Advisory execution substrate hints. Bazel is the first supported executor; future monorepo executors may follow the same pattern."
+    },
     "migrationGuide": [
       {
         "description": "Start by adding pre-commit hooks and core formatting/linting so developers get fast feedback without touching CI.",

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

@@ -630,48 +630,52 @@
     "github-actions"
   ],
   "meta": {
-    "bazelIntegration": {
-      "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
-      "ciContract": {
-        "configFlag": "--config=ci (define in .bazelrc)",
-        "deterministicFlags": [
-          "--nokeep_going",
-          "--test_output=errors"
-        ],
-        "remoteCache": "Optional; not required for CI",
-        "versionPinning": "Use .bazelversion file for Bazelisk"
-      },
-      "description": "Bazel build executor support for quality checks. All hints are ADVISORY—stack-native commands remain the default execution path.",
-      "detectionRules": {
-        "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
-        "optionalMarkers": [
-          ".bazelrc",
-          ".bazelversion"
-        ],
-        "rootMarkers": [
-          "MODULE.bazel",
-          "WORKSPACE.bazel",
-          "WORKSPACE"
-        ]
-      },
-      "optOut": {
-        "configPath": "meta.bazelIntegration.enabled",
-        "description": "Set meta.bazelIntegration.enabled = false in repo config to disable Bazel hints"
-      },
-      "targetConventions": {
-        "build": "bazel build //...",
-        "coverage": "bazel coverage //...",
-        "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
-        "format": "bazel run //tools/format:check",
-        "lint": "//tools/lint:lint or bazel test //... with lint aspects",
-        "test": "bazel test //..."
-      }
-    },
     "complexityChecks": {
       "description": "When supported by the stack, run cyclomatic complexity or similar metrics in CI as a warning-only check initially.",
       "enabledByDefault": true
     },
+    "coverageThresholdDescription": "Expressed as a ratio (0-1), e.g., 0.8 = 80% coverage. Must be between 0 and 1.",
+    "coverageThresholdUnit": "ratio",
     "defaultCoverageThreshold": 0.8,
+    "executorHints": {
+      "bazel": {
+        "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
+        "ciContract": {
+          "configFlag": "--config=ci (define in .bazelrc)",
+          "deterministicFlags": [
+            "--nokeep_going",
+            "--test_output=errors"
+          ],
+          "remoteCache": "Optional; not required for CI",
+          "versionPinning": "Use .bazelversion file for Bazelisk"
+        },
+        "detectionRules": {
+          "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
+          "optionalMarkers": [
+            ".bazelrc",
+            ".bazelversion"
+          ],
+          "rootMarkers": [
+            "MODULE.bazel",
+            "WORKSPACE.bazel",
+            "WORKSPACE"
+          ]
+        },
+        "optOut": {
+          "configPath": "meta.executorHints.bazel.enabled",
+          "description": "Set meta.executorHints.bazel.enabled = false in repo config to disable Bazel hints"
+        },
+        "targetConventions": {
+          "build": "bazel build //...",
+          "coverage": "bazel coverage //...",
+          "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
+          "format": "bazel run //tools/format:check",
+          "lint": "//tools/lint:lint or bazel test //... with lint aspects",
+          "test": "bazel test //..."
+        }
+      },
+      "description": "Advisory execution substrate hints. Bazel is the first supported executor; future monorepo executors may follow the same pattern."
+    },
     "migrationGuide": [
       {
         "description": "Start by adding pre-commit hooks and core formatting/linting so developers get fast feedback without touching CI.",

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

@@ -552,48 +552,52 @@
     "azure-devops"
   ],
   "meta": {
-    "bazelIntegration": {
-      "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
-      "ciContract": {
-        "configFlag": "--config=ci (define in .bazelrc)",
-        "deterministicFlags": [
-          "--nokeep_going",
-          "--test_output=errors"
-        ],
-        "remoteCache": "Optional; not required for CI",
-        "versionPinning": "Use .bazelversion file for Bazelisk"
-      },
-      "description": "Bazel build executor support for quality checks. All hints are ADVISORY—stack-native commands remain the default execution path.",
-      "detectionRules": {
-        "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
-        "optionalMarkers": [
-          ".bazelrc",
-          ".bazelversion"
-        ],
-        "rootMarkers": [
-          "MODULE.bazel",
-          "WORKSPACE.bazel",
-          "WORKSPACE"
-        ]
-      },
-      "optOut": {
-        "configPath": "meta.bazelIntegration.enabled",
-        "description": "Set meta.bazelIntegration.enabled = false in repo config to disable Bazel hints"
-      },
-      "targetConventions": {
-        "build": "bazel build //...",
-        "coverage": "bazel coverage //...",
-        "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
-        "format": "bazel run //tools/format:check",
-        "lint": "//tools/lint:lint or bazel test //... with lint aspects",
-        "test": "bazel test //..."
-      }
-    },
     "complexityChecks": {
       "description": "When supported by the stack, run cyclomatic complexity or similar metrics in CI as a warning-only check initially.",
       "enabledByDefault": true
     },
+    "coverageThresholdDescription": "Expressed as a ratio (0-1), e.g., 0.8 = 80% coverage. Must be between 0 and 1.",
+    "coverageThresholdUnit": "ratio",
     "defaultCoverageThreshold": 0.8,
+    "executorHints": {
+      "bazel": {
+        "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
+        "ciContract": {
+          "configFlag": "--config=ci (define in .bazelrc)",
+          "deterministicFlags": [
+            "--nokeep_going",
+            "--test_output=errors"
+          ],
+          "remoteCache": "Optional; not required for CI",
+          "versionPinning": "Use .bazelversion file for Bazelisk"
+        },
+        "detectionRules": {
+          "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
+          "optionalMarkers": [
+            ".bazelrc",
+            ".bazelversion"
+          ],
+          "rootMarkers": [
+            "MODULE.bazel",
+            "WORKSPACE.bazel",
+            "WORKSPACE"
+          ]
+        },
+        "optOut": {
+          "configPath": "meta.executorHints.bazel.enabled",
+          "description": "Set meta.executorHints.bazel.enabled = false in repo config to disable Bazel hints"
+        },
+        "targetConventions": {
+          "build": "bazel build //...",
+          "coverage": "bazel coverage //...",
+          "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
+          "format": "bazel run //tools/format:check",
+          "lint": "//tools/lint:lint or bazel test //... with lint aspects",
+          "test": "bazel test //..."
+        }
+      },
+      "description": "Advisory execution substrate hints. Bazel is the first supported executor; future monorepo executors may follow the same pattern."
+    },
     "migrationGuide": [
       {
         "description": "Start by adding pre-commit hooks and core formatting/linting so developers get fast feedback without touching CI.",

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

@@ -552,48 +552,52 @@
     "github-actions"
   ],
   "meta": {
-    "bazelIntegration": {
-      "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
-      "ciContract": {
-        "configFlag": "--config=ci (define in .bazelrc)",
-        "deterministicFlags": [
-          "--nokeep_going",
-          "--test_output=errors"
-        ],
-        "remoteCache": "Optional; not required for CI",
-        "versionPinning": "Use .bazelversion file for Bazelisk"
-      },
-      "description": "Bazel build executor support for quality checks. All hints are ADVISORY—stack-native commands remain the default execution path.",
-      "detectionRules": {
-        "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
-        "optionalMarkers": [
-          ".bazelrc",
-          ".bazelversion"
-        ],
-        "rootMarkers": [
-          "MODULE.bazel",
-          "WORKSPACE.bazel",
-          "WORKSPACE"
-        ]
-      },
-      "optOut": {
-        "configPath": "meta.bazelIntegration.enabled",
-        "description": "Set meta.bazelIntegration.enabled = false in repo config to disable Bazel hints"
-      },
-      "targetConventions": {
-        "build": "bazel build //...",
-        "coverage": "bazel coverage //...",
-        "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
-        "format": "bazel run //tools/format:check",
-        "lint": "//tools/lint:lint or bazel test //... with lint aspects",
-        "test": "bazel test //..."
-      }
-    },
     "complexityChecks": {
       "description": "When supported by the stack, run cyclomatic complexity or similar metrics in CI as a warning-only check initially.",
       "enabledByDefault": true
     },
+    "coverageThresholdDescription": "Expressed as a ratio (0-1), e.g., 0.8 = 80% coverage. Must be between 0 and 1.",
+    "coverageThresholdUnit": "ratio",
     "defaultCoverageThreshold": 0.8,
+    "executorHints": {
+      "bazel": {
+        "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
+        "ciContract": {
+          "configFlag": "--config=ci (define in .bazelrc)",
+          "deterministicFlags": [
+            "--nokeep_going",
+            "--test_output=errors"
+          ],
+          "remoteCache": "Optional; not required for CI",
+          "versionPinning": "Use .bazelversion file for Bazelisk"
+        },
+        "detectionRules": {
+          "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
+          "optionalMarkers": [
+            ".bazelrc",
+            ".bazelversion"
+          ],
+          "rootMarkers": [
+            "MODULE.bazel",
+            "WORKSPACE.bazel",
+            "WORKSPACE"
+          ]
+        },
+        "optOut": {
+          "configPath": "meta.executorHints.bazel.enabled",
+          "description": "Set meta.executorHints.bazel.enabled = false in repo config to disable Bazel hints"
+        },
+        "targetConventions": {
+          "build": "bazel build //...",
+          "coverage": "bazel coverage //...",
+          "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
+          "format": "bazel run //tools/format:check",
+          "lint": "//tools/lint:lint or bazel test //... with lint aspects",
+          "test": "bazel test //..."
+        }
+      },
+      "description": "Advisory execution substrate hints. Bazel is the first supported executor; future monorepo executors may follow the same pattern."
+    },
     "migrationGuide": [
       {
         "description": "Start by adding pre-commit hooks and core formatting/linting so developers get fast feedback without touching CI.",

package/dist/config/standards.go.json

@@ -621,48 +621,52 @@
     "github-actions"
   ],
   "meta": {
-    "bazelIntegration": {
-      "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
-      "ciContract": {
-        "configFlag": "--config=ci (define in .bazelrc)",
-        "deterministicFlags": [
-          "--nokeep_going",
-          "--test_output=errors"
-        ],
-        "remoteCache": "Optional; not required for CI",
-        "versionPinning": "Use .bazelversion file for Bazelisk"
-      },
-      "description": "Bazel build executor support for quality checks. All hints are ADVISORY—stack-native commands remain the default execution path.",
-      "detectionRules": {
-        "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
-        "optionalMarkers": [
-          ".bazelrc",
-          ".bazelversion"
-        ],
-        "rootMarkers": [
-          "MODULE.bazel",
-          "WORKSPACE.bazel",
-          "WORKSPACE"
-        ]
-      },
-      "optOut": {
-        "configPath": "meta.bazelIntegration.enabled",
-        "description": "Set meta.bazelIntegration.enabled = false in repo config to disable Bazel hints"
-      },
-      "targetConventions": {
-        "build": "bazel build //...",
-        "coverage": "bazel coverage //...",
-        "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
-        "format": "bazel run //tools/format:check",
-        "lint": "//tools/lint:lint or bazel test //... with lint aspects",
-        "test": "bazel test //..."
-      }
-    },
     "complexityChecks": {
       "description": "When supported by the stack, run cyclomatic complexity or similar metrics in CI as a warning-only check initially.",
       "enabledByDefault": true
     },
+    "coverageThresholdDescription": "Expressed as a ratio (0-1), e.g., 0.8 = 80% coverage. Must be between 0 and 1.",
+    "coverageThresholdUnit": "ratio",
     "defaultCoverageThreshold": 0.8,
+    "executorHints": {
+      "bazel": {
+        "advisoryNotice": "bazelHints are suggestions, not required execution paths. Consumers should prefer stack-native commands unless explicitly adopting Bazel.",
+        "ciContract": {
+          "configFlag": "--config=ci (define in .bazelrc)",
+          "deterministicFlags": [
+            "--nokeep_going",
+            "--test_output=errors"
+          ],
+          "remoteCache": "Optional; not required for CI",
+          "versionPinning": "Use .bazelversion file for Bazelisk"
+        },
+        "detectionRules": {
+          "notes": "Detection uses repo-root markers only. Nested BUILD files do not trigger Bazel mode.",
+          "optionalMarkers": [
+            ".bazelrc",
+            ".bazelversion"
+          ],
+          "rootMarkers": [
+            "MODULE.bazel",
+            "WORKSPACE.bazel",
+            "WORKSPACE"
+          ]
+        },
+        "optOut": {
+          "configPath": "meta.executorHints.bazel.enabled",
+          "description": "Set meta.executorHints.bazel.enabled = false in repo config to disable Bazel hints"
+        },
+        "targetConventions": {
+          "build": "bazel build //...",
+          "coverage": "bazel coverage //...",
+          "description": "Recommended target naming (not assumed to exist). These are illustrative patterns; actual targets are repo-defined.",
+          "format": "bazel run //tools/format:check",
+          "lint": "//tools/lint:lint or bazel test //... with lint aspects",
+          "test": "bazel test //..."
+        }
+      },
+      "description": "Advisory execution substrate hints. Bazel is the first supported executor; future monorepo executors may follow the same pattern."
+    },
     "migrationGuide": [
       {
         "description": "Start by adding pre-commit hooks and core formatting/linting so developers get fast feedback without touching CI.",