@peekdev/cli 0.1.0-alpha.1 → 0.1.0-alpha.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. package/LICENSE +202 -0
  2. package/README.md +90 -0
  3. package/dist/commands/audit.d.ts.map +1 -1
  4. package/dist/commands/audit.js +10 -0
  5. package/dist/commands/audit.js.map +1 -1
  6. package/dist/commands/init.d.ts.map +1 -1
  7. package/dist/commands/init.js +97 -3
  8. package/dist/commands/init.js.map +1 -1
  9. package/dist/commands/sessions.d.ts.map +1 -1
  10. package/dist/commands/sessions.js +129 -11
  11. package/dist/commands/sessions.js.map +1 -1
  12. package/dist/index.d.ts.map +1 -1
  13. package/dist/index.js +11 -1
  14. package/dist/index.js.map +1 -1
  15. package/dist/lib/db.d.ts +46 -5
  16. package/dist/lib/db.d.ts.map +1 -1
  17. package/dist/lib/db.js +78 -7
  18. package/dist/lib/db.js.map +1 -1
  19. package/dist/lib/extension-id.d.ts +30 -0
  20. package/dist/lib/extension-id.d.ts.map +1 -0
  21. package/dist/lib/extension-id.js +78 -0
  22. package/dist/lib/extension-id.js.map +1 -0
  23. package/dist/lib/format/index.d.ts +11 -1
  24. package/dist/lib/format/index.d.ts.map +1 -1
  25. package/dist/lib/format/index.js +22 -20
  26. package/dist/lib/format/index.js.map +1 -1
  27. package/dist/lib/format/json.d.ts +26 -1
  28. package/dist/lib/format/json.d.ts.map +1 -1
  29. package/dist/lib/format/json.js +39 -2
  30. package/dist/lib/format/json.js.map +1 -1
  31. package/dist/lib/format/markdown.d.ts.map +1 -1
  32. package/dist/lib/format/markdown.js +17 -0
  33. package/dist/lib/format/markdown.js.map +1 -1
  34. package/dist/lib/format/playwright.d.ts +13 -0
  35. package/dist/lib/format/playwright.d.ts.map +1 -0
  36. package/dist/lib/format/playwright.js +37 -0
  37. package/dist/lib/format/playwright.js.map +1 -0
  38. package/dist/lib/native-host-wrapper.d.ts +23 -0
  39. package/dist/lib/native-host-wrapper.d.ts.map +1 -0
  40. package/dist/lib/native-host-wrapper.js +45 -0
  41. package/dist/lib/native-host-wrapper.js.map +1 -0
  42. package/dist/lib/peek-home.d.ts +8 -0
  43. package/dist/lib/peek-home.d.ts.map +1 -1
  44. package/dist/lib/peek-home.js +10 -0
  45. package/dist/lib/peek-home.js.map +1 -1
  46. package/dist/lib/prompt.d.ts +13 -0
  47. package/dist/lib/prompt.d.ts.map +1 -1
  48. package/dist/lib/prompt.js +40 -0
  49. package/dist/lib/prompt.js.map +1 -1
  50. package/dist/version.d.ts +1 -1
  51. package/dist/version.d.ts.map +1 -1
  52. package/dist/version.js +14 -5
  53. package/dist/version.js.map +1 -1
  54. package/package.json +16 -12
@@ -11,6 +11,16 @@ export type FormatResult = {
11
11
  readonly ok: false;
12
12
  readonly message: string;
13
13
  };
14
+ /**
15
+ * Optional ancillary data the formatter may need beyond `SessionDetail`. The
16
+ * playwright format needs `blobPath` (the `sessions.events_blob_path` value)
17
+ * to load the gzipped rrweb stream from disk; markdown / json work purely
18
+ * from the SQL rows already on `detail` and ignore it.
19
+ */
20
+ export interface FormatOptions {
21
+ /** Relative path to the session's gzipped event blob, for the playwright walker. */
22
+ readonly blobPath?: string;
23
+ }
14
24
  /** Render a hydrated session in the requested format. */
