@winspan/claude-forge 8.41.0 → 8.51.0

package/dist/claudemd/tech-detector.d.ts

@@ -15,6 +15,7 @@ export declare class TechDetector {
     private detectGo;
     private detectRust;
     private detectPython;
+    private detectJava;
     private readJson;
 }
 //# sourceMappingURL=tech-detector.d.ts.map

package/dist/claudemd/tech-detector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tech-detector.d.ts","sourceRoot":"","sources":["../../src/claudemd/tech-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyBD,qBAAa,YAAY;IACvB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAgBtC,OAAO,CAAC,iBAAiB;IA+CzB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,QAAQ;CAOjB"}
+{"version":3,"file":"tech-detector.d.ts","sourceRoot":"","sources":["../../src/claudemd/tech-detector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAyBD,qBAAa,YAAY;IACvB,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS;IAiBtC,OAAO,CAAC,iBAAiB;IA+CzB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,UAAU;IAuDlB,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/claudemd/tech-detector.js

@@ -30,6 +30,7 @@ export class TechDetector {
             framework: [],
             packageManager: 'npm',
         };
+        this.detectJava(projectPath, stack);
         this.detectPackageJson(projectPath, stack);
         this.detectTypeScript(projectPath, stack);
         this.detectGo(projectPath, stack);
@@ -130,6 +131,58 @@ export class TechDetector {
             }
         }
     }
