gitifact 0.5.0 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 Git-backed requirements and change history for coding agents. New projects use `schemaVersion: 2`, Markdown specifications and per-feature change reasons. Requires Node.js 24.x and Git.
 
-Install with `npm install -g gitifact`. Run `gitifact init`, then read the GITIFACT block it writes into the project's agent instruction file and follow it in the current session.
+Install or update with `npm install -g gitifact@latest`. Run `gitifact init`, then read the GITIFACT block it writes into the project's agent instruction file and follow it in the current session. `init` also asks npm for a newer release and reports it in `update` and `install`, so an older install is noticed; the check never blocks initialization and `GITIFACT_NO_UPDATE_CHECK=1` turns it off.
 
 ```sh
 gitifact init --dry-run
@@ -19,7 +19,7 @@ gitifact spec read --ref HEAD
 gitifact spec diff --from BEFORE --to AFTER
 ```
 
-Initialization creates the configuration and the Git adoption baseline, then installs a managed block between `<!-- GITIFACT:START -->` and `<!-- GITIFACT:END -->` in the agent instruction files. Existing `AGENTS.md`, `CLAUDE.md`, `.claude/CLAUDE.md`, `.cursorrules`, `.hermes.md` and `HERMES.md` all receive the block, except files that only `@`-import another one; when none exist, `AGENTS.md` is created. Claude Code reads `CLAUDE.md` but not `AGENTS.md`, so when the block lands in `AGENTS.md` and neither `CLAUDE.md` nor `.claude/CLAUDE.md` exists, `init` also creates a root `CLAUDE.md` containing only `@AGENTS.md`; `--remove-agents` deletes that file again only when it removes `AGENTS.md` and the file is unchanged. `--agent claude|cursor|codex|hermes|all` targets one tool's file instead, `--remove-agents` removes the block, and `--skip-agents` leaves instruction files alone. Text outside the markers is never touched; re-running `init` refreshes the block after a CLI update and refuses files with a broken marker pair. Initialization requires Git, accepts an unborn repository, preserves unrelated work and staging, and never performs a commit. Existing legacy configuration requires an explicit separate transition.
+Initialization creates the configuration and the Git adoption baseline, then installs a managed block between `<!-- GITIFACT:START -->` and `<!-- GITIFACT:END -->` in the agent instruction files. Existing `AGENTS.md`, `CLAUDE.md`, `.claude/CLAUDE.md`, `.cursorrules`, `.hermes.md` and `HERMES.md` all receive the block, except files that only `@`-import another one; when none exist, `AGENTS.md` is created. Claude Code reads `CLAUDE.md` but not `AGENTS.md`, so when the block lands in `AGENTS.md` and neither `CLAUDE.md` nor `.claude/CLAUDE.md` exists, `init` also creates a root `CLAUDE.md` containing only `@AGENTS.md`; `--remove-agents` deletes that file again only when it removes `AGENTS.md` and the file is unchanged. `--agent claude|cursor|codex|hermes|all` targets one tool's file instead, `--remove-agents` removes the block, and `--skip-agents` leaves instruction files alone. Text outside the markers is never touched; re-running `init` refreshes the block after a CLI update and refuses files with a broken marker pair. Initialization requires Git, accepts an unborn repository, preserves unrelated work and staging, and never performs a commit. Existing legacy configuration requires an explicit separate transition. A `schemaVersion: 1` configuration written by 0.4.x with nothing else in `.gitifact` is replaced (`outcome: "replaced"`); records of that convention are not converted, and a newer `schemaVersion` asks for a newer CLI.
 
 `gitifact docs` lists the guidance topics (`workflow`, `spec`, `design`, `wiki`, `commit`) and `gitifact docs <topic>` prints the bundled guidance for one. `docs wiki` is followed by the project's wiki policy, the body of `.gitifact/wiki/README.md`; `init` writes that page on first adoption with a default policy (keep architecture decision records), and without it the default applies. Edit the README to run the wiki differently. The block summarises the rules and points agents at these topics for the exact input formats.