@userreason/wizard 0.2.0 → 0.3.0

package/dist/bin.js

@@ -3,21 +3,33 @@ import { createRequire as createWizardRequire } from 'node:module'; import { fil
 import {
   offerAgentNote,
   planAgentNote
-} from "./chunk-KV6GSBTQ.js";
-import {
-  offerAgentSkill,
-  planAgentSkill
-} from "./chunk-5Z5J6PY5.js";
+} from "./chunk-Z6ZY7X2K.js";
 import {
   offerCliAccess
-} from "./chunk-HACTNBV3.js";
+} from "./chunk-F4FKAUQN.js";
 import {
   offerGlobalCli
-} from "./chunk-JD5U4U26.js";
+} from "./chunk-ZHHIHHLU.js";
+import {
+  WizardAnalytics
+} from "./chunk-UN24JFV2.js";
+import {
+  beginFirstSurveyPreparation,
+  offerFirstSurvey
+} from "./chunk-HIF6NUNK.js";
+import {
+  runBrowserWizard
+} from "./chunk-VXWLSQYK.js";
+import "./chunk-YYFC7TM2.js";
+import "./chunk-SFODN2YB.js";
+import {
+  offerAgentSkill,
+  planAgentSkill
+} from "./chunk-NZ65XDNL.js";
 import {
   ensureCurrentWizard,
   wizardVersion
-} from "./chunk-6CJ4ANMN.js";
+} from "./chunk-MFGJ2KPT.js";
 import {
   Cancelled,
   Terminal,
@@ -25,26 +37,26 @@ import {
   clean,
   normalizeOrigin,
   openBrowser
-} from "./chunk-SJVLAYGG.js";
+} from "./chunk-GOYBYAUH.js";
 import {
   BrowserConnectionUnavailable,
   compatibilityCredentials,
   connectInstallation,
   memoryCredentials
-} from "./chunk-3RDJORRS.js";
+} from "./chunk-P6DOSGRZ.js";
 import {
   clearInstallation,
   resolveInstallation,
   saveInstallation,
   savedInstallation
-} from "./chunk-FC7PZNYW.js";
+} from "./chunk-2UEUVLCB.js";
 import {
   applyIntegration,
   detectInstallation,
   integrationAdditions,
   integrationPreview,
   planIntegration
-} from "./chunk-6DCCEVPD.js";
+} from "./chunk-5IO5LY22.js";
 import {
   SdkInstallError,
   cliCommand,
@@ -58,8 +70,8 @@ import {
   sdkInstallCommand,
   verifyConfiguration,
   writeIntegration
-} from "./chunk-YMSGDC4B.js";
-import "./chunk-OEGNGGZ2.js";
+} from "./chunk-CADA5WZ3.js";
+import "./chunk-NMHTFC5Q.js";
 import {
   ApiError,
   AuthenticationError,
@@ -67,13 +79,14 @@ import {
   apiUrl,
   credentialStoreKind,
   detectAgentHarness,
+  firstSurveyHandoff,
   login,
   packageProfile,
   resolveConfig,
   resolveCredentials,
   saveConfig,
   uuid
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-77SK7TKZ.js";
 import "./chunk-WL3NOIM6.js";
 
 // src/bin.ts
@@ -83,6 +96,9 @@ var help = `UserReason installation wizard
 
 userreason-wizard [--directory PATH] [--origin URL]
 
+--browser-setup (explicit browser-guided setup; falls back when unavailable)
+--resume-setup UUID (resume this project's saved browser setup)
+--browser-origin ORIGIN (trusted dashboard origin for a custom API)
 --workspace UUID / --workspace-name NAME
 --site UUID / --site-name NAME
 --environment development|production (customer site environment)
@@ -101,6 +117,7 @@ userreason-wizard [--directory PATH] [--origin URL]
 --diff (show the full patch for the application edit and the proposed guidance text)
 --interactive (ask questions even when an agent harness or CI is detected)
 --no-color (also NO_COLOR)
+--no-telemetry (also UR_TELEMETRY_DISABLED=1)
 --no-open (print the browser link without opening it)
 --session-only (keep compatibility login only in memory; do not persist credentials)
 --force (replace differing generated files)
@@ -118,6 +135,10 @@ Prompts are off when stdin or stdout is not a terminal, with --yes or --json, in
 var nameError = (value) => !value.trim() || value.trim().length > 240 ? "Enter a name between 1 and 240 characters." : void 0;
 var currentStep = "Reading wizard options";
 var activeTerminal;
+var analytics;
+var surveyPreparation;
+var surveyAbort = new AbortController();
+var measured = (step, operation) => analytics ? analytics.measure(step, operation) : operation();
 var frameworkLabel = (framework) => framework === "next" ? "Next.js" : framework;
 var lowerFirst = (value) => value.charAt(0).toLowerCase() + value.slice(1);
 async function main() {
@@ -127,7 +148,11 @@ async function main() {
       help: { type: "boolean", short: "h" },
       version: { type: "boolean", short: "v" },
       dev: { type: "boolean" },
+      "browser-setup": { type: "boolean" },
+      "resume-setup": { type: "string" },
+      "browser-origin": { type: "string" },
       "api-environment": { type: "string" },
+      "no-telemetry": { type: "boolean" },
       yes: { type: "boolean" },
       install: { type: "boolean" },
       refresh: { type: "boolean" },
@@ -173,6 +198,17 @@ async function main() {
     process.stdout.write(help);
     return;
   }
+  const browserMode = Boolean(values["browser-setup"] || values["resume-setup"]);
+  if (values["browser-setup"] && values["resume-setup"]) throw new Error("Choose --browser-setup or --resume-setup");
+  if (values["resume-setup"]) uuid(values["resume-setup"], "Setup ID");
+  if (values["browser-origin"]) {
+    if (!browserMode) throw new Error("--browser-origin requires browser setup");
+    apiUrl(values["browser-origin"], "Browser origin");
+  }
+  if (browserMode) {
+    const conflicts = ["refresh", "dry-run", "install", "skip-install", "integrate", "skip-integrate", "agent-note", "skip-agent-note", "agent-skill", "skip-agent-skill", "global-cli", "skip-global-cli", "cli-access", "skip-cli-access", "workspace", "workspace-name", "site", "site-name", "origin", "environment", "force", "diff", "session-only", "client-id", "credential-store"];
+    if (conflicts.some((key) => values[key] !== void 0 && values[key] !== false)) throw new Error("Browser setup choices are reviewed in the browser. Omit terminal installation/resource flags; ongoing CLI access is a separate login.");
+  }
   if (values["credential-store"] !== void 0) credentialStoreKind(values["credential-store"]);
   if (values["api-environment"] !== void 0 && !["production", "development"].includes(values["api-environment"]))
     throw new Error("API environment must be development or production");
@@ -218,8 +254,25 @@ async function main() {
   const tty = Boolean(process.stdin.isTTY && process.stdout.isTTY && process.env.TERM !== "dumb");
   const explicitlyQuiet = Boolean(values.yes || values.json);
   const interactive = tty && !explicitlyQuiet && (!harness || Boolean(values.interactive));
-  const terminal = new Terminal(interactive, Boolean(values.json), { color: !values["no-color"] });
+  const terminal = new Terminal(interactive, Boolean(values.json), { color: !values["no-color"], onCancel: () => {
+    surveyAbort.abort(new Cancelled());
+    surveyPreparation?.cancel();
+    if (browserMode) {
+      process.exitCode = 130;
+      return;
+    }
+    analytics?.finish(true);
+    process.exitCode = 130;
+    void (analytics?.flush(true) ?? Promise.resolve()).finally(() => process.exit(130));
+  } });
   activeTerminal = terminal;
+  try {
+    analytics = new WizardAnalytics({ surface: "wizard", releaseVersion: version, executionMode: interactive ? "interactive" : process.env.CI ? "ci" : harness ? "agent" : "noninteractive", apiUrl: values["api-url"] ?? (developmentApi ? "https://api-dev.userreason.com" : "https://api.userreason.com"), disabled: values["no-telemetry"] || values["dry-run"] });
+  } catch {
+  }
+  if (!values.refresh) analytics?.configure({ context: { source_site_environment: newSiteEnvironment === "development" ? "development" : "production" } });
+  analytics?.begin("run");
+  await analytics?.checkpoint();
   const { c, S } = terminal.kit;
   const dot = ` ${S.dot} `;
   const environmentNote = developmentApi ? `development API${newSiteEnvironment !== apiEnvironment ? `, new sites are ${newSiteEnvironment}` : ""}` : newSiteEnvironment !== apiEnvironment ? `new sites are ${newSiteEnvironment}` : void 0;
@@ -239,8 +292,27 @@ async function main() {
     values.directory ?? process.cwd(),
     values.framework
   );
+  analytics?.configure({ wizard: { framework: project.framework, package_manager: project.packageManager } });
   terminal.info(`${clean(project.name)} ${c.muted(`(${frameworkLabel(project.framework)}, ${project.packageManager})`)}`);
+  if (browserMode) {
+    currentStep = values["resume-setup"] ? "Resuming browser setup" : "Connecting browser setup";
+    const interrupted = () => surveyAbort.abort(new Cancelled());
+    process.once("SIGINT", interrupted);
+    process.once("SIGTERM", interrupted);
+    terminal.cancelState = "the local runner stopped; browser approvals, applied changes and saved drafts remain available when you resume";
+    let handled;
+    try {
+      handled = await runBrowserWizard({ project, apiOrigin: apiUrl(values["api-url"] ?? (developmentApi ? "https://api-dev.userreason.com" : "https://api.userreason.com")), browserOrigin: values["browser-origin"], resumeId: values["resume-setup"], profile, version, terminal, noOpen: Boolean(values["no-open"]), json: Boolean(values.json), signal: surveyAbort.signal, measurementDisabled: values["no-telemetry"] });
+    } finally {
+      process.off("SIGINT", interrupted);
+      process.off("SIGTERM", interrupted);
+    }
+    if (handled) return;
+    terminal.cancelState = "nothing was written";
+    terminal.info("This server has not enabled browser setup. Continuing with the existing terminal wizard.");
+  }
   if (values.refresh) {
+    analytics?.configure({ wizard: { resumed: true } });
     currentStep = "Refreshing UserReason packages";
     const existing = await detectInstallation(project);
     if (!existing) throw new Error("No UserReason initialization found. Run the wizard without --refresh to set up this application.");
@@ -253,18 +325,49 @@ async function main() {
     const started = Date.now();
     await terminal.task("Updating UserReason packages", async () => {
       if (!await hasCompatibleSdk(project, profile) || values.install) {
-        await installSdk(project, options);
+        await measured("sdk_install", () => installSdk(project, options));
         updated.push("@userreason/js");
       }
       if (!await hasCompatibleCli(project, profile) || values.install) {
-        await installCli(project, options);
+        await measured("cli_install", () => installCli(project, options));
         updated.push("@userreason/cli");
       }
     }, () => updated.length ? `Updated ${updated.map((name) => c.code(name)).join(", ")} ${c.muted(`(${project.packageManager}, ${Math.max(1, Math.round((Date.now() - started) / 1e3))}s)`)}` : "UserReason packages are already current");
-    const globalCli2 = await offerGlobalCli(project, terminal, { installed: true, requested: values["global-cli"], skip: !values["global-cli"], force: values.install, verbose: values.debug, profile, preview: Boolean(values.diff) });
-    const agentNote2 = await offerAgentNote(project, terminal, { installed: true, requested: values["agent-note"], skip: !values["agent-note"], preview: Boolean(values.diff) });
-    const agentSkill2 = await offerAgentSkill(project, terminal, { installed: true, requested: values["agent-skill"], skip: !values["agent-skill"], preview: Boolean(values.diff) });
-    const cliAccess2 = values["cli-access"] ? await offerCliAccess(await resolveConfig({ development: developmentApi, apiUrl: existing.apiBaseUrl, clientId: values["client-id"], credentialStore: values["credential-store"] }), terminal, { installed: true, requested: true, noOpen: values["no-open"], development: developmentApi, preview: Boolean(values.diff) }) : { status: "skipped" };
+    const refreshOption = async (step, requested, skipped, eligible, operation) => {
+      if (!requested) {
+        analytics?.step(step, "skipped", { selection_source: skipped ? "flag" : "default", reason: skipped ? "explicit_skip" : "not_requested" });
+        return operation();
+      }
+      if (await eligible().catch(() => false)) analytics?.step(step, "eligible");
+      analytics?.step(step, "selected", { selection_source: "flag" });
+      return measured(step, operation);
+    };
+    const globalCli2 = await refreshOption(
+      "global_cli",
+      values["global-cli"],
+      values["skip-global-cli"],
+      async () => true,
+      () => offerGlobalCli(project, terminal, { installed: true, requested: values["global-cli"], skip: !values["global-cli"], force: values.install, verbose: values.debug, profile, preview: Boolean(values.diff) })
+    );
+    const agentNote2 = await refreshOption(
+      "agent_note",
+      values["agent-note"],
+      values["skip-agent-note"],
+      async () => "path" in await planAgentNote(project),
+      () => offerAgentNote(project, terminal, { installed: true, requested: values["agent-note"], skip: !values["agent-note"], preview: Boolean(values.diff) })
+    );
+    const agentSkill2 = await refreshOption(
+      "agent_skill",
+      values["agent-skill"],
+      values["skip-agent-skill"],
+      async () => "files" in await planAgentSkill(project),
+      () => offerAgentSkill(project, terminal, { installed: true, requested: values["agent-skill"], skip: !values["agent-skill"], preview: Boolean(values.diff) })
+    );
+    const cliAccess2 = await refreshOption("cli_access", values["cli-access"], values["skip-cli-access"], async () => true, async () => {
+      if (!values["cli-access"]) return { status: "skipped" };
+      const accessConfig = await resolveConfig({ development: developmentApi, apiUrl: existing.apiBaseUrl, clientId: values["client-id"], credentialStore: values["credential-store"] });
+      return offerCliAccess(accessConfig, terminal, { installed: true, requested: true, noOpen: values["no-open"], development: developmentApi, preview: Boolean(values.diff) });
+    });
     const untouched = [!values["global-cli"] && ["global command", "--global-cli"], !values["agent-note"] && ["AGENTS.md note", "--agent-note"], !values["agent-skill"] && ["agent skill", "--agent-skill"], !values["cli-access"] && ["CLI access", "--cli-access"]].filter(Boolean);
     terminal.block("Ready", [
       c.muted("Reload or restart your app to load the updated SDK."),
@@ -334,6 +437,7 @@ async function main() {
     clientId: values["client-id"],
     credentialStore: values["credential-store"]
   });
+  analytics?.configure({ apiUrl: config.apiUrl });
   let resumeStorageBlocked = false;
   const warnResumeStorage = () => {
     if (resumeStorageBlocked) return;
@@ -350,12 +454,14 @@ async function main() {
   let workspaceChoice = values.workspace ? uuid(values.workspace) : saved?.workspaceId;
   const siteChoice = values.site ? uuid(values.site) : saved?.siteId;
   const resumed = Boolean(saved && !values.workspace && !values.site);
+  analytics?.configure({ wizard: { resumed } });
   if (siteChoice && !workspaceChoice) {
     currentStep = "Resolving the existing site";
     const origin = values.origin ? normalizeOrigin(values.origin, newSiteEnvironment === "development" ? "development" : "production") : void 0;
     workspaceChoice = (await resolveInstallation({ siteId: siteChoice, apiBaseUrl: config.apiUrl }, origin)).workspaceId;
   }
-  let credentials = resolveCredentials(config), client = new UserReasonClient(config, credentials), connection;
+  const rawCredentials = resolveCredentials(config);
+  let credentials = analytics?.observeCredentials(rawCredentials) ?? rawCredentials, client = new UserReasonClient(config, credentials), connection;
   const open = async (url) => !values["no-open"] && await openBrowser(url);
   const approvalWait = async (label, url, note) => {
     const opened = await open(url);
@@ -373,6 +479,8 @@ async function main() {
   let waiting;
   let unrestrictedOrigins = false;
   currentStep = "Connecting browser sign-in and approval";
+  analytics?.begin("authentication");
+  await analytics?.checkpoint();
   try {
     connection = await connectInstallation(
       config,
@@ -399,7 +507,9 @@ async function main() {
       }
     );
     waiting?.stop();
-    credentials = memoryCredentials(connection.session);
+    const temporaryCredentials = memoryCredentials(connection.session);
+    credentials = analytics?.observeCredentials(temporaryCredentials) ?? temporaryCredentials;
+    analytics?.setSession(connection.session);
     client = new UserReasonClient(config, credentials, {
       lock: (operation) => operation()
     });
@@ -419,7 +529,8 @@ async function main() {
         return terminal.confirm("Keep this session in memory only? No credentials will be saved.");
       }
     );
-    credentials = compatibility.credentials;
+    credentials = analytics?.observeCredentials(compatibility.credentials) ?? compatibility.credentials;
+    analytics?.setSession(compatibility.session);
     client = new UserReasonClient(
       config,
       credentials,
@@ -471,6 +582,11 @@ async function main() {
     await deviceSignIn();
     account = await client.account();
   }
+  analytics?.end("authentication");
+  if (developmentApi && terminal.interactive && !values.yes && !values.json && !values.diff) {
+    surveyPreparation = beginFirstSurveyPreparation(project.directory, { development: developmentApi, interactive: terminal.interactive });
+  }
+  analytics?.begin("target_selection");
   const who = connection ? clean(connection.session.email) : void 0;
   let selectedWorkspace;
   const approvedWorkspace = connection?.workspaceId ?? workspaceChoice;
@@ -555,6 +671,8 @@ async function main() {
     siteId: selectedSite?.id ?? siteIds.siteId,
     apiBaseUrl: config.apiUrl
   };
+  analytics?.end("target_selection");
+  analytics?.configure({ context: { ...selectedWorkspace ? { workspace_id: selectedWorkspace.id } : {}, ...selectedSite ? { site_id: selectedSite.id } : {}, source_site_environment: selectedSite?.environment ?? environment } });
   currentStep = "Preparing the application integration";
   const reviewed = values["skip-integrate"] ? void 0 : await planIntegration(project, installation);
   const additions = reviewed ? integrationAdditions(reviewed) : void 0;
@@ -577,18 +695,37 @@ async function main() {
     ]);
   } else terminal.block("Changes", [reviewed?.status === "integrated" && !packages.length ? c.muted(`nothing to edit${dot}@userreason/js and @userreason/cli are current`) : installRow]);
   const extras = [];
+  if (developmentApi && interactive && !values.diff) extras.push({ value: "surveys", label: "Recommend surveys (share selected app code with Cerebras and OpenAI)", hint: "Optional. Suggestions first; drafts only when selected. No publishing or event edits.", initial: true });
   if (reviewed?.status === "ready" && additions) extras.push({ value: "edit", label: `${additions.created ? "Create" : "Edit"} ${additions.path}`, hint: "add UserReason.init", initial: true });
   if (noteProbe && "path" in noteProbe) extras.push({ value: "note", label: `${noteProbe.file} ${noteProbe.replacement ? "note update" : "note"}`, hint: "user-feedback guidance", initial: true });
   if (skillProbe && "files" in skillProbe) extras.push({ value: "skill", label: skillProbe.update ? "Agent skill update" : "Agent skill", hint: ".agents/skills/userreason", initial: true });
   if (!values["skip-cli-access"] && !values["session-only"]) extras.push({ value: "access", label: "Ongoing CLI access", hint: "second approval (90 days)", initial: true });
   if (!values["skip-global-cli"] && !values["skip-install"]) extras.push({ value: "global", label: "Global userreason command", hint: `optional${dot}npm i -g, replaces the current global CLI`, initial: Boolean(values["global-cli"]) });
+  for (const item of extras) {
+    if (item.value === "surveys") continue;
+    const step = { edit: "initialization", note: "agent_note", skill: "agent_skill", access: "cli_access", global: "global_cli" }[item.value];
+    analytics?.step(step, "eligible");
+    if (interactive) analytics?.step(step, "offered", { selection_source: "prompt" });
+  }
+  if (interactive && extras.length) analytics?.begin("options");
+  await analytics?.checkpoint();
   const picked = interactive ? new Set(extras.length ? await terminal.multiselect(`Set up ${c.muted(`${dot.trim()} recommended steps are selected`)}`, extras, extras.filter((item) => item.initial).map((item) => item.value)) : []) : void 0;
+  if (interactive && extras.length) {
+    analytics?.end("options");
+    for (const item of extras) {
+      if (item.value === "surveys") continue;
+      const step = { edit: "initialization", note: "agent_note", skill: "agent_skill", access: "cli_access", global: "global_cli" }[item.value];
+      analytics?.step(step, picked?.has(item.value) ? "selected" : "declined", { selection_source: "prompt" });
+    }
+  }
   const integrate = Boolean(reviewed?.status === "ready" && (picked ? picked.has("edit") : values.integrate || values.yes));
   const choice = (key, flag, skipFlag) => picked ? { requested: picked.has(key), skip: !picked.has(key) } : { requested: Boolean(values[flag]), skip: skipFlag };
+  if (!interactive) analytics?.step("initialization", integrate ? "selected" : "skipped", { selection_source: values.integrate || values["skip-integrate"] || values.yes ? "flag" : "default", ...!integrate ? { reason: values["skip-integrate"] ? "explicit_skip" : "not_requested" } : {} });
   const noteChoice = choice("note", "agent-note", Boolean(values["skip-agent-note"]));
   const skillChoice = choice("skill", "agent-skill", Boolean(values["skip-agent-skill"]));
   const globalChoice = choice("global", "global-cli", Boolean(values["skip-global-cli"] || values["skip-install"]));
   const accessChoice = choice("access", "cli-access", Boolean(values["skip-cli-access"] || values["session-only"]));
+  if (!interactive) for (const [step, decision] of [["agent_note", noteChoice], ["agent_skill", skillChoice], ["global_cli", globalChoice], ["cli_access", accessChoice]]) analytics?.step(step, decision.requested ? "selected" : "skipped", { selection_source: decision.requested || decision.skip ? "flag" : "default", ...!decision.requested ? { reason: decision.skip ? "explicit_skip" : "not_requested" } : {} });
   terminal.cancelState = "some steps are done; rerun the wizard to continue";
   if (!selectedWorkspace) {
     currentStep = "Creating the workspace";
@@ -625,6 +762,7 @@ async function main() {
     );
     terminal.success(`Created site ${c.code(clean(selectedSite.name))}`);
   }
+  analytics?.configure({ context: { workspace_id: selectedWorkspace.id, site_id: selectedSite.id, source_site_environment: selectedSite.environment } });
   currentStep = "Saving optional installation resume details";
   if (!await saveInstallation(project.directory, installation)) warnResumeStorage();
   currentStep = "Preparing initialization files";
@@ -645,9 +783,10 @@ async function main() {
     await terminal.task("Installing @userreason/js, @userreason/cli", async () => {
       if (shouldInstall) {
         try {
-          await installSdk(project, { profile, verbose: values.debug, onWarning: (message) => {
+          const operation = () => installSdk(project, { profile, verbose: values.debug, onWarning: (message) => {
             warnings.push(message);
           } });
+          await measured("sdk_install", operation);
           sdkInstalled = true;
           installed.push("@userreason/js");
         } catch (error) {
@@ -658,9 +797,10 @@ async function main() {
       }
       if (shouldInstallCli) {
         try {
-          await installCli(project, { profile, verbose: values.debug, onWarning: (message) => {
+          const operation = () => installCli(project, { profile, verbose: values.debug, onWarning: (message) => {
             warnings.push(message);
           } });
+          await measured("cli_install", operation);
           cliInstalled = true;
           installed.push("@userreason/cli");
         } catch (error) {
@@ -684,16 +824,17 @@ Then rerun the wizard. Your saved workspace and site will be reused.`, failure.t
     const concrete = await planIntegration(project, installation);
     if (reviewed.status !== "ready" || concrete.status !== "ready" || concrete.path !== reviewed.path || concrete.before !== reviewed.before || concrete.after !== reviewed.after)
       throw new Error("The application entry changed after the preview. Rerun to review it again.");
-    await applyIntegration(concrete);
+    await measured("initialization", () => applyIntegration(concrete));
     if (concrete.before === null) generated.files.push(concrete.path);
     terminal.success(`${concrete.before === null ? "Created" : "Edited"} ${c.code(additions?.path ?? "")}`);
   }
+  if (existingPlan?.status === "integrated") analytics?.step("initialization", "already_present");
   const integrated = Boolean(integrate && !installFailed || existingPlan?.status === "integrated");
   if (!integrated && !installFailed) terminal.note(generated.instruction, "Application integration");
   currentStep = "Checking site configuration";
   const verification = await terminal.task(
     "Checking site configuration",
-    () => verifyConfiguration(installation, hostOrigin ?? "https://installation.userreason.invalid"),
+    () => analytics ? analytics.measure("configuration_check", () => verifyConfiguration(installation, hostOrigin ?? "https://installation.userreason.invalid"), "completed") : verifyConfiguration(installation, hostOrigin ?? "https://installation.userreason.invalid"),
     "Site configuration reachable"
   );
   if (integrated && sdkInstalled && !installFailed) {
@@ -705,13 +846,30 @@ Then rerun the wizard. Your saved workspace and site will be reused.`, failure.t
   if (picked && !completed && !installFailed && (picked.has("note") || picked.has("skill")))
     terminal.warn("The note and skill wait for an initialized SDK. Rerun with the entry edit selected, or apply the initialization yourself first.");
   currentStep = "Offering the optional user feedback note";
-  const agentNote = await offerAgentNote(project, terminal, { installed: completed, ...noteChoice, preview: Boolean(values.diff) });
+  const agentNote = await measured("agent_note", () => offerAgentNote(project, terminal, { installed: completed, ...noteChoice, preview: Boolean(values.diff) }));
   currentStep = "Offering the optional feedback agent skill";
-  const agentSkill = await offerAgentSkill(project, terminal, { installed: completed, ...skillChoice, preview: Boolean(values.diff) });
+  const agentSkill = await measured("agent_skill", () => offerAgentSkill(project, terminal, { installed: completed, ...skillChoice, preview: Boolean(values.diff) }));
   currentStep = "Offering the optional global CLI";
-  const globalCli = await offerGlobalCli(project, terminal, { installed: cliInstalled && !installFailed, ...globalChoice, force: values.install, verbose: values.debug, profile, preview: Boolean(values.diff) });
+  const globalCli = await measured("global_cli", () => offerGlobalCli(project, terminal, { installed: cliInstalled && !installFailed, ...globalChoice, force: values.install, verbose: values.debug, profile, preview: Boolean(values.diff) }));
   currentStep = "Offering ongoing CLI access";
-  const cliAccess = await offerCliAccess(config, terminal, { installed: cliInstalled && !installFailed, ...accessChoice, noOpen: values["no-open"], development: developmentApi, preview: Boolean(values.diff) });
+  const cliAccess = await measured("cli_access", () => offerCliAccess(config, terminal, { installed: cliInstalled && !installFailed, ...accessChoice, noOpen: values["no-open"], development: developmentApi, preview: Boolean(values.diff) }));
+  if (completed && terminal.interactive && !values.yes && !values.json && !values.diff) {
+    try {
+      currentStep = "Creating the first survey";
+      await offerFirstSurvey(new UserReasonClient(config, resolveCredentials(config)), project.directory, selectedWorkspace.id, selectedSite.id, {
+        show: (message) => terminal.note(message, developmentApi ? "Recommended surveys" : "First survey"),
+        confirm: (message) => terminal.confirm(message, false),
+        choose: (message, options, initialValue) => terminal.select(message, options, initialValue),
+        answer: (message) => terminal.text(message),
+        chooseMany: (message, options, initial) => terminal.multiselect(message, options, initial),
+        loading: (message, work) => terminal.task(message, work, () => void 0),
+        signal: surveyAbort.signal
+      }, { development: developmentApi, interactive: terminal.interactive, product: selectedSite.name, preparation: surveyPreparation, sourceConsent: picked?.has("surveys") });
+    } catch (error) {
+      terminal.warn("Optional first-survey assistance did not finish. Installation is preserved. Use the ongoing CLI connection with site:read and survey:write; no installation grant is broadened.");
+      terminal.note(firstSurveyHandoff(project.directory, config.apiUrl, selectedWorkspace.id, selectedSite.id), "Resume with your agent");
+    }
+  }
   const nextStep = installFailed ? `Run ${sdkInstalled ? cliInstallCommand(project, profile) : sdkInstallCommand(project, profile)} in your normal terminal, then rerun the wizard to finish setup.` : integrated ? "Start your app and open it in the browser to connect the SDK." : generated.instruction;
   const siteLine = `${clean(selectedWorkspace.name)} ${S.arrow} ${clean(selectedSite.name)} ${c.muted(`(${siteDetail(selectedSite)})`)}`;
   terminal.block(installFailed ? "Saved" : "Ready", [c.muted(installFailed ? "SDK installation is pending. After installing, rerun the wizard; your site is reused." : "SDK not connected yet. Start your app to connect it.")], { suffix: siteLine, kind: installFailed ? "warn" : "done" });
@@ -749,11 +907,16 @@ var approvalProgress;
 main().catch((error) => {
   const detail = error instanceof Error ? error.message : "Installation failed";
   if (error instanceof Cancelled) {
-    if (activeTerminal) activeTerminal.cancelled();
+    analytics?.finish(true);
+    if (activeTerminal) {
+      activeTerminal.cancelled();
+      return;
+    }
     process.stderr.write(detail + "\n");
     process.exitCode = 130;
     return;
   }
+  analytics?.finish(false, true);
   const message = `${currentStep}: ${detail}`;
   if (process.argv.includes("--json"))
     process.stdout.write(JSON.stringify({ error: "wizard_failed", step: currentStep, message }) + "\n");
@@ -761,4 +924,8 @@ main().catch((error) => {
     activeTerminal.error(clean(detail), [`while ${lowerFirst(currentStep)}`]);
   else process.stderr.write(message + "\n");
   process.exitCode = 1;
+}).finally(async () => {
+  surveyPreparation?.cancel();
+  analytics?.finish(false, Boolean(process.exitCode));
+  await analytics?.flush(true);
 });

package/dist/{chunk-FC7PZNYW.js → chunk-2UEUVLCB.js}

@@ -1,15 +1,15 @@
 import { createRequire as createWizardRequire } from 'node:module'; import { fileURLToPath as wizardFileURLToPath } from 'node:url'; import { dirname as wizardDirname } from 'node:path'; const require = createWizardRequire(import.meta.url); const __filename = wizardFileURLToPath(import.meta.url); const __dirname = wizardDirname(__filename);
 import {
   detectInstallation
-} from "./chunk-6DCCEVPD.js";
+} from "./chunk-5IO5LY22.js";
 import {
   DEFAULT_API
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-CADA5WZ3.js";
 import {
   apiUrl,
   configDirectory,
   uuid
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-77SK7TKZ.js";
 
 // src/state.ts
 import { mkdir, readFile, writeFile, rename, rm, realpath, lstat } from "node:fs/promises";

package/dist/{chunk-6DCCEVPD.js → chunk-5IO5LY22.js}

@@ -3,10 +3,10 @@ import {
   DEFAULT_API,
   initializationSource,
   integrationSource
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-CADA5WZ3.js";
 import {
   require_typescript
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-77SK7TKZ.js";
 import {
   __toESM
 } from "./chunk-WL3NOIM6.js";
@@ -673,8 +673,26 @@ function reactRoots(ast) {
   if (!creationCount && renders.length > 1) return [];
   return renders.flatMap((node) => node.arguments[0] ? [node.arguments[0]] : []);
 }
-function existing(text, config = dummy) {
-  const ast = parse("entry.tsx", text), calls = ast ? sdkCalls(ast) : [];
+function integrationReferences(ast) {
+  const modules = nodes(ast, import_typescript.default.isStringLiteral).filter((literal) => {
+    const parent = literal.parent;
+    return (import_typescript.default.isImportDeclaration(parent) || import_typescript.default.isExportDeclaration(parent)) && parent.moduleSpecifier === literal || import_typescript.default.isExternalModuleReference(parent) && parent.expression === literal || import_typescript.default.isCallExpression(parent) && parent.arguments[0] === literal && (parent.expression.kind === import_typescript.default.SyntaxKind.ImportKeyword || import_typescript.default.isIdentifier(parent.expression) && parent.expression.text === "require");
+  }).map((literal) => literal.text);
+  const tags = nodes(ast, (node) => import_typescript.default.isJsxOpeningElement(node) || import_typescript.default.isJsxSelfClosingElement(node)).map((node) => node.tagName.getText(ast));
+  const globalAccess = nodes(ast, import_typescript.default.isElementAccessExpression).some((node) => import_typescript.default.isIdentifier(node.expression) && ["window", "globalThis", "self", "global"].includes(node.expression.text) && import_typescript.default.isStringLiteralLike(node.argumentExpression) && node.argumentExpression.text === "UserReason");
+  const identifier = nodes(ast, import_typescript.default.isIdentifier).some((node) => {
+    if (node.text !== "UserReason") return false;
+    const parent = node.parent;
+    if ((import_typescript.default.isPropertyAssignment(parent) || import_typescript.default.isPropertyDeclaration(parent) || import_typescript.default.isPropertySignature(parent) || import_typescript.default.isMethodDeclaration(parent) || import_typescript.default.isMethodSignature(parent) || import_typescript.default.isGetAccessorDeclaration(parent) || import_typescript.default.isSetAccessorDeclaration(parent) || import_typescript.default.isJsxAttribute(parent)) && parent.name === node) return false;
+    if ((import_typescript.default.isBindingElement(parent) || import_typescript.default.isImportSpecifier(parent)) && parent.propertyName === node) return false;
+    if (import_typescript.default.isExportSpecifier(parent) && parent.name === node && parent.propertyName) return false;
+    if (import_typescript.default.isLabeledStatement(parent) || import_typescript.default.isBreakStatement(parent) || import_typescript.default.isContinueStatement(parent)) return false;
+    return true;
+  });
+  return { modules, tags, identifier: identifier || globalAccess };
+}
+function existing(text, config = dummy, path = "entry.tsx") {
+  const ast = parse(path, text), calls = ast ? sdkCalls(ast) : [];
   if (calls.length) {
     try {
       let first;
@@ -690,11 +708,13 @@ function existing(text, config = dummy) {
     }
     return { status: "integrated", reason: "SDK initialization is already present; its configuration is preserved." };
   }
-  if (/userreason\.generated/.test(text) && /<UserReasonProvider\s*\/?\s*>/.test(text))
+  if (!ast) return;
+  const references = integrationReferences(ast);
+  if (references.modules.some((name) => /userreason\.generated/.test(name)) && references.tags.includes("UserReasonProvider"))
     return { status: "integrated", reason: "Existing generated initialization is already present." };
-  if (/userreason\.client/.test(text) && /<UserReasonInit\s*\/?\s*>/.test(text))
+  if (references.modules.some((name) => /userreason\.client/.test(name)) && references.tags.includes("UserReasonInit"))
     return { status: "integrated", reason: "Browser initialization is already present." };
-  if (/\bUserReason\b|userreason\.generated|from\s*['"]@userreason\/js['"]/.test(text))
+  if (references.identifier || references.modules.some((name) => name === "@userreason/js" || /userreason\.(?:generated|client)/.test(name)))
     return { status: "manual", reason: "An existing UserReason integration needs review before editing the entry." };
 }
 async function planIntegration(project, config = dummy) {
@@ -716,11 +736,13 @@ async function planIntegration(project, config = dummy) {
     const found2 = files.filter((value) => value.text !== void 0);
     if (found2.length > 1) return { status: "manual", reason: "Multiple instrumentation-client files need review." };
     for (const root of ["app/layout.tsx", "app/layout.jsx", "app/layout.js", "pages/_app.tsx", "pages/_app.jsx", "pages/_app.js"]) {
-      const rootText = await source(project, join(directory, root));
-      if (rootText && /userreason\.(?:generated|client)/.test(rootText)) return existing(rootText) ?? { status: "manual", reason: "Existing root initialization needs review." };
+      const rootPath = join(directory, root), rootText = await source(project, rootPath);
+      const rootAst = rootText ? parse(rootPath, rootText) : void 0;
+      if (rootText && rootAst && integrationReferences(rootAst).modules.some((name2) => /userreason\.(?:generated|client)/.test(name2)))
+        return existing(rootText, dummy, rootPath) ?? { status: "manual", reason: "Existing root initialization needs review." };
     }
     const { path: path2, text: text2 } = found2[0] ?? files[project.typescript ? 0 : 1];
-    const current2 = text2 ? existing(text2, config) : void 0;
+    const current2 = text2 ? existing(text2, config, path2) : void 0;
     if (current2) return current2;
     const ast = parse(path2, text2 ?? "");
     if (!ast) return { status: "manual", reason: "Client instrumentation could not be parsed safely." };
@@ -776,7 +798,7 @@ ${initializationSource(config)}`),
     };
   const { path, text } = found[0];
   const name = project.framework === "next" ? "UserReasonInit" : "UserReason";
-  const current = existing(text, config);
+  const current = existing(text, config, path);
   if (current) return current;
   let after;
   {