@userreason/wizard 0.2.1 → 0.3.1

package/dist/{chunk-ULHKVBPD.js → chunk-7O7H3PIM.js}

@@ -1,16 +1,16 @@
 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 {
-  Cancelled
-} from "./chunk-SJVLAYGG.js";
 import {
   initializationPath
-} from "./chunk-5SC2K42Q.js";
+} from "./chunk-LEJFE4U5.js";
 import {
   cliCommand
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-TOID3NYP.js";
+import {
+  Cancelled
+} from "./chunk-EVNEX5N5.js";
 import {
   packageProfile
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 
 // src/agent-note.ts
 import { constants } from "node:fs";
@@ -152,7 +152,7 @@ ${plan.snippet}` : plan.snippet,
     terminal.success(`User feedback note ${plan.replacement ? "updated in" : "added to"} ${plan.file}`);
     return { status: plan.replacement ? "updated" : "added", file: plan.file };
   } catch (error) {
-    if (error instanceof Cancelled) return { status: "declined" };
+    if (error instanceof Cancelled) return { status: "declined", reason: "user_cancelled" };
     terminal.warn("Installation is complete. The optional user feedback note could not be added; the guidance file needs review.");
     return { status: "failed", reason: "guidance_file_needs_review" };
   }

package/dist/chunk-CSZW2ULJ.js

@@ -0,0 +1,152 @@
+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 {
+  connectSetup,
+  resumeSetup,
+  runSetup
+} from "./chunk-Q5U5UOQN.js";
+import {
+  clean,
+  openBrowser
+} from "./chunk-EVNEX5N5.js";
+import {
+  BrowserSetupUnavailable
+} from "./chunk-7AAH6C4L.js";
+
+// src/setup-flow.ts
+var shell = (value) => /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replace(/'/g, `'"'"'`)}'`;
+var registryArgs = (profile) => profile?.kind === "local-development" ? ["--prefer-online", `--registry=${profile.registry}`, `--@userreason:registry=${profile.registry}`] : [];
+function setupSampleCommand(setupId, apiOrigin, cliVersion, profile) {
+  return ["npx", "-y", ...registryArgs(profile), `@userreason/cli@${cliVersion}`, "setup", "sample", "--setup", setupId, "--api-url", apiOrigin, "--directory", ".", "--json"].map(shell).join(" ");
+}
+function setupResumeCommand(setupId, apiOrigin, version, profile) {
+  return ["npx", "-y", ...registryArgs(profile), `@userreason/wizard@${version}`, "--resume-setup", setupId, "--api-url", apiOrigin, "--directory", "."].map(shell).join(" ");
+}
+var setupManualGuidance = {
+  install_packages: "Review the project dependency and registry settings, install compatible @userreason/js and @userreason/cli versions with the project package manager, then rerun setup. See https://docs.userreason.com/get-started/quickstart/.",
+  initialize_sdk: "Identify the existing browser entry and initialize UserReason once with the selected site\u2019s public ID, preserving any existing initialization. See https://docs.userreason.com/sdk/initialization/.",
+  install_skill: "Review the existing agent guidance and merge the UserReason skill manually from the installed @userreason/cli skills/userreason directory. Preserve your existing edits and do not overwrite a customized skill.",
+  insert_footer: "Identify the intended existing site footer and manually add a Powered by UserReason link to https://userreason.com/. Preserve its content and layout; resolve ambiguous placement before editing."
+};
+function setupSummary(session) {
+  return {
+    setup_id: session.setup_id,
+    phase: session.phase,
+    workspace_id: session.workspace_id,
+    site_id: session.site_id,
+    local_operations: session.commands.map((command) => ({ kind: command.kind, status: command.status, code: command.result?.code ?? null })),
+    manual_steps: session.local_plan?.manual_steps ?? [],
+    source: session.source?.status ?? "not_started",
+    drafts: session.draft_outcomes.map((draft) => ({ candidate_id: draft.candidate_id, prompt_id: draft.prompt_id, status: draft.status, revision: draft.revision })),
+    sample: session.sample.status,
+    cli_access: "not_requested"
+  };
+}
+async function runBrowserWizard(input) {
+  const { terminal, project, apiOrigin, signal } = input;
+  let connected;
+  try {
+    connected = input.resumeId ? await resumeSetup(apiOrigin, input.resumeId, project, { signal, measurementDisabled: input.measurementDisabled }) : await connectSetup(apiOrigin, project, async (url, code) => {
+      terminal.block("Continue in your browser", [url, `Verification code: ${code}`, input.development ? "Choose your workspace, site and installation options in the browser." : "Review the project, local changes and source permissions there."]);
+      if (!input.noOpen && !await openBrowser(url)) terminal.info("Open the link above to continue.");
+    }, {
+      signal,
+      browserOrigin: input.browserOrigin,
+      automaticSetup: input.development,
+      measurementDisabled: input.measurementDisabled,
+      ...input.development ? { launcher: { wizard_version: input.version, api_origin: apiOrigin, ...input.profile.kind === "local-development" ? { registry: input.profile.registry } : {} } } : {}
+    });
+  } catch (error) {
+    if (!input.resumeId && error instanceof BrowserSetupUnavailable) return false;
+    throw error;
+  }
+  const resume = setupResumeCommand(connected.client.identity.setup_id, apiOrigin, input.version, input.profile);
+  terminal.block("Setup connected", [`Setup: ${connected.client.identity.setup_id}`, "Keep this terminal open while you complete setup in the browser.", `To reconnect from this project: ${resume}`]);
+  let status = "", displayedPacket = "";
+  const shownManual = /* @__PURE__ */ new Set();
+  try {
+    const automaticSetup = connected.session.capabilities.onboarding_v2 === true;
+    const result = await runSetup(connected.client, project, {
+      signal,
+      automaticSetup,
+      onOperationError({ kind, message, receiptPath }) {
+        terminal.block(`${kind === "install_packages" ? "Package installation" : kind.replaceAll("_", " ")} failed`, [
+          ...message.split("\n").map(clean),
+          `Local diagnostic receipt: ${receiptPath}`,
+          "The detailed error stays on this computer; the browser receives only the operation status."
+        ]);
+      },
+      onSession(session) {
+        for (const step of session.local_plan?.manual_steps ?? []) {
+          const key = `${step.kind}:${step.code}`;
+          if (shownManual.has(key)) continue;
+          shownManual.add(key);
+          terminal.block(`Manual step: ${step.kind}`, [setupManualGuidance[step.kind]]);
+        }
+        const next = `${session.phase}:${session.source?.status ?? ""}:${session.sample.status}`;
+        if (next === status) return;
+        status = next;
+        const messages = {
+          configuring: "Choose the workspace, site and installation options in the browser.",
+          awaiting_local_approval: automaticSetup ? "Choose your setup options in the browser." : "Review and approve the exact local changes in the browser.",
+          applying: "Applying browser-approved local changes.",
+          ready_for_recommendations: !session.capabilities.source_review ? session.commands.some((command) => ["failed", "manual", "outcome_unknown"].includes(command.status)) ? "Setup needs attention. Check the error above and review the results in the browser." : session.capabilities.sample_read ? "Finish setup or try the optional agent check in the browser." : "Finish setup in the browser." : !automaticSetup && session.source?.status === "pending" ? "Review source files and provider details in the browser before any source upload." : "Continue with recommendations or skip that step in the browser.",
+          analyzing: automaticSetup ? "Preparing survey suggestions from your project." : "Analyzing the source packet approved in the browser.",
+          selecting_drafts: "Review recommendations and select drafts in the browser.",
+          creating_drafts: "Creating only the drafts selected in the browser.",
+          agent_test: session.sample.status === "received" ? "Simulated sample received. Finish or skip in the browser." : "Complete or skip the optional agent test in the browser.",
+          complete: "Browser setup completed.",
+          cancelled: "Browser setup cancelled. Applied changes and created drafts are listed below.",
+          expired: "Browser setup expired. Applied changes and created drafts are listed below."
+        };
+        terminal.info(messages[session.phase]);
+      },
+      onSourceIssue(code) {
+        if (automaticSetup) {
+          terminal.warn(`Survey suggestions need attention (${clean(code)}). Retry in the browser or continue without suggestions.`);
+          return;
+        }
+        terminal.warn(`Source analysis needs review (${clean(code)}). Check the browser status, then retry source review or skip it. Changed local source requires fresh approval.`);
+      },
+      onSourcePrepared(packet) {
+        if (automaticSetup) return;
+        if (displayedPacket === packet.manifest.packet_digest) return;
+        displayedPacket = packet.manifest.packet_digest;
+        terminal.block("Local source review", [
+          "The exact bounded excerpts below stay local until you approve this packet and its providers in the browser.",
+          `Packet SHA-256: ${packet.manifest.packet_digest}`,
+          ...packet.evidence.flatMap((item) => [`${clean(item.path)}:${item.start_line}-${item.end_line} (file SHA-256 ${item.file_hash})`, ...item.excerpt.split("\n").map((line) => `> ${clean(line)}`)]),
+          `Omitted files: ${packet.manifest.omitted_files}. Truncated: ${packet.manifest.truncated ? "yes" : "no"}. Git history is excluded.`
+        ]);
+      },
+      onSample(session) {
+        terminal.block("Try your agent", ["Ask: What do UserReason dummy respondents think?", "Tell your agent to read this setup\u2019s simulated sample, using:", setupSampleCommand(session.setup_id, apiOrigin, input.profile.cliVersion, input.profile), "This is example data. It does not read production responses or grant ongoing CLI access."]);
+      }
+    });
+    const summary = setupSummary(result);
+    const needsAttention = result.commands.some((command) => ["failed", "manual", "outcome_unknown"].includes(command.status));
+    terminal.block("Setup result", [
+      `Status: ${result.phase}${needsAttention ? " (installation needs attention)" : ""}`,
+      ...summary.local_operations.map((operation) => `${operation.kind}: ${operation.status}${operation.code ? ` (${operation.code})` : ""}`),
+      ...summary.manual_steps.map((step) => `${step.kind}: manual (${step.code})`),
+      ...summary.drafts.map((draft) => `Draft ${draft.prompt_id}: ${draft.status}${draft.revision ? ` (revision ${draft.revision})` : ""}`),
+      `Simulated sample: ${summary.sample}`,
+      "Ongoing CLI access was not requested. Use a separate `userreason login --open` when you want to authorize it."
+    ]);
+    if (input.json) process.stdout.write(`${JSON.stringify(summary)}
+`);
+    if (result.phase === "cancelled") process.exitCode = 130;
+    else if (result.phase !== "complete" || needsAttention) process.exitCode = 1;
+    return true;
+  } catch (error) {
+    terminal.info(`Resume from this project: ${resume}`);
+    throw error;
+  }
+}
+
+export {
+  setupSampleCommand,
+  setupResumeCommand,
+  setupManualGuidance,
+  setupSummary,
+  runBrowserWizard
+};

package/dist/{chunk-3RDJORRS.js → chunk-DMXUXEQI.js}

@@ -4,7 +4,7 @@ import {
   object,
   string,
   uuid
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 
 // src/connection.ts
 import { createHash, randomBytes } from "node:crypto";

package/dist/{chunk-SJVLAYGG.js → chunk-EVNEX5N5.js}

@@ -7,7 +7,7 @@ import {
   plainLine,
   stripAnsi,
   textWidth
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 import {
   __commonJS,
   __toESM
@@ -1235,6 +1235,7 @@ function approvalProgressMessage(progress) {
 var Cancelled = class extends Error {
   constructor() {
     super("Installation cancelled.");
+    this.name = "Cancelled";
   }
 };
 var clean = (value) => value.replace(/\r\n?/g, "\n").replace(/\t/g, "  ").replace(/[\x00-\x09\x0b-\x1f\x7f-\x9f]/g, "");
@@ -1279,6 +1280,7 @@ var Terminal = class {
   constructor(interactive, json, options = {}) {
     this.interactive = interactive;
     this.json = json;
+    this.onCancel = options.onCancel;
     this.kit = createUiKit({ level: detectColorLevel({ stream: process.stdout, off: options.color === false }) });
   }
   interactive;
@@ -1288,6 +1290,7 @@ var Terminal = class {
   cancelState = "nothing was written";
   /** True after output that leaves no guide line behind, so the next event adds one. */
   gap = false;
+  onCancel;
   header(options) {
     const lines = this.kit.header({ ...options, trademark: this.interactive });
     if (this.interactive) for (const line of lines) process.stdout.write(cleanStyled(line) + "\n");
@@ -1373,6 +1376,10 @@ var Terminal = class {
   cancelled(afterSpinner = false) {
     if (this.interactive && afterSpinner) process.stdout.write("\n");
     this.error(`Cancelled ${this.kit.c.muted(`${this.kit.S.dot} ${this.cancelState}`)}`);
+    if (this.onCancel) {
+      this.onCancel();
+      return;
+    }
     process.exit(130);
   }
   async text(message, initialValue, validate) {

package/dist/chunk-KF37D5WL.js

@@ -0,0 +1,44 @@
+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 {
+  TELEMETRY_REASONS,
+  ToolTelemetry
+} from "./chunk-7AAH6C4L.js";
+
+// src/analytics.ts
+var WizardAnalytics = class extends ToolTelemetry {
+  starts = /* @__PURE__ */ new Map();
+  begin(step) {
+    this.starts.set(step, performance.now());
+    this.step(step, "started");
+  }
+  end(step, phase = "completed") {
+    const start = this.starts.get(step);
+    this.step(step, phase, start === void 0 ? {} : { duration_ms: performance.now() - start });
+    this.starts.delete(step);
+  }
+  async measure(step, operation, phase = "applied") {
+    const start = performance.now();
+    this.begin(step);
+    await this.checkpoint();
+    try {
+      const value = await operation();
+      const result = value && typeof value === "object" ? value : void 0;
+      const outcome = result?.reason === "user_cancelled" ? "cancelled" : result?.status === "already_present" ? "already_present" : result?.status === "declined" ? "declined" : result?.status === "skipped" ? "skipped" : result?.status === "failed" ? "failed" : phase;
+      const reason = result?.reason && TELEMETRY_REASONS.includes(result.reason) ? result.reason : result?.reason?.includes("review") ? "validation_failed" : result?.reason?.includes("preserved") || result?.reason === "existing_feedback_section" ? "existing_content_preserved" : outcome === "failed" ? "operation_failed" : outcome === "skipped" ? "unsupported" : void 0;
+      this.step(step, outcome, { duration_ms: performance.now() - start, ...reason ? { reason } : {}, ...result?.file === "AGENTS.md" || result?.file === "CLAUDE.md" ? { guidance_file: result.file } : {} });
+      this.starts.delete(step);
+      return value;
+    } catch (error) {
+      this.step(step, error instanceof Error && error.name === "Cancelled" ? "cancelled" : "failed", { duration_ms: performance.now() - start, reason: error instanceof Error && error.name === "Cancelled" ? "user_cancelled" : "operation_failed" });
+      this.starts.delete(step);
+      throw error;
+    }
+  }
+  finish(cancelled = false, failed = false) {
+    for (const step of [...this.starts.keys()].reverse()) this.end(step, cancelled ? "cancelled" : failed ? "failed" : "completed");
+  }
+};
+
+export {
+  WizardAnalytics
+};

package/dist/{chunk-5SC2K42Q.js → chunk-LEJFE4U5.js}

@@ -3,10 +3,10 @@ import {
   DEFAULT_API,
   initializationSource,
   integrationSource
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-TOID3NYP.js";
 import {
   require_typescript
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 import {
   __toESM
 } from "./chunk-WL3NOIM6.js";

package/dist/{chunk-OEGNGGZ2.js → chunk-NMHTFC5Q.js}

@@ -7342,8 +7342,8 @@ import { lstat, readFile, open } from "node:fs/promises";
 import { join } from "node:path";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
-async function configurePackageRegistry(project, profile) {
-  if (profile.kind !== "local-development") return;
+async function planPackageRegistry(project, profile) {
+  if (profile.kind !== "local-development") return null;
   const modernYarn = project.packageManager === "yarn" && (project.yarnMajor ?? 1) >= 2;
   const path = join(project.directory, modernYarn ? ".yarnrc.yml" : ".npmrc");
   let before = "", metadata;
@@ -7382,7 +7382,13 @@ async function configurePackageRegistry(project, profile) {
     after = configured === profile.registry ? before : `${before}${before && !before.endsWith("\n") ? "\n" : ""}${line}
 `;
   }
-  if (after === before) return;
+  return { path, before: metadata ? before : null, after };
+}
+async function configurePackageRegistry(project, profile) {
+  const plan = await planPackageRegistry(project, profile);
+  if (!plan || plan.after === plan.before) return;
+  const { path, after } = plan, before = plan.before ?? "";
+  const metadata = plan.before === null ? null : await lstat(path);
   const handle = await open(path, metadata ? constants.O_WRONLY | (constants.O_NOFOLLOW ?? 0) : "wx", 420);
   try {
     if (metadata) {
@@ -7399,5 +7405,6 @@ async function configurePackageRegistry(project, profile) {
 
 export {
   require_dist,
+  planPackageRegistry,
   configurePackageRegistry
 };

package/dist/{chunk-6CJ4ANMN.js → chunk-NNPYUATH.js}

@@ -1,7 +1,7 @@
 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 {
   currentPackageProfile
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 
 // src/startup.ts
 import { readFile } from "node:fs/promises";

package/dist/chunk-PJQOSDYS.js

@@ -0,0 +1,50 @@
+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 {
+  sanitizeSetupDiagnostic
+} from "./chunk-7AAH6C4L.js";
+
+// src/install-diagnostics.ts
+import { readFile, readdir, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+async function installFailureDetails(directory, cache, output) {
+  const secrets = [], missing = /* @__PURE__ */ new Set();
+  for (const path of /* @__PURE__ */ new Set([join(directory, ".npmrc"), process.env.npm_config_userconfig ?? process.env.NPM_CONFIG_USERCONFIG ?? join(homedir(), ".npmrc")])) {
+    try {
+      if ((await stat(path)).size > 1e6) continue;
+      for (const line of (await readFile(path, "utf8")).split(/\r?\n/)) {
+        const match = /^\s*[^=]*(?:_authToken|_auth|_password)\s*=\s*(.+)$/i.exec(line);
+        if (!match) continue;
+        const value = match[1].trim();
+        const variable = /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/.exec(value);
+        if (variable) {
+          if (!process.env[variable[1]]) missing.add(variable[1]);
+        } else secrets.push(value);
+      }
+    } catch {
+    }
+  }
+  const requests = /* @__PURE__ */ new Set();
+  if (cache) try {
+    const folder = join(cache, "_logs");
+    for (const name of (await readdir(folder)).filter((name2) => name2.endsWith("-debug-0.log")).sort().slice(-3)) {
+      const path = join(folder, name);
+      if ((await stat(path)).size > 2e6) continue;
+      for (const line of (await readFile(path, "utf8")).split("\n")) {
+        const match = /\bhttp fetch (GET|POST|PUT) ([45]\d\d) (https?:\/\/\S+)/.exec(line);
+        if (match && requests.size < 12) requests.add(`${match[2]} ${match[1]} ${match[3]}`);
+      }
+    }
+  } catch {
+  }
+  const lines = output.split(/\r?\n/).filter((line) => !/complete log of this run|npm notice/.test(line)).slice(-45);
+  return sanitizeSetupDiagnostic([
+    ...requests,
+    ...lines,
+    ...[...missing].map((name) => `Authentication variable ${name} is not set in the wizard process.`)
+  ].join("\n"), secrets);
+}
+
+export {
+  installFailureDetails
+};