myagentmemory 0.4.12 → 0.4.13

package/scripts/install-skills.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# Install (or uninstall) agent-memory skills for Claude Code, Codex, and Cursor.
+# Install (or uninstall) agent-memory skills for Claude Code, Codex, Cursor, and Agent CLI.
 # Usage: bash scripts/install-skills.sh [--uninstall]
 
 set -euo pipefail
@@ -62,11 +62,13 @@ SKILL_DIRS=(
   "$HOME/.claude/skills/agent-memory"
   "$HOME/.codex/skills/agent-memory"
   "$HOME/.cursor/skills/agent-memory"
+  "$HOME/.agents/skills/agent-memory"
 )
 SKILL_LABELS=(
   "Claude Code skill"
   "Codex skill"
   "Cursor skill"
+  "Agent CLI skill"
 )
 
 if $UNINSTALL; then
@@ -81,6 +83,7 @@ else
   install_skill "Claude Code skill" "$PROJECT_DIR/skills/claude-code" "$HOME/.claude/skills/agent-memory" "$HOME/.claude" '[ -f "$HOME/.claude/settings.json" ] || [ -f "$HOME/.claude/settings.local.json" ] || command_exists claude'
   install_skill "Codex skill" "$PROJECT_DIR/skills/codex" "$HOME/.codex/skills/agent-memory" "$HOME/.codex" '[ -f "$HOME/.codex/config.toml" ] || command_exists codex'
   install_skill "Cursor skill" "$PROJECT_DIR/skills/cursor" "$HOME/.cursor/skills/agent-memory" "$HOME/.cursor"
+  install_skill "Agent CLI skill" "$PROJECT_DIR/skills/agent" "$HOME/.agents/skills/agent-memory" "$HOME/.agents"
   echo ""
   echo "Done."
 fi

package/scripts/postinstall.cjs

@@ -1,6 +1,9 @@
 const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
 const path = require("node:path");
 
