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,120 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { execFileSync } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { detectProject, detectProjectSkills } from "../src/project.js";
+import { AGENT_ROOT } from "../src/paths.js";
+
+function git(cwd: string, ...args: string[]): void {
+  execFileSync("git", args, {
+    cwd,
+    stdio: "ignore",
+    env: {
+      ...process.env,
+      GIT_AUTHOR_NAME: "t",
+      GIT_AUTHOR_EMAIL: "t@example.com",
+      GIT_COMMITTER_NAME: "t",
+      GIT_COMMITTER_EMAIL: "t@example.com",
+    },
+  });
+}
+
+/** Real repo with one commit plus a linked worktree, since #120 is entirely about worktree layout. */
+function makeRepoWithWorktree(): { root: string; repo: string; worktree: string } {
+  const root = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "hermes-project-")));
+  const repo = path.join(root, "my-project");
+  fs.mkdirSync(path.join(repo, "packages", "api"), { recursive: true });
+  git(root, "init", "-q", "-b", "main", "my-project");
+  fs.writeFileSync(path.join(repo, "README.md"), "x\n");
+  git(repo, "add", ".");
+  git(repo, "commit", "-qm", "init");
+
+  const worktree = path.join(root, "worktrees", "issue-123");
+  git(repo, "worktree", "add", "-q", "-b", "issue-123", worktree);
+
+  return { root, repo, worktree };
+}
+
+describe("project detection", () => {
+  it("detectProject returns null outside a project", () => {
+    const result = detectProject("projects-memory", os.homedir());
+    assert.deepStrictEqual(result, { name: null, memoryDir: null });
+  });
+
+  it("detectProject resolves the project memory directory from cwd", () => {
+    const cwd = "/tmp/demo-repo";
+    const result = detectProject("projects-memory", cwd);
+
+    assert.strictEqual(result.name, "demo-repo");
+    assert.strictEqual(
+      result.memoryDir,
+      path.join(AGENT_ROOT, "projects-memory", "demo-repo"),
+    );
+  });
+
+  it("detectProjectSkills appends the skills directory for dynamic discovery", () => {
+    const cwd = "/tmp/demo-repo";
+    const result = detectProjectSkills("projects-memory", cwd);
+
+    assert.strictEqual(result.name, "demo-repo");
+    assert.strictEqual(
+      result.skillsDir,
+      path.join(AGENT_ROOT, "projects-memory", "demo-repo", "skills"),
+    );
+  });
+});
+
+describe("git worktree project identity (#120)", () => {
+  it("gives a linked worktree the same project identity as its main checkout", () => {
+    const { root, repo, worktree } = makeRepoWithWorktree();
+    try {
+      assert.strictEqual(detectProject("projects-memory", repo).name, "my-project");
+      assert.strictEqual(detectProject("projects-memory", worktree).name, "my-project");
+      assert.strictEqual(
+        detectProject("projects-memory", worktree).memoryDir,
+        detectProject("projects-memory", repo).memoryDir,
+      );
+    } finally {
+      fs.rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("scopes a subdirectory of the repository to the repository", () => {
+    const { root, repo } = makeRepoWithWorktree();
+    try {
+      assert.strictEqual(
+        detectProject("projects-memory", path.join(repo, "packages", "api")).name,
+        "my-project",
+      );
+    } finally {
+      fs.rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("keeps using an existing cwd-basename store instead of orphaning it", () => {
+    const { root, repo } = makeRepoWithWorktree();
+    const legacy = path.join(AGENT_ROOT, "projects-memory", "api");
+    const legacyPreexisting = fs.existsSync(legacy);
+    try {
+      fs.mkdirSync(legacy, { recursive: true });
+      assert.strictEqual(
+        detectProject("projects-memory", path.join(repo, "packages", "api")).name,
+        "api",
+      );
+    } finally {
+      if (!legacyPreexisting) fs.rmSync(legacy, { recursive: true, force: true });
+      fs.rmSync(root, { recursive: true, force: true });
+    }
+  });
+
+  it("falls back to the directory basename outside a repository", () => {
+    const dir = fs.realpathSync(fs.mkdtempSync(path.join(os.tmpdir(), "hermes-nogit-")));
+    try {
+      assert.strictEqual(detectProject("projects-memory", dir).name, path.basename(dir));
+    } finally {
+      fs.rmSync(dir, { recursive: true, force: true });
+    }
+  });
+});