refactor: architecture deepening — 6 candidates implemented

1. IntentPostProcessor: extract intent post-processing into strategy
   registry (architecture dedup, symbol_lookup diversity)

2. FusionStrategy: extract fusion logic from HybridRecallEngine into
   SmartFusionStrategy + rrfFusion module. symbol_lookup short-circuit
   now lives in the strategy, not the engine.

3. executeAssembleContext split: 861-line god function →
   assembleContextStrategy.ts (data collection) +
   assembleContextFormatter.ts (JSON/text formatting) +
   thin 56-line orchestrator

4. memoryMatcher: extract pure ranking functions from resultCard.ts
   (rankFeatureMemoryMatches, rankDecisionMatches, rankFeedbackMatches,
   rankLongTermMemoryMatches) into independently testable module

5. MemoryStoreProvider: optional instance cache for MCP/CLI sessions

6. CONTEXT.md: domain vocabulary for future architecture reviews

All 551 existing tests pass. Zero regressions.

Author: codefromkarl

CONTEXT.md

@@ -0,0 +1,37 @@
+# ContextAtlas Domain Vocabulary
+
+## Core Pipeline
+
+- **Recall** — 混合召回：向量 + 词法 + skeleton + graph 四路并发召回原始候选
+- **Rerank** — 精排：对召回候选做 cross-encoder 重排
+- **Expand** — 上下文扩展：从 seed chunks 补充邻居、面包屑、跨文件引用
+- **Pack** — 上下文打包：合并 chunks → 按文件聚合段落 → Token 预算裁剪
+
+## Memory
+
+- **FeatureMemory** — 模块记忆：记录模块职责、API、数据流
+- **DecisionRecord** — 决策记录：记录架构决策
+- **LongTermMemory** — 长期记忆：无法从代码推导的事实（用户偏好、纠正、项目状态）
+- **MemoryCatalog** — 路由索引：轻量索引，用于按需加载模块记忆
+- **MemoryRouter** — 渐进式记忆路由器：catalog → global → feature 三层加载
+- **MemoryStore** — 项目记忆 facade：协调 feature/project-meta/decision/long-term 四类子存储
+- **MemorySession** — 已完成初始化的记忆会话（候选概念，待实现）
+
+## Retrieval
+
+- **ContextPack** — 检索输出包：seeds + expanded + files + debug info
+- **ResultCard** — 检索结果卡片：排名 + 上下文块 + 记忆匹配 + 格式化
+- **QueryIntent** — 查询意图：balanced / architecture / symbol_lookup
+- **LexicalStrategy** — 词法策略：chunks_fts / files_fts / none
+
+## Assembly
+
+- **AssemblyProfile** — 装配配置：overview / debug / implementation / verification / handoff
+- **ContextBlock** — 上下文块：类型化、优先级、来源追踪的结构化上下文单元
+- **WakeupLayers** — 唤醒层：分层展示上下文块，从关键到辅助
+- **Checkpoint** — 任务检查点：保存/恢复 Agent 工作状态
+
+## Infrastructure
+
+- **MemoryStoreProvider** — 记忆存储提供者：统一创建/缓存 MemoryStore 实例（候选概念）
+- **IntentPostProcessor** — 意图后处理器：按 QueryIntent 应用不同的后处理策略（候选概念）

src/application/memory/assembleContextFormatter.ts

