larkway 0.3.10 → 0.3.12

package/README.md

@@ -8,7 +8,7 @@
 
 You @ the bot in a Feishu thread. It runs on your machine — reading your real codebase, executing commands, opening MRs — and posts the result back. You define what the agent knows and what it can do. Larkway just carries the messages.
 
-**Current release: v0.3.10**
+**Current release: v0.3.12**
 
 ---
 

package/README.zh.md

@@ -8,7 +8,7 @@
 
 你在飞书话题里 @ bot，它在你的机器上运行——读真实代码库、执行命令、开 MR——把结果贴回飞书。你定义 agent 知道什么、能做什么。Larkway 只负责传递消息。
 
-**当前版本：v0.3.10**
+**当前版本：v0.3.12**
 
 ---
 

package/dist/cli/index.js

@@ -107597,6 +107597,10 @@ function stringField(obj, key) {
   const value = obj[key];
   return typeof value === "string" ? value : void 0;
 }
+function nonEmptyStringField(obj, key) {
+  const value = stringField(obj, key);
+  return value && value.length > 0 ? value : void 0;
+}
 function parseLarkCliMessages(stdout2) {
   const parsed = JSON.parse(stdout2);
   if (Array.isArray(parsed)) return parsed;
@@ -107610,6 +107614,25 @@ function parseLarkCliMessages(stdout2) {
   }
   return null;
 }
