gcf-aif-ext 0.2.4 → 0.2.5

package/README.md

@@ -31,6 +31,8 @@ ai-factory gcf hooks-install   # arms the pre-commit gate
 
 `gcf init` is idempotent: it creates what is missing and overwrites nothing.
 
+It then offers the optional [harness](../gcf-harness-aif-ext) — orchestration and a readset guard for **Claude Code only** — and on yes runs `ai-factory extension add gcf-harness-aif-ext` and `ai-factory gcf-harness init`. It asks only in a terminal and only when `.ai-factory.json` lists the Claude Code agent; an agent or CI run is never asked and installs nothing. `--harness` installs it without asking, `--no-harness` skips the question.
+
 `hooks-install` is a separate step because an AI Factory manifest can declare skills, commands and injections but cannot install a git hook — and because arming a gate that can break your commits is your call, not the extension's. It needs a git repository, and it will not overwrite a `pre-commit` it did not write: if husky or lefthook already owns the hook, it prints the one line to chain from it instead. Without the hook GCF still works; nothing enforces it at commit time.
 
 Then `/gcf-vision` for a brand-new game, `/gcf-adopt` for a project that already has code, `/gcf-ingest <gdd.md>` for an existing design doc, or `/gcf-card` to start a feature by hand.

package/commands/gcf.js

@@ -15,12 +15,53 @@ const MARKER = 'gcf-aif-ext pre-commit gate';
 
 const out = (json, value, human) => console.log(json ? JSON.stringify(value, null, 2) : human(value));
 
+const HARNESS = 'gcf-harness-aif-ext';
+
+/**
+ * `--harness` / `--no-harness` decide. Without either, ask only when someone can answer
+ * and the answer matters: an agent, CI or MinTTY run has no terminal, and a project
+ * without the Claude Code agent has no use for a Claude-Code-only extension.
+ */
+export async function harnessWanted(flag, ask, canAsk) {
+  if (flag !== undefined) return flag;
+  return canAsk ? ask() : false;
+}
+
+async function claudeConfigured() {
+  try {
+    const { agents } = JSON.parse(await readFile(path.join(process.cwd(), '.ai-factory.json'), 'utf8'));
+    return agents.some((a) => a?.id === 'claude');
+  } catch {
+    return true; // unknown config shape: let the human decide
+  }
+}
+
+async function askHarness() {
+  const { createInterface } = await import('node:readline/promises');
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question(`Also install ${HARNESS} (orchestration + readset guard, Claude Code only)? [y/N] `);
+    return /^y(es)?$/i.test(answer.trim());
+  } finally {
+    rl.close();
+  }
+}
+
+// Re-enter the AIF CLI that is running this command, not whatever `ai-factory` PATH holds
+// (an npx run has none on PATH).
+function aif(args) {
+  const res = spawnSync(process.execPath, [process.argv[1], ...args], { cwd: process.cwd(), stdio: 'inherit' });
+  if (res.status !== 0) throw new Error(`ai-factory ${args.join(' ')} failed — gcf/ is ready; retry that command by hand`);
+}
+
 export function register(program) {
   const gcf = program.command('gcf').description('Game Context Framework core');
 
   gcf.command('init')
-    .description('Create the gcf/ skeleton from templates (idempotent, never overwrites)')
-    .action(async () => {
+    .description('Create the gcf/ skeleton from templates (idempotent, never overwrites); offers the harness')
+    .option('--harness', `also install ${HARNESS} and run gcf-harness init (Claude Code only)`)
+    .option('--no-harness', 'do not offer the harness')
+    .action(async (opts) => {
       const root = path.join(process.cwd(), 'gcf');
       for (const dir of ['cards', 'systems', 'source', '.metrics']) {
         await mkdir(path.join(root, dir), { recursive: true });
@@ -44,6 +85,16 @@ export function register(program) {
       const { writeIndex } = await lib('index-gen');
       await writeIndex(root);
       console.log('gcf/ ready. Edit PILLARS.md, then add candidates to backlog.md.');
+
+      const installed = program.commands?.some((c) => (typeof c?.name === 'function' ? c.name() : c?.name) === 'gcf-harness');
+      if (installed) {
+        if (opts.harness) aif(['gcf-harness', 'init']);
+        return;
+      }
+      const canAsk = Boolean(process.stdin.isTTY && process.stdout.isTTY) && (await claudeConfigured());
+      if (!(await harnessWanted(opts.harness, askHarness, canAsk))) return;
+      aif(['extension', 'add', HARNESS]);
+      aif(['gcf-harness', 'init']);
     });
 
   gcf.command('index')

package/extension.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/lee-to/ai-factory/2.x/schemas/extension.schema.json",
   "name": "gcf-aif-ext",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Game Context Framework for AI Factory",
   "skills": [
     "skills/gcf-init",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gcf-aif-ext",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Game Context Framework for AI Factory",
   "type": "module",
   "license": "MIT",