@winspan/claude-forge 8.34.0 → 8.36.0

package/dist/intelligence/context-gatherer.d.ts

@@ -0,0 +1,101 @@
+/**
+ * ContextGatherer — 在意图分类前并行收集多源上下文
+ *
+ * 设计目标：
+ *   - 给 IntentClassifier 注入 git 状态、对话历史、项目状态等额外信号
+ *   - 总耗时 < 200ms（所有字段并行收集）
+ *   - 单点失败不污染主流程：每个字段独立 try/catch，错误进入 meta.errors
+ *
+ * 数据来源：
+ *   - git: `child_process.execFile`（log / status / branch / rev-list），单命令 2s 超时
+ *   - 对话历史: SQLite `routing_events`（首选）→ `events`（兜底，仅 prompts）
+ *   - resume 块: 项目根 CLAUDE.md → `decodeForgeResumeInnerFromClaudeMd`
+ *   - 项目状态（可选）: `git diff` 最近修改文件 + `dist/` mtime 启发
+ *
+ * 调用约束：
+ *   - 严格 TS，禁止扩散 any
+ *   - 不反向依赖业务层（位于 intelligence 层，仅可依赖 core）
+ */
+import type { SQLiteStorage } from '../core/storage/sqlite.js';
+import type { IntentAnalysis } from './classifier.js';
+export interface GitContext {
+    recentCommits: Array<{
+        hash: string;
+        message: string;
+        timestamp: number;
+    }>;
+    uncommittedFiles: string[];
+    branch: string;
+    remoteStatus: 'ahead' | 'behind' | 'diverged' | 'synced' | 'unknown';
+    aheadCount?: number;
+}
+export interface ConversationContext {
+    previousPrompts: string[];
+    previousIntents: IntentAnalysis[];
+    resumeBlockContent?: string;
+}
+export interface ProjectContext {
+    recentlyModifiedFiles: string[];
+    hasFailedBuild: boolean;
+    lastError?: string;
+}
+export interface ClassificationContext {
+    git: GitContext;
+    conversation: ConversationContext;
+    project?: ProjectContext;
+    meta: {
+        gatherTimeMs: number;
+        fieldsGathered: string[];
+        errors: string[];
+    };
+}
+export interface ContextGathererOptions {
+    includeProject?: boolean;
+    maxHistoryDepth?: number;
+    projectPath?: string;
+}
+export declare class ContextGatherer {
+    private storage;
+    private projectPath;
+    constructor(storage: SQLiteStorage, projectPath: string);
+    /**
+     * 并行收集所有上下文字段。
+     *
+     * 流程：
+     *   1. 用 Promise.allSettled 拉起 git / 对话历史 / resume / project（可选）
+     *   2. 每个 settled 结果转换为 (value, error) 对，error 进入 meta.errors
+     *   3. 所有字段都有 fallback 默认值，保证返回结构完整可用
+     */
+    gather(sessionId: string, options?: ContextGathererOptions): Promise<ClassificationContext>;
+    /**
+     * 并行拉起所有 git 子查询；任一失败都不会拖垮其他。
+     *
+     * 非 git 目录会让 `git branch --show-current` 等命令以非 0 退出，整体
+     * 退化为 EMPTY_GIT_CONTEXT 的子集 — 没分支、没 commit，但不抛出。
+     */
+    private gatherGit;
+    /**
+     * 三段式收集：
+     *   A. routing_events 反查 prompt + intent_json（首选，命中即返回）
+     *   B. routing_events 没有命中 → events 表回退查 user_prompt（仅 prompts）
+     *   C. CLAUDE.md 的 forge:resume 内容（独立任务，不阻塞 A/B）
+     */
+    private gatherConversation;
+    /**
+     * 读 CLAUDE.md 并提取 forge:resume 内容。
+     *
+     * 容错：
+     *   - ENOENT / 权限错误 → 返回 undefined（不视为错误）
+     *   - 文件存在但没 resume 块 → decodeForgeResumeInnerFromClaudeMd 返回 ''，按 undefined 处理
+     */
+    private readResumeBlock;
+    /**
+     * 项目状态收集 — 默认关闭，调用方按需开启。
+     *
+     * 当前启发：
+     *   - recentlyModifiedFiles：HEAD~5..HEAD 的差异文件名
+     *   - hasFailedBuild：dist/ 不存在或 mtime 早于 src/ 的某个时间窗口
+     */
+    private gatherProject;
+}
+//# sourceMappingURL=context-gatherer.d.ts.map