15
- export declare function formatSession(detail: SessionDetail, format: ExportFormat): FormatResult;
25
+ export declare function formatSession(detail: SessionDetail, format: ExportFormat, options?: FormatOptions): FormatResult;
16
26
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/format/index.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAK9C,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;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,YAAY,EACpB,OAAO,GAAE,aAAkB,GAC1B,YAAY,CAuBd"}
@@ -1,29 +1,38 @@
1
- // Export-format dispatch (P2 PRD §C.3). `markdown` and `json` are implemented
2
- // fully (self-contained AI-paste formats read straight from the extracted SQL
3
- // rows). `html` (self-contained rrweb replay) and `playwright` (repro
4
- // boilerplate) are deferred:
5
- // - html would require bundling an rrweb player inline; importing
6
- // @tracelane/report is explicitly forbidden (ADR-0001 product independence),
7
- // so a peek-specific viewer is a tracked follow-up.
8
- // - playwright overlaps the MCP `generate_playwright_repro` tool (Phase 3c
9
- // Task 3.13); the repro walker should live there and be shared, rather than
10
- // forked here. Tracked follow-up.
11
- // The stubs return a non-ok result so the command shell exits non-zero with a
12
- // clear message (never silently emit an empty/partial file).
1
+ // Export-format dispatch (P2 PRD §C.3). `markdown`, `json`, and `playwright`
2
+ // are implemented fully:
3
+ // - markdown / json: self-contained AI-paste formats, read straight from
4
+ // the extracted SQL rows (consoleErrors / networkErrors).
5
+ // - playwright (K.2 alpha.7 fix): wires to the SAME walker the MCP
6
+ // `generate_playwright_repro` tool uses via `@peekdev/mcp/mcp/playwright-
7
+ // repro` + `@peekdev/mcp/mcp/event-blobs`. CLI + AI consumers produce
8
+ // identical output for the same session (P2 PRD §B3 parity guarantee).
9
+ //
10
+ // `html` (self-contained rrweb replay) stays deferred — it would require
11
+ // bundling an rrweb player inline; importing @tracelane/report is explicitly
12
+ // forbidden (ADR-0001 product independence), so a peek-specific viewer is a
13
+ // tracked follow-up. The stub returns a non-ok result so the command shell
14
+ // exits non-zero with a clear message (never silently emit an empty/partial
15
+ // file).
13
16
  import { formatSessionJson } from './json.js';
14
17
  import { formatSessionMarkdown } from './markdown.js';
18
+ import { formatSessionPlaywright } from './playwright.js';
15
19
  /** Supported `--format` values (P2 PRD §C.1). */
16
20
  export const EXPORT_FORMATS = ['markdown', 'json', 'html', 'playwright'];
17
21
  export function isExportFormat(value) {
18
22
  return EXPORT_FORMATS.includes(value);
19
23
  }
20
24
  /** Render a hydrated session in the requested format. */
