Reconcile plugin onto KB-root state model (Phase A) - #9
Merged
Conversation
Converge the plugin off the old .nexus/ directory model onto the canonical KB-root model so install -> scaffold -> /done /status /idea /failure all hit one root structure. - /failure: read/append root failure-log.md (was .nexus/), format-tolerant — detect plain-line vs categorised shape and append in kind; categories stay optional, never forced onto a day-one log. - 3 hooks: replace find_nexus_dir() with find_state_dir() -> <git-toplevel>/.claude/session-state; session_preflight message points at KB-root reality; branch_verify echo-hint path fixed; session_save writes there and only inside a git repo. Stdlib-only, non-blocking, exit 0. - /field-report: re-point reads to root failure-log.md (path only). - Retire /nexus-onboard (removed); scrub README, ROADMAP, manifests. - Repurpose /nexus-init into an idempotent KB-root foundations bootstrapper (root failure-log.md, KB/ PARA skeleton, .gitignore/.env.example) — no .nexus/. - Remove dead templates/config.json; scrub templates/README row. - README/manifests/universe.md: surviving command set, drop "onboarding", bump 0.5.0 -> 0.6.0, living-map framing. - New docs/cowork-setup.md: single canonical Cowork story (greenfield no-terminal install via Customize panel, namespaced nexus:* commands, /plugin CLI-only, remove+re-add for stale). GUI click-path flagged unverified pending the clean dry-run; third-party marketplace GUI-add unconfirmed. Folds the two prior Cowork snippets into a single pointer. Only allowed .nexus/ mention remaining is the historical note in ROADMAP's retired-commands section. Hooks compile. Phase B not started. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
The latest updates on your projects. Learn more about Vercel for GitHub.
|
… get commands Greenfield gap surfaced in the live dry-run: operators were never told to mkdir/git init or how to obtain the commands. Adds the substrate + folder + plugin-install (or manual copy) step up front. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Phase A of the plugin reconciliation (plan: discipline-first / KB-root convergence). Converges the plugin off the old
.nexus/state model so install → scaffold →/done/status/idea/failureall hit ONE root structure. Launch-blocking fix before the Ranj/Andy operator handoff.What changed
/failure+/field-report→ rootfailure-log.md;/failureis format-tolerant (matches the log's existing shape, never forces the category table on a plain-line log).find_state_dir()=<git-toplevel>/.claude/session-state; pre-flight message rewritten to KB-root reality./nexus-onboardretired (the setup-prompt's livinguniverse.mdinterview replaces it); deadtemplates/config.jsonremoved./nexus-initrepurposed → idempotent KB-root foundations bootstrap (rootfailure-log.md,KB/PARA + READMEs,.gitignore/.env.example), no.nexus/.templates/universe.mdreconciled; version 0.5.0 → 0.6.0.docs/cowork-setup.md— single Cowork story (two old snippets folded into pointers).Verified (static)
grep -rn "\.nexus/" .→ only the allowed historical note in ROADMAP's retired-commands section..claude/session-state.docs/cowork-setup.mdhonestly flags the desktop GUI click-path as[unverified]and states plainly that a pure-GUI third-party-marketplace add is unconfirmed (may need a one-time CLI/plugin marketplace add).NOT done — do before merge
/done/status/idea/failureall hit one root structure;/nexus-initin a second scratch repo; hooks write.claude/session-state/, create no.nexus/.Follow-up
nexus.structure.json+ coherence check + CI + CHANGELOG + updating doc + offline staleness surface.Do not merge until the dry-run confirms the live behaviour.