@lingxiao-office/sdk 1.0.0

package/dist/core/ModeToolPolicy.d.ts

@@ -0,0 +1,62 @@
+import type { CollaborationMode, RouteMode, BlackboardMode } from './ModeRuntimeProjection.js';
+import type { ControlMode } from '../contracts/types/Session.js';
+import type { PermissionMode } from './PermissionSystem.js';
+import { type ModeId } from '../contracts/modes.js';
+export type ModeToolActor = 'leader' | 'worker' | 'team_member' | 'workflow_node' | 'remote_worker' | 'external_worker';
+export interface ModeToolMetadata {
+    category?: string;
+    visibility?: string;
+    readOnly?: boolean;
+    modifiesWorkspace?: boolean;
+    requiresNetwork?: boolean;
+    privileged?: boolean;
+    dangerous?: boolean;
+}
+export interface ModeToolPolicyInput {
+    actor: ModeToolActor;
+    controlMode: ControlMode;
+    routeMode: RouteMode;
+    collaborationMode: CollaborationMode;
+    /**
+     * 会话级模式插件激活状态（bughunt/office/workflow）。
+     * 用于 fail-closed：工具所属模式未启用 → 结构化 mode error。
+     */
+    activeModes: Record<ModeId, boolean>;
+    blackboardMode: BlackboardMode;
+    permissionMode: PermissionMode;
+    activeTeamName?: string | null;
+    callerInTeamRoster?: boolean;
+    callerIsTeamLeader?: boolean;
+    allowSoloEphemeralDispatch?: boolean;
+    toolName: string;
+    toolMetadata: ModeToolMetadata;
+}
+export type ModeToolDecision = {
+    visibility: 'visible';
+    execution: 'allowed' | 'permission_required';
+} | {
+    visibility: 'hidden';
+    execution: 'forbidden';
+    reason: string;
+} | {
+    visibility: 'visible';
+    execution: 'dispatch_preferred';
+    reason: string;
+};
+export declare const TEAM_TOOL_NAMES: ReadonlySet<string>;
+export declare const TEAM_MEMBER_TOOL_NAMES: ReadonlySet<string>;
+export declare const LEADER_META_TOOL_NAMES: ReadonlySet<string>;
+export declare const BLACKBOARD_WRITE_TOOL_NAMES: ReadonlySet<string>;
+export declare function isTeamTool(toolName: string): boolean;
+export declare function isLeaderMetaTool(toolName: string, metadata?: ModeToolMetadata): boolean;
+export declare function isBlackboardWriteTool(toolName: string, metadata?: ModeToolMetadata): boolean;
+export declare function isHighRiskExecutionTool(_toolName: string, metadata: ModeToolMetadata): boolean;
+export declare function resolveModeToolDecision(input: ModeToolPolicyInput): ModeToolDecision;
+export declare function filterToolsByModePolicy<T extends {
+    function: {
+        name: string;
+    };
+}>(tools: readonly T[], input: Omit<ModeToolPolicyInput, 'toolName' | 'toolMetadata'> & {
+    getToolMetadata: (toolName: string) => ModeToolMetadata;
+}): T[];
+//# sourceMappingURL=ModeToolPolicy.d.ts.map

package/dist/core/ModeToolPolicy.d.ts.map

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

package/dist/core/ModeToolPolicy.js

