Summary

Audit of all roadmap items under docs/src/content/docs/reference/roadmap/ against the current code surfaced two classes of drift: stale status/content on active roadmap pages, and fully shipped items that still had standalone roadmap pages.

What changed:

• Updated the roadmap overview Completed list for shipped-but-unlisted behavior (jackin eject, jackin prune, jackin config trust, per-workspace git_pull_on_entry, macOS keep-awake) and corrected the workspace subcommand wording.
• Reconciled active roadmap items whose remaining-work text no longer matched the code: config versioning, GitHub CLI auth strategy, per-mount references from dependent items, and the codebase-readability program row for the project-structure refresh.
• Finished the residual PROJECT_STRUCTURE.md work by adding build.rs and the missing workflow entries.
• Retired fully shipped roadmap pages instead of keeping Resolved pages: env var interpolation, per-mount isolation, split workspace config files, and project-structure update.
• Repointed inbound roadmap links to canonical docs: role manifest interpolation, Workspaces per-mount isolation, Configuration per-workspace files, Codebase Map, and PROJECT_STRUCTURE.md.
• Removed the Resolved sidebar group and updated the roadmap overview text to say shipped work belongs in Completed plus canonical docs.

The audit also checked the remaining Open / Proposed / Deferred / Partially implemented roadmap items for stealth-shipped work. I did not find another item that was fully implemented and still eligible for retirement.

Hard-rule callout

Roadmap freshness and retirement rule applied. Fully resolved items were removed from the roadmap sidebar/pages, inbound links were audited and repointed, and canonical docs now carry the shipped behavior. No host-side behavior or schema changes.

What's deferred (follow-up PRs)

None for the completed-item retirement pass in this PR.

Verify locally

Checkout

Paste this first to bypass the tirith paste scanner for the rest of the session:

export TIRITH=0

Then paste the checkout block:

mkdir -p "$HOME/Projects/jackin-project/test"
cd "$HOME/Projects/jackin-project/test"

if [ ! -d jackin/.git ]; then
  git clone https://github.com/jackin-project/jackin.git
fi

cd jackin
mise trust
git fetch -f origin docs/roadmap-audit-fixes:refs/remotes/origin/docs/roadmap-audit-fixes
git checkout -B docs/roadmap-audit-fixes refs/remotes/origin/docs/roadmap-audit-fixes

Docs gates

cd docs
bun install --frozen-lockfile
bun run build
bun run check:repo-links
bunx tsc --noEmit
bun test
bun run dev

Astro serves at http://localhost:4321/. Walk the changed pages:

http://localhost:4321/reference/roadmap/
Check the Completed list now links shipped env interpolation, per-mount isolation, split workspace config files, and project-structure refresh to canonical docs rather than retired roadmap pages. Confirm there is no Resolved sidebar group.

http://localhost:4321/reference/roadmap/config-versioning-migration/
The role-manifest example TOML block should show version = "v1alpha3".

http://localhost:4321/reference/roadmap/github-cli-auth-strategy/
Remaining Work item 1 should reference the existing jackin config auth set subcommand and link to src/cli/config.rs.

http://localhost:4321/reference/roadmap/codebase-readability/
The PROJECT_STRUCTURE.md refresh row should be marked completed and link to PROJECT_STRUCTURE.md plus the Codebase Map.

http://localhost:4321/reference/roadmap/ephemeral-mount-modes/
Per-mount-isolation references should point to the Workspaces guide instead of the retired roadmap page.

http://localhost:4321/reference/architecture/
The isolation-state table should say worktree or clone, and the limitations list should preserve the V1 isolation-mode edit caveat.

PROJECT_STRUCTURE.md

The root-level file is not part of the rendered docs site — check it in the GitHub diff or cat PROJECT_STRUCTURE.md locally. The Root Files table should include build.rs, and the CI/CD workflows table should list all seven workflows.

Migration notes

None.