21
- export function formatSession(detail, format) {
25
+ export function formatSession(detail, format, options = {}) {
22
26
  switch (format) {
23
27
  case 'markdown':
24
28
  return { ok: true, content: formatSessionMarkdown(detail) };
25
29
  case 'json':
26
30
  return { ok: true, content: formatSessionJson(detail) };
31
+ case 'playwright':
32
+ return {
33
+ ok: true,
34
+ content: formatSessionPlaywright(detail, ...(options.blobPath !== undefined ? [options.blobPath] : [])),
35
+ };
27
36
  case 'html':
28
37
  return {
29
38
  ok: false,
@@ -31,13 +40,6 @@ export function formatSession(detail, format) {
31
40
  'rrweb replay viewer is tracked for a follow-up; @tracelane/report is intentionally ' +
32
41
  'not reused — ADR-0001 product independence). Use --format markdown or json.',
33
42
  };
34
- case 'playwright':
35
- return {
36
- ok: false,
37
- message: "export format 'playwright' is not yet implemented (the repro generator overlaps the " +
38
- 'MCP `generate_playwright_repro` tool, Phase 3c Task 3.13, and will share that walker). ' +
39
- 'Use --format markdown or json.',
40
- };
41
43
  }
42
44
  }
43
45
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/format/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,yBAAyB;AACzB,2EAA2E;AAC3E,8DAA8D;AAC9D,qEAAqE;AACrE,8EAA8E;AAC9E,0EAA0E;AAC1E,2EAA2E;AAC3E,EAAE;AACF,yEAAyE;AACzE,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,4EAA4E;AAC5E,SAAS;AAGT,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE1D,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;AAkBD,yDAAyD;AACzD,MAAM,UAAU,aAAa,CAC3B,MAAqB,EACrB,MAAoB,EACpB,UAAyB,EAAE;IAE3B,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,YAAY;YACf,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,uBAAuB,CAC9B,MAAM,EACN,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAC9D;aACF,CAAC;QACJ,KAAK,MAAM;YACT,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EACL,8EAA8E;oBAC9E,qFAAqF;oBACrF,6EAA6E;aAChF,CAAC;IACN,CAAC;AACH,CAAC"}
@@ -1,4 +1,21 @@
1
1
  import type { SessionDetail } from '../db.js';
2
+ /** Static attribution block shape — never references session data. */
3
+ export interface AttributionBlock {
4
+ readonly tool: 'peek';
5
+ readonly url: string;
6
+ readonly description: string;
7
+ readonly version: string;
8
+ }
9
+ /**
10
+ * Build the self-marketing attribution block (Phase 5 indirect virality).
11
+ *
12
+ * The URL links to `packages/peek-mcp` because the install command
13
+ * (`npm i @peekdev/mcp` / `peek init`) is the marketing artifact per the
14
+ * research — not the docs site, not a landing page. The UTM medium is
15
+ * format-specific so we can attribute which export shape drives the most
16
+ * click-through (JSON vs Markdown vs future formats).
17
+ */
18
+ export declare function buildAttribution(medium: 'json-attribution' | 'markdown-attribution'): AttributionBlock;
2
19
  /** The JSON export envelope. Field names mirror the MCP tool return shapes. */
3
20
  export interface SessionJsonExport {
4
21
  readonly id: string;
@@ -30,6 +47,14 @@ export interface SessionJsonExport {
30
47
  }
31
48
  /** Build the JSON export object (pure; not yet stringified). */
32
49
  export declare function toJsonExport(detail: SessionDetail): SessionJsonExport;
33
- /** Render a session as a pretty-printed JSON string (2-space indent). */
50
+ /**
51
+ * Render a session as a pretty-printed JSON string (2-space indent).
52
+ *
53
+ * `_attribution` is inserted FIRST in the object literal so it appears at the
54
+ * top of the serialized output — `JSON.stringify` preserves insertion order
55
+ * per the ECMA-262 spec for string keys (own enumerable string properties are
56
+ * visited in insertion order). The `_` prefix is the JSON convention for
57
+ * "metadata, not data" — discoverable but not part of the session payload.
58
+ */
34
59
  export declare function formatSessionJson(detail: SessionDetail): string;
35
60
  //# sourceMappingURL=json.d.ts.map
@@ -1 +1 @@
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"}
1
+ {"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/lib/format/json.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,sEAAsE;AACtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,GAAG,sBAAsB,GAClD,gBAAgB,CAQlB;AAED,+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;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAM/D"}
@@ -2,6 +2,31 @@
2
2
  // (P2 PRD §C.3 "same schema as MCP tool returns", §B3) so an AI consumer can
3
3
  // treat a CLI export and an MCP `get_session_*` response interchangeably. Pure:
4
4
  // SessionDetail in, JSON string out.
5
+ //
6
+ // Phase 5 self-marketing: every export carries a top-level `_attribution` block
7
+ // (underscore-prefixed per JSON convention for "metadata not data") so a JSON
8
+ // export shared in a PR or attached to a JIRA ticket is a tracked acquisition
9
+ // channel — the Loom / Calendly / Statuspage indirect-virality pattern. The
10
+ // block contains only static strings + the CLI version; no session content
11
+ // leaks in.
12
+ import { CLI_VERSION } from '../../version.js';
13
+ /**
14
+ * Build the self-marketing attribution block (Phase 5 indirect virality).
15
+ *
16
+ * The URL links to `packages/peek-mcp` because the install command
17
+ * (`npm i @peekdev/mcp` / `peek init`) is the marketing artifact per the
18
+ * research — not the docs site, not a landing page. The UTM medium is
19
+ * format-specific so we can attribute which export shape drives the most
20
+ * click-through (JSON vs Markdown vs future formats).
21
+ */
22
+ export function buildAttribution(medium) {
23
+ return {
24
+ tool: 'peek',
25
+ url: `https://github.com/Cubenest/rrweb-stack/tree/main/packages/peek-mcp?utm_source=peek-export&utm_medium=${medium}&utm_campaign=indirect-virality`,
26
+ description: 'Captured with peek — your real browser, exposed to your AI coding agent over MCP. Capture once, query forever, never leaves your machine.',
27
+ version: CLI_VERSION,
28
+ };
29
+ }
5
30
  /** Build the JSON export object (pure; not yet stringified). */
6
31
  export function toJsonExport(detail) {
7
32
  const { session, counts, consoleErrors, networkErrors } = detail;
@@ -34,8 +59,20 @@ export function toJsonExport(detail) {
34
59
  })),
35
60
  };
36
61
  }
