@winspan/claude-forge 8.34.0 → 8.36.0

package/dist/intelligence/classifier.d.ts

@@ -1,55 +1,75 @@
 /**
- * IntentClassifier — intent classification for UserPromptSubmit routing
+ * IntentClassifier — V2 intent classification facade (CoT + multimodal + context).
  *
- * Output contract:
- *   { complexity, taskType, searchKeywords, reasoning }
+ * Pipeline:
+ *   1. Meta-prompt short-circuit (V1 logic preserved)
+ *   2. AI unavailable → regex/keyword fallback (V1 logic preserved)
+ *   3. V2 path:
+ *        a. Parallel `MultimodalParser.parse` + `ContextGatherer.gather`
+ *        b. `CoTClassifier.classify` → returns CoTResult
+ *        c. On any failure (parser/gatherer/CoT) → fallback() with elapsed time
  *
- * Layered strategy (fast → slow):
- *   1. Regex ground-truth   — explicit simple commands (ls/pwd/...) → skip AI
- *   2. LRU cache            — repeated prompts
- *   3. AI classification    — 3s hard timeout
- *   4. Regex fallback       — AI timeout/failure
+ * Output contract (`IntentAnalysis`):
+ *   - V1 fields preserved: requirement / complexity / taskType / searchKeywords /
+ *     reasoning / classificationMs / fallbackUsed / isMetaPrompt
+ *   - V2 fields added: action / target / candidates / finalConfidence /
+ *     reasoningSteps / needsClarification / clarificationQuestion
+ *
+ * Downstream consumers that only read V1 fields keep working unchanged.
+ * V2-aware consumers (e.g. AgentRouter) can use action/target for finer routing.
  */
 import type { AIProvider } from '../core/ai/types.js';
-export type Complexity = 'simple' | 'moderate' | 'complex';
-export type TaskType = 'build_system' | 'add_feature' | 'refactor' | 'migrate' | 'fix_bug' | 'analyze_requirement' | 'design_architecture' | 'design_api' | 'design_schema' | 'write_code' | 'write_test' | 'review' | 'audit_security' | 'optimize_perf' | 'write_spec' | 'review_doc' | 'create_pr' | 'explain' | 'setup_project' | 'cleanup_code' | 'upgrade_dependency' | 'improve_coverage' | 'check_quality' | 'research' | 'investigate' | 'compare_solutions' | 'write_doc' | 'analyze_codebase' | 'multi_domain' | 'other';
-export declare const TASK_TYPES: readonly TaskType[];
-export interface IntentAnalysis {
-    requirement: string;
-    complexity: Complexity;
-    taskType: TaskType;
-    searchKeywords: string[];
-    reasoning: string;
-    /** True when AI timed out or failed and regex fallback was used. */
-    fallbackUsed?: boolean;
-    /** AI classification latency in ms (undefined when fallback-only path). */
-    classificationMs?: number;
-    /**
-     * Meta 控制类 prompt（"继续"/"开启多个 agent"/列表前缀等），下游应跳过
-     * 路由和方法论匹配。避免 classifier 对这类指令类 prompt 的误分类触发
-     * 不必要的 agent 路由 / methodology plan，造成违抗数据 + 死循环。
-     */
-    isMetaPrompt?: boolean;
-}
+import type { SQLiteStorage } from '../core/storage/sqlite.js';
+import { type CoTResult, type ActionVerb, type Domain, type Artifact, type Scope, type IntentTarget, type IntentCandidate, type ReasoningStep } from './cot-classifier.js';
+import { type Complexity, type TaskType, TASK_TYPES } from './intent-types.js';
+export type { Complexity, TaskType, ActionVerb, Domain, Artifact, Scope, IntentTarget, IntentCandidate, ReasoningStep, CoTResult, };
+export { TASK_TYPES };
+/**
+ * V2 IntentAnalysis === CoTResult.
+ *
+ * The shape contains all V1 fields (complexity / taskType / searchKeywords /
+ * reasoning / fallbackUsed / classificationMs / isMetaPrompt) plus V2 additions
+ * (action / target / candidates / finalConfidence / reasoningSteps /
+ * needsClarification / clarificationQuestion).
+ */
+export type IntentAnalysis = CoTResult;
 export interface IntentClassifierOptions {
-    /** Override model for classification (e.g. use haiku while distill uses opus). */
+    /** Storage handle used by ContextGatherer to read routing_events / events history. */
+    storage: SQLiteStorage;
+    /** Project root path used as default cwd for git / resume lookups. */
+    projectPath: string;
+    /** Override model for CoT classification. */
     model?: string;
-    /** Hard timeout in ms. Defaults to 10_000. */
+    /** Override model for Vision (passed to MultimodalParser). */
+    visionModel?: string;
+    /** Hard timeout for CoT classification call (ms). Defaults to 20_000 (15-20s target). */
     timeoutMs?: number;
+    /** Per-image vision timeout (ms). Defaults to MultimodalParser internal default. */
+    visionTimeoutMs?: number;
+    /** finalConfidence below this triggers needsClarification (default 0.7). */
+    clarificationThreshold?: number;
 }
