@wandoupeas/coding-forge 0.1.0

package/dist/cli/commands/run.js

@@ -0,0 +1,161 @@
+/**
+ * run 命令 - runtime 兼容入口
+ * CLI 仅负责参数解析和结果渲染，真正执行交给 core/runtime。
+ */
+import { Command } from 'commander';
+import logger from '../utils/logger.js';
+import { reviewTaskDeliverables } from '../../agent/index.js';
+import { listDeliverables } from '../../core/deliverable.js';
+import { runReadyTasks } from '../../core/runtime.js';
+import { loadWorkspaceState } from '../../core/workspace.js';
+export function createRunCommand() {
+    return new Command('run')
+        .description('执行 ready 队列中的任务（兼容层，内部走 runtime core）')
+        .option('-d, --dry-run', '仅预览 runtime 将要执行的 ready 队列')
+        .option('-n, --limit <count>', '最多执行的 ready 任务数', parsePositiveInteger)
+        .option('-p, --phase <id>', '兼容选项：保留旧参数，但当前 runtime 不直接按 phase 过滤')
+        .option('-w, --worker <role>', '兼容选项：保留旧参数，但当前 runtime 不直接按 worker 过滤')
+        .option('--auto', '兼容选项：runtime 已默认按 ready 队列批量执行')
+        .option('-s, --superpowers', '兼容选项：superpowers 由规划与技能体系决定', true)
+        .option('-e, --execution <mode>', '兼容选项：CLI 不再直接切换 execution mode', 'subagent')
+        .option('--session <id>', '覆盖默认生成的 runtime session id')
+        .action(async (options) => {
+        try {
+            await runCommand(options);
+        }
+        catch (error) {
+            logger.error(`运行失败: ${error}`);
+            process.exit(1);
+        }
+    });
+}
+export async function runCommand(options, basePath = process.cwd()) {
+    logger.h1('🚀 Runtime 执行入口');
+    renderCompatibilityWarnings(options);
+    if (options.dryRun) {
+        await renderDryRun(basePath, options.limit);
+        return;
+    }
+    const result = await runReadyTasks(basePath, {
+        limit: options.limit,
+        sessionId: options.session
+    });
+    renderRunSummary(result);
+}
+function renderCompatibilityWarnings(options) {
+    if (options.auto) {
+        logger.info('`--auto` 已成为默认行为，runtime 会按 ready 队列连续处理任务。');
+    }
+    if (options.phase) {
+        logger.warning(`当前兼容层尚未将 \`--phase ${options.phase}\` 下推到 runtime core，已按全局 ready 队列执行。`);
+    }
+    if (options.worker) {
+        logger.warning(`当前兼容层尚未将 \`--worker ${options.worker}\` 下推到 runtime core，已按任务分配规则执行。`);
+    }
+    if (options.execution && options.execution !== 'subagent') {
+        logger.warning(`\`--execution ${options.execution}\` 仅为兼容保留；执行模式现在由 agent 自身和 skills 决定。`);
+    }
+    if (options.superpowers === false) {
+        logger.warning('`--no-superpowers` 仅为兼容保留；CLI 不再直接切换 superpowers，相关行为由规划结果与技能路由决定。');
+    }
+}
+async function renderDryRun(basePath, limit) {
+    const workspace = await loadWorkspaceState(basePath);
+    const readyTasks = getReadyTasks(workspace.tasks.tasks, limit);
+    logger.h2('Runtime 预览');
+    logger.info(`status: ${workspace.runtime.status}`);
+    logger.info(`session: ${workspace.runtime.sessionId ?? 'none'}`);
+    logger.info(`summary: ${workspace.runtime.summary}`);
+    logger.info(`ready tasks: ${readyTasks.length}`);
+    if (readyTasks.length > 0) {
+        console.log();
+        logger.h2('即将执行的任务');
+        for (const task of readyTasks.slice(0, 5)) {
+            console.log(`  ${task.id}: ${task.title} (${task.assignee}) [${task.phase}]`);
+        }
+    }
+    else {
+        logger.info('当前没有 ready task。');
+    }
+}
+function renderRunSummary(result) {
+    console.log();
+    logger.h2('Runtime 执行结果');
+    logger.info(`session: ${result.sessionId}`);
+    logger.info(`processed: ${result.processed}`);
+    logger.info(`completed: ${result.completed}`);
+    logger.info(`failed: ${result.failed}`);
+    logger.info(`blocked: ${result.blocked}`);
+    logger.info(`deliverables: ${result.deliverables}`);
+    console.log();
+    logger.info('下一步:');
+    logger.list([
+        'webforge dashboard        # 查看 runtime / task / session 状态',
+        'webforge resume           # 查看恢复建议与 next action',
+        'webforge deliverables     # 查看交付物'
+    ]);
+}
+function getReadyTasks(tasks, limit) {
+    const readyTasks = tasks
+        .filter((task) => task.status === 'ready')
+        .sort((left, right) => {
+        if (left.priority !== right.priority) {
+            return left.priority - right.priority;
+        }
+        const createdAtDiff = new Date(left.created_at).getTime() - new Date(right.created_at).getTime();
+        if (createdAtDiff !== 0) {
+            return createdAtDiff;
+        }
+        return left.id.localeCompare(right.id);
+    });
+    if (limit === undefined) {
+        return readyTasks;
+    }
+    return readyTasks.slice(0, limit);
+}
+function parsePositiveInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isInteger(parsed) || parsed <= 0) {
+        throw new Error(`Expected a positive integer, received: ${value}`);
+    }
+    return parsed;
+}
+export function createDeliverablesCommand(basePath = process.cwd()) {
+    return new Command('deliverables')
+        .description('查看交付物')
+        .argument('[task-id]', '任务 ID')
+        .action(async (taskId) => {
+        if (taskId) {
+            await reviewTaskDeliverables(taskId, basePath);
+            return;
+        }
+        const deliverables = await listDeliverables(undefined, basePath);
+        console.log(`\n📦 所有交付物 (${deliverables.length}):\n`);
+        const grouped = {
+            pending_review: deliverables.filter((item) => item.status === 'pending_review'),
+            approved: deliverables.filter((item) => item.status === 'approved'),
+            rejected: deliverables.filter((item) => item.status === 'rejected')
+        };
+        if (grouped.pending_review.length > 0) {
+            console.log('⏳ 待审核:');
+            for (const item of grouped.pending_review) {
+                console.log(`   • ${item.taskId}: ${item.title}`);
+            }
+            console.log();
+        }
+        if (grouped.approved.length > 0) {
+            console.log('✅ 已通过:');
+            for (const item of grouped.approved) {
+                console.log(`   • ${item.taskId}: ${item.title}`);
+            }
+            console.log();
+        }
+        if (grouped.rejected.length > 0) {
+            console.log('❌ 已拒绝:');
+            for (const item of grouped.rejected) {
+                console.log(`   • ${item.taskId}: ${item.title}`);
+            }
+        }
+    });
+}
+//# sourceMappingURL=run.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * superpowers 命令 - 记录外部 workflow 的回写结果
+ */
+import { Command } from 'commander';
+import type { WorkspaceSuperpowersRun } from '../../types/index.js';
+export interface RecordSuperpowersRunOptions {
+    summary: string;
+    task?: string;
+    session?: string;
+    artifact: string[];
+    owner?: string;
+    wave?: string;
+    thread?: string;
+    branch?: string;
+    worktree?: string;
+    compactFrom?: string;
+    json?: boolean;
+}
+export declare function createSuperpowersCommand(basePath?: string): Command;
+export declare function recordSuperpowersRunCommand(workflow: string, options: RecordSuperpowersRunOptions, basePath?: string): Promise<WorkspaceSuperpowersRun>;
+//# sourceMappingURL=superpowers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"superpowers.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/superpowers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,KAAK,EAGV,uBAAuB,EACxB,MAAM,sBAAsB,CAAC;AAG9B,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAiClF;AAED,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,2BAA2B,EACpC,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAqClC"}