37
- /** Render a session as a pretty-printed JSON string (2-space indent). */
62
+ /**
63
+ * Render a session as a pretty-printed JSON string (2-space indent).
64
+ *
65
+ * `_attribution` is inserted FIRST in the object literal so it appears at the
66
+ * top of the serialized output — `JSON.stringify` preserves insertion order
67
+ * per the ECMA-262 spec for string keys (own enumerable string properties are
68
+ * visited in insertion order). The `_` prefix is the JSON convention for
69
+ * "metadata, not data" — discoverable but not part of the session payload.
70
+ */
38
71
  export function formatSessionJson(detail) {
39
- return `${JSON.stringify(toJsonExport(detail), null, 2)}\n`;
72
+ const envelope = {
73
+ _attribution: buildAttribution('json-attribution'),
74
+ session: toJsonExport(detail),
75
+ };
76
+ return `${JSON.stringify(envelope, null, 2)}\n`;
40
77
  }
41
78
  //# sourceMappingURL=json.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/lib/format/json.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,qCAAqC;AAkCrC,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IACjE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa;QACvD,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC;QACH,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC9D,CAAC"}
1
+ {"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/lib/format/json.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,6EAA6E;AAC7E,gFAAgF;AAChF,qCAAqC;AACrC,EAAE;AACF,gFAAgF;AAChF,8EAA8E;AAC9E,8EAA8E;AAC9E,4EAA4E;AAC5E,2EAA2E;AAC3E,YAAY;AAEZ,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAW/C;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAmD;IAEnD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,yGAAyG,MAAM,iCAAiC;QACrJ,WAAW,EACT,2IAA2I;QAC7I,OAAO,EAAE,WAAW;KACrB,CAAC;AACJ,CAAC;AAgCD,gEAAgE;AAChE,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,MAAM,CAAC;IACjE,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,MAAM,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa;QACvD,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,KAAK,EAAE,CAAC,CAAC,KAAK;SACf,CAAC,CAAC;QACH,aAAa,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,EAAE,CAAC,CAAC,GAAG;YACV,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,YAAY,EAAE,CAAC,CAAC,YAAY;YAC5B,UAAU,EAAE,CAAC,CAAC,UAAU;YACxB,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC;KACJ,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAqB;IACrD,MAAM,QAAQ,GAAG;QACf,YAAY,EAAE,gBAAgB,CAAC,kBAAkB,CAAC;QAClD,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC;KAC9B,CAAC;IACF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/lib/format/markdown.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,UAAU,CAAC;AAgChF,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CA0CnE"}
1
+ {"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../../src/lib/format/markdown.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAoC,aAAa,EAAE,MAAM,UAAU,CAAC;AAiChF,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAuDnE"}
@@ -12,6 +12,13 @@
12
12
  // `generate_playwright_repro` tools (Phase 3c). The CLI markdown export reads
13
13
  // only the extracted SQL rows, so it states where the richer data lives rather
14
14
  // than fabricating it.
15
+ //
16
+ // Phase 5 self-marketing: the export ends with an `---` rule + an attribution
17
+ // blockquote so every Markdown export shared in a PR or attached to a ticket
18
+ // is a tracked acquisition channel (UTM-tagged link to peek-mcp's install
19
+ // path on GitHub — the install command IS the marketing artifact per the
20
+ // indirect-virality research). The attribution is static — no session data.
21
+ import { buildAttribution } from './json.js';
15
22
  function isoFromMs(tsMs) {
16
23
  return new Date(tsMs).toISOString();
17
24
  }
