@chendpoc/pi-memory 0.1.13 → 0.2.0

package/dist/cli/jobs.d.ts

@@ -0,0 +1,32 @@
+import type { CliLog } from "./log.js";
+import type { LlmClient } from "../adapters/llm/types.js";
+import type { MemoryStore } from "../store/memoryStore.js";
+export type MaintenanceCliOptions = {
+    cron: boolean;
+    force: boolean;
+    verbose: boolean;
+};
+export declare function runMaintenanceCommand(opts: {
+    store: MemoryStore;
+    agentDir: string;
+    llm: LlmClient | null;
+    options: MaintenanceCliOptions;
+    log: CliLog;
+}): Promise<number>;
+export declare function runDrainShutdownQueueCommand(opts: {
+    store: MemoryStore;
+    agentDir: string;
+    llm: LlmClient | null;
+    verbose: boolean;
+    log: CliLog;
+}): Promise<number>;
+export declare function runConsolidateCommand(opts: {
+    store: MemoryStore;
+    agentDir: string;
+    llm: LlmClient | null;
+    cron: boolean;
+    force: boolean;
+    verbose: boolean;
+    log: CliLog;
+}): Promise<number>;
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/cli/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlB;AAED,wBAAsB,4BAA4B,CAAC,IAAI,EAAE;IACvD,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBlB;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,MAAM,CAAC,CA2BlB"}

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"}