@askjo/pi-mem 1.0.0 → 1.2.0

package/tests/file-helpers.test.ts

@@ -2,7 +2,7 @@ import { describe, it, beforeEach, afterEach } from "node:test";
 import assert from "node:assert";
 import * as fs from "node:fs";
 import * as path from "node:path";
-import { readFileSafe, ensureDirs } from "../lib.ts";
+import { readFileSafe, ensureDirs, safeResolvePath } from "../lib.ts";
 import { makeTempDir, cleanup, makeConfig, writeFile } from "./helpers.ts";
 
 let tmpDir: string;
@@ -63,3 +63,41 @@ describe("ensureDirs", () => {
 		assert.strictEqual(fs.readFileSync(testFile, "utf-8"), "keep me");
 	});
 });
+
+describe("safeResolvePath", () => {
+	it("allows simple filenames", () => {
+		const result = safeResolvePath("/mem", "SOUL.md");
+		assert.ok(result);
+		assert.strictEqual(result.normalized, "SOUL.md");
+		assert.strictEqual(result.resolved, path.join("/mem", "SOUL.md"));
+	});
+
+	it("allows subdirectory paths", () => {
+		const result = safeResolvePath("/mem", "catchup/2026-04-26/file.md");
+		assert.ok(result);
+		assert.strictEqual(result.normalized, "catchup/2026-04-26/file.md");
+		assert.strictEqual(result.resolved, path.join("/mem", "catchup/2026-04-26/file.md"));
+	});
+
+	it("blocks .. traversal", () => {
+		assert.strictEqual(safeResolvePath("/mem", "../etc/passwd"), null);
+	});
+
+	it("blocks nested .. traversal", () => {
+		assert.strictEqual(safeResolvePath("/mem", "foo/../../etc/passwd"), null);
+	});
+
+	it("blocks deep nested .. traversal", () => {
+		assert.strictEqual(safeResolvePath("/mem", "catchup/2026/../../../etc/passwd"), null);
+	});
+
+	it("blocks absolute paths", () => {
+		assert.strictEqual(safeResolvePath("/mem", "/etc/passwd"), null);
+	});
+
+	it("allows paths that resolve within memoryDir after normalization", () => {
+		const result = safeResolvePath("/mem", "catchup/2026/../2026/file.md");
+		assert.ok(result);
+		assert.strictEqual(result.normalized, "catchup/2026/file.md");
+	});
+});

package/tests/helpers.ts

@@ -20,7 +20,9 @@ export function makeConfig(baseDir: string, overrides: Partial<MemoryConfig> = {
 		dailyDir: path.join(memoryDir, "daily"),
 		notesDir: path.join(memoryDir, "notes"),
 		contextFiles: [],
+		searchDirs: [],
 		autocommit: false,
+		timezone: "UTC",
 		...overrides,
 	};
 }

package/tests/memory-context.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, beforeEach, afterEach } from "node:test";
 import assert from "node:assert";
 import * as fs from "node:fs";
-import { buildMemoryContext, ensureDirs, todayStr, yesterdayStr } from "../lib.ts";
+import { buildMemoryContext, ensureDirs, todayStr, yesterdayStr, daysAgoStr, isLowActivity } from "../lib.ts";
 import { makeTempDir, cleanup, makeConfig, writeFile } from "./helpers.ts";
 
 let tmpDir: string;
@@ -25,30 +25,13 @@ describe("buildMemoryContext", () => {
 		assert.ok(result.includes("Important fact"));
 	});
 
