@mneme-ai/core 2.19.60 → 2.19.62

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

package/dist/phoenix/organs.d.ts

@@ -0,0 +1,110 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — 3 priority-1 organ bots.
+ *
+ * From the user's PHOENIX P5 spec — these are the first 3 bots, the
+ * minimum viable swarm. The remaining 5 (Forager, Scholar, Pulse-bot,
+ * Lighthouse, Vampire) ship in future sprints.
+ *
+ * The pattern: each organ is a PURE-FUNCTION step that:
+ *   1. Reads its inputs (HMAC ledger, OS handle table, latency metrics)
+ *   2. Computes a verdict (cleanup needed? integrity breached? restart?)
+ *   3. Returns structured result (no side effects unless explicitly committed)
+ *   4. Caller (daemon loop) decides whether to act on the verdict
+ *
+ * This separation means the organs are TESTABLE without spawning real
+ * processes + composable into custom schedulers.
+ */
+declare const PROTOCOL_VERSION = 1;
+export interface CustodianReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "custodian";
+    ts: string;
+    tmpDirsSwept: number;
+    tmpBytesReclaimed: number;
+    globalOrphansSwept: number;
+    totalReclaimedBytes: number;
+    durationMs: number;
+}
+/** Custodian cycle — sweeps stale per-PID tmp dirs + orphan .locked-* +
+ *  expired vaccines + fragmented logs. Safe to call from any interval.
+ *  Idempotent + non-throwing.
+ *
+ *  Default period 5min per spec; the daemon's tickAllOrgans loop drives
+ *  the scheduling, this function just runs one cycle. */
+export declare function runCustodianCycle(): CustodianReport;
+export interface SentinelReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "sentinel";
+    ts: string;
+    hmacChainOk: boolean;
+    hmacChainBrokenAt?: number;
+    handleCount: number;
+    handleBaseline: number;
+    handleLeakDetected: boolean;
+    durationMs: number;
+    recommendation: "healthy" | "warn-handle-leak" | "critical-chain-broken";
+}
+export interface SentinelOptions {
+    /** Function that returns current open-handle count (process-specific).
+     *  Caller injects this so the organ stays platform-agnostic. */
+    handleCounter?: () => number;
+    /** Baseline handle count to compare against. Default 50. */
+    handleBaseline?: number;
+    /** HMAC chain verifier — caller passes a function that checks their
+     *  existing chain (lineage / shepherd state / etc). Returns the chain
+     *  result so Sentinel can include it in the report. */
+    verifyHmacChain?: () => {
+        ok: boolean;
+        brokenAt?: number;
+    };
+}
+/** Sentinel cycle — verifies HMAC chain integrity + checks for handle
+ *  leaks. Pure function; no side effects. Caller decides escalation
+ *  (enter quarantine, alert, etc) based on verdict. */
+export declare function runSentinelCycle(opts?: SentinelOptions): SentinelReport;
+export interface OrganLatencyStats {
+    /** Organ name (e.g. "indexer", "embedder", "scan"). */
+    name: string;
+    /** Recent p99 latency in ms. */
+    p99Ms: number;
+    /** Historical baseline p99 in ms. */
+    baselineMs: number;
+    /** Optional: consecutive failure count. */
+    consecutiveFailures?: number;
+}
+export interface SurgeonReport {
+    v: typeof PROTOCOL_VERSION;
+    organ: "surgeon";
+    ts: string;
+    organsExamined: number;
+    organsToRestart: Array<{
+        name: string;
+        reason: string;
+        degradationFactor: number;
+    }>;
+    durationMs: number;
+}
+/** Surgeon cycle — examines per-organ latency stats + flags organs whose
+ *  p99 exceeds 3× baseline OR have 3+ consecutive failures. Returns a
+ *  list of organs caller should restart. Pure verdict; caller commits. */
+export declare function runSurgeonCycle(stats: OrganLatencyStats[], opts?: {
+    degradationFactor?: number;
+    maxConsecutiveFailures?: number;
+}): SurgeonReport;
+export interface AllOrgansReport {
+    v: typeof PROTOCOL_VERSION;
+    ts: string;
+    custodian: CustodianReport;
+    sentinel: SentinelReport;
+    surgeon: SurgeonReport;
+    durationMs: number;
+}
+/** Run all 3 priority-1 organs in one cycle. Used by daemon's tickAllOrgans
+ *  loop and the mneme.phoenix.organs_tick MCP tool. */
+export declare function runAllOrgans(opts?: {
+    sentinel?: SentinelOptions;
+    surgeonStats?: OrganLatencyStats[];
+    surgeonOpts?: Parameters<typeof runSurgeonCycle>[1];
+}): AllOrgansReport;
+export { PROTOCOL_VERSION };
+//# sourceMappingURL=organs.d.ts.map

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

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