+function expandMessagesWithThreadReplies(messages) {
+  const expanded = [];
+  for (const raw of messages) {
+    expanded.push(raw);
+    if (!raw || typeof raw !== "object") continue;
+    const parent = raw;
+    const parentRootId = nonEmptyStringField(parent, "root_id") ?? nonEmptyStringField(parent, "message_id");
+    const replies = arrayField(parent, "thread_replies") ?? [];
+    for (const replyRaw of replies) {
+      if (!replyRaw || typeof replyRaw !== "object") continue;
+      const reply = replyRaw;
+      expanded.push({
+        ...reply,
+        root_id: nonEmptyStringField(reply, "root_id") ?? parentRootId
+      });
+    }
+  }
+  return expanded;
+}
 function cardActionChoice(value) {
   if (value && typeof value === "object") {
     const choice = value["larkway_choice"];
@@ -107942,8 +107965,9 @@ var init_channelClient = __esm({
               log(`gap-fill: failed to parse lark-cli output for chat ${chatId}`);
               continue;
             }
-            totalFetched += messages.length;
-            for (const raw of messages) {
+            const messagesWithReplies = expandMessagesWithThreadReplies(messages);
+            totalFetched += messagesWithReplies.length;
+            for (const raw of messagesWithReplies) {
               if (this.closed) break;
               const m = raw;
               const messageId = m["message_id"];
@@ -120457,6 +120481,7 @@ function renderAgentsMd(input) {
     "",
     "## Workspace Contract",
     "",
+    "- \u5F00\u573A\u4E0D\u53EF\u8DF3\u8FC7:\u56DE\u5E94 owner \u524D,\u5148 Read `memory/index.md`,\u5E76\u6309\u76F8\u5173\u6027 Read \u76F8\u5173 category \u6587\u4EF6,\u518D\u5F00\u59CB\u5E72\u6D3B(\u9632\u6B62\u65B0 session \u5931\u5FC6)\u3002",
     "- Larkway is a thin Feishu bridge. It passes scene/context pointers; you decide what to inspect and what work to do.",
     "- Each Feishu topic is one task session under `sessions/<thread_id>/`.",
     "- Keep durable notes, repo clones, session summaries, and permission decisions inside this workspace.",
@@ -120776,6 +120801,75 @@ async function ensureAgentWorkspace(input) {
     path7.join(input.workspacePath, "permissions-granted.md"),
     renderPermissionsGranted(input)
   );
+  await ensureMemoryScaffold(input.workspacePath);
+}
+var MEMORY_CATEGORY_FILES = [
+  {
+    name: "preferences.md",
+    title: "Owner Preferences",
+    purpose: "owner \u6216\u56E2\u961F\u957F\u671F\u504F\u597D(\u6C47\u62A5\u683C\u5F0F\u3001\u9ED8\u8BA4\u8BED\u8A00\u3001\u9A8C\u8BC1\u504F\u597D\u7B49)\u3002"
+  },
+  {
+    name: "reusable-knowledge.md",
+    title: "Reusable Knowledge",
+    purpose: "\u591A\u4E2A session \u540E\u6C89\u6DC0\u51FA\u7684\u53EF\u590D\u7528\u7ECF\u9A8C\u3001\u5E38\u89C1\u5751\u3001\u65B9\u6848\u5224\u65AD\u3002"
+  },
+  {
+    name: "workflows.md",
+    title: "Workflows",
+    purpose: "\u8FD9\u4E2A Agent \u81EA\u5DF1\u7684\u957F\u671F\u5DE5\u4F5C\u65B9\u5F0F(\u9879\u76EE repo \u7684\u5DE5\u7A0B\u89C4\u8303\u4ECD\u5199\u8FDB\u9879\u76EE repo)\u3002"
+  },
+  {
+    name: "decisions.md",
+    title: "Decisions",
+    purpose: "\u957F\u671F\u51B3\u7B56\u8BB0\u5F55,\u4F8B\u5982\u4E3A\u4EC0\u4E48\u67D0\u6743\u9650\u5FC5\u987B\u4EBA\u5DE5\u786E\u8BA4\u3002"
+  },
+  {
+    name: "assets.md",
+    title: "Assets",
+    purpose: "\u957F\u671F\u56FE\u7247/\u622A\u56FE/\u9644\u4EF6\u7684\u7D22\u5F15,\u53EA\u8BB0\u5F15\u7528\u548C\u7528\u9014,\u4E0D\u5185\u8054\u5927\u6587\u4EF6(\u5B9E\u4F53\u653E assets/)\u3002"
+  }
+];
+function renderMemoryIndex() {
+  return [
+    "# Memory Index",
+    "",
+    "\u8FD9\u662F\u8DE8 session \u957F\u671F\u8BB0\u5FC6\u3002\u65B0 session \u8D77\u624B\u5148\u8BFB\u8FD9\u91CC,\u628A\u8FC7\u5F80\u79EF\u7D2F\u62C9\u8D77\u6765\u3002",
+    "Larkway \u53EA\u521D\u59CB\u5316\u7A7A\u5BB9\u5668;\u63D0\u70BC\u3001\u5206\u7C7B\u3001\u5199\u5165\u6B63\u6587\u90FD\u7531\u4F60(Agent)\u5728 owner \u786E\u8BA4\u540E\u5B8C\u6210\u3002",
+    "",
+    "## \u5206\u7C7B\u6587\u4EF6",
+    "",
+    ...MEMORY_CATEGORY_FILES.map((f) => `- \`${f.name}\` \u2014 ${f.purpose}`),
+    "",
+    "## \u7EF4\u62A4\u89C4\u5219",
+    "",
+    "- \u70ED\u8DEF\u5F84(\u6BCF\u8F6E)\u53EA\u505A\u52A0\u6CD5:\u628A\u5019\u9009\u5199\u8FDB session \u7684 `memory-candidates.md`,\u6216\u5F80 category \u6587\u4EF6\u8FFD\u52A0\u65B0\u6761\u76EE;\u4E0D\u5728\u70ED\u8DEF\u5F84\u6539\u5199/\u5220\u9664\u5DF2\u6709\u6761\u76EE\u3002",
+    "- \u6539\u5199\u3001\u5220\u9664\u3001\u89E3\u51B3\u51B2\u7A81 \u2192 \u63A8\u8FDF\u5230 owner \u663E\u5F0F\u8BF4\u300C\u6574\u7406\u8BB0\u5FC6\u300D\u65F6\u79BB\u7EBF\u505A\u3002UPDATE/DELETE \u7684\u65E7\u6761\u76EE\u79FB `archive/`(\u6CE8\u4E00\u53E5\u539F\u56E0+\u5BF9\u5E94 commit),\u4E0D\u624B\u5199 superseded \u6233,\u4E0D\u7269\u7406\u5220;archive/ \u7684\u957F\u671F\u6E05\u7406\u4EA4\u7ED9 git history\u3002",
+    "- \u88C1\u51B3\u4EE5 source \u4F18\u5148:user \u4EB2\u53E3\u8BF4\u7684 >> agent \u63A8\u65AD;\u51B2\u7A81\u65F6\u4FDD\u7559\u65E7\u7684 user \u6761\u76EE,\u628A\u65B0\u63A8\u65AD\u964D\u7EA7\u4E3A candidate\u3002\u540C source \u5185 recency \u4EE5 git \u5386\u53F2\u4E3A\u51C6,\u4E0D\u624B\u5199\u65E5\u671F\u6233\u3002",
+    "- \u53EA\u6709\u8DE8 session \u8FD8\u4F1A\u7528\u5230\u7684\u624D\u8FDB\u8FD9\u91CC(\u5355\u6B21\u4EFB\u52A1\u7559\u5728 session summary)\u3002\u672C\u6587\u4EF6\u4FDD\u6301\u7B80\u77ED(\u2264~50 \u884C),\u4E0D\u653E changelog/\u7EDF\u8BA1\u3002",
+    ""
+  ].join("\n");
+}
+function renderMemoryCategorySkeleton(title) {
+  return [
+    `# ${title}`,
+    "",
+    "\u5199\u524D\u5148\u8BFB\u672C\u6587\u4EF6;\u6709\u76F8\u540C/\u76F8\u5173\u6761\u76EE\u5C31 NOOP \u4E0D\u91CD\u590D\u5199(\u6539\u5199\u3001\u5220\u9664\u3001\u79FB archive \u7559\u5230 owner \u8BF4\u300C\u6574\u7406\u8BB0\u5FC6\u300D\u65F6\u7684\u79BB\u7EBF\u6B65\u9AA4);\u4FE1\u53F7\u4E0D\u8DE8 session \u590D\u7528\u5C31\u4E0D\u5199\u3002",
+    ""
+  ].join("\n");
+}
+async function ensureMemoryScaffold(workspacePath) {
+  const memoryDir = path7.join(workspacePath, "memory");
+  await fs.mkdir(memoryDir, { recursive: true });
+  await fs.mkdir(path7.join(memoryDir, "assets"), { recursive: true });
+  await fs.mkdir(path7.join(memoryDir, "archive"), { recursive: true });
+  await writeIfMissing(path7.join(memoryDir, "index.md"), renderMemoryIndex());
+  for (const file of MEMORY_CATEGORY_FILES) {
+    await writeIfMissing(
+      path7.join(memoryDir, file.name),
+      renderMemoryCategorySkeleton(file.title)
+    );
+  }
 }
 
 // src/cli/commands/init.ts

package/dist/main.js

@@ -111823,6 +111823,10 @@ function stringField(obj, key) {
   const value = obj[key];
   return typeof value === "string" ? value : void 0;
 }
+function nonEmptyStringField(obj, key) {
+  const value = stringField(obj, key);
+  return value && value.length > 0 ? value : void 0;
+}
 function parseLarkCliMessages(stdout) {
   const parsed = JSON.parse(stdout);
   if (Array.isArray(parsed)) return parsed;
@@ -111836,6 +111840,25 @@ function parseLarkCliMessages(stdout) {
   }
   return null;
 }
+function expandMessagesWithThreadReplies(messages) {
+  const expanded = [];
+  for (const raw of messages) {
+    expanded.push(raw);
+    if (!raw || typeof raw !== "object") continue;
+    const parent = raw;
+    const parentRootId = nonEmptyStringField(parent, "root_id") ?? nonEmptyStringField(parent, "message_id");
+    const replies = arrayField(parent, "thread_replies") ?? [];
+    for (const replyRaw of replies) {
+      if (!replyRaw || typeof replyRaw !== "object") continue;
+      const reply = replyRaw;
+      expanded.push({
+        ...reply,
+        root_id: nonEmptyStringField(reply, "root_id") ?? parentRootId
+      });
+    }
+  }
+  return expanded;
+}
 function cardActionChoice(value) {
   if (value && typeof value === "object") {
     const choice = value["larkway_choice"];
@@ -112154,8 +112177,9 @@ var ChannelClient = class {
           log(`gap-fill: failed to parse lark-cli output for chat ${chatId}`);
           continue;
         }
-        totalFetched += messages.length;
-        for (const raw of messages) {
+        const messagesWithReplies = expandMessagesWithThreadReplies(messages);
+        totalFetched += messagesWithReplies.length;
+        for (const raw of messagesWithReplies) {
           if (this.closed) break;
           const m = raw;
           const messageId = m["message_id"];
@@ -113246,6 +113270,9 @@ function senderOpenIdOf(senderId) {
   return "";
 }
 
+// src/claude/prompt.ts
+import { readFileSync as readFileSync2 } from "node:fs";
+
 // src/agent/triggerFacts.ts
 function stringField2(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
@@ -113282,6 +113309,23 @@ function deriveTriggerFacts(parsed, isNewThread, larkCliProfile) {
 }
 
 // src/claude/prompt.ts
+var MEMORY_CATEGORY_FILE_NAMES = [
+  "preferences.md",
+  "reusable-knowledge.md",
+  "workflows.md",
+  "decisions.md",
+  "assets.md"
+];
+var MEMORY_FILE_LINE_LIMIT = 200;
+function statMemoryLines(filePath) {
+  try {
+    const text = readFileSync2(filePath, "utf8");
+    if (text.length === 0) return 0;
+    return (text.match(/\n/g)?.length ?? 0) + (text.endsWith("\n") ? 0 : 1);
+  } catch {
+    return 0;
+  }
+}
 function csv(items) {
   return items.length > 0 ? items.join(",") : "(none)";
 }
@@ -113403,6 +113447,8 @@ function renderWorkspaceBlock(primarySlug, primaryCachePath, defaultBranch, extr
 }
 function renderAgentWorkspaceBlock(conventions, extraRepos) {
   const summaryFilePath = conventions.workspaceSessionPath ? `${conventions.workspaceSessionPath}/summary.md` : void 0;
+  const memoryDir = conventions.agentWorkspacePath ? `${conventions.agentWorkspacePath}/memory` : void 0;
+  const memoryIndex = memoryDir ? `${memoryDir}/index.md` : void 0;
   const lines = [
     "<agent-workspace>",
     "Larkway \u662F thin bridge:\u5B83\u53EA\u628A\u98DE\u4E66\u89E6\u53D1\u573A\u666F\u548C\u672C\u5730\u8DEF\u5F84\u6307\u9488\u4EA4\u7ED9\u4F60,\u4E0D\u66FF\u4F60\u7F16\u6392\u4EFB\u52A1\u3002",
@@ -113411,12 +113457,29 @@ function renderAgentWorkspaceBlock(conventions, extraRepos) {
     `- summary_file_path:  ${summaryFilePath ?? "(topic_session_path)/summary.md"}`,
     `- state_file_path:     ${conventions.stateFilePath}`,
     `- workspace_repos_dir: ${conventions.workspaceReposPath}`,
+    `- memory_dir:          ${memoryDir ?? "(agent_workspace_path)/memory"}`,
+    `- memory_index:        ${memoryIndex ?? "(memory_dir)/index.md"}`,
     "- \u4E00\u4E2A\u98DE\u4E66\u8BDD\u9898 = \u4E00\u4E2A task/session\u3002\u8BDD\u9898\u5185\u7EED\u63A5\u65F6,\u7EE7\u7EED\u4F7F\u7528\u540C\u4E00\u4E2A topic_session_path\u3002",
     "- \u7FA4\u91CC @ \u4F60\u65F6,bridge \u4F1A\u62C9\u8D77/\u5173\u8054\u4E00\u4E2A\u8BDD\u9898;\u662F\u5426\u8BFB\u53D6\u7FA4\u5386\u53F2\u3001\u8BDD\u9898\u5386\u53F2\u3001\u9644\u4EF6\u3001\u6587\u6863,\u7531\u4F60\u6839\u636E\u4EFB\u52A1\u81EA\u884C\u51B3\u5B9A\u3002",
     "- \u4E0D\u8981\u5047\u8BBE bridge \u5DF2\u7ECF clone/fetch/worktree/pnpm install;\u9700\u8981\u4EE3\u7801\u65F6,\u4F60\u5728 workspace \u91CC\u81EA\u5DF1 clone/branch/install/test\u3002",
     "- summary.md \u662F\u4F60\u7EF4\u62A4\u672C\u8BDD\u9898\u6458\u8981\u3001\u51B3\u7B56\u548C\u4E0B\u4E00\u6B65 notes \u7684\u5730\u65B9;bridge \u53EA\u521B\u5EFA\u5360\u4F4D,\u4E0D\u66FF\u4F60\u603B\u7ED3\u3002",
-    "- \u4F18\u5148\u8BFB\u53D6 workspace \u5185\u7684 AGENTS.md\u3001CLAUDE.md(\u5982\u5B58\u5728)\u3001permissions-request.md\u3001permissions-granted.md\u3002"
+    "- \u8D77\u624B\u5148\u8BFB memory/index.md \u62C9\u8D77\u8DE8 session \u957F\u671F\u8BB0\u5FC6(preferences / reusable-knowledge / workflows / decisions / assets),\u518D\u8BFB workspace \u5185\u7684 AGENTS.md\u3001CLAUDE.md(\u5982\u5B58\u5728)\u3001permissions-request.md\u3001permissions-granted.md\u3002",
+    "- \u672C session \u91CC\u8DE8 session \u53EF\u590D\u7528\u7684\u5185\u5BB9,\u5148\u8BB0\u5230 topic_session_path/memory-candidates.md;owner \u786E\u8BA4\u540E,\u7531\u4F60\u5199\u8FDB memory/<category>.md\u3002",
+    "- \u70ED\u8DEF\u5F84(\u6BCF\u8F6E)\u53EA\u5141\u8BB8 ADD / NOOP:\u628A\u5019\u9009 append \u5230 memory-candidates.md,\u6216\u5F80 category \u6587\u4EF6\u8FFD\u52A0\u65B0\u6761\u76EE;\u4E0D\u5728\u70ED\u8DEF\u5F84\u505A UPDATE/DELETE/\u6539\u5199\u5DF2\u6709\u6761\u76EE\u3002",
+    "- \u6539\u5199\u3001\u5220\u9664\u3001\u89E3\u51B3\u51B2\u7A81 \u2192 \u63A8\u8FDF\u5230 owner \u663E\u5F0F\u8BF4\u300C\u6574\u7406\u8BB0\u5FC6\u300D\u65F6\u7684\u79BB\u7EBF\u6B65\u9AA4\u505A\u3002\u5931\u6548/\u88AB\u63A8\u7FFB\u7684\u6761\u76EE\u79FB memory/archive/(\u6CE8\u4E00\u53E5\u539F\u56E0),\u4E0D\u7269\u7406\u5220\u3002",
+    "- \u79BB\u7EBF\u6574\u7406/\u6539\u5199\u5DF2\u6709\u8BB0\u5FC6\u524D,\u5148\u7528 rg \u5728 sessions/*/transcript.md \u6838\u5230\u6765\u6E90\u884C;commit/\u7B14\u8BB0\u5F15\u7528\u8BE5\u884C;\u6838\u4E0D\u5230\u6765\u6E90\u7684\u7ED3\u8BBA\u964D\u7EA7\u4E3A candidate,\u4E0D\u5199\u8FDB\u6B63\u6587\u3002(\u5355 agent \u81EA\u5DF1\u505A,\u522B spawn \u522B\u7684 agent\u3002)",
+    "- \u53EA\u6709\u8DE8 session \u8FD8\u4F1A\u518D\u7528\u5230\u7684\u624D\u8FDB memory/(\u5355\u6B21\u4EFB\u52A1\u7559\u5728 summary,\u968F session \u8FC7\u671F);\u65B0\u589E\u3001\u4EE5\u53CA\u4F1A\u6539\u53D8\u884C\u4E3A\u6216\u8FB9\u754C\u7684\u6539\u5199/\u5220\u9664\u90FD\u8981 owner \u786E\u8BA4\u3002"
   ];
+  if (memoryDir) {
+    for (const fileName of MEMORY_CATEGORY_FILE_NAMES) {
+      const count = statMemoryLines(`${memoryDir}/${fileName}`);
+      if (count > MEMORY_FILE_LINE_LIMIT) {
+        lines.push(
+          `- \u26A0\uFE0F ${fileName} \u5DF2 ${count} \u884C,\u8D85\u9650\u2014\u2014\u4E0B\u6B21\u300C\u6574\u7406\u8BB0\u5FC6\u300D\u65F6\u5148\u84B8\u998F\u538B\u7F29\u3002`
+        );
+      }
+    }
+  }
   if (conventions.defaultProjectSlug) {
     lines.push("");
     lines.push("Repo pointers(\u53EA\u662F\u6307\u9488,\u4E0D\u662F\u5DF2\u51C6\u5907\u597D\u7684 clone):");
@@ -113693,6 +113756,15 @@ function renderSummaryPlaceholder() {
     ""
   ].join("\n");
 }
+function renderMemoryCandidatesPlaceholder() {
+  return [
+    "# Memory Candidates",
+    "",
+    "\u672C session \u91CC\u503C\u5F97\u63D0\u5347\u4E3A\u8DE8 session \u957F\u671F\u8BB0\u5FC6\u7684\u5019\u9009,\u8BB0\u5728\u8FD9\u3002",
+    "owner \u786E\u8BA4\u540E,\u7531\u4F60(Agent)\u5199\u8FDB ../../memory/<category>.md\u3002",
+    ""
+  ].join("\n");
+}
 function indentBlock(value) {
   const trimmed = value.trim();
   if (!trimmed) return "  (empty)";
@@ -113748,6 +113820,10 @@ function renderTranscriptEntry(input) {
 async function ensureSessionArtifacts(input) {
   await fs.mkdir(input.sessionPath, { recursive: true });
   await writeIfMissing(path4.join(input.sessionPath, "summary.md"), renderSummaryPlaceholder());
+  await writeIfMissing(
+    path4.join(input.sessionPath, "memory-candidates.md"),
+    renderMemoryCandidatesPlaceholder()
+  );
   await fs.appendFile(
     path4.join(input.sessionPath, "transcript.md"),
     `${renderTranscriptEntry(input)}
@@ -113828,6 +113904,7 @@ function renderAgentsMd(input) {
     "",
     "## Workspace Contract",
     "",
+    "- \u5F00\u573A\u4E0D\u53EF\u8DF3\u8FC7:\u56DE\u5E94 owner \u524D,\u5148 Read `memory/index.md`,\u5E76\u6309\u76F8\u5173\u6027 Read \u76F8\u5173 category \u6587\u4EF6,\u518D\u5F00\u59CB\u5E72\u6D3B(\u9632\u6B62\u65B0 session \u5931\u5FC6)\u3002",
     "- Larkway is a thin Feishu bridge. It passes scene/context pointers; you decide what to inspect and what work to do.",
     "- Each Feishu topic is one task session under `sessions/<thread_id>/`.",
     "- Keep durable notes, repo clones, session summaries, and permission decisions inside this workspace.",
@@ -113994,6 +114071,75 @@ async function ensureAgentWorkspace(input) {
     path5.join(input.workspacePath, "permissions-granted.md"),
     renderPermissionsGranted(input)
   );
+  await ensureMemoryScaffold(input.workspacePath);
+}
+var MEMORY_CATEGORY_FILES = [
+  {
+    name: "preferences.md",
+    title: "Owner Preferences",
+    purpose: "owner \u6216\u56E2\u961F\u957F\u671F\u504F\u597D(\u6C47\u62A5\u683C\u5F0F\u3001\u9ED8\u8BA4\u8BED\u8A00\u3001\u9A8C\u8BC1\u504F\u597D\u7B49)\u3002"
+  },
+  {
+    name: "reusable-knowledge.md",
+    title: "Reusable Knowledge",
+    purpose: "\u591A\u4E2A session \u540E\u6C89\u6DC0\u51FA\u7684\u53EF\u590D\u7528\u7ECF\u9A8C\u3001\u5E38\u89C1\u5751\u3001\u65B9\u6848\u5224\u65AD\u3002"
+  },
+  {
+    name: "workflows.md",
+    title: "Workflows",
+    purpose: "\u8FD9\u4E2A Agent \u81EA\u5DF1\u7684\u957F\u671F\u5DE5\u4F5C\u65B9\u5F0F(\u9879\u76EE repo \u7684\u5DE5\u7A0B\u89C4\u8303\u4ECD\u5199\u8FDB\u9879\u76EE repo)\u3002"
+  },
+  {
+    name: "decisions.md",
+    title: "Decisions",
+    purpose: "\u957F\u671F\u51B3\u7B56\u8BB0\u5F55,\u4F8B\u5982\u4E3A\u4EC0\u4E48\u67D0\u6743\u9650\u5FC5\u987B\u4EBA\u5DE5\u786E\u8BA4\u3002"
+  },
+  {
+    name: "assets.md",
+    title: "Assets",
+    purpose: "\u957F\u671F\u56FE\u7247/\u622A\u56FE/\u9644\u4EF6\u7684\u7D22\u5F15,\u53EA\u8BB0\u5F15\u7528\u548C\u7528\u9014,\u4E0D\u5185\u8054\u5927\u6587\u4EF6(\u5B9E\u4F53\u653E assets/)\u3002"
+  }
+];
+function renderMemoryIndex() {
+  return [
+    "# Memory Index",
+    "",
+    "\u8FD9\u662F\u8DE8 session \u957F\u671F\u8BB0\u5FC6\u3002\u65B0 session \u8D77\u624B\u5148\u8BFB\u8FD9\u91CC,\u628A\u8FC7\u5F80\u79EF\u7D2F\u62C9\u8D77\u6765\u3002",
+    "Larkway \u53EA\u521D\u59CB\u5316\u7A7A\u5BB9\u5668;\u63D0\u70BC\u3001\u5206\u7C7B\u3001\u5199\u5165\u6B63\u6587\u90FD\u7531\u4F60(Agent)\u5728 owner \u786E\u8BA4\u540E\u5B8C\u6210\u3002",
+    "",
+    "## \u5206\u7C7B\u6587\u4EF6",
+    "",
+    ...MEMORY_CATEGORY_FILES.map((f) => `- \`${f.name}\` \u2014 ${f.purpose}`),
+    "",
+    "## \u7EF4\u62A4\u89C4\u5219",
+    "",
+    "- \u70ED\u8DEF\u5F84(\u6BCF\u8F6E)\u53EA\u505A\u52A0\u6CD5:\u628A\u5019\u9009\u5199\u8FDB session \u7684 `memory-candidates.md`,\u6216\u5F80 category \u6587\u4EF6\u8FFD\u52A0\u65B0\u6761\u76EE;\u4E0D\u5728\u70ED\u8DEF\u5F84\u6539\u5199/\u5220\u9664\u5DF2\u6709\u6761\u76EE\u3002",
+    "- \u6539\u5199\u3001\u5220\u9664\u3001\u89E3\u51B3\u51B2\u7A81 \u2192 \u63A8\u8FDF\u5230 owner \u663E\u5F0F\u8BF4\u300C\u6574\u7406\u8BB0\u5FC6\u300D\u65F6\u79BB\u7EBF\u505A\u3002UPDATE/DELETE \u7684\u65E7\u6761\u76EE\u79FB `archive/`(\u6CE8\u4E00\u53E5\u539F\u56E0+\u5BF9\u5E94 commit),\u4E0D\u624B\u5199 superseded \u6233,\u4E0D\u7269\u7406\u5220;archive/ \u7684\u957F\u671F\u6E05\u7406\u4EA4\u7ED9 git history\u3002",
+    "- \u88C1\u51B3\u4EE5 source \u4F18\u5148:user \u4EB2\u53E3\u8BF4\u7684 >> agent \u63A8\u65AD;\u51B2\u7A81\u65F6\u4FDD\u7559\u65E7\u7684 user \u6761\u76EE,\u628A\u65B0\u63A8\u65AD\u964D\u7EA7\u4E3A candidate\u3002\u540C source \u5185 recency \u4EE5 git \u5386\u53F2\u4E3A\u51C6,\u4E0D\u624B\u5199\u65E5\u671F\u6233\u3002",
+    "- \u53EA\u6709\u8DE8 session \u8FD8\u4F1A\u7528\u5230\u7684\u624D\u8FDB\u8FD9\u91CC(\u5355\u6B21\u4EFB\u52A1\u7559\u5728 session summary)\u3002\u672C\u6587\u4EF6\u4FDD\u6301\u7B80\u77ED(\u2264~50 \u884C),\u4E0D\u653E changelog/\u7EDF\u8BA1\u3002",
+    ""
+  ].join("\n");
+}
+function renderMemoryCategorySkeleton(title) {
+  return [
+    `# ${title}`,
+    "",
+    "\u5199\u524D\u5148\u8BFB\u672C\u6587\u4EF6;\u6709\u76F8\u540C/\u76F8\u5173\u6761\u76EE\u5C31 NOOP \u4E0D\u91CD\u590D\u5199(\u6539\u5199\u3001\u5220\u9664\u3001\u79FB archive \u7559\u5230 owner \u8BF4\u300C\u6574\u7406\u8BB0\u5FC6\u300D\u65F6\u7684\u79BB\u7EBF\u6B65\u9AA4);\u4FE1\u53F7\u4E0D\u8DE8 session \u590D\u7528\u5C31\u4E0D\u5199\u3002",
+    ""
+  ].join("\n");
+}
+async function ensureMemoryScaffold(workspacePath) {
+  const memoryDir = path5.join(workspacePath, "memory");
+  await fs2.mkdir(memoryDir, { recursive: true });
+  await fs2.mkdir(path5.join(memoryDir, "assets"), { recursive: true });
+  await fs2.mkdir(path5.join(memoryDir, "archive"), { recursive: true });
+  await writeIfMissing2(path5.join(memoryDir, "index.md"), renderMemoryIndex());
+  for (const file of MEMORY_CATEGORY_FILES) {
+    await writeIfMissing2(
+      path5.join(memoryDir, file.name),
+      renderMemoryCategorySkeleton(file.title)
+    );
+  }
 }
 
 // src/bridge/stateFile.ts
@@ -119265,13 +119411,7 @@ async function runV2Mode({
       );
     }
     const larkCliProfile = deriveLarkCliProfile(bot.lark_cli_profile, bot.app_id);
-    if (healthyBots.length > 1) {
-      ensureLarkCliProfile(bot.id, larkCliProfile, bot.app_id, appSecret);
-    } else {
-      if (bot.lark_cli_profile) {
-        ensureLarkCliProfile(bot.id, larkCliProfile, bot.app_id, appSecret);
-      }
-    }
+    ensureLarkCliProfile(bot.id, larkCliProfile, bot.app_id, appSecret);
     const botDir = resolveLarkwayDir(bot.id);
     const sharedReposDir = path13.join(larkwayHome(), "repos");
     const worktreesDir = path13.join(botDir, "worktrees");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "larkway",
-  "version": "0.3.10",
+  "version": "0.3.12",
   "description": "Thin bridge: Feishu thread to local Claude Code CLI",
   "license": "MIT",
   "author": "Chuck Wu (chuckwu0)",
@@ -19,6 +19,18 @@
   "bin": {
     "larkway": "bin/larkway"
   },
+  "scripts": {
+    "start": "tsx src/main.ts",
+    "cli": "tsx src/cli/index.ts",
+    "start:supervised": "bin/start-bridge.sh",
+    "dev": "tsx watch src/main.ts",
+    "build": "node scripts/build.mjs",
+    "prepack": "node scripts/build.mjs",
+    "typecheck": "tsc --noEmit",
+    "check:links": "bash bin/check-doc-links.sh",
+    "test": "vitest run",
+    "test:v0.3": "bash bin/v0.3-local-acceptance.sh"
+  },
   "dependencies": {},
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
@@ -36,6 +48,7 @@
     "qrcode-terminal": "^0.12.0",
     "zod": "^3.22.0"
   },
+  "packageManager": "pnpm@9.0.0",
   "engines": {
     "node": ">=20"
   },
@@ -43,16 +56,5 @@
     "dist/",
     "bin/larkway",
     "README.md"
-  ],
-  "scripts": {
-    "start": "tsx src/main.ts",
-    "cli": "tsx src/cli/index.ts",
-    "start:supervised": "bin/start-bridge.sh",
-    "dev": "tsx watch src/main.ts",
-    "build": "node scripts/build.mjs",
-    "typecheck": "tsc --noEmit",
-    "check:links": "bash bin/check-doc-links.sh",
-    "test": "vitest run",
-    "test:v0.3": "bash bin/v0.3-local-acceptance.sh"
-  }
-}
+  ]
+}