@userreason/wizard 0.2.1 → 0.3.1

package/dist/chunk-Q5U5UOQN.js

@@ -0,0 +1,288 @@
+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 {
+  planFooter
+} from "./chunk-4INLEQE2.js";
+import {
+  planAgentSkill
+} from "./chunk-SB3AYQWG.js";
+import {
+  detectInstallation,
+  initializationPath,
+  planIntegration
+} from "./chunk-LEJFE4U5.js";
+import {
+  compatibleProductionVersion,
+  inspectProject,
+  installCli,
+  installSdk,
+  installedVersion,
+  integrationSource
+} from "./chunk-TOID3NYP.js";
+import {
+  planPackageRegistry
+} from "./chunk-NMHTFC5Q.js";
+import {
+  SetupError,
+  apiUrl,
+  connectBrowserSetup,
+  detectSetupTerminal,
+  packageProfile,
+  readSetupFile,
+  resumeBrowserSetup,
+  runBrowserSetup,
+  runSetupExecutor,
+  setupDigest,
+  setupHash,
+  verifySetupFiles,
+  writeSetupFile
+} from "./chunk-7AAH6C4L.js";
+
+// src/setup.ts
+import { basename } from "node:path";
+
+// src/setup-plan.ts
+import { randomUUID } from "node:crypto";
+import { lstat, readdir, readFile } from "node:fs/promises";
+import { join, relative } from "node:path";
+var relativeName = (project, path) => relative(project.directory, path).replaceAll("\\", "/");
+var metadata = (files) => files.map((file2) => ({ path: file2.path, before_hash: file2.before === null ? null : setupHash(file2.before), after_hash: setupHash(file2.after) }));
+var exactVersion = (value) => {
+  const version = value.replace(/^[~^]/, "");
+  if (!/^\d+\.\d+\.\d+(?:-[A-Za-z0-9.-]+)?(?:\+[A-Za-z0-9.-]+)?$/.test(version)) throw new SetupError("setup_package_version", "The package profile must resolve to an exact version before review.");
+  return version;
+};
+async function alreadyCompatible(project, name, profile) {
+  try {
+    const manifest = JSON.parse(await readSetupFile(project.directory, "package.json"));
+    const declaration = (name === "@userreason/js" ? manifest.dependencies : manifest.devDependencies)?.[name];
+    if (!declaration) return false;
+    const installed = JSON.parse(await readSetupFile(project.directory, `node_modules/${name}/package.json`)).version;
+    if (typeof installed !== "string") return false;
+    return profile.kind === "local-development" ? installed === (name === "@userreason/js" ? profile.sdkVersion : profile.cliVersion) : compatibleProductionVersion(installed, name === "@userreason/js" ? profile.sdkVersion : profile.cliVersion);
+  } catch {
+    return false;
+  }
+}
+async function file(project, path, after) {
+  const name = relativeName(project, path);
+  return { path: name, before: await readSetupFile(project.directory, name), after };
+}
+async function installationFiles(project, config) {
+  const plan = await planIntegration(project, config);
+  if (plan.status === "manual") return null;
+  if (plan.status === "integrated") {
+    const found = await detectInstallation(project), path = await initializationPath(project);
+    if (!found || !path || found.siteId !== config.siteId || found.apiBaseUrl !== config.apiBaseUrl) return null;
+    const before = await readSetupFile(project.directory, relativeName(project, path));
+    return before === null ? null : [{ path: relativeName(project, path), before, after: before }];
+  }
+  if (plan.status !== "ready") return null;
+  const result = [await file(project, plan.path, plan.after)];
+  if (plan.legacyNext) {
+    const helper = integrationSource(project.framework, config, project.typescript, true);
+    const planned = await file(project, join(project.sourceDirectory, helper.filename), helper.content);
+    if (planned.before !== null && planned.before !== planned.after) return null;
+    result.unshift(planned);
+  }
+  return result;
+}
+async function prepareSetupPlan(project, session, apiOrigin, selectedProfile = packageProfile()) {
+  const profile = { ...selectedProfile, sdkVersion: exactVersion(selectedProfile.sdkVersion), cliVersion: exactVersion(selectedProfile.cliVersion) };
+  const operations = [], manual = [];
+  const config = session.site_id ? { siteId: session.site_id, apiBaseUrl: apiUrl(apiOrigin) } : null;
+  return prepare(project, session, profile, config, operations, manual);
+}
+async function prepare(project, session, profile, config, operations = [], manual = []) {
+  const add = (kind, files, extra = {}) => {
+    const effect = { effect_id: randomUUID(), kind, files: metadata(files), ...extra };
+    operations.push({ effect, files });
+  };
+  let initialized = false;
+  let initialization = null;
+  if (session.choices.install_sdk) {
+    initialization = config ? await installationFiles(project, config) : null;
+    initialized = initialization !== null;
+    if (!initialization) manual.push({ kind: "initialize_sdk", code: "review_required" });
+  } else if (config) {
+    const installed = await detectInstallation(project);
+    initialized = installed?.siteId === config.siteId && installed?.apiBaseUrl === config.apiBaseUrl;
+  }
+  const packages = [];
+  if (session.choices.install_sdk && !await alreadyCompatible(project, "@userreason/js", profile)) packages.push({ name: "@userreason/js", version: exactVersion(profile.sdkVersion) });
+  if (session.choices.install_skill && initialized && !await alreadyCompatible(project, "@userreason/cli", profile)) packages.push({ name: "@userreason/cli", version: exactVersion(profile.cliVersion) });
+  if (packages.length) {
+    const before = await readSetupFile(project.directory, "package.json");
+    if (!before) throw new SetupError("setup_manifest_invalid", "The project needs an ordinary package.json.");
+    const manifest = JSON.parse(before);
+    for (const item of packages) {
+      const section = item.name === "@userreason/js" ? "dependencies" : "devDependencies";
+      if (manifest[section] && (typeof manifest[section] !== "object" || Array.isArray(manifest[section]))) throw new SetupError("setup_manifest_invalid", "The dependency manifest needs review.");
+      manifest[section] = { ...manifest[section], [item.name]: item.version };
+      const other = section === "dependencies" ? "devDependencies" : "dependencies";
+      if (manifest[other]?.[item.name] !== void 0) {
+        delete manifest[other][item.name];
+        if (!Object.keys(manifest[other]).length) delete manifest[other];
+      }
+    }
+    const indent = /\n([ \t]+)"/.exec(before)?.[1] ?? "  ";
+    const after = JSON.stringify(manifest, null, indent) + (before.endsWith("\n") ? "\n" : "");
+    const files = [{ path: "package.json", before, after }];
+    const registry = await planPackageRegistry(project, profile);
+    if (registry) files.push({ ...registry, path: relativeName(project, registry.path) });
+    const guards = [];
+    for (const path of [".npmrc", ".yarnrc", ".yarnrc.yml"]) {
+      const content = await readSetupFile(project.directory, path);
+      if (!files.some((file2) => file2.path === path) && content !== null) files.push({ path, before: content, after: content });
+      guards.push({ path, before_hash: content === null ? null : setupHash(content) });
+    }
+    const paths = project.packageManager === "npm" ? ["package-lock.json"] : project.packageManager === "pnpm" ? ["pnpm-lock.yaml"] : ["yarn.lock", ".pnp.cjs", ".pnp.loader.mjs"];
+    const managed_outputs = await Promise.all(paths.map(async (path) => {
+      const content = await readSetupFile(project.directory, path);
+      return { path, before_hash: content === null ? null : setupHash(content) };
+    }));
+    add("install_packages", files, { package_manager: project.packageManager, packages, managed_outputs });
+    operations.at(-1).guards = guards;
+  }
+  if (initialization) add("initialize_sdk", initialization, { site_id: config.siteId });
+  if (session.choices.install_skill) {
+    if (!initialized) manual.push({ kind: "install_skill", code: "dependency_failed" });
+    else {
+      const skill = await planAgentSkill(project);
+      if ("files" in skill && (!skill.update || Object.keys(skill.update.snapshot).every((path) => skill.files.some((file2) => file2.path === path)))) {
+        const files = await Promise.all(skill.files.map((item) => file(project, join(skill.path, item.path), item.content)));
+        add("install_skill", files);
+      } else if (!("files" in skill) && skill.reason === "up_to_date" && skill.path) {
+        const files = await Promise.all(["references/management.md", "SKILL.md"].map(async (path) => {
+          const name = `${skill.path}/${path}`;
+          const before = await readSetupFile(project.directory, name);
+          if (before === null) throw new Error("Missing installed skill");
+          return { path: name, before, after: before };
+        }));
+        add("install_skill", files);
+      } else manual.push({ kind: "install_skill", code: "review_required" });
+    }
+  }
+  if (session.choices.footer_badge) {
+    const overlay = new Map(operations.flatMap((operation) => operation.files.map((file2) => [join(project.directory, file2.path), file2.after])));
+    const footer = await planFooter(project, overlay);
+    if (footer.status === "manual") manual.push({ kind: "insert_footer", code: footer.code === "missing_footer" ? "unsupported" : "review_required" });
+    else add("insert_footer", [{ path: relativeName(project, footer.path), before: footer.before, after: footer.after }], { placement: { path: relativeName(project, footer.path), anchor_hash: footer.anchorHash } });
+  }
+  return { wire: { project_fingerprint: session.project_fingerprint, choices_digest: setupDigest(session.choices), effects: operations.map((item) => item.effect), ...manual.length ? { manual_steps: manual } : {} }, operations };
+}
+async function snapshot(project) {
+  const result = {}, stack = [""];
+  let entries = 0, bytes = 0;
+  while (stack.length) {
+    const folder = stack.pop();
+    for (const entry of await readdir(join(project.directory, folder), { withFileTypes: true })) {
+      if (++entries > 2e4) throw new SetupError("setup_files_changed", "Project scanning exceeds the bounded review budget.");
+      const path = folder ? `${folder}/${entry.name}` : entry.name;
+      if (path === "node_modules" || path === ".git" || /^\.userreason-npm-/.test(path) || /^\.yarn\/(cache|unplugged)(\/|$)/.test(path) || path === ".yarn/install-state.gz") continue;
+      const info = await lstat(join(project.directory, path));
+      if (info.isSymbolicLink()) {
+        result[path] = "link";
+        continue;
+      }
+      if (info.isDirectory()) stack.push(path);
+      else if (info.isFile()) {
+        bytes += info.size;
+        if (info.size > 2e7 || bytes > 64e6) throw new SetupError("setup_files_changed", "Project scanning exceeds the bounded byte budget.");
+        result[path] = setupHash(await readFile(join(project.directory, path)));
+      }
+    }
+  }
+  return result;
+}
+function setupRuntime(project, apiOrigin, selectedProfile = packageProfile()) {
+  apiOrigin = apiUrl(apiOrigin);
+  const profile = { ...selectedProfile, sdkVersion: exactVersion(selectedProfile.sdkVersion), cliVersion: exactVersion(selectedProfile.cliVersion) };
+  return {
+    prepare: (session) => prepare(project, session, profile, session.site_id ? { siteId: session.site_id, apiBaseUrl: apiOrigin } : null),
+    async apply(operation, signal) {
+      const current = await inspectProject(project.directory, project.framework);
+      if (current.packageManager !== project.packageManager) throw new SetupError("setup_files_changed", "The package manager changed after review.");
+      if (operation.effect.kind !== "install_packages") {
+        if (operation.effect.kind === "insert_footer") {
+          const footer = await planFooter(current);
+          if (footer.status === "manual" || relativeName(project, footer.path) !== operation.effect.placement.path || footer.anchorHash !== operation.effect.placement.anchor_hash || footer.after !== operation.files[0]?.after)
+            throw new SetupError("setup_files_changed", "The reviewed footer placement changed.");
+        }
+        if (operation.effect.kind === "install_skill") {
+          const skill = await planAgentSkill(current);
+          if ("files" in skill) {
+            if (skill.files.length !== operation.files.length || skill.files.some((item) => !operation.files.some((file2) => file2.path === relativeName(project, join(skill.path, item.path)) && file2.after === item.content)))
+              throw new SetupError("setup_files_changed", "The reviewed skill changed.");
+          } else if (skill.reason !== "up_to_date" || !operation.files.every((file2) => file2.before === file2.after)) throw new SetupError("setup_files_changed", "An existing skill needs review.");
+        }
+        const already = operation.files.every((file2) => file2.before === file2.after);
+        for (const file2 of operation.files) {
+          signal.throwIfAborted();
+          await writeSetupFile(project.directory, file2);
+        }
+        return already ? "already_present" : "verified";
+      }
+      if (operation.effect.package_manager !== current.packageManager) throw new SetupError("setup_command_mismatch", "The package manager differs from the reviewed command.");
+      for (const item of operation.effect.packages) if (item.version !== (item.name === "@userreason/js" ? profile.sdkVersion : profile.cliVersion)) throw new SetupError("setup_package_version", "The approved package version differs from this local package profile.");
+      const before = await snapshot(project);
+      for (const file2 of operation.files.filter((file3) => file3.path !== "package.json")) await writeSetupFile(project.directory, file2);
+      for (const item of operation.effect.packages) {
+        signal.throwIfAborted();
+        await (item.name === "@userreason/js" ? installSdk : installCli)(current, { profile, exact: true, signal, configureRegistry: false });
+      }
+      const manifest = operation.files.find((file2) => file2.path === "package.json");
+      const actual = await readSetupFile(project.directory, manifest.path);
+      if (!actual || setupDigest(JSON.parse(actual)) !== setupDigest(JSON.parse(manifest.after))) throw new Error("The package manager made unexpected manifest changes");
+      await writeSetupFile(project.directory, { ...manifest, before: actual });
+      const after = await snapshot(project), allowed = /* @__PURE__ */ new Set([...operation.files.map((file2) => file2.path), ...(operation.effect.managed_outputs ?? []).map((file2) => file2.path)]);
+      for (const path of /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)])) if (!allowed.has(path) && before[path] !== after[path]) throw new Error("The package manager changed an unreviewed project file");
+      return "verified";
+    },
+    async verify(operation) {
+      if (!await verifySetupFiles(project.directory, operation.files, "after")) return false;
+      if (operation.effect.kind !== "install_packages") return true;
+      for (const item of operation.effect.packages) if (await installedVersion(project, item.name).catch(() => "") !== item.version) return false;
+      return true;
+    }
+  };
+}
+
+// src/setup.ts
+function connectSetup(apiOrigin, project, onBrowser, options = {}) {
+  return connectBrowserSetup(apiOrigin, {
+    directory: project.directory,
+    browserOrigin: options.browserOrigin,
+    capabilities: {
+      framework: project.framework,
+      package_manager: project.packageManager,
+      install_packages: true,
+      initialize_sdk: true,
+      install_skill: true,
+      insert_footer: true,
+      source_review: true,
+      sample_read: true,
+      ...options.automaticSetup ? { onboarding_v2: true } : {},
+      ...options.launcher ? { launcher: options.launcher } : {},
+      project_name: basename(project.directory).replace(/[\u0000-\u001f\u007f\/\\]/g, "").trim().slice(0, 120) || "Application",
+      terminal: detectSetupTerminal()
+    }
+  }, onBrowser, options);
+}
+function resumeSetup(apiOrigin, setupId, project, options = {}) {
+  return resumeBrowserSetup(apiOrigin, setupId, project.directory, options);
+}
+function executeSetup(client, project, options = {}) {
+  return runSetupExecutor(client, project.directory, setupRuntime(project, client.identity.api_url), options);
+}
+function runSetup(client, project, options = {}) {
+  return runBrowserSetup(client, project.directory, setupRuntime(project, client.identity.api_url), options);
+}
+
+export {
+  prepareSetupPlan,
+  setupRuntime,
+  connectSetup,
+  resumeSetup,
+  executeSetup,
+  runSetup
+};

