@chendpoc/pi-memory 0.1.12 → 0.2.0

package/dist/cli/jobs.js

@@ -0,0 +1,100 @@
+import { runConsolidateJob } from "../consolidate/runJob.js";
+import { runDrainShutdownQueueJob } from "../shutdown/runDrainJob.js";
+export async function runMaintenanceCommand(opts) {
+    const { store, agentDir, llm, options, log } = opts;
+    log.debug(`maintenance agentDir=${agentDir} cron=${options.cron} force=${options.force}`);
+    log.line("step", "consolidate");
+    const consolidateResult = await runConsolidateJob({
+        store,
+        agentDir,
+        llm,
+        cronFired: options.cron,
+        force: options.force,
+    });
+    switch (consolidateResult.status) {
+        case "skipped":
+            log.warn("consolidate skipped (conditions not met)");
+            break;
+        case "consolidated":
+            log.success("consolidate complete");
+            if (options.verbose) {
+                log.line("entries", `${consolidateResult.stats.entriesBefore} → ${consolidateResult.stats.entriesAfter}`);
+                log.line("overflow files", `${consolidateResult.stats.overflowBefore} → ${consolidateResult.stats.overflowAfter}`);
+            }
+            break;
+        case "failed":
+            log.error(`consolidate failed: ${consolidateResult.error.message}`);
+            return 1;
+    }
+    log.line("step", "drain-shutdown-queue");
+    const drainResult = await runDrainShutdownQueueJob({ store, agentDir, llm });
+    switch (drainResult.status) {
+        case "empty":
+            log.warn("shutdown queue empty");
+            return 0;
+        case "drained":
+            log.success("shutdown queue drained");
+            if (options.verbose) {
+                log.line("queued sessions", String(drainResult.stats.queued));
+                log.line("ingested sessions", String(drainResult.stats.ingested));
+                log.line("skipped sessions", String(drainResult.stats.skipped));
+                log.line("appended entries", String(drainResult.stats.appended));
+                if (drainResult.stats.indexGeneration !== undefined) {
+                    log.line("index generation", String(drainResult.stats.indexGeneration));
+                }
+            }
+            return 0;
+        case "failed":
+            log.error(`shutdown queue drain failed: ${drainResult.error.message}`);
+            return 1;
+    }
+}
+export async function runDrainShutdownQueueCommand(opts) {
+    const result = await runDrainShutdownQueueJob({
+        store: opts.store,
+        agentDir: opts.agentDir,
+        llm: opts.llm,
+    });
+    switch (result.status) {
+        case "empty":
+            opts.log.warn("shutdown queue empty");
+            return 0;
+        case "drained":
+            opts.log.success("shutdown queue drained");
+            if (opts.verbose) {
+                opts.log.line("queued sessions", String(result.stats.queued));
+                opts.log.line("ingested sessions", String(result.stats.ingested));
+                opts.log.line("skipped sessions", String(result.stats.skipped));
+                opts.log.line("appended entries", String(result.stats.appended));
+            }
+            return 0;
+        case "failed":
+            opts.log.error(`shutdown queue drain failed: ${result.error.message}`);
+            return 1;
+    }
+}
+export async function runConsolidateCommand(opts) {
+    const result = await runConsolidateJob({
+        store: opts.store,
+        agentDir: opts.agentDir,
+        llm: opts.llm,
+        cronFired: opts.cron,
+        force: opts.force,
+    });
+    switch (result.status) {
+        case "skipped":
+            opts.log.warn("consolidate skipped (conditions not met)");
+            return 0;
+        case "consolidated":
+            opts.log.success("consolidate complete");
+            if (opts.verbose) {
+                opts.log.line("entries", `${result.stats.entriesBefore} → ${result.stats.entriesAfter}`);
+                opts.log.line("overflow files", `${result.stats.overflowBefore} → ${result.stats.overflowAfter}`);
+            }
+            return 0;
+        case "failed":
+            opts.log.error(`consolidate failed: ${result.error.message}`);
+            return 1;
+    }
+}
+//# sourceMappingURL=jobs.js.map

package/dist/cli/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/cli/jobs.ts"],"names":[],"mappings":"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"}

package/dist/cli/log.d.ts

