autosnippet 3.2.21 → 3.3.2

package/dist/lib/service/snippet/SnippetInstaller.js

@@ -1,276 +0,0 @@
-/**
- * SnippetInstaller — Codec 驱动的 Snippet 安装器
- *
- * 支持:
- *   - Xcode: 每个 snippet 一个 .codesnippet 文件
- *   - VSCode: 所有 snippets 合并为单个 .code-snippets JSON 文件
- *
- * 行为由注入的 SnippetCodec 决定。
- */
-import { existsSync, mkdirSync, readdirSync, readFileSync, unlinkSync, writeFileSync, } from 'node:fs';
-import { join } from 'node:path';
-export class SnippetInstaller {
-    #codec;
-    #snippetFactory;
-    #snippetsDirOverride;
-    /**
-     * @param options.codec IDE codec
-     * @param [options.snippetsDir] 覆盖 codec 默认目录
-     */
-    constructor(options = {}) {
-        this.#codec = options.codec || null;
-        this.#snippetFactory = options.snippetFactory || null;
-        this.#snippetsDirOverride = options.snippetsDir || null;
-    }
-    /** codec ID ('xcode' | 'vscode') */
-    get target() {
-        return this.#codec?.id || 'unknown';
-    }
-    /** 当前安装目录 */
-    get snippetsDir() {
-        return this.#snippetsDirOverride || this.#codec?.getInstallDir(process.cwd()) || '';
-    }
-    setSnippetFactory(factory) {
-        this.#snippetFactory = factory;
-    }
-    setCodec(codec) {
-        this.#codec = codec;
-    }
-    // ─────────────── 安装 ───────────────
-    /**
-     * 安装单个 snippet spec
-     * @param spec SnippetSpec
-     * @param [projectRoot] VSCode 需要 projectRoot 确定 .vscode/ 路径
-     * @returns }
-     */
-    install(spec, projectRoot) {
-        this.#assertCodec();
-        const codec = this.#codec;
-        try {
-            const dir = this.#resolveDir(projectRoot);
-            this.#ensureDir(dir);
-            const bundleFilename = codec.getBundleFilename();
-            if (bundleFilename) {
-                // Bundle 模式 (VSCode): merge into single JSON file
-                return this.#installToBundle(spec, dir, bundleFilename);
-            }
-            // Per-file 模式 (Xcode): 每个 snippet 一个文件
-            const content = codec.generate(spec);
-            const filename = `${spec.identifier}${codec.fileExtension}`;
-            const filePath = join(dir, filename);
-            writeFileSync(filePath, content);
-            return { success: true, path: filePath, message: `Installed: ${filename}` };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { success: false, path: '', message };
-        }
-    }
-    /**
-     * 从 Recipe 批量安装
-     * @returns }
-     */
-    installFromRecipes(recipes, projectRoot) {
-        this.#assertCodec();
-        this.#assertFactory();
-        const codec = this.#codec;
-        const factory = this.#snippetFactory;
-        const dir = this.#resolveDir(projectRoot);
-        this.#ensureDir(dir);
-        const specs = recipes.map((r) => factory.fromRecipe(r));
-        const bundleFilename = codec.getBundleFilename();
-        if (bundleFilename) {
-            // Bundle 模式: 一次性写入整个 bundle
-            return this.#installBundleFromSpecs(specs, dir, bundleFilename, recipes.length);
-        }
-        // Per-file 模式
-        const details = [];
-        let successCount = 0;
-        let errorCount = 0;
-        for (const spec of specs) {
-            const result = this.install(spec, projectRoot);
-            details.push(result);
-            if (result.success) {
-                successCount++;
-            }
-            else {
-                errorCount++;
-            }
-        }
-        return { success: errorCount === 0, count: recipes.length, successCount, errorCount, details };
-    }
-    // ─────────────── 查询 ───────────────
-    /**
-     * 列出已安装的 AutoSnippet 管理的 snippet
-     * @returns >}
-     */
-    listInstalled(projectRoot) {
-        const dir = this.#resolveDir(projectRoot);
-        if (!existsSync(dir)) {
-            return [];
-        }
-        const bundleFilename = this.#codec?.getBundleFilename();
-        if (bundleFilename) {
-            // VSCode: 检查 bundle 文件是否存在
-            const bundlePath = join(dir, bundleFilename);
-            if (!existsSync(bundlePath)) {
-                return [];
-            }
-            try {
-                const content = JSON.parse(readFileSync(bundlePath, 'utf-8'));
-                return Object.keys(content).map((key) => ({
-                    filename: key,
-                    path: bundlePath,
-                }));
-            }
-            catch {
-                return [];
-            }
-        }
-        // Xcode: 列出 com.autosnippet.*.codesnippet 文件
-        return readdirSync(dir)
-            .filter((f) => f.startsWith('com.autosnippet.') &&
-            f.endsWith(this.#codec?.fileExtension || '.codesnippet'))
-            .map((f) => ({ filename: f, path: join(dir, f) }));
-    }
-    // ─────────────── 卸载 ───────────────
-    /**
-     * 卸载指定 snippet
-     * @returns }
-     */
-    uninstall(identifier, projectRoot) {
-        const dir = this.#resolveDir(projectRoot);
-        const bundleFilename = this.#codec?.getBundleFilename();
-        if (bundleFilename) {
-            // VSCode: 从 bundle JSON 中移除对应 key
-            return this.#removeFromBundle(identifier, dir, bundleFilename);
-        }
-        // Xcode: 删除单个文件
-        const ext = this.#codec?.fileExtension || '.codesnippet';
-        const filename = identifier.endsWith(ext) ? identifier : `${identifier}${ext}`;
-        const filePath = join(dir, filename);
-        if (!existsSync(filePath)) {
-            return { success: false, message: `Not found: ${filename}` };
-        }
-        unlinkSync(filePath);
-        return { success: true, message: `Uninstalled: ${filename}` };
-    }
-    /**
-     * 清除所有 AutoSnippet 管理的 snippet
-     * @returns }
-     */
-    cleanAll(projectRoot) {
-        const dir = this.#resolveDir(projectRoot);
-        const bundleFilename = this.#codec?.getBundleFilename();
-        if (bundleFilename) {
-            // VSCode: 删除整个 bundle 文件
-            const bundlePath = join(dir, bundleFilename);
-            if (existsSync(bundlePath)) {
-                unlinkSync(bundlePath);
-                return { success: true, removed: 1 };
-            }
-            return { success: true, removed: 0 };
-        }
-        // Xcode: 删除所有 com.autosnippet.* 文件
-        const installed = this.listInstalled(projectRoot);
-        let removed = 0;
-        for (const { path: filePath } of installed) {
-            try {
-                unlinkSync(filePath);
-                removed++;
-            }
-            catch {
-                /* ignore */
-            }
-        }
-        return { success: true, removed };
-    }
-    // ─────────────── Private ───────────────
-    #assertCodec() {
-        if (!this.#codec) {
-            throw new Error('SnippetCodec not set');
-        }
-    }
-    #assertFactory() {
-        if (!this.#snippetFactory) {
-            throw new Error('SnippetFactory not set');
-        }
-    }
-    #resolveDir(projectRoot) {
-        if (this.#snippetsDirOverride) {
-            return this.#snippetsDirOverride;
-        }
-        return this.#codec?.getInstallDir(projectRoot || process.cwd()) || '';
-    }
-    #ensureDir(dir) {
-        if (!existsSync(dir)) {
-            mkdirSync(dir, { recursive: true });
-        }
-    }
-    /** VSCode bundle: 将单个 spec 追加/更新到 bundle JSON */
-    #installToBundle(spec, dir, bundleFilename) {
-        const bundlePath = join(dir, bundleFilename);
-        let bundle = {};
-        if (existsSync(bundlePath)) {
-            try {
-                bundle = JSON.parse(readFileSync(bundlePath, 'utf-8'));
-            }
-            catch {
-                bundle = {};
-            }
-        }
-        const key = `Recipe: ${spec.title || spec.identifier}`;
-        const content = JSON.parse(this.#codec.generate(spec));
-        const entryKey = Object.keys(content)[0];
-        bundle[key] = content[entryKey];
-        writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
-        return { success: true, path: bundlePath, message: `Installed: ${key}` };
-    }
-    /** VSCode bundle: 一次性写入完整 bundle */
-    #installBundleFromSpecs(specs, dir, bundleFilename, totalCount) {
-        try {
-            const content = this.#codec.generateBundle(specs);
-            const bundlePath = join(dir, bundleFilename);
-            writeFileSync(bundlePath, typeof content === 'string' ? content : JSON.stringify(content, null, 2));
-            return {
-                success: true,
-                count: totalCount,
-                successCount: totalCount,
-                errorCount: 0,
-                details: [{ success: true, path: bundlePath, message: `Bundle: ${totalCount} snippets` }],
-            };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return {
-                success: false,
-                count: totalCount,
-                successCount: 0,
-                errorCount: totalCount,
-                details: [{ success: false, path: '', message }],
-            };
-        }
-    }
-    /** VSCode bundle: 从 JSON 中移除一个 snippet */
-    #removeFromBundle(identifier, dir, bundleFilename) {
-        const bundlePath = join(dir, bundleFilename);
-        if (!existsSync(bundlePath)) {
-            return { success: false, message: `Bundle not found: ${bundleFilename}` };
-        }
-        try {
-            const bundle = JSON.parse(readFileSync(bundlePath, 'utf-8'));
-            // 按 identifier 或 title 匹配
-            const keyToRemove = Object.keys(bundle).find((k) => k.includes(identifier) || k === `Recipe: ${identifier}`);
-            if (!keyToRemove) {
-                return { success: false, message: `Snippet not found in bundle: ${identifier}` };
-            }
-            delete bundle[keyToRemove];
-            writeFileSync(bundlePath, `${JSON.stringify(bundle, null, 2)}\n`);
-            return { success: true, message: `Uninstalled: ${keyToRemove}` };
-        }
-        catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
-            return { success: false, message };
-        }
-    }
-}

