@trenchwork/erosolar 1.1.30 → 1.1.32

package/dist/bin/selfTest.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+/**
+ * Self-Test Runner for Erosolar CLI
+ *
+ * Launches the CLI in a separate process and runs extensive tests
+ * to verify functionality works correctly in a real runtime environment.
+ *
+ * @license MIT
+ */
+import { spawn } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { ComposableMessageBuilder } from '../shell/composableMessage.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const PROJECT_DIR = join(__dirname, '../..');
+// ANSI escape codes
+const COLORS = {
+    reset: '\x1b[0m',
+    green: '\x1b[32m',
+    red: '\x1b[31m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    dim: '\x1b[2m',
+    bold: '\x1b[1m',
+};
+/**
+ * Run all self-tests
+ */
+export async function runSelfTest() {
+    console.log(`\n${COLORS.bold}╔══════════════════════════════════════════════════════════╗${COLORS.reset}`);
+    console.log(`${COLORS.bold}║       Erosolar CLI SELF-TEST SUITE                            ║${COLORS.reset}`);
+    console.log(`${COLORS.bold}╚══════════════════════════════════════════════════════════╝${COLORS.reset}\n`);
+    const results = [];
+    // Phase 1: Unit tests (fast, in-process)
+    console.log(`${COLORS.cyan}▶ Phase 1: Unit Tests (in-process)${COLORS.reset}\n`);
+    results.push(...await runUnitTests());
+    // Phase 2: CLI launch tests (separate process)
+    console.log(`\n${COLORS.cyan}▶ Phase 2: CLI Runtime Tests (separate process)${COLORS.reset}\n`);
+    results.push(...await runCLITests());
+    // Phase 3: Integration tests (if time permits)
+    console.log(`\n${COLORS.cyan}▶ Phase 3: Integration Tests${COLORS.reset}\n`);
+    results.push(...await runIntegrationTests());
+    // Summary
+    printSummary(results);
+    return results.every(r => r.passed);
+}
+/**
+ * Run unit tests for core modules
+ */
+async function runUnitTests() {
+    const results = [];
+    // Test 1: ComposableMessageBuilder - Paste handling (paste chips removed)
+    results.push(await runTest('ComposableMessageBuilder: Basic paste handling', () => {
+        const builder = new ComposableMessageBuilder();
+        const code = 'function test() {\n  return true;\n}';
+        const id = builder.addPaste(code);
+        if (!id)
+            throw new Error('Paste should be accepted');
+        const part = builder.getPart(id);
+        if (!part || part.type !== 'paste')
+            throw new Error('Paste part not found');
+        if (part.content !== code)
+            throw new Error('Paste content mismatch');
+    }));
+    return results;
+}
+/**
+ * Run CLI tests in separate process
+ */
+async function runCLITests() {
+    const results = [];
+    // Test 1: CLI starts successfully
+    results.push(await runTest('CLI: Starts without errors', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+        }
+        finally {
+            await stopCLI(ctx);
+        }
+    }));
+    // Test 2: CLI responds to /help
+    results.push(await runTest('CLI: /help command works', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+            ctx.cli?.stdin?.write('/help\n');
+            await waitForOutput(ctx, /command|help|available/i, 5000);
+        }
+        finally {
+            await stopCLI(ctx);
+        }
+    }));
+    // Test 3: CLI handles /clear command
+    results.push(await runTest('CLI: /clear command works', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+            ctx.cli?.stdin?.write('/clear\n');
+            await wait(500);
+            // Should not crash
+            if (ctx.errors.toLowerCase().includes('crash') || ctx.errors.toLowerCase().includes('fatal')) {
+                throw new Error(`CLI crashed on /clear: ${ctx.errors}`);
+            }
+        }
+        finally {
+            await stopCLI(ctx);
+        }
+    }));
+    // Test 4: CLI exits cleanly with /exit or Ctrl+D
+    results.push(await runTest('CLI: Graceful shutdown (Ctrl+C/D)', async () => {
+        const ctx = await launchCLI();
+        try {
+            await waitForOutput(ctx, /agi|welcome|ready/i, 10000);
+            // Send Ctrl+C followed by Ctrl+D for graceful shutdown
+            ctx.cli?.stdin?.write('\x03'); // Ctrl+C
+            await wait(300);
+            ctx.cli?.stdin?.write('\x04'); // Ctrl+D
+            // Wait for process to exit
+            await new Promise((resolve) => {
+                const timeout = setTimeout(() => {
+                    // Force kill if graceful shutdown didn't work - this is acceptable
+                    ctx.cli?.kill('SIGTERM');
+                    resolve();
+                }, 3000);
+                ctx.cli?.on('exit', () => {
+                    clearTimeout(timeout);
+                    resolve();
+                });
+            });
+        }
+        finally {
+            // Already handled
+        }
+    }));
+    return results;
+}
+/**
+ * Run integration tests
+ */
+async function runIntegrationTests() {
+    const results = [];
+    // Test 1: Version flag works
+    results.push(await runTest('Integration: --version flag', async () => {
+        const result = await runCLICommand(['--version']);
+        if (!result.output.includes('agi-cli v')) {
+            throw new Error(`Version not shown: ${result.output}`);
+        }
+    }));
+    // Test 2: Help flag works
+    results.push(await runTest('Integration: --help flag', async () => {
+        const result = await runCLICommand(['--help']);
+        if (!result.output.includes('Usage:')) {
+            throw new Error(`Help not shown: ${result.output}`);
+        }
+    }));
+    // Test 3: Invalid flag handling
+    results.push(await runTest('Integration: Invalid flag handling', async () => {
+        // Should not crash on unknown flags (just pass them through or ignore)
+        const result = await runCLICommand(['--invalid-flag-xyz'], 3000);
+        // Just check it doesn't crash with unhandled exception
+        if (result.errors.includes('unhandled') || result.errors.includes('uncaught')) {
+            throw new Error(`Unhandled exception on invalid flag: ${result.errors}`);
+        }
+    }));
+    return results;
+}
+// ============================================================================
+// HELPER FUNCTIONS
+// ============================================================================
+async function runTest(name, fn) {
+    const start = Date.now();
+    try {
+        await fn();
+        const duration = Date.now() - start;
+        console.log(`  ${COLORS.green}✓${COLORS.reset} ${name} ${COLORS.dim}(${duration}ms)${COLORS.reset}`);
+        return { name, passed: true, duration };
+    }
+    catch (error) {
+        const duration = Date.now() - start;
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(`  ${COLORS.red}✗${COLORS.reset} ${name} ${COLORS.dim}(${duration}ms)${COLORS.reset}`);
+        console.log(`    ${COLORS.red}${message}${COLORS.reset}`);
+        return { name, passed: false, duration, error: message };
+    }
+}
+async function launchCLI() {
+    const ctx = {
+        cli: null,
+        output: '',
+        errors: '',
+    };
+    const cliPath = join(PROJECT_DIR, 'dist/bin/agi.js');
+    ctx.cli = spawn('node', [cliPath], {
+        cwd: PROJECT_DIR,
+        env: {
+            ...process.env,
+            NO_COLOR: '1',
+            FORCE_COLOR: '0',
+            CI: '1',
+        },
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    ctx.cli.stdout?.on('data', (data) => {
+        ctx.output += data.toString();
+    });
+    ctx.cli.stderr?.on('data', (data) => {
+        ctx.errors += data.toString();
+    });
+    return ctx;
+}
+async function stopCLI(ctx) {
+    if (!ctx.cli)
+        return;
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            ctx.cli?.kill('SIGKILL');
+            resolve();
+        }, 3000);
+        ctx.cli.on('exit', () => {
+            clearTimeout(timeout);
+            resolve();
+        });
+        ctx.cli?.stdin?.write('\x03'); // Ctrl+C
+        setTimeout(() => {
+            ctx.cli?.stdin?.write('\x04'); // Ctrl+D
+        }, 500);
+    });
+}
+async function waitForOutput(ctx, pattern, timeout) {
+    const start = Date.now();
+    return new Promise((resolve, reject) => {
+        const check = () => {
+            if (pattern.test(ctx.output)) {
+                resolve();
+                return;
+            }
+            if (Date.now() - start > timeout) {
+                reject(new Error(`Timeout waiting for pattern ${pattern}. Output: ${ctx.output.slice(-500)}`));
+                return;
+            }
+            setTimeout(check, 100);
+        };
+        check();
+    });
+}
+async function wait(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+async function runCLICommand(args, timeout = 5000) {
+    return new Promise((resolve) => {
+        const cliPath = join(PROJECT_DIR, 'dist/bin/agi.js');
+        let output = '';
+        let errors = '';
+        const proc = spawn('node', [cliPath, ...args], {
+            cwd: PROJECT_DIR,
+            env: { ...process.env, NO_COLOR: '1' },
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const timer = setTimeout(() => {
+            proc.kill('SIGKILL');
+        }, timeout);
+        proc.stdout?.on('data', (data) => { output += data.toString(); });
+        proc.stderr?.on('data', (data) => { errors += data.toString(); });
+        proc.on('exit', (code) => {
+            clearTimeout(timer);
+            resolve({ output, errors, exitCode: code ?? 0 });
+        });
+    });
+}
+function printSummary(results) {
+    const passed = results.filter(r => r.passed).length;
+    const failed = results.filter(r => !r.passed).length;
+    const totalDuration = results.reduce((sum, r) => sum + r.duration, 0);
+    console.log(`\n${COLORS.bold}════════════════════════════════════════════════════════════${COLORS.reset}`);
+    console.log(`${COLORS.bold}  TEST SUMMARY${COLORS.reset}`);
+    console.log(`${COLORS.bold}════════════════════════════════════════════════════════════${COLORS.reset}`);
+    console.log(`  Total:    ${results.length}`);
+    console.log(`  ${COLORS.green}Passed:   ${passed}${COLORS.reset}`);
+    if (failed > 0) {
+        console.log(`  ${COLORS.red}Failed:   ${failed}${COLORS.reset}`);
+    }
+    console.log(`  Duration: ${(totalDuration / 1000).toFixed(2)}s`);
+    console.log();
+    if (failed === 0) {
+        console.log(`${COLORS.green}${COLORS.bold}  ✓ ALL TESTS PASSED${COLORS.reset}\n`);
+    }
+    else {
+        console.log(`${COLORS.red}${COLORS.bold}  ✗ SOME TESTS FAILED${COLORS.reset}`);
+        console.log(`\n  Failed tests:`);
+        for (const r of results.filter(r => !r.passed)) {
+            console.log(`    - ${r.name}: ${r.error}`);
+        }
+        console.log();
+    }
+}
+//# sourceMappingURL=selfTest.js.map

package/dist/bin/selfTest.js.map

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

package/dist/capabilities/_binaryRequirements.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Single source of truth for every external binary the offsec
+ * capability surface invokes.
+ *
+ * Each entry maps `bin` → install commands (one per bootstrap channel)
+ * + the capability that needs it. Two things consume this manifest:
+ *
+ *   1. `ensureBinary(bin)` (in _processRunner.ts) — the runtime
+ *      preflight every offsec tool handler runs before spawn. Missing
+ *      binary → clean error with the install hint instead of cryptic
+ *      ENOENT.
+ *
+ *   2. `erosolar offsec install` — the operator-facing self-bootstrap.
+ *      Reads the manifest, filters to the active profile's
+ *      capabilities, runs the install command for every missing
+ *      binary after HITL confirmation. Idempotent — already-installed
+ *      bins are skipped.
+ *
+ * `system-unification.test.ts` (Site ↔ Lambda contract test) is
+ * extended to also assert that every binary spawned from
+ * `src/capabilities/*.ts` has an entry here. That catches the "I
+ * added a tool but forgot the install hint" drift that would
+ * otherwise surface as a confused operator running into ENOENT.
+ *
+ * Kali is the assumed default, but the manifest carries cross-platform
+ * commands so a Linux-non-Kali / macOS / Windows operator can also
+ * bootstrap if their OS package manager has the tool.
+ */
+export type InstallChannel = 'pipx' | 'pip' | 'npm' | 'apt' | 'brew' | 'winget' | 'cargo' | 'go' | 'gem' | 'docker';
+export interface BinaryRequirement {
+    /** Executable name on PATH. */
+    bin: string;
+    /** Capability id this requirement belongs to (matches CapabilityModule.id without the `capability.` prefix). */
+    capability: string;
+    /** Short description used in install prompts. */
+    description: string;
+    /**
+     * Install commands per channel. The runner picks the first available
+     * channel for the operator's platform (e.g. on Linux: prefer pipx for
+     * Python, then pip, then apt; on macOS: prefer brew). Every entry is
+     * a single shell line — runner shells out via `bash -lc <cmd>`.
+     */
+    install: Partial<Record<InstallChannel, string>>;
+    /**
+     * Per-platform notes shown when the operator runs `erosolar offsec
+     * install` on that OS — used to point Windows users at WSL2 for
+     * tools that aren't packaged natively, or to flag Docker-only
+     * paths.
+     */
+    notes?: Partial<Record<NodeJS.Platform, string>>;
+    /**
+     * If true, the bin is "nice to have" — its absence does not block
+     * the capability from loading; individual tool handlers may still
+     * fail. Used for optional integrations like pwndbg / GEF on top of
+     * gdb.
+     */
+    optional?: boolean;
+}
+/**
+ * Canonical channel preference order per platform. The first channel
+ * the binary's manifest entry lists in this order is what the
+ * installer will run. `pipx`/`pip`/`npm`/`cargo`/`go`/`gem` are the
+ * cross-platform escape hatches — any binary published to one of
+ * those channels works on every operator OS without needing a Kali
+ * box. `apt` is Debian/Kali/Ubuntu only; `brew` is macOS-first;
+ * `winget` is Windows.
+ */
+export declare const CHANNEL_PREFERENCE: Record<NodeJS.Platform | 'default', InstallChannel[]>;
+export declare const BINARY_REQUIREMENTS: ReadonlyArray<BinaryRequirement>;
+export declare function findRequirement(bin: string): BinaryRequirement | null;
+export declare function requirementsForCapability(capability: string): BinaryRequirement[];
+/**
+ * Choose the install command for a given platform. Walks the
+ * platform's preferred channel order; returns the first channel the
+ * requirement has a command for. Returns null when no channel matches
+ * (extremely rare — every entry should have at least one command).
+ */
+export declare function pickInstallCommand(req: BinaryRequirement, platform?: NodeJS.Platform): {
+    channel: InstallChannel;
+    cmd: string;
+} | null;
+/** Returns true when at least one platform install command exists. */
+export declare function hasInstallCommand(req: BinaryRequirement): boolean;
+/**
+ * Platform-availability heuristic. Returns true when the requirement
+ * has a channel that's actually usable on the given platform — i.e.
+ * the operator can plausibly install it without WSL/Docker.
+ *
+ *   linux  → any of: apt, pipx, pip, npm, cargo, go, gem
+ *   darwin → any of: brew, pipx, pip, npm, cargo, go, gem
+ *   win32  → any of: winget, pipx, pip, npm, cargo, go, gem
+ *
+ * Tools that are Linux-only at the source level (afl-fuzz, gdb without
+ * code-signing on macOS, hydra) carry a `notes` entry pointing at the
+ * WSL2 / Docker path. The installer surfaces those notes so the
+ * operator knows they need to take a manual route.
+ */
+export declare function isNativelyAvailable(req: BinaryRequirement, platform?: NodeJS.Platform): boolean;
+/** Note for the operator's platform, if any. */
+export declare function platformNote(req: BinaryRequirement, platform?: NodeJS.Platform): string | null;
+//# sourceMappingURL=_binaryRequirements.d.ts.map

package/dist/capabilities/_binaryRequirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_binaryRequirements.d.ts","sourceRoot":"","sources":["../../src/capabilities/_binaryRequirements.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,MAAM,MAAM,cAAc,GACtB,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3F,MAAM,WAAW,iBAAiB;IAChC,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,gHAAgH;IAChH,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,cAAc,EAAE,CAK3B,CAAC;AAwB3D,eAAO,MAAM,mBAAmB,EAAE,aAAa,CAAC,iBAAiB,CA+JhE,CAAC;AAOF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAErE;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C;IAAE,OAAO,EAAE,cAAc,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYjD;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAKjE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,iBAAiB,EACtB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,OAAO,CAYT;AAED,gDAAgD;AAChD,wBAAgB,YAAY,CAC1B,GAAG,EAAE,iBAAiB,EACtB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,GAAG,IAAI,CAEf"}