@peekdev/cli 0.1.0-alpha.1

package/NOTICE

@@ -0,0 +1,8 @@
+@peekdev/cli
+Copyright 2026 Cubenest
+
+This product includes software developed by:
+- WiseLibs — better-sqlite3 (MIT License)
+
+This product is licensed under the Apache License, Version 2.0.
+See the LICENSE file for details.

package/dist/commands/audit.d.ts

@@ -0,0 +1,3 @@
+/** Entry for `peek audit ...`; `argv` excludes the `audit` token. */
+export declare function runAudit(argv: string[]): number;
+//# sourceMappingURL=audit.d.ts.map

package/dist/commands/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/commands/audit.ts"],"names":[],"mappings":"AA8CA,qEAAqE;AACrE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CA6D/C"}

package/dist/commands/audit.js

@@ -0,0 +1,96 @@
+// `peek audit log [--since <dur>] [--tool <name>] [--client <name>]` command
+// shell (Task 3.10, ADR-0010 / P2 PRD §H3). Reads ~/.peek/audit.log (JSONL),
+// runs the pure parse + filter, and prints. The native host / extension write
+// the log; the CLI only reads it.
+import { readFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { filterAuditEntries, parseAuditLog, } from '../lib/audit.js';
+import { cutoffBefore } from '../lib/duration.js';
+import { auditLogPath } from '../lib/peek-home.js';
+function printUsage() {
+    process.stdout.write([
+        'Usage: peek audit log [options]',
+        '',
+        'Options:',
+        '  --since <dur>     Only entries newer than e.g. 1h, 30m, 7d',
+        '  --tool <name>     Filter by tool (e.g. execute_action)',
+        '  --client <name>   Filter by MCP client (e.g. cursor, claude-code)',
+        '  --json            Emit matching entries as JSON instead of a table',
+        '',
+    ].join('\n'));
+}
+function renderEntry(e) {
+    const parts = [
+        e.ts,
+        e.tool ?? '(no tool)',
+        e.client ? `client=${e.client}` : '',
+        e.result ? `result=${e.result}` : '',
+        e.sessionId ? `session=${e.sessionId}` : '',
+    ].filter(Boolean);
+    let line = parts.join('  ');
+    if (e.args !== undefined) {
+        line += `  args=${JSON.stringify(e.args)}`;
+    }
+    return line;
+}
+/** Entry for `peek audit ...`; `argv` excludes the `audit` token. */
+export function runAudit(argv) {
+    const sub = argv[0];
+    if (sub !== 'log') {
+        if (sub === undefined || sub === 'help' || sub === '--help' || sub === '-h') {
+            printUsage();
+            return sub === undefined ? 1 : 0;
+        }
+        process.stderr.write(`peek audit: unknown subcommand '${sub}' (did you mean 'log'?)\n`);
+        return 1;
+    }
+    const { values } = parseArgs({
+        args: argv.slice(1),
+        options: {
+            since: { type: 'string' },
+            tool: { type: 'string' },
+            client: { type: 'string' },
+            json: { type: 'boolean' },
+        },
+        allowPositionals: false,
+    });
+    const filter = {
+        ...(values.tool !== undefined ? { tool: values.tool } : {}),
+        ...(values.client !== undefined ? { client: values.client } : {}),
+    };
+    if (values.since !== undefined) {
+        try {
+            filter.sinceMs = cutoffBefore(values.since);
+        }
+        catch (err) {
+            process.stderr.write(`peek audit log: ${err instanceof Error ? err.message : String(err)}\n`);
+            return 1;
+        }
+    }
+    const path = auditLogPath();
+    let contents;
+    try {
+        contents = readFileSync(path, 'utf8');
+    }
+    catch {
+        process.stdout.write(`No audit log yet (${path}).\n`);
+        return 0;
+    }
+    const { entries, errors } = parseAuditLog(contents);
+    const matched = filterAuditEntries(entries, filter);
+    if (values.json) {
+        process.stdout.write(`${JSON.stringify(matched, null, 2)}\n`);
+    }
+    else if (matched.length === 0) {
+        process.stdout.write('No matching audit entries.\n');
+    }
+    else {
+        for (const e of matched)
+            process.stdout.write(`${renderEntry(e)}\n`);
+    }
+    if (errors.length > 0) {
+        process.stderr.write(`\npeek audit log: skipped ${errors.length} malformed line(s) (first at line ${errors[0]?.line}).\n`);
+    }
+    return 0;
+}
+//# sourceMappingURL=audit.js.map

package/dist/commands/audit.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,3 @@
+/** Entry for `peek init`; `argv` excludes the `init` token. */
+export declare function runInit(argv: string[]): Promise<number>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAsMA,+DAA+D;AAC/D,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC7D"}

package/dist/commands/init.js

@@ -0,0 +1,180 @@
+// `peek init` interactive wizard (Task 3.9, P2 PRD §K.5). This is the
+// SIDE-EFFECTFUL shell: it detects MCP-capable clients (pure: init-config.ts),
+// prompts which to configure, writes the merged `mcpServers.peek` block into
+// each (merge is pure + tested), and then offers to register the native
+// messaging host — the consent step the Phase 3a postinstall deliberately
+// defers to (it dry-runs unless PEEK_INSTALL_NATIVE_HOST is set; here the user
+// affirmatively opts in, so we call the installer directly with realSink).
+import { existsSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { parseArgs } from 'node:util';
+import { buildManifest, hostBinaryPath, installManifests, loadExtensionIds, realSink, resolveInstallTargets, } from '@peekdev/mcp/native-host';
+import { atomicWriteFileSync } from '../lib/fs-atomic.js';
+import { PEEK_BLOCK_SNIPPET, containsJsonComments, detectClients, hasPeekServer, mergePeekConfig, serializeConfig, } from '../lib/init-config.js';
+import { confirm, multiSelect } from '../lib/prompt.js';
+const SUPPORTED = ['darwin', 'linux', 'win32'];
+/** Thrown by `readConfig` when the file is JSONC (comments) — we won't rewrite it. */
+class JsoncConfigError extends Error {
+    constructor() {
+        super('config contains comments (JSONC)');
+        this.name = 'JsoncConfigError';
+    }
+}
+/**
+ * Read + parse a client config file, or undefined if absent/empty. Throws
+ * `JsoncConfigError` if the file is JSONC (comments) so the caller can route to
+ * the "add the block manually" path rather than corrupt it; throws on other
+ * invalid JSON.
+ */
+function readConfig(path) {
+    if (!existsSync(path))
+        return undefined;
+    const raw = readFileSync(path, 'utf8').trim();
+    if (raw.length === 0)
+        return undefined;
+    if (containsJsonComments(raw))
+        throw new JsoncConfigError();
+    return JSON.parse(raw);
+}
+/** Merge the peek block into a client's config and write it atomically. */
+function writeClientConfig(client) {
+    let existing;
+    try {
+        existing = readConfig(client.configPath);
+    }
+    catch (err) {
+        if (err instanceof JsoncConfigError)
+            return { ok: false, jsonc: true };
+        return { ok: false, jsonc: false, error: err instanceof Error ? err.message : String(err) };
+    }
+    try {
+        atomicWriteFileSync(client.configPath, serializeConfig(mergePeekConfig(existing)));
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, jsonc: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+async function configureClients(homeDir, cwd) {
+    const detected = detectClients(homeDir, cwd, existsSync);
+    const present = detected.filter((c) => c.exists);
+    process.stdout.write(present.length > 0
+        ? `Detected MCP-capable clients: ${present.map((c) => c.label).join(', ')}\n`
+        : 'No MCP client configs detected — you can still create them below.\n');
+    const chosen = await multiSelect('Which clients would you like to configure? (peek will be added to each)', detected.map((c) => ({
+        value: c,
+        label: c.label,
+        // Default-check clients whose config already exists and that aren't
+        // manual-only (matches the §K.5 transcript's pre-checked rows).
+        checked: c.exists && !c.manualOnly,
+        disabled: c.manualOnly,
+        hint: c.manualOnly ? 'manual config required' : c.configPath,
+    })));
+    if (chosen.length === 0) {
+        process.stdout.write('No clients selected; skipping MCP config.\n');
+        return;
+    }
+    for (const client of chosen) {
+        const already = (() => {
+            try {
+                return hasPeekServer(readConfig(client.configPath));
+            }
+            catch {
+                return false;
+            }
+        })();
+        const res = writeClientConfig(client);
+        if (res.ok) {
+            process.stdout.write(`  ${already ? 'Updated' : 'Wrote'} ${client.label}: ${client.configPath}\n`);
+        }
+        else if (res.jsonc) {
+            // JSONC (comments): don't rewrite — JSON.stringify would strip the
+            // comments. Tell the user exactly what to add.
+            const snippet = PEEK_BLOCK_SNIPPET.split('\n')
+                .map((l) => `      ${l}`)
+                .join('\n');
+            process.stdout.write([
+                `  ! ${client.label}: ${client.configPath} contains comments (JSONC); not modified.`,
+                '    Add the peek server manually:',
+                `${snippet}\n`,
+            ].join('\n'));
+        }
+        else {
+            process.stdout.write(`  ✗ ${client.label}: ${client.configPath} — ${res.error}\n`);
+        }
+    }
+}
+async function registerNativeHost(platform, homeDir) {
+    const proceed = await confirm('\nRegister the native messaging host now? (writes a manifest into your browser dirs, with your consent)', true);
+    if (!proceed) {
+        process.stdout.write('Skipped native-host registration. Re-run `peek init`, or set PEEK_INSTALL_NATIVE_HOST=1 and reinstall @peekdev/mcp.\n');
+        return;
+    }
+    let extensionIds;
+    try {
+        extensionIds = loadExtensionIds();
+    }
+    catch (err) {
+        process.stdout.write(`Could not load extension IDs (${err instanceof Error ? err.message : String(err)}); skipping native-host registration.\n`);
+        return;
+    }
+    const allTargets = resolveInstallTargets(platform, homeDir);
+    const chosen = await multiSelect('Register native messaging host for:', allTargets.map((t) => ({
+        value: t,
+        label: t.browser,
+        checked: true,
+        hint: t.manifestPath ?? t.registryKey,
+    })));
+    if (chosen.length === 0) {
+        process.stdout.write('No browsers selected; skipping native-host registration.\n');
+        return;
+    }
+    const manifest = buildManifest(hostBinaryPath(), extensionIds);
+    const results = installManifests([...chosen], manifest, { sink: realSink });
+    for (const r of results) {
+        const where = r.manifestPath ?? r.registryKey ?? '(unknown)';
+        if (r.error)
+            process.stdout.write(`  ✗ ${r.browser}: ${where} — ${r.error}\n`);
+        else
+            process.stdout.write(`  ✔ Wrote ${r.browser}: ${where}\n`);
+    }
+}
+function nextSteps() {
+    process.stdout.write([
+        '',
+        'Next steps:',
+        '  1. Install the peek Chrome extension (see the repo README for the store link).',
+        '  2. Open Chrome → click the peek icon → enable recording on a site.',
+        '  3. In your AI client: ask "what\'s in my last Peek session?"',
+        '',
+    ].join('\n'));
+}
+/** Entry for `peek init`; `argv` excludes the `init` token. */
+export async function runInit(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            'skip-native-host': { type: 'boolean' },
+            'skip-clients': { type: 'boolean' },
+        },
+        allowPositionals: false,
+    });
+    const platform = process.platform;
+    const homeDir = homedir();
+    const cwd = process.cwd();
+    process.stdout.write('peek init — configure MCP clients + the native messaging host.\n\n');
+    if (!values['skip-clients']) {
+        await configureClients(homeDir, cwd);
+    }
+    if (!values['skip-native-host']) {
+        if (SUPPORTED.includes(platform)) {
+            await registerNativeHost(platform, homeDir);
+        }
+        else {
+            process.stdout.write(`\nNative-host registration is not supported on '${platform}'; skipping.\n`);
+        }
+    }
+    nextSteps();
+    return 0;
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/sessions.d.ts

@@ -0,0 +1,3 @@
+/** Entry for `peek sessions ...`; `argv` excludes the `sessions` token. */
+export declare function runSessions(argv: string[]): number;
+//# sourceMappingURL=sessions.d.ts.map

package/dist/commands/sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.d.ts","sourceRoot":"","sources":["../../src/commands/sessions.ts"],"names":[],"mappings":"AAyNA,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAuBlD"}

package/dist/commands/sessions.js

@@ -0,0 +1,214 @@
+// `peek sessions <list|show|export|delete>` command shell (Task 3.8, P2 PRD
+// §C.1). Opens the shared DB read-mostly via @peekdev/mcp's openDb, runs the
+// pure query/format helpers, and prints / writes. Arg parsing uses the built-in
+// node:util parseArgs (no dependency).
+import { writeFileSync } from 'node:fs';
+import { parseArgs } from 'node:util';
+import { openDb } from '@peekdev/mcp/db';
+import { deleteSession, deleteSessionsOlderThan, getSessionDetail, listSessions, } from '../lib/db.js';
+import { cutoffBefore } from '../lib/duration.js';
+import { EXPORT_FORMATS, formatSession, isExportFormat, } from '../lib/format/index.js';
+import { formatBytes, pad } from '../lib/output.js';
+import { defaultDbPath } from '../lib/peek-home.js';
+/** Open the shared DB for reading (migrations applied so a fresh DB is valid). */
+function open() {
+    return openDb({ path: defaultDbPath() });
+}
+function printUsage() {
+    process.stdout.write([
+        'Usage: peek sessions <command>',
+        '',
+        'Commands:',
+        '  list [--origin <url>] [--limit 20]   List recent sessions (newest first)',
+        '  show <session-id>                    Show one session (metadata + errors)',
+        `  export <session-id> --format <${EXPORT_FORMATS.join('|')}> [--out <file>]`,
+        '  delete <session-id>                  Delete one session',
+        '  delete --all-older-than <dur>        Delete sessions older than e.g. 7d',
+        '',
+    ].join('\n'));
+}
+function runList(argv) {
+    const { values } = parseArgs({
+        args: argv,
+        options: {
+            origin: { type: 'string' },
+            limit: { type: 'string' },
+        },
+        allowPositionals: false,
+    });
+    const limit = values.limit !== undefined ? Number(values.limit) : 20;
+    if (!Number.isInteger(limit) || limit <= 0) {
+        process.stderr.write('peek sessions list: --limit must be a positive integer\n');
+        return 1;
+    }
+    const db = open();
+    try {
+        const rows = listSessions(db, {
+            limit,
+            ...(values.origin !== undefined ? { origin: values.origin } : {}),
+        });
+        if (rows.length === 0) {
+            process.stdout.write('No sessions recorded yet.\n');
+            return 0;
+        }
+        process.stdout.write(`${pad('ID', 22)}${pad('UPDATED', 26)}${pad('EVENTS', 9)}${pad('SIZE', 11)}ORIGIN\n`);
+        for (const s of rows) {
+            process.stdout.write(`${pad(s.id, 22)}${pad(s.updatedAt, 26)}${pad(String(s.eventCount), 9)}${pad(formatBytes(s.bytes), 11)}${s.origin ?? '(unknown)'}\n`);
+        }
+        return 0;
+    }
+    finally {
+        db.close();
+    }
+}
+function runShow(argv) {
+    const { positionals } = parseArgs({ args: argv, allowPositionals: true, options: {} });
+    const id = positionals[0];
+    if (!id) {
+        process.stderr.write('peek sessions show: missing <session-id>\n');
+        return 1;
+    }
+    const db = open();
+    try {
+        const detail = getSessionDetail(db, id);
+        if (!detail) {
+            process.stderr.write(`peek sessions show: no session with id '${id}'\n`);
+            return 1;
+        }
+        // `show` reuses the markdown formatter — it's the human + AI-readable view.
+        const result = formatSession(detail, 'markdown');
+        if (result.ok)
+            process.stdout.write(result.content);
+        return 0;
+    }
+    finally {
+        db.close();
+    }
+}
+function runExport(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            format: { type: 'string' },
+            out: { type: 'string' },
+        },
+        allowPositionals: true,
+    });
+    const id = positionals[0];
+    if (!id) {
+        process.stderr.write('peek sessions export: missing <session-id>\n');
+        return 1;
+    }
+    const formatRaw = values.format ?? 'markdown';
+    if (!isExportFormat(formatRaw)) {
+        process.stderr.write(`peek sessions export: invalid --format '${formatRaw}' (expected ${EXPORT_FORMATS.join('|')})\n`);
+        return 1;
+    }
+    const format = formatRaw;
+    const db = open();
+    try {
+        const detail = getSessionDetail(db, id);
+        if (!detail) {
+            process.stderr.write(`peek sessions export: no session with id '${id}'\n`);
+            return 1;
+        }
+        const result = formatSession(detail, format);
+        if (!result.ok) {
+            // html / playwright stubs: clear message, non-zero exit (never write a
+            // partial file).
+            process.stderr.write(`peek sessions export: ${result.message}\n`);
+            return 2;
+        }
+        if (values.out !== undefined) {
+            writeFileSync(values.out, result.content, 'utf8');
+            process.stdout.write(`Wrote ${format} export to ${values.out}\n`);
+        }
+        else {
+            process.stdout.write(result.content);
+        }
+        return 0;
+    }
+    finally {
+        db.close();
+    }
+}
+function runDelete(argv) {
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: {
+            'all-older-than': { type: 'string' },
+        },
+        allowPositionals: true,
+    });
+    const olderThan = values['all-older-than'];
+    const id = positionals[0];
+    if (olderThan !== undefined && id !== undefined) {
+        process.stderr.write('peek sessions delete: pass either <session-id> OR --all-older-than\n');
+        return 1;
+    }
+    const db = open();
+    try {
+        if (olderThan !== undefined) {
+            let cutoffIso;
+            try {
+                const cutoffMs = cutoffBefore(olderThan);
+                // parseDuration accepts any integer, so a huge duration (e.g. `17200000w`)
+                // yields a finite-but-out-of-range cutoff; `new Date(...).toISOString()`
+                // would throw RangeError. Guard before converting (the JS Date floor is
+                // -8.64e15 ms) so the failure is a clean message, not a stack trace.
+                if (!Number.isFinite(cutoffMs) || cutoffMs < -8_640_000_000_000_000) {
+                    process.stderr.write(`peek sessions delete: duration '${olderThan}' is too large\n`);
+                    return 1;
+                }
+                cutoffIso = new Date(cutoffMs).toISOString();
+            }
+            catch (err) {
+                process.stderr.write(`peek sessions delete: ${err instanceof Error ? err.message : String(err)}\n`);
+                return 1;
+            }
+            const removed = deleteSessionsOlderThan(db, cutoffIso);
+            process.stdout.write(`Deleted ${removed} session(s) older than ${olderThan}.\n`);
+            return 0;
+        }
+        if (id === undefined) {
+            process.stderr.write('peek sessions delete: missing <session-id> or --all-older-than\n');
+            return 1;
+        }
+        const removed = deleteSession(db, id);
+        if (removed === 0) {
+            process.stderr.write(`peek sessions delete: no session with id '${id}'\n`);
+            return 1;
+        }
+        process.stdout.write(`Deleted session ${id}.\n`);
+        return 0;
+    }
+    finally {
+        db.close();
+    }
+}
+/** Entry for `peek sessions ...`; `argv` excludes the `sessions` token. */
+export function runSessions(argv) {
+    const sub = argv[0];
+    const rest = argv.slice(1);
+    switch (sub) {
+        case 'list':
+            return runList(rest);
+        case 'show':
+            return runShow(rest);
+        case 'export':
+            return runExport(rest);
+        case 'delete':
+            return runDelete(rest);
+        case undefined:
+        case 'help':
+        case '--help':
+        case '-h':
+            printUsage();
+            return sub === undefined ? 1 : 0;
+        default:
+            process.stderr.write(`peek sessions: unknown subcommand '${sub}'\n`);
+            printUsage();
+            return 1;
+    }
+}
+//# sourceMappingURL=sessions.js.map

