akm-cli 0.7.0 → 0.7.2

package/dist/tests/utility-scoring.test.js

@@ -1,558 +0,0 @@
-/**
- * Tests for M-2: Utility-Based Re-ranking (MemRL Pattern).
- *
- * Validates utility_scores table creation, upsert/read helpers,
- * utility boost in search scoring, recency decay, cap at 1.5x,
- * recomputeUtilityScores aggregation, and whyMatched reporting.
- */
-import { afterAll, afterEach, beforeEach, describe, expect, test } from "bun:test";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-import { akmSearch } from "../src/commands/search";
-import { saveConfig } from "../src/core/config";
-import { getDbPath } from "../src/core/paths";
-import { closeDatabase, getUtilityScore, openDatabase, upsertUtilityScore } from "../src/indexer/db";
-import { akmIndex, recomputeUtilityScores } from "../src/indexer/indexer";
-import { recordUsageEvent } from "./helpers/usage-events";
-// ── Temp directory tracking ─────────────────────────────────────────────────
-const createdTmpDirs = [];
-function createTmpDir(prefix = "akm-utility-") {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-    createdTmpDirs.push(dir);
-    return dir;
-}
-afterAll(() => {
-    for (const dir of createdTmpDirs) {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-});
-// ── Helpers ─────────────────────────────────────────────────────────────────
-function writeFile(filePath, content = "") {
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    fs.writeFileSync(filePath, content);
-}
-function tmpStash() {
-    const dir = createTmpDir("akm-utility-stash-");
-    for (const sub of ["skills", "commands", "agents", "knowledge", "scripts"]) {
-        fs.mkdirSync(path.join(dir, sub), { recursive: true });
-    }
-    return dir;
-}
-async function buildTestIndex(stashDir, files = {}) {
-    for (const [relPath, content] of Object.entries(files)) {
-        const fullPath = path.join(stashDir, relPath);
-        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
-        fs.writeFileSync(fullPath, content);
-    }
-    process.env.AKM_STASH_DIR = stashDir;
-    saveConfig({ semanticSearchMode: "off" });
-    await akmIndex({ stashDir, full: true });
-}
-function expectDefined(value) {
-    expect(value).toBeDefined();
-    if (value === undefined || value === null) {
-        throw new Error("Expected value to be defined");
-    }
-    return value;
-}
-// ── Environment isolation ───────────────────────────────────────────────────
-const originalXdgCacheHome = process.env.XDG_CACHE_HOME;
-const originalXdgConfigHome = process.env.XDG_CONFIG_HOME;
-const originalAkmStashDir = process.env.AKM_STASH_DIR;
-let testCacheDir = "";
-let testConfigDir = "";
-beforeEach(() => {
-    testCacheDir = createTmpDir("akm-utility-cache-");
-    testConfigDir = createTmpDir("akm-utility-config-");
-    process.env.XDG_CACHE_HOME = testCacheDir;
-    process.env.XDG_CONFIG_HOME = testConfigDir;
-});
-afterEach(() => {
-    if (originalXdgCacheHome === undefined) {
-        delete process.env.XDG_CACHE_HOME;
-    }
-    else {
-        process.env.XDG_CACHE_HOME = originalXdgCacheHome;
-    }
-    if (originalXdgConfigHome === undefined) {
-        delete process.env.XDG_CONFIG_HOME;
-    }
-    else {
-        process.env.XDG_CONFIG_HOME = originalXdgConfigHome;
-    }
-    if (originalAkmStashDir === undefined) {
-        delete process.env.AKM_STASH_DIR;
-    }
-    else {
-        process.env.AKM_STASH_DIR = originalAkmStashDir;
-    }
-    if (testCacheDir) {
-        fs.rmSync(testCacheDir, { recursive: true, force: true });
-        testCacheDir = "";
-    }
-    if (testConfigDir) {
-        fs.rmSync(testConfigDir, { recursive: true, force: true });
-        testConfigDir = "";
-    }
-});
-// ── Test 1: utility_scores table is created by ensureSchema ─────────────────
-describe("utility_scores table creation", () => {
-    test("ensureSchema creates utility_scores table", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            const row = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='utility_scores'").get();
-            expect(row).toBeDefined();
-            expect(row?.name).toBe("utility_scores");
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-    test("utility_scores table has expected columns", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            const columns = db.prepare("PRAGMA table_info(utility_scores)").all();
-            const columnNames = columns.map((c) => c.name);
-            expect(columnNames).toContain("entry_id");
-            expect(columnNames).toContain("utility");
-            expect(columnNames).toContain("show_count");
-            expect(columnNames).toContain("search_count");
-            expect(columnNames).toContain("select_rate");
-            expect(columnNames).toContain("last_used_at");
-            expect(columnNames).toContain("updated_at");
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-});
-// ── Test 2: upsertUtilityScore writes and reads correctly ────────────────────
-describe("upsertUtilityScore / getUtilityScore", () => {
-    test("upsertUtilityScore writes and getUtilityScore reads correctly", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            // Insert a dummy entry first (utility_scores references entries)
-            db.prepare("INSERT INTO entries (entry_key, dir_path, file_path, stash_dir, entry_json, search_text, entry_type) VALUES (?, ?, ?, ?, ?, ?, ?)").run("test:script:foo", "/tmp", "/tmp/foo.sh", "/tmp", '{"name":"foo","type":"script"}', "foo script", "script");
-            const entryRow = db.prepare("SELECT id FROM entries WHERE entry_key = ?").get("test:script:foo");
-            const entryId = entryRow.id;
-            upsertUtilityScore(db, entryId, {
-                utility: 0.75,
-                showCount: 10,
-                searchCount: 20,
-                selectRate: 0.5,
-                lastUsedAt: "2026-03-17T00:00:00Z",
-            });
-            const score = getUtilityScore(db, entryId);
-            expect(score).toBeDefined();
-            expect(score?.utility).toBe(0.75);
-            expect(score?.showCount).toBe(10);
-            expect(score?.searchCount).toBe(20);
-            expect(score?.selectRate).toBe(0.5);
-            expect(score?.lastUsedAt).toBe("2026-03-17T00:00:00Z");
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-    test("upsertUtilityScore updates existing row", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            db.prepare("INSERT INTO entries (entry_key, dir_path, file_path, stash_dir, entry_json, search_text, entry_type) VALUES (?, ?, ?, ?, ?, ?, ?)").run("test:script:bar", "/tmp", "/tmp/bar.sh", "/tmp", '{"name":"bar","type":"script"}', "bar script", "script");
-            const entryRow = db.prepare("SELECT id FROM entries WHERE entry_key = ?").get("test:script:bar");
-            const entryId = entryRow.id;
-            upsertUtilityScore(db, entryId, {
-                utility: 0.5,
-                showCount: 5,
-                searchCount: 10,
-                selectRate: 0.5,
-                lastUsedAt: "2026-03-15T00:00:00Z",
-            });
-            upsertUtilityScore(db, entryId, {
-                utility: 0.9,
-                showCount: 15,
-                searchCount: 30,
-                selectRate: 0.5,
-                lastUsedAt: "2026-03-17T00:00:00Z",
-            });
-            const score = getUtilityScore(db, entryId);
-            expect(score?.utility).toBe(0.9);
-            expect(score?.showCount).toBe(15);
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-    test("getUtilityScore returns undefined for missing entry", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            const score = getUtilityScore(db, 99999);
-            expect(score).toBeUndefined();
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-});
-// ── Test 3: Entries with usage data get utility boost in search ───────────────
-describe("Utility boost in search scoring", () => {
-    test("entries with usage data get utility boost in search", async () => {
-        const stashDir = tmpStash();
-        // Create two entries with identical FTS content
-        writeFile(path.join(stashDir, "scripts", "boosted-tool", "boosted-tool.sh"), "#!/bin/bash\necho boosted\n");
-        writeFile(path.join(stashDir, "scripts", "boosted-tool", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "boosted-tool",
-                    type: "script",
-                    description: "A deployment automation utility for servers",
-                    filename: "boosted-tool.sh",
-                },
-            ],
-        }));
-        writeFile(path.join(stashDir, "scripts", "plain-tool", "plain-tool.sh"), "#!/bin/bash\necho plain\n");
-        writeFile(path.join(stashDir, "scripts", "plain-tool", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "plain-tool",
-                    type: "script",
-                    description: "A deployment automation utility for servers",
-                    filename: "plain-tool.sh",
-                },
-            ],
-        }));
-        await buildTestIndex(stashDir, {});
-        // Now inject utility score for the boosted entry
-        const dbPath = getDbPath();
-        const db = openDatabase(dbPath);
-        try {
-            const boostedEntry = db.prepare("SELECT id FROM entries WHERE entry_key LIKE '%boosted-tool%'").get();
-            if (boostedEntry) {
-                upsertUtilityScore(db, boostedEntry.id, {
-                    utility: 0.8,
-                    showCount: 20,
-                    searchCount: 25,
-                    selectRate: 0.8,
-                    lastUsedAt: new Date().toISOString(),
-                });
-            }
-        }
-        finally {
-            closeDatabase(db);
-        }
-        const result = await akmSearch({ query: "deployment automation", source: "local" });
-        const localHits = result.hits.filter((h) => h.type !== "registry");
-        const boostedHit = localHits.find((h) => h.name === "boosted-tool");
-        const plainHit = localHits.find((h) => h.name === "plain-tool");
-        const resolvedBoosted = expectDefined(boostedHit);
-        const resolvedPlain = expectDefined(plainHit);
-        // The boosted entry should rank ahead of the plain one due to utility
-        // boost. Per CLAUDE.md / spec §9, displayed scores are clamped to [0,1];
-        // both hits may clamp to the ceiling on a strong-match query, so the
-        // observable contract is rank order, not raw score magnitude. The
-        // boosted score must still be at least as high as the plain one.
-        const boostedIdx = localHits.indexOf(resolvedBoosted);
-        const plainIdx = localHits.indexOf(resolvedPlain);
-        expect(boostedIdx).toBeLessThan(plainIdx);
-        expect(resolvedBoosted.score ?? 0).toBeGreaterThanOrEqual(resolvedPlain.score ?? 0);
-    });
-});
-// ── Test 4: Entries without usage data get no utility boost ──────────────────
-describe("No utility boost for entries without usage data", () => {
-    test("entries without usage data get no utility boost (score unchanged)", async () => {
-        const stashDir = tmpStash();
-        writeFile(path.join(stashDir, "scripts", "no-usage", "no-usage.sh"), "#!/bin/bash\necho no usage\n");
-        writeFile(path.join(stashDir, "scripts", "no-usage", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "no-usage",
-                    type: "script",
-                    description: "A simple test tool with no usage history",
-                    filename: "no-usage.sh",
-                },
-            ],
-        }));
-        await buildTestIndex(stashDir, {});
-        const result = await akmSearch({ query: "simple test tool", source: "local" });
-        const localHits = result.hits.filter((h) => h.type !== "registry");
-        const hit = localHits.find((h) => h.name === "no-usage");
-        const resolved = expectDefined(hit);
-        // No utility data means no utilityBoost in whyMatched
-        expect(resolved.whyMatched).toBeDefined();
-        expect(resolved.whyMatched).not.toContain("usage history boost");
-    });
-});
-// ── Test 5: Utility boost is capped at 1.5x ─────────────────────────────────
-describe("Utility boost cap", () => {
-    test("utility boost is capped at 1.5x", async () => {
-        const stashDir = tmpStash();
-        writeFile(path.join(stashDir, "scripts", "capped-a", "capped-a.sh"), "#!/bin/bash\necho capped\n");
-        writeFile(path.join(stashDir, "scripts", "capped-a", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "capped-a",
-                    type: "script",
-                    description: "A network monitoring tool for production",
-                    filename: "capped-a.sh",
-                },
-            ],
-        }));
-        writeFile(path.join(stashDir, "scripts", "capped-b", "capped-b.sh"), "#!/bin/bash\necho baseline\n");
-        writeFile(path.join(stashDir, "scripts", "capped-b", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "capped-b",
-                    type: "script",
-                    description: "A network monitoring tool for production",
-                    filename: "capped-b.sh",
-                },
-            ],
-        }));
-        await buildTestIndex(stashDir, {});
-        // Inject an extremely high utility score for capped-a
-        const dbPath = getDbPath();
-        const db = openDatabase(dbPath);
-        try {
-            const cappedEntry = db.prepare("SELECT id FROM entries WHERE entry_key LIKE '%capped-a%'").get();
-            if (cappedEntry) {
-                upsertUtilityScore(db, cappedEntry.id, {
-                    utility: 10.0, // Extremely high utility
-                    showCount: 1000,
-                    searchCount: 1000,
-                    selectRate: 1.0,
-                    lastUsedAt: new Date().toISOString(),
-                });
-            }
-        }
-        finally {
-            closeDatabase(db);
-        }
-        const result = await akmSearch({ query: "network monitoring", source: "local" });
-        const localHits = result.hits.filter((h) => h.type !== "registry");
-        const cappedHit = localHits.find((h) => h.name === "capped-a");
-        const baselineHit = localHits.find((h) => h.name === "capped-b");
-        const resolvedCapped = expectDefined(cappedHit);
-        const resolvedBaseline = expectDefined(baselineHit);
-        // The ratio between boosted and baseline should be at most 1.5x
-        // (the cap). Allow a tiny tolerance for floating point + other small boosts.
-        const ratio = expectDefined(resolvedCapped.score) / expectDefined(resolvedBaseline.score);
-        expect(ratio).toBeLessThanOrEqual(1.55); // small tolerance for name boost differences
-    });
-});
-// ── Test 6: Recency decay reduces boost for old usage ────────────────────────
-describe("Recency decay on utility boost", () => {
-    test("recent usage produces higher boost than old usage", async () => {
-        const stashDir = tmpStash();
-        writeFile(path.join(stashDir, "scripts", "recent-use", "recent-use.sh"), "#!/bin/bash\necho recent\n");
-        writeFile(path.join(stashDir, "scripts", "recent-use", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "recent-use",
-                    type: "script",
-                    description: "A data processing pipeline tool for analytics",
-                    filename: "recent-use.sh",
-                },
-            ],
-        }));
-        writeFile(path.join(stashDir, "scripts", "old-use", "old-use.sh"), "#!/bin/bash\necho old\n");
-        writeFile(path.join(stashDir, "scripts", "old-use", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "old-use",
-                    type: "script",
-                    description: "A data processing pipeline tool for analytics",
-                    filename: "old-use.sh",
-                },
-            ],
-        }));
-        await buildTestIndex(stashDir, {});
-        const dbPath = getDbPath();
-        const db = openDatabase(dbPath);
-        try {
-            const recentEntry = db.prepare("SELECT id FROM entries WHERE entry_key LIKE '%recent-use%'").get();
-            const oldEntry = db.prepare("SELECT id FROM entries WHERE entry_key LIKE '%old-use%'").get();
-            if (recentEntry) {
-                upsertUtilityScore(db, recentEntry.id, {
-                    utility: 0.8,
-                    showCount: 20,
-                    searchCount: 25,
-                    selectRate: 0.8,
-                    lastUsedAt: new Date().toISOString(), // Just now
-                });
-            }
-            if (oldEntry) {
-                // Same utility score but last used 90 days ago
-                const oldDate = new Date();
-                oldDate.setDate(oldDate.getDate() - 90);
-                upsertUtilityScore(db, oldEntry.id, {
-                    utility: 0.8,
-                    showCount: 20,
-                    searchCount: 25,
-                    selectRate: 0.8,
-                    lastUsedAt: oldDate.toISOString(),
-                });
-            }
-        }
-        finally {
-            closeDatabase(db);
-        }
-        const result = await akmSearch({ query: "data processing pipeline", source: "local" });
-        const localHits = result.hits.filter((h) => h.type !== "registry");
-        const recentHit = localHits.find((h) => h.name === "recent-use");
-        const oldHit = localHits.find((h) => h.name === "old-use");
-        const resolvedRecent = expectDefined(recentHit);
-        const resolvedOld = expectDefined(oldHit);
-        // Recent usage should rank ahead of old usage. Per CLAUDE.md / spec §9
-        // the displayed score is clamped to [0,1]; on a strong-match query both
-        // hits may clamp to the ceiling, so rank ordering is the observable
-        // contract for the recency signal.
-        const recentIdx = localHits.indexOf(resolvedRecent);
-        const oldIdx = localHits.indexOf(resolvedOld);
-        expect(recentIdx).toBeLessThan(oldIdx);
-        expect(resolvedRecent.score ?? 0).toBeGreaterThanOrEqual(resolvedOld.score ?? 0);
-    });
-});
-// ── Test 7: recomputeUtilityScores aggregates from usage_events ──────────────
-describe("recomputeUtilityScores", () => {
-    test("aggregates search and show events from usage_events", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            // Insert a test entry
-            db.prepare("INSERT INTO entries (entry_key, dir_path, file_path, stash_dir, entry_json, search_text, entry_type) VALUES (?, ?, ?, ?, ?, ?, ?)").run("test:script:recompute-test", "/tmp", "/tmp/recompute.sh", "/tmp", '{"name":"recompute-test","type":"script"}', "recompute test script", "script");
-            const entryRow = db.prepare("SELECT id FROM entries WHERE entry_key = ?").get("test:script:recompute-test");
-            const entryId = entryRow.id;
-            // Record usage events: 5 searches that returned this entry, 3 shows
-            for (let i = 0; i < 5; i++) {
-                recordUsageEvent(db, {
-                    eventType: "search",
-                    entryId,
-                    timestamp: new Date().toISOString(),
-                });
-            }
-            for (let i = 0; i < 3; i++) {
-                recordUsageEvent(db, {
-                    eventType: "show",
-                    entryId,
-                    timestamp: new Date().toISOString(),
-                });
-            }
-            // Recompute utility scores
-            recomputeUtilityScores(db);
-            // Check that utility scores were computed
-            const score = getUtilityScore(db, entryId);
-            expect(score).toBeDefined();
-            expect(score?.searchCount).toBe(5);
-            expect(score?.showCount).toBe(3);
-            expect(score?.selectRate).toBeCloseTo(3 / 5, 2);
-            expect(score?.utility).toBeGreaterThan(0);
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-    test("entries with no usage events get zero utility", () => {
-        const dbPath = path.join(createTmpDir("akm-util-db-"), "test.db");
-        const db = openDatabase(dbPath);
-        try {
-            // Insert a test entry with no usage events
-            db.prepare("INSERT INTO entries (entry_key, dir_path, file_path, stash_dir, entry_json, search_text, entry_type) VALUES (?, ?, ?, ?, ?, ?, ?)").run("test:script:no-usage-test", "/tmp", "/tmp/no-usage.sh", "/tmp", '{"name":"no-usage-test","type":"script"}', "no usage test script", "script");
-            recomputeUtilityScores(db);
-            const entryRow = db.prepare("SELECT id FROM entries WHERE entry_key = ?").get("test:script:no-usage-test");
-            const score = getUtilityScore(db, entryRow.id);
-            // Either undefined or zero utility
-            if (score) {
-                expect(score.utility).toBe(0);
-            }
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-});
-// ── Test 8: whyMatched includes usage history boost when applicable ──────────
-describe("whyMatched includes usage history boost", () => {
-    test("whyMatched includes usage history boost when utility > 0", async () => {
-        const stashDir = tmpStash();
-        writeFile(path.join(stashDir, "scripts", "why-util", "why-util.sh"), "#!/bin/bash\necho why utility\n");
-        writeFile(path.join(stashDir, "scripts", "why-util", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "why-util",
-                    type: "script",
-                    description: "A logging infrastructure tool for debugging",
-                    filename: "why-util.sh",
-                },
-            ],
-        }));
-        await buildTestIndex(stashDir, {});
-        // Inject utility score
-        const dbPath = getDbPath();
-        const db = openDatabase(dbPath);
-        try {
-            const entry = db.prepare("SELECT id FROM entries WHERE entry_key LIKE '%why-util%'").get();
-            if (entry) {
-                upsertUtilityScore(db, entry.id, {
-                    utility: 0.6,
-                    showCount: 10,
-                    searchCount: 15,
-                    selectRate: 0.67,
-                    lastUsedAt: new Date().toISOString(),
-                });
-            }
-        }
-        finally {
-            closeDatabase(db);
-        }
-        const result = await akmSearch({ query: "logging infrastructure", source: "local" });
-        const localHits = result.hits.filter((h) => h.type !== "registry");
-        const hit = localHits.find((h) => h.name === "why-util");
-        const resolved = expectDefined(hit);
-        expect(resolved.whyMatched).toBeDefined();
-        expect(resolved.whyMatched).toContain("usage history boost");
-    });
-});
-// ── Test 9: Production path end-to-end ───────────────────────────────────────
-describe("Production path end-to-end", () => {
-    test("index → search → usage_events have entry_id → recompute populates utility_scores", async () => {
-        const stashDir = tmpStash();
-        writeFile(path.join(stashDir, "scripts", "e2e-tool", "e2e-tool.sh"), "#!/bin/bash\necho e2e\n");
-        writeFile(path.join(stashDir, "scripts", "e2e-tool", ".stash.json"), JSON.stringify({
-            entries: [
-                {
-                    name: "e2e-tool",
-                    type: "script",
-                    description: "An end-to-end test tool for production validation",
-                    filename: "e2e-tool.sh",
-                },
-            ],
-        }));
-        await buildTestIndex(stashDir, {});
-        // Search to trigger usage event logging
-        const result = await akmSearch({ query: "end-to-end test", source: "local" });
-        const localHits = result.hits.filter((h) => h.type !== "registry");
-        expect(localHits.length).toBeGreaterThan(0);
-        // Verify usage_events have entry_id
-        const dbPath = getDbPath();
-        const db = openDatabase(dbPath);
-        try {
-            const events = db
-                .prepare("SELECT entry_id FROM usage_events WHERE event_type = 'search' AND entry_id IS NOT NULL")
-                .all();
-            expect(events.length).toBeGreaterThan(0);
-            // Recompute utility scores
-            recomputeUtilityScores(db);
-            // Verify utility_scores populated
-            const scores = db.prepare("SELECT entry_id, utility FROM utility_scores").all();
-            expect(scores.length).toBeGreaterThan(0);
-        }
-        finally {
-            closeDatabase(db);
-        }
-    });
-});

package/dist/tests/vault-load-error.test.js

@@ -1,78 +0,0 @@
-import { afterAll, describe, expect, test } from "bun:test";
-import { spawnSync } from "node:child_process";
-import fs from "node:fs";
-import os from "node:os";
-import path from "node:path";
-// ── Helpers ──────────────────────────────────────────────────────────────────
-const tempDirs = [];
-function makeTempDir(prefix = "akm-vault-load-") {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), prefix));
-    tempDirs.push(dir);
-    return dir;
-}
-afterAll(() => {
-    for (const dir of tempDirs) {
-        fs.rmSync(dir, { recursive: true, force: true });
-    }
-});
-const xdgCache = makeTempDir("akm-vle-cache-");
-const xdgConfig = makeTempDir("akm-vle-config-");
-const isolatedHome = makeTempDir("akm-vle-home-");
-const repoRoot = path.resolve(import.meta.dir, "..");
-const cliPath = path.join(repoRoot, "src", "cli.ts");
-function runCli(args, extraEnv = {}) {
-    const result = spawnSync("bun", [cliPath, ...args], {
-        encoding: "utf8",
-        timeout: 15_000,
-        cwd: repoRoot,
-        env: {
-            ...process.env,
-            HOME: isolatedHome,
-            XDG_CACHE_HOME: xdgCache,
-            XDG_CONFIG_HOME: xdgConfig,
-            AKM_STASH_DIR: undefined,
-            ...extraEnv,
-        },
-    });
-    return {
-        stdout: result.stdout ?? "",
-        stderr: result.stderr ?? "",
-        status: result.status ?? 1,
-    };
-}
-// ── Tests ─────────────────────────────────────────────────────────────────────
-describe("vault load: error envelope", () => {
-    test("returns {ok:false, error} JSON on stderr and exits 1 when vault does not exist", () => {
-        const stashDir = makeTempDir("akm-vle-stash-");
-        // Create the vaults sub-directory so akm resolves paths but the specific
-        // vault file is absent.
-        fs.mkdirSync(path.join(stashDir, "vaults"), { recursive: true });
-        const { stdout, stderr, status } = runCli(["vault", "load", "vault:does-not-exist"], {
-            AKM_STASH_DIR: stashDir,
-        });
-        // Must exit with code 1 (NotFoundError → EXIT_GENERAL).
-        expect(status).toBe(1);
-        // The JSON error envelope must appear on stderr (runWithJsonErrors writes
-        // to console.error).
-        const parsed = JSON.parse(stderr.trim());
-        expect(parsed.ok).toBe(false);
-        expect(typeof parsed.error).toBe("string");
-        expect(parsed.error).toContain("Vault not found");
-        // stdout must be empty — no shell snippet should leak on error.
-        expect(stdout.trim()).toBe("");
-    });
-    test("emits a shell snippet on stdout (not JSON) when the vault exists", () => {
-        const stashDir = makeTempDir("akm-vle-stash-ok-");
-        fs.mkdirSync(path.join(stashDir, "vaults"), { recursive: true });
-        fs.writeFileSync(path.join(stashDir, "vaults", "myvault.env"), "FOO=bar\n", "utf8");
-        const { stdout, stderr, status } = runCli(["vault", "load", "vault:myvault"], {
-            AKM_STASH_DIR: stashDir,
-        });
-        // Success path: exit 0 and a sourcing shell snippet on stdout.
-        expect(status).toBe(0);
-        expect(stdout).toContain(". ");
-        expect(stdout).toContain("rm -f");
-        // No error envelope on stderr.
-        expect(stderr.trim()).toBe("");
-    });
-});