autosnippet 3.2.10 → 3.2.12

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

@@ -0,0 +1,190 @@
+/**
+ * IncrementalBootstrap — 增量冷启动控制器
+ *
+ * 基于 BootstrapSnapshot 存储的文件指纹，检测项目变更范围，
+ * 推断受影响维度，并控制 fillDimensionsV3 仅执行受影响维度。
+ *
+ * 流程:
+ *   1. 加载上次成功快照
+ *   2. 扫描当前文件 → 计算 diff (added/modified/deleted)
+ *   3. 推断受影响维度 → { mode, dimensions, skippedDimensions }
+ *   4. 从快照恢复未变更维度的 EpisodicMemory
+ *   5. 只对受影响维度执行 Analyst → Producer
+ *   6. 完成后保存新快照
+ *
+ * @module pipeline/IncrementalBootstrap
+ */
+import { SessionStore } from '#service/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;
+        this.#projectRoot = projectRoot;
+    }
+    /**
+     * 评估增量可行性 — 在 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 (仅增量时)
+     */
+    evaluate(currentFiles, allDimIds) {
+        try {
+            // 1. 加载上次快照
+            const previousSnapshot = this.#snapshot.getLatest(this.#projectRoot);
+            if (!previousSnapshot) {
+                this.#log('No previous snapshot found — full bootstrap required');
+                return {
+                    canIncremental: false,
+                    mode: 'full',
+                    affectedDimensions: allDimIds,
+                    skippedDimensions: [],
+                    previousSnapshot: null,
+                    diff: null,
+                    reason: '无历史快照，需要全量冷启动',
+                    restoredEpisodic: null,
+                };
+            }
+            // 2. 计算 diff
+            const diff = this.#snapshot.computeDiff(previousSnapshot, currentFiles, this.#projectRoot);
+            this.#log(`Diff: +${diff.added.length} added, ~${diff.modified.length} modified, ` +
+                `-${diff.deleted.length} deleted, =${diff.unchanged.length} unchanged ` +
+                `(ratio: ${(diff.changeRatio * 100).toFixed(1)}%)`);
+            // 3. 推断受影响维度
+            const inference = this.#snapshot.inferAffectedDimensions(previousSnapshot, diff, allDimIds);
+            if (inference.mode === 'full') {
+                this.#log(`Full rebuild recommended: ${inference.reason}`);
+                return {
+                    canIncremental: false,
+                    mode: 'full',
+                    affectedDimensions: allDimIds,
+                    skippedDimensions: [],
+                    previousSnapshot,
+                    diff,
+                    reason: inference.reason,
+                    restoredEpisodic: null,
+                };
+            }
+            // 4. 增量可行 → 尝试恢复 SessionStore
+            let restoredEpisodic = null;
+            if (previousSnapshot.episodicData) {
+                try {
+                    restoredEpisodic = SessionStore.fromJSON(previousSnapshot.episodicData);
+                    this.#log(`Restored SessionStore: ${restoredEpisodic.getCompletedDimensions().length} dimensions`);
+                }
+                catch (err) {
+                    this.#log(`Failed to restore SessionStore: ${err instanceof Error ? err.message : String(err)}`, 'warn');
+                }
+            }
+            this.#log(`Incremental plan: ${inference.dimensions.length} affected, ` +
+                `${inference.skippedDimensions.length} skipped — ${inference.reason}`);
+            return {
+                canIncremental: true,
+                mode: 'incremental',
+                affectedDimensions: inference.dimensions,
+                skippedDimensions: inference.skippedDimensions,
+                previousSnapshot,
+                diff,
+                reason: inference.reason,
+                restoredEpisodic,
+            };
+        }
+        catch (err) {
+            const errMsg = err instanceof Error ? err.message : String(err);
+            this.#log(`Incremental evaluation failed: ${errMsg} — fallback to full`, 'warn');
+            return {
+                canIncremental: false,
+                mode: 'full',
+                affectedDimensions: allDimIds,
+                skippedDimensions: [],
+                previousSnapshot: null,
+                diff: null,
+                reason: `增量评估失败 (${errMsg})，回退全量`,
+                restoredEpisodic: null,
+            };
+        }
+    }
+    /**
+     * 保存快照 — 在 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
+     */
+    saveSnapshot(params) {
+        const { sessionId, allFiles, dimensionStats, episodicMemory, meta = {}, plan = null } = params;
+        // 构建带 referencedFilesList 的 dimensionStats
+        const enrichedStats = { ...dimensionStats };
+        if (episodicMemory) {
+            for (const dimId of episodicMemory.getCompletedDimensions()) {
+                const report = episodicMemory.getDimensionReport?.(dimId);
+                if (report && enrichedStats[dimId]) {
+                    enrichedStats[dimId] = {
+                        ...enrichedStats[dimId],
+                        referencedFilesList: report.referencedFiles || [],
+                    };
+                }
+            }
+        }
+        return this.#snapshot.save({
+            sessionId,
+            projectRoot: this.#projectRoot,
+            allFiles,
+            dimensionStats: enrichedStats,
+            episodicData: episodicMemory?.toJSON() || null,
+            meta,
+            isIncremental: plan?.mode === 'incremental',
+            parentId: plan?.previousSnapshot?.id || null,
+            changedFiles: plan?.diff
+                ? [...(plan.diff.added || []), ...(plan.diff.modified || []), ...(plan.diff.deleted || [])]
+                : [],
+            affectedDims: plan?.affectedDimensions || [],
+        });
+    }
+    /**
+     * 获取快照管理器 (用于直接查询)
+     * @returns {BootstrapSnapshot}
+     */
+    getSnapshotManager() {
+        return this.#snapshot;
+    }
+    #log(msg, level = 'info') {
+        if (this.#logger) {
+            const fn = this.#logger[level];
+            fn?.(`[IncrementalBootstrap] ${msg}`);
+        }
+    }
+}
+export default IncrementalBootstrap;
+//# sourceMappingURL=IncrementalBootstrap.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IncrementalBootstrap.js","sourceRoot":"","sources":["../../../../../../../lib/external/mcp/handlers/bootstrap/pipeline/IncrementalBootstrap.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,33 @@
+/**
+ * checkpoint.js — Bootstrap 断点续传 (Checkpoint) 存储/恢复
+ *
+ * 在维度级粒度保存/加载/清理执行进度，支持意外中断后恢复。
+ *
+ * 调用方:
+ *   - orchestrator.js (内部 Agent) — AI pipeline 每个维度完成后保存
+ *   - dimension-complete.js (外部 Agent) — 外部 Agent 通知维度完成时保存
+ *   - bootstrap.js — clearCheckpoints() 全量重建前清理
+ *
+ * @module pipeline/checkpoint
+ */
+/**
+ * 保存维度级 checkpoint
+ * @param {string} projectRoot
+ * @param {string} sessionId
+ * @param {string} dimId
+ * @param {object} result 维度执行结果
+ * @param {object} [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
+ */
+export declare function loadCheckpoints(projectRoot: string): Promise<Map<any, any>>;
+/**
+ * 清理 checkpoint 目录
+ * @param {string} projectRoot
+ */
+export declare function clearCheckpoints(projectRoot: string): Promise<void>;
+//# sourceMappingURL=checkpoint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.d.ts","sourceRoot":"","sources":["../../../../../../../lib/external/mcp/handlers/bootstrap/pipeline/checkpoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAWH;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,OAAO,iBAcd;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,0BAwBxD;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,iBAWzD"}

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

