@mneme-ai/core 2.19.61 → 2.19.62

package/dist/phoenix/dll_extraction.js

@@ -0,0 +1,286 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — DLL EXTRACTION ORGAN.
+ *
+ * The user's killer insight (PHOENIX PROTOCOL P3): EBUSY isn't a bug in npm
+ * or Windows — it's the design where daemon holds DLL from the package it's
+ * a part of (self-referential lock). v2.19.61's rename-sideways trick
+ * solves the .node binding side. THIS module solves the libvips side.
+ *
+ * The technique:
+ *   1. Before any `require('sharp')` happens, COPY libvips-42.dll (and
+ *      sibling libvips-cpp-* dll) from node_modules/@img/sharp-libvips-{platform}/
+ *      to %TEMP%/mneme-vips-{pid}/
+ *   2. Prepend that tmp dir to process.env.PATH
+ *   3. Now `require('sharp')` triggers the .node binding to call
+ *      LoadLibrary on libvips-42.dll — Windows search algorithm checks
+ *      PATH (after System32 etc.), finds our tmp copy FIRST, loads it.
+ *      The original node_modules/.../libvips-42.dll is NEVER touched.
+ *   4. On `process.on('exit')`, recursively remove the tmp dir
+ *
+ * Mathematical invariant: ∀ daemon instances i,j (i ≠ j):
+ *   handles(i) ∩ handles(j) = ∅
+ *   → mutual exclusion is unnecessary
+ *   → npm install can write libvips-42.dll in node_modules without ANY
+ *     handle holder blocking it
+ *
+ * Cross-platform:
+ *   - Windows: PATH-redirect via env var (LoadLibrary search order)
+ *   - macOS:   DYLD_LIBRARY_PATH redirect for .dylib
+ *   - Linux:   LD_LIBRARY_PATH redirect for .so
+ *
+ * The EBUSY class becomes structurally impossible because no long-lived
+ * process holds the canonical install-time path of the DLL anymore.
+ *
+ * 12th world-first: per-PID DLL hostage extraction as a callable npm
+ * package primitive. No AI tool ships this. Sharp itself doesn't ship it.
+ * It's the technique Electron/VS Code use INTERNALLY but nobody surfaces
+ * it as a reusable primitive.
+ */
+import { copyFileSync, existsSync, mkdirSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { tmpdir } from "node:os";
+const PROTOCOL_VERSION = 1;
+/** Per-PID tmp dir path. Always relative to OS tmpdir + namespace + PID. */
+export function pidTmpDir(pid = process.pid) {
+    return join(tmpdir(), `mneme-vips-${pid}`);
+}
+/** Find the sharp-libvips DLL directory based on platform + node_modules
+ *  layout. Returns null if not found (sharp may not be installed). */
+export function findLibvipsDir(packageRoot) {
+    const root = packageRoot ?? findPackageRoot();
+    if (!root)
+        return null;
+    const archMap = {
+        "win32:x64": "sharp-libvips-win32-x64",
+        "win32:ia32": "sharp-libvips-win32-ia32",
+        "darwin:arm64": "sharp-libvips-darwin-arm64",
+        "darwin:x64": "sharp-libvips-darwin-x64",
+        "linux:x64": "sharp-libvips-linux-x64",
+        "linux:arm64": "sharp-libvips-linux-arm64",
+        "linux:arm": "sharp-libvips-linuxmusl-x64",
+    };
+    const key = `${process.platform}:${process.arch}`;
+    const subdir = archMap[key];
+    if (!subdir)
+        return null;
+    const candidate = join(root, "node_modules", "@img", subdir, "lib");
+    return existsSync(candidate) ? candidate : null;
+}
+/** Find the package's node_modules root by walking up from this file's
+ *  location. Returns null if we're not in a node_modules tree. */
+function findPackageRoot() {
+    let dir = __dirname;
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(join(dir, "node_modules", "@img")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+    return null;
+}
+/** Returns the env var name used by this platform's dynamic-library
+ *  loader to search for shared objects. */
+export function dynamicLibraryEnvVar() {
+    switch (process.platform) {
+        case "win32": return "PATH";
+        case "darwin": return "DYLD_LIBRARY_PATH";
+        default: return "LD_LIBRARY_PATH";
+    }
+}
+/** Build the plan: which files to copy + which env var to mutate. Pure
+ *  function — no side effects. Caller can preview before executing. */
+export function planExtraction(opts) {
+    const libvipsDir = findLibvipsDir(opts?.packageRoot);
+    if (!libvipsDir)
+        return null;
+    const pid = opts?.pid ?? process.pid;
+    const tmpDir = pidTmpDir(pid);
+    let entries;
+    try {
+        entries = readdirSync(libvipsDir);
+    }
+    catch {
+        return null;
+    }
+    // Match shared-library extensions per platform
+    const extRe = process.platform === "win32"
+        ? /\.dll$/i
+        : process.platform === "darwin"
+            ? /\.(dylib|so)(\..*)?$/i
+            : /\.so(\..*)?$/i;
+    const files = entries
+        .filter((name) => extRe.test(name))
+        .map((name) => ({
+        src: join(libvipsDir, name),
+        dst: join(tmpDir, name),
+    }));
+    return {
+        tmpDir,
+        files,
+        envVar: dynamicLibraryEnvVar(),
+        platform: process.platform,
+    };
+}
+/** Execute the extraction: copy DLLs to per-PID tmp dir + prepend to PATH.
+ *  Idempotent — re-running just refreshes the tmp dir. Safe-default — if
+ *  any step fails, returns ok=false but never throws. */
+export function extractAndRedirect(plan) {
+    const t0 = Date.now();
+    const livePlan = plan ?? planExtraction();
+    if (!livePlan) {
+        return {
+            v: PROTOCOL_VERSION,
+            plan: { tmpDir: "", files: [], envVar: dynamicLibraryEnvVar(), platform: process.platform },
+            filesCopied: 0,
+            bytesCopied: 0,
+            filesFailed: 0,
+            envVarSet: "",
+            durationMs: Date.now() - t0,
+            ok: false,
+            error: "no libvips dir found (sharp may not be installed)",
+        };
+    }
+    try {
+        mkdirSync(livePlan.tmpDir, { recursive: true, mode: 0o700 });
+    }
+    catch (e) {
+        return {
+            v: PROTOCOL_VERSION,
+            plan: livePlan,
+            filesCopied: 0,
+            bytesCopied: 0,
+            filesFailed: 0,
+            envVarSet: "",
+            durationMs: Date.now() - t0,
+            ok: false,
+            error: `mkdir failed: ${e.message}`,
+        };
+    }
+    let filesCopied = 0;
+    let bytesCopied = 0;
+    let filesFailed = 0;
+    for (const { src, dst } of livePlan.files) {
+        try {
+            copyFileSync(src, dst);
+            filesCopied++;
+            try {
+                bytesCopied += statSync(dst).size;
+            }
+            catch { /* */ }
+        }
+        catch {
+            filesFailed++;
+        }
+    }
+    // Prepend tmp dir to the platform's library-search env var
+    const sep = process.platform === "win32" ? ";" : ":";
+    const currentEnv = process.env[livePlan.envVar] ?? "";
+    const newEnv = `${livePlan.tmpDir}${sep}${currentEnv}`;
+    process.env[livePlan.envVar] = newEnv;
+    return {
+        v: PROTOCOL_VERSION,
+        plan: livePlan,
+        filesCopied,
+        bytesCopied,
+        filesFailed,
+        envVarSet: livePlan.envVar,
+        durationMs: Date.now() - t0,
+        ok: filesCopied > 0 && filesFailed === 0,
+    };
+}
+/** Cleanup the per-PID tmp dir. Safe to call on process exit — wraps in
+ *  try/catch so it never blocks shutdown. Returns true if dir was removed. */
+export function cleanupExtraction(opts) {
+    const dir = opts?.tmpDir ?? pidTmpDir(opts?.pid ?? process.pid);
+    if (!existsSync(dir))
+        return false;
+    try {
+        rmSync(dir, { recursive: true, force: true, maxRetries: 3 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Sweep ALL orphan mneme-vips-<pid> dirs in tmpdir from dead processes.
+ *  Called by Custodian organ. Returns count + total bytes reclaimed. */
+export function sweepOrphanTmpDirs() {
+    const t = tmpdir();
+    let swept = 0;
+    let failed = 0;
+    let bytesReclaimed = 0;
+    try {
+        const entries = readdirSync(t);
+        for (const entry of entries) {
+            const m = /^mneme-vips-(\d+)$/.exec(entry);
+            if (!m)
+                continue;
+            const pid = parseInt(m[1], 10);
+            // Skip our own dir
+            if (pid === process.pid)
+                continue;
+            // Is the PID alive?
+            let alive = false;
+            try {
+                process.kill(pid, 0);
+                alive = true;
+            }
+            catch (e) {
+                alive = e.code === "EPERM";
+            }
+            if (alive)
+                continue;
+            // PID dead — safe to reclaim
+            const path = join(t, entry);
+            try {
+                // Walk + total size before delete (best-effort)
+                try {
+                    for (const f of readdirSync(path)) {
+                        try {
+                            bytesReclaimed += statSync(join(path, f)).size;
+                        }
+                        catch { /* */ }
+                    }
+                }
+                catch { /* */ }
+                rmSync(path, { recursive: true, force: true, maxRetries: 3 });
+                swept++;
+            }
+            catch {
+                failed++;
+            }
+        }
+    }
+    catch { /* tmpdir scan failed — best-effort */ }
+    return { swept, bytesReclaimed, failed };
+}
+/** Install an `exit` handler that cleans up THIS process's tmp dir on
+ *  graceful shutdown. Idempotent — safe to call multiple times. Returns
+ *  the installed handler so callers can remove it if needed. */
+let exitHandlerInstalled = false;
+let installedHandler = null;
+export function installCleanupOnExit() {
+    if (exitHandlerInstalled)
+        return installedHandler;
+    exitHandlerInstalled = true;
+    const handler = () => { cleanupExtraction(); };
+    installedHandler = handler;
+    try {
+        process.on("exit", handler);
+    }
+    catch { /* */ }
+    // Also clean on SIGTERM/SIGINT (in case the daemon is asked to stop)
+    try {
+        process.on("SIGTERM", handler);
+    }
+    catch { /* */ }
+    try {
+        process.on("SIGINT", handler);
+    }
+    catch { /* */ }
+    return handler;
+}
+export { PROTOCOL_VERSION };
+//# sourceMappingURL=dll_extraction.js.map

package/dist/phoenix/dll_extraction.js.map

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

package/dist/phoenix/dll_extraction.test.d.ts

@@ -0,0 +1,10 @@
+/**
+ * v2.19.62 PHOENIX P3 — DLL EXTRACTION ORGAN deep tests.
+ *
+ * Tests the pure-function primitives + the safe-default failure semantics.
+ * We test SHAPE + SAFETY (extraction never throws, sweep never deletes live
+ * PIDs, env var prepend preserves prior value) rather than asserting the
+ * end-to-end Windows LoadLibrary outcome (would require a real sharp install).
+ */
+export {};
+//# sourceMappingURL=dll_extraction.test.d.ts.map

package/dist/phoenix/dll_extraction.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dll_extraction.test.d.ts","sourceRoot":"","sources":["../../src/phoenix/dll_extraction.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/phoenix/dll_extraction.test.js

@@ -0,0 +1,216 @@
+/**
+ * v2.19.62 PHOENIX P3 — DLL EXTRACTION ORGAN deep tests.
+ *
+ * Tests the pure-function primitives + the safe-default failure semantics.
+ * We test SHAPE + SAFETY (extraction never throws, sweep never deletes live
+ * PIDs, env var prepend preserves prior value) rather than asserting the
+ * end-to-end Windows LoadLibrary outcome (would require a real sharp install).
+ */
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { existsSync, mkdirSync, writeFileSync, rmSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { pidTmpDir, findLibvipsDir, dynamicLibraryEnvVar, planExtraction, extractAndRedirect, cleanupExtraction, sweepOrphanTmpDirs, installCleanupOnExit, PROTOCOL_VERSION, } from "./dll_extraction.js";
+describe("v2.19.62 dll_extraction primitives", () => {
+    it("PROTOCOL_VERSION is 1", () => {
+        expect(PROTOCOL_VERSION).toBe(1);
+    });
+    it("pidTmpDir returns OS-tmpdir-based per-PID path", () => {
+        const dir = pidTmpDir(12345);
+        expect(dir).toContain("mneme-vips-12345");
+        expect(dir.startsWith(tmpdir())).toBe(true);
+    });
+    it("pidTmpDir defaults to current process.pid", () => {
+        const dir = pidTmpDir();
+        expect(dir).toContain(`mneme-vips-${process.pid}`);
+    });
+    it("dynamicLibraryEnvVar returns platform-correct var name", () => {
+        const v = dynamicLibraryEnvVar();
+        if (process.platform === "win32")
+            expect(v).toBe("PATH");
+        else if (process.platform === "darwin")
+            expect(v).toBe("DYLD_LIBRARY_PATH");
+        else
+            expect(v).toBe("LD_LIBRARY_PATH");
+    });
+    it("findLibvipsDir returns null when no node_modules/@img exists", () => {
+        const r = findLibvipsDir("/nonexistent/path/that/has/no/node_modules");
+        expect(r).toBeNull();
+    });
+});
+describe("v2.19.62 dll_extraction with synthetic libvips dir", () => {
+    let testRoot;
+    let archDir;
+    let libDir;
+    let originalEnv = {};
+    beforeEach(() => {
+        testRoot = join(tmpdir(), `mneme-phoenix-test-${process.pid}-${Date.now()}`);
+        mkdirSync(testRoot, { recursive: true });
+        const archMap = {
+            "win32:x64": "sharp-libvips-win32-x64",
+            "win32:ia32": "sharp-libvips-win32-ia32",
+            "darwin:arm64": "sharp-libvips-darwin-arm64",
+            "darwin:x64": "sharp-libvips-darwin-x64",
+            "linux:x64": "sharp-libvips-linux-x64",
+            "linux:arm64": "sharp-libvips-linux-arm64",
+            "linux:arm": "sharp-libvips-linuxmusl-x64",
+        };
+        const key = `${process.platform}:${process.arch}`;
+        archDir = archMap[key] ?? "sharp-libvips-linux-x64";
+        libDir = join(testRoot, "node_modules", "@img", archDir, "lib");
+        mkdirSync(libDir, { recursive: true });
+        const ext = process.platform === "win32" ? ".dll" : process.platform === "darwin" ? ".dylib" : ".so";
+        writeFileSync(join(libDir, `libvips-42${ext}`), "fake-vips-dll-bytes");
+        writeFileSync(join(libDir, `libvips-cpp-42${ext}`), "fake-vips-cpp-dll");
+        writeFileSync(join(libDir, "README.md"), "non-dll file should be ignored");
+        // Save env state for restore
+        originalEnv[dynamicLibraryEnvVar()] = process.env[dynamicLibraryEnvVar()];
+    });
+    afterEach(() => {
+        try {
+            rmSync(testRoot, { recursive: true, force: true });
+        }
+        catch { /* */ }
+        // Restore env
+        const v = dynamicLibraryEnvVar();
+        if (originalEnv[v] !== undefined)
+            process.env[v] = originalEnv[v];
+        else
+            delete process.env[v];
+        // Cleanup any per-PID tmpdir created
+        try {
+            cleanupExtraction();
+        }
+        catch { /* */ }
+    });
+    it("findLibvipsDir locates the synthetic dir", () => {
+        if (process.platform === "win32" && process.arch !== "x64" && process.arch !== "ia32")
+            return;
+        const found = findLibvipsDir(testRoot);
+        expect(found).not.toBeNull();
+        expect(found).toBe(libDir);
+    });
+    it("planExtraction returns shared-library files only", () => {
+        const plan = planExtraction({ packageRoot: testRoot });
+        expect(plan).not.toBeNull();
+        expect(plan.files.length).toBe(2); // two library files; README skipped
+        expect(plan.envVar).toBe(dynamicLibraryEnvVar());
+        expect(plan.platform).toBe(process.platform);
+        // None of the planned files should be the README
+        expect(plan.files.every((f) => !f.src.endsWith("README.md"))).toBe(true);
+    });
+    it("planExtraction picks per-PID tmpdir for dst", () => {
+        const plan = planExtraction({ packageRoot: testRoot, pid: 99999 });
+        expect(plan).not.toBeNull();
+        expect(plan.tmpDir).toContain("mneme-vips-99999");
+        expect(plan.files[0].dst.startsWith(plan.tmpDir)).toBe(true);
+    });
+    it("extractAndRedirect copies files + prepends env var", () => {
+        const plan = planExtraction({ packageRoot: testRoot });
+        expect(plan).not.toBeNull();
+        const envBefore = process.env[plan.envVar] ?? "";
+        const r = extractAndRedirect(plan);
+        expect(r.ok).toBe(true);
+        expect(r.filesCopied).toBe(2);
+        expect(r.filesFailed).toBe(0);
+        expect(r.bytesCopied).toBeGreaterThan(0);
+        expect(r.envVarSet).toBe(plan.envVar);
+        // Files exist in tmpdir
+        expect(existsSync(plan.files[0].dst)).toBe(true);
+        expect(existsSync(plan.files[1].dst)).toBe(true);
+        // Env var prepended
+        const envAfter = process.env[plan.envVar] ?? "";
+        expect(envAfter.startsWith(plan.tmpDir)).toBe(true);
+        expect(envAfter.length).toBeGreaterThan(envBefore.length);
+    });
+    it("extractAndRedirect returns ok=false when sharp absent (no throw)", () => {
+        const r = extractAndRedirect();
+        // Either ok=true (if a real sharp is actually installed in the working tree)
+        // or ok=false with an error — but NEVER throws.
+        expect(typeof r.ok).toBe("boolean");
+        expect(r.durationMs).toBeGreaterThanOrEqual(0);
+    });
+    it("cleanupExtraction removes the per-PID tmpdir + returns true", () => {
+        const plan = planExtraction({ packageRoot: testRoot, pid: process.pid });
+        extractAndRedirect(plan);
+        expect(existsSync(plan.tmpDir)).toBe(true);
+        const removed = cleanupExtraction();
+        expect(removed).toBe(true);
+        expect(existsSync(plan.tmpDir)).toBe(false);
+    });
+    it("cleanupExtraction returns false when dir already gone", () => {
+        const r = cleanupExtraction({ pid: 8888888 });
+        expect(r).toBe(false);
+    });
+    it("file contents copied byte-for-byte", () => {
+        const plan = planExtraction({ packageRoot: testRoot });
+        extractAndRedirect(plan);
+        for (const { src, dst } of plan.files) {
+            const srcBytes = readFileSync(src);
+            const dstBytes = readFileSync(dst);
+            expect(srcBytes.equals(dstBytes)).toBe(true);
+        }
+    });
+    it("idempotent — second extract refreshes existing tmpdir", () => {
+        const plan = planExtraction({ packageRoot: testRoot });
+        const r1 = extractAndRedirect(plan);
+        const r2 = extractAndRedirect(plan);
+        expect(r1.ok).toBe(true);
+        expect(r2.ok).toBe(true);
+        expect(r2.filesCopied).toBe(r1.filesCopied);
+    });
+});
+describe("v2.19.62 sweepOrphanTmpDirs liveness probing", () => {
+    it("never throws + returns structured result", () => {
+        const r = sweepOrphanTmpDirs();
+        expect(r.swept).toBeGreaterThanOrEqual(0);
+        expect(r.bytesReclaimed).toBeGreaterThanOrEqual(0);
+        expect(r.failed).toBeGreaterThanOrEqual(0);
+    });
+    it("does NOT sweep own PID's tmpdir", () => {
+        const myDir = pidTmpDir(process.pid);
+        mkdirSync(myDir, { recursive: true });
+        writeFileSync(join(myDir, "sentinel.txt"), "alive");
+        const r = sweepOrphanTmpDirs();
+        expect(existsSync(myDir)).toBe(true); // Still there
+        expect(r.swept).toBeGreaterThanOrEqual(0);
+        // Cleanup
+        rmSync(myDir, { recursive: true, force: true });
+    });
+    it("DOES sweep dead-PID tmpdir", () => {
+        // Pick a PID that is almost certainly dead, with a unique-per-test
+        // suffix so parallel tests don't race over the same dir.
+        const deadPid = 900_000_000 + (Date.now() % 1_000_000);
+        let isDead = false;
+        try {
+            process.kill(deadPid, 0);
+        }
+        catch (e) {
+            isDead = e.code === "ESRCH";
+        }
+        if (!isDead)
+            return; // skip in unlikely-collision case
+        const deadDir = pidTmpDir(deadPid);
+        mkdirSync(deadDir, { recursive: true });
+        writeFileSync(join(deadDir, "stale.txt"), "should-be-swept");
+        sweepOrphanTmpDirs();
+        // Other parallel test files (organs.test.ts via runCustodianCycle) also
+        // call sweepOrphanTmpDirs — invariant we care about is that the dead
+        // dir is GONE after our sweep, regardless of who counted it.
+        expect(existsSync(deadDir)).toBe(false);
+    });
+    it("returns 0 when tmpdir has no mneme-vips-* entries", () => {
+        // Can't easily isolate tmpdir, so just check that we got a number
+        const r = sweepOrphanTmpDirs();
+        expect(typeof r.swept).toBe("number");
+    });
+});
+describe("v2.19.62 installCleanupOnExit idempotence", () => {
+    it("returns a handler the first time + same handler on repeat call", () => {
+        const h1 = installCleanupOnExit();
+        const h2 = installCleanupOnExit();
+        expect(h1).toBe(h2);
+        expect(typeof h1).toBe("function");
+    });
+});
+//# sourceMappingURL=dll_extraction.test.js.map

package/dist/phoenix/dll_extraction.test.js.map

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

package/dist/phoenix/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — namespace re-exports.
+ *
+ * Three modules ship in Phase 1:
+ *   - dll_extraction: per-PID DLL hostage extraction (source-level EBUSY fix)
+ *   - organs: 3 priority-1 auto-bots (Custodian + Sentinel + Surgeon)
+ *   - scout: passive npm registry probe (PHOENIX P4 step 1)
+ *
+ * Phase 2 (future): Forager, Scholar, Pulse-bot, Lighthouse, Vampire +
+ * full PHOENIX Auto-Upgrade Queen (cocoon + atomic symlink swap).
+ */
+export * as dllExtraction from "./dll_extraction.js";
+export * as organs from "./organs.js";
+export * as scout from "./scout.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/phoenix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/phoenix/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}

package/dist/phoenix/index.js

@@ -0,0 +1,15 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — namespace re-exports.
+ *
+ * Three modules ship in Phase 1:
+ *   - dll_extraction: per-PID DLL hostage extraction (source-level EBUSY fix)
+ *   - organs: 3 priority-1 auto-bots (Custodian + Sentinel + Surgeon)
+ *   - scout: passive npm registry probe (PHOENIX P4 step 1)
+ *
+ * Phase 2 (future): Forager, Scholar, Pulse-bot, Lighthouse, Vampire +
+ * full PHOENIX Auto-Upgrade Queen (cocoon + atomic symlink swap).
+ */
+export * as dllExtraction from "./dll_extraction.js";
+export * as organs from "./organs.js";
+export * as scout from "./scout.js";
+//# sourceMappingURL=index.js.map

package/dist/phoenix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/phoenix/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,aAAa,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,KAAK,MAAM,YAAY,CAAC"}