Skip to content

Derive project-specific architecture graphs - #282

Merged
forhappy merged 1 commit into
mainfrom
codex/harden-architecture-graph
Aug 23, 2026
Merged

Derive project-specific architecture graphs#282
forhappy merged 1 commit into
mainfrom
codex/harden-architecture-graph

Conversation

@forhappy

Copy link
Copy Markdown
Contributor

Summary

  • Replace fixed call-flow labels with the Rust-owned compass.viewer.architecture/1 projection contract.
  • Classify Production, Test, Generated, Vendor, and Documentation sources before grouping; add deterministic project-derived names, stable memberships, typed relationship lenses, exact omission accounting, quality diagnostics, and bounded overlays.
  • Cut the shared viewer and VS Code architecture surfaces over to the contract, add the full group directory and responsive behavior, and document the design, compatibility change, migration, qualification, and screenshots.

Qualification

  • Self-analysis: 150,127 nodes, 244,152 relationships, 8,086 communities.
  • Final architecture payload: 126,697,704 bytes, below the 128 MiB bound.
  • Quality: good; 34,039 Production nodes; largest group 15.51%; zero fallback names, zero Unknown nodes, and no automatic Other group.
  • 2,651 retained groups; 15 of 42 owner groups shown, with 27 exactly accounted for in the directory; 29 visible routes.

Verification

  • cargo fmt --all -- --check
  • cargo clippy --workspace --lib --bins --locked -- -D warnings
  • cargo test --workspace --lib --bins --locked
  • cargo test -p compass-cli --test compass_product --locked
  • cargo test -p compass-cli --test viewer_export_cli --locked
  • ./scripts/qualify_code_graph_v1.sh --fixtures-only
  • sh scripts/check_product_boundary.sh
  • npm run typecheck:js
  • npm run test:js (209 viewer, 141 VS Code, 88 browser tests)
  • node scripts/check_viewer_assets.mjs
  • python3 scripts/qualify_architecture_graph.py

Known unrelated failure

The pre-existing compass-files build_guard_publishes_one_complete_snapshot_at_a_time integration test remains red because it expects graph-one and observes graph-two. The workspace lib/bin baseline and all architecture-specific gates pass.

Replace the fixed call-flow projection with a source-scoped, typed architecture contract. Add deterministic project naming, relation lenses, quality diagnostics, exact omissions, bounded directory data, overlays, and shared viewer/VS Code rendering.
@forhappy
forhappy merged commit 03a0e4d into main Aug 23, 2026
14 checks passed
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