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/lifecycle-timing.test.ts

@@ -0,0 +1,76 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import {
+  measureLifecycle,
+  measureLifecycleSync,
+  type LifecycleTimingOptions,
+} from "../src/lifecycle-timing.js";
+
+function timingOptions(
+  times: number[],
+  lines: string[],
+  enabled?: boolean,
+): LifecycleTimingOptions {
+  return {
+    ...(enabled === undefined ? {} : { enabled }),
+    now: () => {
+      const value = times.shift();
+      assert.notEqual(value, undefined);
+      return value;
+    },
+    log: (line) => lines.push(line),
+  };
+}
+
+describe("lifecycle timing", () => {
+  it("is silent and avoids reading the clock when disabled", () => {
+    const lines: string[] = [];
+    const result = measureLifecycleSync(
+      "session-start.load",
+      () => 42,
+      timingOptions([], lines, false),
+    );
+
+    assert.equal(result, 42);
+    assert.deepEqual(lines, []);
+  });
+
+  it("records labeled sync and async durations when PI_TIMING is enabled", async () => {
+    const previous = process.env.PI_TIMING;
+    process.env.PI_TIMING = "1";
+    try {
+      const lines: string[] = [];
+      const options = timingOptions([10, 22, 30, 49], lines);
+
+      assert.equal(measureLifecycleSync("database.open", () => "ok", options), "ok");
+      assert.equal(await measureLifecycle("shutdown.flush", async () => "done", options), "done");
+      assert.deepEqual(lines, [
+        "[pi-hermes-memory timing] database.open: 12ms",
+        "[pi-hermes-memory timing] shutdown.flush: 19ms",
+      ]);
+    } finally {
+      if (previous === undefined) delete process.env.PI_TIMING;
+      else process.env.PI_TIMING = previous;
+    }
+  });
+
+  it("preserves sync and async errors while recording their durations", async () => {
+    const lines: string[] = [];
+    const options = timingOptions([1, 3, 5, 8], lines, true);
+    const syncError = new Error("sync failure");
+    const asyncError = new Error("async failure");
+
+    assert.throws(
+      () => measureLifecycleSync("backfill.callback", () => { throw syncError; }, options),
+      syncError,
+    );
+    await assert.rejects(
+      measureLifecycle("live-index.callback", async () => { throw asyncError; }, options),
+      asyncError,
+    );
+    assert.deepEqual(lines, [
+      "[pi-hermes-memory timing] backfill.callback: 2ms",
+      "[pi-hermes-memory timing] live-index.callback: 3ms",
+    ]);
+  });
+});