+    detectJava(projectPath, stack) {
+        const hasPom = existsSync(join(projectPath, 'pom.xml'));
+        const hasGradle = existsSync(join(projectPath, 'build.gradle')) || existsSync(join(projectPath, 'build.gradle.kts'));
+        if (!hasPom && !hasGradle)
+            return;
+        stack.language.push('Java');
+        if (hasGradle) {
+            stack.packageManager = 'gradle';
+            stack.testFramework = 'JUnit';
+            // Detect Kotlin
+            if (existsSync(join(projectPath, 'build.gradle.kts'))) {
+                stack.language.push('Kotlin');
+            }
+            // Detect Spring Boot from build.gradle
+            try {
+                const gradleFile = existsSync(join(projectPath, 'build.gradle.kts'))
+                    ? join(projectPath, 'build.gradle.kts')
+                    : join(projectPath, 'build.gradle');
+                const content = readFileSync(gradleFile, 'utf-8');
+                if (content.includes('spring-boot') || content.includes('org.springframework')) {
+                    stack.framework.push('Spring Boot');
+                }
+                if (content.includes('mybatis')) {
+                    stack.framework.push('MyBatis');
+                }
+            }
+            catch { /* ignore */ }
+        }
+        else if (hasPom) {
+            stack.packageManager = 'maven';
+            stack.testFramework = 'JUnit';
+            // Detect frameworks from pom.xml
+            try {
+                const content = readFileSync(join(projectPath, 'pom.xml'), 'utf-8');
+                if (content.includes('spring-boot') || content.includes('org.springframework')) {
+                    stack.framework.push('Spring Boot');
+                }
+                if (content.includes('mybatis')) {
+                    stack.framework.push('MyBatis');
+                }
+                if (content.includes('dubbo')) {
+                    stack.framework.push('Dubbo');
+                }
+                // Detect Java version
+                const javaVersionMatch = content.match(/<java\.version>(\d+)<\/java\.version>/);
+                if (javaVersionMatch) {
+                    stack.language[stack.language.indexOf('Java')] = `Java ${javaVersionMatch[1]}`;
+                }
+            }
+            catch { /* ignore */ }
+        }
+    }
     readJson(filePath) {
         try {
             return JSON.parse(readFileSync(filePath, 'utf-8'));

package/dist/claudemd/tech-detector.js.map

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

package/dist/claudemd/templates/swarm-protocol.md

@@ -0,0 +1,222 @@
+# claude-forge 工作区规范
+
+## 自检（每次响应前必读）
+
+**在开始任何操作前，先问自己**：
+
+1. 我是否要修改 ≥2 个文件？
+2. 我是否要修改 ≥10 行代码？
+3. 这是否是新功能/重构/Bug 修复？
+4. 我修改的代码所在模块**测试覆盖率 < 50%** 吗？
+
+**如果 1-3 任一答案是"是"，且我没有 spawn Agent**：
+- ❌ 停下来 → 重新评估例外 → 否则立即 spawn Agent
+
+**如果 4 答案是"是"**（改老代码 + 测试薄弱）：
+- ❌ 不要 spawn 普通 `coder` / `planner`
+- ✅ 必须走 **Harness 或 Hybrid 工作流**（详见下方「工作流升级判定」）
+
+**违规示例**：
+- "修复 daemon handler bug（改老代码 + 0 测试）" → 应走 `harness-hotfix`，不是 `coder`
+- "重构 738 行字面量为 .md 文件" → 应走 `refactor-safe`，不是 `coder`
+- "新功能加在 hook 脚本" → 应走 `hybrid-feature-with-safety`，不是 `planner+coder`
+
+---
+
+## 核心行为规则
+
+- Do what has been asked; nothing more, nothing less
+- NEVER create files unless absolutely necessary
+- ALWAYS prefer editing existing files to creating new ones
+- ALWAYS read a file before editing it
+- Never continuously check status after spawning agents — wait for results
+
+---
+
+## Two-Phase Workflow (BMAD 默认路径)
+
+**适用范围**：≥3 文件改动 / 新功能 / 重构 / 架构调整
+**前提**：通过「工作流升级判定」确认为 BMAD 路径（测试覆盖充分 / 全新模块）
+**如果改老代码 + 测试薄弱** → 改走 Harness/Hybrid 三阶段（见下方）
+
+### Phase 1: Generate Spec
+
+1. Spawn planner/researcher agent with `run_in_background: true`
+2. Agent 输出 `docs/design/[task]-spec-YYYYMMDD-HHMM.md`，包含：
+   - 目标、改动文件清单、关键设计决策、风险点、测试策略
+   - **禁止写任何代码**
+3. 主线程告诉用户"已 spawn planner，等待 spec 生成"，**然后结束响应**
+
+### Phase 1.5: User Review (Critical Gate)
+
+Agent 完成后，**主线程必须停止并等待用户确认**：
+
+```
+设计方案已生成：docs/design/xxx-spec.md
+
+请 review 后回复：
+- "批准" / "approve" → 我会 spawn coder 实现
+- "修改 [意见]" → 我会调整 spec
+- "取消" → 停止任务
+```
+
+**绝对禁止**：
+- ❌ 主线程自行判断 spec 质量并进入 Phase 2
+- ❌ 主线程直接 spawn coder 而不等用户确认
+
+### Phase 2: Implement per Spec
+
+收到用户"批准"后：
+1. Spawn coder agent with `run_in_background: true`
+2. 严格按 spec 执行，完成后写 `docs/implementation/[task]-changelog-YYYYMMDD-HHMM.md`
+
+### 例外
+
+可跳过两阶段：
+- 单文件 1-2 行修改
+- 用户明确说"不需要 spec"
+- 纯查询/调研任务
+
+---
+
+## Agent 委托规则
+
+### 默认行为：spawn Agent
+
+接到任务时，**第一反应是 spawn Agent**。主线程只做协调。
+
+### 不 spawn 的例外（仅 4 条）
+
+1. **单行 typo**：1 文件 1 行拼写错误
+2. **协调与汇总**：整合 Agent 结果
+3. **元任务（极小改动）**：git commit/push、daemon 启停、单行规则调整
+4. **即时问答**：不涉及代码/文件的纯对话
+
+**注意**：
+- 例外 #3 不包括"重构 CLAUDE.md"、"修改多个配置文件"等大改动
+- 如果改动 ≥2 文件或 ≥10 行，必须 spawn Agent
+
+### 强制 spawn 的场景
+
+以下必须 spawn Agent：
+- 查/找/看/列出 → Explore agent
+- 函数分析/代码阅读 → doc-reviewer
+- 单文件 2+ 行修改 → coder
+- 实现/修复/重构/优化 → 对应 agent
+
+### 强制理由声明
+
+每次不 spawn 时，必须在响应开头说明：
+
+> 不 spawn 理由：例外 #N [具体原因]
+
+---
+
+## 工作流升级判定（spawn agent 前必查）
+
+**默认是 BMAD（planner+coder）**，但满足下表条件**必须升级到 Harness/Hybrid**。
+
+### 判定表
+
+| 任务特征 | 推荐 agent | 工作流序列 |
+|---------|-----------|----------|
+| **改老代码 + 模块测试覆盖 < 50%** | `refactor-safe` | safety-net → design → implement → test → review |
+| **已知原因的 Bug 修复**（紧急/明确）| `harness-hotfix` | safety-net → fix → verify |
+| **未知/偶发 Bug**（需先定位）| `harness-debug-full` | reproduce → safety-net → root-cause → fix → verify |
+| **新功能改老代码 + 测试薄弱** | `hybrid-feature-with-safety` | safety-net → analyze → design → implement → test → review |
+| **先修 bug 再加功能** | `hybrid-fix-then-feature` | reproduce → fix → verify → design → implement → review |
+| **全新模块 / 测试充分**（覆盖 ≥50%）| `planner` + `coder` | BMAD analyze → design → implement |
+| **纯调研 / 单行 typo / 元任务** | 不 spawn 或 `Explore` | — |
+
+### 测试覆盖快速判定
+
+修改 `src/<module>/` 前必查：
+
+```bash
+SRC=$(find src/<module> -name "*.ts" -not -name "*.test.ts" 2>/dev/null | wc -l)
+TST=$(find tests/unit/<module> src/tests -name "*.test.ts" 2>/dev/null | wc -l)
+echo "ratio: $TST / $SRC"
+```
+
+`TST/SRC < 50%` → **触发 Harness safety-net 阶段**（不要直接改代码）
+
+### 项目模块覆盖现状（提醒）
+
+| 模块 | 覆盖判定 | 默认走 |
+|------|---------|--------|
+| `src/daemon/handlers/` | 部分（≥50%）| BMAD，但 hotfix 类 bug 走 `harness-hotfix` |
+| `src/daemon/services/` | **零测试** | **Harness/Hybrid 强制** |
+| `src/core/storage/` | 高（≥80%）| BMAD |
+| `src/core/queue/` | 高（新写时已加）| BMAD |
+| `src/skills/` | 中（~40%）| 大改走 `refactor-safe` |
+| `src/web/routes/` | 中 | BMAD |
+| `src/hooks/*.sh` | 0（无 sh 测试）| 改 hook 必走 Hybrid |
+| `src/claudemd/` | 低 | `refactor-safe` |
+
+### 违规自查
+
+过去 5 次任务全踩坑，请引以为戒：
+
+- ❌ "修复 daemon schema 收紧拒收 bug"（改 events.ts + 5 个 hook）→ 走了 `coder`，应走 `harness-hotfix`
+- ❌ "Official Skills 数据分离"（重构 738 行老代码）→ 走了 `planner+coder`，应走 `refactor-safe`
+- ❌ "Hook 失败缓冲队列"（新功能 + 改 4 个老 hook）→ 走了 `planner+coder`，应走 `hybrid-feature-with-safety`
+
+**判定时机**：在「自检」之后、「Two-Phase Workflow」之前。判定结果若是 Harness/Hybrid，跳过 Two-Phase，直接 spawn 对应 agent。
+
+---
+
+## 并发规则
+
+- All operations MUST be concurrent/parallel in ONE message
+- ALWAYS batch ALL agents in ONE message with `run_in_background: true`
+- ALWAYS batch ALL file reads/writes/edits in ONE message
+- ALWAYS batch ALL terminal operations in ONE Bash message
+
+---
+
+## 项目特定信息
+
+### 技术栈
+
+- **语言**: TypeScript (Node.js 24+)
+- **数据库**: SQLite (better-sqlite3)
+- **前端**: React 18 + Vite + Tailwind + react-router-dom + react-query + Recharts（`web/` 目录，build 后被 cp 到 dist/web/static/）
+- **测试**: Vitest
+
+### 架构要点
+
+**分层**：
+- `src/cli/` — CLI 命令
+- `src/daemon/` — 后台守护进程（事件处理）
+- `src/web/` — Web 仪表盘
+- `src/core/` — 共享核心（storage/config/types）
+- `src/claudemd/` — CLAUDE.md 生成器
+- `src/skills/` — Skill 匹配与注入
+
+**存储**：
+- 主库：`~/.claude-forge/data.db`
+- 表：sessions, events, tasks, routing_events, skill_invocations, token_usage
+
+### 开发规范
+
+**构建与测试**：
+```bash
+npm run build        # 构建前后端
+npm test             # 运行测试
+./scripts/dev-daemon.sh restart  # 重启 daemon
+```
+
+**守护进程事件推送**：
+- PreToolUse / PostToolUse / UserPromptSubmit / Stop / Notification
+- 通过 Unix socket 推送到 daemon
+
+**注意**：
+- daemon 和 CLI 都用系统 node（v26）
+- better-sqlite3 12.10.0 支持 v26
+- 修改 schema 需要手动迁移（无自动 migration）
+
+---
+
+## 上次工作续接
+
+（由 daemon 自动更新，记录最近任务上下文）

package/dist/cli/commands/claudemd.js

@@ -21,14 +21,14 @@ export function register(program) {
         }
         // Load config and AI provider
         const config = new ConfigManager().get();
-        const apiKey = config.distill.api_key || process.env.ANTHROPIC_API_KEY;
+        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.distill.model, config.distill.base_url);
+        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);

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/daemon.d.ts

