@peekdev/cli 0.1.0-alpha.1

package/dist/commands/status.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function run(argv: readonly string[]): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAqCA,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BlE"}

package/dist/index.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+// `peek` CLI entry (Task 3.6). A thin read-mostly client of the native host's
+// ~/.peek/sessions.db (ADR-0007). Dispatches to the command shells:
+//   peek status
+//   peek sessions <list|show|export|delete>
+//   peek init
+//   peek audit log
+//
+// Arg parsing uses the built-in node:util parseArgs at each command boundary
+// (no CLI framework dependency); this top-level dispatcher just routes on the
+// first positional so each subcommand owns its own option schema.
+import { runAudit } from './commands/audit.js';
+import { runInit } from './commands/init.js';
+import { runSessions } from './commands/sessions.js';
+import { runStatus } from './commands/status.js';
+import { CLI_VERSION } from './version.js';
+const HELP = `peek ${CLI_VERSION} — browser-session companion CLI
+
+Usage: peek <command> [options]
+
+Commands:
+  status                       Native-host registration, DB size + schema, extension state
+  sessions list                List recent sessions
+  sessions show <id>           Show one session (metadata + console/network errors)
+  sessions export <id>         Export a session (--format markdown|json|html|playwright)
+  sessions delete <id>         Delete a session (or --all-older-than <dur>)
+  init                         Interactive wizard: configure MCP clients + native host
+  audit log                    Show the act-tool audit log (--since/--tool/--client)
+
+Run \`peek <command> --help\` for command-specific options.
+
+The native messaging host (@peekdev/mcp) owns the database; this CLI reads it.
+Set PEEK_HOME to relocate ~/.peek. Docs: https://github.com/Cubenest/rrweb-stack
+`;
+export async function run(argv) {
+    const [command, ...rest] = argv;
+    switch (command) {
+        case 'status':
+            return runStatus();
+        case 'sessions':
+            return runSessions(rest);
+        case 'audit':
+            return runAudit(rest);
+        case 'init':
+            return runInit(rest);
+        case 'version':
+        case '--version':
+        case '-v':
+            process.stdout.write(`${CLI_VERSION}\n`);
+            return 0;
+        case undefined:
+        case 'help':
+        case '--help':
+        case '-h':
+            process.stdout.write(HELP);
+            // No command given is a usage error (exit 1); explicit help is success.
+            return command === undefined ? 1 : 0;
+        default:
+            process.stderr.write(`peek: unknown command '${command}'\n\n`);
+            process.stdout.write(HELP);
+            return 1;
+    }
+}
+async function main() {
+    const code = await run(process.argv.slice(2));
+    process.exitCode = code;
+}
+// Run only when invoked directly as the `peek` bin (npx / shell), not when this
+// module is imported (tests, or another package consuming `run`). Guarded the
+// same way as @peekdev/mcp's entry so an ESM `import` has no side effects.
+const invokedDirectly = process.argv[1] !== undefined && import.meta.url === `file://${process.argv[1]}`;
+if (invokedDirectly) {
+    main().catch((err) => {
+        process.stderr.write(`peek: fatal — ${err instanceof Error ? (err.stack ?? err.message) : String(err)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,8EAA8E;AAC9E,oEAAoE;AACpE,gBAAgB;AAChB,4CAA4C;AAC5C,cAAc;AACd,mBAAmB;AACnB,EAAE;AACF,6EAA6E;AAC7E,8EAA8E;AAC9E,kEAAkE;AAElE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,IAAI,GAAG,QAAQ,WAAW;;;;;;;;;;;;;;;;;CAiB/B,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAEhC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,SAAS,EAAE,CAAC;QACrB,KAAK,UAAU;YACb,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,KAAK,OAAO;YACV,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC;QACvB,KAAK,SAAS,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,WAAW,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,CAAC;QACX,KAAK,SAAS,CAAC;QACf,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,wEAAwE;YACxE,OAAO,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC;YACE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,OAAO,CAAC,CAAC;YAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC;AAED,gFAAgF;AAChF,8EAA8E;AAC9E,2EAA2E;AAC3E,MAAM,eAAe,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,UAAU,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACnF,IAAI,eAAe,EAAE,CAAC;IACpB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CACrF,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/audit.d.ts

@@ -0,0 +1,47 @@
+/** One parsed audit entry. Unknown extra fields are preserved verbatim. */
+export interface AuditEntry {
+    readonly ts: string;
+    readonly tool?: string;
+    readonly args?: unknown;
+    readonly approvalTs?: string;
+    readonly approver?: string;
+    readonly client?: string;
+    readonly sessionId?: string;
+    readonly result?: string;
+    readonly [extra: string]: unknown;
+}
+/** A line that did not parse as JSON, kept with its 1-based line number. */
+export interface AuditParseError {
+    readonly line: number;
+    readonly raw: string;
+    readonly error: string;
+}
+export interface ParsedAuditLog {
+    readonly entries: AuditEntry[];
+    readonly errors: AuditParseError[];
+}
+/**
+ * Parse the raw JSONL contents of an audit log. Blank lines are skipped; each
+ * non-blank line must be a JSON object with a string `ts`. Lines that fail to
+ * parse (or aren't objects/lack `ts`) are collected in `errors` rather than
+ * thrown, so a single corrupt line doesn't hide the rest of the log.
+ */
+export declare function parseAuditLog(contents: string): ParsedAuditLog;
+export interface AuditFilter {
+    /**
+     * Only entries at/after this instant (epoch ms). Derived from `--since 1h`
+     * via the duration parser by the command shell.
+     */
+    readonly sinceMs?: number;
+    /** Exact `tool` match (e.g. `execute_action`). */
+    readonly tool?: string;
+    /** Exact `client` match (e.g. `cursor`, `claude-code`). */
+    readonly client?: string;
+}
+/**
+ * Filter parsed audit entries by `--since` / `--tool` / `--client`. An entry
+ * with an unparseable `ts` is dropped only when a `sinceMs` filter is active
+ * (it can't satisfy a time bound); otherwise all filters are exact-match.
+ */
+export declare function filterAuditEntries(entries: AuditEntry[], filter: AuditFilter): AuditEntry[];
+//# sourceMappingURL=audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/lib/audit.ts"],"names":[],"mappings":"AASA,2EAA2E;AAC3E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,4EAA4E;AAC5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAiC9D;AAED,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,EAAE,CAU3F"}

package/dist/lib/audit.js

@@ -0,0 +1,68 @@
+// `peek audit log` (ADR-0010 / P2 PRD §H3). The native host / extension append
+// one JSONL line per AI-driven act-tool call to ~/.peek/audit.log:
+//   { "ts":"2026-05-23T10:14:22Z", "tool":"execute_action",
+//     "args":{...}, "approvalTs":"...", "approver":"user",
+//     "client":"claude-code", "sessionId":"s_8nQ…", "result":"ok" }
+// This module is pure: parse + filter operate on strings/objects, so the file
+// read and stdout write stay a thin shell. Malformed lines are surfaced, not
+// silently dropped (an unparseable audit line is itself notable).
+/**
+ * Parse the raw JSONL contents of an audit log. Blank lines are skipped; each
+ * non-blank line must be a JSON object with a string `ts`. Lines that fail to
+ * parse (or aren't objects/lack `ts`) are collected in `errors` rather than
+ * thrown, so a single corrupt line doesn't hide the rest of the log.
+ */
+export function parseAuditLog(contents) {
+    const entries = [];
+    const errors = [];
+    const lines = contents.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i] ?? '';
+        const trimmed = raw.trim();
+        if (trimmed.length === 0)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(trimmed);
+        }
+        catch (err) {
+            errors.push({
+                line: i + 1,
+                raw: trimmed,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            continue;
+        }
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            errors.push({ line: i + 1, raw: trimmed, error: 'not a JSON object' });
+            continue;
+        }
+        const obj = parsed;
+        if (typeof obj.ts !== 'string') {
+            errors.push({ line: i + 1, raw: trimmed, error: 'missing string "ts"' });
+            continue;
+        }
+        entries.push(obj);
+    }
+    return { entries, errors };
+}
+/**
+ * Filter parsed audit entries by `--since` / `--tool` / `--client`. An entry
+ * with an unparseable `ts` is dropped only when a `sinceMs` filter is active
+ * (it can't satisfy a time bound); otherwise all filters are exact-match.
+ */
+export function filterAuditEntries(entries, filter) {
+    return entries.filter((e) => {
+        if (filter.tool !== undefined && e.tool !== filter.tool)
+            return false;
+        if (filter.client !== undefined && e.client !== filter.client)
+            return false;
+        if (filter.sinceMs !== undefined) {
+            const tsMs = Date.parse(e.ts);
+            if (Number.isNaN(tsMs) || tsMs < filter.sinceMs)
+                return false;
+        }
+        return true;
+    });
+}
+//# sourceMappingURL=audit.js.map

package/dist/lib/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/lib/audit.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,mEAAmE;AACnE,4DAA4D;AAC5D,2DAA2D;AAC3D,oEAAoE;AACpE,8EAA8E;AAC9E,6EAA6E;AAC7E,kEAAkE;AA2BlE;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAgB;IAC5C,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,CAAC,GAAG,CAAC;gBACX,GAAG,EAAE,OAAO;gBACZ,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3E,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAC;YACvE,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,MAAiC,CAAC;QAC9C,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAC;YACzE,SAAS;QACX,CAAC;QACD,OAAO,CAAC,IAAI,CAAC,GAAiB,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC;AAcD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB,EAAE,MAAmB;IAC3E,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI;YAAE,OAAO,KAAK,CAAC;QACtE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAC5E,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC,OAAO;gBAAE,OAAO,KAAK,CAAC;QAChE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/db.d.ts

@@ -0,0 +1,86 @@
+import type { Database } from 'better-sqlite3';
+/** A row of the `sessions` table, as the CLI presents it. */
+export interface SessionRow {
+    readonly id: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    readonly url: string | null;
+    readonly title: string | null;
+    readonly origin: string | null;
+    readonly userAgent: string | null;
+    readonly eventCount: number;
+    readonly bytes: number;
+    readonly status: string;
+}
+/** A console message extracted for a session (mirrors `get_session_console_errors`). */
+export interface ConsoleEventRow {
+    readonly ts: number;
+    readonly level: string;
+    readonly message: string;
+    readonly stack: string | null;
+    readonly url: string | null;
+}
+/** A network request captured for a session (mirrors `get_session_network_errors`). */
+export interface NetworkEventRow {
+    readonly ts: number;
+    readonly method: string;
+    readonly url: string;
+    readonly status: number | null;
+    readonly statusText: string | null;
+    readonly resourceType: string | null;
+    readonly durationMs: number | null;
+    readonly errorText: string | null;
+}
+/** Per-session aggregate counts used by `peek sessions list` / the summary header. */
+export interface SessionCounts {
+    readonly consoleErrors: number;
+    readonly networkErrors: number;
+}
+/** A fully-hydrated session for `show` / `export` (metadata + extracted rows). */
+export interface SessionDetail {
+    readonly session: SessionRow;
+    readonly counts: SessionCounts;
+    readonly consoleErrors: ConsoleEventRow[];
+    readonly networkErrors: NetworkEventRow[];
+}
+export interface ListSessionsOptions {
+    /** Max rows (default 20, per P2 PRD §C.1). */
+    readonly limit?: number;
+    /** Filter to a single origin (`scheme://host[:port]`). */
+    readonly origin?: string;
+}
+/**
+ * List the most-recently-updated sessions, newest first. Default limit 20
+ * (P2 PRD §C.1 `peek sessions list [--origin <url>] [--limit 20]`).
+ */
+export declare function listSessions(db: Database, options?: ListSessionsOptions): SessionRow[];
+/** Fetch one session's metadata, or `undefined` if no such id. */
+export declare function getSession(db: Database, id: string): SessionRow | undefined;
+/** Count error-level console rows and >=400 network rows for a session. */
+export declare function getSessionCounts(db: Database, id: string): SessionCounts;
+export interface ConsoleQueryOptions {
+    /** Only `level = 'error'` rows (the default for export/summary). */
+    readonly errorsOnly?: boolean;
+    /** Max rows (default 50, mirrors the MCP tool). */
+    readonly limit?: number;
+}
+/** Console messages for a session, oldest first. */
+export declare function getConsoleEvents(db: Database, id: string, options?: ConsoleQueryOptions): ConsoleEventRow[];
+export interface NetworkQueryOptions {
+    /** Minimum HTTP status to include (default 400 — failures only). */
+    readonly statusGte?: number;
+    /** Max rows (default 50). */
+    readonly limit?: number;
+}
+/** Failed/notable network requests for a session, oldest first. */
+export declare function getNetworkEvents(db: Database, id: string, options?: NetworkQueryOptions): NetworkEventRow[];
+/** Hydrate one session fully for `show` / `export`. Returns `undefined` if no such id. */
+export declare function getSessionDetail(db: Database, id: string): SessionDetail | undefined;
+/** Delete one session by id. Child rows cascade (ON DELETE CASCADE). Returns rows removed (0 or 1). */
+export declare function deleteSession(db: Database, id: string): number;
+/**
+ * Delete every session whose `updated_at` is strictly before the ISO cutoff.
+ * Returns the number of sessions removed (child rows cascade).
+ */
+export declare function deleteSessionsOlderThan(db: Database, cutoffIso: string): number;
+//# sourceMappingURL=db.d.ts.map

package/dist/lib/db.d.ts.map

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

package/dist/lib/db.js

@@ -0,0 +1,117 @@
+// Read-mostly query helpers over the native host's ~/.peek/sessions.db. The CLI
+// opens the same SQLite file through @peekdev/mcp's `openDb` (WAL + FK pragmas,
+// migration state) — it never reimplements the DB layer (ADR-0007). The native
+// host writes; the CLI lists / shows / exports / deletes.
+//
+// The returned shapes deliberately mirror the MCP tool return schema (P2 PRD
+// §B3) so `peek sessions export --format json` and the MCP `get_session_*`
+// tools are interchangeable for an AI consumer.
+function mapSession(r) {
+    return {
+        id: r.id,
+        createdAt: r.created_at,
+        updatedAt: r.updated_at,
+        url: r.url,
+        title: r.title,
+        origin: r.origin,
+        userAgent: r.user_agent,
+        eventCount: r.event_count,
+        bytes: r.bytes,
+        status: r.status,
+    };
+}
+/**
+ * List the most-recently-updated sessions, newest first. Default limit 20
+ * (P2 PRD §C.1 `peek sessions list [--origin <url>] [--limit 20]`).
+ */
+export function listSessions(db, options = {}) {
+    const limit = options.limit ?? 20;
+    const params = [];
+    let sql = 'SELECT * FROM sessions';
+    if (options.origin !== undefined) {
+        sql += ' WHERE origin = ?';
+        params.push(options.origin);
+    }
+    sql += ' ORDER BY updated_at DESC, created_at DESC LIMIT ?';
+    params.push(limit);
+    const rows = db.prepare(sql).all(...params);
+    return rows.map(mapSession);
+}
+/** Fetch one session's metadata, or `undefined` if no such id. */
+export function getSession(db, id) {
+    const row = db.prepare('SELECT * FROM sessions WHERE id = ?').get(id);
+    return row ? mapSession(row) : undefined;
+}
+/** Count error-level console rows and >=400 network rows for a session. */
+export function getSessionCounts(db, id) {
+    const consoleErrors = db
+        .prepare("SELECT COUNT(*) AS c FROM console_events WHERE session_id = ? AND level = 'error'")
+        .get(id).c;
+    const networkErrors = db
+        .prepare('SELECT COUNT(*) AS c FROM network_events WHERE session_id = ? AND (status >= 400 OR error_text IS NOT NULL)')
+        .get(id).c;
+    return { consoleErrors, networkErrors };
+}
+/** Console messages for a session, oldest first. */
+export function getConsoleEvents(db, id, options = {}) {
+    const limit = options.limit ?? 50;
+    let sql = 'SELECT ts_ms, level, message, stack, url FROM console_events WHERE session_id = ?';
+    if (options.errorsOnly)
+        sql += " AND level = 'error'";
+    sql += ' ORDER BY ts_ms ASC LIMIT ?';
+    const rows = db.prepare(sql).all(id, limit);
+    return rows.map((r) => ({
+        ts: r.ts_ms,
+        level: r.level,
+        message: r.message,
+        stack: r.stack,
+        url: r.url,
+    }));
+}
+/** Failed/notable network requests for a session, oldest first. */
+export function getNetworkEvents(db, id, options = {}) {
+    const statusGte = options.statusGte ?? 400;
+    const limit = options.limit ?? 50;
+    const rows = db
+        .prepare(`SELECT ts_ms, method, url, status, status_text, resource_type, duration_ms, error_text
+         FROM network_events
+        WHERE session_id = ? AND (status >= ? OR error_text IS NOT NULL)
+        ORDER BY ts_ms ASC LIMIT ?`)
+        .all(id, statusGte, limit);
+    return rows.map((r) => ({
+        ts: r.ts_ms,
+        method: r.method,
+        url: r.url,
+        status: r.status,
+        statusText: r.status_text,
+        resourceType: r.resource_type,
+        durationMs: r.duration_ms,
+        errorText: r.error_text,
+    }));
+}
+/** Hydrate one session fully for `show` / `export`. Returns `undefined` if no such id. */
+export function getSessionDetail(db, id) {
+    const session = getSession(db, id);
+    if (!session)
+        return undefined;
+    return {
+        session,
+        counts: getSessionCounts(db, id),
+        consoleErrors: getConsoleEvents(db, id, { errorsOnly: true }),
+        networkErrors: getNetworkEvents(db, id),
+    };
+}
+/** Delete one session by id. Child rows cascade (ON DELETE CASCADE). Returns rows removed (0 or 1). */
+export function deleteSession(db, id) {
+    const info = db.prepare('DELETE FROM sessions WHERE id = ?').run(id);
+    return info.changes;
+}
+/**
+ * Delete every session whose `updated_at` is strictly before the ISO cutoff.
+ * Returns the number of sessions removed (child rows cascade).
+ */
+export function deleteSessionsOlderThan(db, cutoffIso) {
+    const info = db.prepare('DELETE FROM sessions WHERE updated_at < ?').run(cutoffIso);
+    return info.changes;
+}
+//# sourceMappingURL=db.js.map

package/dist/lib/db.js.map

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

package/dist/lib/duration.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parse a short duration string (`30s`, `15m`, `1h`, `7d`, `2w`) into
+ * milliseconds. The numeric part must be a non-negative integer; the unit is
+ * one of s/m/h/d/w (case-insensitive). Throws a user-facing `Error` on anything
+ * else so the caller can print it and exit non-zero.
+ */
+export declare function parseDuration(input: string): number;
+/**
+ * Resolve a duration into an absolute "older than" cutoff timestamp (epoch ms):
+ * everything strictly before the returned instant is "older than" the duration.
+ * `now` is injectable for deterministic tests.
+ */
+export declare function cutoffBefore(input: string, now?: number): number;
+//# sourceMappingURL=duration.d.ts.map

package/dist/lib/duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../src/lib/duration.ts"],"names":[],"mappings":"AAgBA;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAcnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAE5E"}

package/dist/lib/duration.js

@@ -0,0 +1,41 @@
+// Pure duration parsing for `--since 1h` / `--all-older-than 7d` (P2 PRD §C.1,
+// §H3). Accepts a short human duration and returns milliseconds. Kept pure +
+// dependency-free so it can be unit-tested exhaustively; the commands that use
+// it derive an absolute cutoff via `Date.now() - parseDuration(...)`.
+/** Suffix → milliseconds multiplier. */
+const UNIT_MS = {
+    s: 1000,
+    m: 60 * 1000,
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+    w: 7 * 24 * 60 * 60 * 1000,
+};
+const DURATION_RE = /^(\d+)\s*([smhdw])$/;
+/**
+ * Parse a short duration string (`30s`, `15m`, `1h`, `7d`, `2w`) into
+ * milliseconds. The numeric part must be a non-negative integer; the unit is
+ * one of s/m/h/d/w (case-insensitive). Throws a user-facing `Error` on anything
+ * else so the caller can print it and exit non-zero.
+ */
+export function parseDuration(input) {
+    const trimmed = input.trim().toLowerCase();
+    const match = DURATION_RE.exec(trimmed);
+    if (!match) {
+        throw new Error(`invalid duration "${input}" — expected a number followed by s, m, h, d, or w (e.g. 30m, 1h, 7d)`);
+    }
+    // match[1]/match[2] are guaranteed present by the regex shape above, and the
+    // unit is restricted to [smhdw] — every one a key of UNIT_MS.
+    const value = Number(match[1]);
+    const unit = match[2];
+    const multiplier = UNIT_MS[unit] ?? 0;
+    return value * multiplier;
+}
+/**
+ * Resolve a duration into an absolute "older than" cutoff timestamp (epoch ms):
+ * everything strictly before the returned instant is "older than" the duration.
+ * `now` is injectable for deterministic tests.
+ */
+export function cutoffBefore(input, now = Date.now()) {
+    return now - parseDuration(input);
+}
+//# sourceMappingURL=duration.js.map

package/dist/lib/duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duration.js","sourceRoot":"","sources":["../../src/lib/duration.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,sEAAsE;AAEtE,wCAAwC;AACxC,MAAM,OAAO,GAA2B;IACtC,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,EAAE,GAAG,IAAI;IACZ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IACjB,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;CAC3B,CAAC;AAEF,MAAM,WAAW,GAAG,qBAAqB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CACb,qBAAqB,KAAK,uEAAuE,CAClG,CAAC;IACJ,CAAC;IACD,6EAA6E;IAC7E,8DAA8D;IAC9D,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAW,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAyB,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,OAAO,KAAK,GAAG,UAAU,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;IAClE,OAAO,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC"}

package/dist/lib/format/index.d.ts

@@ -0,0 +1,16 @@
+import type { SessionDetail } from '../db.js';
+/** Supported `--format` values (P2 PRD §C.1). */
+export declare const EXPORT_FORMATS: readonly ["markdown", "json", "html", "playwright"];
+export type ExportFormat = (typeof EXPORT_FORMATS)[number];
+export declare function isExportFormat(value: string): value is ExportFormat;
+/** Result of rendering: either content to write, or a not-implemented message. */
+export type FormatResult = {
+    readonly ok: true;
+    readonly content: string;
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/** Render a hydrated session in the requested format. */
+export declare function formatSession(detail: SessionDetail, format: ExportFormat): FormatResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/format/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C,iDAAiD;AACjD,eAAO,MAAM,cAAc,qDAAsD,CAAC;AAClF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD,yDAAyD;AACzD,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,YAAY,CAuBvF"}

package/dist/lib/format/index.js

@@ -0,0 +1,43 @@
+// Export-format dispatch (P2 PRD §C.3). `markdown` and `json` are implemented
+// fully (self-contained AI-paste formats read straight from the extracted SQL
+// rows). `html` (self-contained rrweb replay) and `playwright` (repro
+// boilerplate) are deferred:
+//   - html would require bundling an rrweb player inline; importing
+//     @tracelane/report is explicitly forbidden (ADR-0001 product independence),
+//     so a peek-specific viewer is a tracked follow-up.
+//   - playwright overlaps the MCP `generate_playwright_repro` tool (Phase 3c
+//     Task 3.13); the repro walker should live there and be shared, rather than
+//     forked here. Tracked follow-up.
+// The stubs return a non-ok result so the command shell exits non-zero with a
+// clear message (never silently emit an empty/partial file).
+import { formatSessionJson } from './json.js';
+import { formatSessionMarkdown } from './markdown.js';
+/** Supported `--format` values (P2 PRD §C.1). */
+export const EXPORT_FORMATS = ['markdown', 'json', 'html', 'playwright'];
+export function isExportFormat(value) {
+    return EXPORT_FORMATS.includes(value);
+}
+/** Render a hydrated session in the requested format. */
+export function formatSession(detail, format) {
+    switch (format) {
+        case 'markdown':
+            return { ok: true, content: formatSessionMarkdown(detail) };
+        case 'json':
+            return { ok: true, content: formatSessionJson(detail) };
+        case 'html':
+            return {
+                ok: false,
+                message: "export format 'html' is not yet implemented (a peek-specific self-contained " +
+                    'rrweb replay viewer is tracked for a follow-up; @tracelane/report is intentionally ' +
+                    'not reused — ADR-0001 product independence). Use --format markdown or json.',
+            };
+        case 'playwright':
+            return {
+                ok: false,
+                message: "export format 'playwright' is not yet implemented (the repro generator overlaps the " +
+                    'MCP `generate_playwright_repro` tool, Phase 3c Task 3.13, and will share that walker). ' +
+                    'Use --format markdown or json.',
+            };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/format/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/format/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,sEAAsE;AACtE,6BAA6B;AAC7B,oEAAoE;AACpE,iFAAiF;AACjF,wDAAwD;AACxD,6EAA6E;AAC7E,gFAAgF;AAChF,sCAAsC;AACtC,8EAA8E;AAC9E,6DAA6D;AAG7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,CAAU,CAAC;AAGlF,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,OAAQ,cAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAOD,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAAC,MAAqB,EAAE,MAAoB;IACvE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9D,KAAK,MAAM;YACT,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1D,KAAK,MAAM;YACT,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EACL,8EAA8E;oBAC9E,qFAAqF;oBACrF,6EAA6E;aAChF,CAAC;QACJ,KAAK,YAAY;YACf,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EACL,sFAAsF;oBACtF,yFAAyF;oBACzF,gCAAgC;aACnC,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/lib/format/json.d.ts

@@ -0,0 +1,35 @@
+import type { SessionDetail } from '../db.js';
+/** The JSON export envelope. Field names mirror the MCP tool return shapes. */
+export interface SessionJsonExport {
+    readonly id: string;
+    readonly origin: string | null;
+    readonly url: string | null;
+    readonly title: string | null;
+    readonly startedAt: string;
+    readonly updatedAt: string;
+    readonly status: string;
+    readonly eventCount: number;
+    readonly bytes: number;
+    readonly errorCount: number;
+    readonly consoleErrors: ReadonlyArray<{
+        ts: number;
+        level: string;
+        message: string;
+        stack: string | null;
+    }>;
+    readonly networkErrors: ReadonlyArray<{
+        ts: number;
+        method: string;
+        url: string;
+        status: number | null;
+        statusText: string | null;
+        resourceType: string | null;
+        durationMs: number | null;
+        errorText: string | null;
+    }>;
+}
+/** Build the JSON export object (pure; not yet stringified). */
+export declare function toJsonExport(detail: SessionDetail): SessionJsonExport;
+/** Render a session as a pretty-printed JSON string (2-space indent). */
+export declare function formatSessionJson(detail: SessionDetail): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/lib/format/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/lib/format/json.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACpC,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC,CAAC;IACH,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;QACpC,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;KAC1B,CAAC,CAAC;CACJ;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,iBAAiB,CA8BrE;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE/D"}