add-coder 0.3.33 → 0.3.35

package/templates/adapters/qoder/hooks/doc-format-guard.mjs

@@ -496,6 +496,156 @@ function writeHookEvent(hook, decision, cmd, reason, plan = "unknown", status =
   appendFileSync(file, line);
 }
 
+// templates/core/validation/schema-validator.ts
+function countOccurrences(haystack, needle) {
+  if (!needle) return 0;
+  const h = normalizeWidth(haystack);
+  const n = normalizeWidth(needle);
+  let count = 0;
+  let idx = h.indexOf(n);
+  while (idx !== -1) {
+    count++;
+    idx = h.indexOf(n, idx + n.length);
+  }
+  return count;
+}
+var FULLWIDTH_START = 65281;
+var FULLWIDTH_END = 65374;
+var FULLWIDTH_TO_HALF = 65248;
+var WIDTH_FOLD_EXTRA = { "\u3000": " " };
+function normalizeWidth(text) {
+  let out = "";
+  for (const ch of text) {
+    const code = ch.codePointAt(0);
+    if (code >= FULLWIDTH_START && code <= FULLWIDTH_END) {
+      out += String.fromCharCode(code - FULLWIDTH_TO_HALF);
+    } else {
+      out += WIDTH_FOLD_EXTRA[ch] ?? ch;
+    }
+  }
+  return out;
+}
+function stripFencedBlocks(content) {
+  return content.replace(/```[\s\S]*?```/g, "\n");
+}
+function structText(content, groupColumn) {
+  let text = (content.match(/^#{2,}\s.*$/gm) ?? []).join("\n");
+  const col = typeof groupColumn === "number" ? groupColumn : Number(groupColumn);
+  if (Number.isFinite(col) && col > 0) {
+    const cells = content.split("\n").map((line) => {
+      const cells2 = line.split("|");
+      return cells2.length > col ? (cells2[col + 1] ?? "").trim() : "";
+    }).filter(Boolean);
+    text += "\n" + cells.join("\n");
+  }
+  return text;
+}
+function validateAnchors(content, schema, templateContent) {
+  const issues = [];
+  const nContent = normalizeWidth(content);
+  for (const section of schema.sections) {
+    if (!section.anchor) continue;
+    const refAnchor = normalizeWidth(section.anchor);
+    const refLine = templateContent.split("\n").find((l) => normalizeWidth(l).includes(refAnchor));
+    if (!refLine) continue;
+    const tokens = [
+      ...new Set(
+        normalizeWidth(refLine).replace(/[#*`|(){]/g, " ").split(/\s+/).filter((t) => t !== "" && !t.includes("{"))
+      )
+    ];
+    if (tokens.length === 0) continue;
+    let scope = nContent;
+    if (section.within) {
+      const startIdx = nContent.indexOf(normalizeWidth(section.within));
+      if (startIdx < 0) continue;
+      const endIdx = nContent.indexOf("\n## ", startIdx + 1);
+      scope = nContent.slice(startIdx, endIdx === -1 ? void 0 : endIdx);
+    }
+    const missTokens = tokens.filter((tok) => !scope.includes(tok));
+    if (missTokens.length > 0) {
+      issues.push({
+        code: "ANCHOR_MISS",
+        detail: `\u7F3A\u951A\u70B9(${section.id}): ${missTokens.join(" ")}`,
+        expected: section.anchor
+      });
+    }
+  }
+  return issues;
+}
+function inferRoundHeading(schema) {
+  const round = schema.sections.find((s) => s.heading?.includes("<\u7B2CN\u8F6E>"));
+  return round?.heading ?? null;
+}
+function countRounds(content, roundHeading) {
+  const heading = normalizeWidth(roundHeading);
+  if (!heading.includes("<\u7B2CN\u8F6E>")) return 0;
+  const pattern = heading.replace(/[.*+?^${}()|[\]\\]/g, "\\$&").replace("<\u7B2CN\u8F6E>", "\u7B2C\\s*\\d+\\s*\u8F6E");
+  const re = new RegExp(`^${pattern}`, "gm");
+  return (normalizeWidth(content).match(re) ?? []).length;
+}
+function validateAgainstSchema(content, schema, opts = {}) {
+  const issues = [];
+  const proseOnly = stripFencedBlocks(content);
+  const contentNormalized = normalizeWidth(content);
+  const roundHeading = opts.roundHeading ?? inferRoundHeading(schema);
+  for (const section of schema.sections) {
+    if (!section.heading) continue;
+    const isRoundSection = roundHeading !== null && section.heading === roundHeading;
+    if (isRoundSection) {
+      const need = opts.expectRounds ?? 1;
+      const found = countRounds(content, roundHeading);
+      if (found < need) {
+        issues.push({
+          code: "ROUND_COUNT_SHORT",
+          detail: `\u8F6E\u6B21\u7AE0\u8282\u4E0D\u8DB3\uFF1A\u671F\u671B ${need} \u8F6E\uFF0C\u5B9E\u9645 ${found} \u8F6E`,
+          expected: roundHeading
+        });
+      }
+      for (const sub of section.subsections ?? []) {
+        if (countOccurrences(content, sub.heading) < need) {
+          issues.push({
+            code: "MISSING_SUBSECTION",
+            detail: `\u8F6E\u6B21\u5B50\u7AE0\u8282\u7F3A\u5931\u6216\u4E0D\u8DB3\uFF08\u9700\u8981 ${need} \u4EFD\uFF09\uFF1A${sub.heading}`,
+            expected: sub.heading
+          });
+        }
+      }
+      continue;
+    }
+    if (section.required && countOccurrences(content, section.heading) === 0) {
+      issues.push({ code: "MISSING_SECTION", detail: `\u7F3A\u5C11\u5FC5\u9700\u7AE0\u8282\uFF1A${section.heading}`, expected: section.heading });
+    }
+    for (const sub of section.subsections ?? []) {
+      const need = isRoundSection ? opts.expectRounds ?? 1 : 1;
+      if (countOccurrences(content, sub.heading) < need) {
+        issues.push({
+          code: "MISSING_SUBSECTION",
+          detail: `\u5B50\u7AE0\u8282\u7F3A\u5931\u6216\u4E0D\u8DB3\uFF08\u9700\u8981 ${need} \u4EFD\uFF09\uFF1A${sub.heading}`,
+          expected: sub.heading
+        });
+      }
+    }
+  }
+  for (const ph of schema.placeholders ?? []) {
+    if (!ph) continue;
+    const nPh = normalizeWidth(ph);
+    const idx = contentNormalized.indexOf(nPh);
+    if (idx === -1) continue;
+    const hit = nPh === ph ? ph : `${content.slice(idx, idx + nPh.length)}\uFF08\u5BBD\u5EA6\u7B49\u4EF7\u4E8E ${ph}\uFF09`;
+    issues.push({ code: "PLACEHOLDER_LEFT", detail: `\u5360\u4F4D\u7B26\u672A\u66FF\u6362\uFF1A${hit}`, expected: ph });
+  }
+  const struct = normalizeWidth(structText(content, schema.groupColumn));
+  for (const term of schema.forbidden_terms ?? []) {
+    if (term && struct.includes(normalizeWidth(term))) {
+      issues.push({ code: "FORBIDDEN_TERM", detail: `\u7ED3\u6784\u4F4D\u7981\u8BCD\uFF1A${term}\uFF08\u4EC5\u6807\u9898\u884C\u4E0E\u6307\u5B9A\u5217\u5224\u5B9A\uFF09`, expected: term });
+    }
+  }
+  if (opts.templateContent) {
+    issues.push(...validateAnchors(content, schema, opts.templateContent));
+  }
+  return issues;
+}
+
 // templates/core/governance/doc-format-guard.ts
 function extractContent(input) {
   const ti = input.tool_input;
@@ -591,90 +741,28 @@ var DocFormatGuard = class {
   }
   /** 章节/锚定/占位符/禁词校验，返回 struct 统计 */
   runSchemaChecks(schema, templateName, content, isSearchReplace) {
-    const templatesDir = join3(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);
-    const requiredHeadings = schema.sections.filter((s) => s.required === true && s.heading).map((s) => s.heading);
-    const subs = schema.sections.flatMap((s) => s.subsections ?? []).filter((s) => s.heading).map((s) => s.heading);
-    const placeholders = schema.placeholders ?? [];
-    const terms = schema.forbidden_terms ?? [];
-    if (!isSearchReplace) {
-      for (const section of schema.sections) {
-        if (!section.anchor) continue;
-        applied++;
-        const templateContent = existsSync3(join3(templatesDir, templateName)) ? readFileSync2(join3(templatesDir, templateName), "utf-8") : "";
-        const refLine = templateContent.split("\n").find((l) => l.includes(section.anchor));
-        if (!refLine) {
-          process.stderr.write(`[doc-format-guard] anchor_miss: schema ${section.id} \u58F0\u660E\u7684 anchor '${section.anchor}' \u5728 ${templateName} \u4E2D\u672A\u5B9A\u4F4D\uFF0C\u8DF3\u8FC7\u8BE5\u89C4\u5219\uFF08\u5192\u70DF\u5DE1\u68C0\u5151\u5E95\uFF09
-`);
-          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 ? void 0 : endIdx);
-          } else {
-            process.stderr.write(`[doc-format-guard] within_miss: schema ${section.id} \u7684 within '${section.within}' \u5728\u6587\u6863\u4E2D\u672A\u5B9A\u4F4D\uFF0C\u8DF3\u8FC7\u8BE5\u89C4\u5219
-`);
-            applied--;
-            continue;
-          }
-        }
-        const missTokens = tokens.filter((tok) => !scope.includes(tok));
-        if (missTokens.length > 0) {
-          this.issues.push(`  \u7F3A\u951A\u70B9(${section.id}): ${missTokens.join(" ")}`);
-          missed++;
-          anchorHit = false;
-        }
-      }
-      for (const heading of requiredHeadings) {
-        applied++;
-        if (!content.includes(heading)) {
-          this.issues.push(`  \u7F3A\u7AE0\u8282: ${heading}`);
-          missed++;
-        }
-      }
-      for (const sub of subs) {
-        applied++;
-        if (!content.includes(sub)) {
-          this.issues.push(`  \u7F3A\u5B50\u7AE0\u8282: ${sub}`);
-          missed++;
-        }
-      }
-    }
-    for (const ph of placeholders) {
-      if (content.includes(ph)) {
-        this.issues.push(`  \u672A\u66FF\u6362\u5360\u4F4D\u7B26: ${ph}`);
-        missed++;
-      }
-    }
-    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(`  \u7ED3\u6784\u4F4D\u7981\u8BCD: ${term}`);
-        missed++;
-      }
-    }
-    return { applied, missed, anchorHit };
+    const templatePath = join3(this.projectDir, this.magicDir, "templates", templateName);
+    const templateContent = existsSync3(templatePath) ? readFileSync2(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")
+    };
+  }
+  /** 已声明规则数（用于 struct_score 分母；口径与原内联实现一致：按规则条数计） */
+  countDeclaredRules(schema, isSearchReplace) {
+    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 冲突）
    *  protected: adapter 子类可 override（如 claude 版无算法规则段） */

package/templates/adapters/qoder/hooks/post-tool-use.mjs

@@ -274,7 +274,7 @@ function projectHash() {
 var DEV_FLAG = `/tmp/add_dev_${projectHash()}`;
 
 // templates/core/governance/post-tool-router.ts
-import { existsSync as existsSync3, readFileSync as readFileSync2, readdirSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync2, readdirSync, appendFileSync as appendFileSync2, writeFileSync as writeFileSync2 } from "node:fs";
 import { join as join3, basename as basename2, dirname as dirname2 } from "node:path";
 
 // templates/core/governance/notify.ts
@@ -339,6 +339,37 @@ var AuditBridge = class {
   }
 };
 
+// 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 evidenceEnabled(env = process.env) {
+  return (env.ADD_MEMORY_EVIDENCE ?? "on").toLowerCase() !== "off";
+}
+var MEMORY_DIR_NAME = "memory";
+var EVIDENCE_QUEUE_FILE = "evidence-queue.jsonl";
+var L1_SNAPSHOT_TTL_MS = 7 * 24 * 60 * 60 * 1e3;
+
+// templates/core/scripts/mcp-server/shared/memory/jobs/evidence-collector.ts
+import { createHash as createHash2 } from "node:crypto";
+function classifyEvidenceSource(filePath) {
+  const p = filePath.replace(/\\/g, "/");
+  if (/(^|\/)plans\/[^/]*-plan-v\d+\.md$/.test(p)) return "PLAN";
+  if (/(^|\/)plans\/[^/]*-add-route-v\d+\.md$/.test(p)) return "PLAN";
+  if (/(^|\/)specs\/.+\.md$/.test(p)) return "SPEC";
+  if (/handoff[^/]*\.md$/i.test(p)) return "HANDOFF";
+  if (/(^|\/)reviews\/.+\.md$/.test(p)) return "DEV_OPERATION";
+  return null;
+}
+function buildEvidenceEvent(filePath, excerpt, occurredAt = /* @__PURE__ */ new Date()) {
+  const sourceType = classifyEvidenceSource(filePath);
+  if (!sourceType) throw new Error(`\u975E\u767D\u540D\u5355\u8DEF\u5F84: ${filePath}`);
+  const sourceRef = filePath;
+  const dedupKey = createHash2("sha256").update(`${sourceType}|${sourceRef}|${excerpt}`, "utf8").digest("hex").slice(0, 32);
+  return { dedupKey, sourceType, sourceRef, excerpt: excerpt.slice(0, 500), occurredAt: occurredAt.toISOString() };
+}
+
 // templates/core/governance/post-tool-router.ts
 function extractOutputText(raw) {
   const m1 = raw.match(/"output"\s*:\s*"([^"]*)"/);
@@ -469,6 +500,7 @@ var PostToolRouter = class {
       this.postDocSections(filePath);
       this.emitLine(this.emitAuditReminder(filePath));
       this.emitWriteEvent(filePath);
+      this.emitMemoryEvidence(filePath);
     } else if (toolName2 === "Bash") {
       this.emitLine(this.emitBashDone());
     } else {
@@ -496,6 +528,32 @@ var PostToolRouter = class {
   emitWriteEvent(filePath) {
     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）。
+   */
+  emitMemoryEvidence(filePath) {
+    try {
+      if (!evidenceEnabled() || recallMode() === "off") return;
+      if (!classifyEvidenceSource(filePath)) return;
+      if (!this.magicDir) return;
+      let excerpt = "";
+      try {
+        excerpt = readFileSync2(filePath, "utf-8").slice(0, 500);
+      } catch {
+        excerpt = basename2(filePath);
+      }
+      const ev = buildEvidenceEvent(filePath, excerpt);
+      const dir = join3(this.projectDir, this.magicDir, MEMORY_DIR_NAME);
+      mkdirSync2(dir, { recursive: true });
+      appendFileSync2(join3(dir, EVIDENCE_QUEUE_FILE), JSON.stringify(ev) + "\n", "utf-8");
+      this.emitLine(`[ADD PostToolUse] \u{1F9E0} \u8BB0\u5FC6\u91C7\u8BC1\u5165\u961F: ${filePath}\uFF08consolidation \u65F6\u843D\u5E93\uFF09
+`);
+    } catch {
+    }
+  }
   /** §3 Bash 增强（core: lint/tsc；codex 子类: lint/typecheck/test） */
   emitBashDone() {
     return "[ADD PostToolUse] \u547D\u4EE4\u6267\u884C\u5B8C\u6210\u3002\u5982\u6709 lint/tsc \u9519\u8BEF\u8BF7\u4FEE\u590D\u3002\n";

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

@@ -443,7 +443,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) {
@@ -506,6 +544,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;
@@ -537,6 +607,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/qoder/hooks/session-start.mjs

@@ -479,8 +479,34 @@ var PreloadTemplates = class _PreloadTemplates {
 };
 
 // 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/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;
   magicDir;
@@ -499,6 +525,7 @@ var SessionStartGuard = class {
     this.emitIndex();
     this.emitTodoReminder(state);
     this.emitHitlPending();
+    this.emitMemoryL1();
     return 0;
   }
   // ─────────────────────────── 扩展点 ───────────────────────────
@@ -547,6 +574,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/qoder/hooks/lib/qoder-env.ts