@@ -0,0 +1,145 @@
+import { findModeOfTool } from '../contracts/modes.js';
+import { recordModeGateBlock } from './ModeAudit.js';
+export const TEAM_TOOL_NAMES = new Set([
+    'team_manage',
+    'team_message',
+    'team_inbox',
+]);
+export const TEAM_MEMBER_TOOL_NAMES = new Set([
+    'team_message',
+    'team_inbox',
+]);
+export const LEADER_META_TOOL_NAMES = new Set([
+    'create_task',
+    'update_task',
+    'delete_task',
+    'define_agent_role',
+    'delete_agent_role',
+    'list_available_roles',
+    'dispatch_agent',
+    'dispatch_batch',
+    'explore',
+    'send_message_to_agent',
+    'update_task_status',
+    'force_complete_task',
+    'retry_agent_llm',
+    'nudge_agent',
+    'compact_agent_context',
+    'pause_agent',
+    'resume_agent',
+    'intervene_agent',
+    'terminate_agent',
+    'confirm_intervention',
+    'list_runtime_agents',
+    'check_agent_progress',
+    'ask_user',
+    'submit_plan',
+    'plan_create',
+    'plan_update',
+    'plan_checkpoint',
+    'plan_finalize',
+    'finish_session',
+    'learn_soul',
+    'request_permission_update',
+    'create_download_link',
+    'set_bughunt_dag',
+    'upsert_bughunt_finding',
+    'get_bughunt_ledger',
+    'get_ready_dag_nodes',
+    'verify_finding',
+]);
+export const BLACKBOARD_WRITE_TOOL_NAMES = new Set([
+    'blackboard',
+]);
+export function isTeamTool(toolName) {
+    return TEAM_TOOL_NAMES.has(toolName);
+}
+export function isLeaderMetaTool(toolName, metadata) {
+    return LEADER_META_TOOL_NAMES.has(toolName) || metadata?.visibility === 'leader';
+}
+export function isBlackboardWriteTool(toolName, metadata) {
+    return BLACKBOARD_WRITE_TOOL_NAMES.has(toolName) || metadata?.category === 'blackboard';
+}
+export function isHighRiskExecutionTool(_toolName, metadata) {
+    return Boolean(metadata.dangerous || metadata.privileged || metadata.requiresNetwork || metadata.modifiesWorkspace);
+}
+function forbidden(reason) {
+    return { visibility: 'hidden', execution: 'forbidden', reason };
+}
+function defaultVisible(input) {
+    if (isHighRiskExecutionTool(input.toolName, input.toolMetadata) && input.permissionMode !== 'yolo') {
+        return { visibility: 'visible', execution: 'permission_required' };
+    }
+    return { visibility: 'visible', execution: 'allowed' };
+}
+function isWorkerActor(actor) {
+    return actor !== 'leader';
+}
+export function resolveModeToolDecision(input) {
+    const toolName = input.toolName.trim();
+    if (toolName === 'attempt_completion') {
+        return input.actor === 'leader'
+            ? forbidden('ATTEMPT_COMPLETION_WORKER_ONLY')
+            : defaultVisible(input);
+    }
+    if (isLeaderMetaTool(toolName, input.toolMetadata) && isWorkerActor(input.actor)) {
+        return forbidden('LEADER_TOOL_FORBIDDEN_FOR_WORKER');
+    }
+    // 会话级模式 fail-closed：工具所属模式未启用 → 结构化 mode error。
+    // 对称覆盖 bughunt / office / workflow，单一事实源 src/contracts/modes.ts。
+    // workflow 关闭时仍产出 WORKFLOW_MODE_REQUIRED（modes.md:390 reason 兼容）。
+    // 命中时记录一次拦截计数（确定性 per-mode 可观测，供 N5 反馈点统计反复尝试）。
+    const toolMode = findModeOfTool(toolName);
+    if (toolMode && !input.activeModes[toolMode]) {
+        const reason = `${toolMode.toUpperCase()}_MODE_REQUIRED`;
+        recordModeGateBlock(toolMode, toolName, reason, input.actor);
+        return forbidden(reason);
+    }
+    if (isBlackboardWriteTool(toolName, input.toolMetadata) && input.blackboardMode !== 'full') {
+        return forbidden('BLACKBOARD_WRITE_DISABLED');
+    }
+    if (isTeamTool(toolName) && input.collaborationMode !== 'team') {
+        return forbidden('TEAM_UNAVAILABLE_IN_SOLO');
+    }
+    // Blueprint 工具是 Team 模式项目管理能力：Solo 下无子系统覆盖校验机制，隐藏。
+    if (toolName === 'define_project_blueprint' && input.collaborationMode === 'solo') {
+        return forbidden('BLUEPRINT_UNAVAILABLE_IN_SOLO');
+    }
+    if (toolName === 'team_manage') {
+        const leaderLike = input.actor === 'leader' || input.callerIsTeamLeader === true;
+        if (!leaderLike) {
+            return forbidden('TEAM_MANAGE_LEADER_ONLY');
+        }
+    }
+    if (TEAM_MEMBER_TOOL_NAMES.has(toolName)) {
+        if (input.actor === 'leader') {
+            return defaultVisible(input);
+        }
+        if (!input.callerInTeamRoster) {
+            return forbidden('TEAM_ROSTER_REQUIRED');
+        }
+    }
+    if ((toolName === 'dispatch_agent' || toolName === 'dispatch_batch') && input.actor === 'leader' && input.collaborationMode === 'solo') {
+        if (input.allowSoloEphemeralDispatch ||
+            input.routeMode === 'hybrid' ||
+            input.routeMode === 'delegate') {
+            return { visibility: 'visible', execution: 'allowed' };
+        }
+        return forbidden('SOLO_DISPATCH_REQUIRES_ROUTE');
+    }
+    if (input.actor === 'leader' && input.collaborationMode === 'solo' && isHighRiskExecutionTool(toolName, input.toolMetadata)) {
+        return { visibility: 'visible', execution: 'dispatch_preferred', reason: 'HIGH_RISK_DIRECT_EXECUTION' };
+    }
+    return defaultVisible(input);
+}
+export function filterToolsByModePolicy(tools, input) {
+    return tools.filter((tool) => {
+        const decision = resolveModeToolDecision({
+            ...input,
+            toolName: tool.function.name,
+            toolMetadata: input.getToolMetadata(tool.function.name),
+        });
+        return decision.visibility === 'visible';
+    });
+}
+//# sourceMappingURL=ModeToolPolicy.js.map

