@winspan/claude-forge 8.54.4 → 9.2.0

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

@@ -1,3 +1,63 @@
 import type { Command } from 'commander';
+/**
+ * Spec: docs/design/2026-05-29/0902-ai-config-removal-master-spec.md §2.4.1 + §3.1
+ * Decision: f5a5b030 (Option B — 彻底)
+ * Phase:    R-D (cleanup: drop deprecated ClaudeMDStubError, dedup
+ *           scanDirectoryTree, decline to reintroduce AUTO markers around
+ *           agent output — full file is now written verbatim from the agent).
+ *
+ * `cf claudemd init/update` spawns the `claude` CLI in headless `--bare`
+ * mode against the `claudemd-writer` agent.  The agent receives the parsed
+ * project context (tech stack, directory tree, persona, existing conventions)
+ * as tagged blocks and returns the full CLAUDE.md body wrapped in
+ * `---CLAUDEMD---...---END---`.  This host parses the envelope and writes
+ * the file — the agent never touches disk.
+ *
+ * BEHAVIOR CHANGE in R-D: the previous `manager.generator.write()` path
+ * preserved user content outside `<!-- forge:claudemd-auto -->` markers.
+ * The new flow does NOT reintroduce those markers — the agent writes the
+ * full file body and any prior user content is overwritten.  Users who need
+ * marker-preserving merge can still construct it manually via
+ * `ClaudeMdGenerator.write()` (kept as a reusable primitive).
+ */
+/**
+ * Raised when the `claude` CLI returned text but no `---CLAUDEMD---...---END---`
+ * envelope could be parsed.  Indicates the agent ignored its output schema.
+ */
+export declare class ClaudeMdBlockMissingError extends Error {
+    readonly rawTextSnippet: string;
+    constructor(rawText: string);
+}
+/**
+ * Extract the body inside `---CLAUDEMD---...---END---`.  Returns `null` if
+ * the envelope is missing or malformed.  Any outer agent-emitted frontmatter
+ * (a leading `---\n...\n---\n` block right after the start marker) is stripped
+ * so the caller writes a clean markdown body.
+ */
+export declare function parseClaudeMdBlock(text: string): string | null;
+/**
+ * Build the prompt sent to `claudemd-writer` via stdin.  Uses tagged blocks
+ * the agent's body parses (see `src/daemon/templates/agents/claudemd-writer.md`).
+ */
+export declare function buildClaudeMdWriterPrompt(input: {
+    command: 'init' | 'update';
+    projectName: string;
+    techStackJson: string;
+    directoryTree: string;
+    persona: string;
+    conventions: string;
+}): string;
+/**
+ * Run the `claudemd-writer` agent against a project path and write the
+ * resulting CLAUDE.md. Exposed (spec ed8cf2db §5 refactor) so
+ * `cf project init` can reuse the same code path without spawning a child
+ * `cf claudemd init` subprocess (zero behavior change — same exit codes,
+ * same error handling).
+ */
+export declare function runClaudeMdWriter(opts: {
+    command: 'init' | 'update';
+    projectPath: string;
+    force: boolean;
+}): Promise<void>;
 export declare function register(program: Command): void;
 //# sourceMappingURL=claudemd.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"claudemd.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/claudemd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0E/C"}
+{"version":3,"file":"claudemd.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/claudemd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWzC;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;GAGG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;gBACpB,OAAO,EAAE,MAAM;CAQ5B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiB9D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAST;AAID;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8EhB;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD/C"}

package/dist/cli/commands/claudemd.js

@@ -1,10 +1,158 @@
 import fs from 'fs';
 import path from 'path';
