feat(pi-hermes-memory): 导入上游 v0.9.10 源码快照

从官方 Git 仓库导入 chandra447/pi-hermes-memory 在 tag v0.9.10 （df624056a2e8c68bc89ba0a81e1c120856ec9665，2026-10-02）的源码快照。本次仅导入源码，尚未接入组合包：package.json、加载顺序、依赖与权限策略均未改动。 - 原样导入 src/、tests/、docs/、scripts/、README、CHANGELOG、PLAN、 AGENTS 与 LICENSE；该快照共 156 个上游文件。 - 剔除嵌套 .git、上游 .github 工作流、.ralph/、.claude/、node_modules、覆盖率与构建产物。 - 新增中文 UPSTREAM.md，记录来源，以及启用前必须完成的待决事项：在 pi-compaction 之前注册加载顺序、better-sqlite3 版本与根 allowScripts 对齐、strip-ansi 解析确认。 - 说明选择 tag 而非 main 的原因：导入时上游 main 已领先至 24fcd8ad26fc27badb8d7dbaf8034645de07b893（2026-10-11），选 tag 是为对应一个已发布、可复现的版本。尚未接线。启用前还需反转 tests/extension-load.test.ts 中"不得加载 Hermes"的断言，并同步 pi-tool-search 分组、权限策略与文档。验证：快照 156 个上游文件全部导入，目录内仅多出 UPSTREAM.md 一份；已确认与上游 main 内容存在差异，证明取的是 tag 而非 main。
2026-10-26 10:45:22 +00:00 · 2026-10-13 23:19:35 -07:00
parent 879fc5d37f
commit 312bb2ba5a
157 changed files with 52287 additions and 0 deletions
@@ -0,0 +1,109 @@
+import * as assert from "node:assert/strict";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { describe, it } from "node:test";
+
+interface MockPi {
+  handlers: Record<string, Array<(event: any, ctx: any) => unknown>>;
+  tools: Record<string, { execute: (...args: any[]) => Promise<any> }>;
+  on(event: string, handler: (event: any, ctx: any) => unknown): void;
+  registerTool(def: { name: string; execute: (...args: any[]) => Promise<any> }): void;
+  registerCommand(): void;
+}
+
+describe("session project memory rebinding", () => {
+  it("writes project memory using session cwd when factory cwd differs", async () => {
+    const agentRoot = await fs.mkdtemp(path.join(os.tmpdir(), "pi-project-rebind-agent-"));
+    const launchDir = await fs.mkdtemp(path.join(os.tmpdir(), "pi-project-rebind-launch-"));
+    const targetDir = await fs.mkdtemp(path.join(os.tmpdir(), "pi-project-rebind-target-"));
+    const previousAgentRoot = process.env.PI_CODING_AGENT_DIR;
+    const previousCwd = process.cwd();
+    try {
+      await fs.writeFile(
+        path.join(agentRoot, "hermes-memory-config.json"),
+        JSON.stringify({
+          memoryMode: "legacy-inject",
+          reviewEnabled: false,
+          flushOnCompact: false,
+          flushOnShutdown: false,
+          autoConsolidate: false,
+          correctionDetection: false,
+          standingInstructionsEnabled: false,
+        }),
+      );
+      const launchMemoryDir = path.join(agentRoot, "projects-memory", path.basename(launchDir));
+      const sessionMemoryDir = path.join(agentRoot, "projects-memory", path.basename(targetDir));
+      await fs.mkdir(launchMemoryDir, { recursive: true });
+      await fs.mkdir(sessionMemoryDir, { recursive: true });
+      await fs.writeFile(
+        path.join(launchMemoryDir, "MEMORY.md"),
+        "launch-directory memory",
+      );
+      await fs.writeFile(
+        path.join(sessionMemoryDir, "MEMORY.md"),
+        "active-session memory",
+      );
+
+      process.env.PI_CODING_AGENT_DIR = agentRoot;
+      process.chdir(launchDir);
+      // Import after setting PI_CODING_AGENT_DIR so AGENT_ROOT is test-local.
+      const { default: registerExtension } = await import("../src/index.js");
+      const mockPi: MockPi = {
+        handlers: {},
+        tools: {},
+        on(event, handler) {
+          (this.handlers[event] ??= []).push(handler);
+        },
+        registerTool(def) {
+          this.tools[def.name] = def;
+        },
+        registerCommand() {},
+      };
+      registerExtension(mockPi as any);
+
+      const sessionStart = mockPi.handlers.session_start?.[0];
+      const resourcesDiscover = mockPi.handlers.resources_discover?.[0];
+      const beforeAgentStart = mockPi.handlers.before_agent_start?.[0];
+      assert.ok(sessionStart);
+      assert.ok(resourcesDiscover);
+      assert.ok(beforeAgentStart);
+      assert.ok(mockPi.tools.memory_add);
+
+      const sessionCtx = {
+        cwd: targetDir,
+        sessionManager: { getBranch: () => [] },
+        ui: { notify() {} },
+      };
+
+      // Pi lifecycle: session_start, then resources_discover, then tool execute.
+      await sessionStart({}, sessionCtx);
+      await resourcesDiscover({ cwd: targetDir, reason: "startup" }, sessionCtx);
+
+      const result = await beforeAgentStart({ systemPrompt: "base" }, sessionCtx) as { systemPrompt: string };
+      assert.match(result.systemPrompt, /active-session memory/);
+      assert.doesNotMatch(result.systemPrompt, /launch-directory memory/);
+
+      const writeResult = await mockPi.tools.memory_add.execute(
+        "tc-session-cwd",
+        { target: "project", content: "session-cwd write" },
+        undefined,
+        undefined,
+        { cwd: targetDir },
+      );
+      assert.equal(writeResult.details.success, true);
+
+      const sessionMemory = await fs.readFile(path.join(sessionMemoryDir, "MEMORY.md"), "utf-8");
+      const launchMemory = await fs.readFile(path.join(launchMemoryDir, "MEMORY.md"), "utf-8");
+      assert.match(sessionMemory, /session-cwd write/);
+      assert.doesNotMatch(launchMemory, /session-cwd write/);
+    } finally {
+      process.chdir(previousCwd);
+      if (previousAgentRoot === undefined) delete process.env.PI_CODING_AGENT_DIR;
+      else process.env.PI_CODING_AGENT_DIR = previousAgentRoot;
+      await fs.rm(agentRoot, { recursive: true, force: true });
+      await fs.rm(launchDir, { recursive: true, force: true });
+      await fs.rm(targetDir, { recursive: true, force: true });
+    }
+  });
+});