+const packageRoot = path.resolve(__dirname, "..");
+
 function hasQmd() {
 	const result = spawnSync("qmd", ["status"], {
 		stdio: "ignore",
@@ -14,23 +17,39 @@ function memoryDir() {
 	return path.join(home, ".agent-memory");
 }
 
+// Distinguish a development checkout of agentmemory from an end-user install.
+// When agentmemory is installed as a dependency it lives under node_modules and
+// ships without the `.githooks` directory (it's absent from the package.json
+// "files" allowlist). We must never touch a consumer's repo or VCS config, so
+// the dev-only hook setup below is gated on "are we actually in the source repo?".
+function isDevCheckout() {
+	if (packageRoot.split(path.sep).includes("node_modules")) return false;
+	return fs.existsSync(path.join(packageRoot, ".githooks"));
+}
+
+// Point git at the repo's tracked hooks (lint + tests on commit). Scoped to the
+// agentmemory working tree only — `cwd` + the dev-checkout gate ensure we only
+// ever write to this repo's local git config, never a consumer's.
 function configureGitHooks() {
-	const result = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], {
+	const insideRepo = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], {
+		cwd: packageRoot,
 		stdio: "ignore",
 		shell: process.platform === "win32",
 	});
-
-	if (result.status !== 0) {
+	if (insideRepo.status !== 0) {
 		return;
 	}
 
 	spawnSync("git", ["config", "core.hooksPath", ".githooks"], {
+		cwd: packageRoot,
 		stdio: "ignore",
 		shell: process.platform === "win32",
 	});
 }
 
-configureGitHooks();
+if (isDevCheckout()) {
+	configureGitHooks();
+}
 
 if (!hasQmd()) {
 	const dir = memoryDir();

package/src/cli.ts

@@ -41,9 +41,12 @@ import {
 	getScratchpadFile,
 	getTopicsDir,
 	installSkills,
+	memoryWrite,
 	nowTimestamp,
 	parseScratchpad,
+	probeEmbeddings,
 	readFileSafe,
+	redactSecrets,
 	runQmdEmbedDetached,
 	runQmdSearch,
 	runQmdSync,
@@ -59,7 +62,19 @@ import {
 } from "./core.js";
 
 declare const __VERSION__: string;
-const VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "dev";
+
+function readPackageVersion(): string {
+	try {
+		const packageJson = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf-8")) as {
+			version?: unknown;
+		};
+		return typeof packageJson.version === "string" ? packageJson.version : "dev";
+	} catch {
+		return "dev";
+	}
+}
+
+const VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : readPackageVersion();
 
 // ---------------------------------------------------------------------------
 // Arg parsing (no external deps)
@@ -140,9 +155,11 @@ function exitError(message: string, json: boolean): never {
 async function cmdContext(flags: Record<string, string | boolean>) {
 	const json = hasFlag(flags, "json");
 	const noSearch = hasFlag(flags, "no-search");
+	const query = getFlag(flags, "query") ?? "";
 
 	ensureDirs();
-	const searchResults = noSearch ? "" : await searchRelevantMemories("");
+	if (!noSearch && query) await ensureQmdAvailableForSync();
+	const searchResults = noSearch ? "" : await searchRelevantMemories(query);
 	const context = buildMemoryContext(searchResults);
 
 	if (json) {
@@ -161,82 +178,29 @@ async function cmdWrite(flags: Record<string, string | boolean>) {
 	const mode = getFlag(flags, "mode") ?? "append";
 	const topic = getFlag(flags, "topic");
 	const date = getFlag(flags, "date");
+	const sourceUri = getFlag(flags, "source-uri");
 
 	if (!["long_term", "daily", "topic"].includes(target)) {
 		exitError("--target must be 'long_term', 'daily', or 'topic' (default: daily)", json);
 	}
+	if (!["append", "overwrite"].includes(mode)) {
+		exitError("--mode must be 'append' or 'overwrite'", json);
+	}
 	if (!content) {
 		exitError("--content is required", json);
 	}
 
-	ensureDirs();
-	const ts = nowTimestamp();
-	const sid = "cli";
-
-	if (target === "daily") {
-		const filePath = dailyPath(todayStr());
-		const existing = readFileSafe(filePath) ?? "";
-		const separator = existing.trim() ? "\n\n" : "";
-		const stamped = `<!-- ${ts} [${sid}] -->\n${content}`;
-		fs.writeFileSync(filePath, existing + separator + stamped, "utf-8");
-		await ensureQmdAvailableForUpdate();
-		scheduleQmdUpdate();
-		output(
-			json
-				? { ok: true, path: filePath, target, mode: "append", timestamp: ts }
-				: `Appended to daily log: ${filePath}`,
-			json,
-		);
-		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) ?? "";
-
-	if (mode === "overwrite") {
-		const stamped = `<!-- last updated: ${ts} [${sid}] -->\n${content}`;
-		fs.writeFileSync(memFile, stamped, "utf-8");
-	} else {
-		const separator = existing.trim() ? "\n\n" : "";
-		const stamped = `<!-- ${ts} [${sid}] -->\n${content}`;
-		fs.writeFileSync(memFile, existing + separator + stamped, "utf-8");
-	}
-	await ensureQmdAvailableForUpdate();
-	scheduleQmdUpdate();
-	output(
-		json
-			? { ok: true, path: memFile, target, mode, timestamp: ts }
-			: `${mode === "overwrite" ? "Overwrote" : "Appended to"} MEMORY.md`,
-		json,
-	);
+	const result = await memoryWrite({
+		target: target as "long_term" | "daily" | "topic",
+		content,
+		mode: mode as "append" | "overwrite",
+		sessionId: "cli",
+		topic,
+		date,
+		sourceUri,
+	});
+	if (result.isError) exitError(result.text.replace(/^Error:\s*/, ""), json);
+	output(json ? { ok: true, ...result.details } : result.text.split("\n\n", 1)[0], json);
 }
 
 async function cmdRead(flags: Record<string, string | boolean>) {
@@ -349,7 +313,11 @@ async function cmdScratchpad(flags: Record<string, string | boolean>, positional
 	ensureDirs();
 	const spFile = getScratchpadFile();
 	const existing = readFileSafe(spFile) ?? "";
-	let items = parseScratchpad(existing);
+	let items = parseScratchpad(existing).map((item) => ({
+		...item,
+		text: redactSecrets(item.text).content,
+		meta: redactSecrets(item.meta).content,
+	}));
 
 	if (action === "list") {
 		if (items.length === 0) {
@@ -374,11 +342,12 @@ async function cmdScratchpad(flags: Record<string, string | boolean>, positional
 	if (action === "add") {
 		if (!text) exitError("--text is required for add", json);
 		const ts = nowTimestamp();
-		items.push({ done: false, text: text!, meta: `<!-- ${ts} [cli] -->` });
+		const safeText = redactSecrets(text!).content;
+		items.push({ done: false, text: safeText, meta: `<!-- ${ts} [cli] -->` });
 		fs.writeFileSync(spFile, serializeScratchpad(items), "utf-8");
 		await ensureQmdAvailableForUpdate();
 		scheduleQmdUpdate();
-		output(json ? { ok: true, action, text } : `Added: - [ ] ${text}`, json);
+		output(json ? { ok: true, action, text: safeText } : `Added: - [ ] ${safeText}`, json);
 		return;
 	}
 
@@ -665,11 +634,18 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 	const qmdFound = await detectQmd();
 	let hasCollection = false;
 	let health = null;
+	let embeddings: "ready" | "missing" | "unknown" | "n/a" = "n/a";
 	if (qmdFound) {
 		hasCollection = await checkCollection();
 		if (hasCollection) {
 			await ensureQmdAvailableForSync();
 			health = await getQmdHealth();
+			// A live semantic probe confirms embeddings are actually usable, but
+			// it costs a real qmd query (and a possible model load), so it's
+			// opt-in — the cheap pending-embed count below covers the common case.
+			if (hasFlag(flags, "probe")) {
+				embeddings = await probeEmbeddings();
+			}
 		}
 	}
 
@@ -695,6 +671,7 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 					available: qmdFound,
 					collection: hasCollection ? getCollectionName() : null,
 					health,
+					embeddings,
 				},
 				embedMode,
 			},
@@ -725,6 +702,15 @@ async function cmdStatus(flags: Record<string, string | boolean>) {
 				`Collection '${getCollectionName()}': ${hasCollection ? "configured" : "not configured — run: agent-memory init"}`,
 			);
 			console.log(`Embed mode: ${embedMode}`);
+			if (hasCollection && embeddings !== "n/a") {
+				const embLabel =
+					embeddings === "ready"
+						? "ready"
+						: embeddings === "missing"
+							? "missing — run: agent-memory sync"
+							: "unknown (could not verify within probe timeout)";
+				console.log(`Embeddings (semantic/deep search): ${embLabel}`);
+			}
 			if (health) {
 				if (health.totalFiles !== null) console.log(`Files indexed: ${health.totalFiles}`);
 				if (health.vectorsEmbedded !== null) console.log(`Vectors embedded: ${health.vectorsEmbedded}`);
@@ -781,15 +767,15 @@ Commands:
   version     Show binary version
   install-skills  Install (or --uninstall) bundled skills
   uninstall-skills  Uninstall bundled skills
-  context     Build & print context injection string
-  write       Write to memory files (default: daily)
+  context     Build context; optionally retrieve memories with --query
+  write       Write to memory files (default: daily; optional --source-uri)
   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
+  status      Show configuration and status (--probe for a live embeddings check)
 
 Global flags:
   --dir <path>   Override memory directory
@@ -798,7 +784,7 @@ 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 long_term --content "User prefers dark mode" --source-uri "session://agent/turn/12"
   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
@@ -810,7 +796,7 @@ Examples:
   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 context --query "database choice"
   agent-memory sync
   agent-memory status --json`);
 }