@userreason/wizard 0.2.1 → 0.3.0

package/dist/{chunk-YMSGDC4B.js → chunk-CADA5WZ3.js}

@@ -1,10 +1,10 @@
 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 {
   configurePackageRegistry
-} from "./chunk-OEGNGGZ2.js";
+} from "./chunk-NMHTFC5Q.js";
 import {
   packageProfile
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-77SK7TKZ.js";
 
 // src/project.ts
 import { lstat, readFile, writeFile, access, mkdtemp, realpath, rm } from "node:fs/promises";
@@ -140,7 +140,7 @@ async function hasCompatibleSdk(project, profile = packageProfile()) {
   try {
     const manifest = JSON.parse(await readFile(join(project.directory, "package.json"), "utf8"));
     const version = await installedVersion(project, "@userreason/js");
-    return Boolean(manifest.dependencies?.["@userreason/js"] && (profile.kind === "local-development" ? version === profile.sdkVersion : /^0\.4\.\d+$/.test(version)));
+    return Boolean(manifest.dependencies?.["@userreason/js"] && (profile.kind === "local-development" ? version === profile.sdkVersion : compatibleProductionVersion(version, profile.sdkVersion)));
   } catch {
     return false;
   }
@@ -157,8 +157,13 @@ async function hasCompatibleCli(project, profile = packageProfile()) {
     return false;
   }
 }
+function compatibleProductionVersion(version, requested) {
+  const installed = /^(\d+)\.(\d+)\.(\d+)$/.exec(version);
+  const target = /^(\d+)\.(\d+)\.(\d+)$/.exec(requested.replace(/^[~^]/, ""));
+  return Boolean(installed && target && installed[1] === target[1] && installed[2] === target[2] && Number(installed[3]) >= Number(target[3]));
+}
 function compatibleCliVersion(version, profile) {
-  return profile.kind === "local-development" ? version === profile.cliVersion : /^0\.1\.\d+$/.test(version) && Number(version.split(".")[2]) >= 1;
+  return profile.kind === "local-development" ? version === profile.cliVersion : compatibleProductionVersion(version, profile.cliVersion);
 }
 function cliInstallCommand(project, profile = packageProfile()) {
   return sdkInstallCommand(project, profile).replace("@userreason/js@" + profile.sdkVersion, "--save-dev @userreason/cli@" + profile.cliVersion).replace("yarn add --mode=skip-build --save-dev", "yarn add --mode=skip-build --dev").replace("yarn add --ignore-scripts --save-dev", "yarn add --ignore-scripts --dev");
@@ -177,10 +182,11 @@ async function installDependency(project, dependency, options) {
   const spec = dependency === "sdk" ? `@userreason/js@${profile.sdkVersion}` : `@userreason/cli@${profile.cliVersion}`;
   const args = project.packageManager === "npm" ? ["install", "--ignore-scripts", spec] : project.packageManager === "pnpm" ? ["add", "--ignore-scripts", spec] : (project.yarnMajor ?? 1) >= 2 ? ["add", "--mode=skip-build", spec] : ["add", "--ignore-scripts", spec];
   if (dependency === "cli") args.push(project.packageManager === "yarn" ? "--dev" : "--save-dev");
-  if (profile.kind === "local-development") args.push(project.packageManager === "yarn" ? "--exact" : "--save-exact");
+  if (profile.kind === "local-development" || options.exact) args.push(project.packageManager === "yarn" ? "--exact" : "--save-exact");
   let cache;
   try {
-    await configurePackageRegistry(project, profile);
+    options.signal?.throwIfAborted();
+    if (options.configureRegistry !== false) await configurePackageRegistry(project, profile);
     if (project.packageManager === "npm") {
       cache = await mkdtemp(join(await realpath(project.directory), ".userreason-npm-"));
       args.push("--cache", cache);
@@ -197,6 +203,14 @@ async function installDependency(project, dependency, options) {
           ...cache ? { npm_config_cache: cache, NPM_CONFIG_CACHE: cache } : {}
         }
       });
+      let killTimer;
+      const abort = () => {
+        child.kill("SIGTERM");
+        killTimer = setTimeout(() => child.kill("SIGKILL"), 2e3);
+        killTimer.unref();
+      };
+      options.signal?.addEventListener("abort", abort, { once: true });
+      if (options.signal?.aborted) abort();
       let logs = "";
       const capture = (chunk) => {
         const text = chunk.toString();
@@ -207,6 +221,12 @@ async function installDependency(project, dependency, options) {
       child.stderr?.on("data", capture);
       child.on("error", () => reject(new SdkInstallError(`Unable to start ${project.packageManager}.`)));
       child.on("close", (code) => {
+        options.signal?.removeEventListener("abort", abort);
+        if (killTimer) clearTimeout(killTimer);
+        if (options.signal?.aborted) {
+          reject(options.signal.reason);
+          return;
+        }
         if (code === 0) {
           if (/\b[1-9]\d*\s+vulnerabilit(?:y|ies)\b|\bWARN\b|\bwarning\b/i.test(logs))
             options.onWarning?.(
@@ -266,10 +286,12 @@ export {
   initializationSource,
   integrationSource,
   writeIntegration,
+  installedVersion,
   cliCommand,
   hasCompatibleSdk,
   sdkInstallCommand,
   hasCompatibleCli,
+  compatibleProductionVersion,
   compatibleCliVersion,
   cliInstallCommand,
   SdkInstallError,

package/dist/{chunk-HACTNBV3.js → chunk-F4FKAUQN.js}

@@ -2,14 +2,14 @@ import { createRequire as createWizardRequire } from 'node:module'; import { fil
 import {
   Cancelled,
   openBrowser
-} from "./chunk-SJVLAYGG.js";
+} from "./chunk-GOYBYAUH.js";
 import {
   authorizeCli,
   grantSummary,
   printable,
   resolveCredentials,
   saveConfig
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-77SK7TKZ.js";
 
 // src/cli-access.ts
 async function offerCliAccess(config, terminal, options) {
@@ -39,7 +39,7 @@ async function offerCliAccess(config, terminal, options) {
     return { status: "approved", grant };
   } catch (error) {
     waiting?.stop();
-    if (error instanceof Cancelled) return { status: "declined" };
+    if (error instanceof Cancelled) return { status: "declined", reason: "user_cancelled" };
     if (error instanceof Error) terminal.warn(printable(error.message));
     terminal.warn("The application is installed, but ongoing CLI access was not connected. Run the project CLI with login --open to finish.");
     return { status: "failed" };

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

@@ -7,7 +7,7 @@ import {
   plainLine,
   stripAnsi,
   textWidth
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-77SK7TKZ.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-HIF6NUNK.js

@@ -0,0 +1,33 @@
+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 {
+  firstSurvey,
+  firstSurveyHandoff,
+  prepareFirstSurveyLocally,
+  recommendedSurveys
+} from "./chunk-77SK7TKZ.js";
+
+// src/first-survey.ts
+function beginFirstSurveyPreparation(root, mode, prepare = prepareFirstSurveyLocally) {
+  return mode.development && mode.interactive && !mode.preview ? prepare(root) : void 0;
+}
+async function offerFirstSurvey(client, root, workspace, site, ui, mode) {
+  if (!mode.interactive || mode.preview) return { state: "skipped" };
+  if (mode.development) return recommendedSurveys(client, root, workspace, site, ui, mode);
+  const choice = await ui.choose(
+    "Find your first useful survey? Nothing changes or publishes automatically.",
+    [
+      { value: "guided", label: "Review suggestions" },
+      { value: "agent", label: "Continue with my coding agent" },
+      { value: "finish", label: "Finish setup" }
+    ],
+    "finish"
+  );
+  if (choice === "agent") ui.show(firstSurveyHandoff(root, client.config.apiUrl, workspace, site));
+  if (choice === "guided") return firstSurvey(client, root, workspace, site, ui);
+  return { state: "skipped" };
+}
+
+export {
+  beginFirstSurveyPreparation,
+  offerFirstSurvey
+};

package/dist/{chunk-6CJ4ANMN.js → chunk-MFGJ2KPT.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-77SK7TKZ.js";
 
 // src/startup.ts
 import { readFile } from "node:fs/promises";

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-5Z5J6PY5.js → chunk-NZ65XDNL.js}

@@ -1,13 +1,13 @@
 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";
+} from "./chunk-GOYBYAUH.js";
 import {
   cliCommand
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-CADA5WZ3.js";
 import {
   require_dist
-} from "./chunk-OEGNGGZ2.js";
+} from "./chunk-NMHTFC5Q.js";
 import {
   __toESM
 } from "./chunk-WL3NOIM6.js";
@@ -245,7 +245,7 @@ Agents can propose feedback investigations, read the current documentation and u
     terminal.success("Feedback skill installed in .agents/skills/userreason");
     return { status: "added", path: ".agents/skills/userreason" };
   } 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 agent skill could not be installed; the skill directory needs review.");
     return { status: "failed", reason: "skill_directory_needs_review" };
   }

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

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

package/dist/chunk-SFODN2YB.js

@@ -0,0 +1,196 @@
+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 {
+  applyIntegration
+} from "./chunk-5IO5LY22.js";
+import {
+  require_typescript
+} from "./chunk-77SK7TKZ.js";
+import {
+  __toESM
+} from "./chunk-WL3NOIM6.js";
+
+// src/footer.ts
+var import_typescript = __toESM(require_typescript(), 1);
+import { createHash } from "node:crypto";
+import { lstat, readFile } from "node:fs/promises";
+import { dirname, extname, join, relative, resolve } from "node:path";
+var FOOTER_LINK = '<a href="https://userreason.com/" data-userreason-footer="v1">Powered by UserReason</a>';
+var digest = (text) => createHash("sha256").update(text).digest("hex");
+async function source(root, path, overlay) {
+  const local = relative(root, path);
+  if (!local || local.startsWith("..") || local.includes("\\")) return;
+  let current = root;
+  for (const part of local.split("/")) {
+    current = join(current, part);
+    let info2;
+    try {
+      info2 = await lstat(current);
+    } catch (error) {
+      if (error.code === "ENOENT") return;
+      throw error;
+    }
+    if (info2.isSymbolicLink()) return;
+  }
+  const info = await lstat(path);
+  if (!info.isFile() || info.nlink !== 1 || info.size > 1e6) return;
+  return overlay?.get(path) ?? readFile(path, "utf8");
+}
+function parse(path, text) {
+  const ast = import_typescript.default.createSourceFile(path, text, import_typescript.default.ScriptTarget.Latest, true, /\.(?:jsx|tsx|js)$/.test(path) ? import_typescript.default.ScriptKind.TSX : import_typescript.default.ScriptKind.TS);
+  return ast.parseDiagnostics?.length ? void 0 : ast;
+}
+function jsxFooters(path, text) {
+  const ast = parse(path, text);
+  if (!ast) return [];
+  const result = [];
+  const visit = (node) => {
+    if (import_typescript.default.isJsxElement(node) && node.openingElement.tagName.getText(ast) === "footer") {
+      result.push({ path, source: text, start: node.getStart(ast), insertion: node.closingElement.getStart(ast), end: node.end });
+    }
+    import_typescript.default.forEachChild(node, visit);
+  };
+  visit(ast);
+  return result;
+}
+function htmlFooters(path, text, start = 0, stop = text.length) {
+  const result = [], stack = [];
+  let at = start;
+  while (at < stop) {
+    const open = text.indexOf("<", at);
+    if (open < 0 || open >= stop) break;
+    if (text.startsWith("<!--", open)) {
+      const close = text.indexOf("-->", open + 4);
+      if (close < 0) return [];
+      at = close + 3;
+      continue;
+    }
+    const name = /^<\s*(\/?)\s*([A-Za-z][A-Za-z0-9:-]*)\b/.exec(text.slice(open));
+    if (!name) {
+      at = open + 1;
+      continue;
+    }
+    let end = open + name[0].length, quote = "";
+    for (; end < stop; end++) {
+      const char = text[end];
+      if (quote) {
+        if (char === quote) quote = "";
+      } else if (char === '"' || char === "'") quote = char;
+      else if (char === ">") break;
+    }
+    if (end >= stop) return [];
+    const tag = name[2].toLowerCase(), closing = Boolean(name[1]), self = /\/\s*$/.test(text.slice(open, end));
+    if (!closing && ["script", "style", "textarea"].includes(tag)) {
+      const tail = new RegExp(`<\\/\\s*${tag}\\s*>`, "ig");
+      tail.lastIndex = end + 1;
+      const match = tail.exec(text);
+      if (!match) return [];
+      at = tail.lastIndex;
+      continue;
+    }
+    if (tag === "footer") {
+      if (self) return [];
+      if (!closing) stack.push(open);
+      else {
+        const begin = stack.pop();
+        if (begin === void 0) return [];
+        result.push({ path, source: text, start: begin, insertion: open, end: end + 1 });
+      }
+    }
+    at = end + 1;
+  }
+  return stack.length ? [] : result;
+}
+function vueParts(text) {
+  const starts = [...text.matchAll(/<template(?:\s[^>]*|)>/g)];
+  const first = starts[0];
+  const end = text.lastIndexOf("</template>");
+  return {
+    template: first && end > first.index ? { start: first.index + first[0].length, end } : void 0,
+    scripts: [...text.matchAll(/<script\b[^>]*>([\s\S]*?)<\/script\s*>/g)].map((match) => match[1])
+  };
+}
+async function imports(root, path, text, overlay) {
+  const parts = extname(path) === ".vue" ? vueParts(text) : void 0;
+  const script = parts ? parts.scripts.join("\n") : text;
+  const ast = parse(path + ".tsx", script);
+  if (!ast) return [];
+  const result = [];
+  for (const statement of ast.statements) {
+    if (!import_typescript.default.isImportDeclaration(statement) || !import_typescript.default.isStringLiteral(statement.moduleSpecifier) || !statement.moduleSpecifier.text.startsWith(".")) continue;
+    const bindings = [statement.importClause?.name?.text, ...statement.importClause?.namedBindings && import_typescript.default.isNamedImports(statement.importClause.namedBindings) ? statement.importClause.namedBindings.elements.map((item) => item.name.text) : []].filter((name) => Boolean(name));
+    const body = script.slice(0, statement.pos) + script.slice(statement.end) + (parts?.template ? text.slice(parts.template.start, parts.template.end) : "");
+    if (!bindings.some((name) => new RegExp(`(?:<|\\b)${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:[\\s/>.(),])`).test(body))) continue;
+    const base = resolve(dirname(path), statement.moduleSpecifier.text);
+    for (const candidate of [base, ...[".tsx", ".jsx", ".ts", ".js", ".vue"].map((extension) => base + extension), ...["index.tsx", "index.jsx", "index.ts", "index.js", "index.vue"].map((file) => join(base, file))]) {
+      if (await source(root, candidate, overlay) !== void 0) {
+        result.push(candidate);
+        break;
+      }
+    }
+  }
+  return result;
+}
+async function planFooter(project, overlay) {
+  const root = resolve(project.directory);
+  const entries = project.framework === "vanilla" ? ["index.html"] : project.framework === "next" ? ["app/layout.tsx", "app/layout.jsx", "app/layout.js", "src/app/layout.tsx", "src/app/layout.jsx", "src/app/layout.js", "pages/_app.tsx", "pages/_app.jsx", "src/pages/_app.tsx", "src/pages/_app.jsx"] : project.framework === "vue" ? ["src/main.ts", "src/main.js", "main.ts", "main.js"] : ["src/main.tsx", "src/main.jsx", "src/index.tsx", "src/index.jsx", "src/index.js", "src/main.js", "index.jsx"];
+  const queue = [];
+  for (const file of entries) {
+    const path = join(root, file), text = await source(root, path, overlay);
+    if (text !== void 0) queue.push({ path, source: text });
+  }
+  if (queue.length !== 1) return { status: "manual", code: "unsupported_footer", candidates: [] };
+  const seen = /* @__PURE__ */ new Set(), candidates = [];
+  while (queue.length) {
+    const file = queue.shift();
+    if (seen.has(file.path)) continue;
+    if (seen.size >= 80) return { status: "manual", code: "unsupported_footer", candidates: [] };
+    seen.add(file.path);
+    if (extname(file.path) === ".html") candidates.push(...htmlFooters(file.path, file.source));
+    else if (extname(file.path) === ".vue") {
+      const range = vueParts(file.source).template;
+      if (range) candidates.push(...htmlFooters(file.path, file.source, range.start, range.end));
+    } else candidates.push(...jsxFooters(file.path, file.source));
+    for (const path of await imports(root, file.path, file.source, overlay)) {
+      const text = await source(root, path, overlay);
+      if (text !== void 0) queue.push({ path, source: text });
+    }
+  }
+  const listed = candidates.map((candidate2) => ({ path: relative(root, candidate2.path), line: candidate2.source.slice(0, candidate2.start).split("\n").length }));
+  const attribution = /<a\b[^>]*href\s*=\s*["']https:\/\/(?:www\.)?userreason\.com\/?["'][^>]*>\s*Powered by UserReason\s*<\/a\s*>/i;
+  const marked = candidates.filter((candidate2) => attribution.test(candidate2.source.slice(candidate2.start, candidate2.end)));
+  if (marked.length === 1) {
+    const candidate2 = marked[0];
+    return { status: "already_present", directory: root, path: candidate2.path, before: candidate2.source, after: candidate2.source, anchorHash: digest(candidate2.source.slice(candidate2.start, candidate2.end)) };
+  }
+  if (candidates.length !== 1) return { status: "manual", code: candidates.length ? "ambiguous_footer" : "missing_footer", candidates: listed };
+  const candidate = candidates[0];
+  const existing = candidate.source.slice(candidate.start, candidate.end);
+  if (attribution.test(existing))
+    return { status: "already_present", directory: root, path: candidate.path, before: candidate.source, after: candidate.source, anchorHash: digest(existing) };
+  const line = candidate.source.slice(0, candidate.insertion).split("\n").at(-1) ?? "";
+  const indent = /^\s*/.exec(line)?.[0] ?? "";
+  const insertion = `
+${indent}  ${FOOTER_LINK}
+${indent}`;
+  return {
+    status: "ready",
+    directory: root,
+    path: candidate.path,
+    before: candidate.source,
+    after: candidate.source.slice(0, candidate.insertion) + insertion + candidate.source.slice(candidate.insertion),
+    anchorHash: digest(existing)
+  };
+}
+async function applyFooter(plan) {
+  if (plan.status === "already_present") {
+    if (await source(plan.directory, plan.path) !== plan.before) throw new Error("Footer changed after review");
+    return;
+  }
+  await applyIntegration({ ...plan, status: "ready", description: "Add UserReason attribution to the existing page footer" });
+}
+
+export {
+  FOOTER_LINK,
+  planFooter,
+  applyFooter
+};

package/dist/chunk-UN24JFV2.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-77SK7TKZ.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-VXWLSQYK.js

@@ -0,0 +1,130 @@
+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-YYFC7TM2.js";
+import {
+  clean,
+  openBrowser
+} from "./chunk-GOYBYAUH.js";
+import {
+  BrowserSetupUnavailable
+} from "./chunk-77SK7TKZ.js";
+
+// src/setup-flow.ts
+var shell = (value) => /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replace(/'/g, `'"'"'`)}'`;
+function setupSampleCommand(setupId, apiOrigin, cliVersion) {
+  return ["npx", "-y", `@userreason/cli@${cliVersion}`, "setup", "sample", "--setup", setupId, "--api-url", apiOrigin, "--directory", ".", "--json"].map(shell).join(" ");
+}
+function setupResumeCommand(setupId, apiOrigin, version) {
+  return ["npx", "-y", `@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}`, "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, measurementDisabled: input.measurementDisabled });
+  } catch (error) {
+    if (!input.resumeId && error instanceof BrowserSetupUnavailable) return false;
+    throw error;
+  }
+  const resume = setupResumeCommand(connected.client.identity.setup_id, apiOrigin, input.version);
+  terminal.block("Setup connected", [`Setup: ${connected.client.identity.setup_id}`, "Keep this terminal open. The browser controls approvals, draft choices and cancellation.", `To reconnect from this project: ${resume}`]);
+  let status = "", displayedPacket = "";
+  const shownManual = /* @__PURE__ */ new Set();
+  try {
+    const result = await runSetup(connected.client, project, {
+      signal,
+      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: "Review and approve the exact local changes in the browser.",
+          applying: "Applying browser-approved local changes.",
+          ready_for_recommendations: 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: "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) {
+        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 (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), "This is example data. It does not read production responses or grant ongoing CLI access."]);
+      }
+    });
+    const summary = setupSummary(result);
+    terminal.block("Setup result", [
+      `Status: ${result.phase}`,
+      ...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") process.exitCode = 1;
+    return true;
+  } catch (error) {
+    terminal.info(`Resume from this project: ${resume}`);
+    throw error;
+  }
+}
+
+export {
+  setupSampleCommand,
+  setupResumeCommand,
+  setupManualGuidance,
+  setupSummary,
+  runBrowserWizard
+};