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/UPSTREAM.md

@@ -0,0 +1,23 @@
+# 上游来源
+
+- 官方仓库：<https://github.com/chandra447/pi-hermes-memory>
+- 导入发布 tag：`v0.9.10`
+- 导入 commit：`df624056a2e8c68bc89ba0a81e1c120856ec9665`（`chore: bump version to 0.9.10 (#277)`，2026-10-02）
+- 初始本地导入：2026-10-13
+- 许可证：MIT；上游 `LICENSE` 文件原样保留。
+
+快照取自官方 Git 仓库中 `v0.9.10` tag 指向的 commit。导入时上游 `main` 已领先该 tag（`24fcd8ad26fc27badb8d7dbaf8034645de07b893`，2026-10-11）；选择 tag 是为了让导入状态对应一个已发布、可复现的版本。不保留嵌套 `.git`、上游 `.github` 工作流、依赖目录、覆盖率与构建产物。
+
+## 本地维护
+
+本目录由 `my-pi` 组合包直接维护，不是 submodule。根包直接加载 `pi-hermes-memory/src/index.ts`。
+
+导入时尚未接入组合包。启用该扩展前必须先完成以下事项，记录在此以免待决决定丢失：
+
+- 根 `package.json` 必须新增本地 `file:./pi-hermes-memory` 依赖，并在 `pi.extensions` 中注册扩展入口。
+- 注册顺序很重要：该扩展必须在 `pi-compaction` **之前**加载。`ExtensionRunner.emit()` 会在遇到第一个返回 `{ cancel: true }` 的 `session_before_compact` handler 时停止，而 `pi-compaction/index.ts` 在判定无需压缩时正是这样返回。注册在它之后的 handler 在这些轮次会被跳过，从而静默禁用该扩展的 `flushOnCompact`。
+- 该扩展依赖 `better-sqlite3@^13.0.3`。根 `allowScripts` 当前只放行 `better-sqlite3@12.11.1`（Context Mode 使用）；安装前必须对齐原生构建批准。
+- `strip-ansi@7.2.0` 是第二个运行时依赖，必须能与现有依赖树干净解析。
+- 它注册 `memory_add` / `memory_replace` / `memory_remove` / `memory_search` / `session_search` / `skill_manage`，以及 `/memory-*` 命令。这些名称当前与组合包中的任何内容都不冲突。
+
+同步上游时，请从明确 tag/commit 移植改动，并与本地改动对照审查，不得整体覆盖本目录。