@riconext/hermes-repo 1.2.0 → 1.2.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.2.2
+
+### Patch Changes
+
+- a8aff7f: 记录 flush 执行过程到 debug 日志，并在写入 MEMORY.md 前校验知识文件链接是否真实存在。
+
+## 1.2.1
+
+### Patch Changes
+
+- be5381b: 修复 ESM 打包产物中 `flush` 触发动态 require 导致 `Dynamic require of "fs" is not supported` 的问题。
+
 ## 1.2.0
 
 ### Minor Changes

package/dist/cli.js

@@ -1,10 +1,4 @@
 #!/usr/bin/env node
-var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
-  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
-}) : x)(function(x) {
-  if (typeof require !== "undefined") return require.apply(this, arguments);
-  throw Error('Dynamic require of "' + x + '" is not supported');
-});
 
 // src/cli.ts
 import { Command } from "commander";
@@ -1541,8 +1535,15 @@ function isSkippedEntry(raw) {
 }
 
 // src/consolidate/writeKnowledge.ts
-import { existsSync as existsSync7, mkdirSync as mkdirSync5, writeFileSync as writeFileSync5 } from "fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync5, readFileSync as readFileSync10, writeFileSync as writeFileSync5 } from "fs";
 import { dirname as dirname4 } from "path";
