myagentmemory 0.4.8 → 0.4.11

package/src/cli.ts

@@ -4,7 +4,7 @@
  *
  * Subcommands:
  *   version    — Print binary version
- *   install-skills — Install SKILL.md files into local agent directories
+ *   install-skills — Install (or --uninstall) SKILL.md files into local agent directories
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files
@@ -20,15 +20,13 @@
 
 import * as fs from "node:fs";
 
-declare const __VERSION__: string;
-const VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "dev";
-
 import {
 	_setBaseDir,
 	buildMemoryContext,
 	checkCollection,
 	dailyPath,
 	detectQmd,
+	distilMemories,
 	ensureDirs,
 	ensureQmdAvailableForSync,
 	ensureQmdAvailableForUpdate,
@@ -41,6 +39,7 @@ import {
 	getQmdResultPath,
 	getQmdResultText,
 	getScratchpadFile,
+	getTopicsDir,
 	installSkills,
 	nowTimestamp,
 	parseScratchpad,
@@ -53,9 +52,15 @@ import {
 	searchRelevantMemories,
 	serializeScratchpad,
 	setupQmdCollection,
+	slugifyTopic,
 	todayStr,
+	topicPath,
+	uninstallSkills,
 } from "./core.js";
 
+declare const __VERSION__: string;
+const VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "dev";
+
 // ---------------------------------------------------------------------------
 // Arg parsing (no external deps)
 // ---------------------------------------------------------------------------
@@ -151,12 +156,14 @@ async function cmdContext(flags: Record<string, string | boolean>) {
 
 async function cmdWrite(flags: Record<string, string | boolean>) {
 	const json = hasFlag(flags, "json");
-	const target = getFlag(flags, "target");
+	const target = getFlag(flags, "target") ?? "daily";
 	const content = getFlag(flags, "content");
 	const mode = getFlag(flags, "mode") ?? "append";
+	const topic = getFlag(flags, "topic");
+	const date = getFlag(flags, "date");
 
-	if (!target || !["long_term", "daily"].includes(target)) {
-		exitError("--target must be 'long_term' or 'daily'", json);
+	if (!["long_term", "daily", "topic"].includes(target)) {
+		exitError("--target must be 'long_term', 'daily', or 'topic' (default: daily)", json);
 	}
 	if (!content) {
 		exitError("--content is required", json);
@@ -183,6 +190,33 @@ async function cmdWrite(flags: Record<string, string | boolean>) {
 		return;
 	}
 
+	if (target === "topic") {
+		if (!topic) {
+			exitError("--topic is required when --target is 'topic'", json);
+		}
+		const slug = slugifyTopic(topic);
+		if (!slug) {
+			exitError("--topic must include at least one letter or number", json);
+		}
+		const filePath = topicPath(slug);
+		const existing = readFileSafe(filePath) ?? "";
+		const linkDate = date?.trim() || todayStr();
+		const header = `# Topic: ${topic}\n\n<!-- created: ${ts} [${sid}] -->\n`;
+		const separator = existing.trim() ? "\n\n" : "";
+		const base = existing.trim() ? existing : header.trimEnd();
+		const stamped = `<!-- ${ts} [${sid}] -->\n${content.trim()}\nDaily: [[${linkDate}]]`;
+		fs.writeFileSync(filePath, `${base}${separator}${stamped}`, "utf-8");
+		await ensureQmdAvailableForUpdate();
+		scheduleQmdUpdate();
+		output(
+			json
+				? { ok: true, path: filePath, target, mode: "append", timestamp: ts, topic, slug, date: linkDate }
+				: `Appended to topic: ${filePath}`,
+			json,
+		);
+		return;
+	}
+
 	// long_term
 	const memFile = getMemoryFile();
 	const existing = readFileSafe(memFile) ?? "";
@@ -209,9 +243,10 @@ async function cmdRead(flags: Record<string, string | boolean>) {
 	const json = hasFlag(flags, "json");
 	const target = getFlag(flags, "target");
 	const date = getFlag(flags, "date");
+	const topic = getFlag(flags, "topic");
 
-	if (!target || !["long_term", "scratchpad", "daily", "list"].includes(target)) {
-		exitError("--target must be 'long_term', 'scratchpad', 'daily', or 'list'", json);
+	if (!target || !["long_term", "scratchpad", "daily", "list", "topic", "topics"].includes(target)) {
+		exitError("--target must be 'long_term', 'scratchpad', 'daily', 'list', 'topic', or 'topics'", json);
 	}
 
 	ensureDirs();
@@ -248,6 +283,41 @@ async function cmdRead(flags: Record<string, string | boolean>) {
 		return;
 	}
 
+	if (target === "topics") {
+		try {
+			const files = fs
+				.readdirSync(getTopicsDir())
+				.filter((f) => f.endsWith(".md"))
+				.sort()
+				.reverse();
+			if (json) {
+				output({ files }, true);
+			} else if (files.length === 0) {
+				console.log("No topics found.");
+			} else {
+				console.log(`Topics:\n${files.map((f) => `- ${f}`).join("\n")}`);
+			}
+		} catch {
+			output(json ? { files: [] } : "No topics directory.", json);
+		}
+		return;
+	}
+
+	if (target === "topic") {
+		if (!topic) {
+			exitError("--topic is required when --target is 'topic'", json);
+		}
+		const slug = slugifyTopic(topic);
+		const filePath = topicPath(slug);
+		const content = readFileSafe(filePath);
+		if (!content) {
+			output(json ? { content: null, topic } : `No topic file found for ${topic}.`, json);
+			return;
+		}
+		output(json ? { content, topic, slug, path: filePath } : content, json);
+		return;
+	}
+
 	if (target === "scratchpad") {
 		const content = readFileSafe(getScratchpadFile());
 		if (!content?.trim()) {
@@ -402,6 +472,32 @@ async function cmdSearch(flags: Record<string, string | boolean>) {
 
 function cmdInstallSkills(flags: Record<string, string | boolean>) {
 	const json = hasFlag(flags, "json");
+	const uninstall = hasFlag(flags, "uninstall");
+
+	if (uninstall) {
+		const report = uninstallSkills();
+
+		if (!report.ok) {
+			exitError(report.error ?? "Failed to uninstall skills.", json);
+		}
+
+		if (json) {
+			output(report, true);
+			return;
+		}
+
+		for (const item of report.removed) {
+			console.log(`Uninstalled ${item.label}: ${item.path}`);
+		}
+		for (const item of report.skipped) {
+			console.log(`Skipping ${item.label} (${item.reason})`);
+		}
+		if (report.removed.length === 0) {
+			console.log("No skills were installed.");
+		}
+		return;
+	}
+
 	const report = installSkills();
 
 	if (!report.ok) {
@@ -520,7 +616,7 @@ async function cmdInit(flags: Record<string, string | boolean>) {
 		);
 	} else {
 		console.log(`Memory directory: ${dir}`);
-		console.log(`  MEMORY.md, SCRATCHPAD.md, daily/ created.`);
+		console.log(`  MEMORY.md, SCRATCHPAD.md, daily/, topics/ created.`);
 		if (qmdFound) {
 			if (collectionCreated) {
 				console.log(`  qmd collection '${getCollectionName()}' created.`);
@@ -548,6 +644,7 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 	const memFile = getMemoryFile();
 	const spFile = getScratchpadFile();
 	const dailyDir = getDailyDir();
+	const topicsDir = getTopicsDir();
 
 	const memContent = readFileSafe(memFile);
 	const spContent = readFileSafe(spFile);
@@ -558,6 +655,12 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 	} catch {
 		// directory may not exist
 	}
+	let topicCount = 0;
+	try {
+		topicCount = fs.readdirSync(topicsDir).filter((f) => f.endsWith(".md")).length;
+	} catch {
+		// directory may not exist
+	}
 
 	const qmdFound = await detectQmd();
 	let hasCollection = false;
@@ -587,6 +690,7 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 					openItems: spContent ? parseScratchpad(spContent).filter((i) => !i.done).length : 0,
 				},
 				dailyLogs: dailyCount,
+				topics: topicCount,
 				qmd: {
 					available: qmdFound,
 					collection: hasCollection ? getCollectionName() : null,
@@ -613,6 +717,7 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 			console.log("SCRATCHPAD.md: not created yet");
 		}
 		console.log(`Daily logs: ${dailyCount} file(s)`);
+		console.log(`Topics: ${topicCount} file(s)`);
 		console.log("");
 		if (qmdFound) {
 			console.log(`qmd: available`);
@@ -635,6 +740,33 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 	}
 }
 
+async function cmdDistil(flags: Record<string, string | boolean>) {
+	const json = hasFlag(flags, "json");
+	const dryRun = hasFlag(flags, "dry-run");
+
+	const result = await distilMemories({ dryRun });
+
+	if (json) {
+		output(result, true);
+	} else {
+		if (result.totalEntries === 0) {
+			console.log(result.output.trim());
+			return;
+		}
+		if (dryRun) {
+			console.log("--- Dry run (MEMORY.md not modified) ---\n");
+		}
+		console.log(result.output.trim());
+		console.log("");
+		console.log(
+			`Distilled ${result.totalEntries} entries from ${result.totalDailyFiles} daily file(s) and ${result.totalTopicFiles} topic file(s), ${result.totalTags} tag(s).`,
+		);
+		if (!dryRun) {
+			console.log("MEMORY.md updated.");
+		}
+	}
+}
+
 // ---------------------------------------------------------------------------
 // Usage
 // ---------------------------------------------------------------------------
@@ -647,12 +779,14 @@ Usage:
 
 Commands:
   version     Show binary version
-  install-skills  Install bundled skills into local agent directories
+  install-skills  Install (or --uninstall) bundled skills
+  uninstall-skills  Uninstall bundled skills
   context     Build & print context injection string
-  write       Write to memory files
+  write       Write to memory files (default: daily)
   read        Read memory files
   scratchpad  Manage checklist items
   search      Search across memory files (requires qmd)
+  distil      Generate compact MEMORY.md index from daily logs + topics
   sync        Re-index and embed all files (requires qmd)
   init        Initialize memory directory and qmd collection
   status      Show configuration and status
@@ -663,15 +797,19 @@ Global flags:
 
 Examples:
   agent-memory init
+  agent-memory write --content "Fixed auth bug in login flow"
   agent-memory write --target long_term --content "User prefers dark mode"
-  agent-memory write --target daily --content "Fixed auth bug in login flow"
+  agent-memory write --target topic --topic "auth" --content "Rolled JWT refresh to edge"
   agent-memory read --target long_term
   agent-memory read --target daily --date 2026-02-15
   agent-memory read --target list
+  agent-memory read --target topic --topic "auth"
+  agent-memory read --target topics
   agent-memory scratchpad add --text "Review PR #42"
   agent-memory scratchpad list
   agent-memory scratchpad done --text "PR #42"
   agent-memory search --query "database choice" --mode keyword
+  agent-memory distil --dry-run
   agent-memory context --no-search
   agent-memory sync
   agent-memory status --json`);
@@ -720,6 +858,13 @@ async function main() {
 		case "install-skills":
 			cmdInstallSkills(flags);
 			break;
+		case "uninstall-skills":
+			cmdInstallSkills({ ...flags, uninstall: true });
+			break;
+		case "distil":
+		case "distill":
+			await cmdDistil(flags);
+			break;
 		case "sync":
 			await cmdSync(flags);
 			break;