hippocamp 0.2.10 → 0.2.11

package/docs/how-it-works.md

@@ -78,7 +78,7 @@ Event writes update a sibling `events/YYYY-MM-DD.index.json` file. The Markdown
 
 - Keep memory concise.
 - Prefer curated summaries over raw event history.
-- Give events a short `Keywords:` section; keywords weigh the most in search ranking. Older events with a `Cues:` section still search the same way.
+- Give events a short `Keywords:` section; keywords weigh the most in search ranking. `append_event` writes each keyword as a `[[keyword]]` wiki link, so a graph view such as Obsidian's groups events by topic. Older events with plain keywords or a `Cues:` section still search the same way.
 - Do not duplicate GitHub-owned facts such as commits, PRs, issues, reviews, or CI results.
 - Store artifact references plus the missing rationale, preference, assumption, or follow-up context.
 - Use project scope for project-specific state.
@@ -93,9 +93,9 @@ Agent: claude
 Session: mcp-a1b2c3d4
 
 Keywords:
-- local-first
-- token-free
-- install-story
+- [[local-first]]
+- [[token-free]]
+- [[install-story]]
 
 References:
 - commit: abc1234

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hippocamp",
-  "version": "0.2.10",
+  "version": "0.2.11",
   "private": false,
   "description": "Local Git-backed memory for AI agents.",
   "license": "MIT",

package/scripts/hippocamp-memory.cjs

@@ -79,7 +79,20 @@ function getGlobalRoot() {
 }
 
 function getProjectRoot(projectRoot) {
-  return path.resolve(expandHomePath(projectRoot || process.env.HIPPOCAMP_PROJECT_ROOT || process.cwd()));
+  return path.resolve(expandHomePath(projectRoot || process.env.HIPPOCAMP_PROJECT_ROOT || getWorkingDirectory()));
+}
+
+// A long-running MCP server keeps its cwd after the worktree it started in is deleted.
+function getWorkingDirectory() {
+  try {
+    return process.cwd();
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
+
+    throw new Error("The working directory no longer exists, likely a deleted worktree. Pass projectRoot.");
+  }
 }
 
 function findGitRootSync(startPath) {
@@ -140,7 +153,9 @@ function isProjectRepository(projectRoot) {
 }
 
 function slugifyProjectName(value) {
+  // macOS can report the same accented folder name in NFC or NFD form.
   const slug = value
+    .normalize("NFC")
     .toLowerCase()
     .replace(/[^a-z0-9._-]+/g, "-")
     .replace(/^-+|-+$/g, "");
@@ -297,7 +312,8 @@ function formatKeywordsSection(keywords) {
     return "";
   }
 
-  return ["Keywords:", ...normalizedKeywords.map((keyword) => `- ${keyword}`)].join("\n");
+  // Wiki links let Obsidian-style graph views group events by keyword.
+  return ["Keywords:", ...normalizedKeywords.map((keyword) => `- [[${keyword}]]`)].join("\n");
 }
 
 function normalizeAgentName(value) {

package/test/memory-efficiency.test.cjs

@@ -662,3 +662,57 @@ test("an empty folder has no project and uses global memory", async (t) => {
   // A folder that does not exist keeps its name, as Dream's synthetic roots do.
   assert.equal(memory.getProjectSlug(path.join(tempRoot, "missing")), "missing");
 });
+
+test("Project slug is the same for NFC and NFD folder names", () => {
+  const name = "Génération IA";
+  assert.equal(memory.getProjectSlug(`/tmp/${name.normalize("NFC")}`), "g-n-ration-ia");
+  assert.equal(memory.getProjectSlug(`/tmp/${name.normalize("NFD")}`), "g-n-ration-ia");
+});
+
+test("A deleted working directory asks for projectRoot", async (t) => {
+  const originalCwd = process.cwd();
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), "hippocamp-deleted-cwd-"));
+  t.after(() => process.chdir(originalCwd));
+  process.chdir(tempRoot);
+  await fs.rm(tempRoot, { recursive: true });
+
+  assert.throws(() => memory.getProjectRoot(), /Pass projectRoot/);
+});
+
+test("event keywords are written as wiki links and still indexed as plain keywords", async (t) => {
+  const originalRoot = process.env.HIPPOCAMP_GLOBAL_ROOT;
+  const tempRoot = await fs.mkdtemp(path.join(os.tmpdir(), "hippocamp-wiki-links-"));
+  const projectRoot = path.join(tempRoot, "wiki-links-project");
+
+  process.env.HIPPOCAMP_GLOBAL_ROOT = path.join(tempRoot, "lagoon");
+  await fs.mkdir(projectRoot, { recursive: true });
+  t.after(async () => {
+    if (originalRoot === undefined) {
+      delete process.env.HIPPOCAMP_GLOBAL_ROOT;
+    } else {
+      process.env.HIPPOCAMP_GLOBAL_ROOT = originalRoot;
+    }
+    await fs.rm(tempRoot, { recursive: true, force: true });
+  });
+
+  const event = await memory.appendEvent({
+    content: "Graph views group events by keyword.",
+    keywords: ["Knowledge Graph", "obsidian"],
+    projectRoot,
+    scope: "project",
+    sync: false,
+    timestamp: "2026-10-16T09:00:00.000Z",
+    title: "Graph note",
+  });
+
+  const content = await fs.readFile(path.join(event.root, event.path), "utf8");
+  const index = JSON.parse(await fs.readFile(event.indexPath, "utf8"));
+
+  assert.match(content, /Keywords:\n- \[\[knowledge-graph\]\]\n- \[\[obsidian\]\]/);
+  assert.match(JSON.stringify(index), /"knowledge-graph"/);
+  assert.doesNotMatch(JSON.stringify(index), /\[\[/);
+
+  const search = await memory.searchMemory({ projectRoot, query: "obsidian", scope: "project" });
+
+  assert.deepEqual(search.results[0].keywords, ["knowledge-graph", "obsidian"]);
+});