@posthog/wizard 2.32.0 → 2.34.0

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 (78) hide show
  1. package/dist/{add-mcp-server-to-clients-Dc0yssCM.js → add-mcp-server-to-clients-BjH4z7gH.js} +5 -5
  2. package/dist/{add-mcp-server-to-clients-Dc0yssCM.js.map → add-mcp-server-to-clients-BjH4z7gH.js.map} +1 -1
  3. package/dist/{agent-interface-c7B2JZEd.js → agent-interface-BcUv1qeh.js} +330 -45
  4. package/dist/agent-interface-BcUv1qeh.js.map +1 -0
  5. package/dist/{agent-runner-Am34bBUT.js → agent-runner-8g_pDAVs.js} +30 -11
  6. package/dist/agent-runner-8g_pDAVs.js.map +1 -0
  7. package/dist/{analytics-CBIKy9PZ.js → analytics-DQ8IS1Hu.js} +3 -3
  8. package/dist/analytics-DQ8IS1Hu.js.map +1 -0
  9. package/dist/{api-Blg3nvvZ.js → api-EghEV_u9.js} +3 -3
  10. package/dist/{api-Blg3nvvZ.js.map → api-EghEV_u9.js.map} +1 -1
  11. package/dist/bin.js +203 -75
  12. package/dist/bin.js.map +1 -1
  13. package/dist/check-screens.tsx +25 -0
  14. package/dist/ci-install-ouGSf4zp.js +113 -0
  15. package/dist/ci-install-ouGSf4zp.js.map +1 -0
  16. package/dist/{debug-cy_jyRb4.js → debug-BM7yop-T.js} +1 -1
  17. package/dist/{debug-AdvgwKEw.js → debug-Cn4L5Ype.js} +2 -2
  18. package/dist/{debug-AdvgwKEw.js.map → debug-Cn4L5Ype.js.map} +1 -1
  19. package/dist/{defaults-BNWIWzjc.js → defaults-DII5CAog.js} +1 -1
  20. package/dist/{defaults-BNWIWzjc.js.map → defaults-DII5CAog.js.map} +1 -1
  21. package/dist/{environment-B6TW5v9d.js → environment-D2WUIm8o.js} +3 -3
  22. package/dist/{environment-B6TW5v9d.js.map → environment-D2WUIm8o.js.map} +1 -1
  23. package/dist/{file-utils-8tUk_eEX.js → file-utils-CdQn6073.js} +2 -2
  24. package/dist/{file-utils-8tUk_eEX.js.map → file-utils-CdQn6073.js.map} +1 -1
  25. package/dist/headless-ui-CSqtmW-d.js +24 -0
  26. package/dist/headless-ui-CSqtmW-d.js.map +1 -0
  27. package/dist/{interactive-CApktTrj.js → interactive-CFGcWw43.js} +3 -3
  28. package/dist/{interactive-CApktTrj.js.map → interactive-CFGcWw43.js.map} +1 -1
  29. package/dist/{mcp-prompt-streaming-BKcU9yuz.js → mcp-prompt-streaming-XZSpcXkG.js} +9 -6
  30. package/dist/mcp-prompt-streaming-XZSpcXkG.js.map +1 -0
  31. package/dist/{non-interactive-DejTdRTW.js → non-interactive-D6eksWIw.js} +2 -2
  32. package/dist/{non-interactive-DejTdRTW.js.map → non-interactive-D6eksWIw.js.map} +1 -1
  33. package/dist/{package-manager-DBfgSXNn.js → package-manager-Dozr4x6K.js} +2 -2
  34. package/dist/{package-manager-DBfgSXNn.js.map → package-manager-Dozr4x6K.js.map} +1 -1
  35. package/dist/{playground-BOg2U1AT.js → playground-BB2O8GyY.js} +7 -5
  36. package/dist/{playground-BOg2U1AT.js.map → playground-BB2O8GyY.js.map} +1 -1
  37. package/dist/{posthog-Cr37rnla.js → posthog-DU6JXG00.js} +1 -1
  38. package/dist/{posthog-Cr37rnla.js.map → posthog-DU6JXG00.js.map} +1 -1
  39. package/dist/{posthog-integration-gLhOUdPJ.js → posthog-integration-C3m_uR5A.js} +13 -13
  40. package/dist/{posthog-integration-gLhOUdPJ.js.map → posthog-integration-C3m_uR5A.js.map} +1 -1
  41. package/dist/{provisioning-DuzclqPB.js → provisioning-wMzPfaaP.js} +3 -3
  42. package/dist/{provisioning-DuzclqPB.js.map → provisioning-wMzPfaaP.js.map} +1 -1
  43. package/dist/{registry-Dbl-5SnO.js → registry-BfTeAX2z.js} +4 -4
  44. package/dist/{registry-Dbl-5SnO.js.map → registry-BfTeAX2z.js.map} +1 -1
  45. package/dist/{setup-utils-B6wbp3s0.js → setup-utils-B0oz3raQ.js} +53 -11
  46. package/dist/setup-utils-B0oz3raQ.js.map +1 -0
  47. package/dist/smoke-test.sh +25 -0
  48. package/dist/{start-tui-IoQh-Nhj.js → start-tui-B9qDcoGA.js} +151 -31
  49. package/dist/{start-tui-IoQh-Nhj.js.map → start-tui-B9qDcoGA.js.map} +1 -1
  50. package/dist/{steps-CJrqlHbo.js → steps-BhERMRRI.js} +7 -7
  51. package/dist/{steps-CJrqlHbo.js.map → steps-BhERMRRI.js.map} +1 -1
  52. package/dist/store-J2Rv955W.js +763 -0
  53. package/dist/store-J2Rv955W.js.map +1 -0
  54. package/dist/{task-stream-BQNSp0qR.js → task-stream-CPjpHFhI.js} +4 -4
  55. package/dist/{task-stream-BQNSp0qR.js.map → task-stream-CPjpHFhI.js.map} +1 -1
  56. package/dist/{telemetry-1m0CyTry.js → telemetry-BTLJ-YnG.js} +3 -3
  57. package/dist/{telemetry-1m0CyTry.js.map → telemetry-BTLJ-YnG.js.map} +1 -1
  58. package/dist/{terminal-BKI4i72f.js → terminal-UwqFnPrL.js} +87 -786
  59. package/dist/terminal-UwqFnPrL.js.map +1 -0
  60. package/dist/{urls-B3JumpLT.js → urls-DAVzgHGZ.js} +2 -2
  61. package/dist/{urls-B3JumpLT.js.map → urls-DAVzgHGZ.js.map} +1 -1
  62. package/dist/{wizard-abort-D7SzKUgE.js → wizard-abort-BAB8yvGF.js} +1 -1
  63. package/dist/{wizard-abort-PqLMKSh1.js → wizard-abort-DqeMgCVr.js} +4 -3
  64. package/dist/{wizard-abort-PqLMKSh1.js.map → wizard-abort-DqeMgCVr.js.map} +1 -1
  65. package/dist/wizard-session-BKEdX9mO.js +2 -0
  66. package/dist/{wizard-session-G3VWD6hv.js → wizard-session-CN55LYyZ.js} +9 -2
  67. package/dist/{wizard-session-G3VWD6hv.js.map → wizard-session-CN55LYyZ.js.map} +1 -1
  68. package/dist/wizard-ui-WZ48rUgr.js.map +1 -1
  69. package/package.json +1 -1
  70. package/dist/agent-interface-c7B2JZEd.js.map +0 -1
  71. package/dist/agent-runner-Am34bBUT.js.map +0 -1
  72. package/dist/analytics-CBIKy9PZ.js.map +0 -1
  73. package/dist/ci-install-51ntd9x5.js +0 -73
  74. package/dist/ci-install-51ntd9x5.js.map +0 -1
  75. package/dist/mcp-prompt-streaming-BKcU9yuz.js.map +0 -1
  76. package/dist/setup-utils-B6wbp3s0.js.map +0 -1
  77. package/dist/terminal-BKI4i72f.js.map +0 -1
  78. package/dist/wizard-session-wPJtNl4c.js +0 -2