-	it("includes open scratchpad items only", () => {
+	it("does not include scratchpad in context (available via tool only)", () => {
 		const config = makeConfig(tmpDir);
 		ensureDirs(config);
 		fs.writeFileSync(config.scratchpadFile, "# Scratchpad\n\n- [ ] Open task\n- [x] Done task\n", "utf-8");
 		const result = buildMemoryContext(config);
-		assert.ok(result.includes("## SCRATCHPAD.md (working context)"));
-		assert.ok(result.includes("Open task"));
-		assert.ok(!result.includes("Done task"));
-	});
-
-	it("skips scratchpad section when all items are done", () => {
-		const config = makeConfig(tmpDir);
-		ensureDirs(config);
-		fs.writeFileSync(config.scratchpadFile, "# Scratchpad\n\n- [x] Done\n", "utf-8");
-		const result = buildMemoryContext(config);
-		assert.ok(!result.includes("SCRATCHPAD"));
-	});
-
-	it("skips scratchpad section when file is empty", () => {
-		const config = makeConfig(tmpDir);
-		ensureDirs(config);
-		fs.writeFileSync(config.scratchpadFile, "", "utf-8");
-		const result = buildMemoryContext(config);
 		assert.ok(!result.includes("SCRATCHPAD"));
+		assert.ok(!result.includes("Open task"));
 	});
 
 	it("includes today's daily log", () => {
@@ -107,31 +90,86 @@ describe("buildMemoryContext", () => {
 		const config = makeConfig(tmpDir);
 		ensureDirs(config);
 		fs.writeFileSync(config.memoryFile, "Memory content", "utf-8");
-		fs.writeFileSync(config.scratchpadFile, "# Scratchpad\n\n- [ ] Task\n", "utf-8");
+		writeFile(`${config.dailyDir}/${todayStr()}.md`, "Today content");
 		const result = buildMemoryContext(config);
 		assert.ok(result.includes("---"));
 	});
 
-	it("assembles sections in correct order: context files, memory, scratchpad, today, yesterday", () => {
+	it("assembles sections in correct order: context files, memory, today, yesterday", () => {
 		const config = makeConfig(tmpDir, { contextFiles: ["SOUL.md"] });
 		ensureDirs(config);
 		writeFile(`${config.memoryDir}/SOUL.md`, "Soul content");
 		fs.writeFileSync(config.memoryFile, "Memory content", "utf-8");
-		fs.writeFileSync(config.scratchpadFile, "# Scratchpad\n\n- [ ] Task\n", "utf-8");
 		writeFile(`${config.dailyDir}/${todayStr()}.md`, "Today content");
 		writeFile(`${config.dailyDir}/${yesterdayStr()}.md`, "Yesterday content");
 
 		const result = buildMemoryContext(config);
 		const soulIdx = result.indexOf("## SOUL.md");
 		const memIdx = result.indexOf("## MEMORY.md");
-		const spIdx = result.indexOf("## SCRATCHPAD.md");
 		const todayIdx = result.indexOf("(today)");
 		const yesterdayIdx = result.indexOf("(yesterday)");
 
 		assert.ok(soulIdx < memIdx, "SOUL.md should come before MEMORY.md");
-		assert.ok(memIdx < spIdx, "MEMORY.md should come before SCRATCHPAD.md");
-		assert.ok(spIdx < todayIdx, "SCRATCHPAD should come before today");
+		assert.ok(memIdx < todayIdx, "MEMORY.md should come before today");
 		assert.ok(todayIdx < yesterdayIdx, "today should come before yesterday");
+		assert.ok(!result.includes("SCRATCHPAD"), "scratchpad should not be in context");
+	});
+
+	it("includes catchup INDEX.md for today when it exists", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		const today = todayStr();
+		writeFile(`${config.memoryDir}/catchup/${today}/INDEX.md`, "Catchup summary for today");
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes(`## Catchup: ${today} (today)`));
+		assert.ok(result.includes("Catchup summary for today"));
+		assert.ok(result.includes("memory_read"), "should include tool hint");
+	});
+
+	it("includes catchup INDEX.md for yesterday when it exists", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		const yesterday = yesterdayStr();
+		writeFile(`${config.memoryDir}/catchup/${yesterday}/INDEX.md`, "Catchup summary for yesterday");
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes(`## Catchup: ${yesterday} (yesterday)`));
+		assert.ok(result.includes("Catchup summary for yesterday"));
+	});
+
+	it("does not include catchup when INDEX.md does not exist", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		const result = buildMemoryContext(config);
+		assert.ok(!result.includes("Catchup"));
+	});
+
+	it("catchup appears after daily logs", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		const today = todayStr();
+		fs.writeFileSync(config.memoryFile, "Memory", "utf-8");
+		writeFile(`${config.dailyDir}/${today}.md`, "Daily log");
+		writeFile(`${config.memoryDir}/catchup/${today}/INDEX.md`, "Catchup index");
+		const result = buildMemoryContext(config);
+		const dailyIdx = result.indexOf("(today)");
+		const catchupIdx = result.indexOf("Catchup:");
+		assert.ok(dailyIdx < catchupIdx, "daily log should come before catchup");
+	});
+
+	it("truncates large catchup INDEX.md at ~2KB", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		const today = todayStr();
+		// Generate 50 lines of ~100 chars each = ~5KB
+		const lines = Array.from({ length: 50 }, (_, i) =>
+			`💬 Chat ${i} — ${"x".repeat(80)} <!-- file:chat_${i}.md -->`
+		).join("\n");
+		writeFile(`${config.memoryDir}/catchup/${today}/INDEX.md`, lines);
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes("more entries"), "should show truncation notice");
+		assert.ok(result.includes("memory_read"), "truncation notice should mention memory_read");
+		// Should not contain the last entry
+		assert.ok(!result.includes("Chat 49"), "should not include last entries");
 	});
 
 	it("includes multiple context files in order", () => {
@@ -148,3 +186,140 @@ describe("buildMemoryContext", () => {
 		assert.ok(bIdx < cIdx);
 	});
 });
