@posthog/wizard 2.56.0 → 2.58.0

package/dist/{posthog-DDLIrku0.js → posthog-Dz1JvV4p.js}

@@ -1,3 +1,4 @@
+import { s as logToFile } from "./debug-Di-I0xld.js";
 //#region src/lib/task-stream/destinations/posthog.ts
 const MAX_ATTEMPTS = 3;
 const BASE_BACKOFF_MS = 500;
@@ -74,7 +75,10 @@ var PostHogDestination = class {
 				backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);
 				continue;
 			}
-			if (response.ok) return;
+			if (response.ok) {
+				logToFile(`[task-stream] wizard/sessions push ok: ${response.status}`);
+				return;
+			}
 			const status = response.status;
 			if (status === 401 || status === 403) {
 				this.disabled = true;
@@ -117,4 +121,4 @@ var PostHogDestination = class {
 //#endregion
 export { PostHogDestination };
 
-//# sourceMappingURL=posthog-DDLIrku0.js.map
+//# sourceMappingURL=posthog-Dz1JvV4p.js.map

package/dist/posthog-Dz1JvV4p.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-Dz1JvV4p.js","names":[],"sources":["../src/lib/task-stream/destinations/posthog.ts"],"sourcesContent":["/**\n * PostHog destination — pushes wizard run state to the PostHog backend\n * via `POST /api/projects/{project_id}/wizard/sessions/`.\n *\n * The endpoint is an upsert keyed by `(team, session_id)`: 201 means\n * the row was created, 200 means it was updated. Both are success.\n *\n * Failure handling is fail-silent: never throws to the caller, never\n * writes to stdout/stderr, never blocks the agent. Errors flow through\n * the optional `onError` callback for the wizard's debug log.\n *\n * Retry policy:\n *   5xx / network    → exponential backoff base 500ms cap 8s, max 3 attempts\n *   429              → honour `Retry-After` (seconds), single retry\n *   401 / 403        → disable for the rest of the run, no further pushes\n *   400              → give up for this push, do not disable\n *   other 4xx        → give up for this push, do not disable\n */\n\nimport type {\n  TaskStreamDestination,\n  TaskStreamUpdate,\n  StreamEvent,\n} from '@lib/task-stream/types';\nimport type { Credentials } from '@lib/wizard-session';\nimport { logToFile } from '@utils/debug';\n\nexport interface PostHogDestinationOptions {\n  /**\n   * Lazy credential resolver — called on every send. Returns null\n   * before authentication has completed; in that case the send is a\n   * no-op (no HTTP request).\n   */\n  getCredentials: () => Credentials | null;\n  /** Receives every error for the wizard's internal logfile. */\n  onError?: (err: Error) => void;\n  /** Override for tests. Defaults to global fetch. */\n  fetchImpl?: typeof fetch;\n  /** Override for tests. Defaults to setTimeout. */\n  sleep?: (ms: number) => Promise<void>;\n}\n\nconst MAX_ATTEMPTS = 3;\nconst BASE_BACKOFF_MS = 500;\nconst MAX_BACKOFF_MS = 8000;\nconst DEFAULT_RETRY_AFTER_MS = 1000;\n// setTimeout silently clamps anything above 2^31-1 ms to fire\n// immediately, so any Retry-After-derived sleep must be capped.\nconst MAX_RETRY_AFTER_MS = 60_000;\n\nfunction defaultSleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nfunction parseRetryAfter(value: string | null): number {\n  if (!value) return DEFAULT_RETRY_AFTER_MS;\n  const seconds = Number(value);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return Math.min(Math.ceil(seconds * 1000), MAX_RETRY_AFTER_MS);\n  }\n  // HTTP-date form — best-effort.\n  const date = Date.parse(value);\n  if (Number.isFinite(date)) {\n    return Math.min(Math.max(0, date - Date.now()), MAX_RETRY_AFTER_MS);\n  }\n  return DEFAULT_RETRY_AFTER_MS;\n}\n\n/**\n * Strip the internal-only `timestamp` field before sending. The\n * backend schema in the RFC does not define it.\n */\nfunction toWirePayload(\n  payload: TaskStreamUpdate,\n): Omit<TaskStreamUpdate, 'timestamp'> {\n  // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  const { timestamp: _unused, ...rest } = payload;\n  return rest;\n}\n\nexport class PostHogDestination implements TaskStreamDestination {\n  readonly name = 'posthog';\n\n  private readonly getCredentials: () => Credentials | null;\n  private readonly onError: (err: Error) => void;\n  private readonly fetchImpl: typeof fetch;\n  private readonly sleep: (ms: number) => Promise<void>;\n\n  private disabled = false;\n\n  constructor(opts: PostHogDestinationOptions) {\n    this.getCredentials = opts.getCredentials;\n    this.onError = opts.onError ?? (() => undefined);\n    this.fetchImpl = opts.fetchImpl ?? ((...args) => fetch(...args));\n    this.sleep = opts.sleep ?? defaultSleep;\n  }\n\n  async send(_event: StreamEvent, payload: TaskStreamUpdate): Promise<void> {\n    if (this.disabled) return;\n    const creds = this.getCredentials();\n    if (!creds) return;\n\n    await this.postWithRetry(creds, toWirePayload(payload));\n  }\n\n  private buildRequest(\n    creds: Credentials,\n    body: object,\n  ): { url: string; init: Parameters<typeof fetch>[1] } {\n    const url = `${creds.host.apiHost.replace(/\\/$/, '')}/api/projects/${\n      creds.projectId\n    }/wizard/sessions/`;\n    return {\n      url,\n      init: {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${creds.accessToken}`,\n        },\n        body: JSON.stringify(body),\n      },\n    };\n  }\n\n  private async postWithRetry(creds: Credentials, body: object): Promise<void> {\n    const { url, init } = this.buildRequest(creds, body);\n    let attempt = 0;\n    let backoff = BASE_BACKOFF_MS;\n    let retriedAfter429 = false;\n\n    while (attempt < MAX_ATTEMPTS) {\n      attempt += 1;\n      let response: Response;\n      try {\n        response = await this.fetchImpl(url, init);\n      } catch (err) {\n        if (attempt >= MAX_ATTEMPTS) {\n          this.onError(err instanceof Error ? err : new Error(String(err)));\n          return;\n        }\n        await this.sleep(backoff);\n        backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);\n        continue;\n      }\n\n      if (response.ok) {\n        logToFile(`[task-stream] wizard/sessions push ok: ${response.status}`);\n        return;\n      }\n\n      const status = response.status;\n\n      if (status === 401 || status === 403) {\n        this.disabled = true;\n        this.onError(new Error(`wizard/sessions auth failed: ${status}`));\n        return;\n      }\n\n      if (status === 429) {\n        if (retriedAfter429) {\n          this.onError(new Error('wizard/sessions rate limited'));\n          return;\n        }\n        retriedAfter429 = true;\n        const wait = parseRetryAfter(response.headers.get('Retry-After'));\n        await this.sleep(wait);\n        // Don't count this against the 5xx attempt budget.\n        attempt -= 1;\n        continue;\n      }\n\n      if (status >= 500) {\n        if (attempt >= MAX_ATTEMPTS) {\n          this.onError(new Error(`wizard/sessions server error: ${status}`));\n          return;\n        }\n        await this.sleep(backoff);\n        backoff = Math.min(backoff * 2, MAX_BACKOFF_MS);\n        continue;\n      }\n\n      if (status === 400) {\n        let detail = '';\n        try {\n          detail = await response.text();\n        } catch {\n          // ignore\n        }\n        this.onError(new Error(`wizard/sessions bad request (400): ${detail}`));\n        return;\n      }\n\n      this.onError(new Error(`wizard/sessions unexpected status: ${status}`));\n      return;\n    }\n  }\n}\n"],"mappings":";;AA0CA,MAAM,eAAe;AACrB,MAAM,kBAAkB;AACxB,MAAM,iBAAiB;AACvB,MAAM,yBAAyB;AAG/B,MAAM,qBAAqB;AAE3B,SAAS,aAAa,IAA2B;AAC/C,QAAO,IAAI,SAAS,YAAY,WAAW,SAAS,GAAG,CAAC;;AAG1D,SAAS,gBAAgB,OAA8B;AACrD,KAAI,CAAC,MAAO,QAAO;CACnB,MAAM,UAAU,OAAO,MAAM;AAC7B,KAAI,OAAO,SAAS,QAAQ,IAAI,WAAW,EACzC,QAAO,KAAK,IAAI,KAAK,KAAK,UAAU,IAAK,EAAE,mBAAmB;CAGhE,MAAM,OAAO,KAAK,MAAM,MAAM;AAC9B,KAAI,OAAO,SAAS,KAAK,CACvB,QAAO,KAAK,IAAI,KAAK,IAAI,GAAG,OAAO,KAAK,KAAK,CAAC,EAAE,mBAAmB;AAErE,QAAO;;;;;;AAOT,SAAS,cACP,SACqC;CAErC,MAAM,EAAE,WAAW,SAAS,GAAG,SAAS;AACxC,QAAO;;AAGT,IAAa,qBAAb,MAAiE;CAC/D,OAAgB;CAEhB;CACA;CACA;CACA;CAEA,WAAmB;CAEnB,YAAY,MAAiC;AAC3C,OAAK,iBAAiB,KAAK;AAC3B,OAAK,UAAU,KAAK,kBAAkB,KAAA;AACtC,OAAK,YAAY,KAAK,eAAe,GAAG,SAAS,MAAM,GAAG,KAAK;AAC/D,OAAK,QAAQ,KAAK,SAAS;;CAG7B,MAAM,KAAK,QAAqB,SAA0C;AACxE,MAAI,KAAK,SAAU;EACnB,MAAM,QAAQ,KAAK,gBAAgB;AACnC,MAAI,CAAC,MAAO;AAEZ,QAAM,KAAK,cAAc,OAAO,cAAc,QAAQ,CAAC;;CAGzD,aACE,OACA,MACoD;AAIpD,SAAO;GACL,KAJU,GAAG,MAAM,KAAK,QAAQ,QAAQ,OAAO,GAAG,CAAC,gBACnD,MAAM,UACP;GAGC,MAAM;IACJ,QAAQ;IACR,SAAS;KACP,gBAAgB;KAChB,eAAe,UAAU,MAAM;KAChC;IACD,MAAM,KAAK,UAAU,KAAK;IAC3B;GACF;;CAGH,MAAc,cAAc,OAAoB,MAA6B;EAC3E,MAAM,EAAE,KAAK,SAAS,KAAK,aAAa,OAAO,KAAK;EACpD,IAAI,UAAU;EACd,IAAI,UAAU;EACd,IAAI,kBAAkB;AAEtB,SAAO,UAAU,cAAc;AAC7B,cAAW;GACX,IAAI;AACJ,OAAI;AACF,eAAW,MAAM,KAAK,UAAU,KAAK,KAAK;YACnC,KAAK;AACZ,QAAI,WAAW,cAAc;AAC3B,UAAK,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,IAAI,CAAC,CAAC;AACjE;;AAEF,UAAM,KAAK,MAAM,QAAQ;AACzB,cAAU,KAAK,IAAI,UAAU,GAAG,eAAe;AAC/C;;AAGF,OAAI,SAAS,IAAI;AACf,cAAU,0CAA0C,SAAS,SAAS;AACtE;;GAGF,MAAM,SAAS,SAAS;AAExB,OAAI,WAAW,OAAO,WAAW,KAAK;AACpC,SAAK,WAAW;AAChB,SAAK,wBAAQ,IAAI,MAAM,gCAAgC,SAAS,CAAC;AACjE;;AAGF,OAAI,WAAW,KAAK;AAClB,QAAI,iBAAiB;AACnB,UAAK,wBAAQ,IAAI,MAAM,+BAA+B,CAAC;AACvD;;AAEF,sBAAkB;IAClB,MAAM,OAAO,gBAAgB,SAAS,QAAQ,IAAI,cAAc,CAAC;AACjE,UAAM,KAAK,MAAM,KAAK;AAEtB,eAAW;AACX;;AAGF,OAAI,UAAU,KAAK;AACjB,QAAI,WAAW,cAAc;AAC3B,UAAK,wBAAQ,IAAI,MAAM,iCAAiC,SAAS,CAAC;AAClE;;AAEF,UAAM,KAAK,MAAM,QAAQ;AACzB,cAAU,KAAK,IAAI,UAAU,GAAG,eAAe;AAC/C;;AAGF,OAAI,WAAW,KAAK;IAClB,IAAI,SAAS;AACb,QAAI;AACF,cAAS,MAAM,SAAS,MAAM;YACxB;AAGR,SAAK,wBAAQ,IAAI,MAAM,sCAAsC,SAAS,CAAC;AACvE;;AAGF,QAAK,wBAAQ,IAAI,MAAM,sCAAsC,SAAS,CAAC;AACvE"}

package/dist/{posthog-integration-Cdwv-ohr.js → posthog-integration-BbzluO9E.js}

@@ -1,16 +1,16 @@
-import { L as Integration, N as HAIKU_MODEL, O as DETECTION_TIMEOUT_MS, _ as evaluateWizardReadiness, at as WIZARD_INTERACTION_EVENT_NAME, f as getUI, g as SIGNUP_WIZARD_READINESS_CONFIG, pt as getSkillsBaseUrl, s as logToFile, v as getBlockingServiceKeys, x as AGENTIC_DETECTION_TIMEOUT_MS } from "./debug-B6VsAfeE.js";
-import { n as analytics } from "./analytics-Bcj98zOG.js";
-import { i as withUtm, n as openTrackedLink } from "./telemetry-JfMjqBNP.js";
-import { a as safeReadFile, i as readProjectFile, o as walkProjectFiles } from "./bounded-fs-DZEUmLFS.js";
-import { i as tryGetPackageJson, n as isUsingTypeScript } from "./setup-utils-Bh_HUFPV.js";
-import { i as requestDeepLink } from "./provisioning-sDvZgL0E.js";
+import { L as Integration, N as HAIKU_MODEL, O as DETECTION_TIMEOUT_MS, _ as evaluateWizardReadiness, at as WIZARD_INTERACTION_EVENT_NAME, f as getUI, g as SIGNUP_WIZARD_READINESS_CONFIG, pt as getSkillsBaseUrl, s as logToFile, v as getBlockingServiceKeys, x as AGENTIC_DETECTION_TIMEOUT_MS } from "./debug-Di-I0xld.js";
+import { n as analytics } from "./analytics-Bvq5-kCh.js";
+import { i as withUtm, n as openTrackedLink } from "./telemetry-C5Aokvv-.js";
+import { a as safeReadFile, i as readProjectFile, o as walkProjectFiles } from "./bounded-fs-B4JlDu5o.js";
+import { i as tryGetPackageJson, n as isUsingTypeScript } from "./setup-utils-DJzrAj8A.js";
+import { i as requestDeepLink } from "./provisioning-BiZdXls3.js";
 import "./wizard-session-CwgR5y3-.js";
-import { i as wizardAbort } from "./wizard-abort-CDIfvSu2.js";
-import { n as runAgent, o as authenticate } from "./agent-runner-DmqRgcNz.js";
-import { i as runAgent$1, p as AgentSignals, r as initializeAgent, v as WIZARD_TOOL_NAMES } from "./agent-interface-CaSQlcUF.js";
-import { h as EVENT_PLAN_FILE } from "./yara-hooks-DyEPTBZF.js";
-import { r as detectNodePackageManagers } from "./package-manager-CQjuD9E0.js";
-import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-Bs7-Q1J9.js";
+import { i as wizardAbort } from "./wizard-abort-XOuqDEDH.js";
+import { n as runAgent, o as authenticate } from "./agent-runner-Dp581Sva.js";
+import { S as WIZARD_TOOL_NAMES, i as runAgent$1, p as AgentSignals, r as initializeAgent } from "./agent-interface-DX6gTS9D.js";
+import { h as EVENT_PLAN_FILE } from "./yara-hooks-QuIJX1gt.js";
+import { r as detectNodePackageManagers } from "./package-manager-C04G-yHj.js";
+import { i as SPINNER_MESSAGE, t as FRAMEWORK_REGISTRY } from "./registry-Cre35rWW.js";
 import * as semver from "semver";
 import { existsSync, statSync } from "fs";
 import { isAbsolute, join, resolve, sep } from "path";
@@ -3587,32 +3587,16 @@ const getContentBlocks = (store) => [
 //#endregion
 //#region src/lib/programs/posthog-integration/handoff.ts
 /**
-* The coding-agent handoff prompt.
-*
-* The wizard finishes a successful run by emitting `posthog-setup-report.md` —
-* which now ends with a "Verify before merging" checklist the agent fills in
-* from the context-mill skill (see the basic-integration conclude step). This
-* is the one-line prompt the operator pastes into their own coding agent to
-* close the gap between "wizard finished" and "PostHog merged": read the
-* report, work the checklist, open a PR.
-*
-* Kept as a pure helper so the exact wording is easy to review and test in
-* isolation. It is surfaced through `OutroData.handoffPrompt`, which the wizard
-* prints to the terminal's main buffer on exit (where it survives in scrollback
-* and stays triple-click-selectable); it is NOT written into any file — the
-* verification content itself lives in the report.
-*
-* The wording asks the agent to investigate each checklist item and get the
-* operator's explicit consent before making any changes — so actions with real
-* implications (e.g. uploading source maps, editing CI) are surfaced and
-* approved, not applied silently. It deliberately stops there: no PR mandate or
-* edit-style rules, since the operator pastes this into their own agent and
-* governs how changes ultimately land.
-*
-* Background: https://github.com/PostHog/wizard/issues/447
+* The one-line prompt the operator pastes into their own coding agent after a
+* run: open the setup-report notebook, work its "Verify before merging"
+* checklist. Surfaced via `OutroData.handoffPrompt` (printed to scrollback on
+* exit); only exists when the run captured a notebook URL, since no report
+* file is written. The wording demands investigate-then-approval, and stops
+* there — the operator's own agent governs how changes land. Background:
+* https://github.com/PostHog/wizard/issues/447
 */
-function buildCodingAgentPrompt(reportFile) {
-	return `Read \`${reportFile}\` and work through its "Verify before merging" checklist: investigate each item, then list the changes you'd make and get my approval before applying any of them.`;
+function buildCodingAgentPrompt(notebookUrl) {
+	return `Open ${notebookUrl} (the PostHog setup report) and work through its "Verify before merging" checklist: investigate each item, then list the changes you'd make and get my approval before applying any of them.`;
 }
 //#endregion
 //#region src/lib/programs/posthog-integration/index.ts
@@ -3768,7 +3752,7 @@ ${warehouseReportInstruction(session)}
 			postRun: async (sess, credentials) => {
 				const envVars = config.environment.getEnvVars(credentials.projectApiKey, credentials.host.apiHost);
 				if (config.environment.uploadToHosting) {
-					const { uploadEnvironmentVariablesStep } = await import("./steps-BjLuR8HU.js");
+					const { uploadEnvironmentVariablesStep } = await import("./steps-BG1S5Jcd.js");
 					const uploadedEnvVars = await uploadEnvironmentVariablesStep(envVars, {
 						integration: config.metadata.integration,
 						session: sess
@@ -3796,13 +3780,12 @@ ${warehouseReportInstruction(session)}
 				return {
 					kind: "success",
 					message: "Successfully installed PostHog!",
-					reportFile: SETUP_REPORT_FILE,
 					changes: [...config.ui.getOutroChanges(frameworkContext), Object.keys(envVars).length > 0 ? "Added environment variables to .env file" : ""].filter(Boolean),
 					docsUrl: config.metadata.docsUrl,
 					continueUrl,
 					nextSteps: buildWarehouseNextSteps(sess),
 					notebookUrl: sess.notebookUrl ?? void 0,
-					handoffPrompt: buildCodingAgentPrompt(SETUP_REPORT_FILE)
+					handoffPrompt: sess.notebookUrl ? buildCodingAgentPrompt(sess.notebookUrl) : void 0
 				};
 			}
 		};
@@ -3825,4 +3808,4 @@ const integrationRunStep = {
 //#endregion
 export { resolveProjectDir as C, detectProjectsWithAgent as S, WAREHOUSE_ABORT_CASES as _, LINE_CHART_BLOCK as a, detectWarehouseSources as b, TextBlock as c, isClearBlock as d, isLinesBlock as f, HEALTH_CHECK_STEP as g, Icons as h, FUNNEL_BLOCK as i, computeVisibleRange as l, Colors as m, integrationRunStep as n, PRODUCT_SUITE_BLOCK as o, isObjectBlock as p, posthogIntegrationConfig as r, StatusPeekTrigger as s, SETUP_REPORT_FILE as t, wordWrap as u, detectWarehousePrerequisites as v, gatherFrameworkContext as w, detectIntegrationProjects as x, getDetectedWarehouseSources as y };
 
-//# sourceMappingURL=posthog-integration-Cdwv-ohr.js.map
+//# sourceMappingURL=posthog-integration-BbzluO9E.js.map