autosnippet 3.2.16 → 3.2.17

package/dist/lib/{service/agent → agent}/domain/EvidenceCollector.d.ts

@@ -121,16 +121,13 @@ interface ToolResultObject {
 type ToolResult = string | ToolResultObject | null | undefined;
 export declare class EvidenceCollector {
     #private;
-    /**
-     * @param {object} [options]
-     * @param {number} [options.snippetBudget=32000] 代码片段总字符预算
-     */
+    /** @param [options.snippetBudget=32000] 代码片段总字符预算 */
     constructor(options?: EvidenceCollectorOptions);
     /**
      * 处理单个工具调用，提取证据
      *
-     * @param {object} toolCall - { tool/name, params/args, result }
-     * @param {number} [round=0] 调用序号
+     * @param toolCall { tool/name, params/args, result }
+     * @param [round=0] 调用序号
      */
     processToolCall(toolCall: ToolCall, round?: number): void;
     /**
@@ -149,4 +146,3 @@ export declare class EvidenceCollector {
     };
 }
 export default EvidenceCollector;
-//# sourceMappingURL=EvidenceCollector.d.ts.map

package/dist/lib/{service/agent → agent}/domain/EvidenceCollector.js

@@ -35,10 +35,7 @@ export class EvidenceCollector {
     #snippetBudget;
     /** @type {number} 当前已使用的片段字符数 */
     #snippetCharsUsed = 0;
-    /**
-     * @param {object} [options]
-     * @param {number} [options.snippetBudget=32000] 代码片段总字符预算
-     */
+    /** @param [options.snippetBudget=32000] 代码片段总字符预算 */
     constructor(options = {}) {
         this.#snippetBudget = options.snippetBudget ?? DEFAULT_SNIPPET_BUDGET;
     }
@@ -46,8 +43,8 @@ export class EvidenceCollector {
     /**
      * 处理单个工具调用，提取证据
      *
-     * @param {object} toolCall - { tool/name, params/args, result }
-     * @param {number} [round=0] 调用序号
+     * @param toolCall { tool/name, params/args, result }
+     * @param [round=0] 调用序号
      */
     processToolCall(toolCall, round = 0) {
         const tool = toolCall.tool || toolCall.name;
@@ -190,9 +187,7 @@ export class EvidenceCollector {
             }
         }
     }
-    /**
-     * get_class_info — 提取类结构 → evidenceMap
-     */
+    /** get_class_info — 提取类结构 → evidenceMap */
     #extractClassEvidence(args, result) {
         if (typeof result !== 'object' || !result) {
             return;
@@ -223,9 +218,7 @@ export class EvidenceCollector {
         const classSummary = parts.join(' | ');
         entry.summary = entry.summary ? `${entry.summary}; ${classSummary}` : classSummary;
     }
-    /**
-     * get_protocol_info — 提取协议结构 → evidenceMap
-     */
+    /** get_protocol_info — 提取协议结构 → evidenceMap */
     #extractProtocolEvidence(args, result) {
         if (typeof result !== 'object' || !result) {
             return;
@@ -247,9 +240,7 @@ export class EvidenceCollector {
         const summary = parts.join(' | ');
         entry.summary = entry.summary ? `${entry.summary}; ${summary}` : summary;
     }
-    /**
-     * get_file_summary — 提取文件级摘要 → evidenceMap
-     */
+    /** get_file_summary — 提取文件级摘要 → evidenceMap */
     #extractFileSummary(args, result) {
         const filePath = args.filePath || (typeof result === 'object' && result?.filePath);
         if (!filePath) {
@@ -475,4 +466,3 @@ export class EvidenceCollector {
 // 类型定义 (JSDoc)
 // ──────────────────────────────────────────────────────────────────
 export default EvidenceCollector;
-//# sourceMappingURL=EvidenceCollector.js.map

package/dist/lib/{service/agent → agent}/domain/insight-analyst.d.ts

@@ -83,14 +83,12 @@ export declare const ANALYST_BUDGET: {
  *   §8 历史语义记忆 (Tier 3)
  *   §9 代码实体图谱 (Phase E)
  *
- * @param {object} dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
- * @param {object} projectInfo - { name, lang, fileCount }
- * @param {object} [dimensionContext] - DimensionContext 实例 (跨维度上下文)
- * @param {object} [episodicMemory] - SessionStore 实例 (v4.0 增强上下文)
- * @param {object} [semanticMemory] - PersistentMemory 实例 (v4.1 历史记忆)
- * @param {object} [codeEntityGraph] - CodeEntityGraph 实例 (Phase E 代码实体图谱)
- * @returns {Promise<string>}
+ * @param dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
+ * @param projectInfo { name, lang, fileCount }
+ * @param [dimensionContext] DimensionContext 实例 (跨维度上下文)
+ * @param [episodicMemory] SessionStore 实例 (v4.0 增强上下文)
+ * @param [semanticMemory] PersistentMemory 实例 (v4.1 历史记忆)
+ * @param [codeEntityGraph] CodeEntityGraph 实例 (Phase E 代码实体图谱)
  */
 export declare function buildAnalystPrompt(dimConfig: AnalystDimConfig, projectInfo: AnalystProjectInfo, dimensionContext: DimensionContextLike | null | undefined, episodicMemory: EpisodicMemoryLike | null | undefined, semanticMemory: SemanticMemoryLike | null | undefined, codeEntityGraph: CodeEntityGraphLike | null | undefined): Promise<string>;
 export {};
-//# sourceMappingURL=insight-analyst.d.ts.map

package/dist/lib/{service/agent → agent}/domain/insight-analyst.js

@@ -94,13 +94,12 @@ export const ANALYST_BUDGET = {
  *   §8 历史语义记忆 (Tier 3)
  *   §9 代码实体图谱 (Phase E)
  *
- * @param {object} dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
- * @param {object} projectInfo - { name, lang, fileCount }
- * @param {object} [dimensionContext] - DimensionContext 实例 (跨维度上下文)
- * @param {object} [episodicMemory] - SessionStore 实例 (v4.0 增强上下文)
- * @param {object} [semanticMemory] - PersistentMemory 实例 (v4.1 历史记忆)
- * @param {object} [codeEntityGraph] - CodeEntityGraph 实例 (Phase E 代码实体图谱)
- * @returns {Promise<string>}
+ * @param dimConfig 维度配置 { id, label, guide, focusKeywords, outputType }
+ * @param projectInfo { name, lang, fileCount }
+ * @param [dimensionContext] DimensionContext 实例 (跨维度上下文)
+ * @param [episodicMemory] SessionStore 实例 (v4.0 增强上下文)
+ * @param [semanticMemory] PersistentMemory 实例 (v4.1 历史记忆)
+ * @param [codeEntityGraph] CodeEntityGraph 实例 (Phase E 代码实体图谱)
  */
 export async function buildAnalystPrompt(dimConfig, projectInfo, dimensionContext, episodicMemory, semanticMemory, codeEntityGraph) {
     const parts = [];
@@ -221,4 +220,3 @@ ${depthHint}
     }
     return parts.join('\n\n');
 }
-//# sourceMappingURL=insight-analyst.js.map

package/dist/lib/{service/agent → agent}/domain/insight-gate.d.ts

@@ -81,10 +81,9 @@ export declare function sanitizeAnalysisText(text: string): string;
 /**
  * 从 Analyst 的执行结果构建 AnalysisReport (v1)
  *
- * @param {object} analystResult - { reply, toolCalls }
- * @param {string} dimensionId 维度 ID
- * @param {object} [projectGraph] - ProjectGraph 实例
- * @returns {AnalysisReport}
+ * @param analystResult { reply, toolCalls }
+ * @param dimensionId 维度 ID
+ * @param [projectGraph] ProjectGraph 实例
  */
 export declare function buildAnalysisReport(analystResult: AnalystResult, dimensionId: string, projectGraph?: ProjectGraphLike | null): {
     analysisText: string;
@@ -109,11 +108,10 @@ export declare function buildAnalysisReport(analystResult: AnalystResult, dimens
  * - findings: 来自 ActiveContext 的结构化发现
  * - qualityReport: 多维度质量评分
  *
- * @param {object} analystResult - { reply, toolCalls }
- * @param {string} dimensionId 维度 ID
- * @param {object} [projectGraph] - ProjectGraph 实例
- * @param {object} [activeContext] - ActiveContext 实例
- * @returns {AnalysisArtifact}
+ * @param analystResult { reply, toolCalls }
+ * @param dimensionId 维度 ID
+ * @param [projectGraph] ProjectGraph 实例
+ * @param [activeContext] ActiveContext 实例
  */
 export declare function buildAnalysisArtifact(analystResult: AnalystResult, dimensionId: string, projectGraph?: ProjectGraphLike | null, activeContext?: ActiveContextLike | null): {
     analysisText: string;
@@ -150,17 +148,14 @@ export declare function buildAnalysisArtifact(analystResult: AnalystResult, dime
  * - v2: 从 qualityReport.totalScore 计算
  * - v1: 使用 4 条规则
  *
- * @param {AnalysisReport|AnalysisArtifact} report
- * @param {object} [options]
- * @param {string} [options.outputType] - 'analysis' | 'dual' | 'candidate'
- * @returns {{ pass: boolean, reason?: string, action?: 'retry' | 'degrade' }}
+ * @param [options.outputType] 'analysis' | 'dual' | 'candidate'
+ * @returns }
  */
 export declare function analysisQualityGate(report: GateableReport, options?: GateOptions): GateResult;
 /**
  * 构建重试提示
  *
- * @param {string} reason - Gate 失败原因
- * @returns {string}
+ * @param reason Gate 失败原因
  */
 export declare function buildRetryPrompt(reason: string): string;
 /**
@@ -169,10 +164,10 @@ export declare function buildRetryPrompt(reason: string): string;
  * 将 PipelineStrategy 的 (source, phaseResults, strategyContext) 签名
  * 适配到 buildAnalysisArtifact + analysisQualityGate 调用链。
  *
- * @param {object} source 前一阶段 (analyze) 的 reactLoop 返回值
- * @param {object} phaseResults 所有阶段结果
- * @param {object} strategyContext - orchestrator 注入的运行时上下文
- * @returns {{ action: 'pass'|'retry'|'degrade', reason: string, artifact: object }}
+ * @param source 前一阶段 (analyze) 的 reactLoop 返回值
+ * @param phaseResults 所有阶段结果
+ * @param strategyContext orchestrator 注入的运行时上下文
+ * @returns }
  */
 export declare function insightGateEvaluator(source: unknown, phaseResults: Record<string, unknown>, strategyContext?: Record<string, unknown>): {
     action: string;
@@ -196,28 +191,3 @@ export declare function insightGateEvaluator(source: unknown, phaseResults: Reco
     };
 };
 export {};
-/**
- * @typedef {object} AnalysisReport
- * @property {string} analysisText
- * @property {string[]} referencedFiles
- * @property {string[]} searchQueries
- * @property {string[]} classesExplored
- * @property {string} dimensionId
- * @property {object} metadata - { iterations, toolCallCount }
- */
-/**
- * @typedef {object} AnalysisArtifact
- * @property {string} analysisText
- * @property {Array<{claim: string, evidence: string[], importance: number, source: string}>} findings
- * @property {string[]} referencedFiles
- * @property {string} dimensionId
- * @property {Map<string, import('./EvidenceCollector.js').EvidenceEntry>} evidenceMap
- * @property {import('./EvidenceCollector.js').ExplorationEntry[]} explorationLog
- * @property {import('./EvidenceCollector.js').NegativeSignal[]} negativeSignals
- * @property {Array} [fullToolTrace]
- * @property {{ scores: object, totalScore: number, suggestions: string[] }} qualityReport
- * @property {object} metadata
- * @property {string[]} searchQueries
- * @property {string[]} classesExplored
- */
-//# sourceMappingURL=insight-gate.d.ts.map

package/dist/lib/{service/agent → agent}/domain/insight-gate.js

@@ -70,10 +70,9 @@ export function sanitizeAnalysisText(text) {
 /**
  * 从 Analyst 的执行结果构建 AnalysisReport (v1)
  *
- * @param {object} analystResult - { reply, toolCalls }
- * @param {string} dimensionId 维度 ID
- * @param {object} [projectGraph] - ProjectGraph 实例
- * @returns {AnalysisReport}
+ * @param analystResult { reply, toolCalls }
+ * @param dimensionId 维度 ID
+ * @param [projectGraph] ProjectGraph 实例
  */
 export function buildAnalysisReport(analystResult, dimensionId, projectGraph = null) {
     const referencedFiles = new Set();
@@ -169,11 +168,10 @@ export function buildAnalysisReport(analystResult, dimensionId, projectGraph = n
  * - findings: 来自 ActiveContext 的结构化发现
  * - qualityReport: 多维度质量评分
  *
- * @param {object} analystResult - { reply, toolCalls }
- * @param {string} dimensionId 维度 ID
- * @param {object} [projectGraph] - ProjectGraph 实例
- * @param {object} [activeContext] - ActiveContext 实例
- * @returns {AnalysisArtifact}
+ * @param analystResult { reply, toolCalls }
+ * @param dimensionId 维度 ID
+ * @param [projectGraph] ProjectGraph 实例
+ * @param [activeContext] ActiveContext 实例
  */
 export function buildAnalysisArtifact(analystResult, dimensionId, projectGraph = null, activeContext = null) {
     const toolCalls = analystResult.toolCalls || [];
@@ -284,10 +282,8 @@ function buildQualityScores(analysisText, findings, evidence) {
  * - v2: 从 qualityReport.totalScore 计算
  * - v1: 使用 4 条规则
  *
- * @param {AnalysisReport|AnalysisArtifact} report
- * @param {object} [options]
- * @param {string} [options.outputType] - 'analysis' | 'dual' | 'candidate'
- * @returns {{ pass: boolean, reason?: string, action?: 'retry' | 'degrade' }}
+ * @param [options.outputType] 'analysis' | 'dual' | 'candidate'
+ * @returns }
  */
 export function analysisQualityGate(report, options = {}) {
     if (report.qualityReport?.scores) {
@@ -346,8 +342,7 @@ function analysisQualityGateV1(report, options = {}) {
 /**
  * 构建重试提示
  *
- * @param {string} reason - Gate 失败原因
- * @returns {string}
+ * @param reason Gate 失败原因
  */
 export function buildRetryPrompt(reason) {
     const hints = {
@@ -367,10 +362,10 @@ export function buildRetryPrompt(reason) {
  * 将 PipelineStrategy 的 (source, phaseResults, strategyContext) 签名
  * 适配到 buildAnalysisArtifact + analysisQualityGate 调用链。
  *
- * @param {object} source 前一阶段 (analyze) 的 reactLoop 返回值
- * @param {object} phaseResults 所有阶段结果
- * @param {object} strategyContext - orchestrator 注入的运行时上下文
- * @returns {{ action: 'pass'|'retry'|'degrade', reason: string, artifact: object }}
+ * @param source 前一阶段 (analyze) 的 reactLoop 返回值
+ * @param phaseResults 所有阶段结果
+ * @param strategyContext orchestrator 注入的运行时上下文
+ * @returns }
  */
 export function insightGateEvaluator(source, phaseResults, strategyContext = {}) {
     if (!source?.reply) {
@@ -390,28 +385,3 @@ export function insightGateEvaluator(source, phaseResults, strategyContext = {})
 // ──────────────────────────────────────────────────────────────────
 // 类型定义 (JSDoc)
 // ──────────────────────────────────────────────────────────────────
-/**
- * @typedef {object} AnalysisReport
- * @property {string} analysisText
- * @property {string[]} referencedFiles
- * @property {string[]} searchQueries
- * @property {string[]} classesExplored
- * @property {string} dimensionId
- * @property {object} metadata - { iterations, toolCallCount }
- */
-/**
- * @typedef {object} AnalysisArtifact
- * @property {string} analysisText
- * @property {Array<{claim: string, evidence: string[], importance: number, source: string}>} findings
- * @property {string[]} referencedFiles
- * @property {string} dimensionId
- * @property {Map<string, import('./EvidenceCollector.js').EvidenceEntry>} evidenceMap
- * @property {import('./EvidenceCollector.js').ExplorationEntry[]} explorationLog
- * @property {import('./EvidenceCollector.js').NegativeSignal[]} negativeSignals
- * @property {Array} [fullToolTrace]
- * @property {{ scores: object, totalScore: number, suggestions: string[] }} qualityReport
- * @property {object} metadata
- * @property {string[]} searchQueries
- * @property {string[]} classesExplored
- */
-//# sourceMappingURL=insight-gate.js.map

package/dist/lib/{service/agent → agent}/domain/insight-producer.d.ts

@@ -75,10 +75,8 @@ export declare const PRODUCER_BUDGET: {
 /**
  * 构建 Producer Prompt (v1 — 用于 AnalysisReport)
  *
- * @param {import('./insight-gate.js').AnalysisReport} analysisReport
- * @param {object} dimConfig - { id, label, allowedKnowledgeTypes, outputType }
- * @param {object} projectInfo - { name }
- * @returns {string}
+ * @param dimConfig { id, label, allowedKnowledgeTypes, outputType }
+ * @param projectInfo { name }
  */
 export declare function buildProducerPrompt(analysisReport: AnalysisReportLike, dimConfig: DimConfig, projectInfo: ProjectInfo): string;
 /**
@@ -88,11 +86,6 @@ export declare function buildProducerPrompt(analysisReport: AnalysisReportLike,
  * - §3 结构化发现 (findings)
  * - §4 代码证据 (evidenceMap → code context)
  * - §5 负空间信号
- *
- * @param {import('./insight-gate.js').AnalysisArtifact} artifact
- * @param {object} dimConfig
- * @param {object} projectInfo
- * @returns {string}
  */
 export declare function buildProducerPromptV2(artifact: AnalysisArtifactLike, dimConfig: DimConfig, projectInfo: ProjectInfo): string;
 /**
@@ -100,9 +93,6 @@ export declare function buildProducerPromptV2(artifact: AnalysisArtifactLike, di
  *
  * 策略: 按代码片段数量排序
  * 预算: ≤ 4000 chars (~1000 tokens)
- *
- * @param {Map<string, import('./EvidenceCollector.js').EvidenceEntry>} evidenceMap
- * @returns {string|null}
  */
 export declare function buildCodeContextSection(evidenceMap: Map<string, EvidenceEntry> | null | undefined): string | null;
 /**
@@ -110,14 +100,11 @@ export declare function buildCodeContextSection(evidenceMap: Map<string, Evidenc
  *
  * 当 produce 阶段的提交拒绝率过高时触发 retry。
  *
- * @param {object} source - produce 阶段的 reactLoop 返回值
- * @param {object} _phaseResults
- * @param {object} _strategyContext
- * @returns {{ action: 'pass'|'retry', reason: string }}
+ * @param source produce 阶段的 reactLoop 返回值
+ * @returns }
  */
 export declare function producerRejectionGateEvaluator(source: ReactLoopResult | null | undefined, _phaseResults: unknown, _strategyContext?: GateStrategyContext): {
     action: string;
     reason: string;
 };
 export {};
-//# sourceMappingURL=insight-producer.d.ts.map

package/dist/lib/{service/agent → agent}/domain/insight-producer.js

@@ -14,7 +14,7 @@
  *
  * @module insight-producer
  */
-import { buildProducerStyleGuide, SUBMIT_REQUIREMENTS } from '#shared/StyleGuide.js';
+import { buildProducerStyleGuide, SUBMIT_REQUIREMENTS } from '#domain/knowledge/StyleGuide.js';
 // ──────────────────────────────────────────────────────────────────
 // System Prompt — Producer 专用 (~150 tokens)
 // ──────────────────────────────────────────────────────────────────
@@ -74,10 +74,8 @@ const STYLE_GUIDE = buildProducerStyleGuide();
 /**
  * 构建 Producer Prompt (v1 — 用于 AnalysisReport)
  *
- * @param {import('./insight-gate.js').AnalysisReport} analysisReport
- * @param {object} dimConfig - { id, label, allowedKnowledgeTypes, outputType }
- * @param {object} projectInfo - { name }
- * @returns {string}
+ * @param dimConfig { id, label, allowedKnowledgeTypes, outputType }
+ * @param projectInfo { name }
  */
 export function buildProducerPrompt(analysisReport, dimConfig, projectInfo) {
     const parts = [];
@@ -101,11 +99,6 @@ export function buildProducerPrompt(analysisReport, dimConfig, projectInfo) {
  * - §3 结构化发现 (findings)
  * - §4 代码证据 (evidenceMap → code context)
  * - §5 负空间信号
- *
- * @param {import('./insight-gate.js').AnalysisArtifact} artifact
- * @param {object} dimConfig
- * @param {object} projectInfo
- * @returns {string}
  */
 export function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
     const parts = [];
@@ -161,9 +154,6 @@ export function buildProducerPromptV2(artifact, dimConfig, projectInfo) {
  *
  * 策略: 按代码片段数量排序
  * 预算: ≤ 4000 chars (~1000 tokens)
- *
- * @param {Map<string, import('./EvidenceCollector.js').EvidenceEntry>} evidenceMap
- * @returns {string|null}
  */
 export function buildCodeContextSection(evidenceMap) {
     if (!evidenceMap || evidenceMap.size === 0) {
@@ -209,10 +199,8 @@ export function buildCodeContextSection(evidenceMap) {
  *
  * 当 produce 阶段的提交拒绝率过高时触发 retry。
  *
- * @param {object} source - produce 阶段的 reactLoop 返回值
- * @param {object} _phaseResults
- * @param {object} _strategyContext
- * @returns {{ action: 'pass'|'retry', reason: string }}
+ * @param source produce 阶段的 reactLoop 返回值
+ * @returns }
  */
 export function producerRejectionGateEvaluator(source, _phaseResults, _strategyContext = {}) {
     if (!source?.toolCalls) {
@@ -240,4 +228,3 @@ export function producerRejectionGateEvaluator(source, _phaseResults, _strategyC
     }
     return { action: 'pass', reason: '' };
 }
-//# sourceMappingURL=insight-producer.js.map

package/dist/lib/{service/agent → agent}/domain/scan-prompts.d.ts

@@ -43,19 +43,12 @@ interface ScanPipelineOpts {
     files?: ScanSourceFile[];
     analyzeMaxIter?: number;
 }
-/**
- * @typedef {Object} ScanTaskConfig
- * @property {string} producePrompt - Produce 阶段的 systemPrompt
- * @property {(label: string) => Object} fallback 解析失败时的默认值工厂
- */
 /**
  * task → Produce 阶段配置 (extract + summarize)
  *
  * 两种 task 均为工具驱动 (collect_scan_recipe)，Recipe 格式与冷启动 submit_knowledge 对齐:
  * - extract: 多文件 target 扫描 → 多个 Recipe
  * - summarize: 单文件/代码片段 → 1~2 个 Recipe
- *
- * @type {Record<string, ScanTaskConfig>}
  */
 export declare const SCAN_TASK_CONFIGS: {
     extract: {
@@ -92,14 +85,13 @@ export declare const SCAN_TASK_CONFIGS: {
  *   - strategyContext 需要包含 activeContext / outputType / dimId
  *     (由 AgentFactory.buildSystemContext 设置)
  *
- * @param {Object} opts
- * @param {'extract'|'summarize'} opts.task 任务类型
- * @param {string} opts.producePrompt - Produce 阶段 systemPrompt
- * @param {string[]} opts.analyzeCaps - Analyze 阶段 capabilities
- * @param {string[]} opts.produceCaps - Produce 阶段 capabilities
- * @param {Array} [opts.files] 源文件 (fallback prompt 用)
- * @param {number} [opts.analyzeMaxIter=24] - Analyze 最大迭代
- * @returns {Object[]} PipelineStrategy stages 数组
+ * @param opts.task 任务类型
+ * @param opts.producePrompt Produce 阶段 systemPrompt
+ * @param opts.analyzeCaps Analyze 阶段 capabilities
+ * @param opts.produceCaps Produce 阶段 capabilities
+ * @param [opts.files] 源文件 (fallback prompt 用)
+ * @param [opts.analyzeMaxIter=24] Analyze 最大迭代
+ * @returns PipelineStrategy stages 数组
  */
 export declare function buildScanPipelineStages({ task, producePrompt, analyzeCaps, produceCaps, files, analyzeMaxIter, }?: ScanPipelineOpts): Record<string, unknown>[];
 /**
@@ -110,10 +102,9 @@ export declare function buildScanPipelineStages({ task, producePrompt, analyzeCa
  *   - 2 阶段: explore (工具驱动) → synthesize (文本输出)
  *   - 无质量门控 (探索结果质量由工具返回保证)
  *
- * @param {Object} [opts]
- * @param {string[]} [opts.exploreCaps] - Explore 阶段 capabilities
- * @param {number} [opts.exploreMaxIter=20] - Explore 最大迭代
- * @returns {Object[]} PipelineStrategy stages 数组
+ * @param [opts.exploreCaps] Explore 阶段 capabilities
+ * @param [opts.exploreMaxIter=20] Explore 最大迭代
+ * @returns PipelineStrategy stages 数组
  */
 export declare function buildRelationsPipelineStages({ exploreCaps, exploreMaxIter, }?: {
     exploreCaps?: string[] | undefined;
@@ -142,4 +133,3 @@ export declare function buildRelationsPipelineStages({ exploreCaps, exploreMaxIt
     promptTransform: (_input: string, prev: Record<string, PhaseResult>) => string;
 })[];
 export default SCAN_TASK_CONFIGS;
-//# sourceMappingURL=scan-prompts.d.ts.map

package/dist/lib/{service/agent → agent}/domain/scan-prompts.js

@@ -15,19 +15,12 @@
 import { ANALYST_SYSTEM_PROMPT } from './insight-analyst.js';
 import { buildRetryPrompt, insightGateEvaluator } from './insight-gate.js';
 import { buildCodeContextSection, producerRejectionGateEvaluator } from './insight-producer.js';
-/**
- * @typedef {Object} ScanTaskConfig
- * @property {string} producePrompt - Produce 阶段的 systemPrompt
- * @property {(label: string) => Object} fallback 解析失败时的默认值工厂
- */
 /**
  * task → Produce 阶段配置 (extract + summarize)
  *
  * 两种 task 均为工具驱动 (collect_scan_recipe)，Recipe 格式与冷启动 submit_knowledge 对齐:
  * - extract: 多文件 target 扫描 → 多个 Recipe
  * - summarize: 单文件/代码片段 → 1~2 个 Recipe
- *
- * @type {Record<string, ScanTaskConfig>}
  */
 export const SCAN_TASK_CONFIGS = {
     // ─── extract: Recipe 提取（工具驱动，与冷启动 submit_knowledge 字段对齐） ─────
@@ -123,14 +116,13 @@ content.markdown 字段必须是「项目特写」：
  *   - strategyContext 需要包含 activeContext / outputType / dimId
  *     (由 AgentFactory.buildSystemContext 设置)
  *
- * @param {Object} opts
- * @param {'extract'|'summarize'} opts.task 任务类型
- * @param {string} opts.producePrompt - Produce 阶段 systemPrompt
- * @param {string[]} opts.analyzeCaps - Analyze 阶段 capabilities
- * @param {string[]} opts.produceCaps - Produce 阶段 capabilities
- * @param {Array} [opts.files] 源文件 (fallback prompt 用)
- * @param {number} [opts.analyzeMaxIter=24] - Analyze 最大迭代
- * @returns {Object[]} PipelineStrategy stages 数组
+ * @param opts.task 任务类型
+ * @param opts.producePrompt Produce 阶段 systemPrompt
+ * @param opts.analyzeCaps Analyze 阶段 capabilities
+ * @param opts.produceCaps Produce 阶段 capabilities
+ * @param [opts.files] 源文件 (fallback prompt 用)
+ * @param [opts.analyzeMaxIter=24] Analyze 最大迭代
+ * @returns PipelineStrategy stages 数组
  */
 export function buildScanPipelineStages({ task, producePrompt, analyzeCaps, produceCaps, files, analyzeMaxIter = 24, } = {}) {
     // ── Stage 1: Analyze ──
@@ -252,10 +244,9 @@ export function buildScanPipelineStages({ task, producePrompt, analyzeCaps, prod
  *   - 注入 negativeSignals (搜索但未找到的模式)
  *   - 当 artifact 不可用时 fallback 到 analyze.reply 纯文本
  *
- * @param {Object} ctx - promptBuilder 上下文 (含 gateArtifact, phaseResults, ...)
- * @param {Array} [files] 源文件 (fallback 用)
- * @param {'extract'|'summarize'} task 任务类型
- * @returns {string}
+ * @param ctx promptBuilder 上下文 (含 gateArtifact, phaseResults, ...)
+ * @param [files] 源文件 (fallback 用)
+ * @param task 任务类型
  */
 function buildScanProducerPrompt(ctx, files, task) {
     const artifact = ctx.gateArtifact;
@@ -374,10 +365,9 @@ const RELATIONS_SYNTHESIZE_PROMPT = `你是结构化数据专家。将知识图
  *   - 2 阶段: explore (工具驱动) → synthesize (文本输出)
  *   - 无质量门控 (探索结果质量由工具返回保证)
  *
- * @param {Object} [opts]
- * @param {string[]} [opts.exploreCaps] - Explore 阶段 capabilities
- * @param {number} [opts.exploreMaxIter=20] - Explore 最大迭代
- * @returns {Object[]} PipelineStrategy stages 数组
+ * @param [opts.exploreCaps] Explore 阶段 capabilities
+ * @param [opts.exploreMaxIter=20] Explore 最大迭代
+ * @returns PipelineStrategy stages 数组
  */
 export function buildRelationsPipelineStages({ exploreCaps = ['knowledge_production', 'code_analysis'], exploreMaxIter = 20, } = {}) {
     return [
@@ -410,4 +400,3 @@ export function buildRelationsPipelineStages({ exploreCaps = ['knowledge_product
     ];
 }
 export default SCAN_TASK_CONFIGS;
-//# sourceMappingURL=scan-prompts.js.map

package/dist/lib/{service/agent → agent}/forced-summary.d.ts

@@ -11,7 +11,7 @@
  *
  * @module forced-summary
  */
-import type { AiProvider } from '../../external/ai/AiProvider.js';
+import type { AiProvider } from '#external/ai/AiProvider.js';
 /** Known tool-call argument fields accessed in this module */
 interface ToolCallArgs {
     title?: string;
@@ -58,15 +58,14 @@ interface ForcedSummaryOpts {
 /**
  * 生成强制摘要
  *
- * @param {Object} opts
- * @param {import('../../external/ai/AiProvider.js').AiProvider} opts.aiProvider - LLM 提供商
- * @param {string} [opts.source] - 'user' | 'system'
- * @param {Array} opts.toolCalls 工具调用记录
- * @param {Object} [opts.tracker] - ExplorationTracker 实例
- * @param {Object} [opts.contextWindow] - ContextWindow 实例 (用于避免超出 token)
- * @param {string} opts.prompt 原始用户 prompt
- * @param {Object} [opts.tokenUsage] - token 用量 (会被修改)
- * @returns {Promise<{ reply: string, tokenUsage: { input: number, output: number } }>}
+ * @param opts.aiProvider LLM 提供商
+ * @param [opts.source] 'user' | 'system'
+ * @param opts.toolCalls 工具调用记录
+ * @param [opts.tracker] ExplorationTracker 实例
+ * @param [opts.contextWindow] ContextWindow 实例 (用于避免超出 token)
+ * @param opts.prompt 原始用户 prompt
+ * @param [opts.tokenUsage] token 用量 (会被修改)
+ * @returns }>}
  */
 export declare function produceForcedSummary({ aiProvider, source, toolCalls, tracker, contextWindow, prompt, tokenUsage, }: ForcedSummaryOpts): Promise<{
     reply: string;
@@ -76,4 +75,3 @@ export declare function produceForcedSummary({ aiProvider, source, toolCalls, tr
     };
 }>;
 export default produceForcedSummary;
-//# sourceMappingURL=forced-summary.d.ts.map