@oddessentials/repo-standards 2.0.0 → 2.1.0

package/README.md

@@ -68,7 +68,7 @@ The master spec includes a `meta` block that defines system-wide expectations:
 
 ## Structure of `config/standards.json`
 
-- `version` — schema version (currently `2`)
+- `version` — schema version (currently `3`)
 - `meta` — global rules and migration policy
 - `ciSystems` — supported CI platforms
   _(currently `github-actions`, `azure-devops`)_
@@ -102,6 +102,7 @@ The `version` field indicates schema compatibility:
 
 - `1` — Original schema
 - `2` — Adds `bazelHints`, `meta.bazelIntegration` for Bazel support, `anyOfFiles`, `pinningNotes`
+- `3` — Enforces strict validation with `additionalProperties: false`. Adds enforcement/severity levels, ratio-based coverage thresholds, Rust/Go stacks, and refactors `bazelIntegration` → `executorHints.bazel`
 
 Consumers should ignore unknown fields for forward compatibility.
 
@@ -217,7 +218,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

@@ -39,7 +39,7 @@
             "commands": [
               "bazel build //... --aspects=@rules_dotnet//dotnet:analyzers.bzl%analyzer_aspect"
             ],
-            "notes": "Use rules_dotnet analyzer aspects for Roslyn-based linting in Bazel."
+            "notes": "Example only; actual targets are repo-defined. Use rules_dotnet analyzer aspects for Roslyn-based linting."
           },
           "exampleConfigFiles": [
             ".editorconfig",
@@ -56,9 +56,6 @@
           "requiredFiles": [
             ".editorconfig"
           ],
-          "requiredScripts": [
-            "lint"
-          ],
           "verification": ".editorconfig must exist to drive the .NET formatting and analysis tooling."
         }
       },
@@ -275,7 +272,7 @@
             "commands": [
               "bazel build //..."
             ],
-            "notes": "C# type errors surface during bazel build with rules_dotnet. No separate typecheck step needed."
+            "notes": "Example only; actual targets are repo-defined. C# type errors surface during bazel build with rules_dotnet."
           },
           "exampleConfigFiles": [
             ".editorconfig",
@@ -292,9 +289,6 @@
           "requiredFiles": [
             ".editorconfig"
           ],
-          "requiredScripts": [
-            "typecheck"
-          ],
           "verification": ".editorconfig must exist; Directory.Build.props is optional for shared build configuration."
         }
       },
@@ -567,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.",
@@ -668,5 +666,5 @@
   },
   "stack": "csharp-dotnet",
   "stackLabel": "C# / .NET",
-  "version": 2
+  "version": 3
 }

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

@@ -39,7 +39,7 @@
             "commands": [
               "bazel build //... --aspects=@rules_dotnet//dotnet:analyzers.bzl%analyzer_aspect"
             ],
-            "notes": "Use rules_dotnet analyzer aspects for Roslyn-based linting in Bazel."
+            "notes": "Example only; actual targets are repo-defined. Use rules_dotnet analyzer aspects for Roslyn-based linting."
           },
           "exampleConfigFiles": [
             ".editorconfig",
@@ -56,9 +56,6 @@
           "requiredFiles": [
             ".editorconfig"
           ],
-          "requiredScripts": [
-            "lint"
-          ],
           "verification": ".editorconfig must exist to drive the .NET formatting and analysis tooling."
         }
       },
@@ -275,7 +272,7 @@
             "commands": [
               "bazel build //..."
             ],
-            "notes": "C# type errors surface during bazel build with rules_dotnet. No separate typecheck step needed."
+            "notes": "Example only; actual targets are repo-defined. C# type errors surface during bazel build with rules_dotnet."
           },
           "exampleConfigFiles": [
             ".editorconfig",
@@ -292,9 +289,6 @@
           "requiredFiles": [
             ".editorconfig"
           ],
-          "requiredScripts": [
-            "typecheck"
-          ],
           "verification": ".editorconfig must exist; Directory.Build.props is optional for shared build configuration."
         }
       },
@@ -567,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.",
@@ -668,5 +666,5 @@
   },
   "stack": "csharp-dotnet",
   "stackLabel": "C# / .NET",
-  "version": 2
+  "version": 3
 }

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

@@ -45,7 +45,7 @@
             "commands": [
               "bazel build //... --aspects=@rules_dotnet//dotnet:analyzers.bzl%analyzer_aspect"
             ],
-            "notes": "Use rules_dotnet analyzer aspects for Roslyn-based linting in Bazel."
+            "notes": "Example only; actual targets are repo-defined. Use rules_dotnet analyzer aspects for Roslyn-based linting."
           },
           "exampleConfigFiles": [
             ".editorconfig",
@@ -62,9 +62,6 @@
           "requiredFiles": [
             ".editorconfig"
           ],
-          "requiredScripts": [
-            "lint"
-          ],
           "verification": ".editorconfig must exist to drive the .NET formatting and analysis tooling."
         }
       },
@@ -308,7 +305,7 @@
             "commands": [
               "bazel build //..."
             ],
-            "notes": "C# type errors surface during bazel build with rules_dotnet. No separate typecheck step needed."
+            "notes": "Example only; actual targets are repo-defined. C# type errors surface during bazel build with rules_dotnet."
           },
           "exampleConfigFiles": [
             ".editorconfig",
@@ -325,9 +322,6 @@
           "requiredFiles": [
             ".editorconfig"
           ],
-          "requiredScripts": [
-            "typecheck"
-          ],
           "verification": ".editorconfig must exist; Directory.Build.props is optional for shared build configuration."
         }
       },
@@ -636,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.",
@@ -737,5 +735,5 @@
   },
   "stack": "csharp-dotnet",
   "stackLabel": "C# / .NET",
-  "version": 2
+  "version": 3
 }

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.",
@@ -653,5 +657,5 @@
   },
   "stack": "go",
   "stackLabel": "Go",
-  "version": 2
+  "version": 3
 }

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.",
@@ -653,5 +657,5 @@
   },
   "stack": "go",
   "stackLabel": "Go",
-  "version": 2
+  "version": 3
 }