package/dist/{chunk-5Z5J6PY5.js → chunk-SB3AYQWG.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";
 import {
   cliCommand
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-TOID3NYP.js";
 import {
   require_dist
-} from "./chunk-OEGNGGZ2.js";
+} from "./chunk-NMHTFC5Q.js";
+import {
+  Cancelled
+} from "./chunk-EVNEX5N5.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-YMSGDC4B.js → chunk-TOID3NYP.js}

@@ -1,10 +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 {
+  installFailureDetails
+} from "./chunk-PJQOSDYS.js";
 import {
   configurePackageRegistry
-} from "./chunk-OEGNGGZ2.js";
+} from "./chunk-NMHTFC5Q.js";
 import {
   packageProfile
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 
 // src/project.ts
 import { lstat, readFile, writeFile, access, mkdtemp, realpath, rm } from "node:fs/promises";
@@ -140,7 +143,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 +160,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 +185,12 @@ 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;
+  let logs = "";
   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,16 +207,28 @@ async function installDependency(project, dependency, options) {
           ...cache ? { npm_config_cache: cache, NPM_CONFIG_CACHE: cache } : {}
         }
       });
-      let logs = "";
+      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();
       const capture = (chunk) => {
         const text = chunk.toString();
         logs = (logs + text).slice(-64e3);
-        if (options.verbose) process.stderr.write(text);
       };
       child.stdout?.on("data", capture);
       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?.(
@@ -217,19 +239,24 @@ async function installDependency(project, dependency, options) {
           const restricted = /ERR_ACCESS_DENIED|Access to this API has been restricted/.test(logs);
           reject(
             new SdkInstallError(
-              restricted ? `Your Node or package-manager permission policy blocked ${label} installation. Run the manual install command in your normal terminal.` : `${label} installation failed (${project.packageManager} exit ${code}). Rerun with --debug to inspect package-manager output.`
+              restricted ? `Your Node or package-manager permission policy blocked ${label} installation. Run the manual install command in your normal terminal.` : `${label} installation failed (${project.packageManager} exit ${code}). Package-manager details follow.`
             )
           );
         }
       });
     });
   } catch (error) {
-    if (error instanceof SdkInstallError) throw error;
+    if (error instanceof SdkInstallError) {
+      const details = await installFailureDetails(project.directory, cache, logs);
+      if (details) error.message += "\n" + details;
+      throw error;
+    }
     throw new SdkInstallError(
-      "Unable to prepare a writable SDK install cache inside the project. Run the manual install command in your normal terminal.",
+      "Unable to prepare or run package installation. " + await installFailureDetails(project.directory, cache, error instanceof Error ? error.message : "Unknown local error."),
       { cause: error }
     );
   } finally {
+    if (options.verbose && logs) process.stderr.write(await installFailureDetails(project.directory, cache, logs) + "\n");
     if (cache) {
       try {
         await rm(cache, { recursive: true, force: true });
@@ -266,10 +293,12 @@ export {
   initializationSource,
   integrationSource,
   writeIntegration,
+  installedVersion,
   cliCommand,
   hasCompatibleSdk,
   sdkInstallCommand,
   hasCompatibleCli,
+  compatibleProductionVersion,
   compatibleCliVersion,
   cliInstallCommand,
   SdkInstallError,

package/dist/{chunk-JD5U4U26.js → chunk-TRBSH5G7.js}

@@ -1,14 +1,14 @@
 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 {
   cliCommand,
   compatibleCliVersion
-} 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/global-cli.ts
 import { execFile } from "node:child_process";
@@ -102,7 +102,7 @@ This installs development CLI ${profile.cliVersion} from ${profile.registry}, re
     if (!available) terminal.warn(`Global CLI ${installed.version} is installed, but this terminal does not resolve userreason to it. Check npm's global bin directory in PATH and restart your terminal or agent. Use ${cliCommand(project)} in this project meanwhile.`);
     return { status: reuse ? "already_present" : "installed", version: installed.version, command_available: available };
   } catch (error) {
-    if (error instanceof Cancelled) return { status: "declined" };
+    if (error instanceof Cancelled) return { status: "declined", reason: "user_cancelled" };
     terminal.warn(`The optional global CLI could not be set up. ${error instanceof Error ? error.message : ""}`);
     terminal.note(`${command}
 

package/dist/{chunk-ZGZOBW2B.js → chunk-XASPGFYK.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-5SC2K42Q.js";
+} from "./chunk-LEJFE4U5.js";
 import {
   DEFAULT_API
-} from "./chunk-YMSGDC4B.js";
+} from "./chunk-TOID3NYP.js";
 import {
   apiUrl,
   configDirectory,
   uuid
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 
 // src/state.ts
 import { mkdir, readFile, writeFile, rename, rm, realpath, lstat } from "node:fs/promises";

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

@@ -2,14 +2,14 @@ import { createRequire as createWizardRequire } from 'node:module'; import { fil
 import {
   Cancelled,
   openBrowser
-} from "./chunk-SJVLAYGG.js";
+} from "./chunk-EVNEX5N5.js";
 import {
   authorizeCli,
   grantSummary,
   printable,
   resolveCredentials,
   saveConfig
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.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-ZHJV247H.js

@@ -0,0 +1,31 @@
+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
+} from "./chunk-7AAH6C4L.js";
+
+// src/first-survey.ts
+var surveySuggestionsEnabled = false;
+function beginFirstSurveyPreparation(_root, _mode, _prepare) {
+  return void 0;
+}
+async function offerFirstSurvey(client, root, workspace, site, ui, mode) {
+  if (!surveySuggestionsEnabled || mode.development || !mode.interactive || mode.preview) return { state: "skipped" };
+  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/cli-access.js

@@ -1,9 +1,9 @@
 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 {
   offerCliAccess
-} from "./chunk-HACTNBV3.js";
-import "./chunk-SJVLAYGG.js";
-import "./chunk-GGARVSPT.js";
+} from "./chunk-XPFKXLIZ.js";
+import "./chunk-EVNEX5N5.js";
+import "./chunk-7AAH6C4L.js";
 import "./chunk-WL3NOIM6.js";
 export {
   offerCliAccess

package/dist/connection.js

@@ -4,10 +4,10 @@ import {
   compatibilityCredentials,
   connectInstallation,
   memoryCredentials
-} from "./chunk-3RDJORRS.js";
+} from "./chunk-DMXUXEQI.js";
 import {
   CredentialStoreError
-} from "./chunk-GGARVSPT.js";
+} from "./chunk-7AAH6C4L.js";
 import "./chunk-WL3NOIM6.js";
 export {
   BrowserConnectionUnavailable,

package/dist/first-survey.js

@@ -0,0 +1,11 @@
+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 {
+  beginFirstSurveyPreparation,
+  offerFirstSurvey
+} from "./chunk-ZHJV247H.js";
+import "./chunk-7AAH6C4L.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  beginFirstSurveyPreparation,
+  offerFirstSurvey
+};

package/dist/footer.js

@@ -0,0 +1,17 @@
+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 {
+  FOOTER_LINK,
+  applyFooter,
+  planFooter
+} from "./chunk-4INLEQE2.js";
+import "./chunk-LEJFE4U5.js";
+import "./chunk-TOID3NYP.js";
+import "./chunk-PJQOSDYS.js";
+import "./chunk-NMHTFC5Q.js";
+import "./chunk-7AAH6C4L.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  FOOTER_LINK,
+  applyFooter,
+  planFooter
+};

package/dist/global-cli.js

@@ -2,11 +2,12 @@ import { createRequire as createWizardRequire } from 'node:module'; import { fil
 import {
   globalCliInstallCommand,
   offerGlobalCli
-} from "./chunk-JD5U4U26.js";
-import "./chunk-SJVLAYGG.js";
-import "./chunk-YMSGDC4B.js";
-import "./chunk-OEGNGGZ2.js";
-import "./chunk-GGARVSPT.js";
+} from "./chunk-TRBSH5G7.js";
+import "./chunk-TOID3NYP.js";
+import "./chunk-PJQOSDYS.js";
+import "./chunk-NMHTFC5Q.js";
+import "./chunk-EVNEX5N5.js";
+import "./chunk-7AAH6C4L.js";
 import "./chunk-WL3NOIM6.js";
 export {
   globalCliInstallCommand,

package/dist/install-diagnostics.js

@@ -0,0 +1,9 @@
+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 {
+  installFailureDetails
+} from "./chunk-PJQOSDYS.js";
+import "./chunk-7AAH6C4L.js";
+import "./chunk-WL3NOIM6.js";
+export {
+  installFailureDetails
+};