@@ -71,6 +78,16 @@ export function formatSessionMarkdown(detail) {
71
78
  lines.push('## Suggested reproduction');
72
79
  lines.push(`Generate a Playwright repro with \`peek sessions export ${session.id} --format playwright\`, or the MCP \`generate_playwright_repro\` tool.`);
73
80
  lines.push('');
81
+ // Self-marketing attribution (Phase 5 indirect virality). Horizontal-rule
82
+ // separates it from the export body; blockquote keeps it visually distinct
83
+ // (won't be mistaken for a user-action line by an AI paste consumer). The
84
+ // link target is the install path on GitHub — that's where the reader
85
+ // sees `npm i @peekdev/mcp`.
86
+ const attribution = buildAttribution('markdown-attribution');
87
+ lines.push('---');
88
+ lines.push('');
89
+ lines.push(`> _Captured with [peek](${attribution.url}) — your real browser, exposed to your AI coding agent over MCP._`);
90
+ lines.push('');
74
91
  return lines.join('\n');
75
92
  }
76
93
  //# sourceMappingURL=markdown.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/lib/format/markdown.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../../src/lib/format/markdown.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { SessionDetail } from '../db.js';
2
+ /**
3
+ * Render a hydrated session as a Playwright `.spec.ts` test string. Returns
4
+ * the script verbatim — no trailing newline mutation — so byte-identical
5
+ * comparison with the MCP tool output works for tests.
6
+ *
7
+ * If the session has no recorded event blob (active session pre-flush, or
8
+ * blob pruned by retention), the generator still emits a valid `test(...)`
9
+ * shell with a `// No user actions were recorded` placeholder so the user
10
+ * gets a script they can edit, not an empty file.
11
+ */
12
+ export declare function formatSessionPlaywright(detail: SessionDetail, blobPath?: string): string;
13
+ //# sourceMappingURL=playwright.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../../src/lib/format/playwright.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAKxF"}
@@ -0,0 +1,37 @@
1
+ // `--format playwright`: emit a runnable Playwright `test(...)` repro from a
2
+ // session's rrweb stream (K.2 alpha.7 fix). This wires the CLI to the SAME
3
+ // code path the MCP `generate_playwright_repro` tool uses — Phase 3c Task 3.13,
4
+ // implemented in `@peekdev/mcp/mcp/playwright-repro`. CLI and AI consumers MUST
5
+ // produce identical output for the same session (P2 PRD §B3 cross-surface
6
+ // parity guarantee).
7
+ //
8
+ // The MCP tool walks the in-memory eventWithTime[] directly; the CLI reads
9
+ // the on-disk gzipped blob first (via @peekdev/mcp/mcp/event-blobs), then
10
+ // hands the decoded events to the shared generator. The session metadata
11
+ // (used as the test title) comes from the same SessionDetail the markdown +
12
+ // json formatters consume.
13
+ //
14
+ // Pre-K.2, this format returned a non-ok "not yet implemented (Phase 3c Task
15
+ // 3.13)" message because the walker lived in peek-mcp and wasn't published
16
+ // as a sub-path export. Alpha.7 adds the `./mcp/playwright-repro` and
17
+ // `./mcp/event-blobs` sub-path exports so the CLI can import the generator
18
+ // + the on-disk blob loader directly, with no code forking.
19
+ import { loadSessionEvents } from '@peekdev/mcp/mcp/event-blobs';
20
+ import { generatePlaywrightRepro } from '@peekdev/mcp/mcp/playwright-repro';
21
+ /**
22
+ * Render a hydrated session as a Playwright `.spec.ts` test string. Returns
23
+ * the script verbatim — no trailing newline mutation — so byte-identical
24
+ * comparison with the MCP tool output works for tests.
25
+ *
26
+ * If the session has no recorded event blob (active session pre-flush, or
27
+ * blob pruned by retention), the generator still emits a valid `test(...)`
28
+ * shell with a `// No user actions were recorded` placeholder so the user
29
+ * gets a script they can edit, not an empty file.
30
+ */
31
+ export function formatSessionPlaywright(detail, blobPath) {
32
+ const events = blobPath !== undefined && blobPath.length > 0 ? loadSessionEvents(blobPath) : [];
33
+ return generatePlaywrightRepro(events, {
34
+ title: detail.session.title ?? `peek session ${detail.session.id}`,
35
+ });
36
+ }
37
+ //# sourceMappingURL=playwright.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"playwright.js","sourceRoot":"","sources":["../../../src/lib/format/playwright.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,gFAAgF;AAChF,gFAAgF;AAChF,0EAA0E;AAC1E,qBAAqB;AACrB,EAAE;AACF,2EAA2E;AAC3E,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,6EAA6E;AAC7E,2EAA2E;AAC3E,sEAAsE;AACtE,2EAA2E;AAC3E,4DAA4D;AAE5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,MAAM,mCAAmC,CAAC;AAG5E;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAqB,EAAE,QAAiB;IAC9E,MAAM,MAAM,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChG,OAAO,uBAAuB,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,gBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE;KACnE,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,23 @@
1
+ import type { SupportedPlatform } from '@peekdev/mcp/native-host';
2
+ /**
3
+ * Where the generated wrapper lives. On POSIX it ends in `.sh`; on Windows
4
+ * `.cmd` so the shell that Chrome's CreateProcess invocation finds knows what
5
+ * to execute. The wrapper lives under `~/.peek/` so it shares the same
6
+ * permission scope as the audit log + sessions DB.
7
+ */
8
+ export declare function wrapperPath(peekHomeDir: string, platform: SupportedPlatform): string;
9
+ /**
10
+ * Body of the wrapper script. Pure — accepts the node binary and the host
11
+ * `.js` path explicitly so tests can hand it any fixture without touching
12
+ * `process.execPath` or `hostBinaryPath()`.
13
+ *
14
+ * POSIX: a `/bin/sh` script that `exec`s `node host.js "$@"`. `exec` replaces
15
+ * the shell so Chrome's process tree stays minimal (it tracks the JS process
16
+ * directly for stdin/stdout, not a shell wrapper that's blocking the pipe).
17
+ *
18
+ * Windows: a `.cmd` that calls node with the args via `%*`. We use
19
+ * Windows line endings (`\r\n`) because some legacy CMD versions choke on
20
+ * LF-only `.cmd` files when invoked via CreateProcess.
21
+ */
22
+ export declare function wrapperContent(nodePath: string, hostJsPath: string, platform: SupportedPlatform): string;
23
+ //# sourceMappingURL=native-host-wrapper.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"native-host-wrapper.d.ts","sourceRoot":"","sources":["../../src/lib/native-host-wrapper.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAGpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CAKR"}
@@ -0,0 +1,45 @@
1
+ // P-16 (2026-05-28 QA walk) — generate a tiny shell wrapper for the native
2
+ // host. Chrome (and other Chromium-based browsers) spawn the manifest's `path`
3
+ // via the GUI launcher's `$PATH`, NOT the shell's. On macOS with both a
4
+ // legacy /usr/local/bin/node and a current /opt/homebrew/bin/node, the system
5
+ // PATH resolves `#!/usr/bin/env node` to the older binary — typically
6
+ // architecture-mismatched, so `better-sqlite3.node` fails dlopen and the
7
+ // host process exits before Chrome reads any output. Chrome silently moves on.
8
+ //
9
+ // The fix is to write a wrapper that hardcodes `process.execPath` (the node
10
+ // that ran `peek init`) and point the manifest at the wrapper. This is the
11
+ // well-trodden pattern for any Node-based native messaging host.
12
+ //
13
+ // Pure helpers — `writeNativeHostWrapper` (in commands/init.ts) does the
14
+ // filesystem write. Tests pin the path layout + content shape per platform.
15
+ import { join } from 'node:path';
16
+ /**
17
+ * Where the generated wrapper lives. On POSIX it ends in `.sh`; on Windows
18
+ * `.cmd` so the shell that Chrome's CreateProcess invocation finds knows what
19
+ * to execute. The wrapper lives under `~/.peek/` so it shares the same
20
+ * permission scope as the audit log + sessions DB.
21
+ */
22
+ export function wrapperPath(peekHomeDir, platform) {
23
+ const filename = platform === 'win32' ? 'peek-mcp-host.cmd' : 'peek-mcp-host.sh';
24
+ return join(peekHomeDir, filename);
25
+ }
26
+ /**
27
+ * Body of the wrapper script. Pure — accepts the node binary and the host
28
+ * `.js` path explicitly so tests can hand it any fixture without touching
29
+ * `process.execPath` or `hostBinaryPath()`.
30
+ *
31
+ * POSIX: a `/bin/sh` script that `exec`s `node host.js "$@"`. `exec` replaces
32
+ * the shell so Chrome's process tree stays minimal (it tracks the JS process
33
+ * directly for stdin/stdout, not a shell wrapper that's blocking the pipe).
34
+ *
35
+ * Windows: a `.cmd` that calls node with the args via `%*`. We use
36
+ * Windows line endings (`\r\n`) because some legacy CMD versions choke on
37
+ * LF-only `.cmd` files when invoked via CreateProcess.
38
+ */
39
+ export function wrapperContent(nodePath, hostJsPath, platform) {
40
+ if (platform === 'win32') {
41
+ return `@echo off\r\n"${nodePath}" "${hostJsPath}" %*\r\n`;
42
+ }
43
+ return `#!/bin/sh\nexec "${nodePath}" "${hostJsPath}" "$@"\n`;
44
+ }
45
+ //# sourceMappingURL=native-host-wrapper.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"native-host-wrapper.js","sourceRoot":"","sources":["../../src/lib/native-host-wrapper.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,+EAA+E;AAC/E,wEAAwE;AACxE,8EAA8E;AAC9E,sEAAsE;AACtE,yEAAyE;AACzE,+EAA+E;AAC/E,EAAE;AACF,4EAA4E;AAC5E,2EAA2E;AAC3E,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,4EAA4E;AAE5E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,WAAmB,EAAE,QAA2B;IAC1E,MAAM,QAAQ,GAAG,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IACjF,OAAO,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,UAAkB,EAClB,QAA2B;IAE3B,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;QACzB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,UAAU,CAAC;IAC7D,CAAC;IACD,OAAO,oBAAoB,QAAQ,MAAM,UAAU,UAAU,CAAC;AAChE,CAAC"}
@@ -2,4 +2,12 @@ import { defaultDbPath, peekHomeDir } from '@peekdev/mcp/db';
2
2
  export { defaultDbPath, peekHomeDir };