package/dist/commands/sessions.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,2 @@
+export declare function runStatus(): number;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAkEA,wBAAgB,SAAS,IAAI,MAAM,CAoClC"}

package/dist/commands/status.js

@@ -0,0 +1,88 @@
+// `peek status` command shell (Task 3.7). Wires the real filesystem/platform
+// probes into the pure `gatherStatus`, then prints. Reports native-host
+// manifest install state, DB path + size + schema version, and the (best-effort)
+// extension connection state.
+import { existsSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { openDb } from '@peekdev/mcp/db';
+import { loadExtensionIds, resolveInstallTargets, } from '@peekdev/mcp/native-host';
+import { formatBytes } from '../lib/output.js';
+import { defaultDbPath } from '../lib/peek-home.js';
+import { gatherStatus } from '../lib/status.js';
+const SUPPORTED = ['darwin', 'linux', 'win32'];
+function fileSize(path) {
+    try {
+        return statSync(path).size;
+    }
+    catch {
+        return null;
+    }
+}
+function renderStatus(report) {
+    const lines = [];
+    lines.push('peek status');
+    lines.push('');
+    lines.push('Database (~/.peek/sessions.db):');
+    lines.push(`  path:    ${report.dbPath}`);
+    if (report.dbExists) {
+        lines.push(`  size:    ${formatBytes(report.dbBytes)}`);
+        lines.push(`  schema:  v${report.schemaVersion ?? '?'}`);
+        lines.push(`  sessions: ${report.sessionCount ?? '?'}`);
+    }
+    else {
+        lines.push('  size:    (not created yet — record a session to initialize)');
+    }
+    lines.push('');
+    lines.push('Native messaging host:');
+    lines.push(`  binary:  ${report.hostBinaryPath}`);
+    lines.push(report.anyManifestInstalled
+        ? '  status:  registered'
+        : '  status:  not registered (run `peek init` to register with consent)');
+    for (const t of report.manifestTargets) {
+        const mark = t.installed ? '✔' : '·';
+        lines.push(`    ${mark} ${t.browser}: ${t.location}`);
+    }
+    lines.push('');
+    lines.push('Browser extension:');
+    const conn = report.extensionConnection === 'unknown'
+        ? 'unknown (connection check requires the extension; see https://github.com/Cubenest/rrweb-stack)'
+        : report.extensionConnection;
+    lines.push(`  connection: ${conn}`);
+    return lines.join('\n');
+}
+export function runStatus() {
+    const platform = process.platform;
+    if (!SUPPORTED.includes(platform)) {
+        process.stdout.write(`peek status: unsupported platform '${platform}'.\n`);
+        return 0;
+    }
+    const home = homedir();
+    const dbPath = defaultDbPath();
+    let extensionIds;
+    try {
+        extensionIds = loadExtensionIds();
+    }
+    catch {
+        // The published extension-ids.json may be unreadable in a partial install;
+        // fall back to placeholders so status still renders the rest.
+        extensionIds = { chromeWebStore: '', edgeAddons: '', dev: '' };
+    }
+    const report = gatherStatus({
+        dbPath,
+        fileSize,
+        fileExists: existsSync,
+        manifestTargets: resolveInstallTargets(platform, home),
+        extensionIds,
+        openDb: () => {
+            try {
+                return openDb({ path: dbPath, skipMigrations: true });
+            }
+            catch {
+                return null;
+            }
+        },
+    });
+    process.stdout.write(`${renderStatus(report)}\n`);
+    return 0;
+}
+//# sourceMappingURL=status.js.map