autosnippet 3.3.0 → 3.3.3

package/dist/lib/service/task/TaskGraphService.d.ts

@@ -1,222 +0,0 @@
-import { Task } from '../../domain/task/Task.js';
-import Logger from '../../infrastructure/logging/Logger.js';
-import type { KnowledgeEnrichOptions } from './TaskKnowledgeBridge.js';
-/**
- * TaskGraphService — 任务图核心服务
- *
- * 编排 TaskRepository / TaskReadyEngine / TaskKnowledgeBridge / AuditLog / IdGenerator。
- * 对外提供完整的任务生命周期管理。
- *
- * 设计原则：
- *   - 所有写操作记录审计事件 (task_events 表)
- *   - claim 是原子操作 (status + assignee 一起更新)
- *   - close 时验证不变量 (closedAt 必须存在)
- *   - 子任务 ID 自动递增 (parent.1, parent.2, ...)
- *
- * AutoSnippet 增强：
- *   - ready 返回带知识上下文的任务
- *   - close 返回 newlyReady 列表（减少 Agent MCP 调用次数）
- *   - prime 支持会话恢复（幂等）
- */
-export declare class TaskGraphService {
-    auditLogger: {
-        log: (taskId: string, eventType: string, oldValue: string | null, newValue: string | null) => void;
-    } | null;
-    bridge: import('./TaskKnowledgeBridge.js').TaskKnowledgeBridge | null;
-    idGen: import('../../domain/task/TaskIdGenerator.js').TaskIdGenerator;
-    logger: ReturnType<typeof Logger.getInstance>;
-    readyEngine: import('./TaskReadyEngine.js').TaskReadyEngine;
-    repo: import('../../repository/task/TaskRepository.impl.js').TaskRepositoryImpl;
-    constructor(repository: import('../../repository/task/TaskRepository.impl.js').TaskRepositoryImpl, readyEngine: import('./TaskReadyEngine.js').TaskReadyEngine, knowledgeBridge: import('./TaskKnowledgeBridge.js').TaskKnowledgeBridge | null, auditLogger: {
-        log: (taskId: string, eventType: string, oldValue: string | null, newValue: string | null) => void;
-    } | null, idGenerator: import('../../domain/task/TaskIdGenerator.js').TaskIdGenerator);
-    /**
-     * 创建任务
-     * @param data { title, description, design, acceptance, priority, taskType, parentId }
-     * @returns >}
-     */
-    create(data: {
-        title?: string;
-        description?: string;
-        design?: string;
-        acceptance?: string;
-        priority?: number;
-        taskType?: string;
-        parentId?: string;
-    }): Promise<{
-        task: Task;
-        isDuplicate: boolean;
-    }>;
-    /**
-     * 批量拆解 Epic
-     * 一次性创建多个子任务 + 依赖关系，减少 Agent 的 MCP 调用次数
-     *
-     * @param subtasks [{ title, description, priority, taskType, blockedByIndex }]
-     */
-    decompose(epicId: string, subtasks: Array<Record<string, unknown>>): Promise<Task[]>;
-    /**
-     * 认领任务
-     *
-     * P5: claim-time 知识刷新 — 编码开始时注入最新知识上下文，
-     * 减少 Agent 额外 MCP 调用。
-     *
-     * @param [knowledgeOptions] 上下文信号
-     */
-    claim(id: string, assignee?: string, knowledgeOptions?: KnowledgeEnrichOptions): Promise<Task>;
-    /**
-     * 关闭任务
-     * 返回因此解除阻塞的新就绪任务列表
-     *
-     * @returns >}
-     */
-    close(id: string, reason?: string): Promise<{
-        task: Task | null;
-        newlyReady: string[];
-    }>;
-    /**
-     * 标记任务失败
-     * 释放认领、递增失败计数、回退到 open
-     */
-    fail(id: string, reason: string): Promise<Task | null>;
-    /** 推迟任务 */
-    defer(id: string, reason?: string): Promise<Task | null>;
-    /** 上报进度（长任务的中间状态更新） */
-    progress(id: string, note: string): Promise<Task | null>;
-    /** 添加依赖 */
-    addDependency(taskId: string, dependsOnId: string, depType?: string): Promise<void>;
-    /**
-     * 获取就绪任务 + 知识上下文
-     * @param [options] { limit, withKnowledge, userQuery, activeFile, language }
-     */
-    ready(options?: {
-        limit?: number;
-        withKnowledge?: boolean;
-    } & KnowledgeEnrichOptions): Promise<Task[]>;
-    /** 获取被阻塞的任务 */
-    blocked(): Promise<{
-        blockedBy: string[];
-        knowledgeContext?: Record<string, unknown> | undefined;
-        id?: string | null | undefined;
-        parentId?: string | null | undefined;
-        title?: string | undefined;
-        description?: string | undefined;
-        design?: string | undefined;
-        acceptance?: string | undefined;
-        notes?: string | undefined;
-        status?: string | undefined;
-        priority?: number | undefined;
-        taskType?: string | undefined;
-        closeReason?: string | undefined;
-        assignee?: string | undefined;
-        createdBy?: string | undefined;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
-        closedAt?: number | null | undefined;
-        contentHash?: string | null | undefined;
-        failCount?: number | undefined;
-        lastFailReason?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-    }[]>;
-    /** 获取单个任务详情 */
-    show(id: string): Promise<Task | null>;
-    /**
-     * 列表查询
-     * @param filters { status, taskType, assignee, parentId }
-     * @param options { limit }
-     */
-    list(filters?: Record<string, unknown>, options?: {}): Promise<(Task | null)[]>;
-    /** 依赖树 */
-    depTree(taskId: string): Promise<{
-        depth: unknown;
-        knowledgeContext?: Record<string, unknown> | undefined;
-        id?: string | null | undefined;
-        parentId?: string | null | undefined;
-        title?: string | undefined;
-        description?: string | undefined;
-        design?: string | undefined;
-        acceptance?: string | undefined;
-        notes?: string | undefined;
-        status?: string | undefined;
-        priority?: number | undefined;
-        taskType?: string | undefined;
-        closeReason?: string | undefined;
-        assignee?: string | undefined;
-        createdBy?: string | undefined;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
-        closedAt?: number | null | undefined;
-        contentHash?: string | null | undefined;
-        failCount?: number | undefined;
-        lastFailReason?: string | undefined;
-        metadata?: Record<string, unknown> | undefined;
-    }[]>;
-    /** 统计信息 */
-    stats(): Promise<{
-        total: number;
-        open: number;
-        in_progress: number;
-        closed: number;
-        deferred: number;
-        pinned: number;
-    }>;
-    /**
-     * Prime — 会话恢复（幂等） + 用户输入感知知识注入
-     *
-     * 返回当前进行中的任务 + 就绪任务 + 统计信息。
-     * Agent 在新会话开始或上下文压缩后调用。
-     *
-     * P1: 新增 userQuery / activeFile / language 参数，
-     *     知识注入从「基于历史任务」升级为「基于历史任务 + 当前用户意图」。
-     *
-     * @param [options] { withKnowledge, userQuery, activeFile, language }
-     * @returns >}
-     */
-    prime(options?: {
-        limit?: number;
-        withKnowledge?: boolean;
-    } & KnowledgeEnrichOptions): Promise<Record<string, unknown>>;
-    /**
-     * 记录决策 — 直接以 pinned 状态创建，避免 open→pinned 的幽灵窗口（C1）
-     * @param params { title, description, rationale, tags, relatedTaskId }
-     * @returns >}
-     */
-    recordDecision({ title, description, rationale, tags, relatedTaskId, }: {
-        title: string;
-        description: string;
-        rationale?: string;
-        tags?: string[];
-        relatedTaskId?: string;
-    }): Promise<{
-        task: Task;
-        isDuplicate: boolean;
-    }>;
-    /**
-     * 修订决策 — 原子事务：创建新决策 + 关闭旧决策 + 建立 supersedes 链（C2+C7）
-     * @param params { oldDecisionId, title, description, rationale, reason }
-     * @returns >}
-     */
-    reviseDecision({ oldDecisionId, title, description, rationale, reason, }: {
-        oldDecisionId: string;
-        title: string;
-        description: string;
-        rationale?: string;
-        reason?: string;
-    }): Promise<{
-        newDecision: Task;
-        oldDecisionId: string;
-    }>;
-    /** 取消固定决策 */
-    unpinDecision(id: string, reason?: string): Promise<Task | null>;
-    /**
-     * P2: 获取决策过期阈值（秒）
-     * 默认 30 天 = 2592000 秒。可通过容器内 'config' 服务配置。
-     * 返回 0 表示禁用过期检测。
-     */
-    _getDecisionStaleThreshold(): number;
-    /**
-     * 查找因 closedTaskId 完成而新解除阻塞的任务
-     */
-    _checkNewlyUnblocked(closedTaskId: string): string[];
-    _logEvent(taskId: string, eventType: string, oldValue: string | null, newValue: string | null): void;
-}
-export default TaskGraphService;