@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/cli/commands/governance.js

@@ -0,0 +1,60 @@
+/**
+ * `cf governance inject-global` — write / update / remove the claude-forge
+ * DECISION HINT protocol contract in the global `~/.claude/CLAUDE.md`.
+ *
+ * global-governance Phase 1 (decision 7fa0f2ab). Other projects' Claude
+ * sessions read the global file but not claude-forge's per-repo CLAUDE.md, so
+ * the protocol contract must live there for them to know to spawn
+ * decision-maker.
+ *
+ * Idempotent: re-running updates the marker block in place. Reversible via
+ * `--remove`. A backup (`<path>.bak`) is written before mutating an existing
+ * file.
+ *
+ * Usage:
+ *   cf governance inject-global                 # inject / update the block
+ *   cf governance inject-global --remove        # strip the block
+ *   cf governance inject-global --path <file>   # target a custom file (testing)
+ */
+import { injectGlobalGovernance, removeGlobalGovernanceBlock, defaultGlobalClaudeMdPath, } from '../../core/governance/global-inject.js';
+export function register(program) {
+    const governance = program
+        .command('governance')
+        .description('Manage claude-forge governance protocol injection');
+    governance
+        .command('inject-global')
+        .description('Inject the DECISION HINT protocol contract into the global ~/.claude/CLAUDE.md (idempotent)')
+        .option('--remove', 'Remove the injected governance block instead of writing it')
+        .option('--path <file>', 'Override the target file (defaults to ~/.claude/CLAUDE.md)')
+        .action((opts) => {
+        const target = opts.path ?? defaultGlobalClaudeMdPath();
+        try {
+            if (opts.remove) {
+                const result = removeGlobalGovernanceBlock(target);
+                if (result.action === 'absent') {
+                    console.log(`(no governance block found in ${result.path})`);
+                }
+                else {
+                    console.log(`✓ Removed governance block from ${result.path}`);
+                    if (result.backupPath)
+                        console.log(`  backup: ${result.backupPath}`);
+                }
+                return;
+            }
+            const result = injectGlobalGovernance(target);
+            const verb = result.action === 'created'
+                ? 'Created'
+                : result.action === 'updated'
+                    ? 'Updated'
+                    : 'Injected';
+            console.log(`✓ ${verb} governance block in ${result.path}`);
+            if (result.backupPath)
+                console.log(`  backup: ${result.backupPath}`);
+        }
+        catch (err) {
+            console.error(`governance inject-global failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+}
+//# sourceMappingURL=governance.js.map

package/dist/cli/commands/governance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"governance.js","sourceRoot":"","sources":["../../../src/cli/commands/governance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EACL,sBAAsB,EACtB,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,wCAAwC,CAAC;AAOhD,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,MAAM,UAAU,GAAG,OAAO;SACvB,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,mDAAmD,CAAC,CAAC;IAEpE,UAAU;SACP,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CACV,6FAA6F,CAC9F;SACA,MAAM,CAAC,UAAU,EAAE,4DAA4D,CAAC;SAChF,MAAM,CAAC,eAAe,EAAE,4DAA4D,CAAC;SACrF,MAAM,CAAC,CAAC,IAAyB,EAAE,EAAE;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,IAAI,yBAAyB,EAAE,CAAC;QAExD,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,MAAM,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;gBACnD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/B,OAAO,CAAC,GAAG,CAAC,iCAAiC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC/D,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,mCAAmC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC9D,IAAI,MAAM,CAAC,UAAU;wBAAE,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvE,CAAC;gBACD,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;YAC9C,MAAM,IAAI,GACR,MAAM,CAAC,MAAM,KAAK,SAAS;gBACzB,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS;oBAC3B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAC,UAAU,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,wBAAwB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,IAAI,MAAM,CAAC,UAAU;gBAAE,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CACX,oCAAoC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACvF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -1,3 +1,30 @@
 import type { Command } from 'commander';
+import { type InstallResult } from '../../daemon/launchd-installer.js';
+export interface RunInitFlowOptions {
+    skipPrompts: boolean;
+    full: boolean;
+    /** Override FORGE_HOME for tests. Production: omit (defaults to constant). */
+    forgeHome?: string;
+    /** Override process.platform for tests. */
+    platform?: NodeJS.Platform;
+    /** Override LaunchAgent installer for tests. */
+    installLaunchAgent?: (opts: {
+        dev?: boolean;
+    }) => InstallResult;
+    /** Override running-pid lookup for tests. */
+    resolveRunningPid?: () => number | null;
+    /** Override detached daemon spawner for tests. */
+    spawnDaemonDetached?: () => number | undefined;
+    /** Override `Date.now`/clock for deterministic tests. */
+    now?: () => Date;
+    /** Optional override web port (defaults to DEFAULTS.WEB_PORT, no interactive prompt). */
+    webPort?: number;
+}
+/**
+ * Core `cf init` orchestration. Pure function (apart from filesystem I/O).
+ * Mirrors the legacy inline action body but accepts dep-injection so unit
+ * tests can run hermetically against a tmp FORGE_HOME.
+ */
+export declare function runInitFlow(opts: RunInitFlowOptions): Promise<void>;
 export declare function register(program: Command): void;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkFzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqH/C"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIzC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAC;AAuC3C,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,gDAAgD;IAChD,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,aAAa,CAAC;IAChE,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IACxC,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC/C,yDAAyD;IACzD,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;IACjB,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkLzE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAe/C"}

package/dist/cli/commands/init.js

@@ -1,14 +1,23 @@
 import fs from 'fs';
 import path from 'path';
-import { fileURLToPath } from 'url';
 import readline from 'readline';
 import { FORGE_HOME, FORGE_PATHS, DEFAULTS } from '../../core/constants.js';
 import { copyHookScripts, backupSettings, injectHooks } from '../init/hook-manager.js';
+import { syncAgents } from '../../daemon/agent-sync.js';
+import { install as installLaunchAgentDefault, } from '../../daemon/launchd-installer.js';
 import chalk from 'chalk';
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-// Fallback if the upstream /v1/models probe fails — keep this in sync with the
-// latest GA opus family release. Bump when Anthropic ships a newer opus.
-const FALLBACK_MODEL = 'claude-opus-4-7';
+import { formatLocalDisplay } from '../../core/utils/time.js';
+import { readSystemMarker, writeSystemMarker, } from '../../core/diagnostics/markers.js';
+import { resolveRunningPid as resolveRunningPidDefault, spawnDaemonDetached as spawnDaemonDetachedDefault, } from './daemon.js';
+// D R-D (2026-05-29, spec 0902 / decision f5a5b030): legacy AI provider
+// prompt (api_key / base_url / model probe) was removed from `cf init`.
+// AI flows now use the local `claude` CLI subprocess (sub-spec A/B/C R-B);
+// daemon doesn't pick the upstream model. The interactive flow only asks
+// for the web port now.
+//
+// Spec ed8cf2db (2026-06-01): `--full` flag added — when set, also installs
+// LaunchAgent (macOS only) and spawns the daemon. Always writes a
+// `system-installed.json` marker (consumed by `cf doctor` from spec 2).
 function prompt(question) {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -21,122 +30,53 @@ function prompt(question) {
         });
     });
 }
-function rankOpusId(id) {
-    // Recognise ids like claude-opus-4-7, claude-opus-4-7-20260101, claude-3-opus-20240229.
-    // Return a tuple that sorts highest-first: [major, minor, dateInt].
-    const newStyle = /^claude-opus-(\d+)-(\d+)(?:-(\d{8}))?$/.exec(id);
-    if (newStyle) {
-        const major = parseInt(newStyle[1], 10);
-        const minor = parseInt(newStyle[2], 10);
-        const date = newStyle[3] ? parseInt(newStyle[3], 10) : 0;
-        return [major, minor, date];
+/**
+ * Core `cf init` orchestration. Pure function (apart from filesystem I/O).
+ * Mirrors the legacy inline action body but accepts dep-injection so unit
+ * tests can run hermetically against a tmp FORGE_HOME.
+ */
+export async function runInitFlow(opts) {
+    const home = opts.forgeHome ?? FORGE_HOME;
+    const platform = opts.platform ?? process.platform;
+    const installLaunchAgent = opts.installLaunchAgent ?? installLaunchAgentDefault;
+    const resolveRunningPid = opts.resolveRunningPid ?? resolveRunningPidDefault;
+    const spawnDaemonDetached = opts.spawnDaemonDetached ?? spawnDaemonDetachedDefault;
+    const now = opts.now ?? (() => new Date());
+    console.log(chalk.bold.cyan('\n🔧 Claude Forge 初始化向导\n'));
+    // Detect prior init (spec ed8cf2db §2 idempotency note).
+    const existingMarker = readSystemMarker(home);
+    const isReinit = existingMarker !== null;
+    if (isReinit) {
+        console.log(chalk.gray('→'), `Claude Forge 已初始化 (initialized_at=${existingMarker.initialized_at}); 重新校验配置…`);
     }
-    // Legacy `claude-3-opus-YYYYMMDD` gets mapped to (3, 0, date) so it ranks below the 4.x family.
-    const legacy = /^claude-(\d+)-opus(?:-(\d{8}))?$/.exec(id);
-    if (legacy) {
-        return [parseInt(legacy[1], 10), 0, legacy[2] ? parseInt(legacy[2], 10) : 0];
+    // 1. Create ~/.claude-forge/ directory
+    if (!fs.existsSync(home)) {
+        fs.mkdirSync(home, { recursive: true });
+        console.log(chalk.green('✓'), 'Created', home);
     }
-    return null;
-}
-async function pickDefaultModel(apiKey, baseUrl) {
-    if (!apiKey)
-        return FALLBACK_MODEL;
-    const modelsUrl = baseUrl.endsWith('/v1')
-        ? `${baseUrl}/models`
-        : `${baseUrl.replace(/\/$/, '')}/v1/models`;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), 5000);
-    try {
-        const res = await fetch(modelsUrl, {
-            redirect: 'follow',
-            signal: controller.signal,
-            headers: {
-                'Authorization': `Bearer ${apiKey}`,
-                'x-api-key': apiKey,
-            },
-        });
-        if (!res.ok)
-            return FALLBACK_MODEL;
-        const payload = (await res.json());
-        const ids = (payload.data ?? []).map((m) => m.id).filter((id) => typeof id === 'string');
-        const ranked = ids
-            .map((id) => ({ id, rank: rankOpusId(id) }))
-            .filter((x) => x.rank !== null)
-            .sort((a, b) => {
-            for (let i = 0; i < 3; i++) {
-                if (a.rank[i] !== b.rank[i])
-                    return b.rank[i] - a.rank[i];
-            }
-            return 0;
-        });
-        return ranked[0]?.id ?? FALLBACK_MODEL;
-    }
-    catch {
-        return FALLBACK_MODEL;
+    else {
+        console.log(chalk.gray('→'), home, 'already exists');
     }
-    finally {
-        clearTimeout(timer);
-    }
-}
-export function register(program) {
-    program
-        .command('init')
-        .description('Initialize Claude Forge hooks and configuration')
-        .option('--skip-prompts', 'Skip interactive prompts and use defaults')
-        .action(async (opts) => {
-        console.log(chalk.bold.cyan('\n🔧 Claude Forge 初始化向导\n'));
-        const skipPrompts = opts.skipPrompts;
-        // 1. Create ~/.claude-forge/ directory
-        if (!fs.existsSync(FORGE_HOME)) {
-            fs.mkdirSync(FORGE_HOME, { recursive: true });
-            console.log(chalk.green('✓'), 'Created', FORGE_HOME);
-        }
-        else {
-            console.log(chalk.gray('→'), FORGE_HOME, 'already exists');
-        }
-        // 2. Interactive configuration
-        let apiKey = process.env.ANTHROPIC_API_KEY || '';
-        let baseUrl = 'https://api.anthropic.com';
-        let webPort = DEFAULTS.WEB_PORT;
-        if (!skipPrompts) {
-            console.log(chalk.yellow('\n📝 配置选项（直接回车使用默认值）\n'));
-            const apiKeyInput = await prompt(`Anthropic API Key (可选，用于 AI 功能) [${apiKey ? '已设置' : '留空'}]: `);
-            if (apiKeyInput)
-                apiKey = apiKeyInput;
-            const baseUrlInput = await prompt(`API Base URL [${baseUrl}]: `);
-            if (baseUrlInput)
-                baseUrl = baseUrlInput;
-            if (baseUrl.startsWith('http://')) {
-                baseUrl = 'https://' + baseUrl.slice('http://'.length);
-            }
-            const portInput = await prompt(`Web 管理后台端口 [${webPort}]: `);
-            if (portInput && !isNaN(parseInt(portInput))) {
-                webPort = parseInt(portInput);
-            }
-        }
-        // 2b. Resolve default model: try upstream /v1/models, fall back to a recent default
-        if (apiKey) {
-            process.stdout.write(chalk.gray('→ 正在从 ') + baseUrl + chalk.gray(' 获取最新模型...'));
-        }
-        const defaultModel = await pickDefaultModel(apiKey, baseUrl);
-        if (apiKey) {
-            process.stdout.write('\r' +
-                chalk.green('✓') +
-                ' 默认模型：' +
-                chalk.cyan(defaultModel) +
-                (defaultModel === FALLBACK_MODEL ? chalk.gray('（fallback，未联网拉取）') : '') +
-                '                    \n');
+    // 2. Interactive configuration — D R-D (spec 0902): only web port now.
+    let webPort = opts.webPort ?? DEFAULTS.WEB_PORT;
+    if (!opts.skipPrompts && opts.webPort === undefined) {
+        console.log(chalk.yellow('\n📝 配置选项（直接回车使用默认值）\n'));
+        const portInput = await prompt(`Web 管理后台端口 [${webPort}]: `);
+        if (portInput && !isNaN(parseInt(portInput))) {
+            webPort = parseInt(portInput);
         }
-        // 3. Generate config.yaml
-        const configPath = FORGE_PATHS.config();
-        const configContent = `# Claude Forge 配置文件
-# 生成时间: ${new Date().toISOString()}
-
-# AI 服务配置（用于 CLAUDE.md 生成、Skill 语义匹配、Patch 建议）
-ai:
-  api_key: ${apiKey ? `"${apiKey}"` : '""  # 留空则禁用 AI 功能'}
-  model: "${defaultModel}"
-  base_url: "${baseUrl}"
+    }
+    // 3. Generate config.yaml — under override-aware home dir.
+    // We deliberately use `path.join(home, 'config.yaml')` instead of
+    // `FORGE_PATHS.config()` so tests can redirect via `forgeHome` override.
+    const configPath = home === FORGE_HOME ? FORGE_PATHS.config() : path.join(home, 'config.yaml');
+    const configContent = `# Claude Forge 配置文件
+# 生成时间: ${formatLocalDisplay(now().getTime())}
+#
+# 注：AI 配置 (api_key / base_url / model) 已在 spec 0902 (decision f5a5b030)
+# 中删除。AI 流程 (CLAUDE.md / Knowledge build / Patch preview) 改走本地
+# \`claude\` CLI 子进程，使用 Claude Code 订阅 / OAuth keychain，daemon 自身
+# 不持 \`ANTHROPIC_API_KEY\`。
 
 # Web 管理后台
 web:
@@ -146,38 +86,110 @@ web:
 # 数据存储
 storage:
   path: "~/.claude-forge/data.db"
-
-# 技能匹配（可选，使用 AI 语义匹配）
-skill_matching:
-  api_key: ${apiKey ? `"${apiKey}"` : '""  # 留空则使用关键词匹配'}
 `;
-        fs.writeFileSync(configPath, configContent, 'utf-8');
-        console.log(chalk.green('\n✓'), 'Created config:', configPath);
-        // 4. Copy hook scripts
-        copyHookScripts();
-        console.log(chalk.green('✓'), 'Hook scripts installed');
-        // 5. Backup settings.json
-        const bp = backupSettings();
-        if (bp) {
-            console.log(chalk.green('✓'), 'Settings backed up to', bp);
+    fs.writeFileSync(configPath, configContent, 'utf-8');
+    console.log(chalk.green('\n✓'), 'Created config:', configPath);
+    // 4. Copy hook scripts
+    copyHookScripts();
+    console.log(chalk.green('✓'), 'Hook scripts installed');
+    // 4b. Sync project-specific agent prompts (spec 1505 Q4).
+    try {
+        const ar = syncAgents();
+        console.log(chalk.green('✓'), `Agent prompts synced (${ar.copied} copied / ${ar.checked} checked, ${ar.skipped_userOwned} user-owned preserved)`);
+    }
+    catch (err) {
+        console.log(chalk.yellow('!'), 'Agent prompts sync skipped:', String(err));
+    }
+    // 5. Backup settings.json
+    const bp = backupSettings();
+    if (bp) {
+        console.log(chalk.green('✓'), 'Settings backed up to', bp);
+    }
+    // 7. Inject hooks into Claude Code settings
+    injectHooks();
+    console.log(chalk.green('✓'), 'Hooks injected into Claude Code settings');
+    // 8. New (spec ed8cf2db §2): `--full` triggers LaunchAgent install +
+    //    daemon spawn (macOS) or a friendly skip notice (other platforms).
+    let launchdInstalled = false;
+    if (opts.full) {
+        if (platform === 'darwin') {
+            try {
+                const result = installLaunchAgent({ dev: false });
+                launchdInstalled = true;
+                console.log(chalk.green('✓'), `LaunchAgent installed (${result.plistPath})`);
+                if (result.reloaded)
+                    console.log(chalk.gray('  (reloaded existing LaunchAgent)'));
+                const runningPid = resolveRunningPid();
+                if (runningPid) {
+                    console.log(chalk.gray('→'), `Daemon already running (PID ${runningPid})`);
+                }
+                else {
+                    try {
+                        const pid = spawnDaemonDetached();
+                        console.log(chalk.green('✓'), `Daemon started (PID ${pid ?? 'unknown'})`);
+                    }
+                    catch (err) {
+                        console.log(chalk.yellow('!'), `Daemon auto-start failed: ${err.message}; check ${FORGE_PATHS.daemonLog()}`);
+                    }
+                }
+            }
+            catch (err) {
+                console.log(chalk.yellow('!'), `LaunchAgent install failed: ${err.message}`);
+            }
         }
-        // 7. Inject hooks into Claude Code settings
-        injectHooks();
-        console.log(chalk.green('✓'), 'Hooks injected into Claude Code settings');
-        // 8. Summary
-        console.log(chalk.bold.green('\n✅ Claude Forge 初始化成功！\n'));
-        console.log(chalk.yellow('下一步：'));
-        console.log('  1. 重启 Claude Code 使 hooks 生效');
-        console.log('  2. 启动守护进程：claude-forge daemon start');
-        console.log('  3. 访问管理后台：http://localhost:' + webPort);
-        // 8b. 提示用户注册 MCP（可选步骤）
-        console.log(chalk.bold('\n📡 可选：注册 MCP Server'));
-        console.log(chalk.dim('  启用 Agent 动态调用 Skill 功能，运行：'));
-        console.log(chalk.cyan('  cf mcp register\n'));
-        if (!apiKey) {
-            console.log(chalk.gray('💡 提示：未配置 API Key，AI 功能（分类器、质量检查）将被禁用'));
-            console.log(chalk.gray('   如需启用，请编辑：' + configPath));
+        else {
+            console.log(chalk.yellow('ℹ'), `跳过 LaunchAgent (仅 macOS 支持); 请在 hook / cron 中调 \`cf daemon ensure-running\` 自愈`);
         }
+    }
+    // 9. Write system marker (spec ed8cf2db §1 — frozen contract with spec 2).
+    try {
+        writeSystemMarker({
+            launchd_installed: launchdInstalled,
+            full_mode: Boolean(opts.full),
+            platform,
+            initialized_at: now().toISOString(),
+        }, home);
+        console.log(chalk.green('✓'), `System marker written: ${path.join(home, 'system-installed.json')}`);
+    }
+    catch (err) {
+        console.log(chalk.yellow('!'), `Marker write failed: ${err.message}`);
+    }
+    // 10. Summary
+    console.log(chalk.bold.green('\n✅ Claude Forge 初始化成功！\n'));
+    console.log(chalk.yellow('下一步：'));
+    console.log('  1. 重启 Claude Code 使 hooks 生效');
+    if (opts.full && launchdInstalled) {
+        console.log('  2. daemon 已通过 LaunchAgent 自启 (cf daemon status 验证)');
+    }
+    else if (opts.full && platform !== 'darwin') {
+        console.log('  2. 启动守护进程：claude-forge daemon ensure-running');
+    }
+    else {
+        console.log('  2. 启动守护进程：claude-forge daemon start');
+        console.log('     (或一键装 LaunchAgent: cf init --full)');
+    }
+    console.log('  3. 访问管理后台：http://localhost:' + webPort);
+    // 11. Optional MCP register hint
+    console.log(chalk.bold('\n📡 可选：注册 MCP Server'));
+    console.log(chalk.dim('  启用 Agent 动态调用 Skill 功能，运行：'));
+    console.log(chalk.cyan('  cf mcp register\n'));
+    // D R-D (spec 0902): AI 流程已迁到 `claude` CLI shell-out。
+    console.log(chalk.gray('💡 AI 流程（CLAUDE.md / Knowledge build / Patch preview）走本地 ') +
+        chalk.cyan('claude') +
+        chalk.gray(' CLI 子进程，使用 Claude Code 订阅 / OAuth。'));
+    console.log(chalk.gray('   无需配置 ANTHROPIC_API_KEY；spec 0902 (decision f5a5b030)。'));
+}
+export function register(program) {
+    program
+        .command('init')
+        .description('Initialize Claude Forge hooks and configuration')
+        .option('--skip-prompts', 'Skip interactive prompts and use defaults')
+        .option('--full', 'Also install LaunchAgent (macOS) and auto-start daemon (spec ed8cf2db)')
+        .action(async (opts) => {
+        await runInitFlow({
+            skipPrompts: Boolean(opts.skipPrompts),
+            full: Boolean(opts.full),
+        });
     });
 }
 //# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/insights-goal-check.d.ts

@@ -0,0 +1,50 @@
+/**
+ * `cf insights goal-check` — Phase 9 of the master roadmap.
+ *
+ * Runs the 13 C1-C13 predicate checks defined in
+ * docs/design/2026-05-22/0200-master-roadmap-full-loop.md §1 and prints a
+ * PASS/FAIL table. This is the single source of truth for "is the
+ * /goal-state-of-the-union actually met?".
+ *
+ * Implementation contract:
+ *   • Each criterion is a pure function that takes the SQLite db + the
+ *     project root and returns { passed, actual, target, note? }.
+ *   • Predicates that need shell access (curl / find on FS) are wrapped in
+ *     try/catch and degrade to FAIL on error — never throw.
+ *   • Output goes to stdout; exit code is 0 iff all 13 pass (so CI can use
+ *     it as a gate later).
+ *
+ * Wired by src/cli/commands/insights.ts; tests live in
+ * tests/unit/cli/insights-goal-check.test.ts.
+ */
+import type Database from 'better-sqlite3';
+export interface CriterionResult {
+    id: string;
+    description: string;
+    passed: boolean;
+    actual: string;
+    target: string;
+    note?: string;
+}
+export interface GoalCheckOptions {
+    /** Project root (for filesystem checks like .claude/agents/, .forge-knowledge/). */
+    cwd: string;
+    /** Web port for C10/C11 curl probes. */
+    webPort: number;
+    /**
+     * When true, skip C10/C11 entirely (their PASS/FAIL reflects a live server,
+     * so unit tests / CI without a daemon should pass --skip-http).
+     */
+    skipHttp?: boolean;
+}
+export declare function runCriteria(db: Database.Database, opts: GoalCheckOptions): CriterionResult[];
+export declare function renderResults(results: CriterionResult[]): string;
+export interface RunGoalCheckParams {
+    cwd?: string;
+    webPort?: number;
+    skipHttp?: boolean;
+    json?: boolean;
+}
+/** Runs the full check, prints output to stdout, returns exit code. */
+export declare function runGoalCheckCli(params?: RunGoalCheckParams): number;
+//# sourceMappingURL=insights-goal-check.d.ts.map

package/dist/cli/commands/insights-goal-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"insights-goal-check.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/insights-goal-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAO3C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,oFAAoF;IACpF,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAoED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,gBAAgB,GAAG,eAAe,EAAE,CAuL5F;AAID,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,EAAE,GAAG,MAAM,CAqBhE;AAID,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,GAAE,kBAAuB,GAAG,MAAM,CAwBvE"}