@swarmdo/cli 1.4.8

package/dist/src/repair/tdd-repair.js

@@ -0,0 +1,210 @@
+/**
+ * tdd-repair.ts — Test-Driven Repair engine: a bounded headless-Claude loop
+ * that edits SOURCE until a failing test command exits 0.
+ *
+ * Capability modeled on upstream claude-flow v3.14.0 "testgen Test-Driven
+ * Repair"; independent implementation against swarmdo conventions.
+ *
+ * Design invariants (each one is a rail, not a preference):
+ *   - The TEST RUN is the fitness function. This harness runs the test and
+ *     reads the exit code; the model never gets Bash, so it cannot fake a
+ *     green run — it can only Read and Edit.
+ *   - Protected files (the test files + anything passed in) are snapshotted
+ *     before the loop; any change to them is restored byte-for-byte and
+ *     aborts the run as a violation. A repair that edits the test is not a
+ *     repair.
+ *   - Hard budget: each claude call carries --max-budget-usd for the
+ *     REMAINING budget; measured spend (from --output-format json) is
+ *     subtracted after every call and the loop stops at zero.
+ *   - Bounded iterations and per-call timeouts — no unbounded loops.
+ *
+ * The claude/test runners are injectable so the test suite exercises every
+ * path with zero billable calls (see __tests__/tdd-repair.test.ts).
+ */
+import { spawnSync } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const OUTPUT_TAIL = 4000;
+function tail(s, n = OUTPUT_TAIL) {
+    return s.length > n ? s.slice(s.length - n) : s;
+}
+/** Paths in the test command that look like test files and exist. */
+export function detectTestFiles(testCommand, cwd) {
+    const found = [];
+    for (const token of testCommand.split(/\s+/)) {
+        if (!/\.(test|spec)\.[cm]?[jt]sx?$/.test(token))
+            continue;
+        const abs = path.isAbsolute(token) ? token : path.join(cwd, token);
+        if (fs.existsSync(abs))
+            found.push(abs);
+    }
+    return found;
+}
+function defaultRunTest(cmd, cwd) {
+    const res = spawnSync('/bin/sh', ['-c', cmd], {
+        cwd,
+        encoding: 'utf8',
+        timeout: 10 * 60 * 1000,
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    const output = `${res.stdout ?? ''}${res.stderr ?? ''}`;
+    // status null = signal/timeout — a fail, never a pass
+    return { exitCode: res.status ?? 1, output };
+}
+function defaultRunClaude(req) {
+    // Same nested-session/env conventions as headless-worker-executor
+    // (#1395/#1852): prompt via STDIN, entrypoint marker, session vars scrubbed.
+    const env = {
+        ...process.env,
+        CLAUDE_ENTRYPOINT: 'worker',
+    };
+    delete env.CLAUDE_SESSION_ID;
+    delete env.CLAUDE_PARENT_SESSION_ID;
+    const res = spawnSync('claude', [
+        '--print',
+        '--output-format', 'json',
+        '--model', req.model,
+        '--max-budget-usd', String(req.maxBudgetUsd),
+        '--allowedTools', 'Read,Edit',
+        '--permission-mode', 'acceptEdits',
+    ], {
+        cwd: req.cwd,
+        env,
+        input: req.prompt,
+        encoding: 'utf8',
+        timeout: req.timeoutMs,
+        maxBuffer: 16 * 1024 * 1024,
+    });
+    const raw = `${res.stdout ?? ''}`;
+    let costUsd = null;
+    let text = raw;
+    try {
+        const parsed = JSON.parse(raw);
+        costUsd = typeof parsed.total_cost_usd === 'number' ? parsed.total_cost_usd : null;
+        text = typeof parsed.result === 'string' ? parsed.result : raw;
+    }
+    catch {
+        // non-JSON output (old CLI or error path) — keep raw text, unknown cost
+    }
+    return { ok: res.status === 0, text, costUsd };
+}
+function buildPrompt(opts, failureOutput, protectedFiles, iteration, maxIterations) {
+    const protectedList = protectedFiles.map((f) => `- ${f}`).join('\n');
+    const contextList = (opts.contextFiles ?? []).map((f) => `- ${f}`).join('\n');
+    return `You are performing Test-Driven Repair (iteration ${iteration}/${maxIterations}).
+
+A test command is failing. Fix the SOURCE code so it passes. You have Read and Edit only — you cannot run anything; the harness reruns the test after you finish.
+
+Test command (run by the harness, not you):
+  ${opts.testCommand}
+
+Current failure output (tail):
+\`\`\`
+${tail(failureOutput)}
+\`\`\`
+${contextList ? `\nLikely fix sites:\n${contextList}\n` : ''}
+RULES — violations abort the run:
+- NEVER edit these protected files (the tests themselves):
+${protectedList || '- (none detected)'}
+- Make the minimal change that makes the test pass for the RIGHT reason — no test-detection hacks, no deleting assertions' targets, no new dependencies.
+- Prefer editing existing source files over creating new ones.
+
+When done, state in one sentence what you changed and why.`;
+}
+export async function runTddRepair(opts) {
+    const cwd = path.resolve(opts.cwd);
+    const maxIterations = opts.maxIterations ?? 4;
+    const totalBudget = opts.maxBudgetUsd ?? 5;
+    const model = opts.model ?? 'sonnet';
+    const perCallTimeoutMs = opts.perCallTimeoutMs ?? 5 * 60 * 1000;
+    const runTest = opts.runTest ?? defaultRunTest;
+    const runClaude = opts.runClaude ?? defaultRunClaude;
+    const log = opts.log ?? (() => { });
+    // Protected set: auto-detected test files + explicit list, snapshotted.
+    const protectedFiles = [
+        ...detectTestFiles(opts.testCommand, cwd),
+        ...(opts.protectFiles ?? []).map((f) => (path.isAbsolute(f) ? f : path.join(cwd, f))),
+    ].filter((f, i, all) => all.indexOf(f) === i);
+    const snapshots = new Map();
+    for (const f of protectedFiles) {
+        if (fs.existsSync(f))
+            snapshots.set(f, fs.readFileSync(f, 'utf8'));
+    }
+    log(`test: ${opts.testCommand}`);
+    let test = runTest(opts.testCommand, cwd);
+    if (test.exitCode === 0) {
+        return {
+            status: 'already-green',
+            iterations: 0,
+            totalCostUsd: 0,
+            protectedFiles,
+            finalTestOutput: tail(test.output),
+            note: 'test command already exits 0 — nothing to repair',
+        };
+    }
+    let totalCost = 0;
+    for (let i = 1; i <= maxIterations; i++) {
+        const remaining = totalBudget - totalCost;
+        if (remaining <= 0) {
+            return {
+                status: 'exhausted',
+                iterations: i - 1,
+                totalCostUsd: totalCost,
+                protectedFiles,
+                finalTestOutput: tail(test.output),
+                note: `budget ceiling reached ($${totalBudget.toFixed(2)})`,
+            };
+        }
+        log(`iteration ${i}/${maxIterations} — invoking claude (budget left $${remaining.toFixed(2)})`);
+        const result = runClaude({
+            prompt: buildPrompt(opts, test.output, protectedFiles, i, maxIterations),
+            cwd,
+            model,
+            maxBudgetUsd: remaining,
+            timeoutMs: perCallTimeoutMs,
+        });
+        totalCost += result.costUsd ?? 0;
+        if (result.text)
+            log(`claude: ${result.text.slice(0, 300)}`);
+        // Protection check BEFORE trusting anything the model did.
+        const restored = [];
+        for (const [file, original] of snapshots) {
+            const current = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : null;
+            if (current !== original) {
+                fs.writeFileSync(file, original);
+                restored.push(file);
+            }
+        }
+        if (restored.length > 0) {
+            return {
+                status: 'protection-violation',
+                iterations: i,
+                totalCostUsd: totalCost,
+                protectedFiles,
+                finalTestOutput: tail(test.output),
+                restoredFiles: restored,
+                note: 'protected files were modified; originals restored byte-for-byte and the run aborted',
+            };
+        }
+        test = runTest(opts.testCommand, cwd);
+        if (test.exitCode === 0) {
+            return {
+                status: 'fixed',
+                iterations: i,
+                totalCostUsd: totalCost,
+                protectedFiles,
+                finalTestOutput: tail(test.output),
+            };
+        }
+        log(`iteration ${i}: test still failing (exit ${test.exitCode})`);
+    }
+    return {
+        status: 'exhausted',
+        iterations: maxIterations,
+        totalCostUsd: totalCost,
+        protectedFiles,
+        finalTestOutput: tail(test.output),
+        note: `iteration ceiling reached (${maxIterations})`,
+    };
+}
+//# sourceMappingURL=tdd-repair.js.map

package/dist/src/repair/tdd-repair.js.map

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

package/dist/src/runtime/headless.d.ts

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+/**
+ * Headless Runtime for Background Workers
+ * Runs without TTY for daemon processes and scheduled tasks
+ *
+ * Usage:
+ *   npx @swarmdo/cli headless --worker <type>
+ *   npx @swarmdo/cli headless --daemon
+ *   npx @swarmdo/cli headless --benchmark
+ *
+ * Environment:
+ *   SWARMDO_HEADLESS=true
+ *   CLAUDE_CODE_HEADLESS=true
+ *
+ * @module v3/cli/runtime/headless
+ */
+import { type HeadlessWorkerType } from '../services/headless-worker-executor.js';
+interface HeadlessConfig {
+    mode: 'worker' | 'daemon' | 'benchmark' | 'status';
+    workerType?: HeadlessWorkerType;
+    timeout?: number;
+    verbose?: boolean;
+}
+interface BenchmarkResults {
+    sona: {
+        avgMs: number;
+        targetMet: boolean;
+    };
+    flashAttention: {
+        throughputPerMs: number;
+        speedup: number;
+    };
+    hnsw: {
+        entriesIndexed: number;
+        searchTime: number;
+    };
+}
+/**
+ * Run a specific worker
+ */
+declare function runWorker(workerType: HeadlessWorkerType, timeout: number): Promise<void>;
+/**
+ * Run daemon mode
+ */
+declare function runDaemon(): Promise<void>;
+/**
+ * Run benchmarks
+ */
+declare function runBenchmarks(): Promise<BenchmarkResults>;
+/**
+ * Show system status
+ */
+declare function showStatus(): Promise<void>;
+/**
+ * Main entry point
+ */
+declare function main(): Promise<void>;
+export { main, runWorker, runDaemon, runBenchmarks, showStatus };
+export type { HeadlessConfig, BenchmarkResults };
+//# sourceMappingURL=headless.d.ts.map

package/dist/src/runtime/headless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless.d.ts","sourceRoot":"","sources":["../../../src/runtime/headless.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAiD,KAAK,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAiBjI,UAAU,cAAc;IACtB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IACnD,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,cAAc,EAAE;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,IAAI,EAAE;QACJ,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AA4ED;;GAEG;AACH,iBAAe,SAAS,CAAC,UAAU,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BvF;AAED;;GAEG;AACH,iBAAe,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAwBxC;AAED;;GAEG;AACH,iBAAe,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC,CA2ExD;AAED;;GAEG;AACH,iBAAe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAgCzC;AAED;;GAEG;AACH,iBAAe,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAiCnC;AAKD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC;AACjE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/src/runtime/headless.js

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+/**
+ * Headless Runtime for Background Workers
+ * Runs without TTY for daemon processes and scheduled tasks
+ *
+ * Usage:
+ *   npx @swarmdo/cli headless --worker <type>
+ *   npx @swarmdo/cli headless --daemon
+ *   npx @swarmdo/cli headless --benchmark
+ *
+ * Environment:
+ *   SWARMDO_HEADLESS=true
+ *   CLAUDE_CODE_HEADLESS=true
+ *
+ * @module v3/cli/runtime/headless
+ */
+import { HeadlessWorkerExecutor, HEADLESS_WORKER_TYPES } from '../services/headless-worker-executor.js';
+import { getDaemon, startDaemon, stopDaemon } from '../services/worker-daemon.js';
+import { initializeIntelligence, benchmarkAdaptation, getIntelligenceStats } from '../memory/intelligence.js';
+import { getHNSWStatus, batchCosineSim, flashAttentionSearch } from '../memory/memory-initializer.js';
+// ============================================================================
+// Main Runtime
+// ============================================================================
+/**
+ * Parse command line arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const config = {
+        mode: 'status',
+        verbose: false
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--worker' || arg === '-w') {
+            config.mode = 'worker';
+            config.workerType = args[++i];
+        }
+        else if (arg === '--daemon' || arg === '-d') {
+            config.mode = 'daemon';
+        }
+        else if (arg === '--benchmark' || arg === '-b') {
+            config.mode = 'benchmark';
+        }
+        else if (arg === '--status' || arg === '-s') {
+            config.mode = 'status';
+        }
+        else if (arg === '--timeout' || arg === '-t') {
+            config.timeout = parseInt(args[++i], 10) || 60000;
+        }
+        else if (arg === '--verbose' || arg === '-v') {
+            config.verbose = true;
+        }
+        else if (arg === '--help' || arg === '-h') {
+            showHelp();
+            process.exit(0);
+        }
+    }
+    return config;
+}
+/**
+ * Show help message
+ */
+function showHelp() {
+    console.log(`
+Headless Runtime for Swarmdo V3
+
+Usage:
+  headless --worker <type>    Run a specific worker
+  headless --daemon           Start background daemon
+  headless --benchmark        Run performance benchmarks
+  headless --status           Show system status
+
+Workers: ${HEADLESS_WORKER_TYPES.join(', ')}
+
+Options:
+  -w, --worker <type>   Worker type to run
+  -d, --daemon          Run as daemon
+  -b, --benchmark       Run benchmarks
+  -s, --status          Show status
+  -t, --timeout <ms>    Execution timeout (default: 60000)
+  -v, --verbose         Verbose output
+  -h, --help            Show help
+
+Environment:
+  SWARMDO_HEADLESS=true   Enable headless mode
+  CLAUDE_CODE_HEADLESS=true   Enable Claude Code headless
+
+Examples:
+  headless --worker audit --timeout 120000
+  headless --daemon
+  headless --benchmark
+`);
+}
+/**
+ * Run a specific worker
+ */
+async function runWorker(workerType, timeout) {
+    console.log(`[Headless] Starting worker: ${workerType}`);
+    const executor = new HeadlessWorkerExecutor(process.cwd(), {
+        maxConcurrent: 1,
+        defaultTimeoutMs: timeout
+    });
+    try {
+        const result = await executor.execute(workerType, {
+            timeoutMs: timeout,
+            model: 'sonnet',
+            sandbox: 'permissive'
+        });
+        if (result.success) {
+            console.log(`[Headless] Worker ${workerType} completed successfully`);
+            console.log(`[Headless] Duration: ${result.durationMs}ms`);
+            if (result.output) {
+                console.log(`[Headless] Output: ${JSON.stringify(result.output).slice(0, 500)}...`);
+            }
+        }
+        else {
+            console.error(`[Headless] Worker ${workerType} failed: ${result.error}`);
+            process.exit(1);
+        }
+    }
+    finally {
+        // executor doesn't have shutdown, just let it be garbage collected
+    }
+}
+/**
+ * Run daemon mode
+ */
+async function runDaemon() {
+    console.log('[Headless] Starting daemon mode...');
+    // Start the daemon
+    const daemon = await startDaemon(process.cwd());
+    console.log('[Headless] Daemon started');
+    console.log('[Headless] Press Ctrl+C to stop');
+    // Handle shutdown
+    process.on('SIGINT', async () => {
+        console.log('\n[Headless] Shutting down daemon...');
+        await stopDaemon();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        console.log('\n[Headless] Received SIGTERM, shutting down...');
+        await stopDaemon();
+        process.exit(0);
+    });
+    // Keep process running
+    await new Promise(() => { });
+}
+/**
+ * Run benchmarks
+ */
+async function runBenchmarks() {
+    console.log('=== Swarmdo V3 Performance Benchmarks ===\n');
+    // Initialize intelligence
+    await initializeIntelligence();
+    // SONA Benchmark
+    console.log('1. SONA Adaptation Benchmark (10,000 iterations)...');
+    const sonaResult = benchmarkAdaptation(10000);
+    console.log(`   Average: ${sonaResult.avgMs.toFixed(4)}ms`);
+    console.log(`   Target (<0.05ms): ${sonaResult.targetMet ? '✅ ACHIEVED' : '❌ NOT MET'}`);
+    // Flash Attention Benchmark
+    console.log('\n2. Flash Attention Search Benchmark...');
+    const dim = 384;
+    const count = 10000;
+    const query = new Float32Array(dim).map(() => Math.random() - 0.5);
+    const vectors = Array.from({ length: count }, () => new Float32Array(dim).map(() => Math.random() - 0.5));
+    // Warmup
+    flashAttentionSearch(query, vectors, { k: 10 });
+    const flashStart = performance.now();
+    for (let i = 0; i < 10; i++) {
+        flashAttentionSearch(query, vectors, { k: 10 });
+    }
+    const flashTime = (performance.now() - flashStart) / 10;
+    const throughput = count / flashTime;
+    // Brute force comparison
+    const bruteStart = performance.now();
+    for (let i = 0; i < 10; i++) {
+        const scores = batchCosineSim(query, vectors);
+        Array.from({ length: count }, (_, i) => i)
+            .sort((a, b) => scores[b] - scores[a])
+            .slice(0, 10);
+    }
+    const bruteTime = (performance.now() - bruteStart) / 10;
+    const speedup = bruteTime / flashTime;
+    console.log(`   Throughput: ${throughput.toFixed(0)} vectors/ms`);
+    console.log(`   Time for 10k vectors: ${flashTime.toFixed(2)}ms`);
+    console.log(`   Speedup vs brute force: ${speedup.toFixed(2)}x`);
+    // HNSW Status
+    console.log('\n3. HNSW Index Status...');
+    const hnswStatus = getHNSWStatus();
+    console.log(`   Entries indexed: ${hnswStatus.entryCount}`);
+    console.log(`   Initialized: ${hnswStatus.initialized}`);
+    // Intelligence Stats
+    console.log('\n4. Intelligence System Stats...');
+    const stats = getIntelligenceStats();
+    console.log(`   SONA enabled: ${stats.sonaEnabled}`);
+    console.log(`   Patterns learned: ${stats.patternsLearned}`);
+    console.log(`   Avg adaptation time: ${stats.avgAdaptationTime.toFixed(4)}ms`);
+    console.log('\n=== Benchmark Complete ===');
+    return {
+        sona: {
+            avgMs: sonaResult.avgMs,
+            targetMet: sonaResult.targetMet
+        },
+        flashAttention: {
+            throughputPerMs: throughput,
+            speedup
+        },
+        hnsw: {
+            entriesIndexed: hnswStatus.entryCount,
+            searchTime: flashTime
+        }
+    };
+}
+/**
+ * Show system status
+ */
+async function showStatus() {
+    console.log('=== Swarmdo V3 System Status ===\n');
+    // Check daemon
+    const daemon = getDaemon();
+    console.log('Daemon:');
+    if (daemon) {
+        const status = daemon.getStatus();
+        console.log(`  Running: ${status.running}`);
+        console.log(`  PID: ${status.pid}`);
+        console.log(`  Workers: ${status.workers.size}`);
+    }
+    else {
+        console.log('  Not initialized');
+    }
+    // Intelligence
+    const stats = getIntelligenceStats();
+    console.log('\nIntelligence:');
+    console.log(`  SONA enabled: ${stats.sonaEnabled}`);
+    console.log(`  ReasoningBank size: ${stats.reasoningBankSize}`);
+    console.log(`  Patterns learned: ${stats.patternsLearned}`);
+    // HNSW
+    const hnsw = getHNSWStatus();
+    console.log('\nHNSW Index:');
+    console.log(`  Initialized: ${hnsw.initialized}`);
+    console.log(`  Entries: ${hnsw.entryCount}`);
+    console.log('\nEnvironment:');
+    console.log(`  SWARMDO_HEADLESS: ${process.env.SWARMDO_HEADLESS || 'not set'}`);
+    console.log(`  CLAUDE_CODE_HEADLESS: ${process.env.CLAUDE_CODE_HEADLESS || 'not set'}`);
+    console.log(`  NODE_ENV: ${process.env.NODE_ENV || 'development'}`);
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    // Set headless environment
+    process.env.SWARMDO_HEADLESS = 'true';
+    const config = parseArgs();
+    try {
+        switch (config.mode) {
+            case 'worker':
+                if (!config.workerType || !HEADLESS_WORKER_TYPES.includes(config.workerType)) {
+                    console.error(`Invalid worker type. Available: ${HEADLESS_WORKER_TYPES.join(', ')}`);
+                    process.exit(1);
+                }
+                await runWorker(config.workerType, config.timeout || 60000);
+                break;
+            case 'daemon':
+                await runDaemon();
+                break;
+            case 'benchmark':
+                await runBenchmarks();
+                break;
+            case 'status':
+            default:
+                await showStatus();
+                break;
+        }
+    }
+    catch (error) {
+        console.error('[Headless] Error:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}
+// Run if executed directly
+main().catch(console.error);
+export { main, runWorker, runDaemon, runBenchmarks, showStatus };
+//# sourceMappingURL=headless.js.map

package/dist/src/runtime/headless.js.map

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

package/dist/src/runtime/parent-death-watchdog.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Parent-death watchdog (#2234).
+ *
+ * `swarmdo mcp start` runs as a double-forked grandchild of Claude Code (`npx -y
+ * swarmdo … mcp start` → `npm exec …` → `node … mcp start`). When Claude Code
+ * exits, only the `npm exec` shim is terminated; the `node` server reparents to
+ * `launchd`/`init` (`ppid === 1`) and silently lingers — leaving ~50 MB and an
+ * open database handle per restart. Over a week this accumulates to ~20
+ * orphaned servers (~1 GB), and an arbitrary stale one can win the next stdio
+ * handshake, transparently serving superseded code.
+ *
+ * Cheap, robust fix: poll `process.ppid`. When it becomes 1 (and didn't start
+ * there), our original parent has exited — we're orphaned. Run the cleanup
+ * hook and exit cleanly.
+ *
+ * @module runtime/parent-death-watchdog
+ */
+export interface ParentDeathWatchdogOptions {
+    /** Poll interval in ms. Default 2000. */
+    intervalMs?: number;
+    /**
+     * Cleanup hook fired when orphaning is detected. May be async. After it
+     * resolves (or throws), the process exits with code 0 (success) / 1 (error).
+     * Defaults to `process.exit(0)` directly.
+     */
+    onOrphaned?: () => void | Promise<void>;
+    /** Override `process.ppid` getter (tests). */
+    ppidGetter?: () => number;
+    /** Override `process.exit` (tests). */
+    exit?: (code: number) => void;
+}
+export interface ParentDeathWatchdog {
+    stop(): void;
+    /** Manually trigger the orphan check (used by tests). */
+    checkOnce(): Promise<void>;
+}
+/**
+ * Install a parent-death watchdog. Safe to call once per process; calling
+ * twice replaces the previous interval.
+ */
+export declare function installParentDeathWatchdog(opts?: ParentDeathWatchdogOptions): ParentDeathWatchdog;
+//# sourceMappingURL=parent-death-watchdog.d.ts.map

package/dist/src/runtime/parent-death-watchdog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parent-death-watchdog.d.ts","sourceRoot":"","sources":["../../../src/runtime/parent-death-watchdog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,0BAA0B;IACzC,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,MAAM,CAAC;IAC1B,uCAAuC;IACvC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,IAAI,IAAI,CAAC;IACb,yDAAyD;IACzD,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,GAAE,0BAA+B,GAAG,mBAAmB,CA+CrG"}