@wandoupeas/coding-forge 0.1.0

package/dist/cli/commands/logs.js

@@ -0,0 +1,248 @@
+/**
+ * logs 命令 - 查看 runtime 执行日志与观察事件
+ */
+import { Command } from 'commander';
+import { inspectThreadLink } from '../../core/threads.js';
+import { getRuntimeWorkflowContext, getSessionWorkflowContext, inspectWorkflowContext } from '../../core/workflow-context.js';
+import { loadWorkspaceState } from '../../core/workspace.js';
+import { getLatestRuntimeObservation, getRuntimeObservation } from '../../core/logger.js';
+import { buildAgentBriefing } from '../agent-briefing.js';
+import logger from '../utils/logger.js';
+export function createLogsCommand(basePath = process.cwd()) {
+    const command = new Command('logs').description('查看 WebForge runtime 执行日志');
+    command
+        .command('runtime')
+        .description('查看最近一次或指定 session 的 runtime 观察日志')
+        .argument('[session-id]', 'runtime session id，默认使用最近一次 runtime 会话')
+        .option('--json', '输出结构化 runtime 日志摘要')
+        .action(async (sessionId, options) => {
+        try {
+            await runtimeLogsCommand(sessionId, options, basePath);
+        }
+        catch (error) {
+            logger.error(`读取 runtime 日志失败: ${error}`);
+            process.exit(1);
+        }
+    });
+    return command;
+}
+export async function runtimeLogsCommand(sessionId, options = {}, basePath = process.cwd()) {
+    let summary;
+    try {
+        summary = await buildRuntimeLogsSummary(sessionId, basePath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.warning(message);
+        return null;
+    }
+    if (options.json) {
+        console.log(JSON.stringify(summary, null, 2));
+        return summary;
+    }
+    logger.h1('🪵 Runtime 日志');
+    logger.info(`session: ${summary.sessionId}`);
+    logger.info(`start: ${new Date(summary.startTime).toLocaleString()}`);
+    logger.info(`end: ${summary.endTime ? new Date(summary.endTime).toLocaleString() : 'running'}`);
+    logger.info(`result: completed=${summary.completed} | failed=${summary.failed} | blocked=${summary.blocked} | deliverables=${summary.deliverables}`);
+    logger.info(`permission profile: ${summary.permissionProfile ?? 'unknown'}`);
+    if (summary.signals) {
+        logger.info(`signals: ready=${summary.signals.readyTasks} | blocked=${summary.signals.blockedTasks} | pending_review=${summary.signals.pendingReview} | unread=${summary.signals.unreadMessages}`);
+    }
+    console.log();
+    logger.h2('日志恢复快照');
+    renderRecoverySnapshot(summary.workflowContext, summary.threadLinkage);
+    console.log();
+    logger.h2('当前工作区恢复快照');
+    renderRecoverySnapshot(summary.currentWorkflowContext, summary.currentThreadLinkage);
+    console.log();
+    logger.h2('上下文漂移');
+    logger.info(`status: ${summary.contextDrift.status}`);
+    if (summary.contextDrift.reasons.length > 0) {
+        logger.info(`reasons: ${summary.contextDrift.reasons.join(', ')}`);
+    }
+    console.log();
+    logger.h2('事件流');
+    if (summary.events.length === 0) {
+        logger.info('当前没有可展示的 runtime observation 事件。');
+        return summary;
+    }
+    for (const event of summary.events) {
+        console.log(`  ${event.timestamp} :: ${event.message} :: ${event.taskId ?? 'no-task'} :: ${event.permissionProfile ?? 'unknown'}${event.reason ? ` :: ${event.reason}` : ''}`);
+    }
+    return summary;
+}
+export async function buildRuntimeLogsSummary(sessionId, basePath) {
+    const observation = sessionId
+        ? await getRuntimeObservation(sessionId, basePath)
+        : await getLatestRuntimeObservation(basePath);
+    if (!observation) {
+        throw new Error(sessionId
+            ? `没有找到 runtime 日志 ${sessionId}`
+            : '当前 workspace 没有 runtime 日志');
+    }
+    const workspace = await loadWorkspaceState(basePath);
+    const briefing = await buildAgentBriefing(basePath, workspace);
+    const workflowContext = resolveRuntimeLogsWorkflowContext(observation.sessionId, workspace, basePath);
+    const threadLinkage = resolveRuntimeLogsThreadLinkage(workflowContext?.threadId ?? null, workspace, basePath);
+    const currentWorkflowContext = summarizeWorkflowContext('current', briefing.workflowContext, basePath);
+    const currentThreadLinkage = resolveRuntimeLogsThreadLinkage(currentWorkflowContext?.threadId ?? null, workspace, basePath);
+    const contextDrift = buildContextDriftSummary(workflowContext, threadLinkage, currentWorkflowContext, currentThreadLinkage);
+    return {
+        ...observation,
+        workflowContext,
+        threadLinkage,
+        currentWorkflowContext,
+        currentThreadLinkage,
+        contextDrift
+    };
+}
+function resolveRuntimeLogsWorkflowContext(sessionId, workspace, basePath) {
+    let source = null;
+    let context = null;
+    if (workspace.runtime.sessionId === sessionId) {
+        context = getRuntimeWorkflowContext(workspace.runtime);
+        source = context ? 'runtime' : null;
+    }
+    if (!context) {
+        const session = workspace.indexes.sessions.find((item) => item.id === sessionId) ?? null;
+        context = getSessionWorkflowContext(session);
+        source = context ? 'session' : null;
+    }
+    if (!context || !source) {
+        return null;
+    }
+    return summarizeWorkflowContext(source, context, basePath);
+}
+function summarizeWorkflowContext(source, context, basePath) {
+    if (!context) {
+        return null;
+    }
+    const readiness = inspectWorkflowContext(basePath, context);
+    return {
+        source,
+        status: readiness.missingArtifacts.length > 0 ||
+            readiness.missingWorktreePath !== null ||
+            readiness.missingCompactSessionId !== null
+            ? 'blocked'
+            : 'ready',
+        workflow: context.workflow,
+        runId: context.runId ?? null,
+        owner: context.owner ?? null,
+        waveId: context.waveId ?? null,
+        threadId: context.threadId ?? null,
+        branch: context.branch ?? null,
+        worktreePath: context.worktreePath ?? null,
+        compactFromSession: context.compactFromSession ?? null,
+        artifacts: context.artifacts ?? [],
+        missingArtifacts: readiness.missingArtifacts,
+        missingWorktreePath: readiness.missingWorktreePath,
+        missingCompactSessionId: readiness.missingCompactSessionId
+    };
+}
+function resolveRuntimeLogsThreadLinkage(threadId, workspace, basePath) {
+    if (!threadId) {
+        return {
+            status: 'none',
+            threadId: null,
+            workflow: null,
+            runId: null,
+            branch: null,
+            worktreePath: null,
+            missingArtifacts: [],
+            missingWorktreePath: null,
+            missingThreadId: null
+        };
+    }
+    const threadLink = workspace.indexes.threads.find((item) => item.id === threadId) ?? null;
+    if (!threadLink) {
+        return {
+            status: 'blocked',
+            threadId,
+            workflow: null,
+            runId: null,
+            branch: null,
+            worktreePath: null,
+            missingArtifacts: [],
+            missingWorktreePath: null,
+            missingThreadId: threadId
+        };
+    }
+    const readiness = inspectThreadLink(basePath, threadLink);
+    return {
+        status: readiness.missingArtifacts.length > 0 || readiness.missingWorktreePath !== null
+            ? 'blocked'
+            : 'ready',
+        threadId: threadLink.id,
+        workflow: threadLink.workflow,
+        runId: threadLink.runId ?? null,
+        branch: threadLink.branch ?? null,
+        worktreePath: threadLink.worktreePath ?? null,
+        missingArtifacts: readiness.missingArtifacts,
+        missingWorktreePath: readiness.missingWorktreePath,
+        missingThreadId: null
+    };
+}
+function renderRecoverySnapshot(workflowContext, threadLinkage) {
+    if (!workflowContext) {
+        logger.info('workflow context: none');
+    }
+    else {
+        logger.info(`workflow context: ${workflowContext.status} (${workflowContext.source})`);
+        logger.info(`workflow: ${workflowContext.workflow}`);
+        logger.info(`branch: ${workflowContext.branch ?? 'none'}`);
+        logger.info(`worktree: ${workflowContext.worktreePath ?? 'none'}`);
+        logger.info(`wave: ${workflowContext.waveId ?? 'none'}`);
+        logger.info(`thread: ${workflowContext.threadId ?? 'none'}`);
+        logger.info(`compact from: ${workflowContext.compactFromSession ?? 'none'}`);
+        logger.info(`readiness: artifacts=${workflowContext.missingArtifacts.length === 0 ? 'ok' : `missing:${workflowContext.missingArtifacts.length}`}, worktree=${workflowContext.missingWorktreePath ? 'missing' : 'ok'}, compact=${workflowContext.missingCompactSessionId ? 'missing' : 'ok'}`);
+    }
+    if (threadLinkage.status === 'none') {
+        logger.info('thread linkage: none');
+        return;
+    }
+    logger.info(`thread linkage: ${threadLinkage.status}`);
+    logger.info(`thread id: ${threadLinkage.threadId ?? 'none'}`);
+    logger.info(`thread workflow: ${threadLinkage.workflow ?? 'none'}`);
+    logger.info(`thread branch: ${threadLinkage.branch ?? 'none'}`);
+    logger.info(`thread worktree: ${threadLinkage.worktreePath ?? 'none'}`);
+    logger.info(`thread readiness: artifacts=${threadLinkage.missingArtifacts.length === 0 ? 'ok' : `missing:${threadLinkage.missingArtifacts.length}`}, worktree=${threadLinkage.missingWorktreePath ? 'missing' : 'ok'}${threadLinkage.missingThreadId ? `, thread=missing:${threadLinkage.missingThreadId}` : ''}`);
+}
+function buildContextDriftSummary(logWorkflowContext, logThreadLinkage, currentWorkflowContext, currentThreadLinkage) {
+    if (!logWorkflowContext && !currentWorkflowContext) {
+        return {
+            status: 'none',
+            reasons: []
+        };
+    }
+    const reasons = [];
+    if (!logWorkflowContext && currentWorkflowContext) {
+        reasons.push('missing log workflowContext');
+    }
+    else if (logWorkflowContext && !currentWorkflowContext) {
+        reasons.push('missing current workflowContext');
+    }
+    else if (logWorkflowContext && currentWorkflowContext) {
+        appendIfChanged(reasons, 'workflow', logWorkflowContext.workflow, currentWorkflowContext.workflow);
+        appendIfChanged(reasons, 'runId', logWorkflowContext.runId, currentWorkflowContext.runId);
+        appendIfChanged(reasons, 'threadId', logWorkflowContext.threadId, currentWorkflowContext.threadId);
+        appendIfChanged(reasons, 'branch', logWorkflowContext.branch, currentWorkflowContext.branch);
+        appendIfChanged(reasons, 'worktreePath', logWorkflowContext.worktreePath, currentWorkflowContext.worktreePath);
+        appendIfChanged(reasons, 'compactFromSession', logWorkflowContext.compactFromSession, currentWorkflowContext.compactFromSession);
+    }
+    appendIfChanged(reasons, 'threadLinkage.threadId', logThreadLinkage.threadId, currentThreadLinkage.threadId);
+    appendIfChanged(reasons, 'threadLinkage.workflow', logThreadLinkage.workflow, currentThreadLinkage.workflow);
+    appendIfChanged(reasons, 'threadLinkage.runId', logThreadLinkage.runId, currentThreadLinkage.runId);
+    appendIfChanged(reasons, 'threadLinkage.branch', logThreadLinkage.branch, currentThreadLinkage.branch);
+    appendIfChanged(reasons, 'threadLinkage.worktreePath', logThreadLinkage.worktreePath, currentThreadLinkage.worktreePath);
+    return {
+        status: reasons.length > 0 ? 'drifted' : 'aligned',
+        reasons
+    };
+}
+function appendIfChanged(reasons, label, left, right) {
+    if ((left ?? null) !== (right ?? null)) {
+        reasons.push(`${label}: ${left ?? 'none'} -> ${right ?? 'none'}`);
+    }
+}
+//# sourceMappingURL=logs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/cli/commands/logs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EAEtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAgDxC,MAAM,UAAU,iBAAiB,CAAC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAChE,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;IAE5E,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,kCAAkC,CAAC;SAC/C,QAAQ,CAAC,cAAc,EAAE,wCAAwC,CAAC;SAClE,MAAM,CAAC,QAAQ,EAAE,oBAAoB,CAAC;SACtC,MAAM,CAAC,KAAK,EAAE,SAA6B,EAAE,OAA2B,EAAE,EAAE;QAC3E,IAAI,CAAC;YACH,MAAM,kBAAkB,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,EAAE,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAkB,EAClB,UAA8B,EAAE,EAChC,WAAmB,OAAO,CAAC,GAAG,EAAE;IAEhC,IAAI,OAA2B,CAAC;IAChC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,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,eAAe,CAAC,CAAC;IAC3B,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7C,MAAM,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,CAAC,IAAI,CAAC,QAAQ,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAChG,MAAM,CAAC,IAAI,CACT,qBAAqB,OAAO,CAAC,SAAS,aAAa,OAAO,CAAC,MAAM,cAAc,OAAO,CAAC,OAAO,mBAAmB,OAAO,CAAC,YAAY,EAAE,CACxI,CAAC;IACF,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,iBAAiB,IAAI,SAAS,EAAE,CAAC,CAAC;IAE7E,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CACT,kBAAkB,OAAO,CAAC,OAAO,CAAC,UAAU,cAAc,OAAO,CAAC,OAAO,CAAC,YAAY,qBAAqB,OAAO,CAAC,OAAO,CAAC,aAAa,aAAa,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,CACtL,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;IACpB,sBAAsB,CAAC,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAEvE,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;IACvB,sBAAsB,CAAC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAErF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrE,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;IACjB,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CACT,KAAK,KAAK,CAAC,SAAS,OAAO,KAAK,CAAC,OAAO,OAAO,KAAK,CAAC,MAAM,IAAI,SAAS,OAAO,KAAK,CAAC,iBAAiB,IAAI,SAAS,GACjH,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EACzC,EAAE,CACH,CAAC;IACJ,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,SAA6B,EAC7B,QAAgB;IAEhB,MAAM,WAAW,GAAG,SAAS;QAC3B,CAAC,CAAC,MAAM,qBAAqB,CAAC,SAAS,EAAE,QAAQ,CAAC;QAClD,CAAC,CAAC,MAAM,2BAA2B,CAAC,QAAQ,CAAC,CAAC;IAEhD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CACb,SAAS;YACP,CAAC,CAAC,mBAAmB,SAAS,EAAE;YAChC,CAAC,CAAC,4BAA4B,CACjC,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,iCAAiC,CACvD,WAAW,CAAC,SAAS,EACrB,SAAS,EACT,QAAQ,CACT,CAAC;IACF,MAAM,aAAa,GAAG,+BAA+B,CACnD,eAAe,EAAE,QAAQ,IAAI,IAAI,EACjC,SAAS,EACT,QAAQ,CACT,CAAC;IACF,MAAM,sBAAsB,GAAG,wBAAwB,CACrD,SAAS,EACT,QAAQ,CAAC,eAAe,EACxB,QAAQ,CACT,CAAC;IACF,MAAM,oBAAoB,GAAG,+BAA+B,CAC1D,sBAAsB,EAAE,QAAQ,IAAI,IAAI,EACxC,SAAS,EACT,QAAQ,CACT,CAAC;IACF,MAAM,YAAY,GAAG,wBAAwB,CAC3C,eAAe,EACf,aAAa,EACb,sBAAsB,EACtB,oBAAoB,CACrB,CAAC;IAEF,OAAO;QACL,GAAG,WAAW;QACd,eAAe;QACf,aAAa;QACb,sBAAsB;QACtB,oBAAoB;QACpB,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CACxC,SAAiB,EACjB,SAAyB,EACzB,QAAgB;IAEhB,IAAI,MAAM,GAAiC,IAAI,CAAC;IAChD,IAAI,OAAO,GAAoC,IAAI,CAAC;IAEpD,IAAI,SAAS,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9C,OAAO,GAAG,yBAAyB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvD,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC;QACzF,OAAO,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAC7C,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,wBAAwB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAAyC,EACzC,OAAwC,EACxC,QAAgB;IAEhB,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,sBAAsB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5D,OAAO;QACL,MAAM;QACN,MAAM,EACJ,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;YACrC,SAAS,CAAC,mBAAmB,KAAK,IAAI;YACtC,SAAS,CAAC,uBAAuB,KAAK,IAAI;YACxC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO;QACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,IAAI;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;QAC1C,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,IAAI;QACtD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;QAClC,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;QAC5C,mBAAmB,EAAE,SAAS,CAAC,mBAAmB;QAClD,uBAAuB,EAAE,SAAS,CAAC,uBAAuB;KAC3D,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,QAAuB,EACvB,SAAyB,EACzB,QAAgB;IAEhB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO;YACL,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,IAAI;YACd,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE,EAAE;YACpB,mBAAmB,EAAE,IAAI;YACzB,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC1F,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,QAAQ;YACR,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,IAAI;YAClB,gBAAgB,EAAE,EAAE;YACpB,mBAAmB,EAAE,IAAI;YACzB,eAAe,EAAE,QAAQ;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC1D,OAAO;QACL,MAAM,EACJ,SAAS,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,IAAI,SAAS,CAAC,mBAAmB,KAAK,IAAI;YAC7E,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,OAAO;QACb,QAAQ,EAAE,UAAU,CAAC,EAAE;QACvB,QAAQ,EAAE,UAAU,CAAC,QAAQ;QAC7B,KAAK,EAAE,UAAU,CAAC,KAAK,IAAI,IAAI;QAC/B,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,IAAI;QACjC,YAAY,EAAE,UAAU,CAAC,YAAY,IAAI,IAAI;QAC7C,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;QAC5C,mBAAmB,EAAE,SAAS,CAAC,mBAAmB;QAClD,eAAe,EAAE,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAC7B,eAAyD,EACzD,aAA8C;IAE9C,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CACT,qBAAqB,eAAe,CAAC,MAAM,KAAK,eAAe,CAAC,MAAM,GAAG,CAC1E,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,aAAa,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,WAAW,eAAe,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,aAAa,eAAe,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC;QACnE,MAAM,CAAC,IAAI,CAAC,SAAS,eAAe,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,WAAW,eAAe,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,iBAAiB,eAAe,CAAC,kBAAkB,IAAI,MAAM,EAAE,CAAC,CAAC;QAC7E,MAAM,CAAC,IAAI,CACT,wBAAwB,eAAe,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,eAAe,CAAC,gBAAgB,CAAC,MAAM,EAAE,cAAc,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,aAAa,eAAe,CAAC,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CACjR,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACpC,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,mBAAmB,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,IAAI,CAAC,cAAc,aAAa,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;IAC9D,MAAM,CAAC,IAAI,CAAC,oBAAoB,aAAa,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC,CAAC;IACpE,MAAM,CAAC,IAAI,CAAC,kBAAkB,aAAa,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,CAAC,IAAI,CAAC,oBAAoB,aAAa,CAAC,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC;IACxE,MAAM,CAAC,IAAI,CACT,+BAA+B,aAAa,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,aAAa,CAAC,gBAAgB,CAAC,MAAM,EAAE,cAAc,aAAa,CAAC,mBAAmB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,GACtM,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,aAAa,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EACxF,EAAE,CACH,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAC/B,kBAA4D,EAC5D,gBAAiD,EACjD,sBAAgE,EAChE,oBAAqD;IAErD,IAAI,CAAC,kBAAkB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACnD,OAAO;YACL,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,CAAC,kBAAkB,IAAI,sBAAsB,EAAE,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC9C,CAAC;SAAM,IAAI,kBAAkB,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAClD,CAAC;SAAM,IAAI,kBAAkB,IAAI,sBAAsB,EAAE,CAAC;QACxD,eAAe,CACb,OAAO,EACP,UAAU,EACV,kBAAkB,CAAC,QAAQ,EAC3B,sBAAsB,CAAC,QAAQ,CAChC,CAAC;QACF,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,KAAK,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC;QAC1F,eAAe,CACb,OAAO,EACP,UAAU,EACV,kBAAkB,CAAC,QAAQ,EAC3B,sBAAsB,CAAC,QAAQ,CAChC,CAAC;QACF,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC7F,eAAe,CACb,OAAO,EACP,cAAc,EACd,kBAAkB,CAAC,YAAY,EAC/B,sBAAsB,CAAC,YAAY,CACpC,CAAC;QACF,eAAe,CACb,OAAO,EACP,oBAAoB,EACpB,kBAAkB,CAAC,kBAAkB,EACrC,sBAAsB,CAAC,kBAAkB,CAC1C,CAAC;IACJ,CAAC;IAED,eAAe,CACb,OAAO,EACP,wBAAwB,EACxB,gBAAgB,CAAC,QAAQ,EACzB,oBAAoB,CAAC,QAAQ,CAC9B,CAAC;IACF,eAAe,CACb,OAAO,EACP,wBAAwB,EACxB,gBAAgB,CAAC,QAAQ,EACzB,oBAAoB,CAAC,QAAQ,CAC9B,CAAC;IACF,eAAe,CACb,OAAO,EACP,qBAAqB,EACrB,gBAAgB,CAAC,KAAK,EACtB,oBAAoB,CAAC,KAAK,CAC3B,CAAC;IACF,eAAe,CACb,OAAO,EACP,sBAAsB,EACtB,gBAAgB,CAAC,MAAM,EACvB,oBAAoB,CAAC,MAAM,CAC5B,CAAC;IACF,eAAe,CACb,OAAO,EACP,4BAA4B,EAC5B,gBAAgB,CAAC,YAAY,EAC7B,oBAAoB,CAAC,YAAY,CAClC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;QAClD,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,OAAiB,EACjB,KAAa,EACb,IAA+B,EAC/B,KAAgC;IAEhC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,IAAI,IAAI,MAAM,OAAO,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,12 @@
+/**
+ * mailbox 命令 - mailbox 观察与维护入口
+ */
+import { Command } from 'commander';
+export declare function createMailboxCommand(): Command;
+export declare function listMailboxes(basePath?: string): Promise<void>;
+export declare function readMailbox(workerId: string, options: {
+    all?: boolean;
+    markRead?: boolean;
+}, basePath?: string): Promise<void>;
+export declare function clearMailbox(workerId: string, basePath?: string): Promise<void>;
+//# sourceMappingURL=mailbox.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mailbox.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mailbox.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,oBAAoB,IAAI,OAAO,CAM9C;AA6CD,wBAAsB,aAAa,CAAC,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnF;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAC9C,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/cli/commands/mailbox.js

@@ -0,0 +1,131 @@
+/**
+ * mailbox 命令 - mailbox 观察与维护入口
+ */
+import { Command } from 'commander';
+import { readdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import logger from '../utils/logger.js';
+import { Mailbox } from '../../core/mailbox.js';
+import { loadConfig } from '../../utils/config.js';
+const MAILBOX_DIR = '.webforge/mailboxes';
+export function createMailboxCommand() {
+    return new Command('mailbox')
+        .description('查看或维护 Worker mailbox')
+        .addCommand(createListCommand())
+        .addCommand(createReadCommand())
+        .addCommand(createClearCommand());
+}
+function createListCommand() {
+    return new Command('list')
+        .description('列出已发现的 mailbox')
+        .action(async () => {
+        try {
+            await listMailboxes();
+        }
+        catch (error) {
+            logger.error(`列出失败: ${error}`);
+            process.exit(1);
+        }
+    });
+}
+function createReadCommand() {
+    return new Command('read')
+        .description('读取指定 Worker 的 mailbox')
+        .argument('<worker>', 'Worker ID')
+        .option('-a, --all', '显示全部消息（默认仅显示未读）')
+        .option('-m, --mark-read', '将当前读取结果标记为已读')
+        .action(async (workerId, options) => {
+        try {
+            await readMailbox(workerId, options);
+        }
+        catch (error) {
+            logger.error(`读取失败: ${error}`);
+            process.exit(1);
+        }
+    });
+}
+function createClearCommand() {
+    return new Command('clear')
+        .description('清空指定 Worker 的 mailbox')
+        .argument('<worker>', 'Worker ID')
+        .action(async (workerId) => {
+        try {
+            await clearMailbox(workerId);
+        }
+        catch (error) {
+            logger.error(`清空失败: ${error}`);
+            process.exit(1);
+        }
+    });
+}
+export async function listMailboxes(basePath = process.cwd()) {
+    logger.h1('📬 Worker 邮箱列表');
+    const workers = await discoverMailboxWorkers(basePath);
+    if (workers.length === 0) {
+        logger.info('当前没有发现任何 mailbox。');
+        return;
+    }
+    for (const workerId of workers) {
+        const mailbox = new Mailbox(workerId, basePath);
+        await mailbox.init();
+        const unreadCount = await mailbox.getUnreadCount();
+        const icon = unreadCount > 0 ? '🔔' : '📭';
+        console.log(`  ${icon} ${workerId.padEnd(12)} ${unreadCount > 0 ? `(${unreadCount} 未读)` : '(0 未读)'}`);
+    }
+}
+export async function readMailbox(workerId, options, basePath = process.cwd()) {
+    logger.h1(`📬 ${workerId} 的邮箱`);
+    const mailbox = new Mailbox(workerId, basePath);
+    await mailbox.init();
+    const messages = await mailbox.receive({
+        unreadOnly: !options.all,
+        markAsRead: options.markRead
+    });
+    if (messages.length === 0) {
+        logger.info(options.all ? '邮箱为空' : '没有未读消息');
+        return;
+    }
+    for (const message of messages) {
+        console.log(`\n${'─'.repeat(50)}`);
+        console.log(`  ID: ${message.id}`);
+        console.log(`  来自: ${message.from}`);
+        console.log(`  类型: ${message.type}`);
+        console.log(`  时间: ${new Date(message.timestamp).toLocaleString()}`);
+        console.log(`  内容: ${message.content}`);
+        if (message.task_id) {
+            console.log(`  关联任务: ${message.task_id}`);
+        }
+        console.log(`  状态: ${message.read ? '已读' : '未读'}`);
+    }
+    console.log(`\n共 ${messages.length} 条消息`);
+}
+export async function clearMailbox(workerId, basePath = process.cwd()) {
+    const mailbox = new Mailbox(workerId, basePath);
+    await mailbox.init();
+    await mailbox.clear();
+    logger.success(`已清空 ${workerId} 的邮箱`);
+}
+async function discoverMailboxWorkers(basePath) {
+    const workers = new Set();
+    try {
+        const config = await loadConfig(basePath);
+        for (const workerId of config.workers) {
+            workers.add(workerId);
+        }
+    }
+    catch {
+        // config 不是 mailbox 观察面的强依赖
+    }
+    const mailboxRoot = join(basePath, MAILBOX_DIR);
+    if (existsSync(mailboxRoot)) {
+        const entries = await readdir(mailboxRoot, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isFile() && entry.name.endsWith('.jsonl')) {
+                workers.add(entry.name.slice(0, -'.jsonl'.length));
+            }
+        }
+    }
+    return Array.from(workers).sort();
+}
+//# sourceMappingURL=mailbox.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * onboard 命令 - 统一的 agent onboarding 入口
+ */
+import { Command } from 'commander';
+import { type DoctorReport } from './doctor.js';
+import { type ResumeSummary } from './resume.js';
+export interface OnboardingRecoveryTarget {
+    status: 'none' | 'ready' | 'blocked';
+    workflow: string | null;
+    runId: string | null;
+    branch: string | null;
+    threadId: string | null;
+    worktreePath: string | null;
+    compactFromSession: string | null;
+    missingArtifacts: string[];
+    missingWorktreePath: string | null;
+    missingCompactSessionId: string | null;
+    missingThreadId: string | null;
+}
+export interface OnboardingRecoveryReadiness {
+    overallStatus: 'ready' | 'blocked';
+    workflowContext: OnboardingRecoveryTarget;
+    latestSuperpowersRun: OnboardingRecoveryTarget;
+    threadLinkage: OnboardingRecoveryTarget;
+}
+export interface OnboardingSummary {
+    canProceed: boolean;
+    status: 'ready' | 'blocked';
+    doctor: DoctorReport;
+    resume: ResumeSummary;
+    shouldRead: string[];
+    runtimeLogCommand: string | null;
+    suggestedWorkflow: string | null;
+    recoveryReadiness: OnboardingRecoveryReadiness;
+    recommendedActions: string[];
+}
+export interface OnboardCommandOptions {
+    json?: boolean;
+}
+export declare function createOnboardCommand(): Command;
+export declare function buildOnboardingSummary(basePath?: string): Promise<OnboardingSummary>;
+export declare function onboardCommand(optionsOrBasePath?: OnboardCommandOptions | string, maybeBasePath?: string): Promise<OnboardingSummary>;
+//# sourceMappingURL=onboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/onboard.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,eAAe,EAAE,wBAAwB,CAAC;IAC1C,oBAAoB,EAAE,wBAAwB,CAAC;IAC/C,aAAa,EAAE,wBAAwB,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,iBAAiB,EAAE,2BAA2B,CAAC;IAC/C,kBAAkB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAY9C;AAED,wBAAsB,sBAAsB,CAC1C,QAAQ,GAAE,MAAsB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED,wBAAsB,cAAc,CAClC,iBAAiB,GAAE,qBAAqB,GAAG,MAAW,EACtD,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAmD5B"}