@@ -0,0 +1,86 @@
+/**
+ * checkpoint.js — Bootstrap 断点续传 (Checkpoint) 存储/恢复
+ *
+ * 在维度级粒度保存/加载/清理执行进度，支持意外中断后恢复。
+ *
+ * 调用方:
+ *   - orchestrator.js (内部 Agent) — AI pipeline 每个维度完成后保存
+ *   - dimension-complete.js (外部 Agent) — 外部 Agent 通知维度完成时保存
+ *   - bootstrap.js — clearCheckpoints() 全量重建前清理
+ *
+ * @module pipeline/checkpoint
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import Logger from '#infra/logging/Logger.js';
+import pathGuard from '#shared/PathGuard.js';
+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
+ */
+export async function saveDimensionCheckpoint(projectRoot, sessionId, dimId, result, digest = null) {
+    try {
+        const checkpointDir = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint');
+        await fs.mkdir(checkpointDir, { recursive: true });
+        await fs.writeFile(path.join(checkpointDir, `${dimId}.json`), JSON.stringify({ dimId, sessionId, ...result, digest, completedAt: Date.now() }));
+    }
+    catch (err) {
+        logger.warn(`[Bootstrap-v3] checkpoint save failed for "${dimId}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * 加载有效的 checkpoints
+ * @param {string} projectRoot
+ * @returns {Promise<Map<string, object>>} dimId → checkpoint data
+ */
+export async function loadCheckpoints(projectRoot) {
+    const checkpoints = new Map();
+    try {
+        const checkpointDir = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint');
+        const files = await fs.readdir(checkpointDir).catch(() => []);
+        const now = Date.now();
+        for (const file of files) {
+            if (!file.endsWith('.json')) {
+                continue;
+            }
+            try {
+                const content = await fs.readFile(path.join(checkpointDir, file), 'utf-8');
+                const data = JSON.parse(content);
+                if (data.completedAt && now - data.completedAt < CHECKPOINT_TTL_MS) {
+                    checkpoints.set(data.dimId, data);
+                }
+            }
+            catch {
+                /* skip corrupt checkpoint */
+            }
+        }
+    }
+    catch {
+        /* checkpoint dir doesn't exist */
+    }
+    return checkpoints;
+}
+/**
+ * 清理 checkpoint 目录
+ * @param {string} projectRoot
+ */
+export async function clearCheckpoints(projectRoot) {
+    try {
+        const checkpointDir = path.join(projectRoot, '.autosnippet', 'bootstrap-checkpoint');
+        pathGuard.assertSafe(checkpointDir);
+        await fs.rm(checkpointDir, { recursive: true, force: true });
+    }
+    catch (err) {
+        if (err?.name === 'PathGuardError') {
+            throw err;
+        }
+        /* ignore other errors */
+    }
+}
+//# sourceMappingURL=checkpoint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoint.js","sourceRoot":"","sources":["../../../../../../../lib/external/mcp/handlers/bootstrap/pipeline/checkpoint.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,148 @@
+/**
+ * dimension-configs.js — v3.0 维度配置 + Tier Reflection
+ *
+ * 从 orchestrator.js 拆分，包含:
+ * - DIMENSION_CONFIGS_V3: 仅保留内部 Agent 专属配置 (outputType + allowedKnowledgeTypes)
+ * - getFullDimensionConfig(): 合并 baseDimensions + V3 专属配置
+ * - buildTierReflection: Tier 级反思聚合 (规则化, 不需要 AI)
+ *
+ * label / guide → 从 baseDimensions 获取（唯一权威来源）
+ * SOP / commonMistakes → 从 dimension-sop.js 获取
+ *
+ * @module pipeline/dimension-configs
+ */
+export declare const DIMENSION_CONFIGS_V3: {
+    'project-profile': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'objc-deep-scan': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'category-scan': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'code-standard': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    architecture: {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'code-pattern': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'event-and-data-flow': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'best-practice': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'agent-guidelines': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'module-export-scan': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'framework-convention-scan': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'python-package-scan': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+    'jvm-annotation-scan': {
+        outputType: string;
+        allowedKnowledgeTypes: string[];
+    };
+};
+/**
+ * 获取完整维度配置（合并 baseDimensions + V3 专属配置 + SOP）
+ *
+ * @param {string} dimId 维度 ID
+ * @returns {object|null} 完整维度配置，或 null（未知维度）
+ */
+export declare function getFullDimensionConfig(dimId: string): {
+    id: string;
+    label: string;
+    guide: string;
+    outputType: string;
+    allowedKnowledgeTypes: string[];
+    skillWorthy: boolean;
+    dualOutput: boolean;
+    skillMeta: {
+        name: string;
+        description: string;
+    } | {
+        name: string;
+        description: string;
+    } | {
+        name: string;
+        description: string;
+    } | {
+        name: string;
+        description: string;
+    } | undefined;
+    knowledgeTypes: string[];
+    sopSteps: {
+        phase: string;
+        action: string;
+        expectedOutput?: string;
+        tools?: string[];
+        qualityChecklist?: string[];
+    }[];
+    commonMistakes: string[];
+    timeEstimate: string | null;
+    focusKeywords: string[];
+} | null;
+/** A single finding from a dimension analysis */
+interface DimensionFinding {
+    dimId?: string;
+    importance?: number;
+    evidence?: string | unknown;
+    finding?: string;
+}
+/** Minimal session store interface for tier reflection */
+interface TierSessionStore {
+    getDimensionReport(dimId: string): {
+        findings?: DimensionFinding[];
+        digest?: {
+            gaps?: string[];
+            remainingTasks?: Array<{
+                signal?: string;
+                reason?: string;
+            }>;
+        };
+    } | undefined;
+}
+/**
+ * 构建 Tier 级 Reflection — 在每个 Tier 完成后调用
+ *
+ * 无需 AI 调用，通过规则化聚合维度发现:
+ * - 收集所有维度的关键发现并按重要性排序
+ * - 检测跨维度重复模式
+ * - 为下一 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
+ */
+export declare function buildTierReflection(tierIndex: number, tierResults: Map<string, unknown>, sessionStore: TierSessionStore): {
+    tierIndex: number;
+    completedDimensions: string[];
+    topFindings: DimensionFinding[];
+    crossDimensionPatterns: string[];
+    suggestionsForNextTier: string[];
+};
+export {};
+//# sourceMappingURL=dimension-configs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-configs.d.ts","sourceRoot":"","sources":["../../../../../../../lib/external/mcp/handlers/bootstrap/pipeline/dimension-configs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyChC,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;SAgCnD;AAMD,iDAAiD;AACjD,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,0DAA0D;AAC1D,UAAU,gBAAgB;IACxB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAC5B;QACE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;QAC9B,MAAM,CAAC,EAAE;YACP,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;YAChB,cAAc,CAAC,EAAE,KAAK,CAAC;gBAAE,MAAM,CAAC,EAAE,MAAM,CAAC;gBAAC,MAAM,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;SAC9D,CAAC;KACH,GACD,SAAS,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,YAAY,EAAE,gBAAgB;;;;;;EA0F/B"}

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

@@ -0,0 +1,186 @@
+/**
+ * dimension-configs.js — v3.0 维度配置 + Tier Reflection
+ *
+ * 从 orchestrator.js 拆分，包含:
+ * - DIMENSION_CONFIGS_V3: 仅保留内部 Agent 专属配置 (outputType + allowedKnowledgeTypes)
+ * - getFullDimensionConfig(): 合并 baseDimensions + V3 专属配置
+ * - buildTierReflection: Tier 级反思聚合 (规则化, 不需要 AI)
+ *
+ * label / guide → 从 baseDimensions 获取（唯一权威来源）
+ * SOP / commonMistakes → 从 dimension-sop.js 获取
+ *
+ * @module pipeline/dimension-configs
+ */
+import { baseDimensions } from '../base-dimensions.js';
+import { getDimensionFocusKeywords, getDimensionSOP } from '../shared/dimension-sop.js';
+// ──────────────────────────────────────────────────────────────────
+// v3.0 维度配置 — 仅保留内部 Agent 专属字段
+// label / guide / focusAreas 已移至 baseDimensions（唯一权威来源）
+// ──────────────────────────────────────────────────────────────────
+export const DIMENSION_CONFIGS_V3 = {
+    'project-profile': { outputType: 'dual', allowedKnowledgeTypes: ['architecture'] },
+    'objc-deep-scan': {
+        outputType: 'dual',
+        allowedKnowledgeTypes: ['code-standard', 'code-pattern'],
+    },
+    'category-scan': { outputType: 'dual', allowedKnowledgeTypes: ['code-standard', 'code-pattern'] },
+    'code-standard': { outputType: 'dual', allowedKnowledgeTypes: ['code-standard', 'code-style'] },
+    architecture: {
+        outputType: 'dual',
+        allowedKnowledgeTypes: ['architecture', 'module-dependency', 'boundary-constraint'],
+    },
+    'code-pattern': {
+        outputType: 'candidate',
+        allowedKnowledgeTypes: ['code-pattern', 'code-relation', 'inheritance'],
+    },
+    'event-and-data-flow': {
+        outputType: 'candidate',
+        allowedKnowledgeTypes: ['call-chain', 'data-flow', 'event-and-data-flow'],
+    },
+    'best-practice': { outputType: 'candidate', allowedKnowledgeTypes: ['best-practice'] },
+    'agent-guidelines': {
+        outputType: 'skill',
+        allowedKnowledgeTypes: ['boundary-constraint', 'code-standard'],
+    },
+    'module-export-scan': {
+        outputType: 'dual',
+        allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    },
+    'framework-convention-scan': {
+        outputType: 'dual',
+        allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    },
+    'python-package-scan': {
+        outputType: 'dual',
+        allowedKnowledgeTypes: ['code-standard', 'architecture'],
+    },
+    'jvm-annotation-scan': {
+        outputType: 'dual',
+        allowedKnowledgeTypes: ['code-pattern', 'architecture'],
+    },
+};
+// ──────────────────────────────────────────────────────────────────
+// 完整维度配置获取（合并 baseDimensions + V3 专属 + SOP）
+// ──────────────────────────────────────────────────────────────────
+/**
+ * 获取完整维度配置（合并 baseDimensions + V3 专属配置 + SOP）
+ *
+ * @param {string} dimId 维度 ID
+ * @returns {object|null} 完整维度配置，或 null（未知维度）
+ */
+export function getFullDimensionConfig(dimId) {
+    const base = baseDimensions.find((d) => d.id === dimId);
+    const v3 = DIMENSION_CONFIGS_V3[dimId];
+    if (!base) {
+        return null;
+    }
+    const sop = getDimensionSOP(dimId);
+    return {
+        id: dimId,
+        label: base.label,
+        guide: base.guide,
+        outputType: v3?.outputType || (base.dualOutput ? 'dual' : base.skillWorthy ? 'skill' : 'candidate'),
+        allowedKnowledgeTypes: v3?.allowedKnowledgeTypes || base.knowledgeTypes || [],
+        skillWorthy: base.skillWorthy || false,
+        dualOutput: base.dualOutput || false,
+        skillMeta: base.skillMeta,
+        knowledgeTypes: base.knowledgeTypes || [],
+        // SOP 结构化分析步骤
+        sopSteps: sop?.steps || null,
+        commonMistakes: sop?.commonMistakes || [],
+        timeEstimate: sop?.timeEstimate || null,
+        // 关键关注域词汇（用于 EpisodicMemory 跨维度 findings 相关性匹配）
+        focusKeywords: getDimensionFocusKeywords(dimId, base.guide),
+    };
+}
+/**
+ * 构建 Tier 级 Reflection — 在每个 Tier 完成后调用
+ *
+ * 无需 AI 调用，通过规则化聚合维度发现:
+ * - 收集所有维度的关键发现并按重要性排序
+ * - 检测跨维度重复模式
+ * - 为下一 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
+ */
+export function buildTierReflection(tierIndex, tierResults, sessionStore) {
+    const completedDimensions = [...tierResults.keys()];
+    // 收集本 Tier 所有维度的 findings
+    const allFindings = [];
+    for (const dimId of completedDimensions) {
+        const report = sessionStore.getDimensionReport(dimId);
+        if (report?.findings) {
+            for (const f of report.findings) {
+                allFindings.push({ dimId, ...f });
+            }
+        }
+    }
+    // Top findings by importance
+    const topFindings = allFindings
+        .sort((a, b) => (b.importance || 5) - (a.importance || 5))
+        .slice(0, 10);
+    // 检测跨维度模式 (多个维度提到同一文件/关键词)
+    const fileMentions = {};
+    const keywordMentions = {};
+    for (const f of allFindings) {
+        // 统计文件引用频率
+        if (f.evidence) {
+            const ev = typeof f.evidence === 'string' ? f.evidence : String(f.evidence);
+            const file = ev.split(':')[0];
+            if (file) {
+                fileMentions[file] = (fileMentions[file] || 0) + 1;
+            }
+        }
+        // 统计关键词
+        const words = (f.finding || '').split(/[\s,，。.]+/).filter((w) => w.length > 3);
+        for (const w of words) {
+            keywordMentions[w] = (keywordMentions[w] || 0) + 1;
+        }
+    }
+    const crossDimensionPatterns = [];
+    // 多维度引用的文件 = 跨维度热点
+    for (const [file, count] of Object.entries(fileMentions)) {
+        if (count >= 2) {
+            crossDimensionPatterns.push(`文件 "${file}" 被 ${count} 个维度引用 — 可能是系统核心组件`);
+        }
+    }
+    // 多维度提及的关键词
+    for (const [word, count] of Object.entries(keywordMentions)) {
+        if (count >= 3) {
+            crossDimensionPatterns.push(`关键词 "${word}" 出现 ${count} 次 — 跨维度关联主题`);
+        }
+    }
+    // 为下一 Tier 生成建议
+    const suggestionsForNextTier = [];
+    // 找出 gaps (各维度报告的未覆盖方面)
+    for (const dimId of completedDimensions) {
+        const report = sessionStore.getDimensionReport(dimId);
+        const gaps = report?.digest?.gaps || [];
+        for (const gap of gaps) {
+            if (gap && typeof gap === 'string' && gap.length > 5) {
+                suggestionsForNextTier.push(`[${dimId}] 未覆盖: ${gap}`);
+            }
+        }
+    }
+    // remainingTasks
+    for (const dimId of completedDimensions) {
+        const report = sessionStore.getDimensionReport(dimId);
+        const remaining = report?.digest?.remainingTasks || [];
+        for (const task of remaining) {
+            if (task?.signal) {
+                suggestionsForNextTier.push(`[${dimId}] 遗留信号: ${task.signal} (${task.reason || '未处理'})`);
+            }
+        }
+    }
+    return {
+        tierIndex,
+        completedDimensions,
+        topFindings,
+        crossDimensionPatterns: crossDimensionPatterns.slice(0, 5),
+        suggestionsForNextTier: suggestionsForNextTier.slice(0, 8),
+    };
+}
+//# sourceMappingURL=dimension-configs.js.map