tauri-agent-tools 0.6.0 → 0.7.0

package/dist/commands/diagnose.js

@@ -0,0 +1,311 @@
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { addBridgeOptions } from './shared.js';
+import { BridgeClient } from '../bridge/client.js';
+import { discoverBridge, discoverBridgesByPid } from '../bridge/tokenDiscovery.js';
+import { resolveTauriProject } from '../util/tauriConfig.js';
+export function registerDiagnose(program) {
+    const cmd = new Command('diagnose')
+        .description("Full diagnostic bundle: composes `forensics` with live bridge data when available. Best-effort — degrades cleanly when the bridge isn't reachable.")
+        .option('--config <path>', 'Path to tauri.conf.json (or its directory). Auto-detected if omitted.')
+        .option('--identifier <id>', 'Bundle identifier override')
+        .option('-o, --out <dir>', 'Output directory (default: ./diagnose-<timestamp>)')
+        .option('--since <duration>', 'How far back to pull from app log files (forensics phase, default: 10m)')
+        .option('--logs-duration <ms>', 'Time budget for live OS-log tail in milliseconds (default: 3000)')
+        .option('--no-bridge', 'Skip bridge-enrichment phase even if a bridge is reachable')
+        .option('--json', 'Print the master summary as JSON in addition to writing to disk');
+    addBridgeOptions(cmd);
+    cmd.action(async (opts) => {
+        const outDir = opts.out ?? `./diagnose-${timestampSlug()}`;
+        await mkdir(outDir, { recursive: true });
+        const forensicsDir = join(outDir, 'forensics');
+        await mkdir(forensicsDir, { recursive: true });
+        const outcomes = [];
+        // ── Phase A: Resolve project (for the summary header) ──────────────────
+        let identifier = '<unknown>';
+        let productName = '<unknown>';
+        try {
+            const resolved = await resolveTauriProject({
+                configPath: opts.config,
+                identifierOverride: opts.identifier,
+            });
+            identifier = resolved.identifier;
+            productName = resolved.productName;
+            outcomes.push({
+                phase: 'resolve-config',
+                ok: true,
+                detail: `identifier=${identifier} productName=${productName}`,
+            });
+        }
+        catch (err) {
+            outcomes.push({
+                phase: 'resolve-config',
+                ok: false,
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // ── Phase B: Forensics subprocess (Tier 1 bundle) ──────────────────────
+        const forensicsArgs = ['forensics', '-o', forensicsDir, '--logs-duration', String(opts.logsDuration ?? 3000)];
+        if (opts.config)
+            forensicsArgs.push('--config', opts.config);
+        if (opts.identifier)
+            forensicsArgs.push('--identifier', opts.identifier);
+        if (opts.since)
+            forensicsArgs.push('--since', opts.since);
+        try {
+            await runSelf(forensicsArgs);
+            outcomes.push({ phase: 'forensics', ok: true, detail: `→ ${forensicsDir}` });
+        }
+        catch (err) {
+            outcomes.push({
+                phase: 'forensics',
+                ok: false,
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // ── Phase C: Bridge enrichment (Tier 2) — optional, best-effort ────────
+        const bridgeData = await collectBridgeData(opts, outcomes);
+        await writeFile(join(outDir, 'bridge.json'), JSON.stringify(bridgeData, null, 2));
+        // ── Phase D: Master summary ────────────────────────────────────────────
+        const forensicsSummary = await tryReadJson(join(forensicsDir, 'summary.json'));
+        const master = {
+            identifier,
+            productName,
+            outDir,
+            forensicsDir,
+            phases: outcomes,
+            bridgeReachable: bridgeData.reachable,
+            bridgeVersion: bridgeData.version,
+            forensicsSummary: forensicsSummary ?? null,
+        };
+        await writeFile(join(outDir, 'summary.json'), JSON.stringify(master, null, 2));
+        await writeFile(join(outDir, 'summary.md'), renderMaster(master, bridgeData, outcomes));
+        if (opts.json) {
+            console.log(JSON.stringify(master, null, 2));
+        }
+        else {
+            const ok = outcomes.filter((o) => o.ok).length;
+            console.log(`✓ Diagnostic bundle written to ${outDir}`);
+            console.log(`  ${ok}/${outcomes.length} phases succeeded`);
+            console.log(`  Bridge: ${bridgeData.reachable ? `reachable (v${bridgeData.version})` : 'unreachable — bundle is forensics-only'}`);
+        }
+    });
+    program.addCommand(cmd);
+}
+function timestampSlug() {
+    return new Date().toISOString().replace(/[:.]/g, '-');
+}
+/** Spawn the same CLI binary that's currently running, for one-level composition. */
+function runSelf(args) {
+    return new Promise((resolve, reject) => {
+        const cliPath = process.argv[1];
+        if (!cliPath) {
+            reject(new Error('Could not locate the current CLI binary (process.argv[1] is empty)'));
+            return;
+        }
+        const child = spawn(process.execPath, [cliPath, ...args], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stderr = '';
+        child.stderr.setEncoding('utf-8');
+        child.stderr.on('data', (chunk) => (stderr += chunk));
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`subprocess exited ${code}${stderr ? ': ' + stderr.trim() : ''}`));
+        });
+    });
+}
+async function tryReadJson(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(await readFile(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+async function collectBridgeData(opts, outcomes) {
+    const data = {
+        reachable: false,
+        version: null,
+        process: null,
+        capabilities: null,
+        devtools: null,
+        health: null,
+        errors: {},
+    };
+    if (opts.noBridge) {
+        outcomes.push({ phase: 'bridge', ok: true, detail: 'skipped (--no-bridge)' });
+        return data;
+    }
+    // Resolve a bridge config without throwing — diagnose tolerates absence.
+    const cfg = await tryResolveBridgeConfig(opts);
+    if (!cfg) {
+        outcomes.push({ phase: 'bridge', ok: false, detail: 'no live bridge discovered' });
+        return data;
+    }
+    const client = new BridgeClient(cfg, opts.windowLabel);
+    const version = await client.version();
+    if (!version) {
+        outcomes.push({ phase: 'bridge', ok: false, detail: `bridge at port ${cfg.port} did not respond to /version` });
+        return data;
+    }
+    data.reachable = true;
+    data.version = version.version;
+    // Each endpoint is best-effort; record per-endpoint failures rather than aborting.
+    for (const [name, fn] of [
+        ['process', () => client.process()],
+        ['capabilities', () => client.capabilities()],
+        ['devtools', () => client.devtools()],
+        ['health', () => client.health()],
+    ]) {
+        try {
+            const result = await fn();
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            data[name] = result;
+            outcomes.push({ phase: `bridge:${name}`, ok: true, detail: 'ok' });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            data.errors[name] = msg;
+            outcomes.push({ phase: `bridge:${name}`, ok: false, detail: msg });
+        }
+    }
+    return data;
+}
+async function tryResolveBridgeConfig(opts) {
+    try {
+        if (opts.port && opts.token) {
+            return { port: opts.port, token: opts.token };
+        }
+        if (opts.pid !== undefined) {
+            const bridges = await discoverBridgesByPid();
+            const match = bridges.get(opts.pid);
+            if (!match)
+                return null;
+            return {
+                port: opts.port ?? match.port,
+                token: opts.token ?? match.token,
+            };
+        }
+        const discovered = await discoverBridge();
+        if (!discovered)
+            return null;
+        return {
+            port: opts.port ?? discovered.port,
+            token: opts.token ?? discovered.token,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function renderMaster(master, bridge, outcomes) {
+    const phaseRows = outcomes
+        .map((o) => `- ${o.ok ? '✓' : '✗'} **${o.phase}** — ${o.detail}`)
+        .join('\n');
+    const bridgeSection = bridge.reachable ? renderBridgeSection(bridge) : NO_BRIDGE_HINT;
+    return `# Diagnose: ${master.productName}
+
+- **Identifier:** \`${master.identifier}\`
+- **Output:** \`${master.outDir}\`
+- **Forensics bundle:** [\`${master.forensicsDir}/summary.md\`](./forensics/summary.md)
+
+## Phases
+
+${phaseRows}
+
+## Bridge enrichment
+
+${bridgeSection}
+
+## Next steps
+
+${suggestNext(master, bridge, outcomes)}
+`;
+}
+const NO_BRIDGE_HINT = `_No live dev bridge was reachable._ The bundle in \`forensics/\` is still useful for post-mortem analysis (OS log tail, panic markers, app data file listing). To get richer data next time:
+
+- Confirm the app is running in dev mode (\`cfg!(debug_assertions)\` must be true)
+- Check for token files: \`ls /tmp/tauri-dev-bridge-*.token\`
+- If you have a PID, pass \`--pid <n>\` explicitly
+`;
+function renderBridgeSection(bridge) {
+    const parts = [`_Bridge v${bridge.version} responded._`, ''];
+    if (bridge.health) {
+        parts.push('### Health');
+        parts.push('');
+        parts.push(`- Uptime: ${Math.floor(bridge.health.uptime_ms / 1000)}s`);
+        parts.push(`- Webview ready: ${bridge.health.webview_ready ? 'yes' : '**NO**'}`);
+        parts.push(`- Sidecars alive: ${bridge.health.sidecars_alive ? 'yes' : '**NO**'}`);
+        parts.push('');
+    }
+    if (bridge.process) {
+        parts.push('### Process tree');
+        parts.push('');
+        parts.push(`- Tauri pid \`${bridge.process.tauri.pid}\` (uptime ${Math.floor(bridge.process.tauri.uptime_ms / 1000)}s)`);
+        if (bridge.process.sidecars.length === 0) {
+            parts.push('- No sidecars registered');
+        }
+        else {
+            for (const s of bridge.process.sidecars) {
+                const alive = s.alive === null || s.alive === undefined ? '?' : s.alive ? 'alive' : '**DEAD**';
+                parts.push(`- Sidecar \`${s.name}\` pid \`${s.pid}\` — ${alive}`);
+            }
+        }
+        parts.push('');
+    }
+    if (bridge.devtools) {
+        parts.push('### Webview devtools');
+        parts.push('');
+        parts.push(`- Platform: ${bridge.devtools.platform}`);
+        parts.push(`- Inspectable: ${bridge.devtools.inspectable ? 'yes' : 'no'}`);
+        if (bridge.devtools.url)
+            parts.push(`- URL: ${bridge.devtools.url}`);
+        parts.push(`- Hint: ${bridge.devtools.hint}`);
+        parts.push('');
+    }
+    if (bridge.capabilities) {
+        parts.push('### Capabilities');
+        parts.push('');
+        parts.push(`- Windows: ${bridge.capabilities.windows.join(', ') || '(none)'}`);
+        parts.push(`- Declared: ${bridge.capabilities.declared.length}`);
+        parts.push('');
+    }
+    if (Object.keys(bridge.errors).length > 0) {
+        parts.push('### Bridge endpoint errors');
+        parts.push('');
+        for (const [endpoint, err] of Object.entries(bridge.errors)) {
+            parts.push(`- \`${endpoint}\`: ${err}`);
+        }
+        parts.push('');
+    }
+    return parts.join('\n');
+}
+function suggestNext(master, bridge, outcomes) {
+    const tips = [];
+    if (!bridge.reachable) {
+        tips.push(`- Bridge was not reachable; the bundle in \`forensics/\` is your best evidence. Inspect \`forensics/summary.md\` first.`);
+    }
+    if (bridge.health && !bridge.health.webview_ready) {
+        tips.push(`- The bridge reports the webview is **not ready**. Likely a pre-webview-boot failure — check \`forensics/app-log-tail.txt\` for the last Rust messages before the webview was supposed to come up.`);
+    }
+    if (bridge.health && !bridge.health.sidecars_alive) {
+        tips.push(`- One or more sidecars are dead. Run \`tauri-agent-tools sidecar tap --schema <path> -- <cmd>\` against the failing sidecar to see exactly what envelope it emits before exiting.`);
+    }
+    if (outcomes.some((o) => o.phase === 'forensics' && !o.ok)) {
+        tips.push(`- The forensics subprocess failed. Run \`tauri-agent-tools forensics --config ${master.identifier === '<unknown>' ? '<path>' : 'auto'} -o /tmp/forensics\` directly to surface the error.`);
+    }
+    if (tips.length === 0) {
+        tips.push(`- No specific anomalies detected. Browse \`${'forensics/summary.md'}\` and the per-endpoint JSON in \`bridge.json\` for context.`);
+    }
+    return tips.join('\n');
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/commands/diagnose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.js","sourceRoot":"","sources":["../../src/commands/diagnose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAOnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AA6B7D,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC;SAChC,WAAW,CACV,oJAAoJ,CACrJ;SACA,MAAM,CAAC,iBAAiB,EAAE,uEAAuE,CAAC;SAClG,MAAM,CAAC,mBAAmB,EAAE,4BAA4B,CAAC;SACzD,MAAM,CAAC,iBAAiB,EAAE,oDAAoD,CAAC;SAC/E,MAAM,CAAC,oBAAoB,EAAE,yEAAyE,CAAC;SACvG,MAAM,CACL,sBAAsB,EACtB,kEAAkE,CACnE;SACA,MAAM,CAAC,aAAa,EAAE,4DAA4D,CAAC;SACnF,MAAM,CAAC,QAAQ,EAAE,iEAAiE,CAAC,CAAC;IAEvF,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAEtB,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,IAAkB,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,cAAc,aAAa,EAAE,EAAE,CAAC;QAC3D,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC/C,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAmB,EAAE,CAAC;QAEpC,0EAA0E;QAC1E,IAAI,UAAU,GAAG,WAAW,CAAC;QAC7B,IAAI,WAAW,GAAG,WAAW,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC;gBACzC,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,kBAAkB,EAAE,IAAI,CAAC,UAAU;aACpC,CAAC,CAAC;YACH,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;YACjC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,cAAc,UAAU,gBAAgB,WAAW,EAAE;aAC9D,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;QAED,0EAA0E;QAC1E,MAAM,aAAa,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC;QAC9G,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,UAAU;YAAE,aAAa,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QACzE,IAAI,IAAI,CAAC,KAAK;YAAE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1D,IAAI,CAAC;YACH,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,WAAW;gBAClB,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;QAED,0EAA0E;QAC1E,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAElF,0EAA0E;QAC1E,MAAM,gBAAgB,GAAG,MAAM,WAAW,CACxC,IAAI,CAAC,YAAY,EAAE,cAAc,CAAC,CACnC,CAAC;QAEF,MAAM,MAAM,GAAG;YACb,UAAU;YACV,WAAW;YACX,MAAM;YACN,YAAY;YACZ,MAAM,EAAE,QAAQ;YAChB,eAAe,EAAE,UAAU,CAAC,SAAS;YACrC,aAAa,EAAE,UAAU,CAAC,OAAO;YACjC,gBAAgB,EAAE,gBAAgB,IAAI,IAAI;SAC3C,CAAC;QAEF,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAExF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;YAC/C,OAAO,CAAC,GAAG,CAAC,kCAAkC,MAAM,EAAE,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,QAAQ,CAAC,MAAM,mBAAmB,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,aAAa,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe,UAAU,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,wCAAwC,EAAE,CAAC,CAAC;QACrI,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,qFAAqF;AACrF,SAAS,OAAO,CAAC,IAAc;IAC7B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC,CAAC;YACxF,OAAO;QACT,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE;YACxD,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC;QAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1B,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,qBAAqB,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3F,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAI,IAAY;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAM,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAkB,EAAE,QAAwB;IAC3E,MAAM,IAAI,GAAe;QACvB,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;QACb,YAAY,EAAE,IAAI;QAClB,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,EAAE;KACX,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yEAAyE;IACzE,MAAM,GAAG,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC,CAAC;QACnF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;IACvC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,GAAG,CAAC,IAAI,8BAA8B,EAAE,CAAC,CAAC;QAChH,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;IACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE/B,mFAAmF;IACnF,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI;QACvB,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAU;QAC5C,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,CAAU;QACtD,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAU;QAC9C,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,CAAU;KAC3C,EAAE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,8DAA8D;YAC7D,IAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;YAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,IAAgB;IAEhB,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QAChD,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,MAAM,oBAAoB,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACpC,IAAI,CAAC,KAAK;gBAAE,OAAO,IAAI,CAAC;YACxB,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI;gBAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK;aACjC,CAAC;QACJ,CAAC;QACD,MAAM,UAAU,GAAG,MAAM,cAAc,EAAE,CAAC;QAC1C,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI;YAClC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK;SACtC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,MAAyF,EACzF,MAAkB,EAClB,QAAwB;IAExB,MAAM,SAAS,GAAG,QAAQ;SACvB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC;SAChE,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IAEtF,OAAO,eAAe,MAAM,CAAC,WAAW;;sBAEpB,MAAM,CAAC,UAAU;kBACrB,MAAM,CAAC,MAAM;6BACF,MAAM,CAAC,YAAY;;;;EAI9C,SAAS;;;;EAIT,aAAa;;;;EAIb,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC;CACtC,CAAC;AACF,CAAC;AAED,MAAM,cAAc,GAAG;;;;;CAKtB,CAAC;AAEF,SAAS,mBAAmB,CAAC,MAAkB;IAC7C,MAAM,KAAK,GAAa,CAAC,YAAY,MAAM,CAAC,OAAO,cAAc,EAAE,EAAE,CAAC,CAAC;IAEvE,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACvE,KAAK,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACjF,KAAK,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,cAAc,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzH,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC;gBAC/F,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtD,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3E,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG;YAAE,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC;QAC/E,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACzC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,QAAQ,OAAO,GAAG,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,WAAW,CAClB,MAA8B,EAC9B,MAAkB,EAClB,QAAwB;IAExB,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CACP,yHAAyH,CAC1H,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QAClD,IAAI,CAAC,IAAI,CACP,oMAAoM,CACrM,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACnD,IAAI,CAAC,IAAI,CACP,mLAAmL,CACpL,CAAC;IACJ,CAAC;IACD,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,WAAW,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QAC3D,IAAI,CAAC,IAAI,CACP,iFAAiF,MAAM,CAAC,UAAU,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,qDAAqD,CAC5L,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CACP,8CAA8C,sBAAsB,8DAA8D,CACnI,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

package/dist/commands/forensics.d.ts

@@ -0,0 +1,2 @@
+import { Command } from 'commander';
+export declare function registerForensics(program: Command): void;

package/dist/commands/forensics.js

@@ -0,0 +1,331 @@
+import { Command } from 'commander';
+import { spawn } from 'node:child_process';
+import { mkdir, readdir, stat, writeFile, readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, basename } from 'node:path';
+import { LineFramer } from '../util/ndjson.js';
+import { resolveTauriProject } from '../util/tauriConfig.js';
+import { buildArgs as buildDarwinArgs, parseLine as parseDarwinLine } from '../platform/oslog/darwin.js';
+import { buildArgs as buildLinuxArgs, parseLine as parseLinuxLine } from '../platform/oslog/linux.js';
+const PANIC_MARKERS = [
+    'panicked at',
+    'panic occurred',
+    'SIGSEGV',
+    'SIGABRT',
+    'fatal runtime error',
+    'thread \'main\' panicked',
+    'Uncaught',
+    'unhandledRejection',
+];
+export function registerForensics(program) {
+    const cmd = new Command('forensics')
+        .description("Bundle a forensic snapshot of a Tauri app (paths, logs, crash reports). Works on dead apps.")
+        .option('--config <path>', 'Path to tauri.conf.json (or its directory). Auto-detected if omitted.')
+        .option('--identifier <id>', 'Bundle identifier override')
+        .option('-o, --out <dir>', 'Output directory (default: ./forensics-<timestamp>)')
+        .option('--since <duration>', 'How far back to pull from app log files (default: 10m)')
+        .option('--logs-duration <ms>', 'Time budget for the live OS-log tail in milliseconds (default: 3000)', parsePositiveInt)
+        .option('--json', 'Print the summary as JSON to stdout in addition to writing to disk')
+        .action(async (opts) => {
+        const outDir = opts.out ?? `./forensics-${timestampSlug()}`;
+        await mkdir(outDir, { recursive: true });
+        const outcomes = [];
+        const summary = { phases: outcomes };
+        // ── Phase 1: Resolve project + paths ─────────────────────────────────
+        const resolved = await safe(async () => resolveTauriProject({ configPath: opts.config, identifierOverride: opts.identifier }));
+        if (!resolved.ok) {
+            outcomes.push({ phase: 'resolve-config', ok: false, detail: resolved.error });
+            await writeSummary(outDir, summary, opts.json);
+            throw new Error(`Could not resolve Tauri config: ${resolved.error}`);
+        }
+        const project = resolved.value;
+        outcomes.push({
+            phase: 'resolve-config',
+            ok: true,
+            detail: `identifier=${project.identifier} productName=${project.productName}`,
+        });
+        summary['identifier'] = project.identifier;
+        summary['productName'] = project.productName;
+        summary['configPath'] = project.configPath;
+        summary['platform'] = project.platform;
+        summary['paths'] = project.paths[project.platform];
+        // ── Phase 2: List files in app-data + app-log directories ────────────
+        const dataFiles = await safeListDir(project.paths[project.platform].appDataDir);
+        const logFiles = await safeListDir(project.paths[project.platform].appLogDir);
+        summary['appDataFiles'] = dataFiles.files;
+        summary['appLogFiles'] = logFiles.files;
+        outcomes.push({
+            phase: 'list-app-data',
+            ok: dataFiles.ok,
+            detail: dataFiles.ok ? `${dataFiles.files.length} files` : dataFiles.detail,
+        });
+        outcomes.push({
+            phase: 'list-app-log',
+            ok: logFiles.ok,
+            detail: logFiles.ok ? `${logFiles.files.length} files` : logFiles.detail,
+        });
+        // ── Phase 3: Tail the most-recently-modified app log file ────────────
+        const newestLog = pickNewest(logFiles.files);
+        let logTail = [];
+        let panicLines = [];
+        if (newestLog) {
+            const tailResult = await safe(async () => tailFile(newestLog.path, 200));
+            if (tailResult.ok) {
+                logTail = tailResult.value;
+                panicLines = logTail.filter((l) => PANIC_MARKERS.some((m) => l.includes(m)));
+                outcomes.push({
+                    phase: 'tail-app-log',
+                    ok: true,
+                    detail: `${logTail.length} lines, ${panicLines.length} panic marker(s)`,
+                });
+                await writeFile(join(outDir, 'app-log-tail.txt'), logTail.join('\n'));
+            }
+            else {
+                outcomes.push({ phase: 'tail-app-log', ok: false, detail: tailResult.error });
+            }
+        }
+        else {
+            outcomes.push({ phase: 'tail-app-log', ok: false, detail: 'no app log files found' });
+        }
+        summary['logTailLineCount'] = logTail.length;
+        summary['panicLines'] = panicLines;
+        // ── Phase 4: macOS DiagnosticReports (skip on other platforms) ───────
+        let diagnosticReports = [];
+        if (project.platform === 'darwin') {
+            const drDir = `${homedir()}/Library/Logs/DiagnosticReports`;
+            if (existsSync(drDir)) {
+                const all = await safeListDir(drDir);
+                // Filter to entries whose name starts with productName (macOS naming convention).
+                diagnosticReports = all.files
+                    .filter((f) => basename(f.path).startsWith(project.productName))
+                    .sort((a, b) => (a.mtime < b.mtime ? 1 : -1))
+                    .slice(0, 5);
+                outcomes.push({
+                    phase: 'macos-diagnostic-reports',
+                    ok: true,
+                    detail: `${diagnosticReports.length} report(s) matching productName`,
+                });
+            }
+            else {
+                outcomes.push({
+                    phase: 'macos-diagnostic-reports',
+                    ok: false,
+                    detail: `${drDir} not accessible`,
+                });
+            }
+        }
+        summary['diagnosticReports'] = diagnosticReports;
+        // ── Phase 5: Live OS-log tail (best-effort) ──────────────────────────
+        const liveLogs = [];
+        const budgetMs = opts.logsDuration ?? 3000;
+        if (project.platform === 'darwin' || project.platform === 'linux') {
+            const livRes = await safe(async () => collectLiveLogs(project.identifier, project.productName, budgetMs, project.platform));
+            if (livRes.ok) {
+                liveLogs.push(...livRes.value);
+                outcomes.push({
+                    phase: 'live-os-log-tail',
+                    ok: true,
+                    detail: `${liveLogs.length} entries in ${budgetMs}ms`,
+                });
+                await writeFile(join(outDir, 'live-os-log.ndjson'), liveLogs.map((e) => JSON.stringify(e)).join('\n'));
+            }
+            else {
+                outcomes.push({ phase: 'live-os-log-tail', ok: false, detail: livRes.error });
+            }
+        }
+        else {
+            outcomes.push({
+                phase: 'live-os-log-tail',
+                ok: false,
+                detail: `not implemented on ${project.platform}`,
+            });
+        }
+        summary['liveLogEntries'] = liveLogs.length;
+        // ── Phase 6: Write artifacts to outDir ───────────────────────────────
+        await writeFile(join(outDir, 'project.json'), JSON.stringify(project, null, 2));
+        await writeFile(join(outDir, 'summary.json'), JSON.stringify(summary, null, 2));
+        await writeFile(join(outDir, 'summary.md'), renderMarkdown(summary, outcomes, project, panicLines, logTail));
+        summary['outDir'] = outDir;
+        if (opts.json) {
+            console.log(JSON.stringify(summary, null, 2));
+        }
+        else {
+            console.log(`✓ Forensic bundle written to ${outDir}`);
+            console.log(`  ${outcomes.filter((o) => o.ok).length}/${outcomes.length} phases succeeded`);
+            if (panicLines.length > 0) {
+                console.log(`  ⚠ ${panicLines.length} panic marker(s) in the most-recent log`);
+            }
+        }
+    });
+    program.addCommand(cmd);
+}
+function timestampSlug() {
+    return new Date().toISOString().replace(/[:.]/g, '-');
+}
+async function safe(fn) {
+    try {
+        return { ok: true, value: await fn() };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+async function safeListDir(dir) {
+    if (!existsSync(dir)) {
+        return { ok: false, files: [], detail: `${dir} does not exist` };
+    }
+    try {
+        const entries = await readdir(dir);
+        const files = [];
+        for (const name of entries) {
+            const path = join(dir, name);
+            try {
+                const st = await stat(path);
+                if (!st.isFile())
+                    continue;
+                files.push({ path, size: st.size, mtime: st.mtime.toISOString() });
+            }
+            catch {
+                // Skip unreadable entries (permission denied, etc.)
+            }
+        }
+        return { ok: true, files, detail: `${files.length} files` };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            files: [],
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+function pickNewest(files) {
+    if (files.length === 0)
+        return null;
+    return [...files].sort((a, b) => (a.mtime < b.mtime ? 1 : -1))[0] ?? null;
+}
+async function tailFile(path, lines) {
+    // Naive impl: read whole file, slice last N. Good enough for "tail the most
+    // recent app log" since these files are typically rotated/small.
+    const text = await readFile(path, 'utf-8');
+    return text.split(/\r?\n/).slice(-lines).filter((l) => l.length > 0);
+}
+async function collectLiveLogs(identifier, productName, budgetMs, platform) {
+    if (platform === 'win32')
+        return [];
+    const args = platform === 'darwin'
+        ? buildDarwinArgs({ identifier, productName })
+        : buildLinuxArgs({ identifier, productName, since: `${Math.ceil(budgetMs / 1000)}s ago` });
+    const cmdBin = platform === 'darwin' ? 'log' : 'journalctl';
+    const parser = platform === 'darwin' ? parseDarwinLine : parseLinuxLine;
+    const child = spawn(cmdBin, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+    const framer = new LineFramer();
+    const entries = [];
+    child.stdout.setEncoding('utf-8');
+    child.stdout.on('data', (chunk) => {
+        for (const line of framer.push(chunk)) {
+            const e = parser(line);
+            if (e)
+                entries.push(e);
+        }
+    });
+    const timer = setTimeout(() => child.kill('SIGTERM'), budgetMs);
+    await new Promise((resolve) => {
+        child.on('close', () => {
+            clearTimeout(timer);
+            resolve();
+        });
+        child.on('error', () => {
+            clearTimeout(timer);
+            resolve(); // swallow — forensics is best-effort
+        });
+    });
+    return entries;
+}
+async function writeSummary(outDir, summary, alsoStdout) {
+    await writeFile(join(outDir, 'summary.json'), JSON.stringify(summary, null, 2));
+    if (alsoStdout)
+        console.log(JSON.stringify(summary, null, 2));
+}
+function renderMarkdown(summary, outcomes, project, panicLines, logTail) {
+    const phases = outcomes
+        .map((o) => `- ${o.ok ? '✓' : '✗'} **${o.phase}** — ${o.detail}`)
+        .join('\n');
+    const dataFiles = summary['appDataFiles'] ?? [];
+    const logFiles = summary['appLogFiles'] ?? [];
+    const dataList = dataFiles.length === 0
+        ? '_no files_'
+        : dataFiles.map((f) => `- \`${f.path}\` (${f.size} bytes, ${f.mtime})`).join('\n');
+    const logList = logFiles.length === 0
+        ? '_no files_'
+        : logFiles.map((f) => `- \`${f.path}\` (${f.size} bytes, ${f.mtime})`).join('\n');
+    const panicBlock = panicLines.length === 0
+        ? '_none_'
+        : panicLines.map((l) => '    ' + l).join('\n');
+    const tailBlock = logTail.length === 0
+        ? '_no log file to tail_'
+        : '```\n' + logTail.slice(-20).join('\n') + '\n```';
+    return `# Forensics: ${project.productName}
+
+- **Identifier:** \`${project.identifier}\`
+- **Platform:** ${project.platform}
+- **Config:** \`${project.configPath}\`
+
+## Phases
+
+${phases}
+
+## Resolved paths (current platform)
+
+\`\`\`json
+${JSON.stringify(project.paths[project.platform], null, 2)}
+\`\`\`
+
+## App data files
+
+${dataList}
+
+## App log files
+
+${logList}
+
+## Panic markers in most-recent log
+
+\`\`\`
+${panicBlock}
+\`\`\`
+
+## Tail of most-recent log (last 20 lines)
+
+${tailBlock}
+
+## Suggested next steps
+
+${suggestNextSteps(project, panicLines, logTail, outcomes)}
+`;
+}
+function suggestNextSteps(project, panicLines, logTail, outcomes) {
+    const tips = [];
+    if (panicLines.length > 0) {
+        tips.push(`- A panic was detected. Run \`tauri-agent-tools os-logs --identifier ${project.identifier} --level error --since 30m --json\` to fetch surrounding error-level entries.`);
+    }
+    if (logTail.length === 0) {
+        tips.push(`- No app log file found. Verify the app actually writes to \`appLogDir\` (default for Tauri is via \`tauri-plugin-log\`).`);
+    }
+    if (outcomes.some((o) => o.phase === 'live-os-log-tail' && !o.ok)) {
+        tips.push(`- Live OS-log tail failed. Check that \`${project.platform === 'darwin' ? 'log' : 'journalctl'}\` is on PATH.`);
+    }
+    if (tips.length === 0) {
+        tips.push(`- No specific anomalies detected. Inspect the artifacts in this folder for context.`);
+    }
+    return tips.join('\n');
+}
+function parsePositiveInt(value) {
+    const n = parseInt(value, 10);
+    if (!Number.isFinite(n) || n <= 0) {
+        throw new Error(`Expected a positive integer, got: ${value}`);
+    }
+    return n;
+}
+//# sourceMappingURL=forensics.js.map