@astragenie/astramemory-local 0.7.2

package/dist/cli/consolidate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `astramem-local consolidate <run|proposals|accept|reject>` — operator
+ * surface for the ADR-004 stage-9 consolidation pass.
+ *
+ *   consolidate run [--json]              trigger a pass now (also scheduled
+ *                                         at boot + every 6h by the daemon)
+ *   consolidate proposals [--json]        list pending merge proposals with
+ *                                         both texts side by side
+ *   consolidate accept <id|--all> [--json]  accept proposal(s) — merges loser
+ *                                         into winner (supersede, not delete)
+ *   consolidate reject <id> [--json]      reject a proposal
+ *
+ * Talks to the running daemon over HTTP (same env contract as search/recall):
+ * ASTRA_MEMORY_URL (default http://127.0.0.1:7777), ASTRA_MEMORY_TOKEN.
+ */
+export declare function consolidateCommand(args: string[]): Promise<void>;

package/dist/cli/consolidate.js

@@ -0,0 +1,146 @@
+/**
+ * `astramem-local consolidate <run|proposals|accept|reject>` — operator
+ * surface for the ADR-004 stage-9 consolidation pass.
+ *
+ *   consolidate run [--json]              trigger a pass now (also scheduled
+ *                                         at boot + every 6h by the daemon)
+ *   consolidate proposals [--json]        list pending merge proposals with
+ *                                         both texts side by side
+ *   consolidate accept <id|--all> [--json]  accept proposal(s) — merges loser
+ *                                         into winner (supersede, not delete)
+ *   consolidate reject <id> [--json]      reject a proposal
+ *
+ * Talks to the running daemon over HTTP (same env contract as search/recall):
+ * ASTRA_MEMORY_URL (default http://127.0.0.1:7777), ASTRA_MEMORY_TOKEN.
+ */
+function getBaseUrl() {
+    return process.env.ASTRA_MEMORY_URL ?? 'http://127.0.0.1:7777';
+}
+function getToken() {
+    return process.env.ASTRA_MEMORY_TOKEN ?? 'devtok';
+}
+async function api(path, init) {
+    const res = await fetch(`${getBaseUrl()}${path}`, {
+        ...init,
+        headers: {
+            'content-type': 'application/json',
+            authorization: `Bearer ${getToken()}`,
+            ...(init?.headers ?? {}),
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`HTTP ${res.status}: ${await res.text()}`);
+    }
+    return res.json();
+}
+/** Fetch memory text for side-by-side display; tolerate lifecycle races. */
+async function memoryText(id) {
+    try {
+        const m = (await api(`/memory/${id}`));
+        return m.text ?? '(no text)';
+    }
+    catch {
+        return '(unavailable — merged or erased since)';
+    }
+}
+export async function consolidateCommand(args) {
+    const [sub, ...rest] = args;
+    const jsonMode = rest.includes('--json') || args.includes('--json');
+    switch (sub) {
+        case 'run': {
+            const summary = await api('/consolidation/run', { method: 'POST', body: '{}' });
+            if (jsonMode) {
+                console.log(JSON.stringify(summary));
+            }
+            else {
+                const s = summary;
+                console.log(`Consolidation pass: ${s.groupsScanned} group(s) scanned, ${s.merged.length} auto-merged.`);
+                console.log("Review borderline pairs: astramem-local consolidate proposals");
+            }
+            break;
+        }
+        case 'proposals': {
+            const { proposals } = (await api('/consolidation/proposals?status=pending'));
+            if (jsonMode) {
+                console.log(JSON.stringify(proposals));
+                break;
+            }
+            if (proposals.length === 0) {
+                console.log('No pending consolidation proposals.');
+                break;
+            }
+            console.log(`\n${proposals.length} pending proposal(s):\n`);
+            for (const p of proposals) {
+                const [winText, loseText] = await Promise.all([memoryText(p.winner_id), memoryText(p.loser_id)]);
+                console.log(`  ${p.id}  (similarity ${p.similarity.toFixed(3)})`);
+                console.log(`    keep : ${winText.slice(0, 100)}`);
+                console.log(`    merge: ${loseText.slice(0, 100)}`);
+                console.log('');
+            }
+            console.log('Accept: astramem-local consolidate accept <id>   (or --all)');
+            console.log('Reject: astramem-local consolidate reject <id>');
+            break;
+        }
+        case 'accept': {
+            const all = rest.includes('--all');
+            let ids;
+            if (all) {
+                const { proposals } = (await api('/consolidation/proposals?status=pending'));
+                ids = proposals.map(p => p.id);
+            }
+            else {
+                const id = rest.find(a => !a.startsWith('-'));
+                if (!id) {
+                    console.error('consolidate accept: proposal id required (or --all)');
+                    process.exit(1);
+                }
+                ids = [id];
+            }
+            let accepted = 0;
+            const skipped = [];
+            for (const id of ids) {
+                try {
+                    await api(`/consolidation/proposals/${id}/accept`, { method: 'POST' });
+                    accepted++;
+                }
+                catch (err) {
+                    // 409s are expected when an atom was merged/erased since the
+                    // proposal was written — skip, don't abort the batch.
+                    skipped.push({ id, reason: err.message.split('\n')[0] ?? 'unknown' });
+                }
+            }
+            if (jsonMode) {
+                console.log(JSON.stringify({ accepted, skipped }));
+            }
+            else {
+                console.log(`Accepted ${accepted} proposal(s)${skipped.length ? `, skipped ${skipped.length} (lifecycle conflicts)` : ''}.`);
+                for (const s of skipped)
+                    console.log(`  skipped ${s.id}: ${s.reason}`);
+            }
+            break;
+        }
+        case 'reject': {
+            const id = rest.find(a => !a.startsWith('-'));
+            if (!id) {
+                console.error('consolidate reject: proposal id required');
+                process.exit(1);
+            }
+            await api(`/consolidation/proposals/${id}/reject`, { method: 'POST' });
+            console.log(jsonMode ? JSON.stringify({ rejected: id }) : `Rejected ${id}.`);
+            break;
+        }
+        default:
+            console.log(`astramem-local consolidate <subcommand>
+
+Subcommands:
+  run                       Trigger a consolidation pass now
+  proposals                 List pending merge proposals (side-by-side texts)
+  accept <id> | --all       Accept proposal(s) — supersedes loser into winner
+  reject <id>               Reject a proposal
+
+The daemon also runs a pass automatically at boot and every 6 hours.`);
+            if (sub !== undefined && sub !== '--help' && sub !== '-h')
+                process.exit(1);
+    }
+}
+//# sourceMappingURL=consolidate.js.map

package/dist/cli/consolidate.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1 @@
+export declare function doctorCommand(args: string[]): Promise<void>;

package/dist/cli/doctor.js

@@ -0,0 +1,54 @@
+import { join } from 'node:path';
+import { resolveRuntimeConfig } from '../config/resolve-runtime.js';
+import { getChecks, openProductionDbReadonly } from '../doctor/checks.js';
+import { getHardeningChecks } from '../doctor/hardening-checks.js';
+import { runChecks, formatTable, formatJson } from '../doctor/runner.js';
+function parseFlag(args, flag) {
+    return args.includes(flag);
+}
+function parseArg(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+export async function doctorCommand(args) {
+    const jsonMode = parseFlag(args, '--json');
+    const portArg = parseArg(args, '--port');
+    // Shared resolver — doctor must probe the SAME dataDir the daemon serves
+    // from (config.yaml included), not the compile-time default. Previously a
+    // non-default config.yaml dataDir made doctor probe the wrong directory,
+    // producing false "file is not a database" failures.
+    const { cfg, port, dataDir } = resolveRuntimeConfig({
+        port: portArg ? Number(portArg) : undefined,
+    });
+    const checks = [
+        ...getChecks({
+            port,
+            dataDir,
+            redactionEnabled: cfg.security.redaction.enabled,
+            encryptionEnabled: cfg.security.encryption.enabled,
+        }),
+        // W1.3: parity with `reinstall`'s assertions — stranded legacy DB,
+        // plaintext pre-encryption backup, served-vs-build version, zombie
+        // instance lock, poison-job accumulation.
+        ...getHardeningChecks({
+            dataDir,
+            port,
+            openDbReadonly: () => openProductionDbReadonly(join(dataDir, 'memory.sqlite'), cfg.security.encryption.enabled),
+        }),
+    ];
+    const results = await runChecks(checks);
+    if (jsonMode) {
+        console.log(formatJson(results));
+    }
+    else {
+        console.log('\nAstraMemory Doctor\n');
+        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=doctor.js.map

package/dist/cli/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEzE,SAAS,SAAS,CAAC,IAAc,EAAE,IAAY;IAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAc,EAAE,IAAY;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEzC,yEAAyE;IACzE,0EAA0E;IAC1E,yEAAyE;IACzE,qDAAqD;IACrD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,oBAAoB,CAAC;QAClD,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5C,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG;QACb,GAAG,SAAS,CAAC;YACX,IAAI;YACJ,OAAO;YACP,gBAAgB,EAAE,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO;YAChD,iBAAiB,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO;SACnD,CAAC;QACF,mEAAmE;QACnE,mEAAmE;QACnE,0CAA0C;QAC1C,GAAG,kBAAkB,CAAC;YACpB,OAAO;YACP,IAAI;YACJ,cAAc,EAAE,GAAG,EAAE,CACnB,wBAAwB,CAAC,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;SAC5F,CAAC;KACH,CAAC;IACF,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC;IAExC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC;QACtC,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/entity-backfill.d.ts

@@ -0,0 +1,10 @@
+/**
+ * `astramem-local entity-backfill [--dry-run] [--limit N] [--json]`
+ *
+ * FEAT-402 (W4.2) AC-7 — one-shot entity extraction + linking backfill for
+ * memories that predate distill-time entity extraction (migration 012).
+ * Extracts entities from existing memory text via the extraction LLM
+ * provider and links them; never re-distills or mutates memory text. See
+ * src/entity/backfill.ts for the core (DB-only, testable) logic.
+ */
+export declare function entityBackfillCommand(args: string[]): Promise<void>;

package/dist/cli/entity-backfill.js

@@ -0,0 +1,46 @@
+/**
+ * `astramem-local entity-backfill [--dry-run] [--limit N] [--json]`
+ *
+ * FEAT-402 (W4.2) AC-7 — one-shot entity extraction + linking backfill for
+ * memories that predate distill-time entity extraction (migration 012).
+ * Extracts entities from existing memory text via the extraction LLM
+ * provider and links them; never re-distills or mutates memory text. See
+ * src/entity/backfill.ts for the core (DB-only, testable) logic.
+ */
+import { openRuntimeDb } from './open-runtime-db.js';
+import { getProviders } from '../providers/index.js';
+import { runEntityBackfill } from '../entity/backfill.js';
+function parseArg(args, flag) {
+    const i = args.indexOf(flag);
+    return i >= 0 ? args[i + 1] : undefined;
+}
+export async function entityBackfillCommand(args) {
+    const jsonMode = args.includes('--json');
+    const dryRun = args.includes('--dry-run');
+    const limitArg = parseArg(args, '--limit');
+    const limit = limitArg ? Math.max(1, Number(limitArg)) : undefined;
+    const { db, cfg } = openRuntimeDb();
+    const provider = getProviders(cfg).llm.extraction;
+    const result = await runEntityBackfill(db, provider, {
+        dryRun,
+        limit,
+        capUsd: cfg.budget.daily_usd,
+    });
+    db.close();
+    if (jsonMode) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log('');
+    console.log('  AstraMemory Entity Backfill');
+    console.log('  ───────────────────────────');
+    console.log(`  Scanned: ${result.scanned}`);
+    console.log(`  Memories linked: ${result.linked}`);
+    console.log(`  Entity links created: ${result.entitiesLinked}`);
+    console.log(`  Skipped (no entities found): ${result.skipped}`);
+    if (dryRun) {
+        console.log('  --dry-run: no rows were mutated.');
+    }
+    console.log('');
+}
+//# sourceMappingURL=entity-backfill.js.map

package/dist/cli/entity-backfill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-backfill.js","sourceRoot":"","sources":["../../src/cli/entity-backfill.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAA6B,MAAM,uBAAuB,CAAC;AAErF,SAAS,QAAQ,CAAC,IAAc,EAAE,IAAY;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAAc;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,aAAa,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC;IAElD,MAAM,MAAM,GAAyB,MAAM,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE;QACzE,MAAM;QACN,KAAK;QACL,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS;KAC7B,CAAC,CAAC;IAEH,EAAE,CAAC,KAAK,EAAE,CAAC;IAEX,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,2BAA2B,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,kCAAkC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAChE,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC"}

package/dist/cli/hook-install.d.ts

@@ -0,0 +1,45 @@
+/**
+ * hook-install.ts — SessionStart memory-pack hook auto-install.
+ *
+ * Deferred from KF-B (docs/hooks/memory-pack.md shipped the manual-install
+ * recipe; this wires it into `astramem-local init`). Installs the
+ * platform-appropriate one-liner into the user's global Claude Code settings
+ * (`~/.claude/settings.json` by default, injectable via `settingsPath` for
+ * tests and callers that target a project-local settings file instead).
+ *
+ * Read-modify-write: parses existing JSON, appends one SessionStart hook
+ * block, and writes the whole object back — every other key (and every other
+ * hook) survives untouched. Idempotent: detects an already-installed
+ * astramem hook by the `/recall/pack` marker substring in any existing
+ * SessionStart command and skips re-inserting it.
+ */
+/** Marker substring used to detect an already-installed astramem hook (idempotency). */
+export declare const HOOK_MARKER = "/recall/pack";
+/** Default target: `~/.claude/settings.json` (global, matches docs/hooks/memory-pack.md). */
+export declare function defaultSettingsPath(): string;
+/**
+ * Build the platform-appropriate SessionStart hook one-liner from
+ * docs/hooks/memory-pack.md, with the daemon port filled in.
+ *
+ * Uses `MEMORY_BEARER` (the env var `astramem-local init` actually persists
+ * to the user's shell — see src/config/persist-envs.ts and the `.mcp.json`
+ * wiring in README.md), not the doc's original `ASTRAMEM_TOKEN` placeholder.
+ */
+export declare function buildHookCommand(port: number): string;
+export interface InstallHookOptions {
+    /** Daemon port to bake into the hook URL. */
+    port: number;
+    /** Injectable target path — defaults to defaultSettingsPath(). */
+    settingsPath?: string;
+}
+export type InstallHookOutcome = 'installed' | 'already-installed';
+export interface InstallHookResult {
+    outcome: InstallHookOutcome;
+    settingsPath: string;
+}
+/**
+ * Install the SessionStart memory-pack hook into `opts.settingsPath`
+ * (default `~/.claude/settings.json`). Preserves all existing content;
+ * idempotent against repeated calls.
+ */
+export declare function installMemoryPackHook(opts: InstallHookOptions): InstallHookResult;

package/dist/cli/hook-install.js

@@ -0,0 +1,77 @@
+/**
+ * hook-install.ts — SessionStart memory-pack hook auto-install.
+ *
+ * Deferred from KF-B (docs/hooks/memory-pack.md shipped the manual-install
+ * recipe; this wires it into `astramem-local init`). Installs the
+ * platform-appropriate one-liner into the user's global Claude Code settings
+ * (`~/.claude/settings.json` by default, injectable via `settingsPath` for
+ * tests and callers that target a project-local settings file instead).
+ *
+ * Read-modify-write: parses existing JSON, appends one SessionStart hook
+ * block, and writes the whole object back — every other key (and every other
+ * hook) survives untouched. Idempotent: detects an already-installed
+ * astramem hook by the `/recall/pack` marker substring in any existing
+ * SessionStart command and skips re-inserting it.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { homedir, platform } from 'node:os';
+/** Marker substring used to detect an already-installed astramem hook (idempotency). */
+export const HOOK_MARKER = '/recall/pack';
+/** Default target: `~/.claude/settings.json` (global, matches docs/hooks/memory-pack.md). */
+export function defaultSettingsPath() {
+    return join(homedir(), '.claude', 'settings.json');
+}
+/**
+ * Build the platform-appropriate SessionStart hook one-liner from
+ * docs/hooks/memory-pack.md, with the daemon port filled in.
+ *
+ * Uses `MEMORY_BEARER` (the env var `astramem-local init` actually persists
+ * to the user's shell — see src/config/persist-envs.ts and the `.mcp.json`
+ * wiring in README.md), not the doc's original `ASTRAMEM_TOKEN` placeholder.
+ */
+export function buildHookCommand(port) {
+    const url = `http://127.0.0.1:${port}/recall/pack`;
+    if (platform() === 'win32') {
+        return (`powershell -NoProfile -Command "try { $r = Invoke-RestMethod -Method Post -Uri ${url} ` +
+            `-Headers @{Authorization=\\"Bearer $env:MEMORY_BEARER\\"} -ContentType application/json ` +
+            `-Body (@{repo=(Split-Path -Leaf (Get-Location))} | ConvertTo-Json) -TimeoutSec 2; ` +
+            `if ($r.pack) { $r.pack } } catch {}"`);
+    }
+    return (`curl -s -m 2 -X POST ${url} -H "Authorization: Bearer $MEMORY_BEARER" ` +
+        `-H "Content-Type: application/json" -d "{\\"repo\\": \\"$(basename \\"$PWD\\")\\"}" | ` +
+        `node -e "let d='';process.stdin.on('data',c=>d+=c).on('end',()=>{try{const p=JSON.parse(d).pack;if(p)console.log(p)}catch{}})"`);
+}
+/**
+ * Install the SessionStart memory-pack hook into `opts.settingsPath`
+ * (default `~/.claude/settings.json`). Preserves all existing content;
+ * idempotent against repeated calls.
+ */
+export function installMemoryPackHook(opts) {
+    const settingsPath = opts.settingsPath ?? defaultSettingsPath();
+    let settings = {};
+    if (existsSync(settingsPath)) {
+        const raw = readFileSync(settingsPath, 'utf8');
+        try {
+            settings = raw.trim() === '' ? {} : JSON.parse(raw);
+        }
+        catch {
+            throw new Error(`hook-install: ${settingsPath} contains invalid JSON — fix or remove it before retrying`);
+        }
+    }
+    const hooks = settings.hooks ?? {};
+    const sessionStart = hooks.SessionStart ?? [];
+    const alreadyInstalled = sessionStart.some((block) => (block.hooks ?? []).some((h) => typeof h.command === 'string' && h.command.includes(HOOK_MARKER)));
+    if (alreadyInstalled) {
+        return { outcome: 'already-installed', settingsPath };
+    }
+    sessionStart.push({
+        hooks: [{ type: 'command', command: buildHookCommand(opts.port), timeout: 3 }],
+    });
+    hooks.SessionStart = sessionStart;
+    settings.hooks = hooks;
+    mkdirSync(dirname(settingsPath), { recursive: true });
+    writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n', 'utf8');
+    return { outcome: 'installed', settingsPath };
+}
+//# sourceMappingURL=hook-install.js.map

package/dist/cli/hook-install.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};