package/dist/lib/service/snippet/codecs/SnippetCodec.d.ts

@@ -1,44 +0,0 @@
-/**
- * SnippetCodec — IDE Snippet 格式抽象接口
- *
- * 子类实现:
- *   - XcodeCodec  (.codesnippet plist XML)
- *   - VSCodeCodec (.code-snippets JSON, 兼容 Cursor)
- *
- * SnippetSpec 结构 (IDE 无关中间表示):
- *   { identifier, title, completion, summary, code, language }
- */
-export interface SnippetSpec {
-    identifier: string;
-    title?: string;
-    completion?: string;
-    trigger?: string;
-    summary?: string;
-    code?: string | string[];
-    language?: string;
-    [key: string]: unknown;
-}
-export declare class SnippetCodec {
-    /** @returns codec 标识 ('xcode' | 'vscode') */
-    get id(): string;
-    /** 输出文件的扩展名 ('.codesnippet' | '.code-snippets') */
-    get fileExtension(): string;
-    /** 单个 SnippetSpec → IDE 格式字符串 */
-    generate(spec: SnippetSpec): string;
-    /**
-     * 批量 specs → IDE 格式输出
-     *   Xcode:  返回 Array<{ filename, content }>（每个 snippet 一个文件）
-     *   VSCode: 返回 string（单个 JSON bundle 文件内容）
-     * @returns >}
-     */
-    generateBundle(specs: SnippetSpec[]): string | Array<{
-        filename: string;
-        content: string;
-    }>;
-    /** 目标 snippet 安装目录路径 */
-    getInstallDir(projectRoot?: string): string;
-    /** AutoSnippet 语言标识 → IDE 语言标识映射 */
-    mapLanguage(lang: string): string;
-    /** 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file) */
-    getBundleFilename(): string | null;
-}