package/dist/core/ModeToolPolicy.js.map

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

package/dist/core/ModeWorktreeService.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ModeWorktreeService — 模式级 git worktree 执行卫生。
+ *
+ * 不是安全边界（契约 docs/contracts/modes.md:186 明确「模式不是安全边界」；
+ * 安全仍由 PermissionSystem + Sandbox 正交保证）。这是**工程卫生**：
+ *   - bughunt 扫描（tsc/npm audit/semgrep）与 workflow 执行默认在独立 git worktree
+ *     里跑，产生的临时产物 / node_modules 变更 / 编译缓存不会污染主工作树；
+ *   - 模式关闭时通过 CleanupRegistry 确定性回收（git worktree remove），不留残骸。
+ *
+ * 机制（确定性，复用 git CLI，不引入新依赖）：
+ *   - worktree 根：workspace 下 .lingxiao/mode-worktrees/<mode>/
+ *   - 新建：`git worktree add --detach <path> HEAD`（不创建分支，HEAD 快照，避免动到主分支）
+ *   - 复用：若该路径已是合法 worktree，直接返回（幂等）
+ *   - 回收：`git worktree remove --force <path>`（模式关闭 / 进程退出时）
+ *
+ * 仅在 git 仓库内启用；非 git 仓库（裸目录）直接退回 workspace 原路径，绝不抛错。
+ */
+import type { ModeId } from '../contracts/modes.js';
+/**
+ * 为某模式在该 session 的 workspace 下确保一个独立 worktree。
+ *
+ * @returns 该模式应使用的执行目录（worktree 路径）；若不可用（非 git / 创建失败）
+ *          返回 null，调用方回退到原 workspace。
+ */
+export declare function ensureModeWorktree(mode: ModeId, workspace: string): string | null;
+/**
+ * 显式回收某模式的 worktree（模式关闭时调用）。
+ * 失败静默——回收失败不阻塞模式关闭。
+ */
+export declare function releaseModeWorktree(mode: ModeId, workspace: string): void;
+//# sourceMappingURL=ModeWorktreeService.d.ts.map

