myagentmemory 0.4.4 → 0.4.5

package/dist/cli.d.ts

@@ -3,6 +3,7 @@
  * agent-memory CLI
  *
  * Subcommands:
+ *   version    — Print binary version
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files

package/dist/cli.js

@@ -3,6 +3,7 @@
  * agent-memory CLI
  *
  * Subcommands:
+ *   version    — Print binary version
  *   context    — Build & print context injection string to stdout
  *   write      — Write to memory files
  *   read       — Read memory files
@@ -16,7 +17,8 @@
  *   --json         Machine-readable JSON output
  */
 import * as fs from "node:fs";
-import { _setBaseDir, buildMemoryContext, checkCollection, dailyPath, detectQmd, ensureDirs, ensureQmdAvailableForUpdate, getCollectionName, getDailyDir, getMemoryDir, getMemoryFile, getQmdResultPath, getQmdResultText, getScratchpadFile, nowTimestamp, parseScratchpad, readFileSafe, runQmdSearch, scheduleQmdUpdate, searchRelevantMemories, serializeScratchpad, setupQmdCollection, todayStr, } from "./core.js";
+const VERSION = typeof __VERSION__ !== "undefined" ? __VERSION__ : "dev";
+import { _setBaseDir, buildMemoryContext, checkCollection, dailyPath, detectQmd, ensureDirs, ensureQmdAvailableForSync, ensureQmdAvailableForUpdate, getCollectionName, getDailyDir, getMemoryDir, getMemoryFile, getQmdEmbedMode, getQmdHealth, getQmdResultPath, getQmdResultText, getScratchpadFile, nowTimestamp, parseScratchpad, readFileSafe, runQmdEmbedDetached, runQmdSearch, runQmdSync, runQmdUpdateNow, scheduleQmdUpdate, searchRelevantMemories, serializeScratchpad, setupQmdCollection, todayStr, } from "./core.js";
 function parseArgs(argv) {
     const flags = {};
     const positional = [];
@@ -319,18 +321,60 @@ async function cmdSearch(flags) {
         exitError(`Search failed: ${err instanceof Error ? err.message : String(err)}`, json);
     }
 }
