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-27 11:15:23 +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,75 @@
+/**
+ * Switch project command — /memory-switch-project lets users manually
+ * set the active project for project-scoped memory.
+ *
+ * Normally, the project is auto-detected from cwd at extension load.
+ * This command is useful when the user wants to view or manage memory
+ * for a project they're not currently in.
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { MemoryConfig } from "../types.js";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { resolveProjectsRoot } from "../paths.js";
+
+export function registerSwitchProjectCommand(pi: ExtensionAPI, config?: MemoryConfig): void {
+  const projectsMemoryDir = config?.projectsMemoryDir ?? "projects-memory";
+  pi.registerCommand("memory-switch-project", {
+    description: "Switch the active project for project-scoped memory",
+
+    async handler(_args, ctx) {
+      const projectsDir = resolveProjectsRoot(projectsMemoryDir);
+
+      // Discover all project directories (subdirectories of projects-memory/ that have MEMORY.md)
+      let projects: string[] = [];
+      try {
+        const entries = await fs.readdir(projectsDir, { withFileTypes: true });
+        for (const entry of entries) {
+          if (!entry.isDirectory()) continue;
+          try {
+            await fs.access(path.join(projectsDir, entry.name, "MEMORY.md"));
+            projects.push(entry.name);
+          } catch { /* no MEMORY.md — skip */ }
+        }
+      } catch {
+        // Directory doesn't exist — no projects
+      }
+
+      if (projects.length === 0) {
+        ctx.ui.notify(
+          "\n  📁 No project memories found.\n\n  Project memory is automatically created when you use memory_add with\n  target 'project' while working in a project directory.\n",
+          "info",
+        );
+        return;
+      }
+
+      const lines: string[] = [];
+      lines.push("");
+      lines.push("  ╔══════════════════════════════════════════════╗");
+      lines.push("  ║        📁 Project Memory — Switch           ║");
+      lines.push("  ╚══════════════════════════════════════════════╝");
+      lines.push("");
+      lines.push("  Available project memories:");
+      lines.push("");
+
+      for (const proj of projects.sort()) {
+        // Read entry count
+        let entryCount = 0;
+        try {
+          const raw = await fs.readFile(path.join(projectsDir, proj, "MEMORY.md"), "utf-8");
+          entryCount = raw.split("\n§\n").filter(Boolean).length;
+        } catch { /* ignore */ }
+
+        lines.push(`  📁 ${proj} (${entryCount} ${entryCount === 1 ? "entry" : "entries"})`);
+      }
+
+      lines.push("");
+      lines.push("  Use memory_add with target 'project' to manage");
+      lines.push("  project-scoped memory. Project is auto-detected from");
+      lines.push(`  your current directory: ${process.cwd()}`);
+
+      ctx.ui.notify(lines.join("\n"), "info");
+    },
+  });
+}