+export declare function isMetaPrompt(prompt: string): boolean;
+declare const TASK_TYPE_KEYWORDS: Array<{
+    taskType: TaskType;
+    patterns: RegExp[];
+}>;
+declare function guessTaskType(prompt: string): TaskType;
+declare function extractKeywords(prompt: string): string[];
 export declare class IntentClassifier {
-    private ai;
-    private cache;
-    private readonly model?;
-    private readonly timeoutMs;
-    constructor(ai: AIProvider | null, options?: IntentClassifierOptions);
-    classify(prompt: string, projectPath: string): Promise<IntentAnalysis>;
-    private matchGroundTruth;
-    private aiClassifyWithTimeout;
-    private aiClassify;
-    private parseAIResponse;
-    private fallback;
-    private guessTaskType;
-    private extractKeywords;
+    private readonly ai;
+    private readonly options;
+    private readonly parser;
+    private readonly gatherer;
+    private readonly cot;
+    constructor(ai: AIProvider | null, options: IntentClassifierOptions);
+    /**
+     * Classify a user prompt.
+     *
+     * @param prompt    Raw user prompt (may include `[Image #N]` markers or code blocks).
+     * @param sessionId Used by ContextGatherer to fetch the session's prior history.
+     */
+    classify(prompt: string, sessionId: string): Promise<IntentAnalysis>;
 }
+export { guessTaskType, extractKeywords, TASK_TYPE_KEYWORDS };
 //# sourceMappingURL=classifier.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/intelligence/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AAE3D,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,aAAa,GACb,UAAU,GACV,SAAS,GACT,SAAS,GACT,qBAAqB,GACrB,qBAAqB,GACrB,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,QAAQ,GACR,gBAAgB,GAChB,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,WAAW,GACX,SAAS,GACT,eAAe,GACf,cAAc,GACd,oBAAoB,GACpB,kBAAkB,GAClB,eAAe,GACf,UAAU,GACV,aAAa,GACb,mBAAmB,GACnB,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,OAAO,CAAC;AAEZ,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAQhC,CAAC;AAEX,MAAM,WAAW,cAAc;IAC7B,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,oEAAoE;IACpE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkGD,MAAM,WAAW,uBAAuB;IACtC,kFAAkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAKf,OAAO,CAAC,EAAE;IAJtB,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEf,EAAE,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,uBAAuB;IAKtE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAwD5E,OAAO,CAAC,gBAAgB;YA4BV,qBAAqB;YAYrB,UAAU;IAgCxB,OAAO,CAAC,eAAe;IA2BvB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;CAOxB"}
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/intelligence/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,KAAK,EACV,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,KAAK,UAAU,EACf,KAAK,QAAQ,EACb,UAAU,EACX,MAAM,mBAAmB,CAAC;AAK3B,YAAY,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,MAAM,EACN,QAAQ,EACR,KAAK,EACL,YAAY,EACZ,eAAe,EACf,aAAa,EACb,SAAS,GACV,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAIvC,MAAM,WAAW,uBAAuB;IACtC,sFAAsF;IACtF,OAAO,EAAE,aAAa,CAAC;IACvB,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAkBD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAapD;AAgBD,QAAA,MAAM,kBAAkB,EAAE,KAAK,CAAC;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAgCzE,CAAC;AAEF,iBAAS,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAY/C;AAED,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA+BjD;AAgHD,qBAAa,gBAAgB;IAMzB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;gBAGxB,EAAE,EAAE,UAAU,GAAG,IAAI,EACrB,OAAO,EAAE,uBAAuB;IAuBnD;;;;;OAKG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAiE3E;AA4BD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,kBAAkB,EAAE,CAAC"}