package/dist/lib/service/snippet/codecs/SnippetCodec.js

@@ -1,35 +0,0 @@
-export class SnippetCodec {
-    /** @returns codec 标识 ('xcode' | 'vscode') */
-    get id() {
-        throw new Error('SnippetCodec.id is abstract');
-    }
-    /** 输出文件的扩展名 ('.codesnippet' | '.code-snippets') */
-    get fileExtension() {
-        throw new Error('SnippetCodec.fileExtension is abstract');
-    }
-    /** 单个 SnippetSpec → IDE 格式字符串 */
-    generate(spec) {
-        throw new Error('SnippetCodec.generate() is abstract');
-    }
-    /**
-     * 批量 specs → IDE 格式输出
-     *   Xcode:  返回 Array<{ filename, content }>（每个 snippet 一个文件）
-     *   VSCode: 返回 string（单个 JSON bundle 文件内容）
-     * @returns >}
-     */
-    generateBundle(specs) {
-        throw new Error('SnippetCodec.generateBundle() is abstract');
-    }
-    /** 目标 snippet 安装目录路径 */
-    getInstallDir(projectRoot) {
-        throw new Error('SnippetCodec.getInstallDir() is abstract');
-    }
-    /** AutoSnippet 语言标识 → IDE 语言标识映射 */
-    mapLanguage(lang) {
-        throw new Error('SnippetCodec.mapLanguage() is abstract');
-    }
-    /** 获取 bundle 文件名 (VSCode = 'autosnippet.code-snippets', Xcode = per-file) */
-    getBundleFilename() {
-        return null;
-    }
-}

package/dist/lib/service/snippet/codecs/VSCodeCodec.d.ts