package/dist/phoenix/organs.js

@@ -0,0 +1,154 @@
+/**
+ * v2.19.62 PHOENIX PHASE 1 — 3 priority-1 organ bots.
+ *
+ * From the user's PHOENIX P5 spec — these are the first 3 bots, the
+ * minimum viable swarm. The remaining 5 (Forager, Scholar, Pulse-bot,
+ * Lighthouse, Vampire) ship in future sprints.
+ *
+ * The pattern: each organ is a PURE-FUNCTION step that:
+ *   1. Reads its inputs (HMAC ledger, OS handle table, latency metrics)
+ *   2. Computes a verdict (cleanup needed? integrity breached? restart?)
+ *   3. Returns structured result (no side effects unless explicitly committed)
+ *   4. Caller (daemon loop) decides whether to act on the verdict
+ *
+ * This separation means the organs are TESTABLE without spawning real
+ * processes + composable into custom schedulers.
+ */
+import { sweepOrphanTmpDirs } from "./dll_extraction.js";
+import { readdirSync, statSync, existsSync, unlinkSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const PROTOCOL_VERSION = 1;
+/** Custodian cycle — sweeps stale per-PID tmp dirs + orphan .locked-* +
+ *  expired vaccines + fragmented logs. Safe to call from any interval.
+ *  Idempotent + non-throwing.
+ *
+ *  Default period 5min per spec; the daemon's tickAllOrgans loop drives
+ *  the scheduling, this function just runs one cycle. */
+export function runCustodianCycle() {
+    const t0 = Date.now();
+    // Sweep our own tmp dirs that belong to dead PIDs
+    const sweep = sweepOrphanTmpDirs();
+    // Sweep stale .locked-* files in ~/.mneme-global/
+    let globalOrphansSwept = 0;
+    try {
+        const organDir = join(homedir(), ".mneme-global");
+        if (existsSync(organDir)) {
+            const sweepLocked = (dir) => {
+                try {
+                    for (const entry of readdirSync(dir)) {
+                        const path = join(dir, entry);
+                        try {
+                            const st = statSync(path);
+                            if (st.isDirectory()) {
+                                sweepLocked(path); // recurse one level
+                                continue;
+                            }
+                            if (/\.locked-\d+-\d+$/.test(entry)) {
+                                try {
+                                    unlinkSync(path);
+                                    globalOrphansSwept++;
+                                }
+                                catch { /* */ }
+                            }
+                        }
+                        catch { /* */ }
+                    }
+                }
+                catch { /* */ }
+            };
+            sweepLocked(organDir);
+        }
+    }
+    catch { /* */ }
+    return {
+        v: PROTOCOL_VERSION,
+        organ: "custodian",
+        ts: new Date().toISOString(),
+        tmpDirsSwept: sweep.swept,
+        tmpBytesReclaimed: sweep.bytesReclaimed,
+        globalOrphansSwept,
+        totalReclaimedBytes: sweep.bytesReclaimed,
+        durationMs: Date.now() - t0,
+    };
+}
+/** Sentinel cycle — verifies HMAC chain integrity + checks for handle
+ *  leaks. Pure function; no side effects. Caller decides escalation
+ *  (enter quarantine, alert, etc) based on verdict. */
+export function runSentinelCycle(opts) {
+    const t0 = Date.now();
+    const baseline = opts?.handleBaseline ?? 50;
+    const handleCount = opts?.handleCounter ? opts.handleCounter() : -1;
+    const handleLeakDetected = handleCount > baseline * 2;
+    const chain = opts?.verifyHmacChain ? opts.verifyHmacChain() : { ok: true };
+    let recommendation = "healthy";
+    if (!chain.ok)
+        recommendation = "critical-chain-broken";
+    else if (handleLeakDetected)
+        recommendation = "warn-handle-leak";
+    return {
+        v: PROTOCOL_VERSION,
+        organ: "sentinel",
+        ts: new Date().toISOString(),
+        hmacChainOk: chain.ok,
+        ...(chain.brokenAt !== undefined ? { hmacChainBrokenAt: chain.brokenAt } : {}),
+        handleCount,
+        handleBaseline: baseline,
+        handleLeakDetected,
+        durationMs: Date.now() - t0,
+        recommendation,
+    };
+}
+/** Surgeon cycle — examines per-organ latency stats + flags organs whose
+ *  p99 exceeds 3× baseline OR have 3+ consecutive failures. Returns a
+ *  list of organs caller should restart. Pure verdict; caller commits. */
+export function runSurgeonCycle(stats, opts) {
+    const t0 = Date.now();
+    const degradationFactor = opts?.degradationFactor ?? 3;
+    const maxConsecutiveFailures = opts?.maxConsecutiveFailures ?? 3;
+    const organsToRestart = [];
+    for (const stat of stats) {
+        const factor = stat.baselineMs > 0 ? stat.p99Ms / stat.baselineMs : 0;
+        if (factor >= degradationFactor) {
+            organsToRestart.push({
+                name: stat.name,
+                reason: `p99 ${stat.p99Ms}ms is ${factor.toFixed(1)}x baseline ${stat.baselineMs}ms (threshold ${degradationFactor}x)`,
+                degradationFactor: factor,
+            });
+            continue;
+        }
+        if ((stat.consecutiveFailures ?? 0) >= maxConsecutiveFailures) {
+            organsToRestart.push({
+                name: stat.name,
+                reason: `${stat.consecutiveFailures} consecutive failures (threshold ${maxConsecutiveFailures})`,
+                degradationFactor: 0,
+            });
+        }
+    }
+    return {
+        v: PROTOCOL_VERSION,
+        organ: "surgeon",
+        ts: new Date().toISOString(),
+        organsExamined: stats.length,
+        organsToRestart,
+        durationMs: Date.now() - t0,
+    };
+}
+/** Run all 3 priority-1 organs in one cycle. Used by daemon's tickAllOrgans
+ *  loop and the mneme.phoenix.organs_tick MCP tool. */
+export function runAllOrgans(opts) {
+    const t0 = Date.now();
+    const custodian = runCustodianCycle();
+    const sentinel = runSentinelCycle(opts?.sentinel);
+    const surgeon = runSurgeonCycle(opts?.surgeonStats ?? [], opts?.surgeonOpts);
+    return {
+        v: PROTOCOL_VERSION,
+        ts: new Date().toISOString(),
+        custodian,
+        sentinel,
+        surgeon,
+        durationMs: Date.now() - t0,
+    };
+}
+export { PROTOCOL_VERSION };
+//# sourceMappingURL=organs.js.map

package/dist/phoenix/organs.js.map

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

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

@@ -0,0 +1,9 @@
+/**
+ * v2.19.62 PHOENIX P5 — 3 priority-1 organs deep tests.
+ *
+ * Custodian / Sentinel / Surgeon — each is a pure function returning a
+ * verdict. Tests cover: shape of reports, threshold semantics, idempotence,
+ * composability via runAllOrgans.
+ */
+export {};
+//# sourceMappingURL=organs.test.d.ts.map

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

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