package/dist/cli/commands/superpowers.js

@@ -0,0 +1,135 @@
+/**
+ * superpowers 命令 - 记录外部 workflow 的回写结果
+ */
+import { basename } from 'path';
+import { Command } from 'commander';
+import { recordSuperpowersRun } from '../../core/superpowers-runs.js';
+import logger from '../utils/logger.js';
+export function createSuperpowersCommand(basePath = process.cwd()) {
+    const command = new Command('superpowers').description('记录 superpowers workflow 的回写结果');
+    command
+        .command('record')
+        .description('记录一次 workflow 执行结果，并把产物索引回写到 .webforge/')
+        .argument('<workflow>', 'workflow 名称，例如 writing-plans / brainstorming')
+        .requiredOption('--summary <text>', '本次 workflow 的结果摘要')
+        .option('-a, --artifact <value>', '记录产物，支持 path 或 kind:path，可重复传入', collectOption, [])
+        .option('--task <task-id>', '关联的 task id')
+        .option('--session <session-id>', '关联的 session id')
+        .option('--owner <worker-id>', '本次 workflow 的 owner / worker')
+        .option('--wave <wave-id>', 'subagent wave id')
+        .option('--thread <thread-id>', 'thread id')
+        .option('--branch <branch>', '关联 branch')
+        .option('--worktree <path>', '关联 worktree path')
+        .option('--compact-from <session-id>', 'compact 来源 session')
+        .option('--json', '输出结构化结果')
+        .action(async (workflow, options) => {
+        try {
+            await recordSuperpowersRunCommand(workflow, options, basePath);
+        }
+        catch (error) {
+            logger.error(`记录 superpowers workflow 失败: ${error}`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+export async function recordSuperpowersRunCommand(workflow, options, basePath = process.cwd()) {
+    if (!Array.isArray(options.artifact) || options.artifact.length === 0) {
+        throw new Error('至少提供一个 --artifact，确保 workflow 结果可恢复');
+    }
+    const input = {
+        workflow,
+        summary: options.summary,
+        taskId: options.task,
+        sessionId: options.session,
+        artifacts: options.artifact.map((item) => parseArtifactOption(item, workflow)),
+        metadata: buildMetadata(options)
+    };
+    const recorded = await recordSuperpowersRun(basePath, input);
+    if (options.json) {
+        console.log(JSON.stringify(recorded, null, 2));
+        return recorded;
+    }
+    logger.h1('🦾 Superpowers Workflow 已记录');
+    logger.info(`workflow: ${recorded.workflow}`);
+    logger.info(`run: ${recorded.id}`);
+    logger.info(`summary: ${recorded.summary}`);
+    if (recorded.taskId) {
+        logger.info(`task: ${recorded.taskId}`);
+    }
+    if (recorded.sessionId) {
+        logger.info(`session: ${recorded.sessionId}`);
+    }
+    console.log();
+    logger.h2('产物');
+    logger.list(recorded.artifacts.map((artifact) => `${artifact.kind}: ${artifact.path}`));
+    return recorded;
+}
+function buildMetadata(options) {
+    const metadata = {
+        owner: options.owner,
+        waveId: options.wave,
+        threadId: options.thread,
+        branch: options.branch,
+        worktreePath: options.worktree,
+        compactFromSession: options.compactFrom
+    };
+    return Object.values(metadata).some((value) => value !== undefined) ? metadata : undefined;
+}
+function parseArtifactOption(value, workflow) {
+    const separatorIndex = value.indexOf(':');
+    if (separatorIndex > 0 && !value.startsWith('./') && !value.startsWith('../') && !value.startsWith('/')) {
+        const kind = normalizeArtifactKind(value.slice(0, separatorIndex));
+        const path = value.slice(separatorIndex + 1);
+        return {
+            kind,
+            path,
+            label: basename(path)
+        };
+    }
+    return {
+        kind: inferArtifactKind(workflow, value),
+        path: value,
+        label: basename(value)
+    };
+}
+function inferArtifactKind(workflow, path) {
+    const normalized = `${workflow} ${path}`.toLowerCase();
+    if (normalized.includes('compact')) {
+        return 'compact-handoff';
+    }
+    if (normalized.includes('thread')) {
+        return 'thread';
+    }
+    if (normalized.includes('decision')) {
+        return 'decision';
+    }
+    if (normalized.includes('knowledge') || normalized.includes('requirements')) {
+        return 'knowledge';
+    }
+    if (normalized.includes('worktree') || normalized.includes('branch')) {
+        return 'worktree-metadata';
+    }
+    if (normalized.includes('plan')) {
+        return 'plan';
+    }
+    return 'note';
+}
+function normalizeArtifactKind(raw) {
+    switch (raw) {
+        case 'knowledge':
+        case 'decision':
+        case 'plan':
+        case 'compact-handoff':
+        case 'thread':
+        case 'worktree-metadata':
+            return raw;
+        case 'note':
+        default:
+            return 'note';
+    }
+}
+function collectOption(value, previous) {
+    return [...previous, value];
+}
+//# sourceMappingURL=superpowers.js.map

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

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

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

@@ -0,0 +1,14 @@
+/**
+ * ui 命令 - 启动 Web UI 本地服务
+ */
+import { Command } from 'commander';
+import { type StartedUiHttpServerHandle } from '../../ui/http/server.js';
+export interface UiCommandOptions {
+    root?: string;
+    host?: string;
+    port?: string;
+    staticRoot?: string;
+}
+export declare function createUiCommand(): Command;
+export declare function startUiServer(options: UiCommandOptions): Promise<StartedUiHttpServerHandle>;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/ui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAqB,KAAK,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAG5F,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,eAAe,IAAI,OAAO,CASzC;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,yBAAyB,CAAC,CA2BpC"}

package/dist/cli/commands/ui.js

@@ -0,0 +1,41 @@
+/**
+ * ui 命令 - 启动 Web UI 本地服务
+ */
+import { Command } from 'commander';
+import { startUiHttpServer } from '../../ui/http/server.js';
+import logger from '../utils/logger.js';
+export function createUiCommand() {
+    return new Command('ui')
+        .description('启动 WebForge 多项目只读 Web UI')
+        .option('--root <path>', '要扫描的项目根目录', process.cwd())
+        .option('--host <host>', '服务监听地址', '127.0.0.1')
+        .option('--port <port>', '服务端口', '4173')
+        .action(async (options) => {
+        await startUiServer(options);
+    });
+}
+export async function startUiServer(options) {
+    const root = options.root ?? process.cwd();
+    const host = options.host ?? '127.0.0.1';
+    const port = options.port ?? '4173';
+    const numericPort = Number.parseInt(port, 10);
+    if (Number.isNaN(numericPort) || numericPort < 0 || numericPort > 65535) {
+        throw new Error(`invalid ui port: ${port}`);
+    }
+    const handle = await startUiHttpServer({
+        rootPath: root,
+        host,
+        port: numericPort,
+        staticRoot: options.staticRoot
+    });
+    logger.h1('Web UI Ready');
+    logger.info('Web UI 本地服务已启动。');
+    logger.list([
+        `root: ${root}`,
+        `host: ${handle.host}`,
+        `port: ${handle.port}`,
+        `url: ${handle.url}`
+    ]);
+    return handle;
+}
+//# sourceMappingURL=ui.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../../src/cli/commands/ui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAkC,MAAM,yBAAyB,CAAC;AAC5F,OAAO,MAAM,MAAM,oBAAoB,CAAC;AASxC,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;SACrB,WAAW,CAAC,0BAA0B,CAAC;SACvC,MAAM,CAAC,eAAe,EAAE,WAAW,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;SACnD,MAAM,CAAC,eAAe,EAAE,QAAQ,EAAE,WAAW,CAAC;SAC9C,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,MAAM,CAAC;SACvC,MAAM,CAAC,KAAK,EAAE,OAAyB,EAAE,EAAE;QAC1C,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAyB;IAEzB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;IACpC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,KAAK,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC;QACrC,QAAQ,EAAE,IAAI;QACd,IAAI;QACJ,IAAI,EAAE,WAAW;QACjB,UAAU,EAAE,OAAO,CAAC,UAAU;KAC/B,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC;IAC1B,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC/B,MAAM,CAAC,IAAI,CAAC;QACV,SAAS,IAAI,EAAE;QACf,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,QAAQ,MAAM,CAAC,GAAG,EAAE;KACrB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * verify 命令 - 对显式验证场景提供稳定入口
+ */
+import { Command } from 'commander';
+import { type InitVerificationSummary } from './init.js';
+export interface VerifyInitOptions {
+    json?: boolean;
+}
+export declare function createVerifyCommand(basePath?: string): Command;
+export declare function verifyInitCommand(projectPath?: string, options?: VerifyInitOptions, basePath?: string): Promise<InitVerificationSummary>;
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAqB7E;AAED,wBAAsB,iBAAiB,CACrC,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,iBAAsB,EAC/B,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,uBAAuB,CAAC,CAmBlC"}

package/dist/cli/commands/verify.js

@@ -0,0 +1,46 @@
+/**
+ * verify 命令 - 对显式验证场景提供稳定入口
+ */
+import { resolve } from 'path';
+import { Command } from 'commander';
+import logger from '../utils/logger.js';
+import { buildInitVerificationSummary } from './init.js';
+export function createVerifyCommand(basePath = process.cwd()) {
+    const command = new Command('verify').description('运行可复用的 WebForge 验证流程');
+    command
+        .command('init')
+        .description('验证初始化后的 onboarding contract 与 doctor/onboard 输出是否一致')
+        .argument('[project-path]', '要验证的项目路径，默认使用当前目录')
+        .option('--json', '输出结构化验证结果')
+        .action(async (projectPath, options) => {
+        try {
+            const summary = await verifyInitCommand(projectPath, options, basePath);
+            if (!summary.ok) {
+                process.exit(1);
+            }
+        }
+        catch (error) {
+            logger.error(`验证失败: ${error}`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+export async function verifyInitCommand(projectPath, options = {}, basePath = process.cwd()) {
+    const targetPath = projectPath ? resolve(basePath, projectPath) : basePath;
+    const summary = await buildInitVerificationSummary(targetPath);
+    if (options.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return summary;
+    }
+    logger.h1('🧪 Init Verification');
+    logger.info(`target: ${targetPath}`);
+    logger.info(`status: ${summary.ok ? 'ok' : 'fail'}`);
+    logger.info(`protocol doc: ${summary.protocolDocPath}`);
+    logger.info(`protocol doc exists: ${summary.protocolDocExists ? 'yes' : 'no'}`);
+    logger.info(`doctor: fail=${summary.doctorFailCount} | warn=${summary.doctorWarnCount}`);
+    logger.info(`onboard: canProceed=${summary.onboardCanProceed ? 'yes' : 'no'}`);
+    logger.info(`shouldRead contains AGENTS.md: ${summary.shouldReadHasAgents ? 'yes' : 'no'}`);
+    return summary;
+}
+//# sourceMappingURL=verify.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../../src/cli/commands/verify.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EACL,4BAA4B,EAE7B,MAAM,WAAW,CAAC;AAMnB,MAAM,UAAU,mBAAmB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAClE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC;IAE1E,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,qDAAqD,CAAC;SAClE,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;SAC/C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC;SAC7B,MAAM,CAAC,KAAK,EAAE,WAA+B,EAAE,OAA0B,EAAE,EAAE;QAC5E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YACxE,IAAI,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,WAAoB,EACpB,UAA6B,EAAE,EAC/B,WAAmB,OAAO,CAAC,GAAG,EAAE;IAEhC,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3E,MAAM,OAAO,GAAG,MAAM,4BAA4B,CAAC,UAAU,CAAC,CAAC;IAE/D,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,EAAE,CAAC,sBAAsB,CAAC,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACrC,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,MAAM,CAAC,IAAI,CAAC,iBAAiB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACxD,MAAM,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAChF,MAAM,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,eAAe,WAAW,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACzF,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,MAAM,CAAC,IAAI,CAAC,kCAAkC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5F,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * WebForge CLI 入口
+ */
+import { Command } from 'commander';
+export declare function createProgram(): Command;
+export declare function registerGlobalErrorHandlers(): void;
+export declare function isCliEntrypoint(argv?: string[]): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,aAAa,IAAI,OAAO,CA+BvC;AAED,wBAAgB,2BAA2B,IAAI,IAAI,CAUlD;AAED,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAEtE"}

package/dist/cli/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+/**
+ * WebForge CLI 入口
+ */
+import { Command } from 'commander';
+import { pathToFileURL } from 'url';
+import { createInitCommand } from './commands/init.js';
+import { createPlanCommand } from './commands/plan.js';
+import { createRunCommand, createDeliverablesCommand } from './commands/run.js';
+import { createOnboardCommand } from './commands/onboard.js';
+import { createResumeCommand } from './commands/resume.js';
+import { createDashboardCommand } from './commands/dashboard.js';
+import { createDoctorCommand } from './commands/doctor.js';
+import { createSuperpowersCommand } from './commands/superpowers.js';
+import { createKnowledgeCommand } from './commands/knowledge.js';
+import { createLogsCommand } from './commands/logs.js';
+import { createMailboxCommand } from './commands/mailbox.js';
+import { createReviewCommand } from './commands/review.js';
+import { createCheckpointCommand } from './commands/checkpoint.js';
+import { createUiCommand } from './commands/ui.js';
+import logger from './utils/logger.js';
+import { createVerifyCommand } from './commands/verify.js';
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('webforge')
+        .description('WebForge harness compatibility CLI')
+        .version('0.1.0')
+        .showHelpAfterError()
+        .configureOutput({
+        writeErr: (str) => logger.error(str.trim()),
+        outputError: (str, write) => write(logger.error(str.trim()))
+    });
+    program.addCommand(createInitCommand());
+    program.addCommand(createPlanCommand());
+    program.addCommand(createRunCommand());
+    program.addCommand(createOnboardCommand());
+    program.addCommand(createResumeCommand());
+    program.addCommand(createDashboardCommand());
+    program.addCommand(createDoctorCommand());
+    program.addCommand(createSuperpowersCommand());
+    program.addCommand(createKnowledgeCommand());
+    program.addCommand(createLogsCommand());
+    program.addCommand(createDeliverablesCommand());
+    program.addCommand(createReviewCommand());
+    program.addCommand(createCheckpointCommand());
+    program.addCommand(createMailboxCommand());
+    program.addCommand(createVerifyCommand());
+    program.addCommand(createUiCommand());
+    return program;
+}
+export function registerGlobalErrorHandlers() {
+    process.on('uncaughtException', (error) => {
+        logger.error(`未捕获的异常: ${error.message}`);
+        process.exit(1);
+    });
+    process.on('unhandledRejection', (reason) => {
+        logger.error(`未处理的 Promise: ${reason}`);
+        process.exit(1);
+    });
+}
+export function isCliEntrypoint(argv = process.argv) {
+    return Boolean(argv[1]) && import.meta.url === pathToFileURL(argv[1]).href;
+}
+if (isCliEntrypoint()) {
+    registerGlobalErrorHandlers();
+    createProgram().parse();
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/utils/logger.d.ts

@@ -0,0 +1,18 @@
+/**
+ * CLI 日志工具
+ * 美化终端输出
+ */
+export declare const logger: {
+    info(message: string): void;
+    success(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    h1(title: string): void;
+    h2(title: string): void;
+    list(items: string[], bullet?: string): void;
+    table(rows: string[][]): void;
+    progress(current: number, total: number, width?: number): string;
+};
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/cli/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,MAAM;kBACH,MAAM,GAAG,IAAI;qBAIV,MAAM,GAAG,IAAI;qBAIb,MAAM,GAAG,IAAI;mBAIf,MAAM,GAAG,IAAI;mBAIb,MAAM,GAAG,IAAI;cAMlB,MAAM,GAAG,IAAI;cAKb,MAAM,GAAG,IAAI;gBAIX,MAAM,EAAE,WAAU,MAAM,GAAW,IAAI;gBAMvC,MAAM,EAAE,EAAE,GAAG,IAAI;sBAiBX,MAAM,SAAS,MAAM,UAAS,MAAM,GAAQ,MAAM;CAUrE,CAAC;AAEF,eAAe,MAAM,CAAC"}