@@ -1,3 +1,31 @@
+/**
+ * Forge daemon management CLI.
+ *
+ * Three ways to run the daemon:
+ *   1. Manual one-shot:    `cf daemon start` / `cf daemon stop`
+ *      Spawns a detached child process; no auto-restart on crash.
+ *
+ *   2. Local development:  `./scripts/dev-daemon.sh start`
+ *      Always uses the repo's `dist/daemon/index.js` build.
+ *
+ *   3. System service:     `cf daemon install`
+ *      Installs a macOS LaunchAgent at
+ *      `~/Library/LaunchAgents/com.claude-forge.daemon.plist`. With
+ *      `KeepAlive = { Crashed: true }` the daemon auto-restarts on crash
+ *      (OOM-kill, signal kill, uncaught exception). Normal exits via
+ *      `cf daemon stop` do NOT trigger a restart (`SuccessfulExit: false`).
+ *      `ThrottleInterval=10s` rate-limits restart loops.
+ *
+ * LaunchAgent logs:
+ *   ~/.claude-forge/daemon-stdout.log
+ *   ~/.claude-forge/daemon-stderr.log
+ *
+ * Uninstall:
+ *   cf daemon uninstall   # bootouts the service and removes the plist
+ *
+ * Platform: install/uninstall/launchd-status are macOS-only. On other platforms
+ * the commands print a clear "not supported" error.
+ */
 import type { Command } from 'commander';
 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":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8CzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuD/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;AA0DzC,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA2N/C"}