+
+describe("isLowActivity", () => {
+	it("returns true when no daily logs exist", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		assert.strictEqual(isLowActivity(config), true);
+	});
+
+	it("returns true when daily logs are empty/short for all 3 days", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		writeFile(`${config.dailyDir}/${todayStr()}.md`, "hi");
+		writeFile(`${config.dailyDir}/${yesterdayStr()}.md`, "");
+		writeFile(`${config.dailyDir}/${daysAgoStr(2)}.md`, "tiny");
+		assert.strictEqual(isLowActivity(config), true);
+	});
+
+	it("returns false when 2+ days have substantial daily logs", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		// 50+ bytes = substantial activity
+		writeFile(`${config.dailyDir}/${todayStr()}.md`, "A".repeat(60));
+		writeFile(`${config.dailyDir}/${yesterdayStr()}.md`, "B".repeat(80));
+		assert.strictEqual(isLowActivity(config), false);
+	});
+
+	it("returns true when only 1 day has substantial activity", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		writeFile(`${config.dailyDir}/${todayStr()}.md`, "A".repeat(60));
+		// yesterday and 2 days ago are empty
+		assert.strictEqual(isLowActivity(config), true);
+	});
+});
+
+describe("buildMemoryContext rollup mode", () => {
+	it("injects Rollup Mode section when user has low activity", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		// No daily logs = low activity
+		// Add catchup for 3 days ago
+		const threeAgo = daysAgoStr(3);
+		writeFile(`${config.memoryDir}/catchup/${threeAgo}/INDEX.md`, "💬 Old chat — summary");
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes("⚡ Rollup Mode"), "should include rollup mode indicator");
+		assert.ok(result.includes("Low activity detected"), "should include activity explanation");
+	});
+
+	it("includes catchup from 5+ days ago in rollup mode", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		// No daily logs = low activity
+		const fiveAgo = daysAgoStr(5);
+		writeFile(`${config.memoryDir}/catchup/${fiveAgo}/INDEX.md`, "💬 Five days ago chat — important");
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes("Five days ago chat"), "should include 5-day-old catchup in rollup mode");
+		assert.ok(result.includes("5 days ago"), "should show relative label");
+	});
+
+	it("does NOT include rollup mode when user is active", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		writeFile(`${config.dailyDir}/${todayStr()}.md`, "Active user entry " + "x".repeat(60));
+		writeFile(`${config.dailyDir}/${yesterdayStr()}.md`, "Also active yesterday " + "x".repeat(60));
+		const fiveAgo = daysAgoStr(5);
+		writeFile(`${config.memoryDir}/catchup/${fiveAgo}/INDEX.md`, "💬 Old chat — should not appear");
+		const result = buildMemoryContext(config);
+		assert.ok(!result.includes("Rollup Mode"), "should NOT include rollup mode for active users");
+		assert.ok(!result.includes("Old chat — should not appear"), "should NOT include old catchup for active users");
+	});
+
+	it("only includes today and yesterday catchup when user is active", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		writeFile(`${config.dailyDir}/${todayStr()}.md`, "Active user " + "x".repeat(60));
+		writeFile(`${config.dailyDir}/${yesterdayStr()}.md`, "Active yesterday " + "x".repeat(60));
+		const today = todayStr();
+		const yesterday = yesterdayStr();
+		const threeAgo = daysAgoStr(3);
+		writeFile(`${config.memoryDir}/catchup/${today}/INDEX.md`, "Today catchup");
+		writeFile(`${config.memoryDir}/catchup/${yesterday}/INDEX.md`, "Yesterday catchup");
+		writeFile(`${config.memoryDir}/catchup/${threeAgo}/INDEX.md`, "Old catchup");
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes("Today catchup"));
+		assert.ok(result.includes("Yesterday catchup"));
+		assert.ok(!result.includes("Old catchup"), "should not include 3-day-old catchup in normal mode");
+	});
+
+	it("respects total catchup byte budget in rollup mode", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		// Create large catchup files for 7 days — should hit the 8KB total budget
+		for (let i = 0; i < 7; i++) {
+			const date = daysAgoStr(i);
+			// Each INDEX.md is ~2KB
+			const content = Array.from({ length: 20 }, (_, j) =>
+				`💬 Chat ${j} day-${i} — ${"x".repeat(80)}`
+			).join("\n");
+			writeFile(`${config.memoryDir}/catchup/${date}/INDEX.md`, content);
+		}
+		const result = buildMemoryContext(config);
+		// Should not include all 7 days due to budget
+		assert.ok(result.includes("Rollup Mode"));
+		// day 0 should be there
+		assert.ok(result.includes("day-0"));
+		// Verify it doesn't blow past budget by checking not ALL days are present
+		// The total catchup content should be bounded
+		const catchupParts = result.split("## Catchup:");
+		assert.ok(catchupParts.length <= 8, `should not have too many catchup sections (got ${catchupParts.length - 1})`);
+	});
+
+	it("truncates individual day catchup at reduced cap in rollup mode", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		const today = todayStr();
+		// Generate large INDEX.md (3KB) for today — should be truncated at 1KB in rollup
+		const lines = Array.from({ length: 40 }, (_, i) =>
+			`💬 Chat ${i} — ${"y".repeat(60)} <!-- file:chat_${i}.md -->`
+		).join("\n");
+		writeFile(`${config.memoryDir}/catchup/${today}/INDEX.md`, lines);
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes("more entries"), "should truncate in rollup mode at smaller cap");
+	});
+
+	it("skips days with no catchup INDEX.md gracefully", () => {
+		const config = makeConfig(tmpDir);
+		ensureDirs(config);
+		// Only day 0 and day 4 have catchup, days 1-3 and 5-6 don't
+		writeFile(`${config.memoryDir}/catchup/${todayStr()}/INDEX.md`, "Today stuff");
+		writeFile(`${config.memoryDir}/catchup/${daysAgoStr(4)}/INDEX.md`, "Four days ago");
+		const result = buildMemoryContext(config);
+		assert.ok(result.includes("Today stuff"));
+		assert.ok(result.includes("Four days ago"));
+		// Should not error or include empty sections
+		assert.ok(!result.includes("## Catchup: undefined"));
+	});
+});

