@astragenie/astramemory-local 0.7.2

package/dist/cli/open-runtime-db.js

@@ -0,0 +1,37 @@
+/**
+ * open-runtime-db.ts — one way for CLI one-shots to open the production DB.
+ *
+ * queue/budget/rebuild predated encryption-at-rest and opened the DB with
+ * `defaultConfig()` + no key: against an encrypted database they died with
+ * "SqliteError: file is not a database", and against a non-default
+ * config.yaml dataDir they opened the wrong file entirely — the same two
+ * bug classes fixed for doctor/backup in the Wave-0/1 hardening.
+ */
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { resolveRuntimeConfig } from '../config/resolve-runtime.js';
+import { defaultConfigDir } from '../config/datadir.js';
+import { getOrCreateKey } from '../storage/keystore.js';
+import { openDb } from '../storage/db.js';
+import { migrate } from '../storage/migrate.js';
+import { isPlaintextSqlite } from '../storage/migrate-encrypt.js';
+/** Resolve config the same way serve does, open key-aware, run migrations.
+ *
+ * Key is applied only when the file on disk is actually encrypted: a
+ * plaintext DB (fresh test dir, encryption recently toggled on but serve's
+ * auto-migration not yet run) must be opened WITHOUT a key — PRAGMA key on
+ * a plaintext file makes every read fail with "file is not a database".
+ * serve owns the plaintext→encrypted migration; one-shot commands do not. */
+export function openRuntimeDb() {
+    const { cfg, dataDir } = resolveRuntimeConfig();
+    const dbPath = dataDir === ':memory:' ? ':memory:' : join(dataDir, 'memory.sqlite');
+    const wantKey = dbPath !== ':memory:' &&
+        cfg.security.encryption.enabled &&
+        existsSync(dbPath) &&
+        !isPlaintextSqlite(dbPath);
+    const key = wantKey ? getOrCreateKey(defaultConfigDir()).key : undefined;
+    const db = openDb(dbPath, key ? { key } : {});
+    migrate(db, cfg.embedding.dim);
+    return { db, cfg, dataDir };
+}
+//# sourceMappingURL=open-runtime-db.js.map

package/dist/cli/open-runtime-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-runtime-db.js","sourceRoot":"","sources":["../../src/cli/open-runtime-db.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAW,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AASlE;;;;;;6EAM6E;AAC7E,MAAM,UAAU,aAAa;IAC3B,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACpF,MAAM,OAAO,GACX,MAAM,KAAK,UAAU;QACrB,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO;QAC/B,UAAU,CAAC,MAAM,CAAC;QAClB,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7B,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/cli/pair.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `astramem-local pair <code> --url <cloud-url>` — Wave 3e device pairing.
+ *
+ * Redeems a FEAT-278 claim code against the cloud (possession of code =
+ * credential; POST /claims/{code}/redeem, no auth) and wires up sync:
+ *   1. the returned ApiKey goes into the OS credential store as the sync
+ *      device token (never written to disk in plaintext),
+ *   2. url/workspaceId land in <configDir>/sync.json with enabled=true,
+ *      merged into Config.sync at the next daemon start.
+ *
+ * Claim codes come from the AstraMemory dashboard (POST /me/claims).
+ */
+export interface RedeemResponse {
+    apiUrl: string;
+    tenantId: string;
+    workspaceId: string;
+    apiKey: string;
+}
+export type RedeemResult = {
+    ok: true;
+    data: RedeemResponse;
+} | {
+    ok: false;
+    status: number;
+    message: string;
+};
+/** POST /claims/{code}/redeem. Exposed for tests via injectable fetch. */
+export declare function redeemClaim(cloudUrl: string, code: string, fetchImpl?: typeof fetch): Promise<RedeemResult>;
+export declare function pairCommand(args: string[]): Promise<void>;

package/dist/cli/pair.js