package/dist/core/ModeWorktreeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeWorktreeService.d.ts","sourceRoot":"","sources":["../../src/core/ModeWorktreeService.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA2BpD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmCjF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAKzE"}

package/dist/core/ModeWorktreeService.js

@@ -0,0 +1,116 @@
+/**
+ * ModeWorktreeService — 模式级 git worktree 执行卫生。
+ *
+ * 不是安全边界（契约 docs/contracts/modes.md:186 明确「模式不是安全边界」；
+ * 安全仍由 PermissionSystem + Sandbox 正交保证）。这是**工程卫生**：
+ *   - bughunt 扫描（tsc/npm audit/semgrep）与 workflow 执行默认在独立 git worktree
+ *     里跑，产生的临时产物 / node_modules 变更 / 编译缓存不会污染主工作树；
+ *   - 模式关闭时通过 CleanupRegistry 确定性回收（git worktree remove），不留残骸。
+ *
+ * 机制（确定性，复用 git CLI，不引入新依赖）：
+ *   - worktree 根：workspace 下 .lingxiao/mode-worktrees/<mode>/
+ *   - 新建：`git worktree add --detach <path> HEAD`（不创建分支，HEAD 快照，避免动到主分支）
+ *   - 复用：若该路径已是合法 worktree，直接返回（幂等）
+ *   - 回收：`git worktree remove --force <path>`（模式关闭 / 进程退出时）
+ *
+ * 仅在 git 仓库内启用；非 git 仓库（裸目录）直接退回 workspace 原路径，绝不抛错。
+ */
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import { execFileSync } from 'child_process';
+import { coreLogger } from './Log.js';
+import { registerCleanup } from './CleanupRegistry.js';
+/** worktree 注册表：mode → 已分配路径。用于回收与幂等复用。 */
+const assignedWorktrees = new Map();
+/** 已注册的全局退出回收 token（只注册一次）。 */
+let globalCleanupRegistered = false;
+/** git 子进程封装：失败返回 null（绝不抛错中断业务），调用方按需 fallback。 */
+function git(args, cwd) {
+    try {
+        return execFileSync('git', args, {
+            cwd,
+            encoding: 'utf-8',
+            timeout: 15_000,
+            maxBuffer: 4 * 1024 * 1024,
+            stdio: ['ignore', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** workspace 是否在一个 git 仓库内。 */
+function isGitRepo(workspace) {
+    return git(['rev-parse', '--git-dir'], workspace) !== null;
+}
+/**
+ * 为某模式在该 session 的 workspace 下确保一个独立 worktree。
+ *
+ * @returns 该模式应使用的执行目录（worktree 路径）；若不可用（非 git / 创建失败）
+ *          返回 null，调用方回退到原 workspace。
+ */
+export function ensureModeWorktree(mode, workspace) {
+    if (!workspace)
+        return null;
+    if (!isGitRepo(workspace))
+        return null;
+    const worktreePath = resolve(workspace, '.lingxiao', 'mode-worktrees', mode);
+    // 幂等：已分配且仍存在 → 直接复用。
+    if (assignedWorktrees.has(mode)) {
+        const existing = assignedWorktrees.get(mode);
+        if (existsSync(existing))
+            return existing;
+        assignedWorktrees.delete(mode);
+    }
+    // 幂等：路径已存在但未登记（上次进程残留）——若已是 worktree 则登记复用，否则跳过。
+    if (existsSync(worktreePath)) {
+        const list = git(['worktree', 'list', '--porcelain'], workspace) ?? '';
+        if (list.includes(`worktree ${worktreePath}`)) {
+            assignedWorktrees.set(mode, worktreePath);
+            registerGlobalCleanupOnce();
+            return worktreePath;
+        }
+        // 路径被占用但不是 worktree——不强行删，退回原 workspace（确定性：不动用户已有文件）。
+        return null;
+    }
+    // 新建：--detach 挂在 HEAD 快照，不创建/不切分支，避免污染主分支状态。
+    const ok = git(['worktree', 'add', '--detach', worktreePath, 'HEAD'], workspace);
+    if (ok === null) {
+        coreLogger.warn(`[ModeWorktree] 未能为模式 ${mode} 创建 worktree，回退到主工作树`);
+        return null;
+    }
+    assignedWorktrees.set(mode, worktreePath);
+    registerGlobalCleanupOnce();
+    coreLogger.info(`[ModeWorktree] 已为模式 ${mode} 启用执行 worktree: ${worktreePath}`);
+    return worktreePath;
+}
+/**
+ * 显式回收某模式的 worktree（模式关闭时调用）。
+ * 失败静默——回收失败不阻塞模式关闭。
+ */
+export function releaseModeWorktree(mode, workspace) {
+    const worktreePath = assignedWorktrees.get(mode);
+    if (!worktreePath)
+        return;
+    git(['worktree', 'remove', '--force', worktreePath], workspace);
+    assignedWorktrees.delete(mode);
+}
+/** 注册一次「进程退出时回收所有已登记 worktree」的全局清理。 */
+function registerGlobalCleanupOnce() {
+    if (globalCleanupRegistered)
+        return;
+    globalCleanupRegistered = true;
+    registerCleanup(() => {
+        for (const [mode, path] of assignedWorktrees) {
+            try {
+                // 退出时无 workspace 上下文，用 worktree 自身边界做 prune（git 支持）。
+                git(['worktree', 'remove', '--force', path], path);
+            }
+            catch {
+                // 退出路径静默。
+            }
+        }
+        assignedWorktrees.clear();
+    }, 120); // 晚于业务资源清理，早于最终退出。
+}
+//# sourceMappingURL=ModeWorktreeService.js.map

package/dist/core/ModeWorktreeService.js.map

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

package/dist/core/OrchestrationTypes.d.ts

@@ -0,0 +1,114 @@
+export type OrchestrationNodeKind = 'plan' | 'contract' | 'implement' | 'evaluate' | 'repair' | 'reset' | 'generic';
+export type OrchestrationVerdict = 'PASS' | 'FAIL' | 'BLOCKED' | 'UNKNOWN';
+export type OrchestrationAcceptanceStatus = 'pending' | 'running' | 'passed' | 'failed' | 'blocked' | 'skipped';
+export type OrchestrationSpeculativeSelectionPolicy = 'first_green' | 'fewest_changes' | 'fastest_tests';
+export interface OrchestrationArtifactRef {
+    path: string;
+    label?: string;
+    kind?: string;
+}
+export interface OrchestrationAcceptance {
+    status: OrchestrationAcceptanceStatus;
+    summary?: string;
+    criteria?: string[];
+    evidenceTaskIds?: string[];
+    artifactRefs?: OrchestrationArtifactRef[];
+    evaluatedAt?: number;
+}
+export interface OrchestrationContractBinding {
+    /** Stable cross-worker contract surface, e.g. `POST /api/login` or `chat.message.api`. */
+    surface: string;
+    /** Expected contract version. When omitted, any live version for the surface satisfies the binding. */
+    version?: number;
+    /** Blackboard tag used to resolve the live contract node. */
+    tag: string;
+    /** Optional team request id expected to be acked before implementation can start. */
+    requestId?: string;
+    /** Whether this task must wait for a live blackboard contract before dispatch. */
+    requireContract?: boolean;
+    /** Whether this task must wait for the request ack loop to close before dispatch. */
+    requireAck?: boolean;
+}
+export interface OrchestrationSpeculativeAlternative {
+    id: string;
+    label?: string;
+    strategyPrompt?: string;
+    workingDir?: string;
+    writeScope?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface OrchestrationSpeculationPolicy {
+    enabled?: boolean;
+    maxBranches?: number;
+    timeoutMs?: number;
+    selectionPolicy?: OrchestrationSpeculativeSelectionPolicy;
+    alternatives?: OrchestrationSpeculativeAlternative[];
+}
+export type TaskReadiness = 'ready' | 'blocked' | 'running' | 'terminal';
+export interface DAGNode {
+    id: string;
+    subject: string;
+    status: string;
+    exitReason?: string;
+    displayState?: string;
+    readiness: TaskReadiness;
+    agentType: string;
+    assignedAgent?: string;
+    preferredAgentName?: string;
+    blockedBy: string[];
+    blocks: string[];
+    blockedReason?: string;
+    nextAction?: string;
+    orchestration?: OrchestrationTaskMetadata;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface DAGEdge {
+    from: string;
+    to: string;
+    type: 'blocks' | 'depends_on' | 'repair_of' | 'evidence_for';
+}
+export interface DAGSnapshot {
+    sessionId: string;
+    runId?: string;
+    nodes: DAGNode[];
+    edges: DAGEdge[];
+    ready: string[];
+    blocked: string[];
+    running: string[];
+    terminal: string[];
+    criticalPath?: string[];
+    updatedAt: number;
+}
+export interface RunExplanation {
+    mode: 'manual' | 'eternal';
+    state: 'working' | 'waiting_for_dependency' | 'waiting_for_user' | 'evaluating' | 'repairing' | 'blocked' | 'idle';
+    reason: string;
+    nextAction?: string;
+    activeTaskIds?: string[];
+    activeAgentNames?: string[];
+    blockedTaskIds?: string[];
+    since: number;
+    confidence?: 'observed' | 'reported' | 'inferred';
+}
+export interface OrchestrationTaskMetadata {
+    orchestrationRunId?: string;
+    nodeKind?: OrchestrationNodeKind;
+    generation?: number;
+    stage?: string;
+    verdict?: OrchestrationVerdict;
+    contract?: unknown;
+    contractBinding?: OrchestrationContractBinding;
+    evaluationPolicy?: unknown;
+    speculation?: OrchestrationSpeculationPolicy;
+    acceptance?: OrchestrationAcceptance;
+    blockedReason?: string;
+    nextAction?: string;
+    explainReason?: string;
+    mainPathRank?: number;
+    /** P2: 当前任务在 repair chain 中的修复次数 */
+    repairCount?: number;
+    /** P2: 是否已达到修复上限 */
+    repairLimitReached?: boolean;
+}
+//# sourceMappingURL=OrchestrationTypes.d.ts.map

package/dist/core/OrchestrationTypes.d.ts.map

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

package/dist/core/OrchestrationTypes.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=OrchestrationTypes.js.map

package/dist/core/OrchestrationTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestrationTypes.js","sourceRoot":"","sources":["../../src/core/OrchestrationTypes.ts"],"names":[],"mappings":""}

package/dist/core/PatternRecognitionEngine.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PatternRecognitionEngine — P3: 失败模式识别引擎。
+ *
+ * 识别重复失败模式（同文件反复失败、角色频繁超时、循环依赖），
+ * 并提供行动建议。纯确定性，无 LLM 调用。
+ */
+export type PatternType = 'repeated_same_file' | 'role_timeout' | 'circular_dependency';
+export interface RecognizedPattern {
+    type: PatternType;
+    description: string;
+    severity: 'warning' | 'critical';
+    suggestedAction: string;
+    context: Record<string, unknown>;
+}
+export interface FailureRecord {
+    taskId: string;
+    errorType: string;
+    files?: string[];
+    role?: string;
+    durationMs?: number;
+    timestamp: number;
+}
+export declare class PatternRecognitionEngine {
+    private readonly failures;
+    private readonly fileFailureCounts;
+    private readonly roleTimeoutCounts;
+    private readonly taskDependencyCycles;
+    recordFailure(record: FailureRecord): void;
+    getPatterns(): RecognizedPattern[];
+    suggestAction(pattern: RecognizedPattern): string;
+    clear(): void;
+}
+//# sourceMappingURL=PatternRecognitionEngine.d.ts.map

package/dist/core/PatternRecognitionEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatternRecognitionEngine.d.ts","sourceRoot":"","sources":["../../src/core/PatternRecognitionEngine.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,WAAW,GAAG,oBAAoB,GAAG,cAAc,GAAG,qBAAqB,CAAC;AAExF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,SAAS,GAAG,UAAU,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAuB;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA6B;IAC/D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAElE,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAqB1C,WAAW,IAAI,iBAAiB,EAAE;IA6ClC,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAIjD,KAAK,IAAI,IAAI;CAMd"}

package/dist/core/PatternRecognitionEngine.js

@@ -0,0 +1,82 @@
+/**
+ * PatternRecognitionEngine — P3: 失败模式识别引擎。
+ *
+ * 识别重复失败模式（同文件反复失败、角色频繁超时、循环依赖），
+ * 并提供行动建议。纯确定性，无 LLM 调用。
+ */
+const SAME_FILE_THRESHOLD = 3;
+const ROLE_TIMEOUT_THRESHOLD = 2;
+const CIRCULAR_DEPENDENCY_THRESHOLD = 2;
+export class PatternRecognitionEngine {
+    failures = [];
+    fileFailureCounts = new Map();
+    roleTimeoutCounts = new Map();
+    taskDependencyCycles = new Map();
+    recordFailure(record) {
+        this.failures.push(record);
+        // Track file failures
+        if (record.files) {
+            for (const file of record.files) {
+                this.fileFailureCounts.set(file, (this.fileFailureCounts.get(file) ?? 0) + 1);
+            }
+        }
+        // Track role timeouts
+        if (record.role && record.errorType === 'timeout') {
+            this.roleTimeoutCounts.set(record.role, (this.roleTimeoutCounts.get(record.role) ?? 0) + 1);
+        }
+        // Track circular dependencies
+        if (record.errorType === 'circular_dependency') {
+            this.taskDependencyCycles.set(record.taskId, (this.taskDependencyCycles.get(record.taskId) ?? 0) + 1);
+        }
+    }
+    getPatterns() {
+        const patterns = [];
+        // Check repeated same file failures
+        for (const [file, count] of this.fileFailureCounts) {
+            if (count >= SAME_FILE_THRESHOLD) {
+                patterns.push({
+                    type: 'repeated_same_file',
+                    description: `File "${file}" has caused ${count} failures`,
+                    severity: count >= SAME_FILE_THRESHOLD * 2 ? 'critical' : 'warning',
+                    suggestedAction: `Review "${file}" manually — it may have structural issues causing repeated failures`,
+                    context: { file, failureCount: count },
+                });
+            }
+        }
+        // Check role timeouts
+        for (const [role, count] of this.roleTimeoutCounts) {
+            if (count >= ROLE_TIMEOUT_THRESHOLD) {
+                patterns.push({
+                    type: 'role_timeout',
+                    description: `Role "${role}" has timed out ${count} times`,
+                    severity: count >= ROLE_TIMEOUT_THRESHOLD * 2 ? 'critical' : 'warning',
+                    suggestedAction: `Increase contextBudget for role "${role}" or reduce task scope`,
+                    context: { role, timeoutCount: count },
+                });
+            }
+        }
+        // Check circular dependencies
+        for (const [taskId, count] of this.taskDependencyCycles) {
+            if (count >= CIRCULAR_DEPENDENCY_THRESHOLD) {
+                patterns.push({
+                    type: 'circular_dependency',
+                    description: `Task "${taskId}" has hit circular dependency ${count} times`,
+                    severity: 'critical',
+                    suggestedAction: `Re-split task "${taskId}" to break the dependency cycle`,
+                    context: { taskId, cycleCount: count },
+                });
+            }
+        }
+        return patterns;
+    }
+    suggestAction(pattern) {
+        return pattern.suggestedAction;
+    }
+    clear() {
+        this.failures.length = 0;
+        this.fileFailureCounts.clear();
+        this.roleTimeoutCounts.clear();
+        this.taskDependencyCycles.clear();
+    }
+}
+//# sourceMappingURL=PatternRecognitionEngine.js.map

package/dist/core/PatternRecognitionEngine.js.map

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