add-coder 0.3.34 → 0.3.35

package/templates/adapters/vscode/hooks/prompt-submit.mjs

@@ -145,10 +145,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -635,7 +631,45 @@ function writeHookEvent(hook, decision, cmd, reason, plan = "unknown", status =
   appendFileSync(file, line);
 }
 
+// templates/core/scripts/mcp-server/shared/memory/switches.ts
+function recallMode(env = process.env) {
+  const v = (env.ADD_MEMORY_RECALL_MODE ?? "shadow").toLowerCase();
+  return v === "off" || v === "inject" ? v : "shadow";
+}
+var L1_SNAPSHOT_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+
+// templates/core/scripts/mcp-server/shared/memory/metrics/stage-words.ts
+var STAGE_LABEL = {
+  "plan-start": "Plan \u8D77\u8349",
+  "spec-start": "Spec \u8D77\u8349",
+  dps: "DPS \u95E8\u7981",
+  rahs: "RAHS \u95E8\u7981",
+  handoff: "Handoff \u4EA4\u63A5"
+};
+var STAGE_PATTERNS = [
+  { stage: "handoff", re: /handoff|交接(手册|文档|说明)?|交接给/i },
+  { stage: "rahs", re: /rahs|注意力漂移|执行健康度/i },
+  { stage: "dps", re: /dps|文档质量闸门|质量闸门|门禁(评分|检查)?/i },
+  { stage: "spec-start", re: /(生成|写|新建|起草|补)\s*(spec|规格|三元组)|specs?\s*三元组|WHEN-?THEN/i },
+  { stage: "plan-start", re: /(生成|写|新建|起草|补)\s*(plan|计划|方案)|plan\s*阶段|规划阶段/i }
+];
+function detectRecallStage(prompt) {
+  if (!prompt) return null;
+  for (const { stage, re } of STAGE_PATTERNS) {
+    if (re.test(prompt)) return stage;
+  }
+  return null;
+}
+function buildStageRecallHint(stage, mode) {
+  if (mode === "off") return null;
+  const label = STAGE_LABEL[stage];
+  const tail = mode === "shadow" ? "\uFF08\u5F53\u524D shadow \u6A21\u5F0F\uFF1AHook \u4E0D\u6CE8\u5165\u4E0A\u4E0B\u6587\uFF0C\u53EC\u56DE\u7ED3\u679C\u9700\u663E\u5F0F\u6D88\u8D39\uFF09" : "\uFF08\u5F53\u524D inject \u6A21\u5F0F\uFF1A\u8C03\u7528\u540E\u4E0A\u4E0B\u6587\u5C06\u88AB\u6CE8\u5165\uFF09";
+  return `[Memory] \u68C0\u6D4B\u5230${label}\u9636\u6BB5 \u2192 \u5EFA\u8BAE\u8C03\u7528 recall_memory({ stage: "${stage}", query: <\u672C\u9636\u6BB5\u610F\u56FE>, planKeyword: <Plan \u5173\u952E\u8BCD> }) \u83B7\u53D6\u53D7\u6CBB\u7406\u7684\u5386\u53F2\u4E0A\u4E0B\u6587\uFF08\u542B\u6765\u6E90\u4E0E\u8BC4\u5206\uFF09\u3002${tail}
+`;
+}
+
 // templates/core/governance/prompt-router.ts