@@ -0,0 +1,64 @@
+/**
+ * `astramem-local pair <code> --url <cloud-url>` — Wave 3e device pairing.
+ *
+ * Redeems a FEAT-278 claim code against the cloud (possession of code =
+ * credential; POST /claims/{code}/redeem, no auth) and wires up sync:
+ *   1. the returned ApiKey goes into the OS credential store as the sync
+ *      device token (never written to disk in plaintext),
+ *   2. url/workspaceId land in <configDir>/sync.json with enabled=true,
+ *      merged into Config.sync at the next daemon start.
+ *
+ * Claim codes come from the AstraMemory dashboard (POST /me/claims).
+ */
+import { defaultConfigDir } from '../config/datadir.js';
+import { writeSyncSettings } from '../config/sync-settings.js';
+import { storeSyncToken } from '../storage/keystore.js';
+/** POST /claims/{code}/redeem. Exposed for tests via injectable fetch. */
+export async function redeemClaim(cloudUrl, code, fetchImpl = fetch) {
+    const res = await fetchImpl(`${cloudUrl.replace(/\/$/, '')}/claims/${encodeURIComponent(code)}/redeem`, {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+    });
+    if (res.status === 410) {
+        return { ok: false, status: 410, message: 'claim code expired, already redeemed, or unknown — issue a fresh code from the dashboard' };
+    }
+    if (res.status === 429) {
+        const retryAfter = res.headers.get('retry-after') ?? '60';
+        return { ok: false, status: 429, message: `rate limited — retry in ${retryAfter}s` };
+    }
+    if (!res.ok) {
+        return { ok: false, status: res.status, message: `cloud returned HTTP ${res.status}` };
+    }
+    const body = await res.json();
+    if (!body.apiKey || !body.workspaceId || !body.apiUrl) {
+        return { ok: false, status: res.status, message: 'redeem succeeded but response was missing apiKey/workspaceId/apiUrl' };
+    }
+    return { ok: true, data: body };
+}
+function parseArg(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+export async function pairCommand(args) {
+    const code = args.find(a => !a.startsWith('-'));
+    const cloudUrl = parseArg(args, '--url') ?? process.env.ASTRA_SYNC_URL;
+    if (!code || !cloudUrl) {
+        console.error('usage: astramem-local pair <claim-code> --url <cloud-url>   (or set ASTRA_SYNC_URL)');
+        process.exit(1);
+    }
+    const result = await redeemClaim(cloudUrl, code);
+    if (!result.ok) {
+        console.error(`pair failed (HTTP ${result.status}): ${result.message}`);
+        process.exit(1);
+    }
+    const { apiUrl, tenantId, workspaceId, apiKey } = result.data;
+    const stored = storeSyncToken(apiKey);
+    const configDir = defaultConfigDir();
+    writeSyncSettings(configDir, { enabled: true, url: apiUrl, workspaceId, tenantId });
+    console.log('✓ paired with AstraMemory cloud');
+    console.log(`  workspace : ${workspaceId}`);
+    console.log(`  api url   : ${apiUrl}`);
+    console.log(`  token     : ${stored.stored ? 'stored in OS credential store' : 'NOT stored — set ASTRA_SYNC_TOKEN yourself'}`);
+    console.log('\nRestart the daemon to start the sync shipper (team/org-scoped memories only — personal never syncs).');
+}
+//# sourceMappingURL=pair.js.map

package/dist/cli/pair.js.map

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

package/dist/cli/providers.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `astramem-local providers [--json]`
+ *
+ * Shows the configured LLM (compaction/extraction) + embedding providers and
+ * runs the same live health probes `astramem-local doctor` uses
+ * (doctor/probes/llm-chat-probe.ts, doctor/probes/embed-probe.ts) — a real
+ * 1-token chat call and a real embed call with dim assertion, not just
+ * surface-level config echo.
+ */
+export declare function providersCommand(args: string[]): Promise<void>;

package/dist/cli/providers.js

@@ -0,0 +1,97 @@
+/**
+ * `astramem-local providers [--json]`
+ *
+ * Shows the configured LLM (compaction/extraction) + embedding providers and
+ * runs the same live health probes `astramem-local doctor` uses
+ * (doctor/probes/llm-chat-probe.ts, doctor/probes/embed-probe.ts) — a real
+ * 1-token chat call and a real embed call with dim assertion, not just
+ * surface-level config echo.
+ */
+import { defaultConfig } from '../config/config.js';
+import { runChecks, formatTable } from '../doctor/runner.js';
+import { llmChatProbe } from '../doctor/probes/llm-chat-probe.js';
+import { embedProbe } from '../doctor/probes/embed-probe.js';
+export async function providersCommand(args) {
+    const jsonMode = args.includes('--json');
+    const cfg = defaultConfig();
+    const useMock = process.env.ASTRA_MEMORY_MOCK_PROVIDERS === '1';
+    const configured = {
+        mode: useMock ? 'mock' : 'live',
+        llm_compaction: `${cfg.llm.compaction.provider}/${cfg.llm.compaction.model}`,
+        llm_extraction: `${cfg.llm.extraction.provider}/${cfg.llm.extraction.model}`,
+        embedding: `${cfg.embedding.provider}/${cfg.embedding.model}`,
+    };
+    let providers;
+    let buildError;
+    if (useMock) {
+        const { makeMockProviders } = await import('../pipeline/mock-providers.js');
+        providers = makeMockProviders();
+    }
+    else {
+        try {
+            const { getProviders } = await import('../providers/index.js');
+            providers = getProviders(cfg);
+        }
+        catch (err) {
+            buildError = err instanceof Error ? err.message : String(err);
+        }
+    }
+    const checks = [];
+    if (providers) {
+        const p = providers;
+        checks.push({
+            name: `LLM chat probe (compaction: ${p.llm.compaction.name}/${p.llm.compaction.model})`,
+            run: () => llmChatProbe(p.llm.compaction),
+        });
+        const sameProvider = p.llm.compaction.name === p.llm.extraction.name && p.llm.compaction.model === p.llm.extraction.model;
+        if (!sameProvider) {
+            checks.push({
+                name: `LLM chat probe (extraction: ${p.llm.extraction.name}/${p.llm.extraction.model})`,
+                run: () => llmChatProbe(p.llm.extraction),
+            });
+        }
+        checks.push({
+            name: `Embed probe (${p.embed.name}/${p.embed.model})`,
+            run: () => embedProbe(p.embed),
+        });
+    }
+    else {
+        checks.push({
+            name: 'Provider construction',
+            run: async () => ({
+                ok: false,
+                message: buildError ?? 'unknown provider construction error',
+                fix: 'Check config.llm / config.embedding and required env vars (e.g. AZURE_OPENAI_API_KEY, AZURE_OPENAI_ENDPOINT)',
+            }),
+        });
+    }
+    const results = await runChecks(checks);
+    if (jsonMode) {
+        console.log(JSON.stringify({
+            configured,
+            checks: results,
+            summary: {
+                ok: results.filter(r => r.ok).length,
+                fail: results.filter(r => !r.ok).length,
+            },
+        }, null, 2));
+    }
+    else {
+        console.log('');
+        console.log('  AstraMemory Providers');
+        console.log('  ──────────────────────────────');
+        console.log(`  Mode           : ${configured.mode}`);
+        console.log(`  LLM compaction : ${configured.llm_compaction}`);
+        console.log(`  LLM extraction : ${configured.llm_extraction}`);
+        console.log(`  Embedding      : ${configured.embedding}`);
+        console.log('');
+        console.log(formatTable(results));
+        const failCount = results.filter(r => !r.ok).length;
+        const okCount = results.filter(r => r.ok).length;
+        console.log(`\n  ${okCount} passed, ${failCount} failed\n`);
+    }
+    const hasFailures = results.some(r => !r.ok);
+    if (hasFailures)
+        process.exit(1);
+}
+//# sourceMappingURL=providers.js.map

package/dist/cli/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/cli/providers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAA4B,MAAM,qBAAqB,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG7D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,KAAK,GAAG,CAAC;IAEhE,MAAM,UAAU,GAAG;QACjB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;QAC/B,cAAc,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE;QAC5E,cAAc,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,EAAE;QAC5E,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,CAAC,QAAQ,IAAI,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE;KAC9D,CAAC;IAEF,IAAI,SAAkC,CAAC;IACvC,IAAI,UAA8B,CAAC;IACnC,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;QAC5E,SAAS,GAAG,iBAAiB,EAAE,CAAC;IAClC,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;YAC/D,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAY,EAAE,CAAC;IAC3B,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,SAAS,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,+BAA+B,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG;YACvF,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;SAC1C,CAAC,CAAC;QACH,MAAM,YAAY,GAChB,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC;QACvG,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,+BAA+B,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG;gBACvF,GAAG,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,gBAAgB,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,GAAG;YACtD,GAAG,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;SAC/B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,uBAAuB;YAC7B,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;gBAChB,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,UAAU,IAAI,qCAAqC;gBAC5D,GAAG,EAAE,8GAA8G;aACpH,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAA0B,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAE/D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;YACE,UAAU;YACV,MAAM,EAAE,OAAO;YACf,OAAO,EAAE;gBACP,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM;gBACpC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM;aACxC;SACF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,cAAc,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,sBAAsB,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;QACpD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,YAAY,SAAS,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC7C,IAAI,WAAW;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACnC,CAAC"}

package/dist/cli/queue-purge.d.ts

@@ -0,0 +1,5 @@
+export interface PurgeResult {
+    purged: number;
+    dumpPath: string | null;
+}
+export declare function queuePurgeCommand(args: string[]): Promise<void>;

package/dist/cli/queue-purge.js

@@ -0,0 +1,92 @@
+/**
+ * `astramem-local queue purge --poison [--json] [--dump-dir PATH]`
+ *
+ * Manual poison-job purge (FEAT-405) ahead of the 30-day auto-purge
+ * (src/pipeline/handlers/cleanup.ts). Writes a forensics dump (job payload +
+ * failure reason per job) BEFORE deleting anything, so an operator who
+ * cleared stuck poison jobs on demand can still inspect what was removed.
+ *
+ * Exit codes:
+ *   0 = success (including the zero-poison-jobs no-op)
+ *   1 = failure (dump dir could not be created/written)
+ */
+import { join } from 'node:path';
+import { mkdirSync, writeFileSync } from 'node:fs';
+import { openRuntimeDb } from './open-runtime-db.js';
+import { JobRepo } from '../pipeline/job-repo.js';
+function parseArg(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+function safeParsePayload(payloadJson) {
+    try {
+        return JSON.parse(payloadJson);
+    }
+    catch {
+        return payloadJson;
+    }
+}
+export async function queuePurgeCommand(args) {
+    const jsonMode = args.includes('--json');
+    if (!args.includes('--poison')) {
+        console.error('queue purge: only --poison is supported (usage: `queue purge --poison`)');
+        process.exit(1);
+        return;
+    }
+    const { db, dataDir } = openRuntimeDb();
+    const repo = new JobRepo(db);
+    // Read poison jobs BEFORE any deletion — the forensics dump must reflect
+    // exactly what gets purged.
+    const poisonJobs = repo.listPoison();
+    if (poisonJobs.length === 0) {
+        db.close();
+        const result = { purged: 0, dumpPath: null };
+        if (jsonMode) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log('queue purge: no poison jobs found — nothing to do.');
+        }
+        return;
+    }
+    const dumpDir = parseArg(args, '--dump-dir') ?? join(dataDir, 'forensics');
+    let dumpPath;
+    try {
+        // Create the dump dir if missing rather than silently dropping the
+        // forensics dump (AC-5). mkdirSync throws loud on a real failure (e.g.
+        // a file occupying the path, or a permissions error).
+        mkdirSync(dumpDir, { recursive: true });
+        const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+        dumpPath = join(dumpDir, `poison-purge-${stamp}.json`);
+        const dump = poisonJobs.map(j => ({
+            id: j.id,
+            kind: j.kind,
+            payload: safeParsePayload(j.payload_json),
+            failure_reason: j.last_error,
+            attempts: j.attempts,
+            created_at: j.created_at,
+            updated_at: j.updated_at,
+        }));
+        writeFileSync(dumpPath, JSON.stringify({ purged_at: Date.now(), count: dump.length, jobs: dump }, null, 2), 'utf-8');
+    }
+    catch (err) {
+        db.close();
+        console.error(`queue purge: failed to write forensics dump to ${dumpDir}: ${String(err)}`);
+        process.exit(1);
+        return;
+    }
+    // Delete exactly the ids captured above (not a blanket state='poison'
+    // delete) so a job that gets poisoned concurrently, after the dump was
+    // written, is never swept up without ever appearing in a forensics dump.
+    const purged = repo.purgePoisonByIds(poisonJobs.map(j => j.id));
+    db.close();
+    const result = { purged, dumpPath };
+    if (jsonMode) {
+        console.log(JSON.stringify(result));
+    }
+    else {
+        console.log(`queue purge: removed ${purged} poison job(s).`);
+        console.log(`  Forensics dump: ${dumpPath}`);
+    }
+}
+//# sourceMappingURL=queue-purge.js.map

package/dist/cli/queue-purge.js.map

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

package/dist/cli/queue.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `astramem-local queue [--json] [--limit N]`
+ * `astramem-local queue purge --poison [--json] [--dump-dir PATH]`
+ *
+ * Shows job-table state counts (pending/running/completed/failed/poison/paused)
+ * plus the most recent failures (state IN ('failed','poison')) with their
+ * last_error, so an operator can see what's stuck without opening the DB.
+ *
+ * The `purge --poison` subcommand (FEAT-405) removes poison-marked jobs on
+ * demand, ahead of the 30-day auto-purge — see ./queue-purge.ts.
+ */
+import type { JobState } from '../contracts/index.js';
+interface StateCount {
+    state: JobState;
+    n: number;
+}
+interface RecentFailure {
+    id: string;
+    kind: string;
+    attempts: number;
+    last_error: string | null;
+    updated_at: number;
+}
+export interface QueueSummary {
+    counts: StateCount[];
+    recentFailures: RecentFailure[];
+}
+export declare function queueCommand(args: string[]): Promise<void>;
+export {};

package/dist/cli/queue.js

@@ -0,0 +1,73 @@
+/**
+ * `astramem-local queue [--json] [--limit N]`
+ * `astramem-local queue purge --poison [--json] [--dump-dir PATH]`
+ *
+ * Shows job-table state counts (pending/running/completed/failed/poison/paused)
+ * plus the most recent failures (state IN ('failed','poison')) with their
+ * last_error, so an operator can see what's stuck without opening the DB.
+ *
+ * The `purge --poison` subcommand (FEAT-405) removes poison-marked jobs on
+ * demand, ahead of the 30-day auto-purge — see ./queue-purge.ts.
+ */
+import { openRuntimeDb } from './open-runtime-db.js';
+import { queuePurgeCommand } from './queue-purge.js';
+function parseArg(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+export async function queueCommand(args) {
+    if (args[0] === 'purge') {
+        await queuePurgeCommand(args.slice(1));
+        return;
+    }
+    const jsonMode = args.includes('--json');
+    const limitArg = parseArg(args, '--limit');
+    const limit = limitArg ? Math.max(1, Number(limitArg)) : 10;
+    // Key-aware + config.yaml-aware open (same resolution as serve/doctor).
+    const { db } = openRuntimeDb();
+    const counts = db
+        .prepare('SELECT state, COUNT(*) AS n FROM jobs GROUP BY state ORDER BY state')
+        .all();
+    const recentFailures = db
+        .prepare(`
+      SELECT id, kind, attempts, last_error, updated_at
+      FROM jobs
+      WHERE state IN ('failed', 'poison')
+      ORDER BY updated_at DESC
+      LIMIT ?
+    `)
+        .all(limit);
+    db.close();
+    const summary = { counts, recentFailures };
+    if (jsonMode) {
+        console.log(JSON.stringify(summary, null, 2));
+        return;
+    }
+    console.log('');
+    console.log('  AstraMemory Job Queue');
+    console.log('  ──────────────────────────────');
+    if (counts.length === 0) {
+        console.log('  (no jobs yet)');
+    }
+    else {
+        const total = counts.reduce((sum, c) => sum + c.n, 0);
+        for (const c of counts) {
+            console.log(`  ${c.state.padEnd(10)} ${c.n}`);
+        }
+        console.log(`  ${'total'.padEnd(10)} ${total}`);
+    }
+    console.log('');
+    if (recentFailures.length === 0) {
+        console.log('  No recent failures.');
+    }
+    else {
+        console.log(`  Recent failures (last ${recentFailures.length}):`);
+        for (const f of recentFailures) {
+            const when = new Date(f.updated_at).toISOString();
+            const err = (f.last_error ?? '(no error recorded)').slice(0, 160);
+            console.log(`    [${when}] ${f.kind} ${f.id} (attempts=${f.attempts}): ${err}`);
+        }
+    }
+    console.log('');
+}
+//# sourceMappingURL=queue.js.map

package/dist/cli/queue.js.map

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

package/dist/cli/rebuild.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `astramem-local rebuild [--repo REPO] [--project PROJECT] [--limit N] [--dry-run] [--json]`
+ *
+ * Re-embed/reindex flow: enumerates existing memories and enqueues one
+ * `reembed` job per memory via the same JobRepo used by ingest — the
+ * daemon's worker (500ms poll, src/pipeline/worker.ts) recomputes each
+ * embedding with the configured provider and upserts the vector row
+ * (src/pipeline/handlers/reembed.ts). Requires a running daemon.
+ */
+export interface RebuildResult {
+    candidateCount: number;
+    queuedIds: string[];
+    dryRun: boolean;
+}
+export declare function rebuildCommand(args: string[]): Promise<void>;

package/dist/cli/rebuild.js

@@ -0,0 +1,70 @@
+/**
+ * `astramem-local rebuild [--repo REPO] [--project PROJECT] [--limit N] [--dry-run] [--json]`
+ *
+ * Re-embed/reindex flow: enumerates existing memories and enqueues one
+ * `reembed` job per memory via the same JobRepo used by ingest — the
+ * daemon's worker (500ms poll, src/pipeline/worker.ts) recomputes each
+ * embedding with the configured provider and upserts the vector row
+ * (src/pipeline/handlers/reembed.ts). Requires a running daemon.
+ */
+import { openRuntimeDb } from './open-runtime-db.js';
+import { JobRepo } from '../pipeline/job-repo.js';
+function parseArg(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+export async function rebuildCommand(args) {
+    const jsonMode = args.includes('--json');
+    const dryRun = args.includes('--dry-run');
+    const repo = parseArg(args, '--repo');
+    const project = parseArg(args, '--project');
+    const limitArg = parseArg(args, '--limit');
+    const limit = limitArg ? Math.max(1, Number(limitArg)) : undefined;
+    // Key-aware + config.yaml-aware open (same resolution as serve/doctor).
+    const { db } = openRuntimeDb();
+    const conditions = [];
+    const params = [];
+    if (repo) {
+        conditions.push('repo = ?');
+        params.push(repo);
+    }
+    if (project) {
+        conditions.push('project = ?');
+        params.push(project);
+    }
+    const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+    const limitClause = limit !== undefined ? ` LIMIT ${limit}` : '';
+    const candidates = db
+        .prepare(`SELECT id FROM memories ${where} ORDER BY created_at ASC${limitClause}`)
+        .all(...params);
+    const queuedIds = [];
+    if (!dryRun && candidates.length > 0) {
+        const repoDao = new JobRepo(db);
+        const tx = db.transaction(() => {
+            for (const c of candidates) {
+                repoDao.enqueue('reembed', { kind: 'reembed', memory_id: c.id });
+                queuedIds.push(c.id);
+            }
+        });
+        tx();
+    }
+    db.close();
+    const result = { candidateCount: candidates.length, queuedIds, dryRun };
+    if (jsonMode) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log('');
+    console.log('  AstraMemory Rebuild');
+    console.log('  ──────────────────────────────');
+    console.log(`  Candidates matched: ${result.candidateCount}`);
+    if (dryRun) {
+        console.log('  --dry-run: no jobs were queued.');
+    }
+    else {
+        console.log(`  Reembed jobs queued: ${queuedIds.length}`);
+        console.log('  The running daemon will recompute embeddings with the configured provider.');
+    }
+    console.log('');
+}
+//# sourceMappingURL=rebuild.js.map

package/dist/cli/rebuild.js.map

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

package/dist/cli/reembed-dim.d.ts

@@ -0,0 +1,21 @@
+import { type DB } from '../storage/db.js';
+import type { EmbedProvider } from '../contracts/embed.js';
+export interface ReembedDimResult {
+    targetDim: number;
+    totalCandidates: number;
+    alreadyDone: number;
+    reembedded: number;
+    failed: Array<{
+        memoryId: string;
+        error: string;
+    }>;
+    schemaRecreated: boolean;
+}
+/**
+ * Testable core: no process.exit, no config.yaml writes, no provider
+ * resolution — the caller supplies `embed` (already verified to produce
+ * `targetDim`-shaped vectors). Safe to call repeatedly against the same DB
+ * for the same targetDim (resumable — see module doc).
+ */
+export declare function runReembedDim(db: DB, targetDim: number, embed: EmbedProvider, batchSize?: number): Promise<ReembedDimResult>;
+export declare function reembedDimCommand(args: string[]): Promise<void>;