Skip to content

feat(worktrees): add exact agent routing and classified navigation - #431

Merged
styler-ai merged 88 commits into
mainfrom
feat/430-worktree-atlas-continuity
Aug 16, 2026
Merged

feat(worktrees): add exact agent routing and classified navigation#431
styler-ai merged 88 commits into
mainfrom
feat/430-worktree-atlas-continuity

Conversation

@styler-ai

@styler-ai styler-ai commented Aug 1, 2026

Copy link
Copy Markdown
Owner

Summary

  • add bounded structural discovery and a control-atlas registry for primary, linked, bare/common-manager, moved, missing, malformed, and arbitrary-location Git worktrees without creating, moving, switching, or deleting Git state
  • add MCP atlas_worktree_list, atlas_worktree_add, and atlas_worktree_remove, plus short worktree alias routing across normal tools while preserving mutually exclusive legacy project_path routing
  • let atlas_init(worktree=...) hydrate an absent target from a compatible complete control atlas through a private SQLite candidate, assign target identity, clear non-transferable state, reconcile current branch/dirty bytes, and fall back visibly to ordinary init
  • keep one writable schema-18 atlas per checkout, preserve worktree-local graph/purpose/generation ownership, and expose explicit bounded alias-labelled read-only federation
  • aggregate native main, alias-routed, synchronized active, and retained retired worktree token savings in the control checkout while keeping exact-worktree detail and the current token TUI layout
  • complete classified documentation/source navigation, the version-matched v0.4.5-rc1 skill, README/docs/architecture/release notes, browser-native issue links, GitHub Pages entry points, and the joint hosted cross-platform holistic E2E

Boundaries

Validation

  • cargo run --locked -p projectatlas-lints --bin cargo-projectatlas-lints -- strict-strings
  • cargo fmt --all --check
  • cargo check --workspace --all-targets --all-features --locked
  • cargo clippy --workspace --all-targets --all-features --locked -- -D warnings
  • cargo deny --locked --all-features check -D warnings
  • cargo test --workspace --all-features --locked
  • cargo test --locked -p projectatlas-cli --test e2e holistic_agent_worktree_flow_keeps_local_atlases_isolated_across_cli_watch_and_mcp -- --exact --include-ignored --nocapture
  • cargo test --doc --workspace --all-features --locked
  • RUSTDOCFLAGS="-D warnings" cargo doc --workspace --no-deps --all-features --locked
  • 52 benchmark-harness unit tests, release helper self-tests, skill validation, strict OpenSpec validation, full live IssueOps parity, locked Mermaid parse/audit, rendered diagram inspection, and desktop/mobile Pages QA
  • candidate scan plus lint --report-untracked --purpose-level low
  • repository pre-push hook

Closes #430
Closes #440

