@userreason/wizard 0.2.1 → 0.3.1

package/dist/bin.js

@@ -1,50 +1,48 @@
 #!/usr/bin/env node
 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 {
+  runBrowserWizard
+} from "./chunk-CSZW2ULJ.js";
+import {
+  clearInstallation,
+  resolveInstallation,
+  saveInstallation,
+  savedInstallation
+} from "./chunk-XASPGFYK.js";
 import {
   offerAgentNote,
   planAgentNote
-} from "./chunk-ULHKVBPD.js";
-import {
-  offerAgentSkill,
-  planAgentSkill
-} from "./chunk-5Z5J6PY5.js";
+} from "./chunk-7O7H3PIM.js";
 import {
   offerCliAccess
-} from "./chunk-HACTNBV3.js";
+} from "./chunk-XPFKXLIZ.js";
 import {
   offerGlobalCli
-} from "./chunk-JD5U4U26.js";
+} from "./chunk-TRBSH5G7.js";
 import {
-  ensureCurrentWizard,
-  wizardVersion
-} from "./chunk-6CJ4ANMN.js";
+  WizardAnalytics
+} from "./chunk-KF37D5WL.js";
 import {
-  Cancelled,
-  Terminal,
-  approvalStatus,
-  clean,
-  normalizeOrigin,
-  openBrowser
-} from "./chunk-SJVLAYGG.js";
+  beginFirstSurveyPreparation,
+  offerFirstSurvey
+} from "./chunk-ZHJV247H.js";
+import "./chunk-Q5U5UOQN.js";
+import "./chunk-4INLEQE2.js";
 import {
-  BrowserConnectionUnavailable,
-  compatibilityCredentials,
-  connectInstallation,
-  memoryCredentials
-} from "./chunk-3RDJORRS.js";
+  offerAgentSkill,
+  planAgentSkill
+} from "./chunk-SB3AYQWG.js";
 import {
-  clearInstallation,
-  resolveInstallation,
-  saveInstallation,
-  savedInstallation
-} from "./chunk-ZGZOBW2B.js";
+  ensureCurrentWizard,
+  wizardVersion
+} from "./chunk-NNPYUATH.js";
 import {
   applyIntegration,
   detectInstallation,
   integrationAdditions,
   integrationPreview,
   planIntegration
-} from "./chunk-5SC2K42Q.js";
+} from "./chunk-LEJFE4U5.js";
 import {
   SdkInstallError,
   cliCommand,
@@ -58,8 +56,23 @@ import {
   sdkInstallCommand,
   verifyConfiguration,
   writeIntegration
-} from "./chunk-YMSGDC4B.js";
-import "./chunk-OEGNGGZ2.js";
+} from "./chunk-TOID3NYP.js";
+import "./chunk-PJQOSDYS.js";
+import "./chunk-NMHTFC5Q.js";
+import {
+  Cancelled,
+  Terminal,
+  approvalStatus,
+  clean,
+  normalizeOrigin,
+  openBrowser
+} from "./chunk-EVNEX5N5.js";
+import {
+  BrowserConnectionUnavailable,
+  compatibilityCredentials,
+  connectInstallation,
+  memoryCredentials
+} from "./chunk-DMXUXEQI.js";
 import {
   ApiError,
   AuthenticationError,
@@ -67,13 +80,14 @@ import {
   apiUrl,
   credentialStoreKind,
   detectAgentHarness,
+  firstSurveyHandoff,
   login,
   packageProfile,
   resolveConfig,
   resolveCredentials,
   saveConfig,
   uuid
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 import "./chunk-WL3NOIM6.js";
 
 // src/bin.ts
@@ -83,6 +97,10 @@ var help = `UserReason installation wizard
 
 userreason-wizard [--directory PATH] [--origin URL]
 
+--browser-setup (browser-guided setup; default for development onboarding)
+--terminal-setup (use terminal onboarding instead)
+--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 +119,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 +137,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 +150,12 @@ async function main() {
       help: { type: "boolean", short: "h" },
       version: { type: "boolean", short: "v" },
       dev: { type: "boolean" },
+      "browser-setup": { type: "boolean" },
+      "terminal-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,7 +201,6 @@ async function main() {
     process.stdout.write(help);
     return;
   }
-  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");
   if (values.dev && values["api-environment"] === "production")
@@ -181,6 +208,20 @@ async function main() {
   const embeddedProfile = packageProfile();
   const apiEnvironment = values["api-environment"] ?? (values.dev ? "development" : embeddedProfile.apiEnvironment);
   const developmentApi = apiEnvironment === "development";
+  const explicitBrowserMode = 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["terminal-setup"] && explicitBrowserMode) throw new Error("Choose --terminal-setup or browser setup");
+  if (values["resume-setup"]) uuid(values["resume-setup"], "Setup ID");
+  const terminalFlags = ["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"];
+  const hasTerminalFlags = terminalFlags.some((key) => values[key] !== void 0 && values[key] !== false);
+  const browserMode = explicitBrowserMode || developmentApi && !values["terminal-setup"] && !hasTerminalFlags && !values.yes && !values.json;
+  if (values["browser-origin"]) {
+    if (!browserMode) throw new Error("--browser-origin requires browser setup");
+    apiUrl(values["browser-origin"], "Browser origin");
+  }
+  if (browserMode && hasTerminalFlags)
+    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"]);
   const newSiteEnvironment = values.environment ?? apiEnvironment;
   if (values["global-cli"] && values["skip-global-cli"]) throw new Error("Choose --global-cli or --skip-global-cli");
   if (values["global-cli"] && values["skip-install"]) throw new Error("--global-cli requires project package installation; omit --skip-install");
@@ -218,8 +259,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 +297,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, development: developmentApi, 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 +330,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 +442,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 +459,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 +484,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 +512,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 +534,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 +587,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 +676,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;
@@ -582,13 +705,31 @@ async function main() {
   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 +766,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 +787,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 +801,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 +828,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 +850,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 (!developmentApi && 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 +911,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 +928,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);
 });