Skip to content

Add agent governance and root version tracking - #25

Merged
Bhagat-Atul merged 1 commit into
benevolentbandwidth:mainfrom
Bhagat-Atul:main
Jul 13, 2026
Merged

Add agent governance and root version tracking#25
Bhagat-Atul merged 1 commit into
benevolentbandwidth:mainfrom
Bhagat-Atul:main

Conversation

@Bhagat-Atul

Copy link
Copy Markdown
Collaborator

Merge: agent governance, decision tracking, and repo-level versioning

This merge adds the repo handoff layer needed for future agents and contributors to work from the same product, architecture, privacy, and
release decisions.

Key changes:

  • Adds AGENTS.md and Cursor rules with non-negotiable Zest guardrails.
  • Adds documentation/13-agent-brief.md as the short first-read context.
  • Adds documentation/14-decision-log.md as the summarized decision register.
  • Requires every future change to update relevant documentation summaries, durable architecture decisions, and version records when applicable.
  • Moves module version tracking to root module_versions.json.
  • Adds root VERSION_LOG.md for release/module history.
  • Updates Gradle source-tree verification to enforce root module_versions.json, VERSION_LOG.md, and documentation consistency.
  • Updates backend /version packaging/loading so Cloud Run still exposes the manifest.
  • Updates Cloud Run deploy docs to build from repo root context.
  • Tracks documentation and agent-context as versioned modules.
  • Bumps coordinated release/app/backend version to 1.0.2.

Validation:

  • Backend contract tests passed.
  • Android source-tree/version guard passed.
  • Android debug Kotlin compile passed.
  • git diff whitespace check passed.

Operational note:
Future backend deploys should use the repository root as the Cloud Run source/build context so the root Dockerfile and root & module_versions.json are included in the image.

  - Add AGENTS.md and Cursor rules so future agents start from the same repo context
  - Add agent brief and decision log docs for summarized architecture handoff
  - Require every change to update relevant summaries, durable decisions, and version records
  - Move module version manifest source of truth from backend/ to repo root
  - Add root VERSION_LOG.md for release and module-version history
  - Add documentation and agent-context modules to version tracking
  - Update Android source-tree guard to validate root module_versions.json and VERSION_LOG.md
  - Update backend /version loading to support root manifest locally and packaged manifest in Cloud Run
  - Add root Dockerfile and update backend deploy docs to use repo root build context
  - Bump coordinated release/app/backend version to 1.0.2

  Verification:
  - .venv/bin/python -m pytest backend/tests/test_app.py backend/tests/test_benchmark_analyze.py -q
  - ./gradlew :app:verifySourceTreeForBuild
  - ./gradlew :app:compileDebugKotlin
  - git diff --check
@Bhagat-Atul
Bhagat-Atul merged commit 991cff4 into benevolentbandwidth:main Jul 13, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant