autosnippet 3.2.16 → 3.2.17

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.d.ts

@@ -90,63 +90,44 @@ interface AffectedDimensionResult {
 }
 export declare class BootstrapSnapshot {
     #private;
-    /**
-     * @param {import('better-sqlite3').Database} db - better-sqlite3 实例
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
+    /** @param db better-sqlite3 实例 */
     constructor(db: unknown, { logger }?: {
         logger?: LoggerLike | null;
     });
     /**
      * 保存一次 bootstrap 完成后的快照
      *
-     * @param {object} params
-     * @param {string} params.sessionId     - Bootstrap 会话 ID
-     * @param {string} params.projectRoot   项目根目录
+     * @param params.sessionId Bootstrap 会话 ID
+     * @param params.projectRoot 项目根目录
      * @param {Array<{path: string, relativePath: string}>} params.allFiles 扫描到的文件列表
-     * @param {object} params.dimensionStats - { dimId: { referencedFiles: string[] } }
-     * @param {object} [params.episodicData] - EpisodicMemory.toJSON()
-     * @param {object} [params.meta]         - { durationMs, candidateCount, primaryLang }
-     * @param {boolean} [params.isIncremental] 是否增量 bootstrap
-     * @param {string} [params.parentId]     增量时的父快照 ID
-     * @param {string[]} [params.changedFiles] 增量时的变更文件
-     * @param {string[]} [params.affectedDims] 增量时受影响的维度
-     * @returns {string} 快照 ID
+     * @param params.dimensionStats { dimId: { referencedFiles: string[] } }
+     * @param [params.episodicData] EpisodicMemory.toJSON()
+     * @param [params.meta] { durationMs, candidateCount, primaryLang }
+     * @param [params.isIncremental] 是否增量 bootstrap
+     * @param [params.parentId] 增量时的父快照 ID
+     * @param [params.changedFiles] 增量时的变更文件
+     * @param [params.affectedDims] 增量时受影响的维度
+     * @returns 快照 ID
      */
     save(params: SaveParams): string;
-    /**
-     * 清除项目的所有快照 — 用于手动重新冷启动时强制全量
-     * @param {string} projectRoot
-     */
+    /** 清除项目的所有快照 — 用于手动重新冷启动时强制全量 */
     clearProject(projectRoot: string): void;
     /**
      * 加载最新的快照
      *
-     * @param {string} projectRoot
-     * @returns {object|null} 快照数据
+     * @returns 快照数据
      */
     getLatest(projectRoot: string): SnapshotData | null;
-    /**
-     * 根据 ID 加载快照
-     * @param {string} id
-     * @returns {object|null}
-     */
+    /** 根据 ID 加载快照 */
     getById(id: string): SnapshotData | null;
-    /**
-     * 获取项目的所有快照 (按时间降序)
-     * @param {string} projectRoot
-     * @param {number} [limit=10]
-     * @returns {Array<object>}
-     */
+    /** 获取项目的所有快照 (按时间降序) */
     list(projectRoot: string, limit?: number): SnapshotData[];
     /**
      * 计算当前文件与快照的 diff
      *
-     * @param {object} snapshot - getLatest() 返回的快照
+     * @param snapshot getLatest() 返回的快照
      * @param {Array<{path: string, relativePath: string, content: string}>} currentFiles 当前文件列表
-     * @param {string} projectRoot
-     * @returns {{ added: string[], modified: string[], deleted: string[], unchanged: string[], changeRatio: number }}
+     * @returns }
      */
     computeDiff(snapshot: SnapshotData, currentFiles: SnapshotFile[], projectRoot: string): DiffResult;
     /**
@@ -157,12 +138,11 @@ export declare class BootstrapSnapshot {
      * 2. 新增文件按文件类型推断可能相关的维度
      * 3. 如果变更比例超过阈值 → 建议全量
      *
-     * @param {object} snapshot 上次快照
+     * @param snapshot 上次快照
      * @param {{ added: string[], modified: string[], deleted: string[] }} diff
-     * @param {string[]} allDimIds 所有可用维度 ID
-     * @returns {{ mode: 'incremental'|'full', dimensions: string[], skippedDimensions: string[], reason: string }}
+     * @param allDimIds 所有可用维度 ID
+     * @returns }
      */
     inferAffectedDimensions(snapshot: SnapshotData, diff: DiffResult, allDimIds: string[]): AffectedDimensionResult;
 }
 export default BootstrapSnapshot;