package/dist/bin.js CHANGED
@@ -1,17 +1,17 @@
1
1
  #!/usr/bin/env node
2
- import { I as POSTHOG_DOCS_URL, Q as WIZARD_USER_AGENT, a as getLogFilePath, et as getSkillsBaseUrl, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, tt as VERSION } from "./debug-AdvgwKEw.js";
3
- import { t as analytics } from "./analytics-CBIKy9PZ.js";
4
- import { r as setEntryCommand } from "./telemetry-1m0CyTry.js";
5
- import { n as isUsingTypeScript } from "./setup-utils-B6wbp3s0.js";
6
- import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-B3JumpLT.js";
7
- import { o as handleApiError } from "./api-Blg3nvvZ.js";
8
- import "./wizard-session-G3VWD6hv.js";
9
- import { r as runCleanups } from "./wizard-abort-PqLMKSh1.js";
10
- import { n as isNonInteractiveEnvironment } from "./environment-B6TW5v9d.js";
11
- import { C as AUDIT_CHECKS_FILE, T as AUDIT_REPORT_FILE, c as recoverOrphanedSettingsBackups, g as WIZARD_TOOL_NAMES, h as SETUP_REPORT_FILE, u as AgentSignals, v as fetchSkillMenu, w as AUDIT_CHECKS_KEY } from "./agent-interface-c7B2JZEd.js";
12
- import { i as SPINNER_MESSAGE } from "./registry-Dbl-5SnO.js";
13
- import { _ as parseRequirementsTxt, a as StatusPeekTrigger, c as isClearBlock, d as Colors, f as Icons, g as parsePyprojectToml, h as parsePipfile, i as PRODUCT_SUITE_BLOCK, n as FUNNEL_BLOCK, p as HEALTH_CHECK_STEP, r as LINE_CHART_BLOCK, t as posthogIntegrationConfig } from "./posthog-integration-gLhOUdPJ.js";
14
- import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-8tUk_eEX.js";
2
+ import { I as POSTHOG_DOCS_URL, Q as WIZARD_USER_AGENT, a as getLogFilePath, et as getSkillsBaseUrl, h as LoggingUI, m as setUI, p as getUI, r as debug, s as logToFile, tt as VERSION } from "./debug-Cn4L5Ype.js";
3
+ import { t as analytics } from "./analytics-DQ8IS1Hu.js";
4
+ import { r as setEntryCommand } from "./telemetry-BTLJ-YnG.js";
5
+ import { n as isUsingTypeScript } from "./setup-utils-B0oz3raQ.js";
6
+ import { a as getUiHostFromHost, n as getCloudUrlFromRegion } from "./urls-DAVzgHGZ.js";
7
+ import { o as handleApiError } from "./api-EghEV_u9.js";
8
+ import "./wizard-session-CN55LYyZ.js";
9
+ import { r as runCleanups } from "./wizard-abort-DqeMgCVr.js";
10
+ import { n as isNonInteractiveEnvironment } from "./environment-D2WUIm8o.js";
11
+ import { D as AUDIT_REPORT_FILE, E as AUDIT_CHECKS_KEY, T as AUDIT_CHECKS_FILE, _ as SETUP_REPORT_FILE, b as fetchSkillMenu, f as AgentSignals, l as recoverOrphanedSettingsBackups, v as WIZARD_TOOL_NAMES } from "./agent-interface-BcUv1qeh.js";
12
+ import { i as SPINNER_MESSAGE } from "./registry-BfTeAX2z.js";
13
+ import { _ as parseRequirementsTxt, a as StatusPeekTrigger, c as isClearBlock, d as Colors, f as Icons, g as parsePyprojectToml, h as parsePipfile, i as PRODUCT_SUITE_BLOCK, n as FUNNEL_BLOCK, p as HEALTH_CHECK_STEP, r as LINE_CHART_BLOCK, t as posthogIntegrationConfig } from "./posthog-integration-C3m_uR5A.js";
14
+ import { n as safeReadFile, r as walkProjectFiles, t as IGNORED_DIRS } from "./file-utils-CdQn6073.js";
15
15
  import { n as readApiKeyFromEnv } from "./env-api-key-MlzJYAvt.js";
