@oddessentials/repo-standards 1.2.1 → 2.0.0

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

@@ -35,6 +35,13 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //...:ruff_test",
+              "bazel run //tools/lint:ruff -- check ."
+            ],
+            "notes": "Use rules_python with ruff wrapped as py_test or a custom run target."
+          },
           "exampleConfigFiles": [
             "pyproject.toml",
             ".flake8"
@@ -67,6 +74,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "Use rules_python py_test for pytest-based tests. Tests are hermetically isolated."
+          },
           "exampleConfigFiles": [
             "pytest.ini",
             "pyproject.toml"
@@ -166,6 +179,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "Use rules_python py_test with coverage instrumentation. Combine with --combined_report=lcov."
+          },
           "exampleConfigFiles": [
             "pytest.ini",
             "pyproject.toml"
@@ -189,6 +208,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "Bazel py_binary and py_test targets replace traditional Python tooling."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -208,6 +234,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel run //tools/format:black -- --check ."
+            ],
+            "notes": "Wrap black as a py_binary run target for format checking."
+          },
           "exampleConfigFiles": [
             "pyproject.toml"
           ],
@@ -248,6 +280,13 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //...:mypy_test",
+              "bazel run //tools/typecheck:mypy"
+            ],
+            "notes": "Wrap mypy as a py_test or run target for Bazel-based type checking."
+          },
           "exampleConfigFiles": [
             "mypy.ini",
             "pyproject.toml"
@@ -546,6 +585,43 @@
     "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

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

@@ -35,6 +35,13 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //...:ruff_test",
+              "bazel run //tools/lint:ruff -- check ."
+            ],
+            "notes": "Use rules_python with ruff wrapped as py_test or a custom run target."
+          },
           "exampleConfigFiles": [
             "pyproject.toml",
             ".flake8"
@@ -67,6 +74,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "Use rules_python py_test for pytest-based tests. Tests are hermetically isolated."
+          },
           "exampleConfigFiles": [
             "pytest.ini",
             "pyproject.toml"
@@ -166,6 +179,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "Use rules_python py_test with coverage instrumentation. Combine with --combined_report=lcov."
+          },
           "exampleConfigFiles": [
             "pytest.ini",
             "pyproject.toml"
@@ -189,6 +208,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "Bazel py_binary and py_test targets replace traditional Python tooling."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -208,6 +234,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel run //tools/format:black -- --check ."
+            ],
+            "notes": "Wrap black as a py_binary run target for format checking."
+          },
           "exampleConfigFiles": [
             "pyproject.toml"
           ],
@@ -248,6 +280,13 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //...:mypy_test",
+              "bazel run //tools/typecheck:mypy"
+            ],
+            "notes": "Wrap mypy as a py_test or run target for Bazel-based type checking."
+          },
           "exampleConfigFiles": [
             "mypy.ini",
             "pyproject.toml"
@@ -546,6 +585,43 @@
     "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

package/dist/config/standards.python.json

@@ -41,6 +41,13 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //...:ruff_test",
+              "bazel run //tools/lint:ruff -- check ."
+            ],
+            "notes": "Use rules_python with ruff wrapped as py_test or a custom run target."
+          },
           "exampleConfigFiles": [
             "pyproject.toml",
             ".flake8"
@@ -76,6 +83,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "Use rules_python py_test for pytest-based tests. Tests are hermetically isolated."
+          },
           "exampleConfigFiles": [
             "pytest.ini",
             "pyproject.toml"
@@ -187,6 +200,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "Use rules_python py_test with coverage instrumentation. Combine with --combined_report=lcov."
+          },
           "exampleConfigFiles": [
             "pytest.ini",
             "pyproject.toml"
@@ -213,6 +232,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "Bazel py_binary and py_test targets replace traditional Python tooling."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -235,6 +261,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel run //tools/format:black -- --check ."
+            ],
+            "notes": "Wrap black as a py_binary run target for format checking."
+          },
           "exampleConfigFiles": [
             "pyproject.toml"
           ],
@@ -281,6 +313,13 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //...:mypy_test",
+              "bazel run //tools/typecheck:mypy"
+            ],
+            "notes": "Wrap mypy as a py_test or run target for Bazel-based type checking."
+          },
           "exampleConfigFiles": [
             "mypy.ini",
             "pyproject.toml"
@@ -615,6 +654,43 @@
     "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

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

@@ -35,6 +35,12 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //... --aspects=@rules_rust//rust:defs.bzl%clippy_aspect --output_groups=clippy_checks"
+            ],
+            "notes": "rules_rust includes clippy_aspect for Bazel-native Clippy linting on all Rust targets."
+          },
           "exampleConfigFiles": [
             "clippy.toml",
             ".clippy.toml"
@@ -64,6 +70,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "rules_rust rust_test targets run cargo test under Bazel's hermetic environment."
+          },
           "exampleConfigFiles": [
             "Cargo.toml"
           ],
@@ -159,6 +171,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "Bazel coverage with rules_rust requires LLVM instrumentation. May need additional toolchain configuration."
+          },
           "exampleConfigFiles": [
             "Cargo.toml"
           ],
@@ -181,6 +199,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "rules_rust provides rust_library, rust_test, and clippy_aspect for complete CI."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -200,6 +225,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //... --aspects=@rules_rust//rust:defs.bzl%rustfmt_aspect --output_groups=rustfmt_checks"
+            ],
+            "notes": "rules_rust includes rustfmt_aspect for Bazel-native format checking."
+          },
           "exampleConfigFiles": [
             "rustfmt.toml",
             ".rustfmt.toml"
@@ -242,6 +273,12 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //..."
+            ],
+            "notes": "Rust type checking is inherent to compilation. bazel build with rules_rust enforces type safety."
+          },
           "exampleConfigFiles": [
             "Cargo.toml"
           ],
@@ -524,6 +561,43 @@
     "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

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

@@ -35,6 +35,12 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //... --aspects=@rules_rust//rust:defs.bzl%clippy_aspect --output_groups=clippy_checks"
+            ],
+            "notes": "rules_rust includes clippy_aspect for Bazel-native Clippy linting on all Rust targets."
+          },
           "exampleConfigFiles": [
             "clippy.toml",
             ".clippy.toml"
@@ -64,6 +70,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "rules_rust rust_test targets run cargo test under Bazel's hermetic environment."
+          },
           "exampleConfigFiles": [
             "Cargo.toml"
           ],
@@ -159,6 +171,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "Bazel coverage with rules_rust requires LLVM instrumentation. May need additional toolchain configuration."
+          },
           "exampleConfigFiles": [
             "Cargo.toml"
           ],
@@ -181,6 +199,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "rules_rust provides rust_library, rust_test, and clippy_aspect for complete CI."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -200,6 +225,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //... --aspects=@rules_rust//rust:defs.bzl%rustfmt_aspect --output_groups=rustfmt_checks"
+            ],
+            "notes": "rules_rust includes rustfmt_aspect for Bazel-native format checking."
+          },
           "exampleConfigFiles": [
             "rustfmt.toml",
             ".rustfmt.toml"
@@ -242,6 +273,12 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //..."
+            ],
+            "notes": "Rust type checking is inherent to compilation. bazel build with rules_rust enforces type safety."
+          },
           "exampleConfigFiles": [
             "Cargo.toml"
           ],
@@ -524,6 +561,43 @@
     "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