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。

pi-hermes-memory/tests/handlers/interview.test.ts

@@ -0,0 +1,127 @@
+/**
+ * Unit tests for /memory-interview command.
+ */
+
+import { describe, it, beforeEach } from "node:test";
+import assert from "node:assert/strict";
+import { registerInterviewCommand } from "../../src/handlers/interview.js";
+
+// ─── Mock infrastructure ───
+
+let handlers: Record<string, Function[]>;
+let notifyCalls: Array<{ msg: string; level: string }>;
+let sentMessages: string[];
+
+function createMockPi() {
+  const pi = {
+    on: () => {},
+    registerTool: () => {},
+    registerCommand: (_name: string, opts: { description: string; handler: Function }) => {
+      handlers[_name] = [{ fn: opts.handler, desc: opts.description }];
+    },
+    sendUserMessage: (text: string) => {
+      sentMessages.push(text);
+    },
+  };
+  return pi;
+}
+
+function makeMockCtx() {
+  return {
+    sessionManager: { getBranch: () => [] },
+    signal: undefined as any,
+    ui: {
+      notify: (msg: string, level: string) => {
+        notifyCalls.push({ msg, level });
+      },
+    },
+    waitForIdle: async () => {},
+  } as any;
+}
+
+const mockStore = (entries: string[]) => ({
+  getUserEntries: () => entries,
+  getMemoryEntries: () => [],
+} as any);
+
+// ─── Tests ───
+
+describe("registerInterviewCommand", () => {
+  beforeEach(() => {
+    handlers = {};
+    notifyCalls = [];
+    sentMessages = [];
+  });
+
+  it("registers the /memory-interview command", () => {
+    const pi = createMockPi();
+    registerInterviewCommand(pi as any, mockStore([]));
+
+    const cmd = handlers["memory-interview"];
+    assert.ok(cmd, "command should be registered");
+    assert.ok(cmd.length === 1, "should have one handler");
+  });
+
+  it("command description mentions onboarding", () => {
+    const pi = createMockPi();
+    registerInterviewCommand(pi as any, mockStore([]));
+
+    const cmd = handlers["memory-interview"][0];
+    assert.ok(cmd.desc.includes("user profile"), "description should mention user profile");
+  });
+
+  it("sends interview prompt as user message when USER.md is empty", async () => {
+    const pi = createMockPi();
+    registerInterviewCommand(pi as any, mockStore([]));
+
+    const ctx = makeMockCtx();
+    await handlers["memory-interview"][0].fn(undefined, ctx);
+
+    assert.strictEqual(sentMessages.length, 1, "should send one user message");
+    assert.ok(sentMessages[0].includes("onboarding interview"), "message should be the interview prompt");
+    assert.ok(sentMessages[0].includes("timezone"), "prompt should ask about timezone");
+    assert.ok(sentMessages[0].includes("work style"), "prompt should ask about work style");
+  });
+
+  it("shows notification when USER.md already has entries", async () => {
+    const pi = createMockPi();
+    const store = mockStore(["name: Chandrateja", "prefers concise answers"]);
+    registerInterviewCommand(pi as any, store);
+
+    const ctx = makeMockCtx();
+    await handlers["memory-interview"][0].fn(undefined, ctx);
+
+    assert.ok(notifyCalls.length >= 1, "should show notification for existing entries");
+    assert.ok(
+      notifyCalls[0].msg.includes("2 profile entries"),
+      "notification should mention entry count",
+    );
+    assert.ok(
+      notifyCalls[0].msg.includes("Chandrateja"),
+      "notification should show existing entry preview",
+    );
+  });
+
+  it("still sends interview prompt even when entries exist", async () => {
+    const pi = createMockPi();
+    const store = mockStore(["existing entry"]);
+    registerInterviewCommand(pi as any, store);
+
+    const ctx = makeMockCtx();
+    await handlers["memory-interview"][0].fn(undefined, ctx);
+
+    assert.strictEqual(sentMessages.length, 1, "should still send interview prompt");
+  });
+
+  it("uses correct message count grammar (1 entry)", async () => {
+    const pi = createMockPi();
+    const store = mockStore(["one entry only"]);
+    registerInterviewCommand(pi as any, store);
+
+    const ctx = makeMockCtx();
+    await handlers["memory-interview"][0].fn(undefined, ctx);
+
+    assert.ok(notifyCalls[0].msg.includes("1 profile entry"), "should use singular");
+    assert.ok(!notifyCalls[0].msg.includes("entries"), "should NOT use plural for 1 entry");
+  });
+});