-//# sourceMappingURL=BootstrapSnapshot.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/BootstrapSnapshot.js

@@ -25,17 +25,10 @@ const FULL_REBUILD_THRESHOLD = 0.5;
 // BootstrapSnapshot 类
 // ──────────────────────────────────────────────────────────────
 export class BootstrapSnapshot {
-    /** @type {import('better-sqlite3').Database} */
     #db;
-    /** @type {object|null} */
     #logger;
-    /** @type {object} */
     #stmts;
-    /**
-     * @param {import('better-sqlite3').Database} db - better-sqlite3 实例
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
+    /** @param db better-sqlite3 实例 */
     constructor(db, { logger } = {}) {
         if (!db) {
             throw new Error('BootstrapSnapshot requires a database instance');
@@ -52,18 +45,17 @@ export class BootstrapSnapshot {
     /**
      * 保存一次 bootstrap 完成后的快照
      *
-     * @param {object} params
-     * @param {string} params.sessionId     - Bootstrap 会话 ID
-     * @param {string} params.projectRoot   项目根目录
+     * @param params.sessionId Bootstrap 会话 ID
+     * @param params.projectRoot 项目根目录
      * @param {Array<{path: string, relativePath: string}>} params.allFiles 扫描到的文件列表
-     * @param {object} params.dimensionStats - { dimId: { referencedFiles: string[] } }
-     * @param {object} [params.episodicData] - EpisodicMemory.toJSON()
-     * @param {object} [params.meta]         - { durationMs, candidateCount, primaryLang }
-     * @param {boolean} [params.isIncremental] 是否增量 bootstrap
-     * @param {string} [params.parentId]     增量时的父快照 ID
-     * @param {string[]} [params.changedFiles] 增量时的变更文件
-     * @param {string[]} [params.affectedDims] 增量时受影响的维度
-     * @returns {string} 快照 ID
+     * @param params.dimensionStats { dimId: { referencedFiles: string[] } }
+     * @param [params.episodicData] EpisodicMemory.toJSON()
+     * @param [params.meta] { durationMs, candidateCount, primaryLang }
+     * @param [params.isIncremental] 是否增量 bootstrap
+     * @param [params.parentId] 增量时的父快照 ID
+     * @param [params.changedFiles] 增量时的变更文件
+     * @param [params.affectedDims] 增量时受影响的维度
+     * @returns 快照 ID
      */
     save(params) {
         const { sessionId, projectRoot, allFiles, dimensionStats, episodicData, meta = {}, isIncremental = false, parentId = null, changedFiles = [], affectedDims = [], } = params;
@@ -132,10 +124,7 @@ export class BootstrapSnapshot {
         return id;
     }
     // ─── 快照加载 ─────────────────────────────────────────
-    /**
-     * 清除项目的所有快照 — 用于手动重新冷启动时强制全量
-     * @param {string} projectRoot
-     */
+    /** 清除项目的所有快照 — 用于手动重新冷启动时强制全量 */
     clearProject(projectRoot) {
         try {
             const rows = this.#stmts.listByProject.all(projectRoot, 9999);
@@ -152,8 +141,7 @@ export class BootstrapSnapshot {
     /**
      * 加载最新的快照
      *
-     * @param {string} projectRoot
-     * @returns {object|null} 快照数据
+     * @returns 快照数据
      */
     getLatest(projectRoot) {
         const row = this.#stmts.getLatest.get(projectRoot);
@@ -162,11 +150,7 @@ export class BootstrapSnapshot {
         }
         return this.#deserialize(row);
     }
-    /**
-     * 根据 ID 加载快照
-     * @param {string} id
-     * @returns {object|null}
-     */
+    /** 根据 ID 加载快照 */
     getById(id) {
         const row = this.#stmts.getById.get(id);
         if (!row) {
@@ -174,12 +158,7 @@ export class BootstrapSnapshot {
         }
         return this.#deserialize(row);
     }
-    /**
-     * 获取项目的所有快照 (按时间降序)
-     * @param {string} projectRoot
-     * @param {number} [limit=10]
-     * @returns {Array<object>}
-     */
+    /** 获取项目的所有快照 (按时间降序) */
     list(projectRoot, limit = 10) {
         return this.#stmts.listByProject
             .all(projectRoot, limit)
@@ -189,10 +168,9 @@ export class BootstrapSnapshot {
     /**
      * 计算当前文件与快照的 diff
      *
-     * @param {object} snapshot - getLatest() 返回的快照
+     * @param snapshot getLatest() 返回的快照
      * @param {Array<{path: string, relativePath: string, content: string}>} currentFiles 当前文件列表
-     * @param {string} projectRoot
-     * @returns {{ added: string[], modified: string[], deleted: string[], unchanged: string[], changeRatio: number }}
+     * @returns }
      */
     computeDiff(snapshot, currentFiles, projectRoot) {
         const oldHashes = snapshot.fileHashes || {};
@@ -233,10 +211,10 @@ export class BootstrapSnapshot {
      * 2. 新增文件按文件类型推断可能相关的维度
      * 3. 如果变更比例超过阈值 → 建议全量
      *
-     * @param {object} snapshot 上次快照
+     * @param snapshot 上次快照
      * @param {{ added: string[], modified: string[], deleted: string[] }} diff
-     * @param {string[]} allDimIds 所有可用维度 ID
-     * @returns {{ mode: 'incremental'|'full', dimensions: string[], skippedDimensions: string[], reason: string }}
+     * @param allDimIds 所有可用维度 ID
+     * @returns }
      */
     inferAffectedDimensions(snapshot, diff, allDimIds) {
         const changeRatio = (diff.added.length + diff.modified.length + diff.deleted.length) /
@@ -297,11 +275,7 @@ export class BootstrapSnapshot {
         };
     }
     // ─── 维度-文件映射查询 ──────────────────────────────
-    /**
-     * 获取某个快照中每个维度引用的文件集合
-     * @param {string} snapshotId
-     * @returns {Object<string, Set<string>>}
-     */
+    /** 获取某个快照中每个维度引用的文件集合 */
     #getDimFileMap(snapshotId) {
         const rows = this.#stmts.getDimFiles.all(snapshotId);
         const map = {};
@@ -313,11 +287,7 @@ export class BootstrapSnapshot {
         }
         return map;
     }
-    /**
-     * 根据文件扩展名推断可能相关的维度
-     * @param {string} filePath
-     * @returns {string[]}
-     */
+    /** 根据文件扩展名推断可能相关的维度 */
     #inferDimsByFileType(filePath) {
         const ext = filePath.split('.').pop()?.toLowerCase() || '';
         const name = filePath.split('/').pop()?.toLowerCase() || '';
@@ -532,4 +502,3 @@ export class BootstrapSnapshot {
     }
 }
 export default BootstrapSnapshot;
-//# sourceMappingURL=BootstrapSnapshot.js.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.d.ts

@@ -14,17 +14,11 @@
  *
  * @module pipeline/IncrementalBootstrap
  */
-import { SessionStore } from '#service/agent/memory/SessionStore.js';
+import { SessionStore } from '#agent/memory/SessionStore.js';
 import type { BootstrapFile, LoggerLike, SaveSnapshotParams } from '../../types.js';
 import { BootstrapSnapshot } from './BootstrapSnapshot.js';
 export declare class IncrementalBootstrap {
     #private;
-    /**
-     * @param {import('better-sqlite3').Database} db
-     * @param {string} projectRoot
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
     constructor(db: unknown, projectRoot: string, { logger }?: {
         logger?: LoggerLike | null;
     });
@@ -32,18 +26,7 @@ export declare class IncrementalBootstrap {
      * 评估增量可行性 — 在 bootstrap 流程最开始调用
      *
      * @param {Array<{path: string, relativePath: string, content: string}>} currentFiles 当前扫描到的文件
-     * @param {string[]} allDimIds 所有可用维度 ID
-     * @returns {IncrementalPlan}
-     *
-     * @typedef {object} IncrementalPlan
-     * @property {boolean} canIncremental 是否支持增量
-     * @property {'incremental'|'full'} mode
-     * @property {string[]} affectedDimensions 需要重新分析的维度
-     * @property {string[]} skippedDimensions 可跳过的维度 (使用历史结果)
-     * @property {object|null} previousSnapshot 上次快照
-     * @property {object|null} diff - { added, modified, deleted, unchanged, changeRatio }
-     * @property {string} reason 人类可读的决策原因
-     * @property {object|null} restoredEpisodic 从快照恢复的 EpisodicMemory (仅增量时)
+     * @param allDimIds 所有可用维度 ID
      */
     evaluate(currentFiles: BootstrapFile[], allDimIds: string[]): {
         canIncremental: boolean;
@@ -67,21 +50,12 @@ export declare class IncrementalBootstrap {
     /**
      * 保存快照 — 在 bootstrap 完成后调用
      *
-     * @param {object} params
-     * @param {string} params.sessionId
-     * @param {Array} params.allFiles
-     * @param {object} params.dimensionStats
-     * @param {SessionStore} [params.episodicMemory]
-     * @param {object} [params.meta] - { durationMs, candidateCount, primaryLang }
-     * @param {IncrementalPlan} [params.plan] - evaluate() 返回的计划 (增量时)
-     * @returns {string} 快照 ID
+     * @param [params.meta] { durationMs, candidateCount, primaryLang }
+     * @param [params.plan] evaluate() 返回的计划 (增量时)
+     * @returns 快照 ID
      */
     saveSnapshot(params: SaveSnapshotParams): string;
-    /**
-     * 获取快照管理器 (用于直接查询)
-     * @returns {BootstrapSnapshot}
-     */
+    /** 获取快照管理器 (用于直接查询) */
     getSnapshotManager(): BootstrapSnapshot;
 }
 export default IncrementalBootstrap;
-//# sourceMappingURL=IncrementalBootstrap.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.js

@@ -14,24 +14,15 @@
  *
  * @module pipeline/IncrementalBootstrap
  */
-import { SessionStore } from '#service/agent/memory/SessionStore.js';
+import { SessionStore } from '#agent/memory/SessionStore.js';
 import { BootstrapSnapshot } from './BootstrapSnapshot.js';
 // ──────────────────────────────────────────────────────────────
 // IncrementalBootstrap 类
 // ──────────────────────────────────────────────────────────────
 export class IncrementalBootstrap {
-    /** @type {BootstrapSnapshot} */
     #snapshot;
-    /** @type {object|null} */
     #logger;
-    /** @type {string} */
     #projectRoot;
-    /**
-     * @param {import('better-sqlite3').Database} db
-     * @param {string} projectRoot
-     * @param {object} [opts]
-     * @param {object} [opts.logger]
-     */
     constructor(db, projectRoot, { logger } = {}) {
         this.#snapshot = new BootstrapSnapshot(db, { logger });
         this.#logger = logger || null;
@@ -41,18 +32,7 @@ export class IncrementalBootstrap {
      * 评估增量可行性 — 在 bootstrap 流程最开始调用
      *
      * @param {Array<{path: string, relativePath: string, content: string}>} currentFiles 当前扫描到的文件
-     * @param {string[]} allDimIds 所有可用维度 ID
-     * @returns {IncrementalPlan}
-     *
-     * @typedef {object} IncrementalPlan
-     * @property {boolean} canIncremental 是否支持增量
-     * @property {'incremental'|'full'} mode
-     * @property {string[]} affectedDimensions 需要重新分析的维度
-     * @property {string[]} skippedDimensions 可跳过的维度 (使用历史结果)
-     * @property {object|null} previousSnapshot 上次快照
-     * @property {object|null} diff - { added, modified, deleted, unchanged, changeRatio }
-     * @property {string} reason 人类可读的决策原因
-     * @property {object|null} restoredEpisodic 从快照恢复的 EpisodicMemory (仅增量时)
+     * @param allDimIds 所有可用维度 ID
      */
     evaluate(currentFiles, allDimIds) {
         try {
@@ -133,14 +113,9 @@ export class IncrementalBootstrap {
     /**
      * 保存快照 — 在 bootstrap 完成后调用
      *
-     * @param {object} params
-     * @param {string} params.sessionId
-     * @param {Array} params.allFiles
-     * @param {object} params.dimensionStats
-     * @param {SessionStore} [params.episodicMemory]
-     * @param {object} [params.meta] - { durationMs, candidateCount, primaryLang }
-     * @param {IncrementalPlan} [params.plan] - evaluate() 返回的计划 (增量时)
-     * @returns {string} 快照 ID
+     * @param [params.meta] { durationMs, candidateCount, primaryLang }
+     * @param [params.plan] evaluate() 返回的计划 (增量时)
+     * @returns 快照 ID
      */
     saveSnapshot(params) {
         const { sessionId, allFiles, dimensionStats, episodicMemory, meta = {}, plan = null } = params;
@@ -172,10 +147,7 @@ export class IncrementalBootstrap {
             affectedDims: plan?.affectedDimensions || [],
         });
     }
-    /**
-     * 获取快照管理器 (用于直接查询)
-     * @returns {BootstrapSnapshot}
-     */
+    /** 获取快照管理器 (用于直接查询) */
     getSnapshotManager() {
         return this.#snapshot;
     }
@@ -187,4 +159,3 @@ export class IncrementalBootstrap {
     }
 }
 export default IncrementalBootstrap;
-//# sourceMappingURL=IncrementalBootstrap.js.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/checkpoint.d.ts

@@ -12,22 +12,14 @@
  */
 /**
  * 保存维度级 checkpoint
- * @param {string} projectRoot
- * @param {string} sessionId
- * @param {string} dimId
- * @param {object} result 维度执行结果
- * @param {object} [digest] - DimensionDigest
+ * @param result 维度执行结果
+ * @param [digest] DimensionDigest
  */
 export declare function saveDimensionCheckpoint(projectRoot: string, sessionId: string, dimId: string, result: Record<string, unknown>, digest?: null): Promise<void>;
 /**
  * 加载有效的 checkpoints
- * @param {string} projectRoot
- * @returns {Promise<Map<string, object>>} dimId → checkpoint data
+ * @returns dimId → checkpoint data
  */
 export declare function loadCheckpoints(projectRoot: string): Promise<Map<any, any>>;
-/**
- * 清理 checkpoint 目录
- * @param {string} projectRoot
- */
+/** 清理 checkpoint 目录 */
 export declare function clearCheckpoints(projectRoot: string): Promise<void>;
-//# sourceMappingURL=checkpoint.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/checkpoint.js

@@ -18,11 +18,8 @@ const logger = Logger.getInstance();
 const CHECKPOINT_TTL_MS = 3600_000; // 1小时内有效
 /**
  * 保存维度级 checkpoint
- * @param {string} projectRoot
- * @param {string} sessionId
- * @param {string} dimId
- * @param {object} result 维度执行结果
- * @param {object} [digest] - DimensionDigest
+ * @param result 维度执行结果
+ * @param [digest] DimensionDigest
  */
 export async function saveDimensionCheckpoint(projectRoot, sessionId, dimId, result, digest = null) {
     try {
@@ -36,8 +33,7 @@ export async function saveDimensionCheckpoint(projectRoot, sessionId, dimId, res
 }
 /**
  * 加载有效的 checkpoints
- * @param {string} projectRoot
- * @returns {Promise<Map<string, object>>} dimId → checkpoint data
+ * @returns dimId → checkpoint data
  */
 export async function loadCheckpoints(projectRoot) {
     const checkpoints = new Map();
@@ -66,10 +62,7 @@ export async function loadCheckpoints(projectRoot) {
     }
     return checkpoints;
 }
-/**
- * 清理 checkpoint 目录
- * @param {string} projectRoot
- */
+/** 清理 checkpoint 目录 */
 export async function clearCheckpoints(projectRoot) {
     try {
         const checkpointDir = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint');
@@ -83,4 +76,3 @@ export async function clearCheckpoints(projectRoot) {
         /* ignore other errors */
     }
 }
-//# sourceMappingURL=checkpoint.js.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.d.ts

@@ -68,8 +68,8 @@ export declare const DIMENSION_CONFIGS_V3: {
 /**
  * 获取完整维度配置（合并 baseDimensions + V3 专属配置 + SOP）
  *
- * @param {string} dimId 维度 ID
- * @returns {object|null} 完整维度配置，或 null（未知维度）
+ * @param dimId 维度 ID
+ * @returns 完整维度配置，或 null（未知维度）
  */
 export declare function getFullDimensionConfig(dimId: string): {
     id: string;
@@ -132,10 +132,9 @@ interface TierSessionStore {
  * - 检测跨维度重复模式
  * - 为下一 Tier 生成建议
  *
- * @param {number} tierIndex - Tier 索引 (0-based)
- * @param {Map<string, object>} tierResults 本 Tier 的维度结果
- * @param {import('#service/agent/memory/SessionStore.js').SessionStore} sessionStore
- * @returns {object} TierReflection
+ * @param tierIndex Tier 索引 (0-based)
+ * @param tierResults 本 Tier 的维度结果
+ * @returns TierReflection
  */
 export declare function buildTierReflection(tierIndex: number, tierResults: Map<string, unknown>, sessionStore: TierSessionStore): {
     tierIndex: number;
@@ -145,4 +144,3 @@ export declare function buildTierReflection(tierIndex: number, tierResults: Map<
     suggestionsForNextTier: string[];
 };
 export {};
-//# sourceMappingURL=dimension-configs.d.ts.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.js

@@ -65,8 +65,8 @@ export const DIMENSION_CONFIGS_V3 = {
 /**
  * 获取完整维度配置（合并 baseDimensions + V3 专属配置 + SOP）
  *
- * @param {string} dimId 维度 ID
- * @returns {object|null} 完整维度配置，或 null（未知维度）
+ * @param dimId 维度 ID
+ * @returns 完整维度配置，或 null（未知维度）
  */
 export function getFullDimensionConfig(dimId) {
     const base = baseDimensions.find((d) => d.id === dimId);
@@ -101,10 +101,9 @@ export function getFullDimensionConfig(dimId) {
  * - 检测跨维度重复模式
  * - 为下一 Tier 生成建议
  *
- * @param {number} tierIndex - Tier 索引 (0-based)
- * @param {Map<string, object>} tierResults 本 Tier 的维度结果
- * @param {import('#service/agent/memory/SessionStore.js').SessionStore} sessionStore
- * @returns {object} TierReflection
+ * @param tierIndex Tier 索引 (0-based)
+ * @param tierResults 本 Tier 的维度结果
+ * @returns TierReflection
  */
 export function buildTierReflection(tierIndex, tierResults, sessionStore) {
     const completedDimensions = [...tierResults.keys()];
@@ -183,4 +182,3 @@ export function buildTierReflection(tierIndex, tierResults, sessionStore) {
         suggestionsForNextTier: suggestionsForNextTier.slice(0, 8),
     };
 }
-//# sourceMappingURL=dimension-configs.js.map

package/dist/lib/external/mcp/handlers/bootstrap/pipeline/dimension-context.d.ts

@@ -62,30 +62,19 @@ export declare class DimensionContext {
     completedDimensions: Map<string, DimensionDigest>;
     projectContext: ProjectContext;
     submittedCandidates: CandidateSummary[];
-    /**
-     * @param {object} projectContext 项目基础信息 (全程不变)
-     * @param {string} projectContext.projectName
-     * @param {string} projectContext.primaryLang
-     * @param {number} projectContext.fileCount
-     * @param {number} projectContext.targetCount
-     * @param {string[]} projectContext.modules
-     * @param {object} [projectContext.depGraph]
-     * @param {object} [projectContext.astMetrics]
-     * @param {object} [projectContext.guardSummary]
-     */
+    /** @param projectContext 项目基础信息 (全程不变) */
     constructor(projectContext: ProjectContext);
     /**
      * 维度完成后存储其摘要
      *
-     * @param {string} dimId 维度 ID
-     * @param {DimensionDigest} digest 维度分析摘要
+     * @param dimId 维度 ID
+     * @param digest 维度分析摘要
      */
     addDimensionDigest(dimId: string, digest: DimensionDigest): void;
     /**
      * 记录已提交的候选
      *
-     * @param {string} dimId
-     * @param {object} candidateInfo - { title, subTopic, summary }
+     * @param candidateInfo { title, subTopic, summary }
      */
     addSubmittedCandidate(dimId: string, candidateInfo: {
         title?: string;
@@ -95,8 +84,7 @@ export declare class DimensionContext {
     /**
      * 构建给 Agent 的上下文快照
      *
-     * @param {string} currentDimId 当前维度 ID
-     * @returns {DimensionContextSnapshot}
+     * @param currentDimId 当前维度 ID
      */
     buildContextForDimension(currentDimId: string): {
         project: ProjectContext;
@@ -108,24 +96,14 @@ export declare class DimensionContext {
         }[];
         currentDimension: string;
     };
-    /**
-     * 重算某维度时，获取该维度已有候选
-     *
-     * @param {string} dimId
-     * @returns {Array<CandidateSummary>}
-     */
+    /** 重算某维度时，获取该维度已有候选 */
     getExistingCandidatesForDimension(dimId: string): CandidateSummary[];
     /**
      * 获取所有维度摘要的紧凑文本表示
      * 用于 Agent prompt 中注入
-     *
-     * @returns {string}
      */
     getDigestsSummaryText(): string;
-    /**
-     * 将完整上下文序列化为 JSON (用于断点恢复)
-     * @returns {object}
-     */
+    /** 将完整上下文序列化为 JSON (用于断点恢复) */
     toJSON(): {
         projectContext: ProjectContext;
         completedDimensions: {
@@ -133,11 +111,7 @@ export declare class DimensionContext {
         };
         submittedCandidates: CandidateSummary[];
     };
-    /**
-     * 从 JSON 恢复上下文 (断点恢复)
-     * @param {object} json
-     * @returns {DimensionContext}
-     */
+    /** 从 JSON 恢复上下文 (断点恢复) */
     static fromJSON(json: DimensionContextJSON): DimensionContext;
 }
 /**
@@ -146,9 +120,7 @@ export declare class DimensionContext {
  * Agent 被要求在回复末尾包含 JSON 格式的 dimensionDigest。
  * 此函数从自由格式文本中提取该 JSON 块。
  *
- * @param {string} reply - Agent 的完整回复文本
- * @returns {DimensionDigest|null}
+ * @param reply Agent 的完整回复文本
  */
 export declare function parseDimensionDigest(reply: string | null | undefined): DimensionDigest | null;
 export {};
-//# sourceMappingURL=dimension-context.d.ts.map