+var MEMORY_RECALL_HINT_RE = /之前|上次|还记得|记得吗|为什么当时|类似问题|历史决策|以前的方案|曾经怎么/i;
 var PromptRouter = class {
   magicDir;
   constructor(magicDir) {
@@ -698,6 +732,38 @@ var PromptRouter = class {
   /** 前置注入（core: 无；qoder: 无条件 "ADD workflow active" JSON） */
   preamble(_input) {
   }
+  /**
+   * 显式记忆回忆提示（Spec §10 / Plan §9.1 补充入口）:
+   * 命中回忆词且 ADD_MEMORY_RECALL_MODE != off → 提示调用 recall_memory。
+   * 不做自动召回（同步 Hook ≤200ms 无 DB）；shadow 模式下提示语明示"仅显式调用"。
+   */
+  maybeMemoryHint(prompt) {
+    try {
+      if (recallMode() === "off") return;
+      if (!MEMORY_RECALL_HINT_RE.test(prompt)) return;
+      const mode = recallMode();
+      const suffix = mode === "shadow" ? "\uFF08\u5F53\u524D shadow \u6A21\u5F0F\uFF1A\u53EC\u56DE\u5C06\u843D\u5BA1\u8BA1\uFF0CHook \u4E0D\u81EA\u52A8\u6CE8\u5165\uFF09" : "";
+      process.stdout.write(
+        `[Memory] \u68C0\u6D4B\u5230\u5386\u53F2\u56DE\u5FC6\u610F\u56FE${suffix}\u3002\u53EF\u8C03\u7528 recall_memory({ query: <\u4F60\u7684\u95EE\u9898>, stage: "prompt" }) \u83B7\u53D6\u53D7\u6CBB\u7406\u7684\u8BB0\u5FC6\u4E0A\u4E0B\u6587\uFF08\u542B\u6765\u6E90\u4E0E\u8BC4\u5206\uFF09\u3002
+`
+      );
+    } catch {
+    }
+  }
+  /**
+   * 阶段确定性召回提示（Spec §2 §DeterministicRecall，Plan §3.1 方案 B1 的 Hook 侧）:
+   * 命中 ADD 阶段词 → 提示到工具侧做确定性召回（plan-start/spec-start/dps/rahs/handoff）。
+   * Hook 同步路径无 DB：只输出提示文本，不召回、不写审计；任何异常 fail-open。
+   */
+  maybeStageHint(prompt) {
+    try {
+      const stage = detectRecallStage(prompt);
+      if (!stage) return;
+      const hint = buildStageRecallHint(stage, recallMode());
+      if (hint) process.stdout.write(hint);
+    } catch {
+    }
+  }
   /** Layer 3 输出形态（core: 纯文本逐行；qoder: hookSpecificOutput JSON 包） */
   layer3Json() {
     return false;
@@ -729,6 +795,8 @@ var PromptRouter = class {
       for (const m of matched) process.stdout.write(m + "\n");
       return 0;
     }
+    this.maybeMemoryHint(prompt);
+    this.maybeStageHint(prompt);
     const devKw = loadDevKeywords();
     if (devKw.length === 0) return 0;
     if (!this.devKwMatched(prompt, devKw)) return 0;

package/templates/adapters/vscode/hooks/session-end.mjs

@@ -119,10 +119,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 

package/templates/adapters/vscode/hooks/session-start.mjs

@@ -1,5 +1,5 @@
 // templates/core/governance/session-start-guard.ts
-import { existsSync as existsSync3, readdirSync, statSync } from "node:fs";
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync3, statSync } from "node:fs";
 import { join as join3 } from "node:path";
 
 // templates/core/governance/common.ts
@@ -121,10 +121,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -482,6 +478,30 @@ var PreloadTemplates = class _PreloadTemplates {
   }
 };
 
+// templates/core/scripts/mcp-server/shared/memory/switches.ts
+function recallMode(env = process.env) {
+  const v = (env.ADD_MEMORY_RECALL_MODE ?? "shadow").toLowerCase();
+  return v === "off" || v === "inject" ? v : "shadow";
+}
+function memoryMaxTokens(env = process.env) {
+  const n = Number(env.ADD_MEMORY_MAX_TOKENS ?? 600);
+  return Number.isFinite(n) && n > 0 ? Math.floor(n) : 600;
+}
+var MEMORY_DIR_NAME = "memory";
+var L1_SNAPSHOT_FILE = "l1-context.md";
+var L1_SNAPSHOT_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+
+// templates/core/scripts/mcp-server/shared/memory/retrieval/context-builder.ts
+function estimateTokens(text) {
+  let cjk = 0;
+  let other = 0;
+  for (const ch of text) {
+    if (/[぀-ヿ㐀-䶿一-鿿豈-﫿＀-￯]/.test(ch)) cjk++;
+    else other++;
+  }
+  return cjk + Math.ceil(other / 4);
+}
+
 // templates/core/governance/session-start-guard.ts
 var SessionStartGuard = class {
   projectDir;
@@ -501,6 +521,7 @@ var SessionStartGuard = class {
     this.emitIndex();
     this.emitTodoReminder(state);
     this.emitHitlPending();
+    this.emitMemoryL1();
     return 0;
   }
   // ─────────────────────────── 扩展点 ───────────────────────────
@@ -549,6 +570,45 @@ var SessionStartGuard = class {
       }
     }
   }
+  /**
+   * ⑤ Memory L1 快照注入（ADD_MEMORY_RECALL_MODE 三态）:
+   *   off    → 不输出
+   *   shadow → 仅提示快照存在（召回可执行并落审计，但不注入上下文）
+   *   inject → 读预计算快照注入（新鲜度 ≤7 天，token 预算截断，带来源边界标签）
+   * 同步 Hook ≤200ms 约束：只读文件，任何异常 fail-open 静默跳过。
+   */
+  emitMemoryL1() {
+    try {
+      const mode = recallMode();
+      if (mode === "off" || !this.magicDir) return;
+      const file = join3(this.projectDir, this.magicDir, MEMORY_DIR_NAME, L1_SNAPSHOT_FILE);
+      if (!existsSync3(file)) return;
+      if (mode === "shadow") {
+        process.stdout.write(`[Memory] L1 \u5FEB\u7167\u5DF2\u751F\u6210\uFF08shadow \u6A21\u5F0F\u672A\u6CE8\u5165\uFF09\u3002\u9700\u8981\u65F6\u8C03\u7528 recall_memory \u663E\u5F0F\u53EC\u56DE: ${file}
+`);
+        return;
+      }
+      if (Date.now() - statSync(file).mtimeMs > L1_SNAPSHOT_TTL_MS) return;
+      const text = readFileSync3(file, "utf-8");
+      const budget = memoryMaxTokens();
+      if (estimateTokens(text) <= budget) {
+        process.stdout.write(text);
+        return;
+      }
+      const lines = text.split("\n");
+      const kept = [];
+      let used = 0;
+      for (const line of lines) {
+        const t = estimateTokens(line);
+        if (used + t > budget) break;
+        kept.push(line);
+        used += t;
+      }
+      kept.push(`[Memory L1] \u26A0\uFE0F \u8D85\u51FA\u9884\u7B97 ${budget} tokens\uFF0C\u5DF2\u622A\u65AD\uFF08\u5B8C\u6574\u5FEB\u7167: ${file}\uFF09`);
+      process.stdout.write(kept.join("\n") + "\n");
+    } catch {
+    }
+  }
 };
 
 // templates/adapters/vscode/hooks/session-start.ts