package/dist/cli/commands/daemon.js

@@ -1,11 +1,42 @@
+/**
+ * Forge daemon management CLI.
+ *
+ * Three ways to run the daemon:
+ *   1. Manual one-shot:    `cf daemon start` / `cf daemon stop`
+ *      Spawns a detached child process; no auto-restart on crash.
+ *
+ *   2. Local development:  `./scripts/dev-daemon.sh start`
+ *      Always uses the repo's `dist/daemon/index.js` build.
+ *
+ *   3. System service:     `cf daemon install`
+ *      Installs a macOS LaunchAgent at
+ *      `~/Library/LaunchAgents/com.claude-forge.daemon.plist`. With
+ *      `KeepAlive = { Crashed: true }` the daemon auto-restarts on crash
+ *      (OOM-kill, signal kill, uncaught exception). Normal exits via
+ *      `cf daemon stop` do NOT trigger a restart (`SuccessfulExit: false`).
+ *      `ThrottleInterval=10s` rate-limits restart loops.
+ *
+ * LaunchAgent logs:
+ *   ~/.claude-forge/daemon-stdout.log
+ *   ~/.claude-forge/daemon-stderr.log
+ *
+ * Uninstall:
+ *   cf daemon uninstall   # bootouts the service and removes the plist
+ *
+ * Platform: install/uninstall/launchd-status are macOS-only. On other platforms
+ * the commands print a clear "not supported" error.
+ */
 import fs from 'fs';
 import path from 'path';
 import { spawn, execSync } from 'child_process';
-import { FORGE_HOME } from '../../core/constants.js';
+import { FORGE_PATHS, DEFAULTS } from '../../core/constants.js';
 import { fileURLToPath } from 'url';
