add-coder 0.3.34 → 0.3.35

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

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

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

@@ -144,10 +144,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -278,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
@@ -343,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*"([^"]*)"/);
@@ -473,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 {
@@ -500,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/pre-compact.mjs

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

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

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

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

@@ -145,10 +145,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -447,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) {
@@ -510,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;
@@ -541,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/review-checklist.mjs

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

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

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

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

@@ -121,10 +121,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -483,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;
@@ -503,6 +525,7 @@ var SessionStartGuard = class {
     this.emitIndex();
     this.emitTodoReminder(state);
     this.emitHitlPending();
+    this.emitMemoryL1();
     return 0;
   }
   // ─────────────────────────── 扩展点 ───────────────────────────
@@ -551,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

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

@@ -192,10 +192,6 @@ var protocol = {
       ".trae",
       ".codex"
     ]
-  },
-  "stop": {
-    "max_prompt_per_context": 3,
-    "window_minutes": 30
   }
 };
 
@@ -410,10 +406,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() {
@@ -442,20 +434,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(
@@ -472,73 +458,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/qoder/hooks/subagent-guard.mjs

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

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

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