autosnippet 3.2.16 → 3.2.18

package/dist/lib/{service/agent → agent}/memory/SessionStore.d.ts

@@ -114,93 +114,41 @@ interface ToolArgs {
 }
 export declare class SessionStore {
     #private;
-    /**
-     * @param {SessionStoreConfig} [config]
-     */
     constructor(config?: SessionStoreConfig);
-    /**
-     * 维度完成后存储完整报告
-     * @param {string} dimId
-     * @param {object} report
-     */
+    /** 维度完成后存储完整报告 */
     storeDimensionReport(dimId: string, report: DimensionReportInput): void;
-    /**
-     * @param {string} dimId
-     * @returns {DimensionReport|undefined}
-     */
     getDimensionReport(dimId: string): DimensionReport | undefined;
-    /**
-     * @returns {string[]}
-     */
     getCompletedDimensions(): string[];
-    /**
-     * @param {string} filePath
-     * @param {object} evidence
-     */
     addEvidence(filePath: string, evidence: Omit<Finding, 'timestamp'>): void;
-    /**
-     * @param {string} filePath
-     * @returns {Finding[]}
-     */
     getEvidenceForFile(filePath: string): Finding[];
-    /**
-     * @param {string} query
-     * @param {string} [dimId]
-     * @returns {Array<{filePath: string, evidence: object}>}
-     */
+    /** @returns >} */
     searchEvidence(query: string, dimId?: string): {
         filePath: string;
         evidence: Finding;
     }[];
-    /**
-     * @param {string} dimId
-     * @param {CandidateSummary} candidate
-     */
     addSubmittedCandidate(dimId: string, candidate: Omit<CandidateSummary, 'dimId'>): void;
-    /**
-     * @param {string} dimId
-     * @param {object} digest
-     */
     addDimensionDigest(dimId: string, digest: DimensionDigest): void;
-    /**
-     * @param {number} tierIndex
-     * @param {TierReflection} reflection
-     */
     addTierReflection(tierIndex: number, reflection: TierReflection): void;
-    /**
-     * 获取所有 TierReflection (F17: EpisodicConsolidator 需要)
-     * @returns {TierReflection[]}
-     */
+    /** 获取所有 TierReflection (F17: EpisodicConsolidator 需要) */
     getTierReflections(): TierReflection[];
-    /**
-     * @param {string} currentDimId
-     * @returns {string|null}
-     */
     getRelevantReflections(currentDimId: string): string | null;
     /**
      * 构建给 Analyst 的跨维度上下文
      *
-     * @param {string} currentDimId
-     * @param {string[]|object} [focusKeywordsOrOpts] 关键词数组或 options 对象
-     * @returns {string}
+     * @param [focusKeywordsOrOpts] 关键词数组或 options 对象
      */
     buildContextForDimension(currentDimId: string, focusKeywordsOrOpts?: string[] | {
         focusKeywords?: string[];
         tokenBudget?: number;
     }): string;
-    /**
-     * 兼容 DimensionContext.buildContextForDimension 返回格式
-     * @param {string} currentDimId
-     * @returns {object}
-     */
+    /** 兼容 DimensionContext.buildContextForDimension 返回格式 */
     buildContextSnapshot(currentDimId: string): {
         previousDimensions: Record<string, DimensionDigest>;
         submittedCandidates: CandidateSummary[];
     };
     /**
      * 获取维度的蒸馏上下文 (供 Producer 使用)
-     * @param {string} dimId
-     * @returns {{ keyFindings: Array, toolCallSummary: Array, referencedFiles: string[] }|null}
+     * @returns |null}
      */
     getDistilledForProducer(dimId: string): {
         keyFindings: Finding[];
@@ -210,42 +158,15 @@ export declare class SessionStore {
         })[];
         referencedFiles: string[];
     } | null;
-    /**
-     * 获取缓存的工具结果
-     * @param {string} toolName
-     * @param {object} args
-     * @returns {*|null}
-     */
+    /** 获取缓存的工具结果 */
     getCachedResult(toolName: string, args: ToolArgs): unknown | null;
