gcf-harness-aif-ext 0.2.0 → 0.3.0

package/README.md

@@ -6,17 +6,44 @@ The harness turns policy-as-text into an executable pipeline. It has **no memory
 
 ## Requirements
 
-- [`gcf-aif-ext`](../gcf-aif-ext) `^0.2.0` installed, with a `gcf/` tree in the project — declared as a peer dependency, and `gcf-harness install` refuses when the `gcf` command is not registered
+- [`gcf-aif-ext`](../gcf-aif-ext) `^0.2.0` installed, with a `gcf/` tree in the project — declared as a peer dependency, and `gcf-harness init` refuses when the `gcf` command is not registered
 - Claude Code 2.1.270+ (hooks, dynamic workflows)
 - AI Factory 2.x, Node.js ≥ 22.14
 
 ## Install
 
+Install into a project that already has the core, from npm or a local checkout:
+
+```bash
+ai-factory extension add gcf-aif-ext                                # the core, if not yet installed
+ai-factory extension add gcf-harness-aif-ext                        # npm
+# ai-factory extension add ../GCF/packages/gcf-harness-aif-ext      # local checkout
+```
+
+This installs the `gcf-run` and `gcf-run-ingest` skills and registers the `gcf-harness` command. Then initialize the harness in the project — like `gcf init`, once per project:
+
+```bash
+ai-factory gcf-harness init    # per project: .claude/settings.json + .gitignore
+```
+
+It is **per project**, not global — run it again in every game repository: it adds the readset-guard `PreToolUse` entry to the project's `.claude/settings.json` (never `~/.claude`) and `.gcf-session/` to `.gitignore`. It is idempotent, refuses when the `gcf` command is not registered, and refuses to rewrite a `settings.json` it cannot parse. It is a separate step for the same reason as `gcf hooks-install`: an AI Factory manifest cannot install Claude Code hooks.
+
+## Upgrade
+
+```bash
+ai-factory extension update gcf-harness-aif-ext
+```
+
+Updating keeps the hook entry valid — it points into the extension's install directory, which an update refreshes in place.
+
+To remove the extension:
+
 ```bash
-ai-factory extension add <path-to>/packages/gcf-harness-aif-ext
-ai-factory gcf-harness install   # registers the readset-guard hook
+ai-factory extension remove gcf-harness-aif-ext
 ```
 
+Removal does not touch `.claude/settings.json`: delete the `PreToolUse` entry whose command ends in `# gcf-readset-guard` by hand, or every Read, Grep and Glob will report a hook error.
+
 ## What it adds
 
 **`/gcf-run <card-id…>`** — drives a card from the backlog to `built`, with every gate checked *before* the tokens are spent: the audit ritual, collapsed dependencies, the tune limit, the WIP cap, the context budget. It stops at `built` and prints the playtest list — the verdict belongs to the human, and there is no stage past the build.

package/commands/harness.js

@@ -1,4 +1,4 @@
-// `ai-factory gcf-harness install` — registers the readset-guard PreToolUse hook in the
+// `ai-factory gcf-harness init` — registers the readset-guard PreToolUse hook in the
 // project's .claude/settings.json (the AIF manifest cannot install Claude Code hooks —
 // same decision as gcf hooks-install for git hooks). Idempotent by marker comment.
 import { readFile, writeFile, mkdir, appendFile } from 'node:fs/promises';
@@ -23,8 +23,8 @@ function coreMissing(program) {
 export function register(program) {
   const harness = program.command('gcf-harness').description('GCF harness setup');
 
-  harness.command('install')
-    .description('Register the readset-guard hook in .claude/settings.json (idempotent)')
+  harness.command('init')
+    .description('Initialize the harness in this project: readset-guard hook in .claude/settings.json (idempotent)')
     .action(async () => {
       if (coreMissing(program)) {
         throw new Error('gcf-aif-ext is not installed: the harness drives `ai-factory gcf …` — run `ai-factory extension add gcf-aif-ext` first');

package/extension.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/lee-to/ai-factory/2.x/schemas/extension.schema.json",
   "name": "gcf-harness-aif-ext",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "GCF orchestration harness for Claude Code: one-command card pipeline, readset guard",
   "skills": [
     "skills/gcf-run",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gcf-harness-aif-ext",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "GCF orchestration harness for Claude Code: one-command card pipeline, readset guard",
   "type": "module",
   "license": "MIT",