package/templates/adapters/vscode/hooks/stop-check.mjs

@@ -192,10 +192,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -406,10 +402,6 @@ function buildStopContext(quadrant, info) {
 }
 
 // templates/core/governance/stop-router.ts
-import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
-import { tmpdir } from "node:os";
-import { join as join2 } from "node:path";
 var StopRouter = class {
   /** 主路由：返回 exit code（0 放行 / 2 阻断） */
   run() {
@@ -438,20 +430,14 @@ var StopRouter = class {
   }
   // ─────────────────────────── 扩展点 ───────────────────────────
   /**
-  * Q4 验收决策（双维度组合——2026-08-14 Task 9.4.4④ 上提，回流: I2）:
-  *   维度 0（新增，临时方案）: 弹框频控——同项目同 Plan 窗口内达上限 → 降级放行
-  *   维度 1（前置）: DB 任务进度（step = done/total，数值且 done<total → 未完成阻断提示）
-  *   维度 2: checklist 质量（checkAddCompleteness 未闭环 → 阻断）
-  *   互补非替代——codex 原 DB 进度分流语义上提 core，core checklist 质量语义保留。
-  */
+   * Q4 验收决策（双维度组合——2026-08-14 Task 9.4.4④ 上提，回流: I2）:
+   *   维度 1（前置）: DB 任务进度（step = done/total，数值且 done<total → 未完成阻断提示）
+   *   维度 2: checklist 质量（checkAddCompleteness 未闭环 → 阻断）
+   *   互补非替代——codex 原 DB 进度分流语义上提 core，core checklist 质量语义保留。
+   */
   q4Check(plan, rounds, step, handoff, addRoute) {
+    void plan;
     void rounds;
-    const limited = this.stopPromptLimited(plan);
-    if (limited) {
-      process.stderr.write(`[ADD Stop] \u5DF2\u8FBE\u672C Plan \u5F39\u6846\u4E0A\u9650(${this.stopPromptMax()})\uFF0C\u672C\u6B21\u653E\u884C\u3002\u8BF7\u5728\u540E\u7EED\u5B9E\u65BD\u4E2D\u5B8C\u6210\u9A8C\u6536\u95ED\u73AF\uFF08devlog + handoff\uFF09\u540E\u505C\u6B62\u3002
-`);
-      return 0;
-    }
     const [donePart, totalPart] = step.split("/");
     if (/^\d+$/.test(donePart) && /^\d+$/.test(totalPart) && Number(donePart) < Number(totalPart)) {
       return this.emitQ4Unclosed(
@@ -468,73 +454,6 @@ var StopRouter = class {
     clearDevAction();
     return this.emitQ4Pass();
   }
-  // ── 弹框频控（临时方案，规则真源: hook-protocol-rules.toml [protocol.stop]）──
-  // 计数隔离: 文件级 = PROJECT_DIR md5（跨项目不互扰）；key 级 = planName（同项目跨 Plan 不互扰）
-  // 故障降级: 哨兵读/写异常 → fail-open 放行（不阻塞主流程）
-  /** 哨兵记录：同一项目同一 Plan 的弹框计数 */
-  stopPromptMax() {
-    const cfg = protocol.stop;
-    return cfg?.max_prompt_per_context ?? 3;
-  }
-  /** 哨兵窗口（毫秒） */
-  stopPromptWindowMs() {
-    const cfg = protocol.stop;
-    return (cfg?.window_minutes ?? 30) * 6e4;
-  }
-  /** 哨兵文件路径（项目隔离：PROJECT_DIR md5） */
-  stopSentinelPath() {
-    const projectDir = process.env.PROJECT_DIR || process.env.QODER_PROJECT_DIR || process.env.QODERCN_PROJECT_DIR || process.env.CLAUDE_PROJECT_DIR || process.cwd();
-    const md5 = createHash2("md5").update(projectDir).digest("hex").slice(0, 8);
-    return join2(tmpdir(), `add_stop_${md5}.json`);
-  }
-  /** 写哨兵（失败静默，fail-open） */
-  writeStopPromptSentinel(data) {
-    try {
-      writeFileSync2(this.stopSentinelPath(), JSON.stringify(data), "utf-8");
-    } catch {
-    }
-  }
-  /**
-   * 频控判定：返回 true = 已达上限应放行（不弹框）
-   * 生成态缺失 protocol.stop（TOML 未同步）→ 跳过频控保持既有行为（生成链幂等校验兜底）
-   */
-  stopPromptLimited(plan) {
-    try {
-      const stopCfg = protocol.stop;
-      if (!stopCfg) return false;
-      const max = this.stopPromptMax();
-      const windowMs = this.stopPromptWindowMs();
-      const path3 = this.stopSentinelPath();
-      let data = {};
-      if (existsSync2(path3)) {
-        try {
-          data = JSON.parse(readFileSync2(path3, "utf-8")) ?? {};
-        } catch {
-          return true;
-        }
-      }
-      const now = Date.now();
-      const entry = data[plan];
-      if (!entry) {
-        data[plan] = { count: 1, lastPromptAt: now };
-        this.writeStopPromptSentinel(data);
-        return false;
-      }
-      if (now - entry.lastPromptAt > windowMs) {
-        data[plan] = { count: 1, lastPromptAt: now };
-        this.writeStopPromptSentinel(data);
-        return false;
-      }
-      if (entry.count >= max) {
-        return true;
-      }
-      data[plan] = { count: entry.count + 1, lastPromptAt: now };
-      this.writeStopPromptSentinel(data);
-      return false;
-    } catch {
-      return true;
-    }
-  }
   /** Q0: DB 不可用（core: stderr + 2） */
   emitQ0(reason) {
     process.stderr.write(

package/templates/adapters/vscode/hooks/subagent-guard.mjs

@@ -116,10 +116,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 

package/templates/adapters/vscode/hooks/subagent-stop.mjs

@@ -116,10 +116,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 

package/templates/core/governance/doc-format-guard.ts

@@ -11,22 +11,8 @@ import { spawnSync } from "node:child_process"
 import { detectActiveAdd, localIsoSeconds } from "./common.js"
 import { writeHookEvent } from "./notify.js"
 import { doc } from "./rules.js"
-
-interface SchemaSection {
-  id?: string
-  heading?: string
-  required?: boolean
-  anchor?: string
-  within?: string
-  subsections?: Array<{ heading?: string }>
-}
-
-interface SchemaFile {
-  sections: SchemaSection[]
-  placeholders?: string[]
-  forbidden_terms?: string[]
-  groupColumn?: number | string
-}
+// 校验逻辑真源：core 校验层（Plan core-validation-lifecycle 轮 3——守卫不再内联实现）
+import { validateAgainstSchema, type SchemaFile } from "../validation/schema-validator.js"
 
 /** token 规则条目（rules.doc.token_rules 结构） */
 interface TokenRule {
@@ -161,104 +147,35 @@ export class DocFormatGuard {
 
   /** 章节/锚定/占位符/禁词校验，返回 struct 统计 */
   private runSchemaChecks(schema: SchemaFile, templateName: string, content: string, isSearchReplace: boolean): { applied: number; missed: number; anchorHit: boolean } {
-    const templatesDir = join(this.projectDir, this.magicDir, "templates")
-    let applied = 0
-    let missed = 0
-    let anchorHit = true
-
-    const headings = schema.sections.filter((s) => s.heading).map((s) => s.heading as string)
-    const requiredHeadings = schema.sections.filter((s) => s.required === true && s.heading).map((s) => s.heading as string)
-    const subs = schema.sections.flatMap((s) => s.subsections ?? []).filter((s) => s.heading).map((s) => s.heading as string)
-    const placeholders = schema.placeholders ?? []
-    const terms = schema.forbidden_terms ?? []
-
-    if (!isSearchReplace) {
-      // 锚定校验
-      for (const section of schema.sections) {
-        if (!section.anchor) continue
-        applied++
-        const templateContent = existsSync(join(templatesDir, templateName))
-          ? readFileSync(join(templatesDir, templateName), "utf-8")
-          : ""
-        const refLine = templateContent.split("\n").find((l) => l.includes(section.anchor as string))
-        if (!refLine) {
-          process.stderr.write(`[doc-format-guard] anchor_miss: schema ${section.id} 声明的 anchor '${section.anchor}' 在 ${templateName} 中未定位，跳过该规则（冒烟巡检兑底）\n`)
-          applied--
-          continue
-        }
-        const tokens = [...new Set(refLine.replace(/[#*`|(){]/g, " ").split(/\s+/).filter((t) => t !== "" && !t.includes("{")))]
-        if (tokens.length === 0) {
-          applied--
-          continue
-        }
-        let scope = content
-        if (section.within) {
-          if (content.includes(section.within)) {
-            const startIdx = content.indexOf(section.within)
-            const endIdx = content.indexOf("\n## ", startIdx + 1)
-            scope = content.slice(startIdx, endIdx === -1 ? undefined : endIdx)
-          } else {
-            process.stderr.write(`[doc-format-guard] within_miss: schema ${section.id} 的 within '${section.within}' 在文档中未定位，跳过该规则\n`)
-            applied--
-            continue
-          }
-        }
-        const missTokens = tokens.filter((tok) => !scope.includes(tok))
-        if (missTokens.length > 0) {
-          this.issues.push(`  缺锚点(${section.id}): ${missTokens.join(" ")}`)
-          missed++
-          anchorHit = false
-        }
-      }
-
-      // 必选章节
-      for (const heading of requiredHeadings) {
-        applied++
-        if (!content.includes(heading)) {
-          this.issues.push(`  缺章节: ${heading}`)
-          missed++
-        }
-      }
-      // 子章节
-      for (const sub of subs) {
-        applied++
-        if (!content.includes(sub)) {
-          this.issues.push(`  缺子章节: ${sub}`)
-          missed++
-        }
-      }
-    }
-
-    // 占位符
-    for (const ph of placeholders) {
-      if (content.includes(ph)) {
-        this.issues.push(`  未替换占位符: ${ph}`)
-        missed++
-      }
-    }
-
-    // 结构位禁词（标题行 + groupColumn）
-    let structText = (content.match(/^#{2,}\s.*$/gm) ?? []).join("\n")
-    const col = typeof schema.groupColumn === "number" ? schema.groupColumn : Number(schema.groupColumn)
-    if (!Number.isNaN(col) && col > 0) {
-      const colLines = content
-        .split("\n")
-        .map((l) => {
-          const cells = l.split("|")
-          return cells.length > col ? (cells[col + 1] ?? "").trim() : ""
-        })
-        .filter(Boolean)
-      structText += "\n" + colLines.join("\n")
-    }
-    for (const term of terms) {
-      applied++
-      if (structText.includes(term)) {
-        this.issues.push(`  结构位禁词: ${term}`)
-        missed++
-      }
+    // ★ 校验真源 = core 校验层（Plan core-validation-lifecycle 轮 3：删除内联实现）
+    //   SearchReplace 只传 patch → 标题/锚定类规则不适用，仅保留占位符与结构位禁词
+    const templatePath = join(this.projectDir, this.magicDir, "templates", templateName)
+    const templateContent = existsSync(templatePath) ? readFileSync(templatePath, "utf-8") : ""
+    const all = validateAgainstSchema(content, schema, { templateContent })
+    const relevant = isSearchReplace
+      ? all.filter((i) => i.code === "PLACEHOLDER_LEFT" || i.code === "FORBIDDEN_TERM")
+      : all
+
+    for (const i of relevant) this.issues.push(`  ${i.detail}`)
+
+    const missed = relevant.length
+    const declared = this.countDeclaredRules(schema, isSearchReplace)
+    return {
+      applied: Math.max(missed, declared),
+      missed,
+      anchorHit: !relevant.some((i) => i.code === "ANCHOR_MISS"),
     }
+  }
 
-    return { applied, missed, anchorHit }
+  /** 已声明规则数（用于 struct_score 分母；口径与原内联实现一致：按规则条数计） */
+  private countDeclaredRules(schema: SchemaFile, isSearchReplace: boolean): number {
+    const placeholders = (schema.placeholders ?? []).length
+    const terms = (schema.forbidden_terms ?? []).length
+    if (isSearchReplace) return placeholders + terms
+    const anchors = schema.sections.filter((s) => s.anchor).length
+    const required = schema.sections.filter((s) => s.required === true && s.heading).length
+    const subs = schema.sections.flatMap((s) => s.subsections ?? []).filter((s) => s.heading).length
+    return anchors + required + subs + placeholders + terms
   }
 
   /** 算法化规则校验（真源: [doc.anti_cheat] + HITL 表非空 + handoff 冲突）

package/templates/core/governance/post-tool-router.ts

@@ -3,10 +3,12 @@
 //
 // 设计范式: OOP 路由类（§1 DPS 哨兵自动化 / §2 Edit·Write 守卫 / §3 Bash 增强）。
 
-import { existsSync, readFileSync, readdirSync, writeFileSync } from "node:fs"
+import { existsSync, mkdirSync, readFileSync, readdirSync, appendFileSync, writeFileSync } from "node:fs"
 import { join, basename, dirname } from "node:path"
 import { jsonGet } from "./common.js"
 import { AuditBridge } from "./audit-bridge.js"
+import { evidenceEnabled, EVIDENCE_QUEUE_FILE, MEMORY_DIR_NAME, recallMode } from "../scripts/mcp-server/shared/memory/switches.js"
+import { buildEvidenceEvent, classifyEvidenceSource } from "../scripts/mcp-server/shared/memory/jobs/evidence-collector.js"
 
 /** 纯函数：从 input 中提取 output/content 拼接文本（对齐 bash grep -o 组合） */
 function extractOutputText(raw: string): string {
@@ -165,6 +167,9 @@ export class PostToolRouter {
 
       // §2f: 审计桥接（Task 8.1，ADD-7 自动化）——文件写入事件 → jsonl → MCP 常驻消费落库
       this.emitWriteEvent(filePath)
+
+      // §2g: Memory 采证入队（白名单 → evidence-queue.jsonl → consolidation 异步落库）
+      this.emitMemoryEvidence(filePath)
     } else if (toolName === "Bash") {
       // ═══════════════ §3: Bash matcher: 结果增强（扩展点: codex 文本）═══════════════
       this.emitLine(this.emitBashDone())
@@ -200,6 +205,33 @@ export class PostToolRouter {
     this.auditBridge.emit(filePath)
   }
 
+  /**
+   * §2g Memory 采证入队（Spec §10 PostToolUse 白名单，扩展点）:
+   *   白名单路径（plans/specs/reviews/handoff）→ 追加 evidence-queue.jsonl（幂等 dedupKey），
+   *   由 consolidation job 异步落库。ADD_MEMORY_EVIDENCE=off 或 RECALL_MODE=off 时关闭。
+   *   fail-open：任何异常不阻断文件写入主路径（Plan §9.3）。
+   */
+  protected emitMemoryEvidence(filePath: string): void {
+    try {
+      if (!evidenceEnabled() || recallMode() === "off") return
+      if (!classifyEvidenceSource(filePath)) return
+      if (!this.magicDir) return
+      let excerpt = ""
+      try {
+        excerpt = readFileSync(filePath, "utf-8").slice(0, 500)
+      } catch {
+        excerpt = basename(filePath)
+      }
+      const ev = buildEvidenceEvent(filePath, excerpt)
+      const dir = join(this.projectDir, this.magicDir, MEMORY_DIR_NAME)
+      mkdirSync(dir, { recursive: true })
+      appendFileSync(join(dir, EVIDENCE_QUEUE_FILE), JSON.stringify(ev) + "\n", "utf-8")
+      this.emitLine(`[ADD PostToolUse] 🧠 记忆采证入队: ${filePath}（consolidation 时落库）\n`)
+    } catch {
+      /* fail-open */
+    }
+  }
+
   /** §3 Bash 增强（core: lint/tsc；codex 子类: lint/typecheck/test） */
   protected emitBashDone(): string {
     return "[ADD PostToolUse] 命令执行完成。如有 lint/tsc 错误请修复。\n"

package/templates/core/governance/prompt-router.ts

@@ -17,6 +17,14 @@ import {
 import { loadDevKeywords, matchTrigger } from "./vocabulary.js"
 import { writeHookEvent } from "./notify.js"
 import { event } from "./rules.js"
+import { recallMode } from "../scripts/mcp-server/shared/memory/switches.js"
+import {
+  buildStageRecallHint,
+  detectRecallStage,
+} from "../scripts/mcp-server/shared/memory/metrics/stage-words.js"
+
+/** 显式记忆回忆意图触发词（Plan §9.1：对话触发词仅作补充入口；vocabulary 文档类别 G 同步维护） */
+const MEMORY_RECALL_HINT_RE = /之前|上次|还记得|记得吗|为什么当时|类似问题|历史决策|以前的方案|曾经怎么/i
 
 /**
  * UserPromptSubmit 触发词路由基类（模板方法）:
@@ -108,6 +116,41 @@ export class PromptRouter {
     // core 协议: 无前置注入
   }
 
+  /**
+   * 显式记忆回忆提示（Spec §10 / Plan §9.1 补充入口）:
+   * 命中回忆词且 ADD_MEMORY_RECALL_MODE != off → 提示调用 recall_memory。
+   * 不做自动召回（同步 Hook ≤200ms 无 DB）；shadow 模式下提示语明示"仅显式调用"。
+   */
+  protected maybeMemoryHint(prompt: string): void {
+    try {
+      if (recallMode() === "off") return
+      if (!MEMORY_RECALL_HINT_RE.test(prompt)) return
+      const mode = recallMode()
+      const suffix = mode === "shadow" ? "（当前 shadow 模式：召回将落审计，Hook 不自动注入）" : ""
+      process.stdout.write(
+        `[Memory] 检测到历史回忆意图${suffix}。可调用 recall_memory({ query: <你的问题>, stage: "prompt" }) 获取受治理的记忆上下文（含来源与评分）。\n`
+      )
+    } catch {
+      /* fail-open */
+    }
+  }
+
+  /**
+   * 阶段确定性召回提示（Spec §2 §DeterministicRecall，Plan §3.1 方案 B1 的 Hook 侧）:
+   * 命中 ADD 阶段词 → 提示到工具侧做确定性召回（plan-start/spec-start/dps/rahs/handoff）。
+   * Hook 同步路径无 DB：只输出提示文本，不召回、不写审计；任何异常 fail-open。
+   */
+  protected maybeStageHint(prompt: string): void {
+    try {
+      const stage = detectRecallStage(prompt)
+      if (!stage) return
+      const hint = buildStageRecallHint(stage, recallMode())
+      if (hint) process.stdout.write(hint)
+    } catch {
+      /* fail-open */
+    }
+  }
+
   /** Layer 3 输出形态（core: 纯文本逐行；qoder: hookSpecificOutput JSON 包） */
   protected layer3Json(): boolean {
     return false
@@ -148,6 +191,10 @@ export class PromptRouter {
       return 0
     }
 
+    // ─── Layer 1.5: 显式记忆回忆意图（补充入口；不替代确定性召回，见 Plan §9.1）───
+    this.maybeMemoryHint(prompt)
+    this.maybeStageHint(prompt)
+
     // ─── 开发关键词检测（动态加载） ───
     const devKw = loadDevKeywords()
     if (devKw.length === 0) return 0

package/templates/core/governance/rules.ts

@@ -715,10 +715,6 @@ export const protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 } as const;
 // ── GENERATED END ──