-    /**
-     * 缓存工具结果 (自动排除副作用工具)
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     */
+    /** 缓存工具结果 (自动排除副作用工具) */
     cacheToolResult(toolName: string, args: ToolArgs, result: unknown): void;
-    /**
-     * 兼容 ToolResultCache.get()
-     * @param {string} toolName
-     * @param {object} args
-     * @returns {*|null}
-     */
+    /** 兼容 ToolResultCache.get() */
     get(toolName: string, args: ToolArgs): unknown | null;
-    /**
-     * 兼容 ToolResultCache.set()
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     */
+    /** 兼容 ToolResultCache.set() */
     set(toolName: string, args: ToolArgs, result: unknown): void;
-    /**
-     * @param {string} projectRoot
-     */
     saveCheckpoint(projectRoot: string): Promise<void>;
-    /**
-     * @param {string} projectRoot
-     * @returns {Promise<boolean>}
-     */
     loadCheckpoint(projectRoot: string): Promise<boolean>;
     toJSON(): {
         dimensionReports: {
@@ -259,15 +180,9 @@ export declare class SessionStore {
         projectContext: Record<string, unknown>;
     };
     static fromJSON(json: Record<string, unknown>): SessionStore;
-    /**
-     * 获取所有已引用文件 (去重, F10)
-     * @returns {Set<string>}
-     */
+    /** 获取所有已引用文件 (去重, F10) */
     getAllReferencedFiles(): Set<string>;
-    /**
-     * 获取统计数据 (合并维度 + 缓存统计, F12)
-     * @returns {object}
-     */
+    /** 获取统计数据 (合并维度 + 缓存统计, F12) */
     getStats(): {
         completedDimensions: number;
         totalFindings: number;
@@ -285,14 +200,9 @@ export declare class SessionStore {
             evictions: number;
         };
     };
-    /**
-     * 清空所有缓存
-     */
+    /** 清空所有缓存 */
     clearCache(): void;
-    /**
-     * 销毁实例，释放定时器
-     */
+    /** 销毁实例，释放定时器 */
     dispose(): void;
 }
 export default SessionStore;
-//# sourceMappingURL=SessionStore.d.ts.map

package/dist/lib/{service/agent → agent}/memory/SessionStore.js

@@ -42,34 +42,22 @@ const DEFAULT_TTL_MS = CACHE.DEFAULT_TTL_MS;
 // ═══════════════════════════════════════════════════════════
 export class SessionStore {
     // ── 子系统 1: DimensionReports (from EpisodicMemory) ──
-    /** @type {Map<string, DimensionReport>} */
     #dimensionReports = new Map();
     /** @type {Map<string, Finding[]>} filePath → Evidence[] */
     #evidenceStore = new Map();
-    /** @type {CrossReference[]} */
     #crossReferences = [];
-    /** @type {TierReflection[]} */
     #tierReflections = [];
     /** @type {Map<string, CandidateSummary[]>} dimId → candidates */
     #submittedCandidates = new Map();
-    /** @type {Record<string, unknown>} */
     #projectContext;
     // ── 子系统 2: ReadOnlyCache (from ToolResultCache) ──
-    /** @type {Map<string, SearchCacheEntry>} */
     #searchCache = new Map();
-    /** @type {Map<string, FileCacheEntry>} */
     #fileCache = new Map();
     /** @type {{hits: number, misses: number, evictions: number}} */
     #cacheStats = { hits: 0, misses: 0, evictions: 0 };
-    /** @type {number} */
     #ttlMs;
-    /** @type {ReturnType<typeof setInterval>|null} */
     #cleanupTimer = null;
-    /** @type {import('winston').Logger} */
     #logger;
-    /**
-     * @param {SessionStoreConfig} [config]
-     */
     constructor(config = {}) {
         this.#projectContext = config.projectContext || {};
         this.#ttlMs = config.ttlMs ?? DEFAULT_TTL_MS;
@@ -86,11 +74,7 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §1: 维度报告 (from EpisodicMemory)
     // ═══════════════════════════════════════════════════════
-    /**
-     * 维度完成后存储完整报告
-     * @param {string} dimId
-     * @param {object} report
-     */
+    /** 维度完成后存储完整报告 */
     storeDimensionReport(dimId, report) {
         // findings 统一形状: { finding: string, evidence: string, importance: number }
         // P0 Fix: evidence 可能是 array/object，强制 string
@@ -144,26 +128,15 @@ export class SessionStore {
             `${report.findings?.length || 0} findings, ` +
             `${report.referencedFiles?.length || 0} files`);
     }
-    /**
-     * @param {string} dimId
-     * @returns {DimensionReport|undefined}
-     */
     getDimensionReport(dimId) {
         return this.#dimensionReports.get(dimId);
     }
-    /**
-     * @returns {string[]}
-     */
     getCompletedDimensions() {
         return [...this.#dimensionReports.keys()];
     }
     // ═══════════════════════════════════════════════════════
     // §2: Evidence Store
     // ═══════════════════════════════════════════════════════
-    /**
-     * @param {string} filePath
-     * @param {object} evidence
-     */
     addEvidence(filePath, evidence) {
         if (!this.#evidenceStore.has(filePath)) {
             this.#evidenceStore.set(filePath, []);
@@ -173,18 +146,10 @@ export class SessionStore {
             timestamp: Date.now(),
         });
     }
-    /**
-     * @param {string} filePath
-     * @returns {Finding[]}
-     */
     getEvidenceForFile(filePath) {
         return this.#evidenceStore.get(filePath) || [];
     }
-    /**
-     * @param {string} query
-     * @param {string} [dimId]
-     * @returns {Array<{filePath: string, evidence: object}>}
-     */
+    /** @returns >} */
     searchEvidence(query, dimId) {
         const results = [];
         const lowerQuery = query.toLowerCase();
@@ -205,10 +170,6 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §3: 已提交候选
     // ═══════════════════════════════════════════════════════
-    /**
-     * @param {string} dimId
-     * @param {CandidateSummary} candidate
-     */
     addSubmittedCandidate(dimId, candidate) {
         if (!this.#submittedCandidates.has(dimId)) {
             this.#submittedCandidates.set(dimId, []);
@@ -223,10 +184,6 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §4: DimensionDigest 兼容层
     // ═══════════════════════════════════════════════════════
-    /**
-     * @param {string} dimId
-     * @param {object} digest
-     */
     addDimensionDigest(dimId, digest) {
         const existing = this.#dimensionReports.get(dimId);
         if (existing) {
@@ -268,27 +225,16 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §5: Tier Reflection
     // ═══════════════════════════════════════════════════════
-    /**
-     * @param {number} tierIndex
-     * @param {TierReflection} reflection
-     */
     addTierReflection(tierIndex, reflection) {
         this.#tierReflections.push(reflection);
         this.#logger.info(`[SessionStore] Tier ${tierIndex + 1} reflection: ` +
             `${reflection.topFindings?.length || 0} top findings, ` +
             `${reflection.crossDimensionPatterns?.length || 0} patterns`);
     }
-    /**
-     * 获取所有 TierReflection (F17: EpisodicConsolidator 需要)
-     * @returns {TierReflection[]}
-     */
+    /** 获取所有 TierReflection (F17: EpisodicConsolidator 需要) */
     getTierReflections() {
         return [...this.#tierReflections];
     }
-    /**
-     * @param {string} currentDimId
-     * @returns {string|null}
-     */
     getRelevantReflections(currentDimId) {
         if (this.#tierReflections.length === 0) {
             return null;
@@ -323,9 +269,7 @@ export class SessionStore {
     /**
      * 构建给 Analyst 的跨维度上下文
      *
-     * @param {string} currentDimId
-     * @param {string[]|object} [focusKeywordsOrOpts] 关键词数组或 options 对象
-     * @returns {string}
+     * @param [focusKeywordsOrOpts] 关键词数组或 options 对象
      */
     buildContextForDimension(currentDimId, focusKeywordsOrOpts = []) {
         // 兼容两种调用方式: (dimId, keywords[]) 或 (dimId, { focusKeywords, tokenBudget })
@@ -412,11 +356,7 @@ export class SessionStore {
         }
         return result;
     }
-    /**
-     * 兼容 DimensionContext.buildContextForDimension 返回格式
-     * @param {string} currentDimId
-     * @returns {object}
-     */
+    /** 兼容 DimensionContext.buildContextForDimension 返回格式 */
     buildContextSnapshot(currentDimId) {
         const previousDimensions = {};
         for (const [dimId, report] of this.#dimensionReports) {
@@ -442,8 +382,7 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     /**
      * 获取维度的蒸馏上下文 (供 Producer 使用)
-     * @param {string} dimId
-     * @returns {{ keyFindings: Array, toolCallSummary: Array, referencedFiles: string[] }|null}
+     * @returns |null}
      */
     getDistilledForProducer(dimId) {
         const report = this.#dimensionReports.get(dimId);
@@ -459,12 +398,7 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §8: 只读缓存 (from ToolResultCache, B3 fix)
     // ═══════════════════════════════════════════════════════
-    /**
-     * 获取缓存的工具结果
-     * @param {string} toolName
-     * @param {object} args
-     * @returns {*|null}
-     */
+    /** 获取缓存的工具结果 */
     getCachedResult(toolName, args) {
         if (NON_CACHEABLE.has(toolName)) {
             return null;
@@ -506,12 +440,7 @@ export class SessionStore {
         this.#cacheStats.misses++;
         return null;
     }
-    /**
-     * 缓存工具结果 (自动排除副作用工具)
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     */
+    /** 缓存工具结果 (自动排除副作用工具) */
     cacheToolResult(toolName, args, result) {
         if (NON_CACHEABLE.has(toolName)) {
             return;
@@ -548,30 +477,17 @@ export class SessionStore {
             }
         }
     }
-    /**
-     * 兼容 ToolResultCache.get()
-     * @param {string} toolName
-     * @param {object} args
-     * @returns {*|null}
-     */
+    /** 兼容 ToolResultCache.get() */
     get(toolName, args) {
         return this.getCachedResult(toolName, args);
     }
-    /**
-     * 兼容 ToolResultCache.set()
-     * @param {string} toolName
-     * @param {object} args
-     * @param {*} result
-     */
+    /** 兼容 ToolResultCache.set() */
     set(toolName, args, result) {
         this.cacheToolResult(toolName, args, result);
     }
     // ═══════════════════════════════════════════════════════
     // §9: 持久化 (断点续传)
     // ═══════════════════════════════════════════════════════
-    /**
-     * @param {string} projectRoot
-     */
     async saveCheckpoint(projectRoot) {
         const checkpointDir = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint');
         try {
@@ -598,10 +514,6 @@ export class SessionStore {
             this.#logger.warn(`[SessionStore] Failed to save checkpoint: ${err.message}`);
         }
     }
-    /**
-     * @param {string} projectRoot
-     * @returns {Promise<boolean>}
-     */
     async loadCheckpoint(projectRoot) {
         // Try new format first, then legacy
         const newPath = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint', 'session-store.json');
@@ -682,10 +594,7 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §11: 统计 + 查询
     // ═══════════════════════════════════════════════════════
-    /**
-     * 获取所有已引用文件 (去重, F10)
-     * @returns {Set<string>}
-     */
+    /** 获取所有已引用文件 (去重, F10) */
     getAllReferencedFiles() {
         const files = new Set();
         for (const report of this.#dimensionReports.values()) {
@@ -695,10 +604,7 @@ export class SessionStore {
         }
         return files;
     }
-    /**
-     * 获取统计数据 (合并维度 + 缓存统计, F12)
-     * @returns {object}
-     */
+    /** 获取统计数据 (合并维度 + 缓存统计, F12) */
     getStats() {
         const totalFindings = [...this.#dimensionReports.values()].reduce((sum, r) => sum + r.findings.length, 0);
         const totalEvidence = [...this.#evidenceStore.values()].reduce((sum, arr) => sum + arr.length, 0);
@@ -723,17 +629,13 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // §12: 清理
     // ═══════════════════════════════════════════════════════
-    /**
-     * 清空所有缓存
-     */
+    /** 清空所有缓存 */
     clearCache() {
         this.#searchCache.clear();
         this.#fileCache.clear();
         this.#cacheStats = { hits: 0, misses: 0, evictions: 0 };
     }
-    /**
-     * 销毁实例，释放定时器
-     */
+    /** 销毁实例，释放定时器 */
     dispose() {
         this.clearCache();
         this.#dimensionReports.clear();
@@ -749,9 +651,7 @@ export class SessionStore {
     // ═══════════════════════════════════════════════════════
     // 私有方法
     // ═══════════════════════════════════════════════════════
-    /**
-     * 从 findings 中选择与当前焦点最相关的
-     */
+    /** 从 findings 中选择与当前焦点最相关的 */
     #selectRelevantFindings(findings, focusKeywords, limit) {
         if (!findings || findings.length === 0) {
             return [];
@@ -772,9 +672,7 @@ export class SessionStore {
             .slice(0, limit)
             .map(({ _score, ...rest }) => rest);
     }
-    /**
-     * 清理过期缓存条目 (F13)
-     */
+    /** 清理过期缓存条目 (F13) */
     #evictExpired() {
         if (this.#ttlMs <= 0) {
             return;
@@ -800,4 +698,3 @@ export class SessionStore {
     }
 }
 export default SessionStore;
-//# sourceMappingURL=SessionStore.js.map

package/dist/lib/{service/agent → agent}/memory/index.d.ts

@@ -14,4 +14,3 @@ export { MemoryRetriever } from './MemoryRetriever.js';
 export { MemoryStore } from './MemoryStore.js';
 export { PersistentMemory } from './PersistentMemory.js';
 export { SessionStore } from './SessionStore.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/{service/agent → agent}/memory/index.js

@@ -15,4 +15,3 @@ export { MemoryRetriever } from './MemoryRetriever.js';
 export { MemoryStore } from './MemoryStore.js';
 export { PersistentMemory } from './PersistentMemory.js';
 export { SessionStore } from './SessionStore.js';
-//# sourceMappingURL=index.js.map

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

@@ -53,9 +53,7 @@ export interface QualityGatePolicyOptions {
         reason?: string;
     };
 }
-/**
- * Policy 基类 — 所有约束的抽象接口
- */
+/** Policy 基类 — 所有约束的抽象接口 */
 export declare class Policy {
     /** @type {string} 策略名称 */
     get name(): string;
@@ -89,13 +87,6 @@ export declare class Policy {
  */
 export declare class BudgetPolicy extends Policy {
     #private;
-    /**
-     * @param {Object} [opts]
-     * @param {number} [opts.maxIterations=20]
-     * @param {number} [opts.maxTokens=4096]
-     * @param {number} [opts.timeoutMs=300000]
-     * @param {number} [opts.temperature=0.7]
-     */
     constructor({ maxIterations, maxTokens, timeoutMs, temperature, }?: {
         maxIterations?: number | undefined;
         maxTokens?: number | undefined;
@@ -140,11 +131,10 @@ export declare class SafetyPolicy extends Policy {
     /** 安全命令前缀白名单 */
     static SAFE_COMMANDS: readonly string[];
     /**
-     * @param {Object} [opts]
-     * @param {string} [opts.fileScope] 文件操作范围 (目录路径)
-     * @param {string[]} [opts.allowedSenders] 允许的发送者 ID (空=不限制)
-     * @param {RegExp[]} [opts.commandBlacklist] 额外命令黑名单
-     * @param {string[]} [opts.requireApprovalFor] 需要人工确认的工具名
+     * @param [opts.fileScope] 文件操作范围 (目录路径)
+     * @param [opts.allowedSenders] 允许的发送者 ID (空=不限制)
+     * @param [opts.commandBlacklist] 额外命令黑名单
+     * @param [opts.requireApprovalFor] 需要人工确认的工具名
      */
     constructor({ fileScope, allowedSenders, commandBlacklist, requireApprovalFor, }?: SafetyPolicyOptions);
     get name(): string;
@@ -157,8 +147,7 @@ export declare class SafetyPolicy extends Policy {
     };
     /**
      * 检查命令是否安全
-     * @param {string} command
-     * @returns {{ safe: boolean, reason?: string }}
+     * @returns }
      */
     checkCommand(command: string): {
         safe: boolean;
@@ -169,8 +158,7 @@ export declare class SafetyPolicy extends Policy {
     };
     /**
      * 检查文件路径是否在允许范围内
-     * @param {string} filePath
-     * @returns {{ safe: boolean, reason?: string }}
+     * @returns }
      */
     checkFilePath(filePath: string): {
         safe: boolean;
@@ -179,10 +167,7 @@ export declare class SafetyPolicy extends Policy {
         safe: boolean;
         reason: string;
     };
-    /**
-     * 是否需要人工确认
-     * @param {string} toolName
-     */
+    /** 是否需要人工确认 */
     needsApproval(toolName: string): boolean;
     applyToConfig(config: Record<string, unknown>): Record<string, unknown>;
 }
@@ -195,11 +180,10 @@ export declare class SafetyPolicy extends Policy {
 export declare class QualityGatePolicy extends Policy {
     #private;
     /**
-     * @param {Object} [opts]
-     * @param {number} [opts.minEvidenceLength=500] 分析文本最小长度
-     * @param {number} [opts.minFileRefs=3] 最少文件引用数
-     * @param {number} [opts.minToolCalls=2] 最少工具调用数
-     * @param {Function} [opts.customValidator] 自定义校验 (result) => { ok, reason }
+     * @param [opts.minEvidenceLength=500] 分析文本最小长度
+     * @param [opts.minFileRefs=3] 最少文件引用数
+     * @param [opts.minToolCalls=2] 最少工具调用数
+     * @param [opts.customValidator] 自定义校验 (result) => { ok, reason }
      */
     constructor({ minEvidenceLength, minFileRefs, minToolCalls, customValidator, }?: QualityGatePolicyOptions);
     get name(): string;
@@ -238,8 +222,6 @@ export declare class PolicyEngine {
     /**
      * 获取特定类型的 Policy
      * @template T
-     * @param {new (...args: unknown[]) => T} PolicyClass
-     * @returns {T|null}
      */
     get<T extends Policy>(PolicyClass: abstract new (...args: never[]) => T): T | null;
     validateBefore(context: PolicyContext): {
@@ -256,9 +238,7 @@ export declare class PolicyEngine {
         reason?: string;
     };
     applyToConfig(config: Record<string, unknown>): Record<string, unknown>;
-    /**
-     * 获取合并后的 Budget (从 BudgetPolicy)
-     */
+    /** 获取合并后的 Budget (从 BudgetPolicy) */
     getBudget(): {
         maxIterations: number;
         maxTokens: number;
@@ -271,9 +251,9 @@ export declare class PolicyEngine {
      * 对有副作用的工具 (run_safe_command, write_project_file) 执行安全检查。
      * 委托给 SafetyPolicy，如果没有加载 SafetyPolicy 则放行。
      *
-     * @param {string} toolName 工具名称
-     * @param {Object} args 工具参数
-     * @returns {{ ok: boolean, reason?: string }}
+     * @param toolName 工具名称
+     * @param args 工具参数
+     * @returns }
      */
     validateToolCall(toolName: string, args: Record<string, unknown>): {
         ok: boolean;
@@ -291,4 +271,3 @@ declare const _default: {
     PolicyEngine: typeof PolicyEngine;
 };
 export default _default;
-//# sourceMappingURL=policies.d.ts.map