@oddessentials/repo-standards 1.2.1 → 2.0.1

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

@@ -35,6 +35,12 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //... --@io_bazel_rules_go//go/config:nogo=@//:nogo"
+            ],
+            "notes": "Use nogo for static analysis via rules_go. Configure nogo target with desired analyzers."
+          },
           "exampleConfigFiles": [
             ".golangci.yml",
             ".golangci.yaml"
@@ -64,6 +70,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "rules_go go_test targets wrap 'go test' with Bazel's caching and hermeticity."
+          },
           "exampleConfigFiles": [
             "go.mod"
           ],
@@ -157,6 +169,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "rules_go supports coverage via bazel coverage. Use --combined_report=lcov for aggregated output."
+          },
           "exampleConfigFiles": [
             "go.mod"
           ],
@@ -178,6 +196,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "rules_go go_binary and go_test targets provide hermetic builds and tests."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -197,6 +222,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel run @go_sdk//:bin/gofmt -- -d ."
+            ],
+            "notes": "Run gofmt via the Bazel-managed Go SDK for hermetic formatting checks."
+          },
           "exampleConfigFiles": [],
           "exampleTools": [
             "gofmt",
@@ -238,6 +269,12 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //..."
+            ],
+            "notes": "Go type checking is inherent to compilation. bazel build with rules_go enforces type safety."
+          },
           "exampleConfigFiles": [
             "go.mod"
           ],
@@ -515,6 +552,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.go.json

@@ -41,6 +41,12 @@
         "id": "linting",
         "label": "Linting",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //... --@io_bazel_rules_go//go/config:nogo=@//:nogo"
+            ],
+            "notes": "Use nogo for static analysis via rules_go. Configure nogo target with desired analyzers."
+          },
           "exampleConfigFiles": [
             ".golangci.yml",
             ".golangci.yaml"
@@ -73,6 +79,12 @@
         "id": "unit-test-runner",
         "label": "Unit Test Runner",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel test //..."
+            ],
+            "notes": "rules_go go_test targets wrap 'go test' with Bazel's caching and hermeticity."
+          },
           "exampleConfigFiles": [
             "go.mod"
           ],
@@ -178,6 +190,12 @@
         "id": "unit-test-reporter",
         "label": "Unit Test Reporter / Coverage",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel coverage //..."
+            ],
+            "notes": "rules_go supports coverage via bazel coverage. Use --combined_report=lcov for aggregated output."
+          },
           "exampleConfigFiles": [
             "go.mod"
           ],
@@ -202,6 +220,13 @@
         "id": "ci-quality-gates",
         "label": "CI Quality Gates",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //...",
+              "bazel test //..."
+            ],
+            "notes": "rules_go go_binary and go_test targets provide hermetic builds and tests."
+          },
           "exampleConfigFiles": [
             ".github/workflows/*",
             "azure-pipelines.yml"
@@ -224,6 +249,12 @@
         "id": "code-formatter",
         "label": "Code Formatter",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel run @go_sdk//:bin/gofmt -- -d ."
+            ],
+            "notes": "Run gofmt via the Bazel-managed Go SDK for hermetic formatting checks."
+          },
           "exampleConfigFiles": [],
           "exampleTools": [
             "gofmt",
@@ -271,6 +302,12 @@
         "id": "type-checking",
         "label": "Type Checking",
         "stack": {
+          "bazelHints": {
+            "commands": [
+              "bazel build //..."
+            ],
+            "notes": "Go type checking is inherent to compilation. bazel build with rules_go enforces type safety."
+          },
           "exampleConfigFiles": [
             "go.mod"
           ],
@@ -584,6 +621,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