package/tests/memory-read.test.ts

@@ -0,0 +1,84 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert/strict";
+import * as path from "node:path";
+import { cleanup, makeConfig, makeTempDir, writeFile } from "./helpers.ts";
+import { ensureDirs, resolveIndexedFile, readMemoryFile } from "../lib.ts";
+
+let tmpDir: string;
+
+function seedIndexedDirectory() {
+	const config = makeConfig(tmpDir);
+	ensureDirs(config);
+	const dir = path.join(config.memoryDir, "activity", "2026-05-23");
+	writeFile(path.join(dir, "INDEX.md"), `<!-- index 2026-05-23 -->
+💬 Group: Founder Group — • **Alex Rivera** discussed high monthly LLM spend, with non-engineering workflows driving most cost. <!-- file:1613_chat_founder-group.md -->
+💬 Group: Parent Chat — • **Morgan Lee** shared a family logistics incident involving a toddler and a stuck door. <!-- file:1722_chat_parent-chat.md -->
+💬 Group: Product Dev Stream — • **Watchdog Alert** repeatedly flagged browser service memory pressure and high 5xx/min errors. <!-- file:2336_chat_product-dev-stream.md -->
+💬 Group: Product Community — • **Pat Casey** reported issues connecting desktop messaging and asked about custom skill packages. <!-- file:1033_chat_product-community.md -->
+`);
+	writeFile(path.join(dir, "1613_chat_founder-group.md"), "# Founder Group\n\nAlex discussed LLM spend.");
+	writeFile(path.join(dir, "1722_chat_parent-chat.md"), "# Parent Chat\n\nMorgan discussed the door incident.");
+	writeFile(path.join(dir, "2336_chat_product-dev-stream.md"), "# Product Dev Stream\n\nWatchdog alerts.");
+	writeFile(path.join(dir, "1033_chat_product-community.md"), "# Product Community\n\nDesktop messaging setup questions.");
+	return config;
+}
+
+describe("memory_read indexed directory resolution", () => {
+	beforeEach(() => { tmpDir = makeTempDir(); });
+	afterEach(() => { cleanup(tmpDir); });
+
+	it("reads exact indexed files unchanged", () => {
+		const config = seedIndexedDirectory();
+		const result = readMemoryFile(config, "activity/2026-05-23/INDEX.md");
+		assert.match(result.text, /Founder Group/);
+		assert.match(result.text, /1722_chat_parent-chat\.md/);
+		assert.equal(result.details.filename, "activity/2026-05-23/INDEX.md");
+	});
+
+	it("resolves a title query through sibling INDEX.md", () => {
+		const config = seedIndexedDirectory();
+		const result = resolveIndexedFile(config, "activity/2026-05-23", "Parent Chat");
+		assert.match(result.text, /Morgan discussed the door incident/);
+		assert.equal(result.details.filename, "activity/2026-05-23/1722_chat_parent-chat.md");
+	});
+
+	it("resolves prefixed index titles without requiring the prefix", () => {
+		const config = seedIndexedDirectory();
+		const result = resolveIndexedFile(config, "activity/2026-05-23", "Founder Group");
+		assert.match(result.text, /Alex discussed LLM spend/);
+		assert.equal(result.details.filename, "activity/2026-05-23/1613_chat_founder-group.md");
+	});
+
+	it("self-heals hallucinated indexed file paths by consulting sibling INDEX.md", () => {
+		const config = seedIndexedDirectory();
+		const result = readMemoryFile(config, "activity/2026-05-23/Parent Chat.md");
+		assert.match(result.text, /Morgan discussed the door incident/);
+		assert.equal(result.details.filename, "activity/2026-05-23/1722_chat_parent-chat.md");
+		assert.equal(result.details.resolvedFrom, "Parent Chat");
+	});
+
+	it("returns exact candidates for ambiguous indexed queries", () => {
+		const config = seedIndexedDirectory();
+		const result = resolveIndexedFile(config, "activity/2026-05-23", "Product");
+		assert.match(result.text, /Multiple indexed entries matched "Product"/);
+		assert.match(result.text, /activity\/2026-05-23\/2336_chat_product-dev-stream\.md/);
+		assert.match(result.text, /activity\/2026-05-23\/1033_chat_product-community\.md/);
+		assert.equal(result.details.reason, "ambiguous");
+	});
+
+	it("gives useful nearby-directory guidance when INDEX.md is missing", () => {
+		const config = seedIndexedDirectory();
+		writeFile(path.join(config.memoryDir, "activity", "2026-05-22", "INDEX.md"), "Older index");
+		const result = resolveIndexedFile(config, "activity/2026-05-21", "Parent Chat");
+		assert.match(result.text, /No INDEX\.md for activity\/2026-05-21/);
+		assert.match(result.text, /Indexed directories nearby: activity\/2026-05-23\//);
+		assert.match(result.text, /activity\/2026-05-22\//);
+	});
+
+	it("gives the same guidance for hallucinated paths when INDEX.md is missing", () => {
+		const config = seedIndexedDirectory();
+		const result = readMemoryFile(config, "activity/2026-05-21/Parent Chat.md");
+		assert.match(result.text, /No INDEX\.md for activity\/2026-05-21/);
+		assert.match(result.text, /Indexed directories nearby: activity\/2026-05-23\//);
+	});
+});

package/tests/search.test.ts

@@ -123,4 +123,61 @@ describe("searchMemory", () => {
 		assert.strictEqual(result.lineResults.length, 1);
 		assert.strictEqual(result.lineResults[0].file, "notes.md");
 	});
+
+	it("searches extra dirs configured via searchDirs (flat files)", () => {
+		const config = makeConfig(tmpDir, { searchDirs: ["catchup"] });
+		ensureDirs(config);
+		writeFile(`${config.memoryDir}/catchup/summary.md`, "target in catchup");
+		const result = searchMemory(config, "target");
+		assert.strictEqual(result.lineResults.length, 1);
+		assert.strictEqual(result.lineResults[0].file, "catchup/summary.md");
+	});
+
+	it("searches extra dirs with nested subdirectories", () => {
+		const config = makeConfig(tmpDir, { searchDirs: ["catchup"] });
+		ensureDirs(config);
+		writeFile(`${config.memoryDir}/catchup/2026-04-20/INDEX.md`, "morning briefing notes");
+		writeFile(`${config.memoryDir}/catchup/2026-04-19/INDEX.md`, "yesterday catchup");
+		const result = searchMemory(config, "briefing");
+		assert.strictEqual(result.lineResults.length, 1);
+		assert.strictEqual(result.lineResults[0].file, "catchup/2026-04-20/INDEX.md");
+	});
+
+	it("searches multiple extra dirs", () => {
+		const config = makeConfig(tmpDir, { searchDirs: ["catchup", "projects"] });
+		ensureDirs(config);
+		writeFile(`${config.memoryDir}/catchup/item.md`, "target in catchup");
+		writeFile(`${config.memoryDir}/projects/plan.md`, "target in projects");
+		const result = searchMemory(config, "target");
+		assert.strictEqual(result.lineResults.length, 2);
+		const files = result.lineResults.map(r => r.file);
+		assert.ok(files.includes("catchup/item.md"));
+		assert.ok(files.includes("projects/plan.md"));
+	});
+
+	it("ignores missing extra dirs gracefully", () => {
+		const config = makeConfig(tmpDir, { searchDirs: ["nonexistent"] });
+		ensureDirs(config);
+		fs.writeFileSync(config.memoryFile, "target in memory", "utf-8");
+		const result = searchMemory(config, "target");
+		assert.strictEqual(result.lineResults.length, 1);
+		assert.strictEqual(result.lineResults[0].file, "MEMORY.md");
+	});
+
+	it("respects maxResults across extra dirs", () => {
+		const config = makeConfig(tmpDir, { searchDirs: ["catchup"] });
+		ensureDirs(config);
+		const lines = Array.from({ length: 20 }, (_, i) => `match line ${i}`).join("\n");
+		writeFile(`${config.memoryDir}/catchup/big.md`, lines);
+		const result = searchMemory(config, "match", 5);
+		assert.strictEqual(result.lineResults.length, 5);
+	});
+
+	it("matches filenames in extra dirs", () => {
+		const config = makeConfig(tmpDir, { searchDirs: ["catchup"] });
+		ensureDirs(config);
+		writeFile(`${config.memoryDir}/catchup/2026-04-20/INDEX.md`, "some content");
+		const result = searchMemory(config, "INDEX");
+		assert.ok(result.fileMatches.includes("catchup/2026-04-20/INDEX.md"));
+	});
 });