@@ -0,0 +1,14 @@
+export type CliLogOptions = {
+    verbose?: boolean;
+    debug?: boolean;
+};
+export type CliLog = {
+    info(message: string): void;
+    success(message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    debug(message: string): void;
+    line(label: string, value: string): void;
+};
+export declare function createCliLog(opts?: CliLogOptions): CliLog;
+//# sourceMappingURL=log.d.ts.map

package/dist/cli/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/cli/log.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC;AAMF,wBAAgB,YAAY,CAAC,IAAI,GAAE,aAAkB,GAAG,MAAM,CAyB7D"}

package/dist/cli/log.js

@@ -0,0 +1,32 @@
+import { theme } from "./theme.js";
+function prefix() {
+    return `${theme.prefix()} `;
+}
+export function createCliLog(opts = {}) {
+    const debugOn = opts.debug ?? process.env.PI_MEMORY_DEBUG === "1";
+    return {
+        info(message) {
+            if (!opts.verbose)
+                return;
+            console.error(prefix() + theme.info(message));
+        },
+        success(message) {
+            console.error(prefix() + theme.success(message));
+        },
+        warn(message) {
+            console.error(prefix() + theme.warn(message));
+        },
+        error(message) {
+            console.error(prefix() + theme.error(message));
+        },
+        debug(message) {
+            if (!debugOn && !opts.verbose)
+                return;
+            console.error(prefix() + theme.dim(message));
+        },
+        line(label, value) {
+            console.error(`${prefix()}${theme.label(`${label}`.padEnd(16))} ${theme.value(value)}`);
+        },
+    };
+}
+//# sourceMappingURL=log.js.map

package/dist/cli/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/cli/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAgBnC,SAAS,MAAM;IACb,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAsB,EAAE;IACnD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,GAAG,CAAC;IAElE,OAAO;QACL,IAAI,CAAC,OAAO;YACV,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YAC1B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,OAAO,CAAC,OAAO;YACb,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC,OAAO;YACV,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,KAAK,CAAC,OAAO;YACX,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,KAAK,CAAC,OAAO;YACX,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,OAAO;YACtC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,KAAK,EAAE,KAAK;YACf,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/parseArgs.d.ts

@@ -0,0 +1,35 @@
+export type CliCommand = "consolidate" | "maintenance" | "drain-shutdown-queue" | "init" | "status" | "help";
+export type CommonCliOptions = {
+    agentDir?: string;
+    verbose: boolean;
+};
+export type ConsolidateCliOptions = CommonCliOptions & {
+    cron: boolean;
+    force: boolean;
+};
+export type MaintenanceCliOptions = ConsolidateCliOptions;
+export type DrainShutdownQueueCliOptions = CommonCliOptions;
+export type StatusCliOptions = CommonCliOptions;
+export type InitCliOptions = CommonCliOptions;
+export type ParsedCli = {
+    command: "help";
+    error?: string;
+} | {
+    command: "consolidate";
+    options: ConsolidateCliOptions;
+} | {
+    command: "maintenance";
+    options: MaintenanceCliOptions;
+} | {
+    command: "drain-shutdown-queue";
+    options: DrainShutdownQueueCliOptions;
+} | {
+    command: "init";
+    options: InitCliOptions;
+} | {
+    command: "status";
+    options: StatusCliOptions;
+};
+export declare function parseCliArgs(argv: string[]): ParsedCli;
+export declare const CLI_HELP = "pi-memory \u2014 standalone tools for Pi local memory\n\nUsage:\n  pi-memory init [options]\n  pi-memory status [options]\n  pi-memory maintenance [options]\n  pi-memory consolidate [options]\n  pi-memory drain-shutdown-queue [options]\n\nCommands:\n  init                    Create MEMORY.md from template when missing or empty\n  status                  Print MEMORY.md, sidecar, and vector index diagnostics\n  maintenance             Daily job: consolidate, then drain shutdown queue\n  consolidate             Run consolidate job (dedupe + optional reindex)\n  drain-shutdown-queue    Ingest durable facts from queued session shutdown metadata\n\nOptions:\n  --agent-dir PATH        Memory data directory (overrides PI_MEMORY_AGENT_DIR)\n  --verbose, -v           Extra stderr output (TTY colors when supported)\n\nConsolidate / maintenance:\n  --cron                  Daily OS cron slot (passes cronFired to shouldConsolidate)\n  --force                 Run consolidate even when shouldConsolidate is false\n\nEnvironment:\n  PI_MEMORY_ENV_FILE        Explicit .env path\n  PI_MEMORY_AGENT_DIR       Memory data root; default ~/.pi/pi-memory-data\n  PI_MEMORY_DEBUG=1         Debug stderr logs (extension preflight + CLI)\n  NO_COLOR                  Disable chalk colors\n\nExamples:\n  pi-memory init\n  pi-memory status\n  pi-memory maintenance --cron --verbose\n  pi-memory consolidate --force --verbose\n  pi-memory drain-shutdown-queue --verbose\n";
+//# sourceMappingURL=parseArgs.d.ts.map

package/dist/cli/parseArgs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.d.ts","sourceRoot":"","sources":["../../src/cli/parseArgs.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,aAAa,GACb,aAAa,GACb,sBAAsB,GACtB,MAAM,GACN,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,GAAG;IACrD,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AAE1D,MAAM,MAAM,4BAA4B,GAAG,gBAAgB,CAAC;AAE5D,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG,gBAAgB,CAAC;AAE9C,MAAM,MAAM,SAAS,GACjB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAC1D;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAC1D;IAAE,OAAO,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,4BAA4B,CAAA;CAAE,GAC1E;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,GAC5C;IAAE,OAAO,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAkErD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAsCtD;AAED,eAAO,MAAM,QAAQ,w7CAoCpB,CAAC"}

package/dist/cli/parseArgs.js

@@ -0,0 +1,127 @@
+function parseCommonFlags(rest, base) {
+    const options = { ...base };
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        switch (arg) {
+            case "--verbose":
+            case "-v":
+                options.verbose = true;
+                break;
+            case "--agent-dir": {
+                const value = rest[++i];
+                if (!value)
+                    return { command: "help", error: "--agent-dir requires a path" };
+                options.agentDir = value;
+                break;
+            }
+            default:
+                return { command: "help", error: `Unknown flag: ${arg}` };
+        }
+    }
+    return options;
+}
+function parseConsolidateLikeFlags(rest, command) {
+    const options = {
+        cron: false,
+        force: false,
+        verbose: false,
+    };
+    for (let i = 0; i < rest.length; i++) {
+        const arg = rest[i];
+        switch (arg) {
+            case "--cron":
+                options.cron = true;
+                break;
+            case "--force":
+                options.force = true;
+                break;
+            case "--verbose":
+            case "-v":
+                options.verbose = true;
+                break;
+            case "--agent-dir": {
+                const value = rest[++i];
+                if (!value)
+                    return { command: "help", error: "--agent-dir requires a path" };
+                options.agentDir = value;
+                break;
+            }
+            default:
+                return { command: "help", error: `Unknown flag: ${arg}` };
+        }
+    }
+    return { command, options };
+}
+export function parseCliArgs(argv) {
+    const args = argv.filter((arg) => arg !== "--");
+    if (args.length === 0) {
+        return { command: "help" };
+    }
+    const [command, ...rest] = args;
+    if (command === "help" || command === "--help" || command === "-h") {
+        return { command: "help" };
+    }
+    if (command === "status") {
+        const parsed = parseCommonFlags(rest, { verbose: false });
+        if ("command" in parsed)
+            return parsed;
+        return { command: "status", options: parsed };
+    }
+    if (command === "init") {
+        const parsed = parseCommonFlags(rest, { verbose: false });
+        if ("command" in parsed)
+            return parsed;
+        return { command: "init", options: parsed };
+    }
+    if (command === "consolidate") {
+        return parseConsolidateLikeFlags(rest, "consolidate");
+    }
+    if (command === "maintenance") {
+        return parseConsolidateLikeFlags(rest, "maintenance");
+    }
+    if (command === "drain-shutdown-queue") {
+        const parsed = parseCommonFlags(rest, { verbose: false });
+        if ("command" in parsed)
+            return parsed;
+        return { command: "drain-shutdown-queue", options: parsed };
+    }
+    return { command: "help", error: `Unknown command: ${command}` };
+}
+export const CLI_HELP = `pi-memory — standalone tools for Pi local memory
+
+Usage:
+  pi-memory init [options]
+  pi-memory status [options]
+  pi-memory maintenance [options]
+  pi-memory consolidate [options]
+  pi-memory drain-shutdown-queue [options]
+
+Commands:
+  init                    Create MEMORY.md from template when missing or empty
+  status                  Print MEMORY.md, sidecar, and vector index diagnostics
+  maintenance             Daily job: consolidate, then drain shutdown queue
+  consolidate             Run consolidate job (dedupe + optional reindex)
+  drain-shutdown-queue    Ingest durable facts from queued session shutdown metadata
+
+Options:
+  --agent-dir PATH        Memory data directory (overrides PI_MEMORY_AGENT_DIR)
+  --verbose, -v           Extra stderr output (TTY colors when supported)
+
+Consolidate / maintenance:
+  --cron                  Daily OS cron slot (passes cronFired to shouldConsolidate)
+  --force                 Run consolidate even when shouldConsolidate is false
+
+Environment:
+  PI_MEMORY_ENV_FILE        Explicit .env path
+  PI_MEMORY_AGENT_DIR       Memory data root; default ~/.pi/pi-memory-data
+  PI_MEMORY_DEBUG=1         Debug stderr logs (extension preflight + CLI)
+  NO_COLOR                  Disable chalk colors
+
+Examples:
+  pi-memory init
+  pi-memory status
+  pi-memory maintenance --cron --verbose
+  pi-memory consolidate --force --verbose
+  pi-memory drain-shutdown-queue --verbose
+`;
+//# sourceMappingURL=parseArgs.js.map

