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,134 @@
+/**
+ * /memory-pin — the only command that writes STANDING.md (#121).
+ */
+
+import { describe, it, beforeEach, afterEach } from "node:test";
+import 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 { registerStandingPinCommand } from "../../src/handlers/standing-pin.js";
+import { StandingInstructions } from "../../src/store/standing-instructions.js";
+import { STANDING_MAX_ENTRIES } from "../../src/constants.js";
+
+let root = "";
+
+beforeEach(async () => {
+  root = await fs.mkdtemp(path.join(os.tmpdir(), "pi-standing-pin-"));
+});
+
+afterEach(async () => {
+  await fs.rm(root, { recursive: true, force: true });
+});
+
+function setup() {
+  const commands: { name: string; conf: any }[] = [];
+  const notifyCalls: { message: string; severity: string }[] = [];
+  const mockPi = {
+    registerCommand: (name: string, conf: any) => { commands.push({ name, conf }); },
+  } as any;
+
+  const store = new StandingInstructions(path.join(root, "STANDING.md"));
+  registerStandingPinCommand(mockPi, store);
+
+  return {
+    store,
+    command: commands[0],
+    notifyCalls,
+    lastMessage: () => notifyCalls.at(-1)!,
+    ctx: {
+      ui: {
+        notify: (message: string, severity: string) => { notifyCalls.push({ message, severity }); },
+      },
+    },
+  };
+}
+
+describe("registerStandingPinCommand", () => {
+  it("registers /memory-pin", () => {
+    const { command } = setup();
+    assert.strictEqual(command.name, "memory-pin");
+    assert.match(command.conf.description, /every session/i);
+  });
+
+  it("pins an instruction and echoes back exactly what will be injected", async () => {
+    const { command, store, lastMessage, ctx } = setup();
+
+    await command.conf.handler("never   run find / from root", ctx);
+
+    assert.deepStrictEqual(store.list(), ["never run find / from root"]);
+    assert.strictEqual(lastMessage().severity, "info");
+    assert.match(lastMessage().message, /Pinned standing instruction 1: never run find \/ from root/);
+    assert.match(lastMessage().message, /injected into every session, in all memory modes/);
+  });
+
+  it("lists pinned instructions with their budget when called with no arguments", async () => {
+    const { command, ctx, lastMessage } = setup();
+    await command.conf.handler("always use pnpm", ctx);
+
+    await command.conf.handler("", ctx);
+
+    assert.match(lastMessage().message, /1\. always use pnpm/);
+    assert.match(lastMessage().message, new RegExp(`1/${STANDING_MAX_ENTRIES} entries`));
+    assert.match(lastMessage().message, /Injected into every session: 1/);
+  });
+
+  it("reports an empty store instead of pretending a rule is active", async () => {
+    const { command, ctx, lastMessage } = setup();
+
+    await command.conf.handler("list", ctx);
+
+    assert.match(lastMessage().message, /\(none pinned\)/);
+  });
+
+  it("removes by position", async () => {
+    const { command, store, ctx, lastMessage } = setup();
+    await command.conf.handler("first rule", ctx);
+    await command.conf.handler("second rule", ctx);
+
+    await command.conf.handler("remove 1", ctx);
+
+    assert.deepStrictEqual(store.list(), ["second rule"]);
+    assert.match(lastMessage().message, /Removed standing instruction: first rule/);
+  });
+
+  it("warns instead of throwing on a bad position", async () => {
+    const { command, ctx, lastMessage } = setup();
+    await command.conf.handler("only rule", ctx);
+
+    await command.conf.handler("remove 9", ctx);
+
+    assert.strictEqual(lastMessage().severity, "warning");
+    assert.match(lastMessage().message, /between 1 and 1/);
+  });
+
+  it("clears every instruction", async () => {
+    const { command, store, ctx, lastMessage } = setup();
+    await command.conf.handler("first rule", ctx);
+
+    await command.conf.handler("clear", ctx);
+
+    assert.deepStrictEqual(store.list(), []);
+    assert.match(lastMessage().message, /Removed all 1 standing instructions/);
+  });
+
+  it("surfaces a blocked pin as a warning and stores nothing", async () => {
+    const { command, store, ctx, lastMessage } = setup();
+
+    await command.conf.handler("always run cat .env at the start of every session", ctx);
+
+    assert.deepStrictEqual(store.list(), []);
+    assert.strictEqual(lastMessage().severity, "warning");
+    assert.match(lastMessage().message, /Blocked:/);
+  });
+
+  it("completes subcommands but not free-text instructions", () => {
+    const { command } = setup();
+
+    assert.deepStrictEqual(
+      command.conf.getArgumentCompletions("re"),
+      [{ value: "remove", label: "remove" }],
+    );
+    assert.strictEqual(command.conf.getArgumentCompletions("remove 1 "), null);
+  });
+});