Add project-scoped CodeGraph freshness proxy - #4
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
polaris_codegraph_exploreWhy
The previous stage flow could inspect CodeGraph freshness separately from the graph query. That allowed project identity, pending changes, response banners, and post-query drift to lose their mechanical connection. The project proxy makes freshness adjacent to graph content and forces stale or unknown results into navigation-only mode with auditable source/Git fallback.
User impact
Repositories that already contain
.codegraph/can use one Polaris tool for bounded relationship queries. CodeGraph remains optional and non-gating. Polaris does not install or initialize CodeGraph and does not manage its raw MCP registration, watcher, or daemon. Validation remains graph-free.Validation
python3 tests/run_tests.py— 201/201 passedpython3 -m unittest tests.test_codegraph -v— 92 passedpython3 -m unittest tests.test_core -v— 106 passedpython3 -m compileall -q polaris_cli.py scripts testspython3 scripts/materialize_task_layout.py && git diff --exit-codegit diff --check dev...HEADThe end-to-end test vendors Polaris into a disposable Git repository, launches the registered MCP command against an executable fake CodeGraph CLI, verifies the exact status/sync/explore/status call sequence and working directory, records the bundle as v3, confirms runtime ignore/hash binding, and proves project validation makes no CodeGraph call.