package/dist/cli/parseArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseArgs.js","sourceRoot":"","sources":["../../src/cli/parseArgs.ts"],"names":[],"mappings":"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"}

package/dist/cli/status.d.ts

@@ -0,0 +1,44 @@
+import type { MemoryStats } from "../store/types.js";
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import type { CliLog } from "./log.js";
+export type StatusPalette = {
+    dim: (text: string) => string;
+    ok: (text: string) => string;
+    bad: (text: string) => string;
+    warn: (text: string) => string;
+};
+export declare function cliStatusPalette(): StatusPalette;
+export declare function piStatusPalette(theme: Theme): StatusPalette;
+export type MemoryStatusReport = {
+    agentDir: string;
+    memory: MemoryStats;
+    sidecar: {
+        socketPath: string;
+        running: boolean;
+    };
+    vectorIndex: {
+        dbPath: string;
+        exists: boolean;
+        generation?: number;
+        chunkCount?: number;
+        embeddingProvider?: string;
+        embeddingModel?: string;
+        embeddingDim?: number;
+        /** Set when the index file exists but could not be read locally. */
+        readError?: string;
+        /** Stats came from sidecar RPC rather than opening sqlite in-process. */
+        fromSidecar?: boolean;
+    };
+    embedder: {
+        provider: string;
+        model: string;
+        dim: number;
+    };
+};
+export declare function gatherMemoryStatus(agentDir: string): Promise<MemoryStatusReport>;
+export declare function formatMemoryStatusSummary(report: MemoryStatusReport, palette: StatusPalette, accent: (text: string) => string): string;
+export declare function formatMemoryStatusLines(report: MemoryStatusReport): string[];
+export declare function formatMemoryStatusTuiLines(report: MemoryStatusReport, palette: StatusPalette, theme: Theme): string[];
+export declare function printMemoryStatus(report: MemoryStatusReport, log: CliLog): void;
+export declare function runStatusCommand(agentDir: string, log: CliLog): Promise<number>;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGrD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;CAChC,CAAC;AASF,wBAAgB,gBAAgB,IAAI,aAAa,CAOhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,CAO3D;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IACF,WAAW,EAAE;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,oEAAoE;QACpE,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,yEAAyE;QACzE,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH,CAAC;AAyDF,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8CtF;AA4FD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,MAAM,CAqBR;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,EAAE,CAI5E;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,KAAK,GACX,MAAM,EAAE,CAIV;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAK/E;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrF"}

