docs(bazel): documentation, observability, and #1 close-readiness evidence (#3)

[DecisionNerd]

Summary

• Add bazel.md covering build: migrate CI builds and tests to Bazel with Blacksmith caching #1 Documentation topics (architecture/ownership, install, extending targets, packaging handoff, cache troubleshooting, Cargo rollback, CI/release).
• Add bazel-migration-ac-evidence.md mapping every build: migrate CI builds and tests to Bazel with Blacksmith caching #1 AC to M2 child PR/SHA/artifact evidence, plus security/supply-chain confirmation and observability paths.
• Wire indexes (engineering README, contributing, ARCHITECTURE, OBSERVABILITY, release-process) and refresh stale bazel: cut over CI Gate, retain rollback, retire Cargo sticky disks #4/bazel: Blacksmith remote cache enablement and cold/warm performance gates #5 “next” notes. Explicitly exclude mobile bindings as M2 deliverables.

Closes #3

Test plan

• Review AC evidence map covers all build: migrate CI builds and tests to Bazel with Blacksmith caching #1 checkboxes with child PR/SHA pointers
• Confirm Bazel Bootstrap job has no publish/OIDC secrets (secrets. absent)
• Confirm .bazelrc / docs forbid in-repo --remote_cache
• Docs-classified CI + CI Gate green on this PR head
• After merge, verify bazel: documentation, observability, and #1 close-readiness evidence #3 closed and fill bazel: documentation, observability, and #1 close-readiness evidence #3 merge SHA in evidence map if needed via follow-up comment

Made with Cursor

---

^{Need help on this PR? Tag @codesmith-bot with what you need. Autofix is disabled.}

Note

Add Bazel developer guide and #1 close-readiness evidence map to docs

• Adds bazel.md as the primary developer guide covering installation, local commands, extending the build graph, cache metrics, CI/release runbooks, and security constraints.
• Adds bazel-migration-ac-evidence.md as a checked-in close-readiness map tying build: migrate CI builds and tests to Bazel with Blacksmith caching #1 acceptance criteria to child issues, PRs, and merge SHAs.
• Updates OBSERVABILITY.md with Bazel CI correctness and remote-cache health as observable outcomes, including dashboard/alert guidance.
• Updates release-process.md to explicitly state that Bazel owns CI Rust compilation and that publish credentials must never appear in cacheable Bazel actions.
• Cross-links all existing migration docs (bootstrap, cutover, parity, orchestration) and ARCHITECTURE.md to the new guides, replacing outdated 'Next' sections.

^{Macroscope summarized 35e31b4.}

[coderabbitai]

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (11)

• docs/development/bazel-bootstrap.md is excluded by !**/*.md, !**/docs/**
• docs/development/bazel-migration-ac-evidence.md is excluded by !**/*.md, !**/docs/**
• docs/development/bazel-migration-cutover.md is excluded by !**/*.md, !**/docs/**
• docs/development/bazel-migration-orchestration.md is excluded by !**/*.md, !**/docs/**
• docs/development/bazel-migration-parity.md is excluded by !**/*.md, !**/docs/**
• docs/development/bazel.md is excluded by !**/*.md, !**/docs/**
• docs/development/contributing.md is excluded by !**/*.md, !**/docs/**
• docs/development/release-process.md is excluded by !**/*.md, !**/docs/**
• docs/engineering/ARCHITECTURE.md is excluded by !**/*.md, !**/docs/**
• docs/engineering/OBSERVABILITY.md is excluded by !**/*.md, !**/docs/**
• docs/engineering/README.md is excluded by !**/*.md, !**/docs/**

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 57b18df3-a85f-4e24-a7bb-4edaadd8920a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}