+async function cmdSync(flags) {
+    const json = hasFlag(flags, "json");
+    ensureDirs();
+    const qmdFound = await ensureQmdAvailableForSync();
+    if (!qmdFound) {
+        exitError("qmd is not installed. Install: bun install -g https://github.com/tobi/qmd", json);
+    }
+    const collName = getCollectionName();
+    const hasCollection = await checkCollection(collName);
+    if (!hasCollection) {
+        exitError(`qmd collection '${collName}' not found. Run: agent-memory init`, json);
+    }
+    const result = await runQmdSync();
+    if (json) {
+        output({ ok: result.updateOk && result.embedOk, updateOk: result.updateOk, embedOk: result.embedOk }, true);
+    }
+    else {
+        if (result.updateOk) {
+            console.log("qmd update: ok");
+        }
+        else {
+            console.log("qmd update: failed");
+        }
+        if (result.embedOk) {
+            console.log("qmd embed: ok");
+        }
+        else {
+            console.log("qmd embed: failed");
+        }
+        if (result.updateOk && result.embedOk) {
+            console.log("\nIndex fully synced.");
+        }
+    }
+}
 async function cmdInit(flags) {
     const json = hasFlag(flags, "json");
     ensureDirs();
     const dir = getMemoryDir();
     const qmdFound = await detectQmd();
     let collectionCreated = false;
+    let indexUpdated = false;
+    let embedStarted = false;
     if (qmdFound) {
         const collName = getCollectionName();
         const hasCollection = await checkCollection(collName);
         if (!hasCollection) {
             collectionCreated = await setupQmdCollection();
         }
+        // Run initial index update + start background embed
+        await ensureQmdAvailableForUpdate();
+        await runQmdUpdateNow();
+        indexUpdated = true;
+        const child = runQmdEmbedDetached();
+        embedStarted = child !== null;
     }
     if (json) {
         output({
@@ -338,6 +382,8 @@ async function cmdInit(flags) {
             directory: dir,
             qmd: qmdFound,
             collectionCreated,
+            indexUpdated,
+            embedStarted,
         }, true);
     }
     else {
@@ -350,6 +396,12 @@ async function cmdInit(flags) {
             else {
                 console.log(`  qmd collection '${getCollectionName()}' already exists.`);
             }
+            if (indexUpdated) {
+                console.log(`  Index updated.`);
+            }
+            if (embedStarted) {
+                console.log(`  Embedding started in background.`);
+            }
         }
         else {
             console.log(`  qmd not found — search features unavailable.`);
@@ -375,9 +427,15 @@ async function cmdStatus(flags) {
     }
     const qmdFound = await detectQmd();
     let hasCollection = false;
+    let health = null;
     if (qmdFound) {
         hasCollection = await checkCollection();
+        if (hasCollection) {
+            await ensureQmdAvailableForSync();
+            health = await getQmdHealth();
+        }
     }
+    const embedMode = getQmdEmbedMode();
     if (json) {
         output({
             directory: dir,
@@ -395,7 +453,9 @@ async function cmdStatus(flags) {
             qmd: {
                 available: qmdFound,
                 collection: hasCollection ? getCollectionName() : null,
+                health,
             },
+            embedMode,
         }, true);
     }
     else {
@@ -421,6 +481,19 @@ async function cmdStatus(flags) {
         if (qmdFound) {
             console.log(`qmd: available`);
             console.log(`Collection '${getCollectionName()}': ${hasCollection ? "configured" : "not configured — run: agent-memory init"}`);
+            console.log(`Embed mode: ${embedMode}`);
+            if (health) {
+                if (health.totalFiles !== null)
+                    console.log(`Files indexed: ${health.totalFiles}`);
+                if (health.vectorsEmbedded !== null)
+                    console.log(`Vectors embedded: ${health.vectorsEmbedded}`);
+                if (health.pendingEmbed !== null && health.pendingEmbed > 0) {
+                    console.log(`Pending embeds: ${health.pendingEmbed}`);
+                    console.log(`  run: agent-memory sync`);
+                }
+                if (health.lastUpdated)
+                    console.log(`Last updated: ${health.lastUpdated}`);
+            }
         }
         else {
             console.log("qmd: not installed");
@@ -437,11 +510,13 @@ Usage:
   agent-memory <command> [options]
 
 Commands:
+  version     Show binary version
   context     Build & print context injection string
   write       Write to memory files
   read        Read memory files
   scratchpad  Manage checklist items
   search      Search across memory files (requires qmd)
+  sync        Re-index and embed all files (requires qmd)
   init        Initialize memory directory and qmd collection
   status      Show configuration and status
 
@@ -461,6 +536,7 @@ Examples:
   agent-memory scratchpad done --text "PR #42"
   agent-memory search --query "database choice" --mode keyword
   agent-memory context --no-search
+  agent-memory sync
   agent-memory status --json`);
 }
 // ---------------------------------------------------------------------------
@@ -474,6 +550,10 @@ async function main() {
     if (dir) {
         _setBaseDir(dir);
     }
+    if (command === "version" || hasFlag(flags, "version")) {
+        output(json ? { version: VERSION } : VERSION, json);
+        return;
+    }
     if (!command || command === "help" || hasFlag(flags, "help")) {
         printUsage();
         return;
@@ -494,6 +574,9 @@ async function main() {
         case "search":
             await cmdSearch(flags);
             break;
+        case "sync":
+            await cmdSync(flags);
+            break;
         case "init":
             await cmdInit(flags);
             break;

package/dist/core.d.ts

@@ -4,7 +4,8 @@
  * Core logic for agent-memory CLI and skills.
  * Zero pi peer dependencies — only node:fs, node:path, node:child_process.
  */
-import { execFile } from "node:child_process";
+import type { ChildProcess } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 /** Override base directory (for testing or platform-specific defaults). */
 export declare function _setBaseDir(baseDir: string): void;
 /** Reset to default paths. */
@@ -59,10 +60,15 @@ export declare function parseScratchpad(content: string): ScratchpadItem[];
 export declare function serializeScratchpad(items: ScratchpadItem[]): string;
 export declare function buildMemoryContext(searchResults?: string): string;
 type ExecFileFn = typeof execFile;
+type SpawnFn = typeof spawn;
 /** Override execFile implementation (for testing). */
 export declare function _setExecFileForTest(fn: ExecFileFn): void;
 /** Reset execFile implementation (for testing). */
 export declare function _resetExecFileForTest(): void;
+/** Override spawn implementation (for testing). */
+export declare function _setSpawnForTest(fn: SpawnFn): void;
+/** Reset spawn implementation (for testing). */
+export declare function _resetSpawnForTest(): void;
 /** Set qmd availability flag (for testing). */
 export declare function _setQmdAvailable(value: boolean): void;
 /** Get current qmd availability flag. */
@@ -71,6 +77,10 @@ export declare function _getQmdAvailable(): boolean;
 export declare function _getUpdateTimer(): ReturnType<typeof setTimeout> | null;
 /** Clear the update timer (for testing). */
 export declare function _clearUpdateTimer(): void;
+/** Get current embed timer (for testing). */
+export declare function _getEmbedTimer(): ReturnType<typeof setTimeout> | null;
+/** Clear the embed timer (for testing). */
+export declare function _clearEmbedTimer(): void;
 /** Get the current QMD collection name. */
 export declare function getCollectionName(): string;
 /** Set the QMD collection name (for platform-specific overrides). */
@@ -83,8 +93,28 @@ export declare function detectQmd(): Promise<boolean>;
 export declare function checkCollection(name?: string): Promise<boolean>;
 export declare function getQmdUpdateMode(): "background" | "manual" | "off";
 export declare function ensureQmdAvailableForUpdate(): Promise<boolean>;
+export declare function getQmdEmbedMode(): "background" | "manual" | "off";
+export declare function runQmdEmbedDetached(): ChildProcess | null;
+export declare function scheduleQmdEmbed(): void;
 export declare function scheduleQmdUpdate(): void;
 export declare function runQmdUpdateNow(): Promise<void>;
+export declare function runQmdEmbedNow(): Promise<boolean>;
+export declare function ensureQmdAvailableForSync(): Promise<boolean>;
+export declare function runQmdSync(): Promise<{
+    updateOk: boolean;
+    embedOk: boolean;
+}>;
+export interface QmdHealthInfo {
+    totalFiles: number | null;
+    vectorsEmbedded: number | null;
+    pendingEmbed: number | null;
+    lastUpdated: string | null;
+    collectionFiles: number | null;
+    collectionUpdated: string | null;
+    embedMode: string;
+}
+export declare function parseQmdStatus(stdout: string, collectionName: string): QmdHealthInfo;
+export declare function getQmdHealth(): Promise<QmdHealthInfo | null>;
 /** Search for memories relevant to the user's prompt. Returns formatted markdown or empty string on error. */
 export declare function searchRelevantMemories(prompt: string): Promise<string>;
 export interface QmdSearchResult {

package/dist/core.js

@@ -4,7 +4,7 @@
  * Core logic for agent-memory CLI and skills.
  * Zero pi peer dependencies — only node:fs, node:path, node:child_process.
  */
-import { execFile } from "node:child_process";
+import { execFile, spawn } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 // ---------------------------------------------------------------------------
@@ -280,8 +280,10 @@ export function buildMemoryContext(searchResults) {
     return context;
 }
 let execFileFn = execFile;
+let spawnFn = spawn;
 let qmdAvailable = false;
 let updateTimer = null;
+let embedTimer = null;
 /** QMD collection name — configurable per platform. */
 let QMD_COLLECTION_NAME = "agent-memory";
 /** Override execFile implementation (for testing). */
@@ -292,6 +294,14 @@ export function _setExecFileForTest(fn) {
 export function _resetExecFileForTest() {
     execFileFn = execFile;
 }
+/** Override spawn implementation (for testing). */
+export function _setSpawnForTest(fn) {
+    spawnFn = fn;
+}
+/** Reset spawn implementation (for testing). */
+export function _resetSpawnForTest() {
+    spawnFn = spawn;
+}
 /** Set qmd availability flag (for testing). */
 export function _setQmdAvailable(value) {
     qmdAvailable = value;
@@ -311,6 +321,17 @@ export function _clearUpdateTimer() {
         updateTimer = null;
     }
 }
+/** Get current embed timer (for testing). */
+export function _getEmbedTimer() {
+    return embedTimer;
+}
+/** Clear the embed timer (for testing). */
+export function _clearEmbedTimer() {
+    if (embedTimer) {
+        clearTimeout(embedTimer);
+        embedTimer = null;
+    }
+}
 /** Get the current QMD collection name. */
 export function getCollectionName() {
     return QMD_COLLECTION_NAME;
@@ -425,6 +446,39 @@ export async function ensureQmdAvailableForUpdate() {
     qmdAvailable = await detectQmd();
     return qmdAvailable;
 }
+export function getQmdEmbedMode() {
+    const mode = (process.env.AGENT_MEMORY_QMD_EMBED ?? "background").toLowerCase();
+    if (mode === "manual" || mode === "off" || mode === "background") {
+        return mode;
+    }
+    return "background";
+}
+export function runQmdEmbedDetached() {
+    if (!qmdAvailable)
+        return null;
+    const child = spawnFn("qmd", ["embed"], {
+        detached: true,
+        stdio: "ignore",
+    });
+    child.unref();
+    return child;
+}
+export function scheduleQmdEmbed() {
+    if (getQmdEmbedMode() !== "background")
+        return;
+    if (!qmdAvailable)
+        return;
+    if (embedTimer)
+        clearTimeout(embedTimer);
+    embedTimer = setTimeout(() => {
+        embedTimer = null;
+        runQmdEmbedDetached();
+    }, 5_000);
+    // Don't prevent process exit while waiting to embed
+    if (embedTimer && typeof embedTimer === "object" && "unref" in embedTimer) {
+        embedTimer.unref();
+    }
+}
 export function scheduleQmdUpdate() {
     if (getQmdUpdateMode() !== "background")
         return;
@@ -434,7 +488,9 @@ export function scheduleQmdUpdate() {
         clearTimeout(updateTimer);
     updateTimer = setTimeout(() => {
         updateTimer = null;
-        execFileFn("qmd", ["update"], { timeout: 30_000 }, () => { });
+        execFileFn("qmd", ["update"], { timeout: 30_000 }, () => {
+            scheduleQmdEmbed();
+        });
     }, 500);
 }
 export async function runQmdUpdateNow() {
@@ -446,6 +502,89 @@ export async function runQmdUpdateNow() {
         execFileFn("qmd", ["update"], { timeout: 30_000 }, () => resolve());
     });
 }
+export async function runQmdEmbedNow() {
+    if (!qmdAvailable)
+        return false;
+    return new Promise((resolve) => {
+        execFileFn("qmd", ["embed"], { timeout: 120_000 }, (err) => {
+            resolve(!err);
+        });
+    });
+}
+export async function ensureQmdAvailableForSync() {
+    if (qmdAvailable)
+        return true;
+    qmdAvailable = await detectQmd();
+    return qmdAvailable;
+}
+export async function runQmdSync() {
+    if (!qmdAvailable)
+        return { updateOk: false, embedOk: false };
+    const updateOk = await new Promise((resolve) => {
+        execFileFn("qmd", ["update"], { timeout: 30_000 }, (err) => {
+            resolve(!err);
+        });
+    });
+    const embedOk = await runQmdEmbedNow();
+    return { updateOk, embedOk };
+}
+export function parseQmdStatus(stdout, collectionName) {
+    const result = {
+        totalFiles: null,
+        vectorsEmbedded: null,
+        pendingEmbed: null,
+        lastUpdated: null,
+        collectionFiles: null,
+        collectionUpdated: null,
+        embedMode: getQmdEmbedMode(),
+    };
+    if (!stdout.trim())
+        return result;
+    // Total files across all collections
+    const totalFilesMatch = stdout.match(/(\d+)\s+(?:total\s+)?files?/i);
+    if (totalFilesMatch) {
+        result.totalFiles = Number.parseInt(totalFilesMatch[1], 10);
+    }
+    // Vectors / embeddings
+    const vectorsMatch = stdout.match(/(\d+)\s+(?:vectors?|embeddings?)/i);
+    if (vectorsMatch) {
+        result.vectorsEmbedded = Number.parseInt(vectorsMatch[1], 10);
+    }
+    // Pending embed
+    const pendingMatch = stdout.match(/(\d+)\s+pending/i);
+    if (pendingMatch) {
+        result.pendingEmbed = Number.parseInt(pendingMatch[1], 10);
+    }
+    // If we have totalFiles and vectorsEmbedded but no explicit pending, infer it
+    if (result.pendingEmbed === null && result.totalFiles !== null && result.vectorsEmbedded !== null) {
+        result.pendingEmbed = Math.max(0, result.totalFiles - result.vectorsEmbedded);
+    }
+    // Last updated timestamp
+    const updatedMatch = stdout.match(/(?:last\s+)?updated:?\s+(\d{4}-\d{2}-\d{2}[\sT]\d{2}:\d{2}[:\d]*)/i);
+    if (updatedMatch) {
+        result.lastUpdated = updatedMatch[1];
+    }
+    // Collection-specific info — look for collection name section
+    const collectionPattern = new RegExp(`${collectionName}[:\\s]*(?:.*?)(\\d+)\\s+files?`, "i");
+    const collMatch = stdout.match(collectionPattern);
+    if (collMatch) {
+        result.collectionFiles = Number.parseInt(collMatch[1], 10);
+    }
+    return result;
+}
+export async function getQmdHealth() {
+    if (!qmdAvailable)
+        return null;
+    return new Promise((resolve) => {
+        execFileFn("qmd", ["status"], { timeout: 10_000 }, (err, stdout) => {
+            if (err) {
+                resolve(null);
+                return;
+            }
+            resolve(parseQmdStatus(stdout ?? "", QMD_COLLECTION_NAME));
+        });
+    });
+}
 /** Search for memories relevant to the user's prompt. Returns formatted markdown or empty string on error. */
 export async function searchRelevantMemories(prompt) {
     if (!qmdAvailable || !prompt.trim())

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "myagentmemory",
-	"version": "0.4.4",
+	"version": "0.4.5",
 	"description": "Persistent memory for coding agents (Claude Code, Codex, Cursor, Agent) with qmd-powered semantic search across daily logs, long-term memory, and scratchpad",
 	"main": "./dist/core.js",
 	"types": "./dist/core.d.ts",
@@ -52,7 +52,7 @@
 		"postinstall": "node scripts/postinstall.cjs",
 		"build": "tsc -p tsconfig.json --noEmit",
 		"build:lib": "tsc -p tsconfig.build.json",
-		"build:cli": "bun build src/cli.ts --compile --outfile dist/agent-memory",
+		"build:cli": "bun build src/cli.ts --compile --outfile dist/agent-memory --define __VERSION__=\"'$(node -p \"require('./package.json').version\")'\"",
 		"prepack": "npm run build:lib && bun run build:cli",
 		"lint": "biome check .",
 		"test": "bun test test/unit.test.ts",