3
3
  /** Absolute path to the append-only audit log (~/.peek/audit.log, ADR-0010). */
4
4
  export declare function auditLogPath(): string;
5
+ /**
6
+ * Base directory for gzipped rrweb event chunks (ADR-0007): `~/.peek/rrweb-events/`.
7
+ * Each session has a subdirectory `<sessionId>/` with one `<seq>.json.gz` per
8
+ * append batch. Mirrors `rrwebEventsDir()` in peek-mcp's `mcp/event-blobs.ts`;
9
+ * the path layout is the public contract between writer (native host) and
10
+ * reader/cleaner (this CLI).
11
+ */
12
+ export declare function rrwebEventsDir(): string;
5
13
  //# sourceMappingURL=peek-home.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"peek-home.d.ts","sourceRoot":"","sources":["../../src/lib/peek-home.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAEtC,gFAAgF;AAChF,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
1
+ {"version":3,"file":"peek-home.d.ts","sourceRoot":"","sources":["../../src/lib/peek-home.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAEtC,gFAAgF;AAChF,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC"}
@@ -8,4 +8,14 @@ export { defaultDbPath, peekHomeDir };
8
8
  export function auditLogPath() {
9
9
  return join(peekHomeDir(), 'audit.log');
10
10
  }
11
+ /**
12
+ * Base directory for gzipped rrweb event chunks (ADR-0007): `~/.peek/rrweb-events/`.
13
+ * Each session has a subdirectory `<sessionId>/` with one `<seq>.json.gz` per
14
+ * append batch. Mirrors `rrwebEventsDir()` in peek-mcp's `mcp/event-blobs.ts`;
15
+ * the path layout is the public contract between writer (native host) and
16
+ * reader/cleaner (this CLI).
17
+ */
18
+ export function rrwebEventsDir() {
19
+ return join(peekHomeDir(), 'rrweb-events');
20
+ }
11
21
  //# sourceMappingURL=peek-home.js.map
@@ -1 +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"}
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;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC;AAC7C,CAAC"}
@@ -22,4 +22,17 @@ export interface Choice<T> {
22
22
  export declare function multiSelect<T>(message: string, choices: Choice<T>[]): Promise<T[]>;
23
23
  /** Yes/no confirm. `defaultYes` controls the [Y/n] vs [y/N] default on empty input. */
24
24
  export declare function confirm(message: string, defaultYes?: boolean): Promise<boolean>;
25
+ /**
26
+ * Free-form text prompt with optional validation + retry. Returns the trimmed
27
+ * input — or undefined if the user submits an empty line and `allowEmpty` is
28
+ * true (the caller can interpret empty as "skip").
29
+ *
30
+ * `validate` returns `null` for OK or a message string to print as the reason
31
+ * and re-ask. Used by `peek init` to capture the unpacked-extension ID with a
32
+ * Chrome-shape check (P-10 fix, 2026-05-28 QA walk).
33
+ */
34
+ export declare function promptText(message: string, options?: {
35
+ validate?: (raw: string) => string | null;
36
+ allowEmpty?: boolean;
37
+ }): Promise<string | undefined>;
25
38
  //# sourceMappingURL=prompt.d.ts.map
@@ -1 +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"}
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;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"}
@@ -59,4 +59,44 @@ export async function confirm(message, defaultYes = true) {
59
59
  rl.close();
60
60
  }
61
61
  }
62
+ /**
63
+ * Free-form text prompt with optional validation + retry. Returns the trimmed
64
+ * input — or undefined if the user submits an empty line and `allowEmpty` is
65
+ * true (the caller can interpret empty as "skip").
66
+ *
67
+ * `validate` returns `null` for OK or a message string to print as the reason
68
+ * and re-ask. Used by `peek init` to capture the unpacked-extension ID with a
69
+ * Chrome-shape check (P-10 fix, 2026-05-28 QA walk).
70
+ */
71
+ export async function promptText(message, options = {}) {
72
+ const { validate, allowEmpty = false } = options;
73
+ const rl = createInterface({ input: process.stdin, output: process.stdout });
74
+ try {
75
+ // Re-ask on validation failure until the user enters a valid value (or an
76
+ // empty line when allowed). Bounded to a small constant so a non-TTY pipe
77
+ // can't lock the wizard if it keeps streaming garbage.
78
+ for (let attempt = 0; attempt < 5; attempt += 1) {
79
+ const raw = (await ask(rl, message)).trim();
80
+ if (raw.length === 0) {
81
+ if (allowEmpty)
82
+ return undefined;
83
+ process.stdout.write(' (empty input not allowed; please try again)\n');
84
+ continue;
85
+ }
86
+ if (validate) {
87
+ const err = validate(raw);
88
+ if (err !== null) {
89
+ process.stdout.write(` ${err}\n`);
90
+ continue;
91
+ }
92
+ }
93
+ return raw;
94
+ }
95
+ process.stdout.write(' (too many invalid attempts; skipping)\n');
96
+ return undefined;
97
+ }
98
+ finally {
99
+ rl.close();
100
+ }
101
+ }
62
102
  //# sourceMappingURL=prompt.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"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"}
package/dist/version.d.ts CHANGED
@@ -1,2 +1,2 @@
1
- export declare const CLI_VERSION = "0.1.0-alpha.0";
1
+ export declare const CLI_VERSION: string;
2
2
  //# sourceMappingURL=version.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,kBAAkB,CAAC"}
1
+ {"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,WAAW,QAAe,CAAC"}
package/dist/version.js CHANGED
@@ -1,6 +1,15 @@
1
- // CLI version string surfaced by `peek --version` / `peek --help`. Kept as a
2
- // literal (rather than importing package.json — NodeNext + verbatimModuleSyntax
3
- // makes a runtime JSON import awkward, and a stray resolveJsonModule asset in
4
- // dist is avoidable). The release Changeset bumps both this and package.json.
5
- export const CLI_VERSION = '0.1.0-alpha.0';
1
+ // CLI version string surfaced by `peek --version` / `peek --help`.
2
+ //
3
+ // Read at runtime from this package's package.json (via `createRequire` to
4
+ // keep an awkward JSON ESM import out of the source) so the printed version
5
+ // always matches what npm shipped. The previous hardcoded literal drifted
6
+ // out of sync with package.json across the alpha.0 → alpha.2 bumps because
7
+ // Changesets only edits package.json, not source literals (P-8 bug found in
8
+ // the 2026-05-28 QA walk).
9
+ //
10
+ // The relative path is from the compiled dist/version.js → ../package.json.
11
+ import { createRequire } from 'node:module';
12
+ const _require = createRequire(import.meta.url);
13
+ const _pkg = _require('../package.json');
14
+ export const CLI_VERSION = _pkg.version;
6
15
  //# sourceMappingURL=version.js.map
@@ -1 +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"}
1
+ {"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"}