@riconext/hermes-repo 1.2.2 → 1.2.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 1.2.4
+
+### Patch Changes
+
+- 089eb55: 兼容 LLM 返回 path 和 YAML frontmatter 的知识文件格式，避免有效知识文件在 flush 时被过滤丢弃。
+
+## 1.2.3
+
+### Patch Changes
+
+- 17d33f3: 增加 flush 调用 LLM 时的详细 debug 日志，便于检查请求输入、原始响应和标准化后的知识文件结果。
+
 ## 1.2.2
 
 ### Patch Changes

package/dist/cli.js

@@ -62,6 +62,16 @@ function debugLog(enabled, phase, message) {
   console.error(line);
   writeToLogFile(line);
 }
+function debugLogBlock(enabled, phase, label, content) {
+  if (!enabled) {
+    return;
+  }
+  debugLog(true, phase, `${label} BEGIN`);
+  for (const line of content.split(/\r?\n/)) {
+    debugLog(true, phase, `| ${line}`);
+  }
+  debugLog(true, phase, `${label} END`);
+}
 function debugFromContext(ctx, phase, message) {
   debugLog(ctx?.config.debug === true, phase, message);
 }
@@ -1339,7 +1349,11 @@ var CONSOLIDATE_SYSTEM_PROMPT = `\u4F60\u662F\u4E00\u4E2A\u9879\u76EE\u77E5\u8BC
 ## \u8F93\u51FA\u8981\u6C42
 - \u8F93\u51FA\u4E25\u683C JSON \u683C\u5F0F
 - knowledgeFiles \u6570\u7EC4\u5305\u542B\u6240\u6709\u9700\u8981\u521B\u5EFA/\u66F4\u65B0\u7684\u6587\u4EF6
-  - \u6BCF\u9879\u5FC5\u987B\u5305\u542B\u5B8C\u6574\u7684 frontmatter \u548C body markdown
+  - \u6BCF\u9879\u5FC5\u987B\u5305\u542B targetPath\u3001action\u3001frontmatter\u3001body
+  - targetPath \u662F\u76F8\u5BF9 .memory/ \u7684\u8DEF\u5F84\uFF0C\u4F8B\u5982 "domains/canvas/canvas-interaction.md"
+  - \u4E0D\u8981\u4F7F\u7528 path\u3001filePath\u3001filename \u7B49\u5B57\u6BB5\u4EE3\u66FF targetPath
+  - frontmatter \u5FC5\u987B\u662F JSON \u5BF9\u8C61\uFF0C\u4E0D\u8981\u8F93\u51FA YAML \u5B57\u7B26\u4E32
+  - body \u662F\u4E0D\u5305\u542B frontmatter \u7684 markdown \u6B63\u6587
 - memoryMd \u662F\u5B8C\u6574 MEMORY.md \u5185\u5BB9
 - \u65E0\u4EF7\u503C\u7684 session \u5728 skippedSessions \u4E2D\u8BF4\u660E\u539F\u56E0\uFF08\u800C\u975E\u751F\u6210\u7A7A\u5185\u5BB9\uFF09`;
 function scanExistingKnowledge(repoRoot) {
@@ -1423,7 +1437,7 @@ function buildLlmConsolidateInput(repoRoot, sessions) {
     currentMemoryMd
   };
 }