@styler-ai styler-ai modified the milestones: v0.5.0-00, v0.4.4-00 Aug 1, 2026
@styler-ai styler-ai changed the title docs(openspec): specify worktree atlas continuity feat(worktrees): add exact agent routing and classified navigation Aug 15, 2026
@styler-ai
styler-ai marked this pull request as ready for review August 15, 2026 10:32
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c325958545

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-fs/src/worktree.rs
Comment thread crates/projectatlas-fs/src/worktree.rs Outdated
Comment thread crates/projectatlas-fs/src/worktree.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head 22dd9f8. Please perform a fresh whole-PR review of architecture and ownership, the complete Rust and SQLite pattern fit, OpenSpec fulfillment, positive/negative/failure/concurrency/compatibility/platform coverage, intended-scale performance, and the v0.4.5-rc1 boundaries. Do not rely on earlier-head review conclusions.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 22dd9f82cf

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-cli/src/runtime.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head 867ad9d. Please review the complete PR at this exact head for correctness, regressions, architecture and ownership, the applicable Rust and SQLite pattern fit, full OpenSpec task fulfillment, positive/negative/failure/concurrency/compatibility coverage, cross-platform behavior, intended-scale performance, agent-first workflow boundaries, and RC1 readiness. Keep any partially implemented or partially proven task incomplete.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 867ad9db71

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-cli/src/mcp.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head 348a3e4. Please perform a fresh whole-PR review for correctness, regressions, architecture and ownership, the applicable Rust and SQLite pattern fit, complete OpenSpec fulfillment, positive/negative/failure/concurrency/compatibility coverage, cross-platform behavior, intended-scale performance, agent-first boundaries, and v0.4.5-rc1 readiness. This head removes the failed-initial-sync fallback registration; keep any partially proven task incomplete.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 348a3e4f39

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-cli/src/runtime.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head 14be3dd. Please perform a fresh whole-PR review for correctness, regressions, architecture and ownership, the applicable Rust and SQLite pattern fit, complete OpenSpec fulfillment, positive/negative/failure/concurrency/compatibility coverage, cross-platform behavior, intended-scale performance, agent-first boundaries, and v0.4.5-rc1 readiness. This head makes final aggregate synchronization reject unobserved unbound-to-bound catalog transitions; keep any partially proven task incomplete.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 14be3dddac

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-cli/src/mcp.rs
Comment thread crates/projectatlas-cli/src/runtime.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head 8c437bf. Please perform a fresh whole-PR review for correctness, regressions, architecture and ownership, the complete applicable Rust and SQLite pattern fit, OpenSpec fulfillment, positive/negative/failure/concurrency/compatibility coverage, all four hosted platforms, intended-scale performance, agent-first workflow boundaries, and v0.4.5-rc1 readiness. This head makes failed local snapshot export non-committing and keeps the complete repository aggregate read under validated catalog writer exclusion while leaving benchmark enrichment outside that lock. Treat all prior-head reviews as historical and keep partially implemented or partially proven tasks incomplete.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8c437bf1b1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-cli/src/mcp.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head def3318. Please perform a fresh whole-PR review for correctness, regressions, architecture and ownership, the complete applicable Rust and SQLite pattern fit, OpenSpec fulfillment, positive/negative/failure/concurrency/compatibility coverage, all four hosted platforms, intended-scale performance, agent-first workflow boundaries, and v0.4.5-rc1 readiness. This head makes every deferred first binding atomically accept the local aggregate snapshot or remain unbound, with database and MCP rollback regressions and synchronized lifecycle documentation. Treat prior-head reviews as historical and keep partially implemented or partially proven tasks incomplete.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: def3318612

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-cli/src/runtime.rs
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head d3720e6b8e84726cc3a88da64d417d315f0016ae. Please perform a fresh whole-PR review for correctness, regressions, architecture and ownership, the complete applicable Rust and SQLite pattern fit, OpenSpec fulfillment, positive/negative/failure/concurrency/compatibility coverage, all four hosted platforms, intended-scale performance, agent-first workflow boundaries, and v0.4.5-rc1 readiness. This head revalidates the database currently published at every deferred binding path against the exact captured usage snapshot and adds a deterministic same-lifecycle database-replacement regression. The complete local pre-push release gate and the separately invoked holistic worktree E2E pass. Treat prior-head reviews as historical and keep partially implemented or partially proven tasks incomplete.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: d3720e6b8e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread crates/projectatlas-fs/src/worktree.rs
Comment thread crates/projectatlas-cli/src/runtime.rs Outdated
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review

Please review exact head 436b8325e582075e67998420bfeb1283e876d525 holistically for correctness, regressions, security, Rust/SQLite pattern fit, lifecycle and concurrency safety, intended-scale performance, complete #430/#440 OpenSpec fulfillment, and owning unit/integration/E2E/platform coverage. Pay particular attention to the single-inventory plus exact O(1) lifecycle revalidation path and the four-platform holistic agent/worktree E2E. Report every actionable finding; react with approval only if none remain.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 436b8325e5

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/workflows/ci.yml
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head 280610e. Please review the complete PR against #430, #440, and #448 release contracts, including Windows fail-fast CI behavior.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep them coming!

Reviewed commit: 280610e5e0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Synchronize the completed #430 and #440 OpenSpec release gates after exact-head review and four-platform holistic proof.
@styler-ai

Copy link
Copy Markdown
Owner Author

@codex review exact head ab104af. This is a checklist-only synchronization after the complete source head passed fresh review, the full local gate, and the named holistic E2E on Linux, Windows, macOS Intel, and macOS ARM. Please verify the final OpenSpec/issue completion state and report any remaining actionable issue before merge.

@chatgpt-codex-connector

Copy link
Copy Markdown

Codex Review: Didn't find any major issues. Keep them coming!

Reviewed commit: ab104afea2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

@styler-ai
styler-ai merged commit 03d7d50 into main Aug 16, 2026
5 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.

feat(graph): connect classified documentation and source files feat(worktrees): add exact agent routing and structural status

1 participant