-import { ClaudeMdManager } from '../../claudemd/index.js';
-import { SQLiteStorage } from '../../core/storage/sqlite.js';
-import { ClaudeProvider } from '../../core/ai/provider.js';
-import { ConfigManager } from '../../core/config.js';
-import { expandPath } from '../../core/utils/path.js';
+import { PersonaManager, TechDetector, scanDirectoryTree } from '../../claudemd/index.js';
+import { ConventionExtractor } from '../../claudemd/convention-extractor.js';
+import { spawnClaudeCli, ClaudeCliMissingError, ClaudeCliExitError, ClaudeCliTimeoutError, ClaudeCliCancelledError, } from '../../core/utils/claude-cli-spawn.js';
+/**
+ * Spec: docs/design/2026-05-29/0902-ai-config-removal-master-spec.md §2.4.1 + §3.1
+ * Decision: f5a5b030 (Option B — 彻底)
+ * Phase:    R-D (cleanup: drop deprecated ClaudeMDStubError, dedup
+ *           scanDirectoryTree, decline to reintroduce AUTO markers around
+ *           agent output — full file is now written verbatim from the agent).
+ *
+ * `cf claudemd init/update` spawns the `claude` CLI in headless `--bare`
+ * mode against the `claudemd-writer` agent.  The agent receives the parsed
+ * project context (tech stack, directory tree, persona, existing conventions)
+ * as tagged blocks and returns the full CLAUDE.md body wrapped in
+ * `---CLAUDEMD---...---END---`.  This host parses the envelope and writes
+ * the file — the agent never touches disk.
+ *
+ * BEHAVIOR CHANGE in R-D: the previous `manager.generator.write()` path
+ * preserved user content outside `<!-- forge:claudemd-auto -->` markers.
+ * The new flow does NOT reintroduce those markers — the agent writes the
+ * full file body and any prior user content is overwritten.  Users who need
+ * marker-preserving merge can still construct it manually via
+ * `ClaudeMdGenerator.write()` (kept as a reusable primitive).
+ */
+/**
+ * Raised when the `claude` CLI returned text but no `---CLAUDEMD---...---END---`
+ * envelope could be parsed.  Indicates the agent ignored its output schema.
+ */
+export class ClaudeMdBlockMissingError extends Error {
+    rawTextSnippet;
+    constructor(rawText) {
+        super(`[ClaudeMdBlockMissingError] claudemd-writer agent output missing ` +
+            `---CLAUDEMD---...---END--- envelope (got ${rawText.length} chars).`);
+        this.name = 'ClaudeMdBlockMissingError';
+        this.rawTextSnippet = rawText.slice(0, 200);
+    }
+}
+/**
+ * Extract the body inside `---CLAUDEMD---...---END---`.  Returns `null` if
+ * the envelope is missing or malformed.  Any outer agent-emitted frontmatter
+ * (a leading `---\n...\n---\n` block right after the start marker) is stripped
+ * so the caller writes a clean markdown body.
+ */
+export function parseClaudeMdBlock(text) {
+    const START = '---CLAUDEMD---';
+    const END = '---END---';
+    const startIdx = text.indexOf(START);
+    if (startIdx < 0)
+        return null;
+    const afterStart = startIdx + START.length;
+    const endIdx = text.indexOf(END, afterStart);
+    if (endIdx < 0)
+        return null;
+    let inside = text.slice(afterStart, endIdx).trim();
+    // Strip optional inner frontmatter the agent may add (we own the outer
+    // markers; CLAUDE.md doesn't need its own YAML frontmatter).
+    const fmMatch = inside.match(/^---\n[\s\S]*?\n---\n/);
+    if (fmMatch) {
+        inside = inside.slice(fmMatch[0].length).trimStart();
+    }
+    return inside.trim();
+}
+/**
+ * Build the prompt sent to `claudemd-writer` via stdin.  Uses tagged blocks
+ * the agent's body parses (see `src/daemon/templates/agents/claudemd-writer.md`).
+ */
+export function buildClaudeMdWriterPrompt(input) {
+    return [
+        `<target_command>${input.command}</target_command>`,
+        `<project_name>${input.projectName}</project_name>`,
+        `<project_tech_stack>${input.techStackJson}</project_tech_stack>`,
+        `<project_directory_tree>${input.directoryTree}</project_directory_tree>`,
+        `<project_persona>${input.persona}</project_persona>`,
+        `<project_conventions>${input.conventions}</project_conventions>`,
+    ].join('\n\n');
+}
+// ── Init / update shared implementation ──────────────────────────────────
+/**
+ * Run the `claudemd-writer` agent against a project path and write the
+ * resulting CLAUDE.md. Exposed (spec ed8cf2db §5 refactor) so
+ * `cf project init` can reuse the same code path without spawning a child
+ * `cf claudemd init` subprocess (zero behavior change — same exit codes,
+ * same error handling).
+ */
+export async function runClaudeMdWriter(opts) {
+    const { command, projectPath, force } = opts;
+    const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+    if (command === 'init' && fs.existsSync(claudeMdPath) && !force) {
+        console.error(`CLAUDE.md already exists at ${claudeMdPath}. Use --force to overwrite, or run \`cf claudemd update\`.`);
+        process.exit(1);
+        return;
+    }
+    const techStack = new TechDetector().detect(projectPath);
+    const projectName = path.basename(projectPath) || 'project';
+    const isJava = techStack.language.some((l) => l.startsWith('Java'));
+    const directoryTree = scanDirectoryTree(projectPath, isJava ? 4 : 2);
+    const persona = new PersonaManager().load(projectPath) || '';
+    const conventions = command === 'update' ? new ConventionExtractor().extract(projectPath) || '' : '';
+    const prompt = buildClaudeMdWriterPrompt({
+        command,
+        projectName,
+        techStackJson: JSON.stringify(techStack, null, 2),
+        directoryTree,
+        persona,
+        conventions,
+    });
+    let raw;
+    try {
+        raw = await spawnClaudeCli({
+            agent: 'claudemd-writer',
+            prompt,
+            allowedTools: ['Read', 'Grep'],
+            // 5-min cap: tree scan + 7 sections is well under 60s typical;
+            // 5 min is the same ceiling distill uses for an interactive feel.
+            timeoutMs: 300_000,
+        });
+    }
+    catch (err) {
+        if (err instanceof ClaudeCliMissingError) {
+            console.error(err.message);
+            console.error('Install Claude Code: https://docs.anthropic.com/en/docs/claude-code or `npm i -g @anthropic-ai/claude-code`.');
+            process.exit(1);
+            return;
+        }
+        if (err instanceof ClaudeCliCancelledError) {
+            console.error('[cf claudemd] cancelled.');
+            process.exit(1);
+            return;
+        }
+        if (err instanceof ClaudeCliTimeoutError) {
+            console.error(`[cf claudemd] timeout after ${err.timeoutMs}ms. Re-run with a faster network.`);
+            process.exit(1);
+            return;
+        }
+        if (err instanceof ClaudeCliExitError) {
+            console.error(`[cf claudemd] claude CLI exit ${err.exitCode}: ${err.stderrSnippet}`);
+            process.exit(1);
+            return;
+        }
+        console.error(`[cf claudemd] unexpected error: ${err.message}`);
+        process.exit(1);
+        return;
+    }
+    const body = parseClaudeMdBlock(raw);
+    if (body === null) {
+        const block = new ClaudeMdBlockMissingError(raw);
+        console.error(block.message);
+        process.exit(1);
+        return;
+    }
+    fs.writeFileSync(claudeMdPath, body.endsWith('\n') ? body : body + '\n', 'utf-8');
+    console.log(`CLAUDE.md ${command === 'init' ? 'generated' : 'updated'}: ${claudeMdPath}`);
+}
 export function register(program) {
     const cmd = program.command('claudemd').description('Manage CLAUDE.md files');
     cmd
@@ -12,32 +160,21 @@ export function register(program) {
         .description('Generate CLAUDE.md for current project')
         .option('--force', 'Overwrite existing CLAUDE.md')
         .action(async (opts) => {
-        const projectPath = process.cwd();
-        const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
-        // Check if CLAUDE.md already exists
-        if (fs.existsSync(claudeMdPath) && !opts.force) {
-            console.error('CLAUDE.md already exists. Use --force to overwrite.');
-            process.exit(1);
-        }
-        // Load config and AI provider
-        const config = new ConfigManager().get();
-        const apiKey = config.ai.api_key || process.env.ANTHROPIC_API_KEY;
-        if (!apiKey) {
-            console.error('Error: No API key configured.');
-            console.error('Set ANTHROPIC_API_KEY environment variable or run: cf config edit');
-            process.exit(1);
-        }
-        const storage = new SQLiteStorage(expandPath(config.storage.path));
-        const ai = new ClaudeProvider(apiKey, config.ai.model, config.ai.base_url);
-        const manager = new ClaudeMdManager(storage, ai);
-        console.log('Detecting tech stack...');
-        const stack = manager.generator.detector.detect(projectPath);
-        console.log(`Found: ${stack.language.join(', ')} | ${stack.framework.join(', ')}`);
-        console.log('Generating CLAUDE.md...');
-        const content = await manager.generator.generate(projectPath);
-        fs.writeFileSync(claudeMdPath, content, 'utf-8');
-        console.log(`✓ CLAUDE.md created at ${claudeMdPath}`);
-        storage.close();
+        await runClaudeMdWriter({
+            command: 'init',
+            projectPath: process.cwd(),
+            force: Boolean(opts.force),
+        });
+    });
+    cmd
+        .command('update')
+        .description('Re-generate CLAUDE.md preserving existing conventions blocks')
+        .action(async () => {
+        await runClaudeMdWriter({
+            command: 'update',
+            projectPath: process.cwd(),
+            force: true,
+        });
     });
     cmd
         .command('show')
@@ -56,14 +193,14 @@ export function register(program) {
         .command('persona')
         .description('Show detected persona for current project')
         .action(() => {
+        // R-A: persona detection is tech-stack driven and does NOT depend on an
+        // AI provider.  Previously this code path instantiated a dummy provider
+        // just to satisfy the ClaudeMdManager constructor; we now bypass the
+        // manager entirely and call PersonaManager directly to fully sever the
+        // dependency on the AI provider module from this CLI command.
         const projectPath = process.cwd();
-        const config = new ConfigManager().get();
-        const storage = new SQLiteStorage(expandPath(config.storage.path));
-        const ai = new ClaudeProvider('dummy', 'dummy'); // Not used for persona detection
-        const manager = new ClaudeMdManager(storage, ai);
-        const persona = manager.persona.load(projectPath);
+        const persona = new PersonaManager().load(projectPath);
         console.log(persona);
-        storage.close();
     });
 }
 //# sourceMappingURL=claudemd.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAyC/C"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4H/C"}

package/dist/cli/commands/config.js

@@ -1,7 +1,28 @@
 import fs from 'fs';
 import { FORGE_PATHS } from '../../core/constants.js';
+import { SQLiteStorage } from '../../core/storage/sqlite.js';
+import { ConfigManager } from '../../core/config.js';
+import { expandPath } from '../../core/utils/path.js';
+import { ConfigStore } from '../../daemon/config-store.js';
+/**
+ * Open the runtime KV store backed by `forge_config`. Used by the new
+ * `cf config list|get|set` subcommands (v9.x Phase 0 feature flags).
+ *
+ * Caller is responsible for closing the returned storage.
+ */
+function openConfigStore() {
+    const cfg = new ConfigManager().get();
+    const storage = new SQLiteStorage(expandPath(cfg.storage.path));
+    return { store: new ConfigStore(storage), storage };
+}
 export function register(program) {
-    const config = program.command('config').description('Manage configuration');
+    const config = program
+        .command('config')
+        .description('Manage configuration (runtime feature flags + YAML). ' +
+        'NOTE: `ai.*` / `skill_matching.*` fields were removed from the ' +
+        'ForgeConfig schema in spec 0902 sub-spec D R-D; any such keys still ' +
+        'present in `~/.claude-forge/config.yaml` are silently ignored. ' +
+        'AI flows use the local `claude` CLI subprocess.');
     config
         .command('show')
         .description('Print current configuration')
@@ -13,6 +34,24 @@ export function register(program) {
         }
         const content = fs.readFileSync(configPath, 'utf-8');
         console.log(content);
+        // sub-spec D R-D (spec 0902): warn users that ai.* / skill_matching.*
+        // schema is gone. Keep emit on stderr to avoid polluting machine-parsed
+        // `cf config show` stdout (yaml dump). Detected by grepping yaml
+        // content for `ai:` or `skill_matching:` top-level keys.
+        const hasLegacyAi = /^ai\s*:/m.test(content);
+        const hasLegacySkillMatch = /^skill_matching\s*:/m.test(content);
+        if (hasLegacyAi || hasLegacySkillMatch) {
+            const keys = [];
+            if (hasLegacyAi)
+                keys.push('`ai:`');
+            if (hasLegacySkillMatch)
+                keys.push('`skill_matching:`');
+            console.error('');
+            console.error(`\x1b[33m[deprecation]\x1b[0m ${keys.join(' + ')} block(s) ignored — ` +
+                'removed from ForgeConfig schema in spec 0902 sub-spec D R-D.');
+            console.error('\x1b[33m[deprecation]\x1b[0m AI flows (CLAUDE.md / Knowledge / Patch) ' +
+                'use `claude` CLI subprocess; delete these blocks to silence this warning.');
+        }
     });
     config
         .command('path')
@@ -38,5 +77,59 @@ export function register(program) {
             }
         });
     });