+var KNOWLEDGE_LINK_PREFIXES = [
+  "rules/",
+  "domains/",
+  "workflows/",
+  "decisions/",
+  "incidents/"
+];
 function writeKnowledgeFiles(repoRoot, files) {
   const result = {
     created: [],
@@ -1576,7 +1577,7 @@ function writeKnowledgeFiles(repoRoot, files) {
 function writeMemoryMd(repoRoot, memoryMd) {
   const memoryPathAbs = memoryPath(repoRoot, "MEMORY.md");
   if (existsSync7(memoryPathAbs)) {
-    const existing = __require("fs").readFileSync(memoryPathAbs, "utf8");
+    const existing = readFileSync10(memoryPathAbs, "utf8");
     const preserved = extractUserEditedSections(existing);
     if (preserved.length > 0) {
       memoryMd = injectUserSections(memoryMd, preserved);
@@ -1586,6 +1587,38 @@ function writeMemoryMd(repoRoot, memoryMd) {
   writeFileSync5(memoryPathAbs, `${memoryMd}
 `, "utf8");
 }
+function assertMemoryKnowledgeLinksExist(repoRoot, memoryMd) {
+  const missing = findMissingKnowledgeLinks(repoRoot, memoryMd);
+  if (missing.length > 0) {
+    throw new Error(
+      `MEMORY.md \u5F15\u7528\u4E86\u4E0D\u5B58\u5728\u7684\u77E5\u8BC6\u6587\u4EF6: ${missing.join(", ")}`
+    );
+  }
+}
+function findMissingKnowledgeLinks(repoRoot, memoryMd) {
+  const links = extractKnowledgeLinks(memoryMd);
+  return links.filter((link) => !existsSync7(memoryPath(repoRoot, link)));
+}
+function extractKnowledgeLinks(memoryMd) {
+  const links = /* @__PURE__ */ new Set();
+  const markdownLink = /\[[^\]]+\]\(([^)]+)\)/g;
+  let match;
+  while ((match = markdownLink.exec(memoryMd)) !== null) {
+    const normalized = normalizeKnowledgeLink(match[1]);
+    if (normalized) {
+      links.add(normalized);
+    }
+  }
+  return [...links];
+}
+function normalizeKnowledgeLink(rawLink) {
+  const withoutAnchor = rawLink.split("#")[0].trim();
+  const withoutDotSlash = withoutAnchor.startsWith("./") ? withoutAnchor.slice(2) : withoutAnchor;
+  if (withoutDotSlash.includes("://") || withoutDotSlash.startsWith("/") || withoutDotSlash.includes("..") || !withoutDotSlash.endsWith(".md")) {
+    return null;
+  }
+  return KNOWLEDGE_LINK_PREFIXES.some((prefix) => withoutDotSlash.startsWith(prefix)) ? withoutDotSlash : null;
+}
 function serializeKnowledgeFile(frontmatter, body) {
   const lines = ["---"];
   const fieldOrder = ["title", "domain", "type", "status", "confidence", "lastReviewed"];
@@ -1672,10 +1705,17 @@ function archiveDoneSessions(repoRoot, sessions, autoArchiveDays = 30) {
 // src/consolidate/runConsolidate.ts
 async function runConsolidate(opts) {
   const { repoRoot, config, force, dryRun, debug } = opts;
+  debugLog(
+    debug === true,
+    "consolidate",
+    `start: force=${force === true}, dryRun=${dryRun === true}`
+  );
   writeConsolidateLock(repoRoot);
+  debugLog(debug === true, "consolidate", "lock acquired");
   try {
     const llmConfig = config.llm;
     if (!llmConfig.enabled) {
+      debugLog(debug === true, "consolidate", "skip: llm not enabled");
       return {
         ran: false,
         reason: "llm-not-enabled",
@@ -1694,6 +1734,7 @@ async function runConsolidate(opts) {
       `\u626B\u63CF\u5230 ${allSessions.length} \u4E2A session\uFF0C\u5176\u4E2D ${pendingSessions.length} \u4E2A\u5F85\u5904\u7406`
     );
     if (pendingSessions.length === 0 && !force) {
+      debugLog(debug === true, "consolidate", "skip: no pending sessions");
       return {
         ran: false,
         reason: "no-pending-sessions",
@@ -1705,6 +1746,11 @@ async function runConsolidate(opts) {
       };
     }
     if (dryRun) {
+      debugLog(
+        debug === true,
+        "consolidate",
+        `dry-run: would process ${pendingSessions.length} session(s)`
+      );
       return {
         ran: true,
         reason: "dry-run",
@@ -1716,7 +1762,11 @@ async function runConsolidate(opts) {
       };
     }
     const llmInput = buildLlmConsolidateInput(repoRoot, pendingSessions);
-    debugLog(debug === true, "consolidate", `LLM \u8F93\u5165: ${llmInput.pendingSessions.length} sessions, ${llmInput.existingKnowledge.length} existing knowledge`);
+    debugLog(
+      debug === true,
+      "consolidate",
+      `LLM \u8F93\u5165: ${llmInput.pendingSessions.length} sessions, ${llmInput.existingKnowledge.length} existing knowledge`
+    );
     let llmResult;
     try {
       llmResult = await callLlmConsolidate(llmInput, llmConfig);
@@ -1729,8 +1779,33 @@ async function runConsolidate(opts) {
       "consolidate",
       `LLM \u8FD4\u56DE: ${llmResult.knowledgeFiles.length} knowledge files, ${llmResult.skippedSessions.length} skipped`
     );
+    debugLog(debug === true, "consolidate", "writing knowledge files");
     const writeResult = writeKnowledgeFiles(repoRoot, llmResult.knowledgeFiles);
+    if (writeResult.failed.length > 0) {
+      debugLog(
+        debug === true,
+        "consolidate",
+        `write failed: ${writeResult.failed.join(", ")}`
+      );
+      throw new Error(
+        `\u77E5\u8BC6\u6587\u4EF6\u5199\u5165\u5931\u8D25: ${writeResult.failed.join(", ")}`
+      );
+    }
+    debugLog(
+      debug === true,
+      "consolidate",
+      `knowledge files written: created=${writeResult.created.length}, updated=${writeResult.updated.length}`
+    );
+    debugLog(debug === true, "consolidate", "validating MEMORY.md links");
+    assertMemoryKnowledgeLinksExist(repoRoot, llmResult.memoryMd);
+    debugLog(debug === true, "consolidate", "MEMORY.md links ok");
+    debugLog(debug === true, "consolidate", "writing MEMORY.md");
     writeMemoryMd(repoRoot, llmResult.memoryMd);
+    debugLog(
+      debug === true,
+      "consolidate",
+      `marking sessions done: ${pendingSessions.length} processed, ${llmResult.skippedSessions.length} skipped`
+    );
     const processedSessionIds = /* @__PURE__ */ new Set();
     for (const s of pendingSessions) {
       markSessionConsolidated(repoRoot, s.sessionId);
@@ -1742,6 +1817,7 @@ async function runConsolidate(opts) {
     }
     const prevState = readConsolidateState(repoRoot);
     const newDomains = extractDomainsFromResults(llmResult.knowledgeFiles);
+    debugLog(debug === true, "consolidate", "updating consolidate state");
     writeConsolidateState(repoRoot, {
       version: 2,
       lastConsolidatedAt: (/* @__PURE__ */ new Date()).toISOString(),
@@ -1765,6 +1841,12 @@ async function runConsolidate(opts) {
       allSessions,
       config.consolidate.autoArchiveDays
     );
+    debugLog(debug === true, "consolidate", `archived sessions: ${archived}`);
+    debugLog(
+      debug === true,
+      "consolidate",
+      `done: sessions=${pendingSessions.length}, created=${writeResult.created.length}, updated=${writeResult.updated.length}, skipped=${llmResult.skippedSessions.length}, archived=${archived}`
+    );
     return {
       ran: true,
       sessionsProcessed: pendingSessions.length,
@@ -1775,6 +1857,7 @@ async function runConsolidate(opts) {
     };
   } finally {
     releaseConsolidateLock(repoRoot);
+    debugLog(debug === true, "consolidate", "lock released");
   }
 }
 function extractDomainsFromResults(files) {
@@ -1976,7 +2059,7 @@ async function commitCapture(opts) {
 }
 
 // src/capture/claude-code/resolveSession.ts
-import { existsSync as existsSync9, readdirSync as readdirSync4, readFileSync as readFileSync11, statSync } from "fs";
+import { existsSync as existsSync9, readdirSync as readdirSync4, readFileSync as readFileSync12, statSync } from "fs";
 import { homedir } from "os";
 import { basename as basename2, join as join12, resolve as resolve3 } from "path";
 function encodeClaudeProjectDir(absPath) {
@@ -2427,12 +2510,25 @@ function runCaptureCommand(opts) {
 
 // src/commands/flush.ts
 async function runFlushCommandCli(opts) {
+  const ctx = loadRepoContext(opts.cwd);
+  const debug = ctx?.config.debug === true;
+  configureDebugLogging(ctx?.repoRoot ?? null, debug);
+  debugLog(
+    debug,
+    "flush",
+    `start: force=${opts.force === true}, dryRun=${opts.dryRun === true}`
+  );
   try {
     const result = await runFlushCommand({
       cwd: opts.cwd,
       force: opts.force,
       dryRun: opts.dryRun
     });
+    debugLog(
+      debug,
+      "flush",
+      `result: ran=${result.ran}, reason=${result.reason ?? "ok"}, sessions=${result.sessionsProcessed}, created=${result.knowledgeCreated}, updated=${result.knowledgeUpdated}, skipped=${result.skippedCount}, archived=${result.archived}`
+    );
     if (result.ran) {
       if (result.reason === "dry-run") {
         console.error(
@@ -2472,6 +2568,11 @@ async function runFlushCommandCli(opts) {
     }
     hookExit(0, opts.strict);
   } catch (err) {
+    debugLog(
+      debug,
+      "flush",
+      `error: ${err instanceof Error ? err.message : String(err)}`
+    );
     console.error(
       `hermes-repo flush: ${err instanceof Error ? err.message : String(err)}`
     );
@@ -2480,7 +2581,7 @@ async function runFlushCommandCli(opts) {
 }
 
 // src/inject/runInject.ts
-import { existsSync as existsSync12, readdirSync as readdirSync7, readFileSync as readFileSync12 } from "fs";
+import { existsSync as existsSync12, readdirSync as readdirSync7, readFileSync as readFileSync13 } from "fs";
 import { join as join15 } from "path";
 
 // src/inject/constants.ts
@@ -2543,7 +2644,7 @@ function readMemoryMd(repoRoot) {
   const path = memoryPathOnDisk(repoRoot);
   if (!existsSync12(path)) return null;
   try {
-    const content = readFileSync12(path, "utf8");
+    const content = readFileSync13(path, "utf8");
     return content.trim() || null;
   } catch {
     return null;
@@ -2562,7 +2663,7 @@ function readAllRules(repoRoot) {
   for (const file of files) {
     try {
       const filePath = join15(rulesDir, file);
-      const content = readFileSync12(filePath, "utf8").trim();
+      const content = readFileSync13(filePath, "utf8").trim();
       if (!content) continue;
       parts.push(`### ${file}`, "", content, "");
     } catch {
@@ -2592,23 +2693,23 @@ import { mkdirSync as mkdirSync7, writeFileSync as writeFileSync6 } from "fs";
 import { join as join19 } from "path";
 
 // src/init/mergeClaudeSettings.ts
-import { existsSync as existsSync14, readFileSync as readFileSync15 } from "fs";
+import { existsSync as existsSync14, readFileSync as readFileSync16 } from "fs";
 import { join as join18 } from "path";
 
 // src/init/templateDir.ts
-import { existsSync as existsSync13, readFileSync as readFileSync14 } from "fs";
+import { existsSync as existsSync13, readFileSync as readFileSync15 } from "fs";
 import { dirname as dirname7, join as join17 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 
 // src/index.ts
-import { readFileSync as readFileSync13 } from "fs";
+import { readFileSync as readFileSync14 } from "fs";
 import { dirname as dirname6, join as join16 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 var PACKAGE_NAME = "@riconext/hermes-repo";
 var __dirname = dirname6(fileURLToPath3(import.meta.url));
 function readPkgVersion() {
   const pkgPath = join16(__dirname, "..", "package.json");
-  const pkg = JSON.parse(readFileSync13(pkgPath, "utf8"));
+  const pkg = JSON.parse(readFileSync14(pkgPath, "utf8"));
   return pkg.version;
 }
 
@@ -2631,7 +2732,7 @@ function resolveTemplatePath(name) {
   return join17(templateDir, name);
 }
 function readTemplate(name) {
-  return readFileSync14(resolveTemplatePath(name), "utf8");
+  return readFileSync15(resolveTemplatePath(name), "utf8");
 }
 function renderTemplate(name) {
   const raw = readTemplate(name);
@@ -2650,7 +2751,7 @@ function mergeClaudeLocalSettings(repoRoot) {
   let existing = {};
   if (existed) {
     try {
-      existing = JSON.parse(readFileSync15(settingsPath, "utf8"));
+      existing = JSON.parse(readFileSync16(settingsPath, "utf8"));
     } catch {
       existing = {};
     }
@@ -2690,7 +2791,7 @@ import { mkdirSync as mkdirSync8, writeFileSync as writeFileSync7 } from "fs";
 import { join as join21 } from "path";
 
 // src/init/mergeCodexConfig.ts
-import { existsSync as existsSync15, readFileSync as readFileSync16 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync17 } from "fs";
 import { join as join20 } from "path";
 var CODEX_CONFIG_REL = ".codex/config.toml";
 var CODEX_HERMES_START_MARKER = "# >>> hermes-repo codex (do not edit this block manually)";
@@ -2737,7 +2838,7 @@ function mergeCodexConfig(repoRoot) {
       action: "created"
     };
   }
-  const existing = readFileSync16(configPath, "utf8");
+  const existing = readFileSync17(configPath, "utf8");
   const hasBlock = existing.includes(CODEX_HERMES_START_MARKER) && existing.includes(CODEX_HERMES_END_MARKER);
   return {
     content: spliceHermesBlock(existing, block),
@@ -2764,7 +2865,7 @@ import { mkdirSync as mkdirSync9, writeFileSync as writeFileSync8 } from "fs";
 import { join as join23 } from "path";
 
 // src/init/mergeCodebuddySettings.ts
-import { existsSync as existsSync16, readFileSync as readFileSync17 } from "fs";
+import { existsSync as existsSync16, readFileSync as readFileSync18 } from "fs";
 import { join as join22 } from "path";
 var CODEBUDDY_SETTINGS_LOCAL_REL = ".codebuddy/settings.local.json";
 function codebuddySettingsLocalPath(repoRoot) {
@@ -2779,7 +2880,7 @@ function mergeCodebuddyLocalSettings(repoRoot) {
   let existing = {};
   if (existed) {
     try {
-      existing = JSON.parse(readFileSync17(settingsPath, "utf8"));
+      existing = JSON.parse(readFileSync18(settingsPath, "utf8"));
     } catch {
       existing = {};
     }
@@ -2819,7 +2920,7 @@ import { mkdirSync as mkdirSync10, writeFileSync as writeFileSync9 } from "fs";
 import { join as join25 } from "path";
 
 // src/init/mergeCursorHooks.ts
-import { existsSync as existsSync17, readFileSync as readFileSync18 } from "fs";
+import { existsSync as existsSync17, readFileSync as readFileSync19 } from "fs";
 import { join as join24 } from "path";
 var CURSOR_HOOKS_REL = ".cursor/hooks.json";
 function cursorHooksPath(repoRoot) {
@@ -2832,7 +2933,7 @@ function mergeCursorHooks(repoRoot) {
   let existing = {};
   if (existed) {
     try {
-      existing = JSON.parse(readFileSync18(hooksPath, "utf8"));
+      existing = JSON.parse(readFileSync19(hooksPath, "utf8"));
     } catch {
       existing = {};
     }
@@ -2939,14 +3040,14 @@ function ensureMemoryTree(repoRoot) {
 }
 
 // src/init/mergeAssistants.ts
-import { existsSync as existsSync18, readFileSync as readFileSync19 } from "fs";
+import { existsSync as existsSync18, readFileSync as readFileSync20 } from "fs";
 function readExistingAssistants(repoRoot) {
   const configPath = memoryPath(repoRoot, "config.json");
   if (!existsSync18(configPath)) {
     return [];
   }
   try {
-    const config = JSON.parse(readFileSync19(configPath, "utf8"));
+    const config = JSON.parse(readFileSync20(configPath, "utf8"));
     if (!Array.isArray(config.assistants)) {
       return [];
     }
@@ -2961,14 +3062,14 @@ function mergeAssistants(repoRoot, selected) {
 }
 
 // src/init/mergeGitignore.ts
-import { existsSync as existsSync19, readFileSync as readFileSync20, writeFileSync as writeFileSync11 } from "fs";
+import { existsSync as existsSync19, readFileSync as readFileSync21, writeFileSync as writeFileSync11 } from "fs";
 import { join as join27 } from "path";
 var START_MARKER = "# >>> hermes-repo memory (do not edit this block manually)";
 var END_MARKER = "# <<< hermes-repo memory";
 function mergeHermesGitignore(repoRoot) {
   const block = readTemplate("gitignore-block.txt").trimEnd() + "\n";
   const gitignorePath = join27(repoRoot, ".gitignore");
-  const contentBefore = existsSync19(gitignorePath) ? readFileSync20(gitignorePath, "utf8") : "";
+  const contentBefore = existsSync19(gitignorePath) ? readFileSync21(gitignorePath, "utf8") : "";
   const warnBroadMemoryIgnore = contentBefore.length > 0 && !contentBefore.includes(START_MARKER) && /(^|\n)\.memory\/\s*$/m.test(contentBefore);
   if (!existsSync19(gitignorePath)) {
     writeFileSync11(gitignorePath, `${block}
@@ -3002,7 +3103,7 @@ function mergeHermesGitignore(repoRoot) {
 import { copyFileSync, mkdirSync as mkdirSync12, writeFileSync as writeFileSync14 } from "fs";
 
 // src/init/mergeConfig.ts
-import { existsSync as existsSync20, readFileSync as readFileSync21 } from "fs";
+import { existsSync as existsSync20, readFileSync as readFileSync22 } from "fs";
 var DEFAULT_LLM = {
   enabled: false,
   provider: "openai",
@@ -3028,7 +3129,7 @@ function mergeConfigForInit(repoRoot, assistants) {
   let existing = {};
   if (existed) {
     try {
-      existing = JSON.parse(readFileSync21(configPath, "utf8"));
+      existing = JSON.parse(readFileSync22(configPath, "utf8"));
     } catch {
       existing = {};
     }
@@ -3064,7 +3165,7 @@ function mergeConfigForInit(repoRoot, assistants) {
 }
 
 // src/init/mergeAgentsMd.ts
-import { existsSync as existsSync21, readFileSync as readFileSync22, writeFileSync as writeFileSync12 } from "fs";
+import { existsSync as existsSync21, readFileSync as readFileSync23, writeFileSync as writeFileSync12 } from "fs";
 import { join as join28 } from "path";
 var HERMES_AGENTS_START_MARKER = "<!-- >>> hermes-repo agents (do not edit this block manually) -->";
 var HERMES_AGENTS_END_MARKER = "<!-- <<< hermes-repo agents -->";
@@ -3127,7 +3228,7 @@ function mergeAgentsMd(repoRoot, force) {
     writeFileSync12(agentsPath, buildNewAgentsMd(), "utf8");
     return "created";
   }
-  const content = readFileSync22(agentsPath, "utf8");
+  const content = readFileSync23(agentsPath, "utf8");
   if (agentsMdHasHermesBlock(content)) {
     if (!force) {
       return "skipped";
@@ -3235,7 +3336,7 @@ function writeScaffoldFiles(repoRoot, opts, report) {
 
 // src/init/prompts.ts
 import { checkbox, confirm, input } from "@inquirer/prompts";
-import { existsSync as existsSync23, readFileSync as readFileSync23 } from "fs";
+import { existsSync as existsSync23, readFileSync as readFileSync24 } from "fs";
 import { resolve as resolve6 } from "path";
 function isInitialized(targetDir) {
   const configPath = memoryPath(targetDir, "config.json");
@@ -3243,7 +3344,7 @@ function isInitialized(targetDir) {
     return false;
   }
   try {
-    const config = JSON.parse(readFileSync23(configPath, "utf8"));
+    const config = JSON.parse(readFileSync24(configPath, "utf8"));
     return typeof config.version === "number" && config.version >= 1;
   } catch {
     return false;