@@ -0,0 +1,328 @@
+/**
+ * AssembleContext 格式化层
+ *
+ * 将 AssembledData 格式化为 JSON payload 或文本输出。
+ * 不包含任何业务逻辑或数据源调用。
+ */
+
+import type {
+  ContextBlock,
+  ContextBlockReference,
+  FeatureMemory,
+  TaskCheckpoint,
+} from '../../memory/types.js';
+import type { AssemblyProfileName } from '../../memory/MemoryRouter.js';
+import { formatWakeupLayersText, type WakeupLayersBundle } from './wakeupLayers.js';
+import type {
+  AssembleContextPhase,
+  AssembleContextSource,
+  AssembledData,
+  CheckpointPayload,
+  CodebaseRetrievalPayload,
+  ModuleMemoryPayload,
+} from './assembleContextStrategy.js';
+
+// ===========================================
+// JSON Payload 类型
+// ===========================================
+
+export interface AssembledContextJsonPayload {
+  tool: 'assemble_context';
+  repo_path: string;
+  input: {
+    phase?: AssembleContextPhase;
+    profile?: AssemblyProfileName;
+    query?: string;
+    moduleName?: string;
+    filePaths?: string[];
+    checkpoint_id?: string;
+    includeDiary?: boolean;
+    agentName?: string;
+    diaryTopic?: string;
+    diaryLimit?: number;
+    format: 'json';
+  };
+  assemblyProfile: {
+    requestedPhase?: AssembleContextPhase;
+    resolvedProfile: AssemblyProfileName;
+    source: AssembleContextSource;
+  };
+  routing: {
+    checkpoint: {
+      checkpointId?: string;
+      phase?: AssembleContextPhase;
+      loaded: boolean;
+    };
+    moduleMemory: ModuleMemoryPayload['routing'] | null;
+    codebaseRetrieval: {
+      informationRequest: string;
+      technicalTerms: string[];
+      responseMode: 'expanded';
+      summary: CodebaseRetrievalPayload['summary'] | null;
+      architecturePrimaryFiles: string[];
+      nextInspectionSuggestions: string[];
+    } | null;
+  };
+  budget: {
+    moduleMemory: {
+      candidateCount: number;
+      selectedCount: number;
+      selectedModules: string[];
+      maxResults: number;
+      selectionStrategy: 'mmr' | 'ranked';
+      routeStrategy: string;
+    } | null;
+    codebaseRetrieval: {
+      codeBlocks: number;
+      files: number;
+      totalSegments: number;
+    } | null;
+    selectedContextBlocks: number;
+  };
+  selectedContext: {
+    checkpoint: CheckpointPayload | null;
+    moduleMemories: FeatureMemory[];
+    codebaseRetrieval: CodebaseRetrievalPayload | null;
+    contextBlocks: ContextBlock[];
+    summary: {
+      checkpointBlocks: number;
+      diaryBlocks: number;
+      moduleMemoryBlocks: number;
+      codeBlocks: number;
+      totalBlocks: number;
+      references: number;
+    };
+  };
+  references: ContextBlockReference[];
+  wakeupLayers: WakeupLayersBundle;
+  source: {
+    checkpoint: null | {
+      tool: 'load_checkpoint';
+      checkpointId: string;
+      phase: AssembleContextPhase;
+    };
+    moduleMemory: null | {
+      tool: 'load_module_memory';
+      assembly: ModuleMemoryPayload['assembly'];
+      resultCount: number;
+    };
+    codebaseRetrieval: null | {
+      tool: 'codebase-retrieval';
+      responseMode: 'expanded';
+      summary: CodebaseRetrievalPayload['summary'];
+      architecturePrimaryFiles: string[];
+    };
+    diary: null | {
+      tool: 'record_agent_diary';
+      resultCount: number;
+      agentName?: string;
+      topic?: string;
+    };
+  };
+}
+
+// ===========================================
+// 格式化函数
+// ===========================================
+
+export function buildAssembledPayload(
+  args: {
+    repo_path: string;
+    phase?: AssembleContextPhase;
+    profile?: AssemblyProfileName;
+    query?: string;
+    moduleName?: string;
+    filePaths?: string[];
+    checkpoint_id?: string;
+    includeDiary?: boolean;
+    agentName?: string;
+    diaryTopic?: string;
+    diaryLimit?: number;
+  },
+  data: AssembledData,
+): AssembledContextJsonPayload {
+  const checkpointPayload = data.checkpoint;
+  const modulePayload = data.moduleMemory;
+  const codePayload = data.codebaseRetrieval;
+
+  return {
+    tool: 'assemble_context',
+    repo_path: args.repo_path,
+    input: {
+      phase: args.phase,
+      profile: args.profile,
+      query: args.query,
+      moduleName: args.moduleName,
+      filePaths: args.filePaths,
+      checkpoint_id: args.checkpoint_id,
+      includeDiary: args.includeDiary,
+      agentName: args.agentName,
+      diaryTopic: args.diaryTopic,
+      diaryLimit: args.diaryLimit,
+      format: 'json',
+    },
+    assemblyProfile: {
+      requestedPhase: data.profile.requestedPhase ?? args.phase,
+      resolvedProfile: data.profile.name,
+      source: data.profile.source,
+    },
+    routing: {
+      checkpoint: {
+        checkpointId: checkpointPayload?.checkpoint.id,
+        phase: checkpointPayload?.checkpoint.phase,
+        loaded: Boolean(checkpointPayload),
+      },
+      moduleMemory: modulePayload?.routing ?? null,
+      codebaseRetrieval: data.codebaseRetrieval
+        ? {
+            informationRequest: data.codebaseRequest.information_request,
+            technicalTerms: data.codebaseRequest.technical_terms,
+            responseMode: 'expanded',
+            summary: data.codebaseRetrieval.summary,
+            architecturePrimaryFiles: data.codebaseRetrieval.architecturePrimaryFiles,
+            nextInspectionSuggestions: data.codebaseRetrieval.nextInspectionSuggestions,
+          }
+        : null,
+    },
+    budget: {
+      moduleMemory: modulePayload?.routing
+        ? {
+            candidateCount: modulePayload.routing.candidateCount,
+            selectedCount: modulePayload.routing.selectedCount,
+            selectedModules: modulePayload.routing.selectedModules,
+            maxResults: modulePayload.assembly.maxResults,
+            selectionStrategy: modulePayload.routing.selectionStrategy,
+            routeStrategy: modulePayload.routing.routeStrategy,
+          }
+        : null,
+      codebaseRetrieval: data.codebaseRetrieval?.summary
+        ? {
+            codeBlocks: data.codebaseRetrieval.summary.codeBlocks,
+            files: data.codebaseRetrieval.summary.files,
+            totalSegments: data.codebaseRetrieval.summary.totalSegments,
+          }
+        : null,
+      selectedContextBlocks: data.selectedBlocks.length,
+    },
+    selectedContext: {
+      checkpoint: checkpointPayload,
+      moduleMemories: modulePayload?.memories ?? [],
+      codebaseRetrieval: codePayload,
+      contextBlocks: data.selectedBlocks,
+      summary: {
+        checkpointBlocks: checkpointPayload?.contextBlocks.length ?? 0,
+        diaryBlocks: data.diaryBlocks.length,
+        moduleMemoryBlocks: (modulePayload?.memories ?? []).length,
+        codeBlocks: codePayload?.contextBlocks.length ?? 0,
+        totalBlocks: data.selectedBlocks.length,
+        references: data.references.length,
+      },
+    },
+    references: data.references,
+    wakeupLayers: data.wakeupLayers,
+    source: {
+      checkpoint: checkpointPayload
+        ? {
+            tool: 'load_checkpoint',
+            checkpointId: checkpointPayload.checkpoint.id,
+            phase: checkpointPayload.checkpoint.phase,
+          }
+        : null,
+      moduleMemory: modulePayload
+        ? {
+            tool: 'load_module_memory',
+            assembly: modulePayload.assembly,
+            resultCount: modulePayload.result_count,
+          }
+        : null,
+      codebaseRetrieval: codePayload?.summary
+        ? {
+            tool: 'codebase-retrieval',
+            responseMode: 'expanded',
+            summary: codePayload.summary,
+            architecturePrimaryFiles: codePayload.architecturePrimaryFiles,
+          }
+        : null,
+      diary: data.diaryBlocks.length > 0
+        ? {
+            tool: 'record_agent_diary',
+            resultCount: data.diaryBlocks.length,
+            agentName: args.agentName,
+            topic: args.diaryTopic,
+          }
+        : null,
+    },
+  };
+}
+
+export function formatAssembleContextText(payload: AssembledContextJsonPayload): string {
+  const stage = payload.input.phase ?? payload.assemblyProfile.resolvedProfile;
+  const moduleSummary =
+    payload.selectedContext.moduleMemories.length > 0
+      ? payload.selectedContext.moduleMemories.map((m) => `- ${m.name}`).join('\n')
+      : '- None';
+  const blockSummary =
+    payload.selectedContext.contextBlocks.length > 0
+      ? payload.selectedContext.contextBlocks.slice(0, 12).map(formatContextBlockText).join('\n\n---\n\n')
+      : '- None';
+  const wakeupLayerSummary = formatWakeupLayersText(payload.wakeupLayers);
+  const referenceSummary =
+    payload.references.length > 0
+      ? payload.references
+          .slice(0, 12)
+          .map((ref) => `- ${ref.source}:${ref.ref} (${ref.blockId})`)
+          .join('\n')
+      : '- None';
+
+  return [
+    '## Context Assembly',
+    `- **Stage**: ${stage}`,
+    `- **Assembly Profile**: ${payload.assemblyProfile.resolvedProfile}`,
+    `- **Assembly Source**: ${payload.assemblyProfile.source}`,
+    '',
+    '### Routing / Budget',
+    `- **Module Memory**: ${
+      payload.budget.moduleMemory
+        ? `${payload.budget.moduleMemory.selectedCount}/${payload.budget.moduleMemory.maxResults}`
+        : 'None'
+    }`,
+    `- **Code Retrieval**: ${payload.routing.codebaseRetrieval ? `${payload.routing.codebaseRetrieval.summary?.codeBlocks ?? 0} blocks` : 'None'}`,
+    `- **Selected Context Blocks**: ${payload.budget.selectedContextBlocks}`,
+    '',
+    '### Selected Context',
+    `- **Checkpoint**: ${payload.selectedContext.checkpoint ? payload.selectedContext.checkpoint.checkpoint.id : 'None'}`,
+    `- **Diary Blocks**: ${payload.selectedContext.summary.diaryBlocks}`,
+    `- **Module Memories**: ${payload.selectedContext.moduleMemories.length}`,
+    `- **Code Evidence Blocks**: ${payload.selectedContext.codebaseRetrieval?.contextBlocks.length ?? 0}`,
+    `- **Architecture Primary Files**: ${payload.routing.codebaseRetrieval?.architecturePrimaryFiles.length ?? 0}`,
+    '',
+    wakeupLayerSummary,
+    '',
+    '### Loaded Module Memories',
+    moduleSummary,
+    '',
+    '### Selected Context Blocks',
+    blockSummary,
+    '',
+    '### References',
+    referenceSummary,
+  ].join('\n');
+}
+
+function formatContextBlockText(block: ContextBlock): string {
+  const provenance = block.provenance.map((item) => `${item.source}:${item.ref}`).join(', ') || 'None';
+  const contentLines = block.content
+    .split('\n')
+    .map((line) => line.trimEnd())
+    .filter((line) => line.length > 0);
+
+  return [
+    `### ${block.title || block.id}`,
+    `- **ID**: ${block.id}`,
+    `- **Type**: ${block.type}`,
+    `- **Purpose**: ${block.purpose}`,
+    '- **Content**:',
+    ...(contentLines.length > 0 ? contentLines.map((line) => `  - ${line}`) : ['  - None']),
+    `- **Provenance**: ${provenance}`,
+  ].join('\n');
+}