-async function callLlmConsolidate(input2, llmConfig) {
+async function callLlmConsolidate(input2, llmConfig, debug = false) {
   if (!llmConfig.enabled) {
     throw new Error(
       "LLM \u672A\u542F\u7528\uFF1A\u8BF7\u5728 config.json \u4E2D\u8BBE\u7F6E llm.enabled = true"
@@ -1436,6 +1450,23 @@ async function callLlmConsolidate(input2, llmConfig) {
   }
   const url = `${llmConfig.baseUrl.replace(/\/$/, "")}/chat/completions`;
   const userContent = formatUserMessage(input2);
+  debugLog(
+    debug,
+    "llm",
+    `request: provider=${llmConfig.provider}, model=${llmConfig.model}, baseUrl=${llmConfig.baseUrl}, pendingSessions=${input2.pendingSessions.length}, existingKnowledge=${input2.existingKnowledge.length}, currentMemoryChars=${input2.currentMemoryMd?.length ?? 0}`
+  );
+  debugLogBlock(debug, "llm", "system prompt", CONSOLIDATE_SYSTEM_PROMPT);
+  debugLogBlock(debug, "llm", "user input", userContent);
+  const requestBody = {
+    model: llmConfig.model,
+    response_format: { type: "json_object" },
+    messages: [
+      { role: "system", content: CONSOLIDATE_SYSTEM_PROMPT },
+      { role: "user", content: userContent }
+    ],
+    temperature: 0.2
+  };
+  debugLogBlock(debug, "llm", "request body", JSON.stringify(requestBody, null, 2));
   const controller = new AbortController();
   const timeout = setTimeout(() => controller.abort(), 12e4);
   try {
@@ -1445,35 +1476,58 @@ async function callLlmConsolidate(input2, llmConfig) {
         "Content-Type": "application/json",
         Authorization: `Bearer ${llmConfig.apiKey}`
       },
-      body: JSON.stringify({
-        model: llmConfig.model,
-        response_format: { type: "json_object" },
-        messages: [
-          { role: "system", content: CONSOLIDATE_SYSTEM_PROMPT },
-          { role: "user", content: userContent }
-        ],
-        temperature: 0.2
-      }),
+      body: JSON.stringify(requestBody),
       signal: controller.signal
     });
+    debugLog(debug, "llm", `response status: ${res.status} ${res.statusText}`);
     if (!res.ok) {
       const errBody = await res.text().catch(() => "");
+      debugLogBlock(debug, "llm", "error response body", errBody);
       throw new Error(
         `LLM API \u9519\u8BEF (${res.status}): ${errBody.slice(0, 300)}`
       );
     }
     const data = await res.json();
+    debugLogBlock(debug, "llm", "response json", JSON.stringify(data, null, 2));
     const rawContent = data.choices?.[0]?.message?.content;
     if (!rawContent) {
       throw new Error("LLM \u8FD4\u56DE\u5185\u5BB9\u4E3A\u7A7A");
     }
+    debugLogBlock(debug, "llm", "raw message content", rawContent);
     let parsed;
     try {
       parsed = JSON.parse(rawContent);
     } catch {
       throw new Error("LLM \u8FD4\u56DE\u5185\u5BB9\u4E0D\u662F\u5408\u6CD5 JSON");
     }
-    return validateAndNormalizeLlmResult(parsed);
+    debugLogBlock(debug, "llm", "parsed content", JSON.stringify(parsed, null, 2));
+    const normalized = validateAndNormalizeLlmResult(parsed);
+    debugLog(
+      debug,
+      "llm",
+      `normalized: knowledgeFiles=${normalized.knowledgeFiles.length}, memoryChars=${normalized.memoryMd.length}, skippedSessions=${normalized.skippedSessions.length}`
+    );
+    debugLogBlock(
+      debug,
+      "llm",
+      "normalized knowledgeFiles",
+      JSON.stringify(normalized.knowledgeFiles, null, 2)
+    );
+    debugLogBlock(debug, "llm", "normalized memoryMd", normalized.memoryMd);
+    debugLogBlock(
+      debug,
+      "llm",
+      "normalized skippedSessions",
+      JSON.stringify(normalized.skippedSessions, null, 2)
+    );
+    return normalized;
+  } catch (err) {
+    debugLog(
+      debug,
+      "llm",
+      `error: ${err instanceof Error ? err.message : String(err)}`
+    );
+    throw err;
   } finally {
     clearTimeout(timeout);
   }
@@ -1518,16 +1572,51 @@ function validateAndNormalizeLlmResult(raw) {
 function normalizeKnowledgeFile(raw) {
   if (!raw || typeof raw !== "object") return null;
   const obj = raw;
-  if (typeof obj.targetPath !== "string" || !["create", "update"].includes(obj.action) || typeof obj.body !== "string") {
+  const targetPath = typeof obj.targetPath === "string" ? obj.targetPath : typeof obj.path === "string" ? obj.path : null;
+  if (!targetPath || !["create", "update"].includes(obj.action) || typeof obj.body !== "string") {
     return null;
   }
   return {
-    targetPath: obj.targetPath,
+    targetPath,
     action: obj.action,
-    frontmatter: typeof obj.frontmatter === "object" && obj.frontmatter !== null ? obj.frontmatter : {},
+    frontmatter: normalizeFrontmatter(obj.frontmatter),
     body: obj.body
   };
 }
+function normalizeFrontmatter(raw) {
+  if (raw && typeof raw === "object" && !Array.isArray(raw)) {
+    return raw;
+  }
+  if (typeof raw !== "string") {
+    return {};
+  }
+  const text = raw.trim();
+  const yaml = text.startsWith("---") ? text.replace(/^---\r?\n?/, "").replace(/\r?\n?---$/, "") : text;
+  const frontmatter = {};
+  for (const line of yaml.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) {
+      continue;
+    }
+    const separator = trimmed.indexOf(":");
+    if (separator <= 0) {
+      continue;
+    }
+    const key = trimmed.slice(0, separator).trim();
+    const value = trimmed.slice(separator + 1).trim();
+    frontmatter[key] = parseFrontmatterValue(value);
+  }
+  return frontmatter;
+}
+function parseFrontmatterValue(value) {
+  const unquoted = value.replace(/^["']|["']$/g, "");
+  if (unquoted.startsWith("[") && unquoted.endsWith("]")) {
+    return unquoted.slice(1, -1).split(",").map((item) => item.trim().replace(/^["']|["']$/g, "")).filter(Boolean);
+  }
+  if (unquoted === "true") return true;
+  if (unquoted === "false") return false;
+  return unquoted;
+}
 function isSkippedEntry(raw) {
   if (!raw || typeof raw !== "object") return false;
   const obj = raw;
@@ -1769,7 +1858,7 @@ async function runConsolidate(opts) {
     );
     let llmResult;
     try {
-      llmResult = await callLlmConsolidate(llmInput, llmConfig);
+      llmResult = await callLlmConsolidate(llmInput, llmConfig, debug === true);
     } catch (err) {
       console.error(`[consolidate] LLM \u8C03\u7528\u5931\u8D25: ${err.message}`);
       throw err;