Repository navigation
docs: README and command pages use current paths and facts (C4.1, CORE-174) - #417
Merged
Merged
Conversation
|
Warning Review limit reachedYou've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository. Next included review available in 28 minutes. View limit details
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. |
…E-174) Bring the README and command pages in line with the code and pharn-oss 7.x: the write guard's pharn/.run/ paths, pharn/spec-template.md, pharn/memory-bank/, the root footprint left in place now that the migration is gone, init's one "Ready to install?" question, init --yes, the newest verified release as the default source, the legacy-source inference, no permanent exclusion (a Planned roadmap row), a quick start that does not fail after create-next-app's own commit, and example config/records blocks regenerated from a real pharn 0.20.0 run. `pharn --help` no longer says each option belongs to ONE command. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
🛡️ pharn-ci · ✅ PassTip Pass · This change adds no coverable lines; 29 agent setup files found.
🧪 Diff coverageNo coverable lines changed. 🔍 Test integrityNo test-integrity findings (mode: block). Tests changed: +0 −0 ~1
💬 Messages (1)
🤖 Agent setup (29 files)Agent setup: 29 files · claude-code Agent setup files (29)
pharn-ci 0.10.0 · report schema v2 · coverage format lcov |
…(C4.1, CORE-174) Rebased on the 0.21.0 release: the CHANGELOG entry moves out of the released section, and the config/records examples are regenerated from a real 0.21.0 run (pharn init --yes, then pharn add n-plus-one). Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
PrzemekGalarowicz
force-pushed
the
przemek/core-174-docs-current-paths
branch
from
November 17, 2026 12:16
6f8675f to
6e23870
Compare
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.
Linear: CORE-174 (epic CORE-153). Docs-only except item 15 (the
--helpheader, with an[Unreleased]CHANGELOG line and a test assertion).Checklist (ticket items)
pharn/spec-template.md(verified in pharn-oss 7.22.0:protect-trusted-paths.cjs,pharn/floor/spec-template-core.mjs). The root-migration part is moot (refactor: remove the flat layout and the root migration (CORE-155) [v0.21.0] #412 removed it): the README's root-footprint paragraph now says a rootpharn.spec-template.md/memory-bank/is never moved or mentioned and yougit mvit yourself; the stale "pharn updateprints the replacement.pharn/line" sentence is corrected too.memory-bank/→pharn/memory-bank/— README (two places),docs/getting-started.md,docs/commands/remove.md(verified in 7.22.0'spharn-memory-promote.md).pharn/.run/**,pharn/.run/<command>/<name>/active.json,pharn/.run/writes-scope.json(verified against the installed 7.22.0enforce-writes-scope.cjs, not this repo's own hooks).init.mdsays all four land inpharn/; the "Rename yours first" text is gone). The flat-layout part is moot (refactor: remove the flat layout and the root migration (CORE-155) [v0.21.0] #412).SECURITY.md:7is C4.4's.init.mdheader and "interactive by default" section now describe the summary + "Ready to install?" (+ the overwrite question), and point to--archetype/add/removefor selection; troubleshooting "the wizard cancels" → "pharn initcancels".inithas no--yes" — fixed inupdate.mdandreference/pharn-config.md, linking init's--yessection.remove.mdnow says there is no permanent exclusion,universalis selected regardless, and onlypharn init --archetype <list>changesarchetypes; new Planned roadmap row "Permanent capability exclusion".list.md: selected →auto, unselected →manual(rows 4/8 ofmerge-capabilities.ts).features/README.md"in both layouts" — already fixed on main (getting-started.mdsayspharn/features/README.md); the flat half is moot (refactor: remove the flat layout and the root migration (CORE-155) [v0.21.0] #412).mainframed as the default —init.md,add.md(two places),update.md,troubleshooting.mdnow lead with the newest verified release;--ref mainis the opt-in.libalone).git commitaftercreate-next-app— README and getting-started run the git lines only when.gitis absent:[ -d .git ] || { git init && git add -A && git commit -m "init"; }, with a sentence on why. (The shadcn step in getting-started is C4.6's; left as is.)pharn.config.json#/modelsand.claude/settings.json.--drift— already fixed on main (status.mdsays--no-drift).src/lib/cli-args.tsnow printsOptions (each names the commands that take it; any other command refuses it):; pinned intests/cli-args.test.ts; the same "exactly one command" claim indocs/troubleshooting.mdis corrected; CHANGELOG[Unreleased]line added.How the examples were generated
npm run buildon this branch (rebased on the 0.21.0 release, sopharn0.21.0), then in an empty temp dir:The doc blocks are that
pharn.config.jsonandpharn.records.json, trimmed with…(models stages, most capabilities, hash tails); the command is recorded in the docs above each block.Checks run locally
format:check,lint,lint:md,typecheck,vitest run(3595 passed).🤖 Generated with Claude Code