16
16
  import { satisfies } from "semver";
17
17
  import yargs from "yargs";
@@ -29,6 +29,37 @@ import { createContext, createElement, useCallback, useContext, useEffect, useRe
29
29
  import { jsx, jsxs } from "react/jsx-runtime";
30
30
  import { access, rm } from "node:fs/promises";
31
31
  import * as readline from "node:readline/promises";
32
+ //#region src/lib/headless-mode.ts
33
+ /**
34
+ * Headless mode — the published-build, non-interactive run path.
35
+ *
36
+ * The headless flag and `--ci` both drive a non-interactive install
37
+ * (session.ci === true), but through dedicated entry points so they can
38
+ * diverge: runHeadlessInstall → runWizardHeadless for headless,
39
+ * runCIInstall → runWizardCI for `--ci`. Both delegate to one shared pipeline
40
+ * (runNonInteractive) today; the only forks are the api-key prefixes accepted
41
+ * (ci-install) and the analytics build tag (the mode passed to the runner).
42
+ *
43
+ * The flag is deliberately named `--headless-DONOTUSE-EXPERIMENTAL` and hidden
44
+ * from `--help`: the contract is still unstable and subject to breaking
45
+ * changes, so it must not be advertised or relied on by external callers. This
46
+ * module is the single source of truth for the flag's name and detection — keep
47
+ * the scary name out of every other file so a future rename is one edit here.
48
+ */
49
+ /**
50
+ * The on-CLI flag name. Intentionally ugly + undocumented; do not surface it in
51
+ * `--help`, the README, or user-facing error messages.
52
+ */
53
+ const HEADLESS_FLAG = "headless-DONOTUSE-EXPERIMENTAL";
54
+ /**
55
+ * Read the headless signal off a parsed argv / options bag. yargs always sets
56
+ * the value under the declared key (`HEADLESS_FLAG`), so reading that key is
57
+ * reliable regardless of camel-case expansion.
58
+ */
59
+ function isHeadless(options) {
60
+ return options[HEADLESS_FLAG] === true;
61
+ }
62
+ //#endregion
32
63
  //#region src/commands/command.ts
33
64
  /** Extract the bare command word(s) from a yargs name spec, dropping positionals and aliases' arg syntax. */
34
65
  function commandKeys(name) {
@@ -98,6 +129,12 @@ const GLOBAL_OPTIONS = {
98
129
  describe: "Email address for signup (used with --signup)\nenv: POSTHOG_WIZARD_EMAIL",
99
130
  type: "string"
100
131
  },
132
+ [HEADLESS_FLAG]: {
133
+ default: false,
134
+ describe: "EXPERIMENTAL — do not use. Unstable, subject to breaking changes.",
135
+ type: "boolean",
136
+ hidden: true
137
+ },
101
138
  "local-mcp": {
102
139
  default: false,
103
140
  describe: "Use local MCP server at http://localhost:8787/mcp\nenv: POSTHOG_WIZARD_LOCAL_MCP",
@@ -190,7 +227,7 @@ function runProvision(argv) {
190
227
  }
191
228
  async function provision({ email, region, name, jsonMode }) {
192
229
  try {
193
- const { provisionNewAccount } = await import("./provisioning-DuzclqPB.js").then((n) => n.n);
230
+ const { provisionNewAccount } = await import("./provisioning-wMzPfaaP.js").then((n) => n.n);
194
231
  if (!jsonMode) getUI().log.info(`Provisioning account for ${email} in ${region}...`);
195
232
  emitResult(await provisionNewAccount(email, name, region), jsonMode);
196
233
  process.exit(0);
@@ -248,25 +285,29 @@ const basicIntegrationCommand = {
248
285
  }
249
286
  },
250
287
  check: (argv) => {
251
- if (argv.playground && argv.ci) throw new Error("--playground cannot be combined with --ci.");
288
+ if (argv.playground && (argv.ci || isHeadless(argv))) throw new Error("--playground cannot be combined with a headless run.");
252
289
  return true;
253
290
  },
254
291
  handler: (argv) => {
255
292
  setEntryCommand("integrate");
256
293
  (async () => {
294
+ if (isHeadless(argv)) {
295
+ const { runHeadlessInstall } = await import("./ci-install-ouGSf4zp.js");
296
+ return runHeadlessInstall(argv);
297
+ }
257
298
  if (argv.ci) {
258
- const { runCIInstall } = await import("./ci-install-51ntd9x5.js");
299
+ const { runCIInstall } = await import("./ci-install-ouGSf4zp.js");
259
300
  return runCIInstall(argv);
260
301
  }
261
302
  if (isNonInteractiveEnvironment()) {
262
- const { failNonInteractive } = await import("./non-interactive-DejTdRTW.js");
303
+ const { failNonInteractive } = await import("./non-interactive-D6eksWIw.js");
263
304
  return failNonInteractive();
264
305
  }
265
306
  if (argv.playground) {
266
- const { runPlayground } = await import("./playground-BOg2U1AT.js");
307
+ const { runPlayground } = await import("./playground-BB2O8GyY.js");
267
308
  return runPlayground();
268
309
  }
269
- const { runInteractive } = await import("./interactive-CApktTrj.js");
310
+ const { runInteractive } = await import("./interactive-CFGcWw43.js");
270
311
  runInteractive(argv);
271
312
  })();
272
313
  }
@@ -3216,13 +3257,18 @@ const errorTrackingUploadSourceMapsConfig = {
3216
3257
  * `session.installDir` is a real, readable directory. We deliberately do
3217
3258
  * NOT require the base posthog-integration report to be present — it is a
3218
3259
  * report many users never commit, and `requires: ['posthog-integration']`
3219
- * is metadata, not a hard runtime gate. Real readiness (integration state
3220
- * + beta access) is established by the agent's STEP 1 Signals API probe at
3221
- * the start of the run. The beta gates (the `product-autonomy` access flag
3222
- * and `signals-scout` enrollment — PostHog-side flag names, unchanged by
3223
- * the wizard-side "self-driving" rename) are PostHog-internal flags with no
3224
- * customer-facing read API, which is why that probe lives in the run and
3225
- * emits a structured `[ABORT]` when the product is not available.
3260
+ * is metadata, not a hard runtime gate.
3261
+ *
3262
+ * Self-driving is now in OPEN beta — available to every team — so STEP 1
3263
+ * no longer probes the Signals API as an access gate; it completes
3264
+ * instantly so the run opens with a fast first checkmark. The
3265
+ * `self-driving is not available for this project` abort below is kept
3266
+ * only as a safety net: if the Signals API genuinely can't be reached
3267
+ * during the run (a hard error that is unexpected in open beta), the skill
3268
+ * emits it and the wizard renders a friendly "try again" screen — now with
3269
+ * open-beta wording, not the old closed, per-team "join the beta" copy. The
3270
+ * PostHog-side flags (`product-autonomy`, `signals-scout`) are unchanged by
3271
+ * the wizard-side "self-driving" rename.
3226
3272
  */
3227
3273
  /**
3228
3274
  * `[ABORT] <reason>` cases the self-driving skill can emit. The
@@ -3233,7 +3279,7 @@ const SELF_DRIVING_ABORT_CASES = [
3233
3279
  {
3234
3280
  match: /^self-driving is not available for this project$/i,
3235
3281
  message: "PostHog Self-driving is not available for this project",
3236
- body: "Self-driving is in beta and is enabled per team by PostHog. This project does not appear to have access yet. Reach out to your PostHog contact (or wizard@posthog.com) to join the beta, then run the wizard again."
3282
+ body: "Self-driving is in open beta and available to every team, so this is unexpected — the PostHog Signals API could not be reached for this project. Nothing was changed. Try again in a moment, and if it keeps happening reach out to wizard@posthog.com."
3237
3283
  },
3238
3284
  {
3239
3285
  match: /^github connection declined$/i,
@@ -3389,8 +3435,13 @@ Wizard mechanics:
3389
3435
  Follow these steps IN ORDER. Do not skip or reorder.
3390
3436
 
3391
3437
  STEP 1 — Check Self-driving access. (skill: "Check access")
3392
- Probe the Signals API as the skill describes. If the API is not
3393
- available for this project (permission or not-found errors), emit
3438
+ Self-driving is in open beta and available to every team, so there is
3439
+ no access gate to probe. Do NOT call any MCP tool here — mark this task
3440
+ in_progress and then completed right away and emit the
3441
+ ${AgentSignals.STATUS} line, so the user sees an immediate first step.
3442
+ Only if the Signals API later turns out to be genuinely unreachable for
3443
+ this project (a hard error on every Signals call, unexpected in open
3444
+ beta) should you emit
3394
3445
  ${AgentSignals.ABORT} self-driving is not available for this project
3395
3446
  and halt.
3396
3447
 
@@ -3790,8 +3841,8 @@ function runMcpAdd(argv) {
3790
3841
  const debug = argv.debug;
3791
3842
  const localMcp = argv.local;
3792
3843
  try {
3793
- const { startTUI } = await import("./start-tui-IoQh-Nhj.js");
3794
- const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
3844
+ const { startTUI } = await import("./start-tui-B9qDcoGA.js");
3845
+ const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
3795
3846
  const tui = startTUI(VERSION, Program.McpAdd);
3796
3847
  tui.store.session = buildSession({
3797
3848
  debug,
@@ -3802,7 +3853,7 @@ function runMcpAdd(argv) {
3802
3853
  } catch (error) {
3803
3854
  if (!isTUIUnavailable(error)) throw error;
3804
3855
  setUI(new LoggingUI());
3805
- const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-Dc0yssCM.js").then((n) => n.r);
3856
+ const { addMCPServerToClientsStep } = await import("./add-mcp-server-to-clients-BjH4z7gH.js").then((n) => n.r);
3806
3857
  await addMCPServerToClientsStep({
3807
3858
  local: localMcp,
3808
3859
  features,
@@ -3841,8 +3892,8 @@ function runMcpRemove(argv) {
3841
3892
  const debug = argv.debug;
3842
3893
  const localMcp = argv.local;
3843
3894
  try {
3844
- const { startTUI } = await import("./start-tui-IoQh-Nhj.js");
3845
- const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
3895
+ const { startTUI } = await import("./start-tui-B9qDcoGA.js");
3896
+ const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
3846
3897
  const tui = startTUI(VERSION, Program.McpRemove);
3847
3898
  tui.store.session = buildSession({
3848
3899
  debug,
@@ -3850,7 +3901,7 @@ function runMcpRemove(argv) {
3850
3901
  });
3851
3902
  } catch {
3852
3903
  setUI(new LoggingUI());
3853
- const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-Dc0yssCM.js").then((n) => n.r);
3904
+ const { removeMCPServerFromClientsStep } = await import("./add-mcp-server-to-clients-BjH4z7gH.js").then((n) => n.r);
3854
3905
  await removeMCPServerFromClientsStep({ local: localMcp });
3855
3906
  }
3856
3907
  })();
@@ -3872,8 +3923,8 @@ function runMcpTutorial(argv) {
3872
3923
  const debug = argv.debug;
3873
3924
  const localMcp = argv.local;
3874
3925
  try {
3875
- const { startTUI } = await import("./start-tui-IoQh-Nhj.js");
3876
- const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
3926
+ const { startTUI } = await import("./start-tui-B9qDcoGA.js");
3927
+ const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
3877
3928
  const tui = startTUI(VERSION, Program.McpTutorial);
3878
3929
  tui.store.session = buildSession({
3879
3930
  debug,
@@ -3927,10 +3978,10 @@ function runWizard(config, options) {
3927
3978
  (async () => {
3928
3979
  try {
3929
3980
  const installDir = options.installDir || process.cwd();
3930
- const { startTUI } = await import("./start-tui-IoQh-Nhj.js");
3931
- const { buildSession, RunPhase } = await import("./wizard-session-wPJtNl4c.js");
3932
- const { TaskStreamPush } = await import("./task-stream-BQNSp0qR.js");
3933
- const { PostHogDestination } = await import("./posthog-Cr37rnla.js");
3981
+ const { startTUI } = await import("./start-tui-B9qDcoGA.js");
3982
+ const { buildSession, RunPhase } = await import("./wizard-session-BKEdX9mO.js");
3983
+ const { TaskStreamPush } = await import("./task-stream-CPjpHFhI.js");
3984
+ const { PostHogDestination } = await import("./posthog-DU6JXG00.js");
3934
3985
  tui = startTUI(WIZARD_VERSION, config.id);
3935
3986
  const activeTui = tui;
3936
3987
  const session = buildSession({
@@ -3983,7 +4034,7 @@ function runWizard(config, options) {
3983
4034
  await activeTui.store.getGate("health-check");
3984
4035
  const skipAgent = config.run == null;
3985
4036
  if (skipAgent) {
3986
- const { getOrAskForProjectData } = await import("./setup-utils-B6wbp3s0.js").then((n) => n.r);
4037
+ const { getOrAskForProjectData } = await import("./setup-utils-B0oz3raQ.js").then((n) => n.r);
3987
4038
  const { projectApiKey, host, accessToken, projectId } = await getOrAskForProjectData({
3988
4039
  signup: session.signup,
3989
4040
  ci: session.ci,
@@ -3998,7 +4049,7 @@ function runWizard(config, options) {
3998
4049
  projectId
3999
4050
  });
4000
4051
  } else {
4001
- const { runAgent } = await import("./agent-runner-Am34bBUT.js");
4052
+ const { runAgent } = await import("./agent-runner-8g_pDAVs.js");
4002
4053
  await runAgent(config, activeTui.store.session);
4003
4054
  }
4004
4055
  const isDone = () => skipAgent ? activeTui.store.session.outroDismissed : activeTui.store.session.skillsComplete;
@@ -4041,44 +4092,57 @@ function runWizard(config, options) {
4041
4092
  })();
4042
4093
  }
4043
4094
  //#endregion
4044
- //#region src/lib/runners/run-wizard-ci.ts
4095
+ //#region src/lib/runners/run-non-interactive.ts
4096
+ /** User-facing label for a non-interactive mode. */
4097
+ function modeLabel(mode) {
4098
+ return mode === "headless" ? "Headless" : "CI";
4099
+ }
4045
4100
  /**
4046
- * The single CI validation layer: defaults region and requires api-key and
4047
- * install-dir. Every CI entry point routes through `runWizardCI`, so this is
4048
- * the one place these checks live. UI must be initialized before calling.
4101
+ * The single non-interactive validation layer: defaults region and requires
4102
+ * api-key and install-dir. Every non-interactive entry point routes through
4103
+ * `runNonInteractive`, so this is the one place these checks live. UI must be
4104
+ * initialized before calling.
4049
4105
  */
4050
- function validateCiOptions(options) {
4106
+ function validateNonInteractiveOptions(options, mode) {
4107
+ const label = modeLabel(mode);
4108
+ const keyHint = mode === "headless" ? "personal API key phx_xxx or pha_ OAuth access token" : "personal API key phx_xxx";
4051
4109
  if (!options.region) options.region = "us";
4052
4110
  if (!options.apiKey) {
4053
4111
  getUI().intro("PostHog Wizard");
4054
- getUI().log.error("CI mode requires --api-key (personal API key phx_xxx)");
4112
+ getUI().log.error(`${label} mode requires --api-key (${keyHint})`);
4055
4113
  process.exit(1);
4056
4114
  }
4057
4115
  if (!options.installDir) {
4058
4116
  getUI().intro("PostHog Wizard");
4059
- getUI().log.error("CI mode requires --install-dir (directory to install in)");
4117
+ getUI().log.error(`${label} mode requires --install-dir (directory to install in)`);
4060
4118
  process.exit(1);
4061
4119
  }
4062
4120
  }
4063
4121
  /**
4064
- * CI-mode pipeline shared by every non-interactive entry point.
4122
+ * Non-interactive pipeline shared by CI (`runWizardCI`) and headless
4123
+ * (`runWizardHeadless`) runs.
4065
4124
  *
4066
4125
  * Validates flags, builds a `ci:true` session, runs `config.ciPreRun` (or the
4067
4126
  * program's `onReady` hooks by default), executes `runAgent`, and routes any
4068
4127
  * failure through `wizardAbort`. `wizardAbort` owns all exits — never add a
4069
4128
  * raw `process.exit` here.
4129
+ *
4130
+ * `mode` is the only difference between the two callers today (it sets the
4131
+ * analytics build tag and the user-facing label). Keeping it a parameter is
4132
+ * what lets CI and headless share this body now and diverge later — branch on
4133
+ * `mode` here, or stop sharing this function entirely.
4070
4134
  */
4071
- function runWizardCI(config, options) {
4135
+ function runNonInteractive(config, options, mode) {
4072
4136
  setUI(new LoggingUI());
4073
- validateCiOptions(options);
4074
- analytics.setTag("build", "ci");
4137
+ validateNonInteractiveOptions(options, mode);
4138
+ analytics.setTag("build", mode);
4075
4139
  (async () => {
4076
4140
  const path = await import("path");
4077
- const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
4078
- const { readEnvironment } = await import("./environment-B6TW5v9d.js").then((n) => n.t);
4141
+ const { buildSession, RunPhase, OutroKind } = await import("./wizard-session-BKEdX9mO.js");
4142
+ const { readEnvironment } = await import("./environment-D2WUIm8o.js").then((n) => n.t);
4079
4143
  const { readApiKeyFromEnv } = await import("./env-api-key-MlzJYAvt.js").then((n) => n.t);
4080
- const { configureLogFileFromEnvironment, logToFile } = await import("./debug-cy_jyRb4.js");
4081
- const { wizardAbort, WizardError } = await import("./wizard-abort-D7SzKUgE.js");
4144
+ const { configureLogFileFromEnvironment, logToFile } = await import("./debug-BM7yop-T.js");
4145
+ const { wizardAbort, WizardError } = await import("./wizard-abort-BAB8yvGF.js");
4082
4146
  configureLogFileFromEnvironment();
4083
4147
  const env = readEnvironment();
4084
4148
  const apiKey = options.apiKey ?? readApiKeyFromEnv() ?? void 0;
@@ -4101,7 +4165,34 @@ function runWizardCI(config, options) {
4101
4165
  if (config.skillId) session.skillId = config.skillId;
4102
4166
  const runDef = typeof config.run === "object" ? config.run : null;
4103
4167
  getUI().intro("Welcome to the PostHog setup wizard");
4104
- getUI().log.info(`Running ${config.id} in CI mode`);
4168
+ getUI().log.info(`Running ${config.id} in ${modeLabel(mode)} mode`);
4169
+ let store = null;
4170
+ let taskStream = null;
4171
+ if (mode === "headless") {
4172
+ const { WizardStore } = await import("./store-J2Rv955W.js").then((n) => n.n);
4173
+ const { HeadlessUI } = await import("./headless-ui-CSqtmW-d.js");
4174
+ const { TaskStreamPush, PostHogDestination } = await import("./task-stream-CPjpHFhI.js");
4175
+ store = new WizardStore(config.id);
4176
+ store.session = session;
4177
+ setUI(new HeadlessUI(store));
4178
+ taskStream = new TaskStreamPush({
4179
+ store,
4180
+ programId: config.id,
4181
+ destinations: [new PostHogDestination({
4182
+ getCredentials: () => session.credentials,
4183
+ onError: (e) => logToFile("[headless task-stream]", e.message)
4184
+ })],
4185
+ enabled: !session.noTelemetry
4186
+ });
4187
+ taskStream.attach();
4188
+ store.setRunPhase(RunPhase.Running);
4189
+ }
4190
+ const settleStream = async (phase, outroData) => {
4191
+ if (!store || !taskStream) return;
4192
+ if (outroData) store.setOutroData(outroData);
4193
+ store.setRunPhase(phase);
4194
+ await taskStream.shutdown(2e3);
4195
+ };
4105
4196
  try {
4106
4197
  if (config.ciPreRun) await config.ciPreRun(session);
4107
4198
  else {
@@ -4121,24 +4212,36 @@ function runWizardCI(config, options) {
4121
4212
  };
4122
4213
  for (const step of config.steps) if (step.onReady) await step.onReady(readyCtx);
4123
4214
  const detectError = session.frameworkContext.detectError;
4124
- if (detectError) await wizardAbort({
4125
- message: `Prerequisites not met: ${detectError.kind}\n\nSee ${runDef?.docsUrl ?? "https://posthog.com/docs"}`,
4126
- error: new WizardError(`${config.id} prerequisites failed`, {
4127
- integration: config.id,
4128
- detect_error_kind: detectError.kind
4129
- })
4130
- });
4215
+ if (detectError) {
4216
+ await settleStream(RunPhase.Error, {
4217
+ kind: OutroKind.Error,
4218
+ message: `Prerequisites not met: ${detectError.kind}`
4219
+ });
4220
+ await wizardAbort({
4221
+ message: `Prerequisites not met: ${detectError.kind}\n\nSee ${runDef?.docsUrl ?? "https://posthog.com/docs"}`,
4222
+ error: new WizardError(`${config.id} prerequisites failed`, {
4223
+ integration: config.id,
4224
+ detect_error_kind: detectError.kind
4225
+ })
4226
+ });
4227
+ }
4131
4228
  }
4132
- const { runAgent } = await import("./agent-runner-Am34bBUT.js");
4229
+ const { runAgent } = await import("./agent-runner-8g_pDAVs.js");
4133
4230
  await runAgent(config, session);
4231
+ await settleStream(RunPhase.Completed);
4134
4232
  } catch (error) {
4135
4233
  const errorMessage = error instanceof Error ? error.message : String(error);
4136
4234
  const errorStack = error instanceof Error && error.stack ? error.stack : void 0;
4137
- logToFile(`[bin.ts CI] ERROR: ${errorMessage}`);
4138
- if (errorStack) logToFile(`[bin.ts CI] STACK: ${errorStack}`);
4235
+ logToFile(`[${mode}] ERROR: ${errorMessage}`);
4236
+ if (errorStack) logToFile(`[${mode}] STACK: ${errorStack}`);
4139
4237
  const debugInfo = session.debug && errorStack ? `\n\n${errorStack}` : "";
4238
+ const docsUrl = session.frameworkConfig?.metadata.docsUrl ?? runDef?.docsUrl ?? "https://posthog.com/docs";
4239
+ await settleStream(RunPhase.Error, {
4240
+ kind: OutroKind.Error,
4241
+ message: errorMessage
4242
+ });
4140
4243
  await wizardAbort({
4141
- message: `Something went wrong: ${errorMessage}\n\nYou can read the documentation at ${session.frameworkConfig?.metadata.docsUrl ?? runDef?.docsUrl ?? "https://posthog.com/docs"} to set up manually.${debugInfo}`,
4244
+ message: `Something went wrong: ${errorMessage}\n\nYou can read the documentation at ${docsUrl} to set up manually.${debugInfo}`,
4142
4245
  error
4143
4246
  });
4144
4247
  }
@@ -4147,6 +4250,31 @@ function runWizardCI(config, options) {
4147
4250
  });
4148
4251
  }
4149
4252
  //#endregion
4253
+ //#region src/lib/runners/run-wizard-ci.ts
4254
+ /**
4255
+ * CI-mode entry point (`--ci`, dev/test builds). A thin shell over the shared
4256
+ * non-interactive pipeline — see `runNonInteractive`. Kept as its own function
4257
+ * so CI and headless (`runWizardHeadless`) can diverge without re-threading the
4258
+ * many callers that route here.
4259
+ */
4260
+ function runWizardCI(config, options) {
4261
+ runNonInteractive(config, options, "ci");
4262
+ }
4263
+ //#endregion
4264
+ //#region src/lib/runners/run-wizard-headless.ts
4265
+ /**
4266
+ * Headless entry point (the experimental published-build, non-interactive run
4267
+ * path; see @lib/headless-mode). A thin shell over the shared non-interactive
4268
+ * pipeline — see `runNonInteractive`. Today it behaves exactly like
4269
+ * `runWizardCI`; it exists as a separate function so headless can diverge later
4270
+ * (its own auth handling, telemetry, prompts, …) without touching CI or its
4271
+ * callers. Diverge by branching on the mode inside `runNonInteractive`, or by
4272
+ * giving this function its own body.
4273
+ */
4274
+ function runWizardHeadless(config, options) {
4275
+ runNonInteractive(config, options, "headless");
4276
+ }
4277
+ //#endregion
4150
4278
  //#region src/commands/skill-program-options.ts
4151
4279
  /**
4152
4280
  * Per-command options shared by every skill-based program command
@@ -5025,7 +5153,7 @@ async function runDoctorCI(options) {
5025
5153
  getUI().intro("Welcome to the PostHog setup wizard");
5026
5154
  getUI().log.info("Running posthog-doctor in CI mode");
5027
5155
  try {
5028
- const { getOrAskForProjectData } = await import("./setup-utils-B6wbp3s0.js").then((n) => n.r);
5156
+ const { getOrAskForProjectData } = await import("./setup-utils-B0oz3raQ.js").then((n) => n.r);
5029
5157
  const { host, accessToken, projectId } = await getOrAskForProjectData({
5030
5158
  signup: false,
5031
5159
  ci: true,
@@ -5042,7 +5170,7 @@ async function runDoctorCI(options) {
5042
5170
  for (const issue of sorted) getUI().log.info(` • [${issue.severity}] ${getKindMeta(issue.kind).title}`);
5043
5171
  process.exit(1);
5044
5172
  } catch (error) {
5045
- const { ApiError } = await import("./api-Blg3nvvZ.js").then((n) => n.n);
5173
+ const { ApiError } = await import("./api-EghEV_u9.js").then((n) => n.n);
5046
5174
  const message = error instanceof ApiError && error.statusCode === 401 ? "Your PostHog API key is invalid or expired." : error instanceof Error ? error.message : String(error);
5047
5175
  getUI().log.error(`Doctor failed: ${message}`);
5048
5176
  process.exit(1);
@@ -5119,8 +5247,8 @@ function runSlackConnect(argv) {
5119
5247
  (async () => {
5120
5248
  const debug = argv.debug;
5121
5249
  try {
5122
- const { startTUI } = await import("./start-tui-IoQh-Nhj.js");
5123
- const { buildSession } = await import("./wizard-session-wPJtNl4c.js");
5250
+ const { startTUI } = await import("./start-tui-B9qDcoGA.js");
5251
+ const { buildSession } = await import("./wizard-session-BKEdX9mO.js");
5124
5252
  const tui = startTUI(VERSION, Program.SlackConnect);
5125
5253
  tui.store.session = buildSession({ debug });
5126
5254
  } catch (err) {
@@ -5498,6 +5626,6 @@ function resolveInstallDir() {
5498
5626
  }
5499
5627
  Wizard.use(basicIntegrationCommand).use(mcpCommand).use(mcpAnalyticsCommand).use(cliCommand).use(auditCommand).use(doctorCommand).use(migrateCommand).use(revenueCommand).use(warehouseCommand).use(selfDrivingCommand).use(slackCommand).use(uploadSourcemapsCommand).use(skillCommand).init();
5500
5628
  //#endregion
5501
- export { getDetectedWarehouseSources as _, ConfirmButton as a, STRIPE_SDKS as b, runWizard as c, getProgramConfig as d, AUTOMATABLE_VARIANTS as f, fetchHealthIssues as g, getKindMeta as h, useKeyboardHintsContext as i, PROGRAM_REGISTRY as l, SOURCE_MAPS_CONTEXT_KEYS as m, useKeyBindings as n, PromptLabel as o, DISPLAY_NAME as p, KeyboardHintsProvider as r, runWizardCI as s, PickerMenu as t, Program as u, getContentBlocks$2 as v, POSTHOG_SDKS as y };
5629
+ export { fetchHealthIssues as _, ConfirmButton as a, POSTHOG_SDKS as b, runWizardCI as c, Program as d, getProgramConfig as f, getKindMeta as g, SOURCE_MAPS_CONTEXT_KEYS as h, useKeyboardHintsContext as i, runWizard as l, DISPLAY_NAME as m, useKeyBindings as n, PromptLabel as o, AUTOMATABLE_VARIANTS as p, KeyboardHintsProvider as r, runWizardHeadless as s, PickerMenu as t, PROGRAM_REGISTRY as u, getDetectedWarehouseSources as v, STRIPE_SDKS as x, getContentBlocks$2 as y };
5502
5630
 
5503
5631
  //# sourceMappingURL=bin.js.map