package/dist/cli/status.js

@@ -0,0 +1,238 @@
+import { readPiMemoryEnv, resolveEmbedDim } from "../config/env.js";
+import { DEFAULT_HASH_EMBED_DIM } from "../constants/env.js";
+import { createEmbedder } from "../adapters/embed/factory.js";
+import { fetchIndexStats, ping } from "../sidecar/client.js";
+import { resolveSidecarPaths } from "../sidecar/paths.js";
+import { getVecStore } from "../sidecar/server/vec/store.js";
+import { createMemoryStore } from "../store/index.js";
+import { pathExists } from "../utils/fs.js";
+import { theme } from "./theme.js";
+const plainPalette = {
+    dim: (text) => text,
+    ok: (text) => text,
+    bad: (text) => text,
+    warn: (text) => text,
+};
+export function cliStatusPalette() {
+    return {
+        dim: theme.dim,
+        ok: theme.ok,
+        bad: theme.bad,
+        warn: theme.warn,
+    };
+}
+export function piStatusPalette(theme) {
+    return {
+        dim: (text) => theme.fg("dim", text),
+        ok: (text) => theme.fg("success", text),
+        bad: (text) => theme.fg("error", text),
+        warn: (text) => theme.fg("warning", text),
+    };
+}
+function applyLocalVecStats(report, dbPath) {
+    const vec = getVecStore(dbPath);
+    report.vectorIndex.generation = vec.getIndexGeneration();
+    report.vectorIndex.chunkCount = vec.getChunkCount();
+    const meta = vec.getStoredEmbeddingMeta();
+    if (meta) {
+        report.vectorIndex.embeddingProvider = meta.provider;
+        report.vectorIndex.embeddingModel = meta.model;
+        report.vectorIndex.embeddingDim = meta.dim;
+    }
+}
+function applySidecarVecStats(report, stats) {
+    report.vectorIndex.fromSidecar = true;
+    report.vectorIndex.generation = stats.index_generation;
+    report.vectorIndex.chunkCount = stats.chunk_count;
+    if (stats.embedding_provider && stats.embedding_model && stats.embedding_dim !== undefined) {
+        report.vectorIndex.embeddingProvider = stats.embedding_provider;
+        report.vectorIndex.embeddingModel = stats.embedding_model;
+        report.vectorIndex.embeddingDim = stats.embedding_dim;
+    }
+}
+function embedderMatchesIndex(report) {
+    const { embeddingProvider, embeddingModel, embeddingDim } = report.vectorIndex;
+    if (!embeddingProvider || !embeddingModel || embeddingDim === undefined)
+        return true;
+    return (embeddingProvider === report.embedder.provider &&
+        embeddingModel === report.embedder.model &&
+        embeddingDim === report.embedder.dim);
+}
+function resolveConfiguredEmbedder(env) {
+    try {
+        const embedder = createEmbedder(env);
+        return { provider: embedder.provider, model: embedder.model, dim: embedder.dim };
+    }
+    catch {
+        const embedModel = env.embedder === "openai"
+            ? env.openaiEmbedModel
+            : env.embedder === "ollama"
+                ? env.ollamaEmbedModel
+                : "hash/dev";
+        const dim = env.embedder === "hash"
+            ? (env.embedDimOverride ?? DEFAULT_HASH_EMBED_DIM)
+            : resolveEmbedDim(embedModel, env.embedDimOverride);
+        return { provider: env.embedder, model: embedModel, dim };
+    }
+}
+export async function gatherMemoryStatus(agentDir) {
+    const store = createMemoryStore({ agentDir });
+    await store.ensureInitialized();
+    const sidecar = resolveSidecarPaths(agentDir);
+    const env = readPiMemoryEnv();
+    const sidecarRunning = await ping(sidecar.socketPath);
+    const report = {
+        agentDir,
+        memory: await store.getStats(),
+        sidecar: {
+            socketPath: sidecar.socketPath,
+            running: sidecarRunning,
+        },
+        vectorIndex: {
+            dbPath: sidecar.dbPath,
+            exists: pathExists(sidecar.dbPath),
+        },
+        embedder: resolveConfiguredEmbedder(env),
+    };
+    if (!report.vectorIndex.exists)
+        return report;
+    if (sidecarRunning) {
+        const result = await fetchIndexStats(sidecar.socketPath);
+        if ("stats" in result) {
+            applySidecarVecStats(report, result.stats);
+            return report;
+        }
+        const hint = result.error.includes("unknown frame type")
+            ? "restart sidecar (reload Pi session or pi-memory)"
+            : result.error;
+        report.vectorIndex.readError = hint;
+        return report;
+    }
+    try {
+        applyLocalVecStats(report, sidecar.dbPath);
+    }
+    catch (error) {
+        report.vectorIndex.readError =
+            error instanceof Error ? error.message : "unable to open vector index (start sidecar)";
+    }
+    return report;
+}
+function formatVectorIndexLine(report) {
+    const { generation, chunkCount, readError } = report.vectorIndex;
+    if (readError) {
+        return `(unreadable: ${readError})`;
+    }
+    if (generation === undefined || chunkCount === undefined) {
+        return "(unknown — start sidecar or run pi-memory status again)";
+    }
+    return `gen=${generation} chunks=${chunkCount}`;
+}
+function formatIndexEmbedderLine(report, palette) {
+    const { embeddingProvider, embeddingModel, embeddingDim, chunkCount, readError } = report.vectorIndex;
+    if (readError) {
+        return palette.dim("(unavailable)");
+    }
+    if (!embeddingProvider || !embeddingModel || embeddingDim === undefined) {
+        if (chunkCount === 0) {
+            return palette.dim("(empty — reindex pending)");
+        }
+        return palette.dim("(no embedding meta — run reindex)");
+    }
+    const label = `${embeddingProvider}/${embeddingModel} (${embeddingDim}d)`;
+    if (embedderMatchesIndex(report)) {
+        return label;
+    }
+    return palette.warn(`${label} ≠ configured`);
+}
+function memoryStatusRows(report, palette = plainPalette) {
+    const lastConsolidated = report.memory.lastConsolidatedAt ?? "(never)";
+    const sidecarState = report.sidecar.running ? "running" : "not reachable";
+    const sidecarDetail = `${sidecarState} (${report.sidecar.socketPath})`;
+    const rows = [
+        { label: "agent dir", value: () => report.agentDir },
+        { label: "MEMORY lines", value: () => String(report.memory.lineCount) },
+        { label: "entries", value: () => String(report.memory.entryCount) },
+        { label: "overflow files", value: () => String(report.memory.overflowFileCount) },
+        {
+            label: "last consolidate",
+            value: () => !report.memory.lastConsolidatedAt ? palette.dim(lastConsolidated) : lastConsolidated,
+        },
+        {
+            label: "sidecar",
+            value: () => {
+                const state = report.sidecar.running ? palette.ok(sidecarState) : palette.bad(sidecarState);
+                return `${state} ${palette.dim(`(${report.sidecar.socketPath})`)}`;
+            },
+        },
+    ];
+    if (!report.vectorIndex.exists) {
+        rows.push({
+            label: "vector index",
+            value: () => palette.dim("(missing — write MEMORY or start session)"),
+        });
+    }
+    else {
+        rows.push({
+            label: "vector index",
+            value: () => {
+                const line = formatVectorIndexLine(report);
+                if (report.vectorIndex.readError)
+                    return palette.bad(line);
+                if (report.vectorIndex.generation === undefined || report.vectorIndex.chunkCount === undefined) {
+                    return palette.dim(line);
+                }
+                return line;
+            },
+        });
+        rows.push({
+            label: "index embedder",
+            value: () => formatIndexEmbedderLine(report, palette),
+        });
+    }
+    rows.push({
+        label: "configured embedder",
+        value: () => `${report.embedder.provider}/${report.embedder.model} (${report.embedder.dim}d)`,
+    });
+    return rows;
+}
+export function formatMemoryStatusSummary(report, palette, accent) {
+    const parts = [
+        accent("pi-memory"),
+        palette.dim(`entries=${report.memory.entryCount}`),
+        report.sidecar.running ? palette.ok("sidecar up") : palette.bad("sidecar down"),
+    ];
+    if (!report.vectorIndex.exists) {
+        parts.push(palette.dim("no index"));
+    }
+    else {
+        const vec = formatVectorIndexLine(report);
+        if (report.vectorIndex.readError) {
+            parts.push(palette.bad(vec));
+        }
+        else if (report.vectorIndex.generation === undefined || report.vectorIndex.chunkCount === undefined) {
+            parts.push(palette.dim(vec));
+        }
+        else {
+            parts.push(vec);
+        }
+    }
+    return parts.join(palette.dim(" · "));
+}
+export function formatMemoryStatusLines(report) {
+    return memoryStatusRows(report).map(({ label, value }) => `${label.padEnd(16)} ${value()}`);
+}
+export function formatMemoryStatusTuiLines(report, palette, theme) {
+    return memoryStatusRows(report, palette).map(({ label, value }) => `${theme.fg("muted", label.padEnd(16))} ${value()}`);
+}
+export function printMemoryStatus(report, log) {
+    const palette = cliStatusPalette();
+    for (const { label, value } of memoryStatusRows(report, palette)) {
+        log.line(label, value());
+    }
+}
+export async function runStatusCommand(agentDir, log) {
+    const report = await gatherMemoryStatus(agentDir);
+    printMemoryStatus(report, log);
+    return 0;
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/cli/status.ts"],"names":[],"mappings":"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"}