package/dist/intelligence/context-gatherer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-gatherer.d.ts","sourceRoot":"","sources":["../../src/intelligence/context-gatherer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAOH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMtD,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,UAAU,CAAC;IAChB,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE;QACJ,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA8ID,qBAAa,eAAe;IAExB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,WAAW;gBADX,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM;IAG7B;;;;;;;OAOG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC;IA4EjC;;;;;OAKG;YACW,SAAS;IAuDvB;;;;;OAKG;YACW,kBAAkB;IAmEhC;;;;;;OAMG;YACW,eAAe;IAoB7B;;;;;;OAMG;YACW,aAAa;CAuC5B"}

package/dist/intelligence/context-gatherer.js

@@ -0,0 +1,417 @@
+/**
+ * ContextGatherer — 在意图分类前并行收集多源上下文
+ *
+ * 设计目标：
+ *   - 给 IntentClassifier 注入 git 状态、对话历史、项目状态等额外信号
+ *   - 总耗时 < 200ms（所有字段并行收集）
+ *   - 单点失败不污染主流程：每个字段独立 try/catch，错误进入 meta.errors
+ *
+ * 数据来源：
+ *   - git: `child_process.execFile`（log / status / branch / rev-list），单命令 2s 超时
+ *   - 对话历史: SQLite `routing_events`（首选）→ `events`（兜底，仅 prompts）
+ *   - resume 块: 项目根 CLAUDE.md → `decodeForgeResumeInnerFromClaudeMd`
+ *   - 项目状态（可选）: `git diff` 最近修改文件 + `dist/` mtime 启发
+ *
+ * 调用约束：
+ *   - 严格 TS，禁止扩散 any
+ *   - 不反向依赖业务层（位于 intelligence 层，仅可依赖 core）
+ */
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+import { decodeForgeResumeInnerFromClaudeMd } from '../core/utils/forge-resume-block.js';
+import { logger } from '../core/utils/logger.js';
+const execFileAsync = promisify(execFile);
+// ── Defaults ──────────────────────────────────────────────────────────────
+const DEFAULT_HISTORY_DEPTH = 5;
+const GIT_COMMAND_TIMEOUT_MS = 2_000;
+const GIT_LOG_COUNT = 10;
+const EMPTY_GIT_CONTEXT = {
+    recentCommits: [],
+    uncommittedFiles: [],
+    branch: '',
+    remoteStatus: 'unknown',
+};
+// ── Helpers ───────────────────────────────────────────────────────────────
+/**
+ * 错误归一化：把 unknown 异常压成单行字符串，避免日志溢出。
+ */
+function describeError(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+/**
+ * 跑 git 子命令，2s 超时；失败时把错误信息抛给调用方，由上层决定降级策略。
+ *
+ * 用 execFile 而非 execSync：
+ *   - 不阻塞 event loop，可以参与 Promise.all
+ *   - 参数数组形式天然抗 shell 注入
+ */
+async function runGit(args, cwd, timeoutMs = GIT_COMMAND_TIMEOUT_MS) {
+    const { stdout } = await execFileAsync('git', args, {
+        cwd,
+        timeout: timeoutMs,
+        maxBuffer: 1024 * 1024, // 1MB 防御异常输出（仓库异常时 git status 可能爆量）
+        encoding: 'utf-8',
+    });
+    return stdout;
+}
+/**
+ * 解析 `git log --format="%h|%s|%ct"` 单行输出。
+ * 注意：commit message 内本身可能含 `|`，所以只 split 前两个分隔符。
+ */
+function parseLogLine(line) {
+    if (!line.trim())
+        return null;
+    const firstPipe = line.indexOf('|');
+    const lastPipe = line.lastIndexOf('|');
+    if (firstPipe < 0 || lastPipe <= firstPipe)
+        return null;
+    const hash = line.slice(0, firstPipe);
+    const message = line.slice(firstPipe + 1, lastPipe);
+    const tsSec = Number(line.slice(lastPipe + 1));
+    if (!Number.isFinite(tsSec))
+        return null;
+    return { hash, message, timestamp: tsSec * 1000 };
+}
+/**
+ * 解析 `git status --porcelain` 输出为受影响文件路径数组。
+ *
+ * porcelain v1 格式：`XY <path>` 或 `XY <orig> -> <new>`（rename）。
+ * 此处对 rename 也只保留新路径（更符合"最近被改的文件"语义）。
+ */
+function parseStatusFiles(stdout) {
+    const files = [];
+    for (const raw of stdout.split('\n')) {
+        if (!raw)
+            continue;
+        // 去掉前 3 个字符的 XY+空格，保留剩余路径
+        const rest = raw.slice(3).trim();
+        if (!rest)
+            continue;
+        const arrowIdx = rest.indexOf(' -> ');
+        files.push(arrowIdx >= 0 ? rest.slice(arrowIdx + 4) : rest);
+    }
+    return files;
+}
+/**
+ * 解析 `git rev-list --left-right --count origin/<branch>...HEAD` 输出。
+ *
+ * 输出形如 "<behind>\t<ahead>"，左侧是远程领先、右侧是本地领先。
+ */
+function parseAheadBehind(stdout) {
+    const parts = stdout.trim().split(/\s+/);
+    if (parts.length < 2)
+        return null;
+    const behind = Number(parts[0]);
+    const ahead = Number(parts[1]);
+    if (!Number.isFinite(behind) || !Number.isFinite(ahead))
+        return null;
+    return { behind, ahead };
+}
+function classifyRemoteStatus(ahead, behind) {
+    if (ahead > 0 && behind > 0)
+        return 'diverged';
+    if (ahead > 0)
+        return 'ahead';
+    if (behind > 0)
+        return 'behind';
+    return 'synced';
+}
+/**
+ * 安全反序列化 intent_json：失败时返回 null，由上层过滤。
+ *
+ * 不做完整 schema 校验（routing_events 写入由 classifier 控制），只确保
+ * 顶层是对象且关键字段类型大致正确。
+ */
+function safeParseIntent(json) {
+    if (!json)
+        return null;
+    try {
+        const parsed = JSON.parse(json);
+        if (!parsed || typeof parsed !== 'object')
+            return null;
+        const obj = parsed;
+        // 至少有 taskType / complexity / requirement / searchKeywords / reasoning 任一即可视作有效
+        if (typeof obj.taskType === 'string' ||
+            typeof obj.complexity === 'string' ||
+            typeof obj.requirement === 'string') {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Main class ────────────────────────────────────────────────────────────
+export class ContextGatherer {
+    storage;
+    projectPath;
+    constructor(storage, projectPath) {
+        this.storage = storage;
+        this.projectPath = projectPath;
+    }
+    /**
+     * 并行收集所有上下文字段。
+     *
+     * 流程：
+     *   1. 用 Promise.allSettled 拉起 git / 对话历史 / resume / project（可选）
+     *   2. 每个 settled 结果转换为 (value, error) 对，error 进入 meta.errors
+     *   3. 所有字段都有 fallback 默认值，保证返回结构完整可用
+     */
+    async gather(sessionId, options) {
+        const start = Date.now();
+        const cwd = options?.projectPath ?? this.projectPath;
+        const depth = options?.maxHistoryDepth ?? DEFAULT_HISTORY_DEPTH;
+        const includeProject = options?.includeProject === true;
+        const fieldsGathered = [];
+        const errors = [];
+        // 各个收集任务彼此独立，用 allSettled 防止一个 reject 短路其他
+        const gitTask = this.gatherGit(cwd);
+        const conversationTask = this.gatherConversation(sessionId, cwd, depth);
+        const projectTask = includeProject
+            ? this.gatherProject(cwd)
+            : Promise.resolve(undefined);
+        const [gitResult, conversationResult, projectResult] = await Promise.allSettled([
+            gitTask,
+            conversationTask,
+            projectTask,
+        ]);
+        // git
+        let git = EMPTY_GIT_CONTEXT;
+        if (gitResult.status === 'fulfilled') {
+            git = gitResult.value;
+            fieldsGathered.push('git');
+        }
+        else {
+            errors.push(`git: ${describeError(gitResult.reason)}`);
+        }
+        // conversation
+        let conversation = {
+            previousPrompts: [],
+            previousIntents: [],
+        };
+        if (conversationResult.status === 'fulfilled') {
+            conversation = conversationResult.value;
+            fieldsGathered.push('conversation');
+        }
+        else {
+            errors.push(`conversation: ${describeError(conversationResult.reason)}`);
+        }
+        // project（可选）
+        let project;
+        if (includeProject) {
+            if (projectResult.status === 'fulfilled' && projectResult.value) {
+                project = projectResult.value;
+                fieldsGathered.push('project');
+            }
+            else if (projectResult.status === 'rejected') {
+                errors.push(`project: ${describeError(projectResult.reason)}`);
+            }
+        }
+        const elapsed = Date.now() - start;
+        if (errors.length > 0) {
+            logger.debug(`[ContextGatherer] gather completed in ${elapsed}ms with ${errors.length} non-fatal error(s)`);
+        }
+        return {
+            git,
+            conversation,
+            project,
+            meta: {
+                gatherTimeMs: elapsed,
+                fieldsGathered,
+                errors,
+            },
+        };
+    }
+    // ── Git ─────────────────────────────────────────────────────────────────
+    /**
+     * 并行拉起所有 git 子查询；任一失败都不会拖垮其他。
+     *
+     * 非 git 目录会让 `git branch --show-current` 等命令以非 0 退出，整体
+     * 退化为 EMPTY_GIT_CONTEXT 的子集 — 没分支、没 commit，但不抛出。
+     */
+    async gatherGit(cwd) {
+        const [logResult, statusResult, branchResult] = await Promise.allSettled([
+            runGit(['log', `-${GIT_LOG_COUNT}`, '--format=%h|%s|%ct'], cwd),
+            runGit(['status', '--porcelain'], cwd),
+            runGit(['branch', '--show-current'], cwd),
+        ]);
+        const recentCommits = [];
+        if (logResult.status === 'fulfilled') {
+            for (const line of logResult.value.split('\n')) {
+                const parsed = parseLogLine(line);
+                if (parsed)
+                    recentCommits.push(parsed);
+            }
+        }
+        const uncommittedFiles = statusResult.status === 'fulfilled' ? parseStatusFiles(statusResult.value) : [];
+        const branch = branchResult.status === 'fulfilled' ? branchResult.value.trim() : '';
+        // ahead/behind 依赖 branch 名（origin/<branch>），若没分支就跳过
+        let remoteStatus = 'unknown';
+        let aheadCount;
+        if (branch) {
+            try {
+                const stdout = await runGit(['rev-list', '--left-right', '--count', `origin/${branch}...HEAD`], cwd);
+                const counts = parseAheadBehind(stdout);
+                if (counts) {
+                    remoteStatus = classifyRemoteStatus(counts.ahead, counts.behind);
+                    aheadCount = counts.ahead;
+                }
+            }
+            catch {
+                // 没有 origin/<branch>（如新建本地分支、离线仓库）— 保持 unknown
+            }
+        }
+        const ctx = {
+            recentCommits,
+            uncommittedFiles,
+            branch,
+            remoteStatus,
+        };
+        if (aheadCount !== undefined) {
+            ctx.aheadCount = aheadCount;
+        }
+        return ctx;
+    }
+    // ── Conversation ────────────────────────────────────────────────────────
+    /**
+     * 三段式收集：
+     *   A. routing_events 反查 prompt + intent_json（首选，命中即返回）
+     *   B. routing_events 没有命中 → events 表回退查 user_prompt（仅 prompts）
+     *   C. CLAUDE.md 的 forge:resume 内容（独立任务，不阻塞 A/B）
+     */
+    async gatherConversation(sessionId, cwd, depth) {
+        const historyPromise = (async () => {
+            // A: 优先 routing_events
+            const routingRows = this.storage.queryRoutingEvents({
+                session_id: sessionId,
+                limit: depth,
+            });
+            if (routingRows.length > 0) {
+                const prompts = [];
+                const intents = [];
+                for (const r of routingRows) {
+                    if (typeof r.prompt === 'string' && r.prompt.length > 0) {
+                        prompts.push(r.prompt);
+                    }
+                    const intent = safeParseIntent(r.intent_json);
+                    if (intent)
+                        intents.push(intent);
+                }
+                return { previousPrompts: prompts, previousIntents: intents };
+            }
+            // B: 回退到 events 表
+            const events = this.storage.queryEvents({
+                session_id: sessionId,
+                hook_type: 'UserPromptSubmit',
+                limit: depth,
+            });
+            const prompts = [];
+            for (const e of events) {
+                if (typeof e.user_prompt === 'string' && e.user_prompt.length > 0) {
+                    prompts.push(e.user_prompt);
+                }
+            }
+            return { previousPrompts: prompts, previousIntents: [] };
+        })();
+        const resumePromise = this.readResumeBlock(cwd);
+        const [historyResult, resumeResult] = await Promise.allSettled([
+            historyPromise,
+            resumePromise,
+        ]);
+        const result = {
+            previousPrompts: [],
+            previousIntents: [],
+        };
+        if (historyResult.status === 'fulfilled') {
+            result.previousPrompts = historyResult.value.previousPrompts;
+            result.previousIntents = historyResult.value.previousIntents;
+        }
+        else {
+            throw historyResult.reason;
+        }
+        if (resumeResult.status === 'fulfilled' && resumeResult.value) {
+            result.resumeBlockContent = resumeResult.value;
+        }
+        // resume 单点失败静默：CLAUDE.md 不存在是常态，不污染 errors
+        return result;
+    }
+    /**
+     * 读 CLAUDE.md 并提取 forge:resume 内容。
+     *
+     * 容错：
+     *   - ENOENT / 权限错误 → 返回 undefined（不视为错误）
+     *   - 文件存在但没 resume 块 → decodeForgeResumeInnerFromClaudeMd 返回 ''，按 undefined 处理
+     */
+    async readResumeBlock(cwd) {
+        const claudeMdPath = join(cwd, 'CLAUDE.md');
+        try {
+            const content = await readFile(claudeMdPath, 'utf-8');
+            const inner = decodeForgeResumeInnerFromClaudeMd(content);
+            return inner ? inner : undefined;
+        }
+        catch (err) {
+            // 文件不存在是正常情况，不打 warn
+            const code = err?.code;
+            if (code !== 'ENOENT') {
+                logger.debug(`[ContextGatherer] readResumeBlock failed: ${describeError(err)}`);
+            }
+            return undefined;
+        }
+    }
+    // ── Project（可选）─────────────────────────────────────────────────────
+    /**
+     * 项目状态收集 — 默认关闭，调用方按需开启。
+     *
+     * 当前启发：
+     *   - recentlyModifiedFiles：HEAD~5..HEAD 的差异文件名
+     *   - hasFailedBuild：dist/ 不存在或 mtime 早于 src/ 的某个时间窗口
+     */
+    async gatherProject(cwd) {
+        const filesPromise = (async () => {
+            try {
+                const stdout = await runGit(['diff', '--name-only', 'HEAD~5..HEAD'], cwd);
+                return stdout
+                    .split('\n')
+                    .map((s) => s.trim())
+                    .filter((s) => s.length > 0);
+            }
+            catch {
+                return [];
+            }
+        })();
+        const buildPromise = (async () => {
+            const distPath = join(cwd, 'dist');
+            try {
+                const distStat = await stat(distPath);
+                // dist 存在但太老（>7 天）视作失败/过期；这里只判断"不存在"作为最稳妥信号
+                const ageDays = (Date.now() - distStat.mtimeMs) / (1000 * 60 * 60 * 24);
+                return ageDays > 7;
+            }
+            catch {
+                // 不存在 → 视作 hasFailedBuild = true（项目可能未构建过）
+                return true;
+            }
+        })();
+        const [recentlyModifiedFiles, hasFailedBuild] = await Promise.all([
+            filesPromise,
+            buildPromise,
+        ]);
+        return {
+            recentlyModifiedFiles,
+            hasFailedBuild,
+        };
+    }
+}
+//# sourceMappingURL=context-gatherer.js.map

package/dist/intelligence/context-gatherer.js.map

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

package/dist/intelligence/cot-classifier.d.ts

@@ -0,0 +1,95 @@
+/**
+ * CoTClassifier — Chain-of-Thought intent classifier (v2)
+ *
+ * Replaces a single-shot classification with a 5-step reasoning prompt.
+ * Returns a richer intent graph (action / target / candidates) while staying
+ * backward compatible with v1's `IntentAnalysis` shape (taskType / complexity).
+ *
+ * Pipeline:
+ *   1. Build the CoT prompt (scene / contradictions / candidates / chain / final)
+ *   2. Call AI provider with hard timeout (Promise.race)
+ *   3. Extract JSON (strip markdown fences) and strictly validate enums
+ *   4. If finalConfidence < threshold, mark needsClarification + generate question
+ *   5. On parse / validation failure, return a fallback result (fallbackUsed=true)
+ *
+ * The classifier deliberately does NOT keep an LRU cache here: v2 results
+ * depend on `ClassificationContext` (git / conversation / project), which is
+ * mutable across calls. Caching is the caller's responsibility.
+ */
+import type { AIProvider } from '../core/ai/types.js';
+import type { Complexity, TaskType } from './intent-types.js';
+import type { ClassificationContext } from './context-gatherer.js';
+import type { MultimodalInput } from './multimodal-parser.js';
+export type { ClassificationContext, MultimodalInput };
+export type ActionVerb = 'investigate' | 'fix' | 'create' | 'modify' | 'delete' | 'verify' | 'explain' | 'setup' | 'migrate' | 'research';
+export declare const ACTION_VERBS: readonly ActionVerb[];
+export type Domain = 'frontend' | 'backend' | 'database' | 'devops' | 'docs' | 'config' | 'cross';
+export declare const DOMAINS: readonly Domain[];
+export type Artifact = 'code' | 'test' | 'config' | 'doc' | 'build' | 'deploy' | 'schema';
+export declare const ARTIFACTS: readonly Artifact[];
+export type Scope = 'line' | 'function' | 'file' | 'module' | 'system';
+export declare const SCOPES: readonly Scope[];
+export interface IntentTarget {
+    domain: Domain;
+    artifact: Artifact;
+    scope: Scope;
+}
+export interface ReasoningStep {
+    step: number;
+    name: string;
+    content: string;
+    confidence?: number;
+}
+export interface IntentCandidate {
+    action: ActionVerb;
+    taskType: TaskType;
+    confidence: number;
+    reasoning: string;
+}
+export interface CoTResult {
+    requirement: string;
+    complexity: Complexity;
+    taskType: TaskType;
+    searchKeywords: string[];
+    reasoning: string;
+    fallbackUsed?: boolean;
+    classificationMs?: number;
+    isMetaPrompt?: boolean;
+    action: ActionVerb;
+    target: IntentTarget;
+    candidates: IntentCandidate[];
+    finalConfidence: number;
+    reasoningSteps: ReasoningStep[];
+    needsClarification?: boolean;
+    clarificationQuestion?: string;
+}
+export interface CoTClassifierOptions {
+    /** Override model used for classification. */
+    model?: string;
+    /** Hard timeout in ms (default 15_000). */
+    timeoutMs?: number;
+    /** finalConfidence below this triggers clarification (default 0.7). */
+    clarificationThreshold?: number;
+}
+export declare class CoTClassifier {
+    private ai;
+    private readonly model?;
+    private readonly timeoutMs;
+    private readonly clarificationThreshold;
+    constructor(ai: AIProvider, options?: CoTClassifierOptions);
+    classify(input: MultimodalInput, context: ClassificationContext): Promise<CoTResult>;
+    private completeWithTimeout;
+    private buildFallback;
+}
+export declare function buildCoTPrompt(input: MultimodalInput, context: ClassificationContext): string;
+/**
+ * Extract a JSON object from the AI response. Tolerates:
+ *   - ```json ... ``` fenced blocks
+ *   - ``` ... ``` fenced blocks (no language)
+ *   - bare JSON
+ *
+ * Returns the validated CoTResult, or null on any validation failure.
+ * Exported for unit tests.
+ */
+export declare function parseCoTResponse(response: string, input: MultimodalInput): CoTResult | null;
+//# sourceMappingURL=cot-classifier.d.ts.map

package/dist/intelligence/cot-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cot-classifier.d.ts","sourceRoot":"","sources":["../../src/intelligence/cot-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE9D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAM9D,YAAY,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC;AAMvD,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,OAAO,GACP,SAAS,GACT,UAAU,CAAC;AAEf,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAGpC,CAAC;AAEX,MAAM,MAAM,MAAM,GACd,UAAU,GACV,SAAS,GACT,UAAU,GACV,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,OAAO,CAAC;AAEZ,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAE3B,CAAC;AAEX,MAAM,MAAM,QAAQ,GAChB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,KAAK,GACL,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;AAEb,eAAO,MAAM,SAAS,EAAE,SAAS,QAAQ,EAE/B,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEvE,eAAO,MAAM,MAAM,EAAE,SAAS,KAAK,EAEzB,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IAExB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,UAAU,CAAC;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IAGvB,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAgBD,qBAAa,aAAa;IAKZ,OAAO,CAAC,EAAE;IAJtB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAS;gBAE5B,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAO5D,QAAQ,CACZ,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,SAAS,CAAC;YAqCP,mBAAmB;IA2BjC,OAAO,CAAC,aAAa;CA6BtB;AAMD,wBAAgB,cAAc,CAC5B,KAAK,EAAE,eAAe,EACtB,OAAO,EAAE,qBAAqB,GAC7B,MAAM,CAgIR;AAuED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,eAAe,GACrB,SAAS,GAAG,IAAI,CAkDlB"}