+    // ── Runtime KV (forge_config table) ──────────────────────────────────
+    // These manage feature flags / tuning knobs persisted in SQLite. Daemon
+    // seeds DEFAULT_FLAGS on startup; users flip them with `cf config set ...`.
+    config
+        .command('list')
+        .description('List all runtime config entries (forge_config table)')
+        .action(() => {
+        const { store, storage } = openConfigStore();
+        try {
+            const rows = store.list();
+            if (rows.length === 0) {
+                console.log('No config entries. Start the daemon to seed defaults.');
+                return;
+            }
+            // Two-column plain output; trivial to grep / pipe.
+            const keyWidth = Math.max(...rows.map(r => r.key.length));
+            for (const row of rows) {
+                console.log(`${row.key.padEnd(keyWidth)}  ${row.value}    (updated ${row.updated_at})`);
+            }
+        }
+        finally {
+            storage.close();
+        }
+    });
+    config
+        .command('get <key>')
+        .description('Print a single runtime config value (forge_config table)')
+        .action((key) => {
+        const { store, storage } = openConfigStore();
+        try {
+            const value = store.get(key);
+            if (value === undefined) {
+                console.error(`Key not set: ${key}`);
+                process.exit(1);
+            }
+            console.log(value);
+        }
+        finally {
+            storage.close();
+        }
+    });
+    config
+        .command('set <key> <value>')
+        .description('Set a runtime config value (forge_config table)')
+        .action((key, value) => {
+        const { store, storage } = openConfigStore();
+        try {
+            store.set(key, value);
+            console.log(`✓ ${key} = ${value}`);
+        }
+        finally {
+            storage.close();
+        }
+    });
 }
 //# sourceMappingURL=config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE7E,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;QAChE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAChE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/commands/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D;;;;;GAKG;AACH,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,IAAI,aAAa,EAAE,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,OAAO,EAAE,KAAK,EAAE,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAgB;IACvC,MAAM,MAAM,GAAG,OAAO;SACnB,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CACV,uDAAuD;QACvD,iEAAiE;QACjE,sEAAsE;QACtE,iEAAiE;QACjE,iDAAiD,CAClD,CAAC;IAEJ,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrB,sEAAsE;QACtE,wEAAwE;QACxE,iEAAiE;QACjE,yDAAyD;QACzD,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,mBAAmB,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjE,IAAI,WAAW,IAAI,mBAAmB,EAAE,CAAC;YACvC,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,WAAW;gBAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,mBAAmB;gBAAE,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAClB,OAAO,CAAC,KAAK,CACX,gCAAgC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB;gBACtE,8DAA8D,CAC/D,CAAC;YACF,OAAO,CAAC,KAAK,CACX,wEAAwE;gBACxE,2EAA2E,CAC5E,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wBAAwB,CAAC;SACrC,MAAM,CAAC,GAAG,EAAE;QACX,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,+BAA+B,CAAC;SAC5C,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC;QACxC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;QAChE,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAChE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACxB,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEL,wEAAwE;IACxE,wEAAwE;IACxE,4EAA4E;IAE5E,MAAM;SACH,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,sDAAsD,CAAC;SACnE,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YAC1B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;gBACrE,OAAO;YACT,CAAC;YACD,mDAAmD;YACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,KAAK,gBAAgB,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC;YAC1F,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,0DAA0D,CAAC;SACvE,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE;QACtB,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,CAAC,KAAK,CAAC,gBAAgB,GAAG,EAAE,CAAC,CAAC;gBACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM;SACH,OAAO,CAAC,mBAAmB,CAAC;SAC5B,WAAW,CAAC,iDAAiD,CAAC;SAC9D,MAAM,CAAC,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE;QACrC,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,eAAe,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

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

