@peekdev/cli 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/lib/peek-home.js

@@ -8,4 +8,14 @@ export { defaultDbPath, peekHomeDir };
 export function auditLogPath() {
     return join(peekHomeDir(), 'audit.log');
 }
+/**
+ * Base directory for gzipped rrweb event chunks (ADR-0007): `~/.peek/rrweb-events/`.
+ * Each session has a subdirectory `<sessionId>/` with one `<seq>.json.gz` per
+ * append batch. Mirrors `rrwebEventsDir()` in peek-mcp's `mcp/event-blobs.ts`;
+ * the path layout is the public contract between writer (native host) and
+ * reader/cleaner (this CLI).
+ */
+export function rrwebEventsDir() {
+    return join(peekHomeDir(), 'rrweb-events');
+}
 //# sourceMappingURL=peek-home.js.map

package/dist/lib/peek-home.js.map

@@ -1 +1 @@
-{"version":3,"file":"peek-home.js","sourceRoot":"","sources":["../../src/lib/peek-home.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,wDAAwD;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAEtC,gFAAgF;AAChF,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"peek-home.js","sourceRoot":"","sources":["../../src/lib/peek-home.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,wDAAwD;AAExD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAEtC,gFAAgF;AAChF,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC"}

package/dist/lib/prompt.d.ts

@@ -22,4 +22,17 @@ export interface Choice<T> {
 export declare function multiSelect<T>(message: string, choices: Choice<T>[]): Promise<T[]>;
 /** Yes/no confirm. `defaultYes` controls the [Y/n] vs [y/N] default on empty input. */
 export declare function confirm(message: string, defaultYes?: boolean): Promise<boolean>;
+/**
+ * Free-form text prompt with optional validation + retry. Returns the trimmed
+ * input — or undefined if the user submits an empty line and `allowEmpty` is
+ * true (the caller can interpret empty as "skip").
+ *
+ * `validate` returns `null` for OK or a message string to print as the reason
+ * and re-ask. Used by `peek init` to capture the unpacked-extension ID with a
+ * Chrome-shape check (P-10 fix, 2026-05-28 QA walk).
+ */
+export declare function promptText(message: string, options?: {
+    validate?: (raw: string) => string | null;
+    allowEmpty?: boolean;
+}): Promise<string | undefined>;
 //# sourceMappingURL=prompt.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAMD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAkCxF;AAED,uFAAuF;AACvF,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUlF"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,WAAW,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACvC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACxC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC;AAMD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAkCxF;AAED,uFAAuF;AACvF,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAUlF;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC1C,UAAU,CAAC,EAAE,OAAO,CAAC;CACjB,GACL,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA4B7B"}

package/dist/lib/prompt.js

@@ -59,4 +59,44 @@ export async function confirm(message, defaultYes = true) {
         rl.close();
     }
 }
+/**
+ * Free-form text prompt with optional validation + retry. Returns the trimmed
+ * input — or undefined if the user submits an empty line and `allowEmpty` is
+ * true (the caller can interpret empty as "skip").
+ *
+ * `validate` returns `null` for OK or a message string to print as the reason
+ * and re-ask. Used by `peek init` to capture the unpacked-extension ID with a
+ * Chrome-shape check (P-10 fix, 2026-05-28 QA walk).
+ */
+export async function promptText(message, options = {}) {
+    const { validate, allowEmpty = false } = options;
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        // Re-ask on validation failure until the user enters a valid value (or an
+        // empty line when allowed). Bounded to a small constant so a non-TTY pipe
+        // can't lock the wizard if it keeps streaming garbage.
+        for (let attempt = 0; attempt < 5; attempt += 1) {
+            const raw = (await ask(rl, message)).trim();
+            if (raw.length === 0) {
+                if (allowEmpty)
+                    return undefined;
+                process.stdout.write('  (empty input not allowed; please try again)\n');
+                continue;
+            }
+            if (validate) {
+                const err = validate(raw);
+                if (err !== null) {
+                    process.stdout.write(`  ${err}\n`);
+                    continue;
+                }
+            }
+            return raw;
+        }
+        process.stdout.write('  (too many invalid attempts; skipping)\n');
+        return undefined;
+    }
+    finally {
+        rl.close();
+    }
+}
 //# sourceMappingURL=prompt.js.map

package/dist/lib/prompt.js.map

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

package/dist/skills/peek-skill.md

@@ -0,0 +1,182 @@
+---
+name: peek
+description: Use when the user mentions a recent browser session, an error they just reproduced, "what was the user doing before X", DOM state at some past moment, or wants to turn a manual repro into a Playwright test. Peek exposes 10 MCP tools backed by a local SQLite store of rrweb-captured browser sessions.
+---
+
+# peek — local browser-session inspection
+
+Peek is an OSS browser companion for AI coding agents. A Chrome MV3
+extension records masked rrweb sessions to a local SQLite store
+(`~/.peek/sessions.db`); a stdio MCP server exposes 10 tools that let you
+inspect those sessions and (with consent) drive the live browser.
+
+Peek runs entirely on the user's machine. No telemetry, no cloud, no
+account. If `~/.peek/sessions.db` is absent, peek isn't installed yet —
+direct the user to `npx @peekdev/cli init` and stop.
+
+## When to invoke
+
+Reach for peek when the user mentions any of these:
+
+- "what happened in my last session" / "show me my recent sessions"
+- "investigate this error" alongside a manual repro they just performed
+- "what was the user doing when X failed" / "what action triggered X"
+- "what did the DOM look like when Y happened"
+- "turn what I just did into a Playwright test"
+- "click the foo button on this page" (write tools, with consent)
+- "fill in this form on the page open in my browser" (write tools, with
+  consent)
+
+Don't reach for peek when:
+
+- The user is asking about production / remote / non-local data
+- A test-runner integration is already in scope — use
+  `@tracelane/wdio` (or the upcoming `@tracelane/playwright-reporter`)
+  for test-failure capture instead
+- The user wants live page introspection at the current moment with no
+  prior recording — peek is for *replaying* what was already captured,
+  not a live debugger
+- The question is about static code, not runtime behavior
+
+## The 10 tools
+
+**Read tools (8) — work at permission Level 2+ for the origin:**
+
+| Tool | When |
+|---|---|
+| `list_recent_sessions` | Always the first call. Returns `[{ sessionId, origin, startedAt, endedAt, eventCount, ... }]` for the last N sessions. |
+| `get_session_summary` | Narrative summary of one session — what the user did, top-level errors, key navigations. Start here after `list_recent_sessions` picks the target. |
+| `get_session_console_errors` | All `console.error` / uncaught exceptions in the session, with timestamps. |
+| `get_session_network_errors` | All ≥ 400 responses, with request URL, method, status, and (where deep-capture was enabled) redacted body. |
+| `get_user_action_before_error` | Walks rrweb input events backward from a given timestamp; returns the last meaningful user action (click target, form input, navigation). Use right after spotting a console/network error. |
+| `get_dom_snapshot` | Returns the DOM at a given timestamp as a serialized tree. Use to understand what was on screen when something happened. |
+| `query_dom_history` | Given a CSS selector + sessionId, returns every snapshot where that element changed. Good for "when did this element appear/disappear/change text". |
+| `generate_playwright_repro` | Turns a session (or a slice of one) into a runnable Playwright test stub. Selectors are best-effort from rrweb metadata; surface to the user for review before assuming they'll work. |
+
+**Write tools (2) — escalating consent required:**
+
+| Tool | When |
+|---|---|
+| `request_authorization` | Ask the user to authorize a specific action against a specific origin. Always call this BEFORE `execute_action` if the action is destructive (form submission, navigation away from the current page, anything that mutates state). |
+| `execute_action` | Performs a click / type / navigate in the user's live browser. Gated by the per-origin permission level — Level 3 covers safe reads, Level 4 covers actions with destructive-action consent, Level 5 is full automation. |
+
+## Workflow
+
+The shape of almost every peek conversation:
+
+```
+1. list_recent_sessions
+   → pick the sessionId the user means (usually the most recent;
+     prompt if ambiguous)
+
+2. get_session_summary(sessionId)
+   → understand what happened in plain language
+
+3. Drill down based on the user's question:
+   - errors      → get_session_console_errors / get_session_network_errors
+   - timing      → get_user_action_before_error(sessionId, atTimestamp)
+   - DOM state   → get_dom_snapshot(sessionId, atTimestamp)
+   - element history → query_dom_history(sessionId, selector)
+   - repro test  → generate_playwright_repro(sessionId, fromTs, toTs)
+
+4. (Optional, gated) write tools — only when the user explicitly asks
+   peek to *do* something in their browser:
+   - destructive? → request_authorization first, surface the prompt,
+                    only then execute_action
+   - safe (read-only-equivalent click)? → execute_action with the
+                    least-privilege scope
+```
+
+## Examples
+
+### Investigating a 500 error from a manual repro
+
+User: "I just got a 500 on the dashboard, what happened?"
+
+```
+1. list_recent_sessions
+   → grab the most recent session for the dashboard origin
+2. get_session_network_errors(sessionId)
+   → find the 500: POST /api/save, body field "name" was empty
+3. get_user_action_before_error(sessionId, errorTs)
+   → user clicked "Save" with empty form
+4. (optional) get_dom_snapshot(sessionId, errorTs - 100)
+   → confirm the form state right before the click
+5. Tell the user: "You submitted /api/save with an empty `name` field,
+   the server returned 500. The form's required-field validation didn't
+   fire. Want me to add a Playwright test for this?"
+```
+
+### Generating a Playwright test from a manual repro
+
+User: "Write a Playwright test for the bug I just reproduced."
+
+```
+1. list_recent_sessions
+   → the most recent session
+2. get_session_summary(sessionId)
+   → confirm with the user: "I see you logged in, opened settings,
+     clicked Delete account, saw the confirmation dialog, and the
+     test fails when the dialog closes early — is this what you
+     want a test for?"
+3. generate_playwright_repro(sessionId)
+   → returns a test file stub
+4. Show the user the stub; ask which selectors look fragile.
+```
+
+### Clicking a button on the user's live browser (consent flow)
+
+User: "Click the Save button on the page I have open."
+
+```
+1. Identify the target origin from list_recent_sessions OR from context
+2. request_authorization({
+     tool: 'execute_action',
+     origin: 'https://app.example.com',
+     action: 'click',
+     selector: '#save-button',
+     destructive: false,
+   })
+   → surface the consent prompt to the user
+3. If approved → execute_action with the same args
+4. If declined → say so and stop. Do not retry.
+```
+
+## Permission model
+
+Peek uses a five-level per-origin model. The state lives in
+`~/.peek/permissions.json`; the user manages it via the extension's
+side panel and `peek audit` (CLI).
+
+- **Level 0** — no access (default for new origins)
+- **Level 1** — list-only (sessionId + origin + timestamps; no event content)
+- **Level 2** — read full session content (all 8 read tools usable)
+- **Level 3** — read + safe actions (clicks, typing in inputs; no
+  navigation away, no form submission)
+- **Level 4** — read + actions including destructive (with per-action
+  `request_authorization` consent)
+- **Level 5** — automation (Level 4 actions without per-action consent;
+  rare, opt-in only)
+
+If a tool returns `{ error: 'permission_denied', origin, currentLevel,
+requiredLevel }`, tell the user how to escalate (via the side panel)
+and stop. Don't retry, don't suggest workarounds.
+
+## Safety floor
+
+- Never invent sessions. If `list_recent_sessions` returns empty, say so
+  and suggest the user record a session via the extension.
+- Never invent tool names. The 10 above are the entire surface.
+- Selector results from `generate_playwright_repro` are derived from
+  rrweb event metadata. Surface them for review; don't claim a generated
+  test is production-ready without the user confirming.
+- Destructive write actions (form submits, navigation off-page, deletes)
+  ALWAYS require a fresh `request_authorization` call. Never reuse a
+  prior authorization for a different action.
+
+## See also
+
+- npm: <https://www.npmjs.com/package/@peekdev/cli> · <https://www.npmjs.com/package/@peekdev/mcp>
+- Source: <https://github.com/Cubenest/rrweb-stack>
+- Docs: <https://cubenest.in/peek>
+- Privacy policy: <https://github.com/Cubenest/rrweb-stack/blob/main/docs/peek/PRIVACY_POLICY.md>

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const CLI_VERSION = "0.1.0-alpha.0";
+export declare const CLI_VERSION: string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,kBAAkB,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,WAAW,QAAe,CAAC"}

package/dist/version.js

@@ -1,6 +1,15 @@
-// CLI version string surfaced by `peek --version` / `peek --help`. Kept as a
-// literal (rather than importing package.json — NodeNext + verbatimModuleSyntax
-// makes a runtime JSON import awkward, and a stray resolveJsonModule asset in
-// dist is avoidable). The release Changeset bumps both this and package.json.
-export const CLI_VERSION = '0.1.0-alpha.0';
+// CLI version string surfaced by `peek --version` / `peek --help`.
+//
+// Read at runtime from this package's package.json (via `createRequire` to
+// keep an awkward JSON ESM import out of the source) so the printed version
+// always matches what npm shipped. The previous hardcoded literal drifted
+// out of sync with package.json across the alpha.0 → alpha.2 bumps because
+// Changesets only edits package.json, not source literals (P-8 bug found in
+// the 2026-05-28 QA walk).
+//
+// The relative path is from the compiled dist/version.js → ../package.json.
+import { createRequire } from 'node:module';
+const _require = createRequire(import.meta.url);
+const _pkg = _require('../package.json');
+export const CLI_VERSION = _pkg.version;
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,0EAA0E;AAC1E,2EAA2E;AAC3E,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,4EAA4E;AAE5E,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,IAAI,GAAG,QAAQ,CAAC,iBAAiB,CAAwB,CAAC;AAEhE,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,8 +1,22 @@
 {
   "name": "@peekdev/cli",
-  "version": "0.1.0-alpha.2",
-  "description": "peek command-line tool. A thin read-mostly client of the native host's ~/.peek/sessions.db (ADR-0007): status, sessions list/show/export/delete, the `peek init` MCP-client wizard, and `peek audit log`.",
+  "version": "0.1.0-alpha.21",
+  "description": "peek command-line tool. A thin read-mostly client of the native host's ~/.peek/sessions.db: status, sessions list/show/export/delete, the `peek init` MCP-client wizard, and `peek audit log`.",
+  "keywords": [
+    "peek",
+    "mcp",
+    "model-context-protocol",
+    "browser",
+    "claude-code",
+    "cursor",
+    "ai-coding-agent",
+    "session-replay"
+  ],
   "license": "Apache-2.0",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/harry-harish"
+  },
   "type": "module",
   "bin": {
     "peek": "./dist/index.js"
@@ -22,7 +36,7 @@
   ],
   "dependencies": {
     "better-sqlite3": "^12.10.0",
-    "@peekdev/mcp": "0.1.0-alpha.2"
+    "@peekdev/mcp": "0.1.0-alpha.15"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
@@ -37,7 +51,13 @@
     "url": "https://github.com/Cubenest/rrweb-stack",
     "directory": "packages/peek-cli"
   },
-  "homepage": "https://github.com/Cubenest/rrweb-stack/tree/main/packages/peek-cli#readme",
+  "bugs": {
+    "url": "https://github.com/Cubenest/rrweb-stack/issues"
+  },
+  "homepage": "https://peek.cubenest.in",
+  "engines": {
+    "node": ">=22"
+  },
   "scripts": {
     "build": "tsc -p tsconfig.json && node ./scripts/postbuild.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",