@@ -1,27 +0,0 @@
-/**
- * VSCodeCodec — VSCode .code-snippets (JSON) 生成器
- *
- * 特性:
- *   - 项目级 .vscode/autosnippet.code-snippets 单 bundle 文件
- *   - 兼容 Cursor (100% VSCode snippet 格式)
- *   - Xcode 占位符 <#…#> 自动转换为 VSCode ${N:…}
- *   - 多语言 scope 自动映射
- */
-import type { SnippetSpec } from './SnippetCodec.js';
-import { SnippetCodec } from './SnippetCodec.js';
-export declare class VSCodeCodec extends SnippetCodec {
-    #private;
-    get id(): string;
-    get fileExtension(): string;
-    /** 单个 SnippetSpec → JSON 字符串 */
-    generate(spec: SnippetSpec): string;
-    /**
-     * VSCode: 所有 snippets 合并为单个 JSON bundle 文件
-     * @returns JSON 字符串
-     */
-    generateBundle(specs: SnippetSpec[]): string;
-    /** VSCode snippets 安装目录 = 项目级 .vscode/ */
-    getInstallDir(projectRoot: string): string;
-    mapLanguage(lang: string): string;
-    getBundleFilename(): string;
-}

package/dist/lib/service/snippet/codecs/VSCodeCodec.js

@@ -1,82 +0,0 @@
-/**
- * VSCodeCodec — VSCode .code-snippets (JSON) 生成器
- *
- * 特性:
- *   - 项目级 .vscode/autosnippet.code-snippets 单 bundle 文件
- *   - 兼容 Cursor (100% VSCode snippet 格式)
- *   - Xcode 占位符 <#…#> 自动转换为 VSCode ${N:…}
- *   - 多语言 scope 自动映射
- */
-import { join } from 'node:path';
-import { PlaceholderConverter } from '#platform/ios/snippet/PlaceholderConverter.js';
-import { SnippetCodec } from './SnippetCodec.js';
-/** AutoSnippet language → VSCode snippet scope */
-const VSCODE_LANGUAGE_MAP = {
-    swift: 'swift',
-    'objective-c': 'objective-c',
-    objc: 'objective-c',
-    c: 'c',
-    'c++': 'cpp',
-    go: 'go',
-    python: 'python',
-    java: 'java',
-    kotlin: 'kotlin',
-    javascript: 'javascript,javascriptreact',
-    typescript: 'typescript,typescriptreact',
-    rust: 'rust',
-    ruby: 'ruby',
-};
-const BUNDLE_FILENAME = 'autosnippet.code-snippets';
-export class VSCodeCodec extends SnippetCodec {
-    get id() {
-        return 'vscode';
-    }
-    get fileExtension() {
-        return '.code-snippets';
-    }
-    /** 单个 SnippetSpec → JSON 字符串 */
-    generate(spec) {
-        const entry = this.#specToEntry(spec);
-        return JSON.stringify({ [spec.title || spec.identifier]: entry }, null, 2);
-    }
-    /**
-     * VSCode: 所有 snippets 合并为单个 JSON bundle 文件
-     * @returns JSON 字符串
-     */
-    generateBundle(specs) {
-        const bundle = {};
-        for (const spec of specs) {
-            const key = `Recipe: ${spec.title || spec.identifier}`;
-            bundle[key] = this.#specToEntry(spec);
-        }
-        return `${JSON.stringify(bundle, null, 2)}\n`;
-    }
-    /** VSCode snippets 安装目录 = 项目级 .vscode/ */
-    getInstallDir(projectRoot) {
-        return join(projectRoot, '.vscode');
-    }
-    mapLanguage(lang) {
-        return VSCODE_LANGUAGE_MAP[lang?.toLowerCase()] || '';
-    }
-    getBundleFilename() {
-        return BUNDLE_FILENAME;
-    }
-    /** SnippetSpec → VSCode snippet entry */
-    #specToEntry(spec) {
-        const code = Array.isArray(spec.code) ? spec.code.join('\n') : spec.code || '';
-        // 自动将 Xcode 占位符转为 VSCode 格式
-        const converted = PlaceholderConverter.xcodeToVSCode(code);
-        const body = converted.split('\n');
-        const entry = {
-            prefix: spec.completion || spec.trigger || spec.identifier,
-            body,
-            description: spec.summary || '',
-        };
-        // 添加语言 scope (空字符串 = 所有语言)
-        const scope = this.mapLanguage(spec.language || '');
-        if (scope) {
-            entry.scope = scope;
-        }
-        return entry;
-    }
-}

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;