@@ -27,5 +27,44 @@
  * the commands print a clear "not supported" error.
  */
 import type { Command } from 'commander';
+import { type LaunchdStatus } from '../../daemon/launchd-installer.js';
+export declare function resolveRunningPid(): number | null;
+/**
+ * `cf daemon start` <-> LaunchAgent mutex decision (spec 1713 / 2026-05-28).
+ *
+ * When both `cf daemon start` (P1) and the LaunchAgent (P2) try to spawn the
+ * daemon, P2 EADDRINUSEs on the web port. With KeepAlive.Crashed=true +
+ * ThrottleInterval=10s, launchd enters an infinite crash-restart loop. This
+ * pure function decides what `cf daemon start` should do, given the already-
+ * running PID (if any) and the LaunchAgent state:
+ *
+ *   - existingPid set                  → noop-already-running (any platform)
+ *   - non-darwin / no LaunchAgent      → self-spawn (launchd can't fight us)
+ *   - LA loaded with live pid          → noop-launchagent-managing (LA owns it)
+ *   - LA loaded but down (no pid)      → kickstart-launchagent (let LA spawn)
+ *   - LA plist on disk but not loaded  → self-spawn (launchd won't fight us)
+ *
+ * Kept side-effect-free so it can be unit-tested in isolation (same pattern as
+ * the ensure-running decision helper).
+ */
+export interface StartStrategyInput {
+    existingPid: number | null;
+    platform: NodeJS.Platform | string;
+    launchdStatus: LaunchdStatus | null;
+}
+export interface StartStrategy {
+    action: 'noop-already-running' | 'noop-launchagent-managing' | 'kickstart-launchagent' | 'self-spawn';
+    pid?: number;
+}
+export declare function decideStartStrategy(input: StartStrategyInput): StartStrategy;
+/**
+ * Spawn the daemon as a detached background child process. Returns the
+ * spawned PID (may be `undefined` if Node failed to allocate one before
+ * `unref`). Used by `cf daemon start` and `cf init --full`
+ * (spec ed8cf2db §5 refactor — single-source detached-spawn primitive).
+ */
+export declare function spawnDaemonDetached(opts?: {
+    noWeb?: boolean;
+}): number | undefined;
 export declare function register(program: Command): void;
 //# sourceMappingURL=daemon.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2N/C"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,mCAAmC,CAAC;AAsC3C,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAIjD;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC;IACnC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EACF,sBAAsB,GACtB,2BAA2B,GAC3B,uBAAuB,GACvB,YAAY,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,kBAAkB,GAAG,aAAa,CA2B5E;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,MAAM,GAAG,SAAS,CAkBtF;AAWD,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkT/C"}