+import { install as installLaunchAgent, uninstall as uninstallLaunchAgent, status as launchdStatus, PLIST_PATH, LAUNCHD_LABEL, } from '../../daemon/launchd-installer.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const PID_FILE = path.join(FORGE_HOME, 'daemon.pid');
-const DEFAULT_PORT = 3721;
+const PID_FILE = FORGE_PATHS.daemonPid();
+const DEFAULT_PORT = DEFAULTS.WEB_PORT;
+const STDOUT_LOG = FORGE_PATHS.daemonStdout();
+const STDERR_LOG = FORGE_PATHS.daemonStderr();
 function readPid() {
     if (!fs.existsSync(PID_FILE))
         return null;
@@ -32,24 +63,29 @@ function isAlive(pid) {
         return false;
     }
 }
-function isRunning() {
-    const pid = readPid();
-    if (pid && isAlive(pid))
-        return true;
-    return findPidByPort(DEFAULT_PORT) !== null;
-}
 function resolveRunningPid() {
     const pid = readPid();
     if (pid && isAlive(pid))
         return pid;
     return findPidByPort(DEFAULT_PORT);
 }
+function tailFile(filePath, lines) {
+    if (!fs.existsSync(filePath))
+        return '';
+    try {
+        return execSync(`tail -n ${lines} ${JSON.stringify(filePath)}`, { encoding: 'utf-8' });
+    }
+    catch {
+        return '';
+    }
+}
 export function register(program) {
     const daemon = program.command('daemon').description('Manage the Forge daemon');
     daemon
         .command('start')
         .description('Start the daemon')
         .option('-f, --foreground', 'Run in foreground')
+        .option('--no-web', 'Start daemon without the web server')
         .action(async (opts) => {
         const existingPid = resolveRunningPid();
         if (existingPid) {
@@ -59,17 +95,24 @@ export function register(program) {
         if (opts.foreground) {
             console.log('Starting daemon in foreground...');
             const { startDaemon } = await import('../../daemon/index.js');
-            await startDaemon(true);
+            await startDaemon(true, { web: opts.web });
             return;
         }
         // Background mode: spawn detached child process
         const daemonScript = path.resolve(__dirname, '../../daemon/index.js');
-        const logFile = path.join(FORGE_HOME, 'daemon.log');
+        const logFile = FORGE_PATHS.daemonLog();
         const out = fs.openSync(logFile, 'a');
+        const env = {
+            ...process.env,
+            FORGE_DAEMON_FOREGROUND: '1',
+        };
+        if (!opts.web) {
+            env.FORGE_DAEMON_NO_WEB = '1';
+        }
         const child = spawn(process.execPath, [daemonScript], {
             detached: true,
             stdio: ['ignore', out, out],
-            env: { ...process.env, FORGE_DAEMON_FOREGROUND: '1' },
+            env,
         });
         child.unref();
         console.log(`Daemon started (PID: ${child.pid})`);
@@ -94,5 +137,154 @@ export function register(program) {
             console.error('Failed to stop daemon:', err);
         }
     });
+    daemon
+        .command('install')
+        .description('Install the daemon as a macOS LaunchAgent (auto-restart on crash)')
+        .option('--dev', 'Use the local dist build instead of the global install')
+        .option('--node <path>', 'Override the node binary path')
+        .option('--daemon-path <path>', 'Override the daemon entry path')
+        .action(async (opts) => {
+        try {
+            const result = installLaunchAgent({
+                dev: Boolean(opts.dev),
+                nodePath: opts.node,
+                daemonPath: opts.daemonPath,
+            });
+            console.log('LaunchAgent installed.');
+            console.log(`  plist:  ${result.plistPath}`);
+            console.log(`  node:   ${result.nodePath}`);
+            console.log(`  daemon: ${result.daemonPath}`);
+            if (result.reloaded) {
+                console.log('  (reloaded existing LaunchAgent)');
+            }
+            console.log('');
+            console.log(`Logs: ${STDOUT_LOG}`);
+            console.log(`      ${STDERR_LOG}`);
+            console.log(`Run 'cf daemon status' to verify.`);
+        }
+        catch (err) {
+            console.error(`Install failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+    daemon
+        .command('uninstall')
+        .description('Uninstall the daemon LaunchAgent')
+        .action(async () => {
+        try {
+            const result = uninstallLaunchAgent();
+            if (!result.bootedOut && !result.removedPlist) {
+                console.log('LaunchAgent not installed (nothing to do).');
+                return;
+            }
+            console.log('LaunchAgent uninstalled.');
+            if (result.bootedOut)
+                console.log('  bootout: ok');
+            if (result.removedPlist)
+                console.log(`  removed: ${PLIST_PATH}`);
+        }
+        catch (err) {
+            console.error(`Uninstall failed: ${err instanceof Error ? err.message : String(err)}`);
+            process.exitCode = 1;
+        }
+    });
+    daemon
+        .command('status')
+        .description('Show daemon status (process + LaunchAgent on macOS)')
+        .action(async () => {
+        const pid = resolveRunningPid();
+        if (pid) {
+            console.log(`Daemon process: running (PID: ${pid})`);
+        }
+        else {
+            console.log('Daemon process: not running');
+        }
+        if (process.platform !== 'darwin') {
+            return;
+        }
+        try {
+            const s = launchdStatus();
+            console.log('');
+            console.log(`LaunchAgent (${LAUNCHD_LABEL}):`);
+            console.log(`  installed: ${s.installed ? 'yes' : 'no'}`);
+            console.log(`  loaded:    ${s.loaded ? 'yes' : 'no'}`);
+            if (s.loaded) {
+                console.log(`  pid:       ${s.pid ?? '(not running)'}`);
+                if (s.state)
+                    console.log(`  state:     ${s.state}`);
+                if (s.lastExitCode !== null) {
+                    console.log(`  last exit: ${s.lastExitCode}`);
+                }
+            }
+            else if (s.installed) {
+                console.log(`  note:      plist exists but not loaded — try 'cf daemon install'`);
+            }
+            else if (s.raw) {
+                // Hide the noisy "Could not find" error when not installed.
+                if (!/Could not find specified service/i.test(s.raw)) {
+                    console.log(`  detail:    ${s.raw.split('\n')[0]}`);
+                }
+            }
+        }
+        catch (err) {
+            console.error(`LaunchAgent status unavailable: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    });
+    daemon
+        .command('logs')
+        .description('Show recent daemon logs (LaunchAgent stdout/stderr)')
+        .option('-n, --lines <count>', 'Number of lines to show', '40')
+        .option('-f, --follow', 'Follow stderr log (Ctrl+C to exit)')
+        .action(async (opts) => {
+        const lines = parseInt(opts.lines, 10) || 40;
+        if (opts.follow) {
+            if (!fs.existsSync(STDERR_LOG)) {
+                console.error(`Log file not found: ${STDERR_LOG}`);
+                process.exitCode = 1;
+                return;
+            }
+            const child = spawn('tail', ['-f', '-n', String(lines), STDERR_LOG], {
+                stdio: 'inherit',
+            });
+            child.on('exit', (code) => {
+                process.exitCode = code ?? 0;
+            });
+            return;
+        }
+        const stdout = tailFile(STDOUT_LOG, lines);
+        const stderr = tailFile(STDERR_LOG, lines);
+        if (!stdout && !stderr) {
+            console.log('No LaunchAgent logs yet.');
+            console.log(`  expected: ${STDOUT_LOG}`);
+            console.log(`            ${STDERR_LOG}`);
+            return;
+        }
+        if (stdout) {
+            console.log(`=== ${STDOUT_LOG} (last ${lines} lines) ===`);
+            console.log(stdout.trimEnd());
+        }
+        if (stderr) {
+            if (stdout)
+                console.log('');
+            console.log(`=== ${STDERR_LOG} (last ${lines} lines) ===`);
+            console.log(stderr.trimEnd());
+        }
+        // Show launchctl restart counter on darwin.
+        if (process.platform === 'darwin') {
+            try {
+                const s = launchdStatus();
+                if (s.loaded && s.raw) {
+                    const exitsMatch = s.raw.match(/^\s*last exit code\s*=\s*(-?\d+)/mi);
+                    if (exitsMatch) {
+                        console.log('');
+                        console.log(`launchd last exit code: ${exitsMatch[1]}`);
+                    }
+                }
+            }
+            catch {
+                // ignore
+            }
+        }
+    });
 }
 //# sourceMappingURL=daemon.js.map