vybekiit 0.7.0 → 0.7.2

package/dist/bin.js

@@ -5236,7 +5236,7 @@ var init_esm = __esm({
 });
 
 // src/bin.ts
-import process29 from "process";
+import process32 from "process";
 
 // ../packages/core/src/accessGate.ts
 import { Data, Effect, Either } from "effect";
@@ -5688,9 +5688,9 @@ var walkPreferenceLadder = (walk) => Effect2.gen(function* () {
 });
 
 // src/cliRunner.ts
-import { readFile as readFile23 } from "fs/promises";
-import { dirname as dirname17, join as join52 } from "path";
-import process28 from "process";
+import { readFile as readFile26 } from "fs/promises";
+import { dirname as dirname18, join as join55 } from "path";
+import process31 from "process";
 import { fileURLToPath as fileURLToPath9 } from "url";
 
 // src/commands/createSurfaceRegistry.ts
@@ -5756,6 +5756,7 @@ ${createSurfaceUsage}
 After your app exists (your AI coding tool drives these):
   vybekiit list-pieces \xB7 list-page-recipes \xB7 list-presets
   vybekiit add page-recipe <id> [--to=dir] [--dry-run] [--force]
+  vybekiit add report-mode [--to=dir] [--dry-run] [--force]
   vybekiit apply-preset <id> [--cwd=dir] \xB7 verify-presets
   vybekiit scaffold backend \xB7 backend add-route|add-crud|add-upload|gen-contract
   vybekiit env wizard \xB7 sync-agent-layer \xB7 update path via your agent
@@ -5805,6 +5806,7 @@ Agent / kit:
   vybekiit list-page-recipes
   vybekiit list-presets
   vybekiit add page-recipe <id> [--to=dir] [--dry-run] [--force]
+  vybekiit add report-mode [--to=dir] [--dry-run] [--force]   (point & fix overlay into an existing app)
   vybekiit add                              (interactive: pick a ready piece)
   vybekiit apply-preset <feature> [--provider=supabase|neon|railway|mongodb|firebase|aws] [--cwd=dir] [--dry-run]
   vybekiit verify-presets [--fix] [--cwd=dir] [preset...]
@@ -5813,6 +5815,7 @@ Agent / kit:
   vybekiit live-work payments [--mode=demo|dogfood|buyer] [--vendor=lemon-squeezy|stripe|paypal] [--cwd=dir] [--no-pin] [--fresh]
   vybekiit lint-extension-skill <path> [--kind=buyer-goal|platform-wrapper|agent-skills-global]
   vybekiit doc-fallback <tech-id>
+  vybekiit feedback status | feedback submit <draft> [--confirm]
   vybekiit dedup [--intent <desc>] [--target <file>] [--scope <dir>] [--index] [--json]
   vybekiit add bridge
   vybekiit env wizard
@@ -6288,6 +6291,23 @@ var GOAL_ENTRIES = [
     phrases: ["send emails", "email my users", "set up email"],
     skills: { web: "setup-email", mobile: null, extension: null, spa: null, backend: "wire-email" }
   },
+  {
+    id: "feedback",
+    pageRecipeRequired: false,
+    phrases: [
+      "send feedback",
+      "report a kit bug",
+      "suggest a kit improvement",
+      "the kit is confusing"
+    ],
+    skills: {
+      web: "feedback",
+      mobile: "feedback",
+      extension: "feedback",
+      spa: "feedback",
+      backend: "feedback"
+    }
+  },
   {
     id: "doctor",
     phrases: ["it's broken", "nothing works", "get an error", "check my app"],
@@ -7208,6 +7228,88 @@ var renderToneSection = () => {
   return lines.join("\n");
 };
 
+// ../packages/agentKit/src/feedback/feedback.ts
+import { createHash } from "crypto";
+import { Schema as Schema2 } from "effect";
+var boundedText = (maximumLength) => Schema2.String.pipe(Schema2.minLength(1), Schema2.maxLength(maximumLength));
+var FeedbackDiagnosticsSchema = Schema2.Struct({
+  agent: boundedText(100),
+  agentVersion: boundedText(100),
+  kitVersion: boundedText(100),
+  operatingSystem: boundedText(200)
+});
+var FeedbackDraftSchema = Schema2.Struct({
+  kind: Schema2.Literal("bug", "idea", "confusing"),
+  buyerMessage: boundedText(4e3),
+  agentSummary: boundedText(2e3),
+  reproductionSteps: Schema2.Array(boundedText(500)).pipe(Schema2.maxItems(10)),
+  template: Schema2.Literal("web", "mobile", "extension", "backend", "spa", "unknown"),
+  trigger: Schema2.Literal("explicit", "automatic-suggestion"),
+  diagnostics: FeedbackDiagnosticsSchema
+});
+var decodeFeedbackDraft = Schema2.decodeUnknownSync(FeedbackDraftSchema, {
+  onExcessProperty: "error"
+});
+var REDACTION_PATTERNS = [
+  // ghp_abc123... -> [removed]
+  [/\b(?:gh[oprsu]_[A-Za-z0-9_]{20,}|github_pat_[A-Za-z0-9_]{20,})\b/gu, "[removed]"],
+  // sk-proj-abc123... -> [removed]
+  [/\bsk-[A-Za-z0-9_-]{20,}\b/gu, "[removed]"],
+  // AKIAIOSFODNN7EXAMPLE -> [removed]
+  [/\b(?:AKIA|ASIA)[A-Z0-9]{16}\b/gu, "[removed]"],
+  // eyJ...payload.signature -> [removed]
+  [/\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/gu, "[removed]"],
+  // Authorization: Bearer abc -> Authorization: [removed]
+  [/\bAuthorization\s*:\s*(?:Bearer|Basic)\s+[^\s,;]+/giu, "Authorization: [removed]"],
+  // API_KEY=abc -> API_KEY=[removed]
+  [
+    /\b[A-Z0-9_-]*(?:API[_-]?KEY|TOKEN|SECRET|PASSWORD|PRIVATE[_-]?KEY)\s*[:=]\s*[^\s,;]+/giu,
+    "[removed]"
+  ],
+  // postgres://buyer:secret@host/db -> [removed]
+  [/\b(?:postgres(?:ql)?|mysql|mongodb(?:\+srv)?|redis):\/\/[^\s,;]+/giu, "[removed]"],
+  // buyer@example.com -> [removed]
+  [/\b[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,}\b/giu, "[removed]"],
+  // C:\Users\buyer\project -> [removed]
+  [/[A-Z]:\\(?:[^\\\s]+\\)*[^\\\s,;]+/giu, "[removed]"],
+  // /Users/buyer/project -> [removed]
+  [/(?:\/Users|\/home|\/root|\/private|\/tmp|\/var|\/opt)\/(?:[^/\s]+\/)*[^/\s,;]+/gu, "[removed]"],
+  // buyer-mac.local -> [removed]
+  [/\b[A-Z0-9][A-Z0-9-]*\.local\b/giu, "[removed]"]
+];
+var redactText = (text2) => {
+  let safeText = text2;
+  for (const [pattern, replacement] of REDACTION_PATTERNS) {
+    safeText = safeText.replace(pattern, replacement);
+  }
+  return safeText.replaceAll(/\s+/gu, " ").trim();
+};
+var redactFeedbackDraft = (draft) => ({
+  ...draft,
+  buyerMessage: redactText(draft.buyerMessage),
+  agentSummary: redactText(draft.agentSummary),
+  reproductionSteps: draft.reproductionSteps.map(redactText),
+  diagnostics: {
+    agent: redactText(draft.diagnostics.agent),
+    agentVersion: redactText(draft.diagnostics.agentVersion),
+    kitVersion: redactText(draft.diagnostics.kitVersion),
+    operatingSystem: redactText(draft.diagnostics.operatingSystem)
+  }
+});
+var fingerprintFeedbackDraft = (draft) => {
+  const safeDraft = redactFeedbackDraft(draft);
+  const canonicalDraft = JSON.stringify({
+    kind: safeDraft.kind,
+    buyerMessage: safeDraft.buyerMessage,
+    agentSummary: safeDraft.agentSummary,
+    reproductionSteps: safeDraft.reproductionSteps,
+    template: safeDraft.template,
+    trigger: safeDraft.trigger,
+    diagnostics: safeDraft.diagnostics
+  });
+  return createHash("sha256").update(canonicalDraft).digest("hex");
+};
+
 // ../packages/agentKit/src/lint/lintExtensionSkill.ts
 var BUYER_GOAL_REQUIRED = [
   { rule: "goal", pattern: /\*\*Goal:\*\*/ },
@@ -7452,7 +7554,7 @@ var renderBuyerSkillStub = (skillStem, buyerContent, template) => {
   return [
     "---",
     `name: ${skillStem}`,
-    `description: ${description}`,
+    `description: ${JSON.stringify(description)}`,
     "metadata:",
     "  vybekiit-generated: buyer-skill-stub",
     "---",
@@ -10549,13 +10651,13 @@ var parseCreateAppArgs = (argumentsToParse) => {
   return { ok: true, inputs: { surface: selectedSurface, destPath: destinationPath } };
 };
 var promptCreateSurface = async () => {
-  const { cancel: cancel4, intro: intro2, isCancel: isCancel5, outro, select: select3 } = await import("@clack/prompts");
+  const { cancel: cancel4, intro: intro2, isCancel: isCancel6, outro, select: select3 } = await import("@clack/prompts");
   intro2("VybeKiit \u2014 create an app");
   const picked = await select3({
     message: "What are you building?",
     options: CREATE_SURFACE_PROMPT_OPTIONS
   });
-  if (isCancel5(picked) || typeof picked !== "string" || !isCreateSurface(picked)) {
+  if (isCancel6(picked) || typeof picked !== "string" || !isCreateSurface(picked)) {
     cancel4("Cancelled.");
     return null;
   }
@@ -10925,13 +11027,13 @@ var writeTemplateRequired = (flags) => {
   return 1;
 };
 var promptForDropInputs = async (parsed) => {
-  const { confirm: confirm2, intro: intro2, isCancel: isCancel5, select: select3, text: text2, cancel: cancel4 } = await import("@clack/prompts");
+  const { confirm: confirm3, intro: intro2, isCancel: isCancel6, select: select3, text: text2, cancel: cancel4 } = await import("@clack/prompts");
   intro2("VybeKiit: drop a template");
   const picked = await select3({
     message: "Which template?",
     options: DROP_TEMPLATE_OPTIONS
   });
-  if (isCancel5(picked) || typeof picked !== "string" || !isTemplateName(picked)) {
+  if (isCancel6(picked) || typeof picked !== "string" || !isTemplateName(picked)) {
     cancel4("Cancelled.");
     return null;
   }
@@ -10944,17 +11046,17 @@ var promptForDropInputs = async (parsed) => {
       defaultValue: `./${picked}`,
       validate: (value) => typeof value === "string" && value.trim() !== "" ? void 0 : "Path is required"
     });
-    if (isCancel5(dest) || typeof dest !== "string") {
+    if (isCancel6(dest) || typeof dest !== "string") {
       cancel4("Cancelled.");
       return null;
     }
     destPath = dest;
   }
   const mode = dropMode(parsed.flags);
-  const confirmed = await confirm2({
+  const confirmed = await confirm3({
     message: `Drop "${picked}" -> ${resolve5(destPath)}${mode === "new" ? "" : ` (${mode})`}?`
   });
-  if (isCancel5(confirmed) || !confirmed) {
+  if (isCancel6(confirmed) || !confirmed) {
     cancel4("Cancelled.");
     return null;
   }
@@ -11149,19 +11251,255 @@ var runDrop = async (args) => {
   }
 };
 
+// src/commands/feedbackCmd.ts
+import process7 from "process";
+import { confirm, isCancel } from "@clack/prompts";
+import open from "open";
+
+// src/feedback/feedbackClient.ts
+import { Schema as Schema3 } from "effect";
+var DeviceLoginSchema = Schema3.Struct({
+  deviceCode: Schema3.String,
+  userCode: Schema3.String,
+  verificationUri: Schema3.String,
+  expiresIn: Schema3.Number,
+  interval: Schema3.Number
+});
+var IntakeSessionStateSchema = Schema3.Union(
+  Schema3.Struct({
+    status: Schema3.Literal("pending"),
+    retryAfter: Schema3.optional(Schema3.Number)
+  }),
+  Schema3.Struct({ status: Schema3.Literal("ready"), session: Schema3.String }),
+  Schema3.Struct({ status: Schema3.Literal("denied"), message: Schema3.String })
+);
+var FeedbackReceiptSchema = Schema3.Struct({ reference: Schema3.String });
+var resolveBaseUrl = (configuredUrl) => {
+  const baseUrl = configuredUrl || process.env.VYBEKIIT_API_URL || "https://vybekiit.com/api";
+  const parsedUrl = new URL(baseUrl);
+  const localDevelopment = parsedUrl.hostname === "localhost" || parsedUrl.hostname === "127.0.0.1";
+  if (parsedUrl.protocol !== "https:" && !localDevelopment) {
+    throw new Error("Feedback intake requires HTTPS.");
+  }
+  return baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
+};
+var readJson = async (response, schema) => {
+  if (!response.ok) {
+    throw new Error(`Feedback intake returned ${response.status}.`);
+  }
+  return Schema3.decodeUnknownSync(schema)(await response.json());
+};
+var createFeedbackIntakeClient = (options = {}) => {
+  const baseUrl = resolveBaseUrl(options.baseUrl);
+  const fetchRequest = options.fetch || globalThis.fetch;
+  return {
+    createDeviceLogin: async () => {
+      const response = await fetchRequest(`${baseUrl}/feedback/auth/device`, { method: "POST" });
+      return await readJson(response, DeviceLoginSchema);
+    },
+    pollDeviceLogin: async (deviceCode) => {
+      const response = await fetchRequest(`${baseUrl}/feedback/auth/poll`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ deviceCode })
+      });
+      return await readJson(response, IntakeSessionStateSchema);
+    },
+    submit: async ({ session, draft }) => {
+      const response = await fetchRequest(`${baseUrl}/feedback/report`, {
+        method: "POST",
+        headers: {
+          authorization: `Bearer ${session}`,
+          "content-type": "application/json"
+        },
+        body: JSON.stringify(redactFeedbackDraft(draft))
+      });
+      return await readJson(response, FeedbackReceiptSchema);
+    }
+  };
+};
+
+// src/feedback/feedbackFiles.ts
+import { chmod, lstat as lstat2, mkdir as mkdir6, readFile as readFile7, realpath, rename, writeFile as writeFile6 } from "fs/promises";
+import { isAbsolute, join as join14, relative } from "path";
+var FeedbackFileError = class extends Error {
+  code;
+  constructor(code, message, cause) {
+    super(message, { cause });
+    this.name = "FeedbackFileError";
+    this.code = code;
+  }
+};
+var isBeneath = (candidatePath, parentPath) => {
+  const pathFromParent = relative(parentPath, candidatePath);
+  return pathFromParent !== "" && !pathFromParent.startsWith("..") && !isAbsolute(pathFromParent);
+};
+var readFeedbackDraft = async (draftPath, projectRoot) => {
+  const draftsDirectory = await realpath(join14(projectRoot, ".vybekiit", "feedback-drafts"));
+  const draftEntry = await lstat2(draftPath).catch(() => void 0);
+  if (!draftEntry?.isFile() || draftEntry.isSymbolicLink()) {
+    throw new FeedbackFileError(
+      "invalid_draft_path",
+      "Choose a feedback draft created in this app."
+    );
+  }
+  const resolvedDraftPath = await realpath(draftPath);
+  if (!isBeneath(resolvedDraftPath, draftsDirectory)) {
+    throw new FeedbackFileError(
+      "invalid_draft_path",
+      "Choose a feedback draft created in this app."
+    );
+  }
+  if (draftEntry.size > 32 * 1024) {
+    throw new FeedbackFileError(
+      "draft_too_large",
+      "This feedback draft is too large to send safely."
+    );
+  }
+  try {
+    return decodeFeedbackDraft(JSON.parse(await readFile7(resolvedDraftPath, "utf8")));
+  } catch (error) {
+    if (error instanceof FeedbackFileError) {
+      throw error;
+    }
+    throw new FeedbackFileError(
+      "invalid_draft",
+      "This feedback draft could not be read safely.",
+      error
+    );
+  }
+};
+var recordFeedbackSubmission = async (projectRoot, submission) => {
+  const feedbackDirectory = join14(projectRoot, ".vybekiit");
+  const submissionsPath = join14(feedbackDirectory, "feedback-submissions.json");
+  const temporaryPath = `${submissionsPath}.${process.pid}.tmp`;
+  await mkdir6(feedbackDirectory, { recursive: true, mode: 448 });
+  let submissions = [];
+  try {
+    const storedSubmissions = JSON.parse(await readFile7(submissionsPath, "utf8"));
+    if (Array.isArray(storedSubmissions)) {
+      submissions = storedSubmissions.filter(
+        (entry) => typeof entry === "object" && entry !== null && "fingerprint" in entry && typeof entry.fingerprint === "string" && "reference" in entry && typeof entry.reference === "string" && "submittedAt" in entry && typeof entry.submittedAt === "string"
+      );
+    }
+  } catch {
+    submissions = [];
+  }
+  await writeFile6(temporaryPath, `${JSON.stringify([...submissions, submission], null, 2)}
+`, {
+    mode: 384
+  });
+  await rename(temporaryPath, submissionsPath);
+  await chmod(submissionsPath, 384);
+};
+
+// src/commands/feedbackCmd.ts
+var defaultDependencies = () => ({
+  projectRoot: process7.cwd(),
+  interactive: isInteractive(),
+  confirm: async () => {
+    const answer = await confirm({ message: "Send this private feedback report to VybeKiit?" });
+    return !isCancel(answer) && answer;
+  },
+  openBrowser: open,
+  sleep: async (milliseconds) => await new Promise((resolve13) => setTimeout(resolve13, milliseconds)),
+  writeOutput: (message) => process7.stdout.write(`${message}
+`),
+  writeError: (message) => process7.stderr.write(`${message}
+`),
+  now: () => /* @__PURE__ */ new Date(),
+  client: createFeedbackIntakeClient()
+});
+var waitForSession = async (deviceCode, interval, expiresIn, dependencies) => {
+  const expiresAt = dependencies.now().getTime() + expiresIn * 1e3;
+  let pollingInterval = interval;
+  while (dependencies.now().getTime() < expiresAt) {
+    const sessionState = await dependencies.client.pollDeviceLogin(deviceCode);
+    if (sessionState.status !== "pending") {
+      return sessionState;
+    }
+    if (sessionState.retryAfter) {
+      pollingInterval += sessionState.retryAfter;
+    }
+    await dependencies.sleep(pollingInterval * 1e3);
+  }
+  return { status: "denied", message: "The sign-in code expired. Run /feedback again." };
+};
+var showFeedbackStatus = (dependencies) => {
+  dependencies.writeOutput(
+    JSON.stringify({ ok: true, drafts: ".vybekiit/feedback-drafts", confirmationRequired: true })
+  );
+  return 0;
+};
+var showFeedbackUsage = (dependencies) => {
+  dependencies.writeError("Usage: vybekiit feedback status | feedback submit <draft> [--confirm]");
+  return 1;
+};
+var runFeedback = async (args, suppliedDependencies) => {
+  const dependencies = suppliedDependencies || defaultDependencies();
+  const [action, draftPath] = args;
+  if (action === "status") {
+    return showFeedbackStatus(dependencies);
+  }
+  if (action !== "submit" || !draftPath) {
+    return showFeedbackUsage(dependencies);
+  }
+  const confirmed = dependencies.interactive ? await dependencies.confirm() : args.includes("--confirm");
+  if (!confirmed) {
+    if (!dependencies.interactive) {
+      dependencies.writeError(
+        "Add --confirm only after the buyer has approved sending the report."
+      );
+      return 1;
+    }
+    dependencies.writeOutput("Feedback was not sent. Your draft is still saved.");
+    return 0;
+  }
+  try {
+    const draft = await readFeedbackDraft(draftPath, dependencies.projectRoot);
+    const deviceLogin = await dependencies.client.createDeviceLogin();
+    dependencies.writeOutput(
+      `Sign in to send feedback: ${deviceLogin.verificationUri} code ${deviceLogin.userCode}`
+    );
+    await dependencies.openBrowser(deviceLogin.verificationUri);
+    const sessionState = await waitForSession(
+      deviceLogin.deviceCode,
+      deviceLogin.interval,
+      deviceLogin.expiresIn,
+      dependencies
+    );
+    if (sessionState.status !== "ready") {
+      dependencies.writeError(sessionState.message);
+      return 1;
+    }
+    const receipt = await dependencies.client.submit({ session: sessionState.session, draft });
+    await recordFeedbackSubmission(dependencies.projectRoot, {
+      fingerprint: fingerprintFeedbackDraft(draft),
+      reference: receipt.reference,
+      submittedAt: dependencies.now().toISOString()
+    });
+    dependencies.writeOutput(JSON.stringify({ ok: true, reference: receipt.reference }));
+    return 0;
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : "The feedback service is unavailable.";
+    dependencies.writeError(`Feedback was not sent. Your draft is still saved. ${detail}`);
+    return 1;
+  }
+};
+
 // src/commands/init.ts
-import { join as join18 } from "path";
+import { join as join19 } from "path";
 
 // src/commands/initAssets.ts
 import { execFile as execFile5 } from "child_process";
-import { cp as cp4, mkdir as mkdir6, readdir as readdir7, readFile as readFile8, writeFile as writeFile6 } from "fs/promises";
-import { dirname as dirname8, join as join15 } from "path";
+import { cp as cp4, mkdir as mkdir7, readdir as readdir7, readFile as readFile9, writeFile as writeFile7 } from "fs/promises";
+import { dirname as dirname8, join as join16 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 import { promisify as promisify5 } from "util";
 
 // src/commands/initTypes.ts
-import { access as access8, readFile as readFile7 } from "fs/promises";
-import { join as join14 } from "path";
+import { access as access8, readFile as readFile8 } from "fs/promises";
+import { join as join15 } from "path";
 var pathExists4 = async (path) => {
   try {
     await access8(path);
@@ -11172,7 +11510,7 @@ var pathExists4 = async (path) => {
 };
 var readInitPackageJson = async (cwd) => {
   try {
-    const raw = await readFile7(join14(cwd, "package.json"), "utf8");
+    const raw = await readFile8(join15(cwd, "package.json"), "utf8");
     return JSON.parse(raw);
   } catch {
     return null;
@@ -11183,22 +11521,22 @@ var readInitPackageJson = async (cwd) => {
 var execFileAsync5 = promisify5(execFile5);
 var HERE5 = dirname8(fileURLToPath5(import.meta.url));
 var copyClaudeHooks = async (cwd, templateDir) => {
-  const claudeSource = join15(templateDir, ".claude");
+  const claudeSource = join16(templateDir, ".claude");
   if (!await pathExists4(claudeSource)) {
     process.stdout.write("  \u26A0\uFE0F  Could not copy .claude hooks (source missing)\n");
     return;
   }
-  await cp4(claudeSource, join15(cwd, ".claude"), { recursive: true, force: true });
+  await cp4(claudeSource, join16(cwd, ".claude"), { recursive: true, force: true });
   process.stdout.write("  \u2705 .claude/settings.json + hooks\n");
 };
 var copyWorkflows = async (cwd, templateDir, pm) => {
-  const workflowsDir = join15(cwd, ".github", "workflows");
-  const workflowsSource = join15(templateDir, ".github", "workflows");
+  const workflowsDir = join16(cwd, ".github", "workflows");
+  const workflowsSource = join16(templateDir, ".github", "workflows");
   if (!await pathExists4(workflowsSource)) {
     process.stdout.write("  \u26A0\uFE0F  Could not copy workflows (source missing)\n");
     return;
   }
-  await mkdir6(workflowsDir, { recursive: true });
+  await mkdir7(workflowsDir, { recursive: true });
   await cp4(workflowsSource, workflowsDir, { recursive: true, force: true });
   if (pm !== "pnpm") {
     await adaptWorkflows(workflowsDir, pm);
@@ -11206,23 +11544,23 @@ var copyWorkflows = async (cwd, templateDir, pm) => {
   process.stdout.write("  \u2705 .github/workflows/ (CI pipeline)\n");
 };
 var copyPrePushHook = async (cwd, templateDir) => {
-  const huskySource = join15(templateDir, ".husky", "pre-push");
+  const huskySource = join16(templateDir, ".husky", "pre-push");
   if (!await pathExists4(huskySource)) {
     process.stdout.write("  \u26A0\uFE0F  Could not copy pre-push hook\n");
     return;
   }
-  const huskyDir = join15(cwd, ".husky");
-  await mkdir6(huskyDir, { recursive: true });
-  await cp4(huskySource, join15(huskyDir, "pre-push"), { force: true });
+  const huskyDir = join16(cwd, ".husky");
+  await mkdir7(huskyDir, { recursive: true });
+  await cp4(huskySource, join16(huskyDir, "pre-push"), { force: true });
   process.stdout.write("  \u2705 .husky/pre-push\n");
 };
 var copySecurityFile = async (cwd, templateDir) => {
-  const dest = join15(cwd, "SECURITY.md");
+  const dest = join16(cwd, "SECURITY.md");
   if (await pathExists4(dest)) {
     process.stdout.write("  \u2713  SECURITY.md (already exists)\n");
     return;
   }
-  const source = join15(templateDir, "SECURITY.md");
+  const source = join16(templateDir, "SECURITY.md");
   if (!await pathExists4(source)) {
     process.stdout.write("  \u26A0\uFE0F  Could not copy SECURITY.md\n");
     return;
@@ -11231,14 +11569,14 @@ var copySecurityFile = async (cwd, templateDir) => {
   process.stdout.write("  \u2705 SECURITY.md\n");
 };
 var createDevScriptsDir = async (cwd) => {
-  const devScriptsDir = join15(cwd, "dev-scripts");
-  const gitkeepPath = join15(devScriptsDir, ".gitkeep");
-  await mkdir6(devScriptsDir, { recursive: true });
+  const devScriptsDir = join16(cwd, "dev-scripts");
+  const gitkeepPath = join16(devScriptsDir, ".gitkeep");
+  await mkdir7(devScriptsDir, { recursive: true });
   if (await pathExists4(gitkeepPath)) {
     process.stdout.write("  \u2713  dev-scripts/ (already exists)\n");
     return;
   }
-  await writeFile6(
+  await writeFile7(
     gitkeepPath,
     "# Local-only dev scripts - gitignored, never committed to the repo.\n",
     { flag: "wx" }
@@ -11247,8 +11585,8 @@ var createDevScriptsDir = async (cwd) => {
 };
 var generatePlatformConfigs = async (cwd) => {
   const possiblePaths = [
-    join15(cwd, ".claude", "platforms", "generate-platform-configs.sh"),
-    join15(
+    join16(cwd, ".claude", "platforms", "generate-platform-configs.sh"),
+    join16(
       HERE5,
       "..",
       "..",
@@ -11276,12 +11614,12 @@ var generatePlatformConfigs = async (cwd) => {
       return;
     }
   }
-  const agentsPath = join15(cwd, "AGENTS.md");
+  const agentsPath = join16(cwd, "AGENTS.md");
   if (await pathExists4(agentsPath)) {
     process.stdout.write("  \u2713  AGENTS.md (already exists)\n");
     return;
   }
-  await writeFile6(
+  await writeFile7(
     agentsPath,
     "# Agent Instructions\n\nThis project uses VybeKiit conventions.\n\nSee .claude/hooks/ for enforced rules.\n"
   );
@@ -11314,19 +11652,19 @@ var adaptWorkflows = async (dir, pm) => {
   const workflowFiles = files.filter((file) => file.endsWith(".yml"));
   await Promise.all(
     workflowFiles.map(async (file) => {
-      const path = join15(dir, file);
-      let content = await readFile8(path, "utf8");
+      const path = join16(dir, file);
+      let content = await readFile9(path, "utf8");
       for (const [from, to] of Object.entries(replacements[pm])) {
         content = content.replaceAll(from, to);
       }
-      await writeFile6(path, content);
+      await writeFile7(path, content);
     })
   );
 };
 
 // src/commands/initDetect.ts
 import { existsSync as existsSync4 } from "fs";
-import { join as join16 } from "path";
+import { join as join17 } from "path";
 var packageManagerFromManifest = (value) => {
   if (value === void 0 || value === "") {
     return null;
@@ -11353,7 +11691,7 @@ var detectPackageManager = async (cwd) => {
     ["package-lock.json", "npm"]
   ];
   const lockfileMatches = checks.map(([file, pm]) => ({
-    found: existsSync4(join16(cwd, file)),
+    found: existsSync4(join17(cwd, file)),
     pm
   }));
   const match = lockfileMatches.find((entry) => entry.found);
@@ -11420,15 +11758,15 @@ var writeInitSuccess = (pm) => {
 };
 
 // src/commands/initPatches.ts
-import { readFile as readFile9, writeFile as writeFile7 } from "fs/promises";
-import { join as join17 } from "path";
+import { readFile as readFile10, writeFile as writeFile8 } from "fs/promises";
+import { join as join18 } from "path";
 var patchGitignore = async (cwd) => {
-  const gitignorePath = join17(cwd, ".gitignore");
-  const content = await pathExists4(gitignorePath) ? await readFile9(gitignorePath, "utf8") : "";
+  const gitignorePath = join18(cwd, ".gitignore");
+  const content = await pathExists4(gitignorePath) ? await readFile10(gitignorePath, "utf8") : "";
   const needed = ["dev-scripts/", ".env", ".env.*", "!.env.example"];
   const additions = needed.filter((pattern) => !content.includes(pattern));
   if (additions.length > 0) {
-    await writeFile7(gitignorePath, `${content}
+    await writeFile8(gitignorePath, `${content}
 # VybeKiit guardrails
 ${additions.join("\n")}
 `);
@@ -11438,7 +11776,7 @@ ${additions.join("\n")}
   process.stdout.write("  \u2713  .gitignore (already has required entries)\n");
 };
 var patchPackageScripts = async (cwd, pm) => {
-  const pkgPath = join17(cwd, "package.json");
+  const pkgPath = join18(cwd, "package.json");
   const pkg = await readInitPackageJson(cwd);
   if (pkg === null) {
     process.stdout.write("  \u26A0\uFE0F  package.json scripts skipped (package.json missing)\n");
@@ -11452,7 +11790,7 @@ var patchPackageScripts = async (cwd, pm) => {
     ...scripts.verify === void 0 ? { verify: `${pm} run check:ci && ${pm} run typecheck && ${pm} run test` } : {}
   };
   if (Object.keys(patchedScripts).length !== Object.keys(scripts).length) {
-    await writeFile7(pkgPath, `${JSON.stringify({ ...pkg, scripts: patchedScripts }, null, 2)}
+    await writeFile8(pkgPath, `${JSON.stringify({ ...pkg, scripts: patchedScripts }, null, 2)}
 `);
     process.stdout.write("  \u2705 package.json scripts patched (check:ci, typecheck, verify)\n");
     return;
@@ -11463,7 +11801,7 @@ var patchPackageScripts = async (cwd, pm) => {
 // src/commands/init.ts
 var runInit = async (args) => {
   const [targetPath] = args;
-  const cwd = targetPath !== void 0 && targetPath !== "" ? join18(process.cwd(), targetPath) : process.cwd();
+  const cwd = targetPath !== void 0 && targetPath !== "" ? join19(process.cwd(), targetPath) : process.cwd();
   process.stdout.write("\u{1F512} VybeKiit init: bootstrapping security guardrails...\n");
   process.stdout.write("\n");
   const pm = await detectPackageManager(cwd);
@@ -11482,7 +11820,7 @@ var runInit = async (args) => {
   try {
     const { cleanup: resolvedCleanup, source } = await resolveTemplatesSource(projectType);
     cleanup = resolvedCleanup;
-    const templateDir = join18(source, projectType);
+    const templateDir = join19(source, projectType);
     await copyClaudeHooks(cwd, templateDir);
     await copyWorkflows(cwd, templateDir, pm);
     await copyPrePushHook(cwd, templateDir);
@@ -11504,7 +11842,7 @@ var runInit = async (args) => {
 };
 
 // src/commands/lintExtensionSkill.ts
-import { readFile as readFile10 } from "fs/promises";
+import { readFile as readFile11 } from "fs/promises";
 var resolveExtensionSkillKind = (path, explicit) => {
   if (explicit === "buyer-goal" || explicit === "platform-wrapper" || explicit === "agent-skills-global") {
     return explicit;
@@ -11549,7 +11887,7 @@ var runLintExtensionSkill = async (args) => {
   }
   let content;
   try {
-    content = await readFile10(path, "utf8");
+    content = await readFile11(path, "utf8");
   } catch {
     return {
       json: JSON.stringify({ ok: false, error: `Cannot read file: ${path}` }),
@@ -11565,7 +11903,7 @@ var runLintExtensionSkill = async (args) => {
 
 // src/commands/liveWorkDataCmd.ts
 import { resolve as resolve7 } from "path";
-import process7 from "process";
+import process8 from "process";
 
 // ../packages/db/src/types.ts
 import { Data as Data3 } from "effect";
@@ -14548,9 +14886,9 @@ import { Effect as Effect12, Either as Either2 } from "effect";
 
 // ../packages/core/src/node.ts
 import { existsSync as existsSync5, readFileSync as readFileSync3 } from "fs";
-import { join as join19 } from "path";
+import { join as join20 } from "path";
 var loadEnvFile = (cwd, filename = ".env") => {
-  const path = join19(cwd, filename);
+  const path = join20(cwd, filename);
   if (!existsSync5(path)) {
     return {};
   }
@@ -14575,7 +14913,7 @@ var mergeEnvFile = (processEnv, fileEnv) => ({ ...processEnv, ...fileEnv });
 
 // src/doctor/writeEnvKeys.ts
 import { existsSync as existsSync6, readFileSync as readFileSync4, writeFileSync as writeFileSync2 } from "fs";
-import { join as join20 } from "path";
+import { join as join21 } from "path";
 var TRAILING_NEWLINES_PATTERN = /\n*$/;
 var renderEnvValue = (value) => {
   if (value.includes(" ")) {
@@ -14592,7 +14930,7 @@ var replaceEnvLine = (lines, key, newLine) => {
   return true;
 };
 var writeEnvKeys = (cwd, keys) => {
-  const path = join20(cwd, ".env");
+  const path = join21(cwd, ".env");
   const existing = existsSync6(path) ? readFileSync4(path, "utf8") : "";
   const lines = existing.length > 0 ? existing.split("\n") : [];
   for (const [key, value] of Object.entries(keys)) {
@@ -14623,7 +14961,7 @@ var parseLiveWorkDataFlags = (args) => {
   const modeRaw = readFlagValue(args, "mode") ?? "demo";
   const vendorRaw = readFlagValue(args, "vendor");
   const cwdRaw = readFlagValue(args, "cwd");
-  const cwd = resolve7(process7.cwd(), cwdRaw === void 0 || cwdRaw === "" ? "." : cwdRaw);
+  const cwd = resolve7(process8.cwd(), cwdRaw === void 0 || cwdRaw === "" ? "." : cwdRaw);
   if (!isLiveWorkMode(modeRaw)) {
     return {
       mode: "demo",
@@ -14686,7 +15024,7 @@ var toFailurePayload = (error) => {
   }
   return failure;
 };
-var resolveLiveWorkEnv = (cwd) => mergeEnv(process7.env, loadEnvFile2(cwd));
+var resolveLiveWorkEnv = (cwd) => mergeEnv(process8.env, loadEnvFile2(cwd));
 var writeDataPin = (cwd, keys) => Effect12.try({
   try: () => {
     writeEnvKeys2(cwd, keys);
@@ -14742,7 +15080,7 @@ var runLiveWorkData = async (args) => {
 
 // src/commands/liveWorkHostCmd.ts
 import { resolve as resolve8 } from "path";
-import process8 from "process";
+import process9 from "process";
 
 // ../packages/deploy/src/deployEffect.ts
 import { Effect as Effect13 } from "effect";
@@ -14759,7 +15097,7 @@ var failDeploy = (code, message) => Effect13.fail(deployError(code, message));
 // ../packages/deploy/src/liveWork/cloudflareProvision.ts
 import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync3 } from "fs";
 import { tmpdir as tmpdir3 } from "os";
-import { join as join21 } from "path";
+import { join as join22 } from "path";
 import { Effect as Effect14 } from "effect";
 
 // ../packages/deploy/src/liveWork/types.ts
@@ -14817,10 +15155,10 @@ var defaultLiveWorkProjectName = (prefix = "vybekiit-lw") => {
   return `${prefix}-${stamp}`.toLowerCase().replaceAll(/[^a-z0-9-]/g, "-").slice(0, 58);
 };
 var writeDemoStaticSite = (parentDir) => {
-  const buildDir = join21(parentDir, "site");
+  const buildDir = join22(parentDir, "site");
   mkdirSync2(buildDir, { recursive: true });
   writeFileSync3(
-    join21(buildDir, "index.html"),
+    join22(buildDir, "index.html"),
     `<!doctype html><html lang="en"><head><meta charset="utf-8"/><title>VybeKiit Live work</title></head><body><main data-vybekiit-live-work="1"><h1>Live work host OK</h1></main></body></html>
 `,
     "utf8"
@@ -14897,7 +15235,7 @@ var createCloudflarePagesHost = (options) => Effect14.gen(function* () {
         })
       );
     }
-    const parent = options.cwd ?? join21(tmpdir3(), defaultLiveWorkProjectName("vybekiit-lw-site"));
+    const parent = options.cwd ?? join22(tmpdir3(), defaultLiveWorkProjectName("vybekiit-lw-site"));
     mkdirSync2(parent, { recursive: true });
     buildDir = writeDemoStaticSite(parent);
   }
@@ -14998,7 +15336,7 @@ var mapCloudflareCause = (cause) => {
 // ../packages/deploy/src/liveWork/githubPagesProvision.ts
 import { mkdirSync as mkdirSync3, readFileSync as readFileSync5 } from "fs";
 import { tmpdir as tmpdir4 } from "os";
-import { join as join22 } from "path";
+import { join as join23 } from "path";
 import { Effect as Effect15 } from "effect";
 var readGithubToken = (env) => {
   for (const key of ["GITHUB_TOKEN", "GH_TOKEN"]) {
@@ -15126,7 +15464,7 @@ var createGithubPagesHost = (options) => Effect15.gen(function* () {
       );
     }
     if (options.createPages === void 0) {
-      const parent = options.cwd ?? join22(tmpdir4(), defaultLiveWorkProjectName("vybekiit-lw-gp-site"));
+      const parent = options.cwd ?? join23(tmpdir4(), defaultLiveWorkProjectName("vybekiit-lw-gp-site"));
       mkdirSync3(parent, { recursive: true });
       buildDir = writeDemoStaticSite(parent);
     }
@@ -15183,7 +15521,7 @@ var createGithubPagesHost = (options) => Effect15.gen(function* () {
       if (!createRepo.ok) {
         throw mapGithubHttp(createRepo.status, createText, "github_pages_repo_create_failed");
       }
-      const indexPath = join22(buildDir, "index.html");
+      const indexPath = join23(buildDir, "index.html");
       let indexHtml;
       try {
         indexHtml = readFileSync5(indexPath, "utf8");
@@ -15331,10 +15669,10 @@ var isHostLadderProvider = (value) => isLadderProvider(HOST_PREFERENCE_LADDER, v
 var resolveHostLadderOrder = (env, namedVendor) => resolveLadderOrder(HOST_PREFERENCE_LADDER, env.HOSTING_PROVIDER, namedVendor);
 
 // ../packages/deploy/src/liveWork/netlifyProvision.ts
-import { createHash } from "crypto";
+import { createHash as createHash2 } from "crypto";
 import { mkdirSync as mkdirSync4, readdirSync, readFileSync as readFileSync6, statSync } from "fs";
 import { tmpdir as tmpdir5 } from "os";
-import { join as join23, relative } from "path";
+import { join as join24, relative as relative2 } from "path";
 import { Effect as Effect16 } from "effect";
 var readNetlifyAuthToken = (env) => {
   const value = env.NETLIFY_AUTH_TOKEN;
@@ -15355,7 +15693,7 @@ var collectStaticFiles = (buildDir) => {
   const out = /* @__PURE__ */ new Map();
   const walk = (dir) => {
     for (const entry of readdirSync(dir)) {
-      const full = join23(dir, entry);
+      const full = join24(dir, entry);
       const st = statSync(full);
       if (st.isDirectory()) {
         walk(full);
@@ -15364,7 +15702,7 @@ var collectStaticFiles = (buildDir) => {
       if (!st.isFile()) {
         continue;
       }
-      const rel = relative(buildDir, full).split("\\").join("/");
+      const rel = relative2(buildDir, full).split("\\").join("/");
       const webPath = rel.startsWith("/") ? rel : `/${rel}`;
       out.set(webPath, readFileSync6(full));
     }
@@ -15372,7 +15710,7 @@ var collectStaticFiles = (buildDir) => {
   walk(buildDir);
   return out;
 };
-var sha1Hex = (bytes) => createHash("sha1").update(bytes).digest("hex");
+var sha1Hex = (bytes) => createHash2("sha1").update(bytes).digest("hex");
 var typedNetlifyError = (code, hopClass, message) => Object.assign(new Error(message), { hopClass, code });
 var mapNetlifyHttp = (status, body, code) => {
   const lower = body.toLowerCase();
@@ -15437,7 +15775,7 @@ var createNetlifyHost = (options) => Effect16.gen(function* () {
       );
     }
     if (options.createSite === void 0) {
-      const parent = options.cwd ?? join23(tmpdir5(), defaultLiveWorkProjectName("vybekiit-lw-nl-site"));
+      const parent = options.cwd ?? join24(tmpdir5(), defaultLiveWorkProjectName("vybekiit-lw-nl-site"));
       mkdirSync4(parent, { recursive: true });
       buildDir = writeDemoStaticSite(parent);
     }
@@ -15692,7 +16030,7 @@ var buyerHostSuccessMessage = (provider, hopped, fromProvider) => {
 // ../packages/deploy/src/liveWork/railwayHostProvision.ts
 import { mkdirSync as mkdirSync5, writeFileSync as writeFileSync4 } from "fs";
 import { tmpdir as tmpdir6 } from "os";
-import { join as join24 } from "path";
+import { join as join25 } from "path";
 import { Effect as Effect17 } from "effect";
 var defaultRailwayHostCliRunner = async (args, options = {}) => {
   const { execFile: execFile8 } = await import("child_process");
@@ -15755,11 +16093,11 @@ var createRailwayHost = (options) => Effect17.gen(function* () {
         })
       );
     }
-    workDir = workDir ?? join24(tmpdir6(), defaultLiveWorkProjectName("vybekiit-lw-r-site"));
+    workDir = workDir ?? join25(tmpdir6(), defaultLiveWorkProjectName("vybekiit-lw-r-site"));
     mkdirSync5(workDir, { recursive: true });
     buildDir = writeDemoStaticSite(workDir);
     writeFileSync4(
-      join24(workDir, "package.json"),
+      join25(workDir, "package.json"),
       JSON.stringify({
         name: projectName,
         private: true,
@@ -15861,7 +16199,7 @@ var mapRailwayHostCause = (cause) => {
 // ../packages/deploy/src/liveWork/renderProvision.ts
 import { mkdirSync as mkdirSync6 } from "fs";
 import { tmpdir as tmpdir7 } from "os";
-import { join as join25 } from "path";
+import { join as join26 } from "path";
 import { Effect as Effect18 } from "effect";
 var readRenderApiKey = (env) => {
   const value = env.RENDER_API_KEY;
@@ -15944,7 +16282,7 @@ var createRenderHost = (options) => Effect18.gen(function* () {
     );
   }
   if (options.mode !== "buyer" && (options.buildDir === void 0 || options.buildDir.length === 0)) {
-    const parent = options.cwd ?? join25(tmpdir7(), defaultLiveWorkProjectName("vybekiit-lw-rd-site"));
+    const parent = options.cwd ?? join26(tmpdir7(), defaultLiveWorkProjectName("vybekiit-lw-rd-site"));
     mkdirSync6(parent, { recursive: true });
     writeDemoStaticSite(parent);
   }
@@ -16073,7 +16411,7 @@ import { Effect as Effect20 } from "effect";
 // ../packages/deploy/src/liveWork/vercelProvision.ts
 import { mkdirSync as mkdirSync7 } from "fs";
 import { tmpdir as tmpdir8 } from "os";
-import { join as join26 } from "path";
+import { join as join27 } from "path";
 import { Effect as Effect19 } from "effect";
 var defaultVercelCliRunner = async (args, options = {}) => {
   const { execFile: execFile8 } = await import("child_process");
@@ -16134,7 +16472,7 @@ var createVercelHost = (options) => Effect19.gen(function* () {
         })
       );
     }
-    const parent = options.cwd ?? join26(tmpdir8(), defaultLiveWorkProjectName("vybekiit-lw-v-site"));
+    const parent = options.cwd ?? join27(tmpdir8(), defaultLiveWorkProjectName("vybekiit-lw-v-site"));
     mkdirSync7(parent, { recursive: true });
     buildDir = writeDemoStaticSite(parent);
   }
@@ -16521,7 +16859,7 @@ var parseLiveWorkHostFlags = (args) => {
   const cwdRaw = readFlagValue(args, "cwd");
   const buildDirRaw = readFlagValue(args, "build-dir");
   const projectNameRaw = readFlagValue(args, "project-name");
-  const cwd = resolve8(process8.cwd(), cwdRaw === void 0 || cwdRaw === "" ? "." : cwdRaw);
+  const cwd = resolve8(process9.cwd(), cwdRaw === void 0 || cwdRaw === "" ? "." : cwdRaw);
   if (!isLiveWorkMode2(modeRaw)) {
     return {
       mode: "buyer",
@@ -16584,7 +16922,7 @@ var runLiveWorkHost = async (args) => {
       exitCode: 1
     };
   }
-  const env = mergeEnv(process8.env, loadEnvFile2(flags.cwd));
+  const env = mergeEnv(process9.env, loadEnvFile2(flags.cwd));
   const either = await Effect23.runPromise(
     Effect23.either(
       runHostLiveWork({
@@ -16626,7 +16964,7 @@ var runLiveWorkHost = async (args) => {
 
 // src/commands/liveWorkPaymentsCmd.ts
 import { resolve as resolve9 } from "path";
-import process9 from "process";
+import process10 from "process";
 
 // ../packages/payments/src/liveWork/journeyEvents.ts
 var toPaymentsLiveWorkJourneyEvents = (result) => {
@@ -16837,7 +17175,7 @@ var parseLiveWorkPaymentsFlags = (args) => {
   const modeRaw = readFlagValue(args, "mode") ?? "buyer";
   const vendorRaw = readFlagValue(args, "vendor");
   const cwdRaw = readFlagValue(args, "cwd");
-  const cwd = resolve9(process9.cwd(), cwdRaw === void 0 || cwdRaw === "" ? "." : cwdRaw);
+  const cwd = resolve9(process10.cwd(), cwdRaw === void 0 || cwdRaw === "" ? "." : cwdRaw);
   if (!isLiveWorkMode3(modeRaw)) {
     return {
       mode: "buyer",
@@ -16895,7 +17233,7 @@ var runLiveWorkPayments = async (args) => {
       exitCode: 1
     };
   }
-  const env = mergeEnv(process9.env, loadEnvFile2(flags.cwd));
+  const env = mergeEnv(process10.env, loadEnvFile2(flags.cwd));
   const either = await Effect26.runPromise(
     Effect26.either(
       runPaymentsLiveWork({
@@ -16937,7 +17275,7 @@ var runLiveWorkPayments = async (args) => {
 // src/commands/localDev.ts
 import { spawn } from "child_process";
 import { access as access9 } from "fs/promises";
-import { dirname as dirname9, join as join27 } from "path";
+import { dirname as dirname9, join as join28 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 
 // src/lib/agentDetection.ts
@@ -17062,15 +17400,15 @@ var listAgents = () => Object.values(AGENTS);
 // src/commands/localDev.ts
 var HERE6 = dirname9(fileURLToPath6(import.meta.url));
 var PORT = 3005;
-var resolveMonorepoRoot = () => join27(HERE6, "..", "..", "..");
+var resolveMonorepoRoot = () => join28(HERE6, "..", "..", "..");
 var openBrowser = async (url) => {
-  const { default: open } = await import("open");
-  await open(url);
+  const { default: open2 } = await import("open");
+  await open2(url);
 };
 var runLocalDev = async () => {
   const root = resolveMonorepoRoot();
   try {
-    await access9(join27(root, "pnpm-workspace.yaml"));
+    await access9(join28(root, "pnpm-workspace.yaml"));
   } catch {
     process.stderr.write("\u274C vybekiit local-dev must be run from inside the VybeKiit monorepo.\n");
     return 1;
@@ -17084,7 +17422,7 @@ var runLocalDev = async () => {
   process.stdout.write(`   URL: http://localhost:${PORT}
 `);
   process.stdout.write("\n");
-  const appDir = join27(root, "apps", "localDevelopmentWebsite");
+  const appDir = join28(root, "apps", "localDevelopmentWebsite");
   const child = spawn("pnpm", ["dev"], {
     cwd: appDir,
     stdio: "pipe",
@@ -17118,10 +17456,10 @@ var runLocalDev = async () => {
 };
 
 // src/commands/new.ts
-import process10 from "process";
+import process11 from "process";
 var runNew = async (args) => {
   const [template, dir] = args;
-  process10.stderr.write(
+  process11.stderr.write(
     `Note: \`vybekiit new\` is deprecated. Use \`vybekiit create app ${CREATE_SURFACE_PIPE_FLAGS}\`.
 `
   );
@@ -17132,24 +17470,24 @@ var runNew = async (args) => {
   if (template === void 0 || template === "") {
     return await runCreateApp([]);
   }
-  process10.stderr.write(
+  process11.stderr.write(
     `Unknown surface "${template}". Use ${CREATE_SURFACE_LIST_FLAGS} (spa is not a create-app surface).
 `
   );
-  process10.stderr.write(
+  process11.stderr.write(
     "Examples:\n  vybekiit create app --web my-app\n  vybekiit create app --mobile\n"
   );
   return 1;
 };
 
 // src/commands/piecesCmd.ts
-import process11 from "process";
+import process12 from "process";
 
 // src/lib/pageRecipeCatalog.ts
-import { readFile as readFile11 } from "fs/promises";
-import { join as join28 } from "path";
-var PAGE_RECIPE_MANIFEST_RELATIVE = join28("scripts", "data", "page-recipe-manifest.json");
-var pageRecipeManifestPath = (kitRoot) => join28(kitRoot, PAGE_RECIPE_MANIFEST_RELATIVE);
+import { readFile as readFile12 } from "fs/promises";
+import { join as join29 } from "path";
+var PAGE_RECIPE_MANIFEST_RELATIVE = join29("scripts", "data", "page-recipe-manifest.json");
+var pageRecipeManifestPath = (kitRoot) => join29(kitRoot, PAGE_RECIPE_MANIFEST_RELATIVE);
 var nonEmptyOr = (value, fallback) => {
   if (value === void 0 || value === "") {
     return fallback;
@@ -17228,7 +17566,7 @@ var parsePageRecipeManifest = (raw) => {
 };
 var loadPageRecipes = async (kitRoot) => {
   try {
-    const raw = await readFile11(pageRecipeManifestPath(kitRoot), "utf8");
+    const raw = await readFile12(pageRecipeManifestPath(kitRoot), "utf8");
     return parsePageRecipeManifest(raw);
   } catch {
     return [];
@@ -17237,8 +17575,8 @@ var loadPageRecipes = async (kitRoot) => {
 var findPageRecipe = (recipes, idOrSlug) => recipes.find((recipe) => recipe.id === idOrSlug || recipe.slug === idOrSlug);
 
 // src/lib/pageRecipeInstall.ts
-import { access as access11, mkdir as mkdir7, readFile as readFile13, writeFile as writeFile8 } from "fs/promises";
-import { basename as basename2, dirname as dirname11, join as join31, relative as relative3, resolve as resolve11 } from "path";
+import { access as access11, mkdir as mkdir8, readFile as readFile14, writeFile as writeFile9 } from "fs/promises";
+import { basename as basename2, dirname as dirname11, join as join32, relative as relative4, resolve as resolve11 } from "path";
 
 // src/lib/pageRecipeImports.ts
 var SHARED_IMPORT_PATTERN = /from\s+['"]((?:\.\.\/)+shared\/[^'"]+|\.\/shared\/[^'"]+)['"]/g;
@@ -17303,8 +17641,8 @@ var rewriteInstalledSource = (source) => (
 );
 
 // src/lib/pageRecipePlanFiles.ts
-import { access as access10, readFile as readFile12 } from "fs/promises";
-import { basename, dirname as dirname10, join as join30, relative as relative2 } from "path";
+import { access as access10, readFile as readFile13 } from "fs/promises";
+import { basename, dirname as dirname10, join as join31, relative as relative3 } from "path";
 
 // src/lib/pageRecipeRouteStub.ts
 var buildRouteStub = (exportName, componentImportPath, targetRoute) => `import { ${exportName} } from '${componentImportPath}';
@@ -17406,7 +17744,7 @@ export const foregroundTripletFor = (hex: string): string => {
 `;
 
 // src/lib/resolveAppSurface.ts
-import { join as join29, resolve as resolve10 } from "path";
+import { join as join30, resolve as resolve10 } from "path";
 var stripLeadingSlashes = (route) => {
   let result = route;
   while (result.startsWith("/")) {
@@ -17425,11 +17763,11 @@ var appRootCandidates = (dest) => {
   const root = resolve10(dest);
   return [
     root,
-    join29(root, "templates", "web"),
-    join29(root, "web"),
-    join29(root, "templates", "spa"),
-    join29(root, "spa"),
-    join29(root, "apps", "web")
+    join30(root, "templates", "web"),
+    join30(root, "web"),
+    join30(root, "templates", "spa"),
+    join30(root, "spa"),
+    join30(root, "apps", "web")
   ];
 };
 var fallbackLayout = (dest) => {
@@ -17438,15 +17776,15 @@ var fallbackLayout = (dest) => {
     appRoot: root,
     appDir: void 0,
     usesLocaleSegment: false,
-    componentsDir: join29(root, "src", "components", "pageRecipes")
+    componentsDir: join30(root, "src", "components", "pageRecipes")
   };
 };
 var probeAppRoot = async (candidate) => {
-  const appAtRoot = join29(candidate, "app");
-  const appUnderSrc = join29(candidate, "src", "app");
-  const srcDir = join29(candidate, "src");
+  const appAtRoot = join30(candidate, "app");
+  const appUnderSrc = join30(candidate, "src", "app");
+  const srcDir = join30(candidate, "src");
   const [hasPackage, hasAppAtRoot, hasAppUnderSrc, hasSrc] = await Promise.all([
-    pathExists3(join29(candidate, "package.json")),
+    pathExists3(join30(candidate, "package.json")),
     pathExists3(appAtRoot),
     pathExists3(appUnderSrc),
     pathExists3(srcDir)
@@ -17460,8 +17798,8 @@ var probeAppRoot = async (candidate) => {
   } else if (hasAppUnderSrc) {
     appDir = appUnderSrc;
   }
-  const usesLocaleSegment = appDir !== void 0 && await pathExists3(join29(appDir, "[locale]"));
-  const componentsDir = hasSrc ? join29(candidate, "src", "components", "pageRecipes") : join29(candidate, "components", "pageRecipes");
+  const usesLocaleSegment = appDir !== void 0 && await pathExists3(join30(appDir, "[locale]"));
+  const componentsDir = hasSrc ? join30(candidate, "src", "components", "pageRecipes") : join30(candidate, "components", "pageRecipes");
   return {
     appRoot: candidate,
     appDir,
@@ -17481,7 +17819,7 @@ var routeSegmentPath = (targetRoute, usesLocaleSegment) => {
   const trimmed = stripTrailingSlashes(stripLeadingSlashes(targetRoute));
   const body = trimmed === "" ? "index" : trimmed;
   if (usesLocaleSegment) {
-    return join29("[locale]", body);
+    return join30("[locale]", body);
   }
   return body;
 };
@@ -17518,7 +17856,7 @@ var resolveSourceFile = async (basePath) => {
 var findKitSharedDir = async (fromFile) => {
   let dir = dirname10(fromFile);
   for (let depth = 0; depth < 6; depth += 1) {
-    const candidate = join30(dir, "shared");
+    const candidate = join31(dir, "shared");
     if (await pathExists5(candidate)) {
       return candidate;
     }
@@ -17532,19 +17870,19 @@ var findKitSharedDir = async (fromFile) => {
 };
 var loadSharedModule = async (options) => {
   const { spec, appRoot, componentsDir, kitSharedDir } = options;
-  const kitSharedBase = join30(kitSharedDir, stripLeadingDotSlash(spec));
+  const kitSharedBase = join31(kitSharedDir, stripLeadingDotSlash(spec));
   const kitSharedFile = await resolveSourceFile(kitSharedBase);
   if (kitSharedFile === null) {
     throw new Error(`Missing shared recipe dependency: ${spec}`);
   }
-  const sharedDest = join30(componentsDir, "shared", basename(kitSharedFile));
-  const sharedRaw = await readFile12(kitSharedFile, "utf8");
+  const sharedDest = join31(componentsDir, "shared", basename(kitSharedFile));
+  const sharedRaw = await readFile13(kitSharedFile, "utf8");
   const sharedContent = rewriteInstalledSource(sharedRaw);
   const nextSpecs = collectRelativeImports(sharedRaw).map((rel) => stripLeadingDotSlash(rel));
   return {
     file: {
       absolutePath: sharedDest,
-      relativePath: relative2(appRoot, sharedDest),
+      relativePath: relative3(appRoot, sharedDest),
       kind: "shared",
       content: sharedContent
     },
@@ -17617,7 +17955,7 @@ var planRouteFile = async (options) => {
     return [];
   }
   const segment = routeSegmentPath(recipe.targetRoute, usesLocaleSegment);
-  const routeFile = join30(appDir, segment, "page.tsx");
+  const routeFile = join31(appDir, segment, "page.tsx");
   const importPath = `@/components/pageRecipes/${stripComponentExtension(recipeFileName)}`;
   if (await pathExists5(routeFile)) {
     return [];
@@ -17625,7 +17963,7 @@ var planRouteFile = async (options) => {
   return [
     {
       absolutePath: routeFile,
-      relativePath: relative2(appRoot, routeFile),
+      relativePath: relative3(appRoot, routeFile),
       kind: "route",
       content: buildRouteStub(recipe.exportName, importPath, recipe.targetRoute)
     }
@@ -17635,11 +17973,11 @@ var themeHelperFiles = (layout, needsThemeHelper) => {
   if (!needsThemeHelper) {
     return [];
   }
-  const helperDest = join30(layout.componentsDir, "shared", "themeHelpers.ts");
+  const helperDest = join31(layout.componentsDir, "shared", "themeHelpers.ts");
   return [
     {
       absolutePath: helperDest,
-      relativePath: relative2(layout.appRoot, helperDest),
+      relativePath: relative3(layout.appRoot, helperDest),
       kind: "theme-helper",
       content: THEME_HELPER_SOURCE
     }
@@ -17672,15 +18010,15 @@ var pathExists6 = async (path) => {
 var planPageRecipeInstall = async (options) => {
   const { kitRoot, dest, recipe } = options;
   const layout = await resolveAppSurface(dest);
-  const sourceAbs = join31(kitRoot, recipe.sourcePath);
+  const sourceAbs = join32(kitRoot, recipe.sourcePath);
   if (!await pathExists6(sourceAbs)) {
     throw new Error(
       `Recipe source not found at ${recipe.sourcePath}. Re-run from a kit workspace or with kit access.`
     );
   }
-  const recipeSource = await readFile13(sourceAbs, "utf8");
+  const recipeSource = await readFile14(sourceAbs, "utf8");
   const recipeFileName = basename2(recipe.sourcePath);
-  const recipeDest = join31(layout.componentsDir, recipeFileName);
+  const recipeDest = join32(layout.componentsDir, recipeFileName);
   const shared = await planSharedFiles({
     sourceAbs,
     recipeSource,
@@ -17697,7 +18035,7 @@ var planPageRecipeInstall = async (options) => {
   const followUps = buildInstallFollowUps(recipe);
   const mainFile = {
     absolutePath: recipeDest,
-    relativePath: relative3(layout.appRoot, recipeDest),
+    relativePath: relative4(layout.appRoot, recipeDest),
     kind: "component",
     content: rewriteInstalledSource(recipeSource)
   };
@@ -17728,8 +18066,8 @@ var applyPageRecipeInstall = async (plan, options = { force: false }) => {
       if (exists3 && !options.force) {
         return { kind: "skipped", path: file.relativePath };
       }
-      await mkdir7(dirname11(file.absolutePath), { recursive: true });
-      await writeFile8(file.absolutePath, file.content, "utf8");
+      await mkdir8(dirname11(file.absolutePath), { recursive: true });
+      await writeFile9(file.absolutePath, file.content, "utf8");
       return { kind: "written", path: file.relativePath };
     })
   );
@@ -17776,6 +18114,15 @@ var backendPieces = () => [
     command: "vybekiit backend add-upload"
   }
 ];
+var reportModePieces = () => [
+  {
+    kind: "report-mode",
+    id: "report-mode",
+    title: "Report Mode",
+    summary: "Install the dev-only point & fix inspect/report overlay into an existing app.",
+    command: "vybekiit add report-mode [--to=dir]"
+  }
+];
 var dbPieces = () => ALL_PRESETS.map((preset) => {
   const summary = preset.description === void 0 || preset.description === "" ? `Database preset ${preset.id}` : preset.description;
   return {
@@ -17795,7 +18142,7 @@ var pageRecipePieces = (recipes) => recipes.map((recipe) => ({
   linkedPresets: recipe.presetIds,
   command: `vybekiit add page-recipe ${recipe.id}`
 }));
-var buildCatalog = (recipes, kindFilter) => [...dbPieces(), ...pageRecipePieces(recipes), ...backendPieces()].filter(
+var buildCatalog = (recipes, kindFilter) => [...dbPieces(), ...pageRecipePieces(recipes), ...backendPieces(), ...reportModePieces()].filter(
   (piece) => kindFilter === void 0 || piece.kind === kindFilter
 );
 
@@ -17931,7 +18278,7 @@ var runAddPageRecipe = async (args) => {
     if (recipe === void 0) {
       return recipeError(`Unknown page recipe "${recipeId}". Run: vybekiit list-page-recipes`);
     }
-    const dest = resolveInstallDest(destArg, process11.cwd());
+    const dest = resolveInstallDest(destArg, process12.cwd());
     const plan = await planPageRecipeInstall({ kitRoot, dest, recipe });
     if (flags.dryRun) {
       return {
@@ -17955,12 +18302,12 @@ var runAddPageRecipe = async (args) => {
 };
 
 // src/commands/piecesInteractive.ts
-import process13 from "process";
-import { cancel, isCancel, select } from "@clack/prompts";
+import process15 from "process";
+import { cancel, isCancel as isCancel2, select } from "@clack/prompts";
 
 // src/commands/presetsCmd.ts
 import { resolve as resolve12 } from "path";
-import process12 from "process";
+import process13 from "process";
 import { Effect as Effect27, Either as Either5 } from "effect";
 var POSTGRES_PROVIDERS = ["supabase", "neon", "railway"];
 var NOSQL_PROVIDERS = ["mongodb", "firebase", "aws"];
@@ -17988,10 +18335,10 @@ var parseFlags = (args) => {
 };
 var resolvePresetEnv = (cwd) => {
   if (cwd === void 0 || cwd === "") {
-    return process12.env;
+    return process13.env;
   }
-  const absolute = resolve12(process12.cwd(), cwd);
-  return mergeEnv(process12.env, loadEnvFile2(absolute));
+  const absolute = resolve12(process13.cwd(), cwd);
+  return mergeEnv(process13.env, loadEnvFile2(absolute));
 };
 var databaseUrlFromEnv = (env) => env.DATABASE_URL;
 var isNosqlProvider2 = (provider) => provider === "mongodb" || provider === "firebase" || provider === "aws";
@@ -18095,7 +18442,7 @@ var runApplyPreset = async (args) => {
       result.ok ? {
         ok: true,
         ...result.value,
-        ...flags.cwd === void 0 ? {} : { cwd: resolve12(process12.cwd(), flags.cwd) }
+        ...flags.cwd === void 0 ? {} : { cwd: resolve12(process13.cwd(), flags.cwd) }
       } : result,
       null,
       2
@@ -18155,97 +18502,591 @@ var runListPresets = () => {
   };
 };
 
-// src/commands/piecesInteractive.ts
-var runListPath = async () => {
-  const result = await runListPieces([]);
-  process13.stdout.write(`${result.json}
-`);
-  return result.exitCode;
-};
-var runDbPresetPath = async () => {
-  const picked = await select({
-    message: "Which database preset?",
-    options: ALL_PRESETS.map((preset) => ({
-      value: preset.id,
-      label: preset.id,
-      hint: preset.description === void 0 || preset.description === "" ? preset.id : preset.description
-    }))
-  });
-  if (isCancel(picked) || typeof picked !== "string") {
-    cancel("Cancelled.");
-    return 1;
+// src/commands/reportModeCmd.ts
+import { spawnSync } from "child_process";
+import process14 from "process";
+
+// ../packages/reportMode/src/deeplink.ts
+var inferVybeAssistant = (options) => {
+  if (options.cursorSession) {
+    return "cursor";
   }
-  const result = await runApplyPreset([picked, "--dry-run"]);
-  process13.stdout.write(`${result.json}
-`);
-  process13.stdout.write(
-    `
-Dry-run shown. Apply for real with: vybekiit apply-preset ${picked}
-(Needs DATABASE_URL in the project.)
-`
-  );
-  return result.exitCode;
+  if (options.claudeInstalled) {
+    return "claude";
+  }
+  if (options.codexInstalled) {
+    return "codex";
+  }
+  if (options.kiroInstalled === true) {
+    return "kiro";
+  }
+  if (options.kimiInstalled === true) {
+    return "kimi";
+  }
+  if (options.grokInstalled === true) {
+    return "grok";
+  }
+  if (options.devinInstalled === true) {
+    return "devin";
+  }
+  return null;
 };
-var runPageRecipePath = async () => {
-  let cleanup;
+
+// src/lib/reportModeInstall.ts
+import { access as access12, mkdir as mkdir9, readdir as readdir8, readFile as readFile16, writeFile as writeFile11 } from "fs/promises";
+import { dirname as dirname12, join as join33, relative as relative5 } from "path";
+
+// src/lib/packageJsonDeps.ts
+import { readFile as readFile15, writeFile as writeFile10 } from "fs/promises";
+var ensureDependencies = async (pkgPath, deps) => {
+  let raw;
   try {
-    const resolved = await resolveKitSource();
-    const { cleanup: resolvedCleanup, kitRoot } = resolved;
-    cleanup = resolvedCleanup;
-    const recipes = await loadPageRecipes(kitRoot);
-    if (recipes.length === 0) {
-      process13.stderr.write("No page recipes available from the kit source.\n");
-      return 1;
-    }
-    const picked = await select({
-      message: "Which page recipe?",
-      options: recipes.map((recipe) => ({
-        value: recipe.id,
-        label: recipe.title,
-        hint: `${recipe.groupLabel} \xB7 ${recipe.targetRoute}`
-      }))
-    });
-    if (isCancel(picked) || typeof picked !== "string") {
-      cancel("Cancelled.");
-      return 1;
+    raw = await readFile15(pkgPath, "utf8");
+  } catch {
+    return [];
+  }
+  const pkg = JSON.parse(raw);
+  const dependencies = pkg.dependencies ?? {};
+  const added = [];
+  for (const [name, version] of Object.entries(deps)) {
+    if (dependencies[name] === void 0) {
+      dependencies[name] = version;
+      added.push(name);
     }
-    const result = await runAddPageRecipe([picked, "--to=."]);
-    process13.stdout.write(`${result.json}
+  }
+  if (added.length === 0) {
+    return [];
+  }
+  pkg.dependencies = dependencies;
+  await writeFile10(pkgPath, `${JSON.stringify(pkg, null, 2)}
 `);
-    if (result.exitCode === 0) {
-      process13.stdout.write(
-        `
-Installed "${picked}" into the current folder. Wire the TODOs in the JSON report next.
-`
-      );
+  return added;
+};
+
+// src/lib/reportModeInstall.ts
+var INSTALLABLE_SURFACES = ["web", "mobile", "extension"];
+var isInstallableSurface = (surface) => INSTALLABLE_SURFACES.includes(surface);
+var listFilesRecursive = async (dir, prefix = "") => {
+  try {
+    const entries = await readdir8(dir, { withFileTypes: true });
+    const nested = await Promise.all(
+      entries.map(async (entry) => {
+        const rel = prefix === "" ? entry.name : `${prefix}/${entry.name}`;
+        if (entry.isDirectory()) {
+          return await listFilesRecursive(join33(dir, entry.name), rel);
+        }
+        return [rel];
+      })
+    );
+    return nested.flat();
+  } catch {
+    return [];
+  }
+};
+var defaultReportModeFs = {
+  listFiles: (dir) => listFilesRecursive(dir),
+  readText: async (path) => {
+    try {
+      return await readFile16(path, "utf8");
+    } catch {
+      return null;
     }
-    return result.exitCode;
-  } catch (error) {
-    const message = caughtMessage(error);
-    process13.stderr.write(`${message}
-`);
-    return 1;
-  } finally {
-    if (cleanup !== void 0) {
-      await cleanup();
+  },
+  exists: async (path) => {
+    try {
+      await access12(path);
+      return true;
+    } catch {
+      return false;
     }
+  },
+  writeText: async (path, content) => {
+    await mkdir9(dirname12(path), { recursive: true });
+    await writeFile11(path, content, "utf8");
   }
 };
-var runAddPiecesInteractive = async () => {
-  if (!isInteractive()) {
-    process13.stderr.write(
-      "add requires arguments in non-interactive mode. Try: vybekiit list-pieces\n"
-    );
-    return 1;
+var SURFACE_SOURCES = {
+  web: {
+    subtrees: ["src/components/report-mode", "src/lib/report-mode", "src/components/walkthrough"],
+    companions: ["src/lib/nodeEnv.ts", "src/lib/utils.ts"],
+    assumedPresent: []
+  },
+  mobile: {
+    subtrees: ["src/components/report-mode", "src/lib/report-mode"],
+    companions: ["src/lib/nodeEnv.ts"],
+    assumedPresent: ["@/theme/useTheme"]
+  },
+  extension: {
+    subtrees: ["src/components/report-mode", "src/lib/report-mode"],
+    companions: ["src/lib/utils.ts", "styles/report-mode-note.css"],
+    assumedPresent: ["@/components/ui/button", "@/components/ui/input"]
   }
-  const kind = await select({
-    message: "What kind of ready piece?",
-    options: [
-      {
-        value: "page-recipe",
+};
+var REWRITE_TARGET = "src/components/report-mode/report-mode-dev.tsx";
+var UTILS_FILE = "src/lib/utils.ts";
+var WORKSPACE_RANGE = "workspace:*";
+var parseDependencies = (raw) => {
+  if (raw === null || raw === "") {
+    return {};
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    return parsed.dependencies ?? {};
+  } catch {
+    return {};
+  }
+};
+var rewriteContent = (relativePath, raw, applyRewrite) => {
+  if (!applyRewrite || relativePath !== REWRITE_TARGET) {
+    return raw;
+  }
+  return raw.replaceAll("from '@/i18n/navigation'", "from 'next/navigation'");
+};
+var toPlannedFile = async (options) => {
+  const { fs, sourceDir, dest, relativePath, applyRewrite } = options;
+  const raw = await fs.readText(join33(sourceDir, relativePath));
+  if (raw === null) {
+    return null;
+  }
+  const absolutePath = join33(dest, relativePath);
+  return {
+    relativePath,
+    absolutePath,
+    content: rewriteContent(relativePath, raw, applyRewrite),
+    exists: await fs.exists(absolutePath)
+  };
+};
+var buildPlannedFiles = async (options) => {
+  const { fs, sourceDir, dest, sources, applyRewrite } = options;
+  const subtreeGroups = await Promise.all(
+    sources.subtrees.map(async (subtree) => {
+      const names = await fs.listFiles(join33(sourceDir, subtree));
+      return names.map((name) => `${subtree}/${name}`);
+    })
+  );
+  const relativePaths = [...subtreeGroups.flat(), ...sources.companions];
+  const planned = await Promise.all(
+    relativePaths.map(
+      (relativePath) => toPlannedFile({ fs, sourceDir, dest, relativePath, applyRewrite })
+    )
+  );
+  return planned.filter((file) => file !== null);
+};
+var buildDeps = (surface, sourceDeps, willWriteUtils) => {
+  const deps = { "@vybekiit/report-mode": WORKSPACE_RANGE };
+  if (surface === "web") {
+    deps["@vybekiit/ui"] = WORKSPACE_RANGE;
+    deps["@vybekiit/walkthrough"] = WORKSPACE_RANGE;
+    const { sonner } = sourceDeps;
+    if (sonner !== void 0) {
+      deps.sonner = sonner;
+    }
+  }
+  if (willWriteUtils && (surface === "web" || surface === "extension")) {
+    const { cnfast } = sourceDeps;
+    if (cnfast !== void 0) {
+      deps.cnfast = cnfast;
+    }
+  }
+  return deps;
+};
+var buildEnv = (surface, assistant) => {
+  const env = { VYBE_REPORT_MODE: "1" };
+  if (assistant === null) {
+    return env;
+  }
+  const projectSurface = {
+    template: surface,
+    mobile: surface === "mobile",
+    extension: surface === "extension"
+  };
+  return { ...env, ...reportModeEnvKeysForSurface(projectSurface, assistant) };
+};
+var planRewrite = async (options) => {
+  const { surface, dest, fs, appSurface, destDeps } = options;
+  if (surface !== "web") {
+    return { applied: false, reason: `No i18n rewrite for the ${surface} surface.` };
+  }
+  const usesLocaleSegment = appSurface?.usesLocaleSegment === true;
+  const hasI18nNavigation = await fs.exists(join33(dest, "src", "i18n", "navigation.ts"));
+  const hasNextIntlDep = destDeps["next-intl"] !== void 0;
+  if (usesLocaleSegment || hasI18nNavigation || hasNextIntlDep) {
+    return { applied: false, reason: "Project uses next-intl; kept @/i18n/navigation." };
+  }
+  return { applied: true, reason: "Non-next-intl project; rewrote to next/navigation." };
+};
+var uniquePaths = (paths) => [...new Set(paths)];
+var buildMountSpec = (surface, dest, appSurface) => {
+  if (surface === "web") {
+    const appDir = appSurface?.appDir;
+    const candidates = [];
+    if (appDir !== void 0 && appSurface?.usesLocaleSegment === true) {
+      candidates.push(join33(appDir, "[locale]", "layout.tsx"));
+    }
+    if (appDir !== void 0) {
+      candidates.push(join33(appDir, "layout.tsx"));
+    }
+    candidates.push(join33(dest, "src", "app", "layout.tsx"));
+    return {
+      component: "ReportModeDevShell",
+      importStatement: "import { ReportModeDevShell } from '@/components/report-mode/report-mode-shell';",
+      jsxTag: "<ReportModeDevShell />",
+      candidatePaths: uniquePaths(candidates),
+      anchor: "</body>"
+    };
+  }
+  if (surface === "mobile") {
+    return {
+      component: "ReportModeDev",
+      importStatement: "import { ReportModeDev } from '@/components/report-mode/report-mode-dev';",
+      jsxTag: "<ReportModeDev />",
+      candidatePaths: [join33(dest, "app", "_layout.tsx")],
+      anchor: void 0
+    };
+  }
+  return {
+    component: "ReportModeDev",
+    importStatement: "import { ReportModeDev } from '@/components/report-mode/report-mode-dev';",
+    jsxTag: "<ReportModeDev />",
+    candidatePaths: [join33(dest, "src", "components", "app-root.tsx")],
+    anchor: void 0
+  };
+};
+var insertMount = (content, importStatement, jsxTag, anchor) => {
+  const lines = content.split("\n");
+  const lastImportIndex = lines.reduce(
+    (acc, line, index) => line.startsWith("import ") ? index : acc,
+    -1
+  );
+  const withImport = lastImportIndex >= 0 ? [
+    ...lines.slice(0, lastImportIndex + 1),
+    importStatement,
+    ...lines.slice(lastImportIndex + 1)
+  ].join("\n") : `${importStatement}
+${content}`;
+  return withImport.replace(anchor, `  ${jsxTag}
+      ${anchor}`);
+};
+var planMount = async (fs, spec) => {
+  const loaded = await Promise.all(
+    spec.candidatePaths.map(async (candidate) => ({
+      candidate,
+      content: await fs.readText(candidate)
+    }))
+  );
+  const existing = loaded.filter(
+    (entry) => entry.content !== null
+  );
+  const base = {
+    path: existing[0]?.candidate ?? spec.candidatePaths[0] ?? "",
+    importSnippet: spec.importStatement,
+    jsxSnippet: spec.jsxTag
+  };
+  if (existing.length === 0) {
+    return { ...base, status: "todo", reason: "No root layout found; mount manually." };
+  }
+  const alreadyMounted = existing.find((entry) => entry.content.includes(spec.component));
+  if (alreadyMounted !== void 0) {
+    return {
+      ...base,
+      path: alreadyMounted.candidate,
+      status: "already",
+      reason: "Report Mode is already mounted."
+    };
+  }
+  const anchor = spec.anchor;
+  if (anchor !== void 0) {
+    const mountable = existing.filter((entry) => entry.content.split(anchor).length - 1 === 1);
+    const target = mountable[0];
+    if (mountable.length === 1 && target !== void 0) {
+      return {
+        ...base,
+        path: target.candidate,
+        status: "inserted",
+        reason: "Mounted into the root layout.",
+        newContent: insertMount(target.content, spec.importStatement, spec.jsxTag, anchor)
+      };
+    }
+  }
+  return { ...base, status: "todo", reason: "Mount manually (no single layout anchor found)." };
+};
+var planReportModeInstall = async (options) => {
+  const { kitRoot, dest, surface, assistant, appSurface, fs = defaultReportModeFs } = options;
+  if (!isInstallableSurface(surface)) {
+    return { available: false, surface };
+  }
+  const sourceDir = join33(kitRoot, "templates", surface);
+  const sources = SURFACE_SOURCES[surface];
+  const destDeps = parseDependencies(await fs.readText(join33(dest, "package.json")));
+  const rewrite = await planRewrite({ surface, dest, fs, appSurface, destDeps });
+  const files = await buildPlannedFiles({
+    fs,
+    sourceDir,
+    dest,
+    sources,
+    applyRewrite: rewrite.applied
+  });
+  if (files.length === 0) {
+    throw new Error(
+      `Report Mode source not found under templates/${surface}. Re-run from a kit workspace or with kit access.`
+    );
+  }
+  const utilsFile = files.find((file) => file.relativePath === UTILS_FILE);
+  const willWriteUtils = utilsFile !== void 0 && !utilsFile.exists;
+  const sourceDeps = parseDependencies(await fs.readText(join33(sourceDir, "package.json")));
+  const deps = buildDeps(surface, sourceDeps, willWriteUtils);
+  const env = buildEnv(surface, assistant);
+  const mount = await planMount(fs, buildMountSpec(surface, dest, appSurface));
+  const todos = [];
+  if (assistant === null) {
+    todos.push(
+      "Run `vybekiit doctor` to set your assistant key so Report Mode knows where to hand off."
+    );
+  }
+  if (sources.assumedPresent.length > 0) {
+    todos.push(
+      `Report Mode also imports these files that ship in every VybeKiit ${surface} app: ${sources.assumedPresent.join(", ")}. Add them first if your project predates them.`
+    );
+  }
+  if (mount.status === "todo") {
+    todos.push(
+      `Mount Report Mode in ${relative5(dest, mount.path) || mount.path}: add \`${mount.importSnippet}\` and render \`${mount.jsxSnippet}\` in the layout.`
+    );
+  }
+  return {
+    available: true,
+    surface,
+    dest,
+    files,
+    deps,
+    env,
+    rewrite,
+    mount,
+    assumedPresent: sources.assumedPresent,
+    todos,
+    nextCommands: assistant === null ? ["vybekiit doctor"] : []
+  };
+};
+var defaultApplySeams = {
+  fs: defaultReportModeFs,
+  ensureDeps: ensureDependencies,
+  writeEnv: writeEnvKeys
+};
+var applyReportModeInstall = async (plan, options = { force: false }, seams = defaultApplySeams) => {
+  const outcomes = await Promise.all(
+    plan.files.map(async (file) => {
+      if (file.exists && !options.force) {
+        return { kind: "skipped", path: file.relativePath };
+      }
+      await seams.fs.writeText(file.absolutePath, file.content);
+      return { kind: "written", path: file.relativePath };
+    })
+  );
+  const written = outcomes.filter((row) => row.kind === "written").map((row) => row.path);
+  const skipped = outcomes.filter((row) => row.kind === "skipped").map((row) => row.path);
+  const depsAdded = await seams.ensureDeps(join33(plan.dest, "package.json"), plan.deps);
+  if (Object.keys(plan.env).length > 0) {
+    seams.writeEnv(plan.dest, plan.env);
+  }
+  if (plan.mount.status === "inserted" && plan.mount.newContent !== void 0) {
+    await seams.fs.writeText(plan.mount.path, plan.mount.newContent);
+  }
+  return {
+    written,
+    skipped,
+    depsAdded,
+    envKeys: Object.keys(plan.env),
+    mount: plan.mount.status
+  };
+};
+
+// src/commands/reportModeCmd.ts
+var isCursorSession = () => Boolean(process14.env.CURSOR_TRACE_ID || process14.env.CURSOR_SESSION_ID);
+var succeeds = (command, args) => spawnSync(command, [...args], { stdio: "ignore" }).status === 0;
+var resolveAssistant = () => inferVybeAssistant({
+  cursorSession: isCursorSession(),
+  claudeInstalled: succeeds("claude", ["--version"]),
+  codexInstalled: succeeds("codex", ["--version"])
+});
+var installPayload2 = (plan, written, skipped, dryRun) => ({
+  ok: true,
+  dryRun,
+  surface: plan.surface,
+  files: plan.files.map((file) => file.relativePath),
+  written,
+  skipped,
+  deps: plan.deps,
+  env: plan.env,
+  mount: { status: plan.mount.status, path: plan.mount.path, reason: plan.mount.reason },
+  rewrite: plan.rewrite,
+  assumedPresent: plan.assumedPresent,
+  todos: plan.todos,
+  nextCommands: plan.nextCommands
+});
+var reportModeError = (error) => ({
+  json: JSON.stringify({ ok: false, error }),
+  exitCode: 1
+});
+var runAddReportMode = async (args) => {
+  const flags = parsePieceFlags(args);
+  const destArg = flags.to === void 0 || flags.to === "" ? flags.positionals.at(0) : flags.to;
+  const dest = resolveInstallDest(destArg, process14.cwd());
+  const surface = inferProjectSurfaceSync(dest).template;
+  let cleanup;
+  try {
+    const resolved = await resolveKitSource();
+    const { cleanup: resolvedCleanup, kitRoot } = resolved;
+    cleanup = resolvedCleanup;
+    const appSurface = surface === "web" ? await resolveAppSurface(dest) : void 0;
+    const plan = await planReportModeInstall({
+      kitRoot,
+      dest,
+      surface,
+      assistant: resolveAssistant(),
+      ...appSurface === void 0 ? {} : { appSurface }
+    });
+    if (!plan.available) {
+      return {
+        json: JSON.stringify(
+          {
+            ok: true,
+            available: false,
+            surface: plan.surface,
+            reason: `Report Mode has no installable files for the ${plan.surface} surface (web, mobile, and extension only).`
+          },
+          null,
+          2
+        ),
+        exitCode: 0
+      };
+    }
+    if (flags.dryRun) {
+      return {
+        json: JSON.stringify(installPayload2(plan, [], [], true), null, 2),
+        exitCode: 0
+      };
+    }
+    const { written, skipped } = await applyReportModeInstall(plan, { force: flags.force });
+    return {
+      json: JSON.stringify(installPayload2(plan, written, skipped, false), null, 2),
+      exitCode: 0
+    };
+  } catch (error) {
+    return reportModeError(caughtMessage(error));
+  } finally {
+    if (cleanup !== void 0) {
+      await cleanup();
+    }
+  }
+};
+
+// src/commands/piecesInteractive.ts
+var runListPath = async () => {
+  const result = await runListPieces([]);
+  process15.stdout.write(`${result.json}
+`);
+  return result.exitCode;
+};
+var runDbPresetPath = async () => {
+  const picked = await select({
+    message: "Which database preset?",
+    options: ALL_PRESETS.map((preset) => ({
+      value: preset.id,
+      label: preset.id,
+      hint: preset.description === void 0 || preset.description === "" ? preset.id : preset.description
+    }))
+  });
+  if (isCancel2(picked) || typeof picked !== "string") {
+    cancel("Cancelled.");
+    return 1;
+  }
+  const result = await runApplyPreset([picked, "--dry-run"]);
+  process15.stdout.write(`${result.json}
+`);
+  process15.stdout.write(
+    `
+Dry-run shown. Apply for real with: vybekiit apply-preset ${picked}
+(Needs DATABASE_URL in the project.)
+`
+  );
+  return result.exitCode;
+};
+var runReportModePath = async () => {
+  const result = await runAddReportMode(["--to=."]);
+  process15.stdout.write(`${result.json}
+`);
+  if (result.exitCode === 0) {
+    process15.stdout.write(
+      "\nInstalled Report Mode into the current folder. Wire any TODOs in the JSON report next.\n"
+    );
+  }
+  return result.exitCode;
+};
+var runPageRecipePath = async () => {
+  let cleanup;
+  try {
+    const resolved = await resolveKitSource();
+    const { cleanup: resolvedCleanup, kitRoot } = resolved;
+    cleanup = resolvedCleanup;
+    const recipes = await loadPageRecipes(kitRoot);
+    if (recipes.length === 0) {
+      process15.stderr.write("No page recipes available from the kit source.\n");
+      return 1;
+    }
+    const picked = await select({
+      message: "Which page recipe?",
+      options: recipes.map((recipe) => ({
+        value: recipe.id,
+        label: recipe.title,
+        hint: `${recipe.groupLabel} \xB7 ${recipe.targetRoute}`
+      }))
+    });
+    if (isCancel2(picked) || typeof picked !== "string") {
+      cancel("Cancelled.");
+      return 1;
+    }
+    const result = await runAddPageRecipe([picked, "--to=."]);
+    process15.stdout.write(`${result.json}
+`);
+    if (result.exitCode === 0) {
+      process15.stdout.write(
+        `
+Installed "${picked}" into the current folder. Wire the TODOs in the JSON report next.
+`
+      );
+    }
+    return result.exitCode;
+  } catch (error) {
+    const message = caughtMessage(error);
+    process15.stderr.write(`${message}
+`);
+    return 1;
+  } finally {
+    if (cleanup !== void 0) {
+      await cleanup();
+    }
+  }
+};
+var runAddPiecesInteractive = async () => {
+  if (!isInteractive()) {
+    process15.stderr.write(
+      "add requires arguments in non-interactive mode. Try: vybekiit list-pieces\n"
+    );
+    return 1;
+  }
+  const kind = await select({
+    message: "What kind of ready piece?",
+    options: [
+      {
+        value: "page-recipe",
         label: "Page recipe (ready screen)",
         hint: "Copy a full page into your app"
       },
+      {
+        value: "report-mode",
+        label: "Report Mode (point & fix overlay)",
+        hint: "Add the dev-only inspect/report dock"
+      },
       {
         value: "db",
         label: "Database preset",
@@ -18258,7 +19099,7 @@ var runAddPiecesInteractive = async () => {
       }
     ]
   });
-  if (isCancel(kind) || typeof kind !== "string") {
+  if (isCancel2(kind) || typeof kind !== "string") {
     cancel("Cancelled.");
     return 1;
   }
@@ -18268,11 +19109,14 @@ var runAddPiecesInteractive = async () => {
   if (kind === "db") {
     return runDbPresetPath();
   }
+  if (kind === "report-mode") {
+    return runReportModePath();
+  }
   return runPageRecipePath();
 };
 
 // src/commands/planDataModelCmd.ts
-import { readFile as readFile14 } from "fs/promises";
+import { readFile as readFile17 } from "fs/promises";
 var PROVIDERS = [
   "supabase",
   "neon",
@@ -18302,7 +19146,7 @@ var runPlanDataModel = async (args) => {
     };
   }
   try {
-    const raw = await readFile14(inputPath, "utf8");
+    const raw = await readFile17(inputPath, "utf8");
     const parsed = JSON.parse(raw);
     const { entities } = parsed;
     if (entities === void 0 || entities.length === 0) {
@@ -18328,9 +19172,9 @@ var runPlanDataModel = async (args) => {
 };
 
 // src/commands/planReadiness.ts
-import { access as access12 } from "fs/promises";
-import { join as join32 } from "path";
-import process14 from "process";
+import { access as access13 } from "fs/promises";
+import { join as join34 } from "path";
+import process16 from "process";
 var FEATURES = [
   "sign-in",
   "payments",
@@ -18342,13 +19186,13 @@ var FEATURES = [
 var resolveFeatureName = (value) => FEATURES.find((feature) => feature === value);
 var pathExists7 = async (path) => {
   try {
-    await access12(path);
+    await access13(path);
     return true;
   } catch {
     return false;
   }
 };
-var runPlanReadiness = async (args, cwd = process14.cwd()) => {
+var runPlanReadiness = async (args, cwd = process16.cwd()) => {
   const [featureArg, templateArg] = args;
   const feature = featureArg === void 0 ? void 0 : resolveFeatureName(featureArg);
   if (feature === void 0) {
@@ -18374,7 +19218,7 @@ var runPlanReadiness = async (args, cwd = process14.cwd()) => {
       exitCode: 1
     };
   }
-  const hasBackend = await pathExists7(join32(cwd, "backend", "package.json"));
+  const hasBackend = await pathExists7(join34(cwd, "backend", "package.json"));
   const hasWeb = inferProjectSurfaceSync(cwd).template === "web";
   const plan = planFeatureReadiness({
     template,
@@ -18417,16 +19261,16 @@ var runPlanSetup = (args) => {
 };
 
 // src/commands/renderAgentLayer.ts
-import { mkdir as mkdir8, writeFile as writeFile9 } from "fs/promises";
-import { dirname as dirname12, join as join33 } from "path";
-import process15 from "process";
+import { mkdir as mkdir10, writeFile as writeFile12 } from "fs/promises";
+import { dirname as dirname13, join as join35 } from "path";
+import process17 from "process";
 var writeBuyerSkillStubs = async (cwd, template, skillContents) => {
   const stubs = planBuyerSkillStubOutputs(template, skillContents);
   await Promise.all(
     stubs.map(async (stub) => {
-      const absolute = join33(cwd, stub.stubPath);
-      await mkdir8(dirname12(absolute), { recursive: true });
-      await writeFile9(absolute, stub.content, "utf8");
+      const absolute = join35(cwd, stub.stubPath);
+      await mkdir10(dirname13(absolute), { recursive: true });
+      await writeFile12(absolute, stub.content, "utf8");
     })
   );
   return stubs.map((stub) => stub.stubPath);
@@ -18441,7 +19285,7 @@ var resolveRenderTemplate = async (cwd, templateArg) => {
   }
   return "web";
 };
-var runRenderAgentLayer = async (cwd = process15.cwd(), templateArg) => {
+var runRenderAgentLayer = async (cwd = process17.cwd(), templateArg) => {
   const template = await resolveRenderTemplate(cwd, templateArg);
   const { contents, present } = await loadAgentLayerRenderInputs(cwd);
   const skillContents = await listBuyerSkillContents(cwd);
@@ -18464,22 +19308,22 @@ var runRenderAgentLayer = async (cwd = process15.cwd(), templateArg) => {
 };
 
 // src/commands/setup.ts
-import process24 from "process";
+import process27 from "process";
 
 // src/doctor/gate.ts
-import { spawnSync } from "child_process";
-import process16 from "process";
-var { org: GATE_ORG, repos: GATE_REPOS } = readGateIdentity(process16.env);
+import { spawnSync as spawnSync2 } from "child_process";
+import process18 from "process";
+var { org: GATE_ORG, repos: GATE_REPOS } = readGateIdentity(process18.env);
 var SITE_URL = (() => {
-  const value = process16.env.VYBEKIIT_SITE_URL;
+  const value = process18.env.VYBEKIIT_SITE_URL;
   if (value !== void 0 && value.trim() !== "") {
     return value;
   }
   return "https://vybekiit.com";
 })();
-var ghSucceeds = (args) => spawnSync("gh", [...args], { stdio: "ignore" }).status === 0;
+var ghSucceeds = (args) => spawnSync2("gh", [...args], { stdio: "ignore" }).status === 0;
 var isOrgMember = () => {
-  const result = spawnSync("gh", ["api", `user/memberships/orgs/${GATE_ORG}`, "--jq", ".state"], {
+  const result = spawnSync2("gh", ["api", `user/memberships/orgs/${GATE_ORG}`, "--jq", ".state"], {
     encoding: "utf8"
   });
   const stdout = result.stdout === void 0 ? "" : result.stdout;
@@ -18487,7 +19331,7 @@ var isOrgMember = () => {
 };
 var hasRepoAccess = () => GATE_REPOS.some((repo) => ghSucceeds(["api", `repos/${GATE_ORG}/${repo}`]));
 var checkAccess = () => {
-  if (process16.env.VYBEKIIT_SKIP_GATE === "1") {
+  if (process18.env.VYBEKIIT_SKIP_GATE === "1") {
     return { allowed: true, reason: "skipped", org: GATE_ORG };
   }
   if (!ghSucceeds(["--version"])) {
@@ -18519,61 +19363,35 @@ var ensureAccessOrExit = () => {
   if (result.allowed) {
     return true;
   }
-  process16.stderr.write(`${formatGateFailure(result)}
+  process18.stderr.write(`${formatGateFailure(result)}
 `);
   return false;
 };
 
 // src/doctor/run.ts
-import { spawnSync as spawnSync7 } from "child_process";
-import process19 from "process";
-
-// ../packages/reportMode/src/deeplink.ts
-var inferVybeAssistant = (options) => {
-  if (options.cursorSession) {
-    return "cursor";
-  }
-  if (options.claudeInstalled) {
-    return "claude";
-  }
-  if (options.codexInstalled) {
-    return "codex";
-  }
-  if (options.kiroInstalled === true) {
-    return "kiro";
-  }
-  if (options.kimiInstalled === true) {
-    return "kimi";
-  }
-  if (options.grokInstalled === true) {
-    return "grok";
-  }
-  if (options.devinInstalled === true) {
-    return "devin";
-  }
-  return null;
-};
+import { spawnSync as spawnSync8 } from "child_process";
+import process21 from "process";
 
 // src/doctor/agentExperience.ts
-import { spawnSync as spawnSync3 } from "child_process";
+import { spawnSync as spawnSync4 } from "child_process";
 import { accessSync, constants } from "fs";
 import { homedir } from "os";
-import { join as join35 } from "path";
+import { join as join37 } from "path";
 
 // src/doctor/mcpWire.ts
-import { spawnSync as spawnSync2 } from "child_process";
+import { spawnSync as spawnSync3 } from "child_process";
 import { existsSync as existsSync7, mkdirSync as mkdirSync8, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
-import { dirname as dirname13, join as join34 } from "path";
+import { dirname as dirname14, join as join36 } from "path";
 var CATALOG_RELATIVE_PATHS = [
-  join34(".claude", "mcp", "mcp-servers.json"),
+  join36(".claude", "mcp", "mcp-servers.json"),
   "mcp-servers.json"
 ];
 var defaultCommandExists = (command) => {
-  const version = spawnSync2(command, ["--version"], { stdio: "ignore" });
+  const version = spawnSync3(command, ["--version"], { stdio: "ignore" });
   if (version.status === 0) {
     return true;
   }
-  const help = spawnSync2(command, ["--help"], { stdio: "ignore" });
+  const help = spawnSync3(command, ["--help"], { stdio: "ignore" });
   return help.status === 0 || help.error === void 0;
 };
 var createDefaultMcpWireDeps = () => ({
@@ -18587,7 +19405,7 @@ var createDefaultMcpWireDeps = () => ({
   },
   commandExists: defaultCommandExists,
   spawn: (command, args, options) => {
-    const result = spawnSync2(command, [...args], {
+    const result = spawnSync3(command, [...args], {
       stdio: "ignore",
       cwd: options?.cwd,
       timeout: 8e3,
@@ -18597,8 +19415,8 @@ var createDefaultMcpWireDeps = () => ({
   }
 });
 var findMcpCatalogPath = (cwd, pathExists9) => {
-  for (const relative4 of CATALOG_RELATIVE_PATHS) {
-    const absolute = join34(cwd, relative4);
+  for (const relative6 of CATALOG_RELATIVE_PATHS) {
+    const absolute = join36(cwd, relative6);
     if (pathExists9(absolute)) {
       return absolute;
     }
@@ -18745,7 +19563,7 @@ var writeMergedMcpConfig = (configPath, core, deps) => {
   if (added.length === 0 && deps.pathExists(configPath)) {
     return { written: false, added: [] };
   }
-  deps.mkdir(dirname13(configPath));
+  deps.mkdir(dirname14(configPath));
   deps.writeFile(configPath, formatMcpServersConfig(config));
   return { written: true, added };
 };
@@ -18803,7 +19621,7 @@ var wireCoreMcps = (cwd, agents, deps = createDefaultMcpWireDeps()) => {
   let anyFailure = false;
   for (const agent of capable) {
     if (agent.id === "cursor") {
-      const configPath = join34(cwd, ".cursor", "mcp.json");
+      const configPath = join36(cwd, ".cursor", "mcp.json");
       try {
         const { written, added } = writeMergedMcpConfig(configPath, core, deps);
         agentsWired.push("cursor");
@@ -18821,7 +19639,7 @@ var wireCoreMcps = (cwd, agents, deps = createDefaultMcpWireDeps()) => {
       continue;
     }
     if (agent.id === "claude-code") {
-      const configPath = join34(cwd, ".mcp.json");
+      const configPath = join36(cwd, ".mcp.json");
       try {
         const { written, added } = writeMergedMcpConfig(configPath, core, deps);
         if (written && added.length > 0) {
@@ -18859,11 +19677,11 @@ var wireCoreMcps = (cwd, agents, deps = createDefaultMcpWireDeps()) => {
 
 // src/doctor/agentExperience.ts
 var defaultCommandExists2 = (command) => {
-  const version = spawnSync3(command, ["--version"], { stdio: "ignore" });
+  const version = spawnSync4(command, ["--version"], { stdio: "ignore" });
   if (version.status === 0) {
     return true;
   }
-  const help = spawnSync3(command, ["--help"], { stdio: "ignore" });
+  const help = spawnSync4(command, ["--help"], { stdio: "ignore" });
   return help.status === 0 || help.error === void 0;
 };
 var defaultPathExists = (path) => {
@@ -18910,22 +19728,22 @@ var detectPresentAgents = (cwd, deps = createDefaultAgentExperienceDeps()) => {
     add("gemini");
   }
   const home = homedir();
-  if (deps.pathExists(join35(home, ".claude"))) {
+  if (deps.pathExists(join37(home, ".claude"))) {
     add("claude-code");
   }
-  if (deps.pathExists(join35(home, ".codex"))) {
+  if (deps.pathExists(join37(home, ".codex"))) {
     add("codex");
   }
-  if (deps.pathExists(join35(home, ".cursor"))) {
+  if (deps.pathExists(join37(home, ".cursor"))) {
     add("cursor");
   }
-  if (deps.pathExists(join35(cwd, ".claude"))) {
+  if (deps.pathExists(join37(cwd, ".claude"))) {
     add("claude-code");
   }
-  if (deps.pathExists(join35(cwd, ".cursor"))) {
+  if (deps.pathExists(join37(cwd, ".cursor"))) {
     add("cursor");
   }
-  if (deps.pathExists(join35(cwd, "AGENTS.md"))) {
+  if (deps.pathExists(join37(cwd, "AGENTS.md"))) {
     add("codex");
   }
   if (found.size === 0) {
@@ -18951,7 +19769,7 @@ var runAgentExperience = async (cwd, options, deps = createDefaultAgentExperienc
   let ok = true;
   const names = agents.map((agent) => agent.name).join(", ");
   lines.push(`\u2713 agents detected - ${names}`);
-  const hasProjectSkills = deps.pathExists(join35(cwd, ".agents", "skills")) || deps.pathExists(join35(cwd, "platform-skills.manifest.json")) || deps.pathExists(join35(cwd, "skills-lock.json"));
+  const hasProjectSkills = deps.pathExists(join37(cwd, ".agents", "skills")) || deps.pathExists(join37(cwd, "platform-skills.manifest.json")) || deps.pathExists(join37(cwd, "skills-lock.json"));
   if (hasProjectSkills) {
     try {
       await deps.ensureProjectSkillLinks(cwd);
@@ -19003,17 +19821,17 @@ var runAgentExperience = async (cwd, options, deps = createDefaultAgentExperienc
       );
     }
   }
-  const kitRootAgentMcp = join35(cwd, "packages", "agentMcp");
-  const surfaceAgentMcp = join35(cwd, "..", "..", "packages", "agentMcp");
+  const kitRootAgentMcp = join37(cwd, "packages", "agentMcp");
+  const surfaceAgentMcp = join37(cwd, "..", "..", "packages", "agentMcp");
   const hasKitRootMcp = deps.pathExists(kitRootAgentMcp);
   const hasSurfaceMcp = deps.pathExists(surfaceAgentMcp);
   if (hasKitRootMcp || hasSurfaceMcp) {
     try {
       const layout = hasKitRootMcp ? "kit-root" : "surface";
       const template = layout === "kit-root" ? ["web", "mobile", "extension", "backend", "spa"].find(
-        (name) => deps.pathExists(join35(cwd, "templates", name))
+        (name) => deps.pathExists(join37(cwd, "templates", name))
       ) : void 0;
-      const configPaths = [join35(cwd, ".cursor", "mcp.json"), join35(cwd, ".mcp.json")];
+      const configPaths = [join37(cwd, ".cursor", "mcp.json"), join37(cwd, ".mcp.json")];
       for (const configPath of configPaths) {
         await writeFirstPartyMcpConfigFile(
           configPath,
@@ -19035,7 +19853,7 @@ var runAgentExperience = async (cwd, options, deps = createDefaultAgentExperienc
 
 // src/doctor/assetsValidate.ts
 import { existsSync as existsSync8, readFileSync as readFileSync8 } from "fs";
-import { join as join36 } from "path";
+import { join as join38 } from "path";
 var ASSET_SURFACE_DIRS = {
   web: "public",
   spa: "public",
@@ -19056,9 +19874,9 @@ var OPTIMIZE_FILE_CANDIDATES = [
   "scripts/optimize.ts"
 ];
 var createDefaultAssetsValidateDeps = (cwd) => ({
-  exists: (relativePath) => existsSync8(join36(cwd, relativePath)),
+  exists: (relativePath) => existsSync8(join38(cwd, relativePath)),
   readUtf8: (relativePath) => {
-    const absolute = join36(cwd, relativePath);
+    const absolute = join38(cwd, relativePath);
     if (!existsSync8(absolute)) {
       return null;
     }
@@ -19197,35 +20015,35 @@ var verifyAssetsPipeline = (cwd, surface = inferProjectSurfaceSync(cwd), deps =
 
 // src/global/globalPaths.ts
 import { homedir as homedir2 } from "os";
-import { dirname as dirname14, join as join37 } from "path";
-import process17 from "process";
+import { dirname as dirname15, join as join39 } from "path";
+import process19 from "process";
 import { fileURLToPath as fileURLToPath7 } from "url";
-var MODULE_DIR = dirname14(fileURLToPath7(import.meta.url));
+var MODULE_DIR = dirname15(fileURLToPath7(import.meta.url));
 var resolveConfigDir = () => {
-  const override = process17.env.CLAUDE_CONFIG_DIR;
+  const override = process19.env.CLAUDE_CONFIG_DIR;
   if (override !== void 0 && override.trim() !== "") {
     return override.trim();
   }
-  return join37(homedir2(), ".claude");
+  return join39(homedir2(), ".claude");
 };
 var resolveGlobalPaths = (configDir = resolveConfigDir()) => ({
   configDir,
-  skillsDir: join37(configDir, "skills"),
-  commandsDir: join37(configDir, "commands"),
-  memoryFile: join37(configDir, "CLAUDE.md"),
-  settingsFile: join37(configDir, "settings.json"),
+  skillsDir: join39(configDir, "skills"),
+  commandsDir: join39(configDir, "commands"),
+  memoryFile: join39(configDir, "CLAUDE.md"),
+  settingsFile: join39(configDir, "settings.json"),
   // At runtime this module is inlined into dist/bin.js, so MODULE_DIR is <install>/dist
   // and the payload sits beside it at dist/global-skills.
-  bundledSkillsDir: join37(MODULE_DIR, "global-skills")
+  bundledSkillsDir: join39(MODULE_DIR, "global-skills")
 });
 
 // src/global/globalStatus.ts
-import { readFile as readFile15, stat as stat2 } from "fs/promises";
-import { join as join39 } from "path";
+import { readFile as readFile18, stat as stat2 } from "fs/promises";
+import { join as join41 } from "path";
 
 // src/global/managedSkills.ts
-import { readdir as readdir8, stat } from "fs/promises";
-import { join as join38 } from "path";
+import { readdir as readdir9, stat } from "fs/promises";
+import { join as join40 } from "path";
 var GLOBAL_SKILL_SAMPLE_SIZE = 5;
 var MANAGED_SKILL_MARKER = ".vybekiit-managed";
 var exists = async (path) => {
@@ -19238,13 +20056,13 @@ var exists = async (path) => {
 };
 var listManagedSkillNames = async (skillsDir) => {
   try {
-    const entries = await readdir8(skillsDir, { withFileTypes: true });
+    const entries = await readdir9(skillsDir, { withFileTypes: true });
     const names = [];
     for (const entry of entries) {
       if (!entry.isDirectory()) {
         continue;
       }
-      if (await exists(join38(skillsDir, entry.name, MANAGED_SKILL_MARKER))) {
+      if (await exists(join40(skillsDir, entry.name, MANAGED_SKILL_MARKER))) {
         names.push(entry.name);
       }
     }
@@ -19259,6 +20077,7 @@ var sampleManagedSkillNames = (names, size = GLOBAL_SKILL_SAMPLE_SIZE) => {
     return [];
   }
   const preferred = [
+    "feedback",
     "onboarding",
     "plan-my-idea",
     "setup-payments",
@@ -19284,13 +20103,13 @@ var exists2 = async (path) => {
 var readGlobalStatus = async (paths) => {
   let hasMemory = false;
   try {
-    hasMemory = (await readFile15(paths.memoryFile, "utf8")).includes("BEGIN VYBEKIIT");
+    hasMemory = (await readFile18(paths.memoryFile, "utf8")).includes("BEGIN VYBEKIIT");
   } catch {
     hasMemory = false;
   }
   const managed = await listManagedSkillNames(paths.skillsDir);
   return {
-    hasCommand: await exists2(join39(paths.commandsDir, "vybekiit.md")),
+    hasCommand: await exists2(join41(paths.commandsDir, "vybekiit.md")),
     hasMemory,
     skillCount: managed.length,
     skillSample: sampleManagedSkillNames(managed)
@@ -19309,9 +20128,9 @@ var formatGlobalStatus = (status) => {
 };
 
 // src/doctor/codexConfig.ts
-import { access as access13, mkdir as mkdir9, readFile as readFile16, writeFile as writeFile10 } from "fs/promises";
+import { access as access14, mkdir as mkdir11, readFile as readFile19, writeFile as writeFile13 } from "fs/promises";
 import { homedir as homedir3 } from "os";
-import { join as join40 } from "path";
+import { join as join42 } from "path";
 var FEATURES_BLOCK = ["[features]", "skills = true"].join("\n");
 var FEATURES_SKILLS_ENABLED_PATTERN = /\[features\][\s\S]*?\bskills\s*=\s*true\b/m;
 var FEATURES_BLOCK_PATTERN = /(\[features\][^[]*)/m;
@@ -19320,10 +20139,10 @@ var SKILLS_LINE_PATTERN = /\bskills\s*=\s*.*/m;
 var codexConfigPath = () => {
   const configuredHome = process.env.CODEX_HOME;
   if (configuredHome !== void 0 && configuredHome.trim() !== "") {
-    return join40(configuredHome.trim(), "config.toml");
+    return join42(configuredHome.trim(), "config.toml");
   }
-  const home = join40(homedir3(), ".codex");
-  return join40(home, "config.toml");
+  const home = join42(homedir3(), ".codex");
+  return join42(home, "config.toml");
 };
 var upsertFeaturesSkills = (content) => {
   if (FEATURES_SKILLS_ENABLED_PATTERN.test(content)) {
@@ -19349,10 +20168,10 @@ ${FEATURES_BLOCK}
 };
 var ensureCodexSkillsEnabled = async () => {
   const path = codexConfigPath();
-  await mkdir9(join40(path, ".."), { recursive: true });
+  await mkdir11(join42(path, ".."), { recursive: true });
   let previous = "";
   try {
-    previous = await readFile16(path, "utf8");
+    previous = await readFile19(path, "utf8");
   } catch (error) {
     if (!(error instanceof Error && "code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -19362,13 +20181,13 @@ var ensureCodexSkillsEnabled = async () => {
   if (next === previous) {
     return { updated: false, path };
   }
-  await writeFile10(path, next, "utf8");
+  await writeFile13(path, next, "utf8");
   return { updated: true, path };
 };
 
 // src/doctor/kitWorkspaceHealth.ts
 import { existsSync as existsSync9, readdirSync as readdirSync2, readFileSync as readFileSync9, statSync as statSync2 } from "fs";
-import { join as join41 } from "path";
+import { join as join43 } from "path";
 var readPackageJsonSafe = (packageJsonPath) => {
   if (!existsSync9(packageJsonPath)) {
     return null;
@@ -19401,7 +20220,7 @@ var listPackageRelDirs = (packagesRoot) => {
   const top = readdirSync2(packagesRoot);
   const rels = [];
   for (const entry of top) {
-    const abs = join41(packagesRoot, entry);
+    const abs = join43(packagesRoot, entry);
     let isDir = false;
     try {
       isDir = statSync2(abs).isDirectory();
@@ -19411,7 +20230,7 @@ var listPackageRelDirs = (packagesRoot) => {
     if (!isDir) {
       continue;
     }
-    if (existsSync9(join41(abs, "package.json"))) {
+    if (existsSync9(join43(abs, "package.json"))) {
       rels.push(entry);
       continue;
     }
@@ -19422,10 +20241,10 @@ var listPackageRelDirs = (packagesRoot) => {
       continue;
     }
     for (const child of nested) {
-      const childAbs = join41(abs, child);
+      const childAbs = join43(abs, child);
       try {
-        if (statSync2(childAbs).isDirectory() && existsSync9(join41(childAbs, "package.json"))) {
-          rels.push(join41(entry, child));
+        if (statSync2(childAbs).isDirectory() && existsSync9(join43(childAbs, "package.json"))) {
+          rels.push(join43(entry, child));
         }
       } catch {
       }
@@ -19434,15 +20253,15 @@ var listPackageRelDirs = (packagesRoot) => {
   return rels;
 };
 var findMissingDistPackages = (cwd) => {
-  const packagesRoot = join41(cwd, "packages");
+  const packagesRoot = join43(cwd, "packages");
   const missing = [];
   for (const relDir of listPackageRelDirs(packagesRoot)) {
-    const packageDir = join41(packagesRoot, relDir);
-    const pkg = readPackageJsonSafe(join41(packageDir, "package.json"));
+    const packageDir = join43(packagesRoot, relDir);
+    const pkg = readPackageJsonSafe(join43(packageDir, "package.json"));
     if (pkg === null || !packageExpectsDist(pkg)) {
       continue;
     }
-    if (!existsSync9(join41(packageDir, "dist"))) {
+    if (!existsSync9(join43(packageDir, "dist"))) {
       const name = typeof pkg.name === "string" ? pkg.name : relDir;
       missing.push({ name, relDir });
     }
@@ -19450,7 +20269,7 @@ var findMissingDistPackages = (cwd) => {
   return missing;
 };
 var verifyKitWorkspaceHealth = (cwd) => {
-  const packagesRoot = join41(cwd, "packages");
+  const packagesRoot = join43(cwd, "packages");
   if (!existsSync9(packagesRoot)) {
     return { ok: true, lines: [] };
   }
@@ -19468,7 +20287,7 @@ var verifyKitWorkspaceHealth = (cwd) => {
     );
   }
   const buildRoots = ["tsconfig.base.json", "scripts/lib/tsupWorkspaceAliases.mjs"];
-  const missingRoots = buildRoots.filter((rel) => !existsSync9(join41(cwd, rel)));
+  const missingRoots = buildRoots.filter((rel) => !existsSync9(join43(cwd, rel)));
   if (missingRoots.length > 0 && missing.length > 0) {
     lines.push(
       `\u2717 Kit is also missing rebuild helpers (${missingRoots.join(", ")}). Re-run \`vybekiit create app\` with a current CLI so build roots ship with the workspace.`
@@ -19528,12 +20347,12 @@ var verifyMobilePublishReadiness = (platform, env, probe) => {
   }
   return { ok, lines };
 };
-var createDefaultCommandProbe = (spawnSync9) => ({
+var createDefaultCommandProbe = (spawnSync10) => ({
   succeeds(command, args) {
-    return spawnSync9(command, args, { encoding: "utf8", stdio: "pipe" }).status === 0;
+    return spawnSync10(command, args, { encoding: "utf8", stdio: "pipe" }).status === 0;
   },
   output(command, args) {
-    const result = spawnSync9(command, args, { encoding: "utf8", stdio: "pipe" });
+    const result = spawnSync10(command, args, { encoding: "utf8", stdio: "pipe" });
     return `${result.stdout}
 ${result.stderr}`.trim();
   }
@@ -19617,11 +20436,11 @@ var mergeDoctorTools = (providerTools, nativeTools) => {
 
 // src/doctor/perfReadiness.ts
 import { existsSync as existsSync10, readFileSync as readFileSync10 } from "fs";
-import { join as join42 } from "path";
+import { join as join44 } from "path";
 var createDefaultPerfReadinessDeps = (cwd) => ({
-  exists: (relativePath) => existsSync10(join42(cwd, relativePath)),
+  exists: (relativePath) => existsSync10(join44(cwd, relativePath)),
   readUtf8: (relativePath) => {
-    const absolute = join42(cwd, relativePath);
+    const absolute = join44(cwd, relativePath);
     if (!existsSync10(absolute)) {
       return null;
     }
@@ -19754,17 +20573,17 @@ var reportFor = (reports, name) => reports.find((r) => r.tool === name);
 
 // src/doctor/platformSkills.ts
 import { existsSync as existsSync11, readFileSync as readFileSync11 } from "fs";
-import { join as join43 } from "path";
-import process18 from "process";
+import { join as join45 } from "path";
+import process20 from "process";
 var readManifest = (cwd) => {
-  const path = join43(cwd, "platform-skills.manifest.json");
+  const path = join45(cwd, "platform-skills.manifest.json");
   if (!existsSync11(path)) {
     return null;
   }
   return JSON.parse(readFileSync11(path, "utf8"));
 };
 var readSkillsLock = (cwd) => {
-  const path = join43(cwd, "skills-lock.json");
+  const path = join45(cwd, "skills-lock.json");
   if (!existsSync11(path)) {
     return null;
   }
@@ -19774,7 +20593,7 @@ var readSkillsLock = (cwd) => {
     return null;
   }
 };
-var skillFileExists = (cwd, name) => existsSync11(join43(cwd, ".agents", "skills", name, "SKILL.md"));
+var skillFileExists = (cwd, name) => existsSync11(join45(cwd, ".agents", "skills", name, "SKILL.md"));
 var verifyPlatformSkills = (cwd) => {
   const manifest = readManifest(cwd);
   if (manifest === null) {
@@ -19798,7 +20617,7 @@ var verifyPlatformSkills = (cwd) => {
   };
 };
 var templateLabelForPlatformSkills = (cwd) => {
-  if (!existsSync11(join43(cwd, "platform-skills.manifest.json"))) {
+  if (!existsSync11(join45(cwd, "platform-skills.manifest.json"))) {
     return null;
   }
   return inferProjectSurfaceSync(cwd).template;
@@ -19808,7 +20627,7 @@ var formatPlatformSkillsReport = (report) => {
     return [];
   }
   const lines = [];
-  const lockPath = join43(process18.cwd(), "skills-lock.json");
+  const lockPath = join45(process20.cwd(), "skills-lock.json");
   if (existsSync11(lockPath)) {
     try {
       const lock = JSON.parse(readFileSync11(lockPath, "utf8"));
@@ -19865,10 +20684,10 @@ var formatProductSurfaceHints = (env) => {
 
 // src/doctor/projectHealth.ts
 import { existsSync as existsSync12, readFileSync as readFileSync12 } from "fs";
-import { join as join44 } from "path";
+import { join as join46 } from "path";
 var GITIGNORE_ENV_LINE_PATTERN = /^\.env/m;
 var gitignoreCoversEnv = (cwd) => {
-  const path = join44(cwd, ".gitignore");
+  const path = join46(cwd, ".gitignore");
   if (!existsSync12(path)) {
     return false;
   }
@@ -19876,7 +20695,7 @@ var gitignoreCoversEnv = (cwd) => {
   return GITIGNORE_ENV_LINE_PATTERN.test(content) || content.includes(".env\n") || content.includes(".env\r\n");
 };
 var cursorignoreCoversEnv = (cwd) => {
-  const path = join44(cwd, ".cursorignore");
+  const path = join46(cwd, ".cursorignore");
   if (!existsSync12(path)) {
     return false;
   }
@@ -19904,7 +20723,7 @@ var verifyProjectHealth = (cwd) => {
 };
 
 // src/doctor/railwayAgentSetup.ts
-import { spawnSync as spawnSync4 } from "child_process";
+import { spawnSync as spawnSync5 } from "child_process";
 var isRailwayStackActive2 = (env) => isRailwayStackActive(env);
 var verifyCoupledStack = (env) => {
   const { HOSTING_PROVIDER } = parseEnv(hostingConfigSchema, env);
@@ -19932,7 +20751,7 @@ var runRailwayAgentSetup = (railwayInstalled, railwayAuthed) => {
       message: "\u2192 Railway agent setup skipped - sign in with `railway login` first."
     };
   }
-  const result = spawnSync4("railway", ["setup", "agent", "-y"], {
+  const result = spawnSync5("railway", ["setup", "agent", "-y"], {
     stdio: "pipe",
     encoding: "utf8"
   });
@@ -19964,17 +20783,17 @@ var formatRailwayStackReport = (env, agentSetup) => {
 };
 
 // src/doctor/runNativeProjectSetup.ts
-import { spawnSync as spawnSync5 } from "child_process";
+import { spawnSync as spawnSync6 } from "child_process";
 import { existsSync as existsSync13 } from "fs";
-import { join as join45 } from "path";
+import { join as join47 } from "path";
 var runCommand = (options) => {
   const { args, command, cwd, label, log } = options;
   log.log(`[doctor] ${label}: ${command} ${args.join(" ")}`);
-  const result = spawnSync5(command, [...args], { cwd, stdio: "inherit" });
+  const result = spawnSync6(command, [...args], { cwd, stdio: "inherit" });
   return result.status === 0;
 };
 var runExtensionSetup = (cwd, log) => {
-  const wxtTypes = join45(cwd, ".wxt", "wxt.d.ts");
+  const wxtTypes = join47(cwd, ".wxt", "wxt.d.ts");
   if (existsSync13(wxtTypes)) {
     return ["\u2713 Extension - WXT types already generated."];
   }
@@ -19993,7 +20812,7 @@ var runMobileSetup = (cwd, platform, log) => {
   if (platform !== "darwin") {
     return [];
   }
-  const podfile = join45(cwd, "ios", "Podfile");
+  const podfile = join47(cwd, "ios", "Podfile");
   if (!existsSync13(podfile)) {
     return [
       "\u2192 Mobile - no `ios/` folder yet. Run `pnpm ios` (Simulator) or `npx expo prebuild --platform ios` before store builds."
@@ -20002,7 +20821,7 @@ var runMobileSetup = (cwd, platform, log) => {
   const ok = runCommand({
     log,
     label: "installing iOS pods",
-    cwd: join45(cwd, "ios"),
+    cwd: join47(cwd, "ios"),
     command: "pod",
     args: ["install"]
   });
@@ -20025,16 +20844,16 @@ var runNativeProjectSetup = (cwd, surface, platform, log = console) => {
 };
 
 // src/doctor/storageR2.ts
-import { spawnSync as spawnSync6 } from "child_process";
+import { spawnSync as spawnSync7 } from "child_process";
 import { readFileSync as readFileSync13 } from "fs";
-import { join as join46 } from "path";
+import { join as join48 } from "path";
 var R2_BUCKET_UNSAFE_PATTERN = /[^a-z0-9-]/g;
 var R2_BUCKET_DASH_RUN_PATTERN = /-+/g;
 var R2_BUCKET_EDGE_DASH_PATTERN = /^-|-$/g;
 var sanitizeBucketName = (name) => name.toLowerCase().replace(R2_BUCKET_UNSAFE_PATTERN, "-").replace(R2_BUCKET_DASH_RUN_PATTERN, "-").replace(R2_BUCKET_EDGE_DASH_PATTERN, "").slice(0, 40);
 var readProjectName = (cwd) => {
   try {
-    const pkg = JSON.parse(readFileSync13(join46(cwd, "package.json"), "utf8"));
+    const pkg = JSON.parse(readFileSync13(join48(cwd, "package.json"), "utf8"));
     if (pkg.name !== void 0 && pkg.name !== "" && pkg.name !== "my-vybekiit-app") {
       return sanitizeBucketName(pkg.name);
     }
@@ -20042,7 +20861,7 @@ var readProjectName = (cwd) => {
   }
   return "vybekiit-app";
 };
-var wranglerOk = (args) => spawnSync6("wrangler", [...args], { stdio: "ignore" }).status === 0;
+var wranglerOk = (args) => spawnSync7("wrangler", [...args], { stdio: "ignore" }).status === 0;
 var createR2ApiToken = async (accountId, apiToken, bucketName) => {
   const response = await fetch(
     `https://api.cloudflare.com/client/v4/accounts/${accountId}/r2/tokens`,
@@ -20601,12 +21420,12 @@ var verifyPresetsDoctor = async (env) => {
 
 // src/doctor/run.ts
 var toPlatform = (platform) => platform === "darwin" || platform === "win32" || platform === "linux" ? platform : null;
-var isCursorSession = () => Boolean(process19.env.CURSOR_TRACE_ID || process19.env.CURSOR_SESSION_ID);
-var succeeds = (command, args) => spawnSync7(command, [...args], { stdio: "ignore" }).status === 0;
+var isCursorSession2 = () => Boolean(process21.env.CURSOR_TRACE_ID || process21.env.CURSOR_SESSION_ID);
+var succeeds2 = (command, args) => spawnSync8(command, [...args], { stdio: "ignore" }).status === 0;
 var errorCode = (error) => error !== void 0 && "code" in error && typeof error.code === "string" ? error.code : void 0;
 var runInstall = (action, log) => {
   log.log(`[doctor] setting up ${action.tool}: ${action.command} ${action.args.join(" ")}`);
-  const result = spawnSync7(action.command, [...action.args], { stdio: "inherit" });
+  const result = spawnSync8(action.command, [...action.args], { stdio: "inherit" });
   if (errorCode(result.error) === "ENOENT") {
     return action.requires ? { ok: false, missingRequirement: action.requires } : { ok: false };
   }
@@ -20630,7 +21449,7 @@ var buildReport = (tool, presence, installs) => {
   if (tool.auth === void 0) {
     return { tool: tool.name, purpose: tool.purpose, installed: true, authed: null };
   }
-  const authed = succeeds(tool.auth.command, tool.auth.args);
+  const authed = succeeds2(tool.auth.command, tool.auth.args);
   return {
     tool: tool.name,
     purpose: tool.purpose,
@@ -20654,7 +21473,7 @@ var runToolchain = (platform, surface, env, log) => {
   const toolchain = mergeAgentAndProviderTools(providerAndNative);
   const presence = toolchain.map((tool) => ({
     tool: tool.name,
-    present: succeeds(tool.name, tool.versionArgs)
+    present: succeeds2(tool.name, tool.versionArgs)
   }));
   const installs = /* @__PURE__ */ new Map();
   for (const action of planInstall(platform, presence, toolchain)) {
@@ -20670,7 +21489,7 @@ var verifyMobilePublishing = (platform, env, mobile, log) => {
   if (!mobile) {
     return true;
   }
-  const report = verifyMobilePublishReadiness(platform, env, createDefaultCommandProbe(spawnSync7));
+  const report = verifyMobilePublishReadiness(platform, env, createDefaultCommandProbe(spawnSync8));
   writeLines(log, report.lines);
   return report.ok;
 };
@@ -20729,15 +21548,15 @@ var writeReportModeAssistant = (options) => {
   }
 };
 var runDoctor = async (log = console) => {
-  const platform = toPlatform(process19.platform);
+  const platform = toPlatform(process21.platform);
   if (platform === null) {
-    log.error(`[doctor] This operating system (${process19.platform}) isn't supported yet.`);
+    log.error(`[doctor] This operating system (${process21.platform}) isn't supported yet.`);
     return 1;
   }
-  const cwd = process19.cwd();
+  const cwd = process21.cwd();
   const surface = inferProjectSurfaceSync(cwd);
-  const env = mergeEnv(process19.env, loadEnvFile2(cwd));
-  const cursorSession = isCursorSession();
+  const env = mergeEnv(process21.env, loadEnvFile2(cwd));
+  const cursorSession = isCursorSession2();
   if (cursorSession) {
     log.log("\u2713 Cursor - you're in Cursor; no separate agent install needed.");
   }
@@ -20777,13 +21596,57 @@ var runDoctor = async (log = console) => {
   });
 };
 
+// src/global/installState.ts
+import { mkdir as mkdir12, readFile as readFile20, writeFile as writeFile14 } from "fs/promises";
+import { join as join49 } from "path";
+var INSTALL_STATE_FILENAME = ".vybekiit-install.json";
+var installStatePath = (configDir) => join49(configDir, INSTALL_STATE_FILENAME);
+var readInstallState = async (configDir) => {
+  try {
+    const raw = await readFile20(installStatePath(configDir), "utf8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.version !== "string" || parsed.version === "") {
+      return null;
+    }
+    if (typeof parsed.updatedAt !== "string" || parsed.updatedAt === "") {
+      return null;
+    }
+    const firstAppPath = typeof parsed.firstAppPath === "string" && parsed.firstAppPath !== "" ? parsed.firstAppPath : void 0;
+    return {
+      version: parsed.version,
+      updatedAt: parsed.updatedAt,
+      ...firstAppPath === void 0 ? {} : { firstAppPath }
+    };
+  } catch {
+    return null;
+  }
+};
+var writeInstallState = async (configDir, version, options = {}, now = () => /* @__PURE__ */ new Date()) => {
+  const previous = await readInstallState(configDir);
+  let firstAppPath = previous?.firstAppPath;
+  if (options.clearFirstAppPath === true) {
+    firstAppPath = void 0;
+  } else if (options.firstAppPath !== void 0 && options.firstAppPath !== "") {
+    firstAppPath = options.firstAppPath;
+  }
+  const state = {
+    version,
+    updatedAt: now().toISOString(),
+    ...firstAppPath === void 0 ? {} : { firstAppPath }
+  };
+  await mkdir12(configDir, { recursive: true });
+  await writeFile14(installStatePath(configDir), `${JSON.stringify(state, null, 2)}
+`, "utf8");
+  return state;
+};
+
 // src/global/runGlobalInstall.ts
-import process21 from "process";
-import { confirm, isCancel as isCancel2 } from "@clack/prompts";
+import process24 from "process";
+import { confirm as confirm2, isCancel as isCancel3 } from "@clack/prompts";
 
 // src/global/awareness.ts
-import { mkdir as mkdir10, readFile as readFile17, writeFile as writeFile11 } from "fs/promises";
-import { dirname as dirname15 } from "path";
+import { mkdir as mkdir13, readFile as readFile21, writeFile as writeFile15 } from "fs/promises";
+import { dirname as dirname16 } from "path";
 var BEGIN_MARKER = "<!-- BEGIN VYBEKIIT (managed by `vybekiit setup`) -->";
 var END_MARKER = "<!-- END VYBEKIIT -->";
 var LEADING_NEWLINE = /^\n/;
@@ -20796,8 +21659,10 @@ Do this now, briefly:
 1. Say: "\u2705 VybeKiit is active \u2014 you have its skills and browser automation in every project."
 2. Read the skill names under ~/.claude/skills and name 4-5 useful ones (for example: onboarding,
    plan-my-idea, setup-payments, add-signin, go-live).
-3. If there is no app in the current folder yet, offer to run \`vybekiit create app --web\`.
-   Otherwise ask what they want to build or change next.
+3. If there is no app in the current folder yet, check for ~/vybekiit-app (first-install default).
+   If it exists, offer to open that folder and run onboarding. Otherwise offer
+   \`vybekiit create app --web\`. If they are already in an app folder, ask what they want next.
+4. Mention Report mode once if they are in an app: Option+Shift+R (Alt+Shift+R on Windows).
 
 Keep it short and friendly. Do not dump the whole skill list.
 `;
@@ -20806,7 +21671,10 @@ var buildMemoryBlock = () => [
   "## VybeKiit is active on this machine",
   "",
   "VybeKiit is installed globally: its skills live in `~/.claude/skills`, and the `playwright`",
-  "and `context7` MCP servers are registered (browser automation + live library docs).",
+  "and `context7` MCP servers are registered (browser automation, live library docs). Key-gated",
+  "servers like `sentry`, `github`, and `stripe` register once their API key is set (run",
+  "`vybekiit env wizard`). Inside a scaffolded app (`vybekiit create app`), a project-scoped",
+  "`vybekiit` MCP server adds the kit tools (UI catalog, skills, browser automations).",
   "",
   "At the start of a session in any project, briefly tell the user VybeKiit is available, and use",
   "its skills (onboarding, plan-my-idea, setup-payments, add-signin, go-live, harden, \u2026) when they",
@@ -20831,7 +21699,7 @@ ${block}`;
 };
 var readOrEmpty = async (path) => {
   try {
-    return await readFile17(path, "utf8");
+    return await readFile21(path, "utf8");
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       return "";
@@ -20843,8 +21711,8 @@ var writeIfChanged = async (path, next, previous) => {
   if (next === previous) {
     return false;
   }
-  await mkdir10(dirname15(path), { recursive: true });
-  await writeFile11(path, next, "utf8");
+  await mkdir13(dirname16(path), { recursive: true });
+  await writeFile15(path, next, "utf8");
   return true;
 };
 var STATUSLINE_BADGE = "\u25C6 vybekiit";
@@ -20903,20 +21771,20 @@ var installAwareness = async (paths) => {
 };
 
 // src/global/cliVersion.ts
-import { readFile as readFile18 } from "fs/promises";
-import { dirname as dirname16, join as join47 } from "path";
+import { readFile as readFile22 } from "fs/promises";
+import { dirname as dirname17, join as join50 } from "path";
 import { fileURLToPath as fileURLToPath8 } from "url";
-var MODULE_DIR2 = dirname16(fileURLToPath8(import.meta.url));
+var MODULE_DIR2 = dirname17(fileURLToPath8(import.meta.url));
 var readCliVersion = async () => {
   const candidates = [
     // Published layout: dist/*.js → cli/package.json
-    join47(MODULE_DIR2, "..", "package.json"),
+    join50(MODULE_DIR2, "..", "package.json"),
     // Source layout: src/global/*.ts → cli/package.json
-    join47(MODULE_DIR2, "..", "..", "package.json")
+    join50(MODULE_DIR2, "..", "..", "package.json")
   ];
   for (const candidate of candidates) {
     try {
-      const raw = await readFile18(candidate, "utf8");
+      const raw = await readFile22(candidate, "utf8");
       const parsed = JSON.parse(raw);
       if (parsed.version !== void 0 && parsed.version !== "") {
         return parsed.version;
@@ -21004,15 +21872,14 @@ var formatEntitlementBlock = (result) => {
 };
 
 // src/global/installGlobalMcp.ts
-import process20 from "process";
+import process22 from "process";
 var ZERO_CONFIG = [
   {
     name: "playwright",
     transport: "stdio",
-    command: ["npx", "-y", "@anthropic-ai/mcp-playwright"]
+    command: ["npx", "-y", "@playwright/mcp@latest"]
   },
-  { name: "context7", transport: "stdio", command: ["npx", "-y", "@upstash/context7-mcp@latest"] },
-  { name: "sentry", transport: "sse", command: ["https://mcp.sentry.dev/sse"] }
+  { name: "context7", transport: "stdio", command: ["npx", "-y", "@upstash/context7-mcp@latest"] }
 ];
 var KEY_GATED = [
   {
@@ -21024,32 +21891,28 @@ var KEY_GATED = [
   {
     name: "supabase",
     transport: "stdio",
-    command: ["npx", "-y", "supabase-mcp-server"],
+    command: ["npx", "-y", "@supabase/mcp-server-supabase@latest"],
     envKeys: ["SUPABASE_ACCESS_TOKEN"]
   },
-  {
-    name: "vercel",
-    transport: "stdio",
-    command: ["npx", "-y", "@vercel/mcp"],
-    envKeys: ["VERCEL_TOKEN"]
-  },
   {
     name: "stripe",
     transport: "stdio",
-    command: ["npx", "-y", "@stripe/mcp"],
+    command: ["npx", "-y", "@stripe/mcp", "--tools=all"],
     envKeys: ["STRIPE_SECRET_KEY"]
   },
   {
-    name: "cloudflare",
+    // Sentry's hosted server is OAuth-only (would sit "failed to connect" until the user
+    // authenticates in a browser); its stdio server takes a token, so gate on that like the rest.
+    name: "sentry",
     transport: "stdio",
-    command: ["npx", "-y", "@anthropic-ai/mcp-cloudflare"],
-    envKeys: ["CLOUDFLARE_API_TOKEN"]
+    command: ["npx", "-y", "@sentry/mcp-server@latest"],
+    envKeys: ["SENTRY_ACCESS_TOKEN"]
   },
   {
     name: "figma",
     transport: "stdio",
-    command: ["npx", "-y", "@anthropic-ai/mcp-figma"],
-    envKeys: ["FIGMA_ACCESS_TOKEN"]
+    command: ["npx", "-y", "figma-developer-mcp", "--stdio"],
+    envKeys: ["FIGMA_API_KEY"]
   },
   {
     name: "resend",
@@ -21076,7 +21939,7 @@ var KEY_GATED = [
     envKeys: ["TAVILY_API_KEY"]
   }
 ];
-var defaultDeps2 = { exec: makeExec("claude"), env: process20.env };
+var defaultDeps2 = { exec: makeExec("claude"), env: process22.env };
 var buildAddArgs = (def, env) => {
   if (def.transport === "sse") {
     const [url = ""] = def.command;
@@ -21137,8 +22000,9 @@ var installGlobalMcp = async (deps = defaultDeps2) => {
 };
 
 // src/global/installGlobalSkills.ts
-import { cp as cp5, mkdir as mkdir11, readdir as readdir9, readFile as readFile19, rm as rm5, stat as stat3, writeFile as writeFile12 } from "fs/promises";
-import { join as join48 } from "path";
+import { cp as cp5, mkdir as mkdir14, readdir as readdir10, readFile as readFile23, rm as rm5, stat as stat3, writeFile as writeFile16 } from "fs/promises";
+import { join as join51 } from "path";
+var REQUIRED_MANAGED_SKILLS = ["feedback"];
 var pathExists8 = async (path) => {
   try {
     await stat3(path);
@@ -21149,14 +22013,14 @@ var pathExists8 = async (path) => {
 };
 var listBundledSkills = async (sourceDir) => {
   try {
-    const manifest = JSON.parse(await readFile19(join48(sourceDir, "manifest.json"), "utf8"));
+    const manifest = JSON.parse(await readFile23(join51(sourceDir, "manifest.json"), "utf8"));
     if (Array.isArray(manifest.skills)) {
       return [...manifest.skills];
     }
   } catch {
   }
   try {
-    const entries = await readdir9(sourceDir, { withFileTypes: true });
+    const entries = await readdir10(sourceDir, { withFileTypes: true });
     return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
   } catch {
     return [];
@@ -21164,54 +22028,285 @@ var listBundledSkills = async (sourceDir) => {
 };
 var installGlobalSkills = async (paths, sourceDir = paths.bundledSkillsDir) => {
   const names = await listBundledSkills(sourceDir);
-  await mkdir11(paths.skillsDir, { recursive: true });
+  for (const requiredSkill of REQUIRED_MANAGED_SKILLS) {
+    if (!names.includes(requiredSkill)) {
+      throw new Error(`Bundled skills are incomplete: ${requiredSkill} is missing.`);
+    }
+  }
+  await mkdir14(paths.skillsDir, { recursive: true });
   const installed = [];
   const skipped = [];
   for (const name of names) {
-    const dest = join48(paths.skillsDir, name);
+    const dest = join51(paths.skillsDir, name);
     if (await pathExists8(dest)) {
-      if (!await pathExists8(join48(dest, MANAGED_SKILL_MARKER))) {
+      if (!await pathExists8(join51(dest, MANAGED_SKILL_MARKER))) {
         skipped.push(name);
         continue;
       }
       await rm5(dest, { recursive: true, force: true });
     }
-    await cp5(join48(sourceDir, name), dest, { recursive: true });
-    await writeFile12(join48(dest, MANAGED_SKILL_MARKER), "", "utf8");
+    await cp5(join51(sourceDir, name), dest, { recursive: true });
+    await writeFile16(join51(dest, MANAGED_SKILL_MARKER), "", "utf8");
     installed.push(name);
   }
   return { installed, skipped, path: paths.skillsDir };
 };
 
-// src/global/installState.ts
-import { mkdir as mkdir12, readFile as readFile20, writeFile as writeFile13 } from "fs/promises";
-import { join as join49 } from "path";
-var INSTALL_STATE_FILENAME = ".vybekiit-install.json";
-var installStatePath = (configDir) => join49(configDir, INSTALL_STATE_FILENAME);
-var readInstallState = async (configDir) => {
+// src/global/runSessionOne.ts
+import { spawn as spawn2 } from "child_process";
+import { access as access15, readdir as readdir11 } from "fs/promises";
+import { homedir as homedir4 } from "os";
+import { join as join52 } from "path";
+import process23 from "process";
+var DEFAULT_FIRST_APP_DIR_NAME = "vybekiit-app";
+var SESSION_ONE_SEED_PROMPT = "Set up my app.";
+var shouldSkipSessionOne = (args, env = process23.env) => {
+  if (args.includes("--skip-session-one") || args.includes("--skip-first-app")) {
+    return true;
+  }
+  const flag = env.VYBEKIIT_SKIP_SESSION_ONE;
+  return flag === "1" || flag === "true" || flag === "yes";
+};
+var resolveFirstAppPath = (deps) => {
+  const override = deps.env.VYBEKIIT_FIRST_APP_DIR?.trim();
+  if (override !== void 0 && override !== "") {
+    return override.startsWith("/") || /^[A-Za-z]:[\\/]/.test(override) ? override : join52(deps.homeDir(), override);
+  }
+  return join52(deps.homeDir(), DEFAULT_FIRST_APP_DIR_NAME);
+};
+var defaultPathExists2 = async (path) => {
   try {
-    const raw = await readFile20(installStatePath(configDir), "utf8");
-    const parsed = JSON.parse(raw);
-    if (typeof parsed.version !== "string" || parsed.version === "") {
-      return null;
-    }
-    if (typeof parsed.updatedAt !== "string" || parsed.updatedAt === "") {
-      return null;
+    await access15(path);
+    return true;
+  } catch {
+    return false;
+  }
+};
+var defaultIsEmptyDir = async (path) => {
+  try {
+    const entries = await readdir11(path);
+    return entries.length === 0;
+  } catch {
+    return true;
+  }
+};
+var defaultRunCommand = async (cwd, bin, args) => await new Promise((resolve13) => {
+  const child = spawn2(bin, [...args], {
+    cwd,
+    stdio: ["ignore", "inherit", "inherit"],
+    env: process23.env
+  });
+  child.on("error", () => {
+    resolve13({ code: 127 });
+  });
+  child.on("close", (code) => {
+    resolve13({ code: code ?? 1 });
+  });
+});
+var defaultStartDetached = (cwd, bin, args) => {
+  try {
+    const child = spawn2(bin, [...args], {
+      cwd,
+      detached: true,
+      stdio: "ignore",
+      env: process23.env
+    });
+    child.unref();
+    return true;
+  } catch {
+    return false;
+  }
+};
+var openClaudeWithSeed = async (appPath, prompt, platform = process23.platform) => {
+  if (platform === "darwin") {
+    const shellCommand = `cd ${JSON.stringify(appPath)} && claude ${JSON.stringify(prompt)}`;
+    const osa = makeExec("osascript");
+    const result = await osa([
+      "-e",
+      `tell application "Terminal" to do script ${JSON.stringify(shellCommand)}`
+    ]);
+    if (result.code === 0) {
+      return true;
     }
-    return { version: parsed.version, updatedAt: parsed.updatedAt };
+  }
+  try {
+    const child = spawn2("claude", [prompt], {
+      cwd: appPath,
+      detached: true,
+      stdio: "ignore",
+      env: process23.env
+    });
+    child.unref();
+    return true;
   } catch {
-    return null;
+    return false;
   }
 };
-var writeInstallState = async (configDir, version, now = () => /* @__PURE__ */ new Date()) => {
-  const state = {
-    version,
-    updatedAt: now().toISOString()
+var defaultResolvePnpm = async () => {
+  const pnpm = makeExec("pnpm");
+  const version = await pnpm(["--version"]);
+  if (version.code === 0) {
+    return ["pnpm"];
+  }
+  const corepack = makeExec("corepack");
+  const enabled = await corepack(["enable"]);
+  if (enabled.code === 0) {
+    const prepared = await corepack(["prepare", "pnpm@10.33.2", "--activate"]);
+    if (prepared.code === 0) {
+      const again = await pnpm(["--version"]);
+      if (again.code === 0) {
+        return ["pnpm"];
+      }
+    }
+  }
+  const npx = makeExec("npx");
+  const npxCheck = await npx(["-y", "pnpm@10.33.2", "--version"]);
+  if (npxCheck.code === 0) {
+    return ["npx", "-y", "pnpm@10.33.2"];
+  }
+  return null;
+};
+var defaultDeps3 = () => ({
+  createApp: runCreateApp,
+  pathExists: defaultPathExists2,
+  isEmptyDir: defaultIsEmptyDir,
+  runCommand: defaultRunCommand,
+  startDetached: defaultStartDetached,
+  openClaude: (appPath, prompt) => openClaudeWithSeed(appPath, prompt, process23.platform),
+  resolvePnpm: defaultResolvePnpm,
+  homeDir: homedir4,
+  env: process23.env,
+  platform: process23.platform
+});
+var formatSessionOneLines = (result) => {
+  if (result.appPath === null) {
+    return [
+      "",
+      "Session #1: could not create your first app automatically.",
+      "  Run:  npx vybekiit create app --web",
+      '  Then open that folder in Claude Code and say: "Set up my app."',
+      ""
+    ];
+  }
+  const lines = [
+    "",
+    result.created ? `\u2705 Your first web app is ready at ${result.appPath}` : `\u2705 Using your app at ${result.appPath}`
+  ];
+  if (result.depsInstalled) {
+    lines.push("  \u2022 Dependencies installed");
+  } else {
+    lines.push("  \u2022 Dependencies still need install \u2014 in that folder run:  pnpm install");
+  }
+  if (result.packagesBuilt) {
+    lines.push("  \u2022 Kit packages built for local preview");
+  } else if (result.depsInstalled) {
+    lines.push("  \u2022 Kit packages still need a build \u2014 in that folder run:  pnpm build:packages");
+  }
+  if (result.devStarted) {
+    lines.push("  \u2022 Preview starting at http://localhost:3000");
+  } else if (result.depsInstalled && result.packagesBuilt) {
+    lines.push("  \u2022 Preview not started \u2014 in that folder run:  pnpm dev");
+  }
+  if (result.claudeOpened) {
+    lines.push('  \u2022 Claude Code opening with: "Set up my app."');
+  } else {
+    lines.push('  \u2022 Open Claude Code in that folder and say: "Set up my app."');
+    lines.push(`      cd ${result.appPath} && claude "Set up my app."`);
+  }
+  lines.push(
+    "",
+    "Report mode is built in \u2014 if something looks wrong, press Option+Shift+R",
+    "(Alt+Shift+R on Windows), click it, and tell Claude what is off.",
+    ""
+  );
+  return lines;
+};
+var runSessionOne = async (deps = defaultDeps3()) => {
+  const appPath = resolveFirstAppPath(deps);
+  const exists3 = await deps.pathExists(appPath);
+  const empty = exists3 ? await deps.isEmptyDir(appPath) : true;
+  let created = false;
+  if (exists3 && !empty) {
+    const looksLikeKit = await deps.pathExists(join52(appPath, "templates", "web"));
+    if (!looksLikeKit) {
+      const failed = {
+        appPath: null,
+        created: false,
+        depsInstalled: false,
+        packagesBuilt: false,
+        devStarted: false,
+        claudeOpened: false
+      };
+      return {
+        ...failed,
+        lines: [
+          "",
+          `Session #1: ${appPath} already exists and is not a VybeKiit app.`,
+          "  Pick a free folder and run:  npx vybekiit create app --web ~/my-app",
+          "  Or set VYBEKIIT_FIRST_APP_DIR and re-run install once.",
+          ""
+        ]
+      };
+    }
+  } else {
+    process23.stdout.write(`
+Creating your first web app at ${appPath}\u2026
+`);
+    const code = await deps.createApp(["--web", appPath]);
+    if (code !== 0) {
+      const failed = {
+        appPath: null,
+        created: false,
+        depsInstalled: false,
+        packagesBuilt: false,
+        devStarted: false,
+        claudeOpened: false
+      };
+      return { ...failed, lines: formatSessionOneLines(failed) };
+    }
+    created = true;
+  }
+  const pnpm = await deps.resolvePnpm();
+  if (pnpm === null) {
+    const partial = {
+      appPath,
+      created,
+      depsInstalled: false,
+      packagesBuilt: false,
+      devStarted: false,
+      claudeOpened: false
+    };
+    const claudeOpened2 = await deps.openClaude(appPath, SESSION_ONE_SEED_PROMPT);
+    return {
+      ...partial,
+      claudeOpened: claudeOpened2,
+      lines: formatSessionOneLines({ ...partial, claudeOpened: claudeOpened2 })
+    };
+  }
+  const [pnpmBin, ...pnpmPrefix] = pnpm;
+  process23.stdout.write("\nInstalling dependencies (this can take a few minutes)\u2026\n");
+  const install = await deps.runCommand(appPath, pnpmBin, [...pnpmPrefix, "install"]);
+  const depsInstalled = install.code === 0;
+  let packagesBuilt = false;
+  if (depsInstalled) {
+    process23.stdout.write("\nBuilding kit packages for preview\u2026\n");
+    const build = await deps.runCommand(appPath, pnpmBin, [...pnpmPrefix, "build:packages"]);
+    packagesBuilt = build.code === 0;
+  }
+  let devStarted = false;
+  if (depsInstalled && packagesBuilt) {
+    devStarted = deps.startDetached(appPath, pnpmBin, [...pnpmPrefix, "dev"]);
+  }
+  const claudeOpened = await deps.openClaude(appPath, SESSION_ONE_SEED_PROMPT);
+  const outcome = {
+    appPath,
+    created,
+    depsInstalled,
+    packagesBuilt,
+    devStarted,
+    claudeOpened
   };
-  await mkdir12(configDir, { recursive: true });
-  await writeFile13(installStatePath(configDir), `${JSON.stringify(state, null, 2)}
-`, "utf8");
-  return state;
+  return { ...outcome, lines: formatSessionOneLines(outcome) };
 };
 
 // src/global/runGlobalInstall.ts
@@ -21236,6 +22331,11 @@ var formatGlobalInstallSummary = (summary) => {
   if (summary.skillSample.length > 0) {
     lines.push(`             smoke: ${summary.skillSample.join(", ")}`);
   }
+  if (summary.skippedSkillNames.length > 0) {
+    lines.push(
+      `             kept your own same-named skills: ${summary.skippedSkillNames.join(", ")}`
+    );
+  }
   if (skillsEmpty) {
     lines.push(
       "             No managed skills on disk \u2014 Claude Code will not load kit skills until this is fixed.",
@@ -21246,7 +22346,7 @@ var formatGlobalInstallSummary = (summary) => {
     lines.push("  \u2022 MCP      skipped \u2014 the `claude` command was not found on your PATH");
   } else {
     const enabledLabel = summary.mcpEnabled.length > 0 ? summary.mcpEnabled.join(", ") : "none newly added";
-    lines.push(`  \u2022 MCP      ${enabledLabel} (browser automation + live docs everywhere)`);
+    lines.push(`  \u2022 MCP      ${enabledLabel} (browser automation + live docs + error monitoring)`);
     if (summary.mcpRefreshed.length > 0) {
       lines.push(`             refreshed: ${summary.mcpRefreshed.join(", ")}`);
     }
@@ -21260,7 +22360,7 @@ var formatGlobalInstallSummary = (summary) => {
     lines.push("");
   } else {
     lines.push(
-      "  \u2022 Command  type /vybekiit in Claude Code to see status anytime",
+      summary.feedbackInstalled ? "  \u2022 Command  type /vybekiit for status or /feedback to send us a note" : "  \u2022 Command  type /vybekiit in Claude Code to see status anytime",
       "  \u2022 Claude now knows it is VybeKiit-enabled in every project",
       "",
       "To see it: restart Claude Code (or run `claude` once) to approve the new MCP servers,",
@@ -21268,6 +22368,8 @@ var formatGlobalInstallSummary = (summary) => {
       "",
       "Re-run anytime to update:  curl -fsSL https://vybekiit.com/install.sh | sh",
       "                     or:  npx -y vybekiit@latest update",
+      'First install also creates your web app and opens Claude with "Set up my app."',
+      "Skip that step:  VYBEKIIT_SKIP_SESSION_ONE=1  or  --skip-session-one",
       ""
     );
   }
@@ -21277,7 +22379,7 @@ var runGlobalInstall = async (args, gate = checkEntitlement) => {
   const entitlement = await gate();
   if (!entitlement.entitled) {
     for (const line of formatEntitlementBlock(entitlement)) {
-      process21.stderr.write(`${line}
+      process24.stderr.write(`${line}
 `);
     }
     return 1;
@@ -21285,17 +22387,17 @@ var runGlobalInstall = async (args, gate = checkEntitlement) => {
   const skipPrompt = args.includes("--yes") || args.includes("-y");
   if (!skipPrompt) {
     if (!isInteractive()) {
-      process21.stdout.write(
+      process24.stdout.write(
         "Skipping global setup (non-interactive). Run `vybekiit global-install --yes` or `vybekiit update` to provision Claude Code globally.\n"
       );
       return 0;
     }
-    const proceed = await confirm({
+    const proceed = await confirm2({
       message: "Set up / update VybeKiit globally in Claude Code? Refreshes skills + browser automation in every project.",
       initialValue: true
     });
-    if (isCancel2(proceed) || proceed !== true) {
-      process21.stdout.write(
+    if (isCancel3(proceed) || proceed !== true) {
+      process24.stdout.write(
         "Skipped global setup. You can run `vybekiit update` or `vybekiit global-install` anytime.\n"
       );
       return 0;
@@ -21308,7 +22410,7 @@ var runGlobalInstall = async (args, gate = checkEntitlement) => {
   const skills = await installGlobalSkills(paths);
   const mcp = await installGlobalMcp({
     exec: makeExec("claude"),
-    env: process21.env,
+    env: process24.env,
     forceRefresh: isRerun
   });
   const awareness = await installAwareness(paths);
@@ -21317,6 +22419,8 @@ var runGlobalInstall = async (args, gate = checkEntitlement) => {
   const summary = {
     skillsInstalled: skills.installed.length,
     skillsSkipped: skills.skipped.length,
+    skippedSkillNames: skills.skipped,
+    feedbackInstalled: skills.installed.includes("feedback"),
     skillSample,
     skillsPath: skills.path,
     mcpEnabled: mcp.enabled,
@@ -21328,24 +22432,38 @@ var runGlobalInstall = async (args, gate = checkEntitlement) => {
     previousVersion: previous?.version ?? null
   };
   for (const line of formatGlobalInstallSummary(summary)) {
-    process21.stdout.write(`${line}
+    process24.stdout.write(`${line}
 `);
   }
   if (!isGloballyInstalled(postStatus)) {
-    process21.stderr.write(
+    process24.stderr.write(
       "VybeKiit global install incomplete: expected managed skills + /vybekiit + CLAUDE.md block.\n"
     );
     return 1;
   }
-  await writeInstallState(paths.configDir, version);
+  let firstAppPath = previous?.firstAppPath;
+  const isFirstInstall = previous === null;
+  if (isFirstInstall && !shouldSkipSessionOne(args)) {
+    const sessionOne = await runSessionOne();
+    for (const line of sessionOne.lines) {
+      process24.stdout.write(`${line}
+`);
+    }
+    if (sessionOne.appPath !== null) {
+      firstAppPath = sessionOne.appPath;
+    }
+  }
+  await writeInstallState(paths.configDir, version, {
+    ...firstAppPath === void 0 ? {} : { firstAppPath }
+  });
   return 0;
 };
 
 // src/ui/welcomeBanner.ts
-import process23 from "process";
+import process26 from "process";
 
 // src/ui/ansiShimmer.ts
-import process22 from "process";
+import process25 from "process";
 var RESET = "\x1B[0m";
 var GRADIENT_START = [34, 211, 238];
 var GRADIENT_END = [167, 139, 250];
@@ -21357,7 +22475,7 @@ var colorAt = (t) => rgb(
   lerp(GRADIENT_START[1], GRADIENT_END[1], t),
   lerp(GRADIENT_START[2], GRADIENT_END[2], t)
 );
-var supportsColor = (env = process22.env, isTTY = Boolean(process22.stdout.isTTY)) => {
+var supportsColor = (env = process25.env, isTTY = Boolean(process25.stdout.isTTY)) => {
   if (env.NO_COLOR !== void 0 && env.NO_COLOR !== "") {
     return false;
   }
@@ -21419,13 +22537,13 @@ var writeBlock = (write, lines) => {
   }
 };
 var playWelcomeBanner = async (options = {}) => {
-  const write = options.write === void 0 ? (text2) => process23.stdout.write(text2) : options.write;
+  const write = options.write === void 0 ? (text2) => process26.stdout.write(text2) : options.write;
   const sleepFn = options.sleep === void 0 ? sleep : options.sleep;
   const frames = options.frames === void 0 ? DEFAULT_FRAMES : options.frames;
   const frameDelayMs = options.frameDelayMs === void 0 ? DEFAULT_FRAME_DELAY_MS : options.frameDelayMs;
   const art = [...WELCOME_ART];
   const useColor = !options.forcePlain && supportsColor();
-  const animate = useColor && Boolean(process23.stdout.isTTY) && frames > 0;
+  const animate = useColor && Boolean(process26.stdout.isTTY) && frames > 0;
   if (!animate) {
     writeBlock(write, art);
     writeln(write, "");
@@ -21480,6 +22598,14 @@ var formatSetupNextStep = (input) => {
       ""
     ];
   }
+  if (input.firstAppPath !== void 0 && input.firstAppPath !== "") {
+    return [
+      'Your app is ready \u2014 open Claude Code in that folder and say: "Set up my app."',
+      `  ${input.firstAppPath}`,
+      "  (If Claude is already open there, you are set.)",
+      ""
+    ];
+  }
   return [
     "Next: create your app",
     "  vybekiit create app --web",
@@ -21493,13 +22619,15 @@ var runSetup = async () => {
   await playWelcomeBanner();
   const code = await runDoctor();
   await runGlobalInstall(["--yes"]);
-  const access15 = checkAccess();
-  process24.stdout.write("\n");
+  const access17 = checkAccess();
+  const installState = await readInstallState(resolveGlobalPaths().configDir);
+  process27.stdout.write("\n");
   for (const line of formatSetupNextStep({
     doctorExitCode: code,
-    gateReason: access15.reason
+    gateReason: access17.reason,
+    ...installState?.firstAppPath === void 0 ? {} : { firstAppPath: installState.firstAppPath }
   })) {
-    process24.stdout.write(`${line}
+    process27.stdout.write(`${line}
 `);
   }
   return code;
@@ -21507,20 +22635,20 @@ var runSetup = async () => {
 
 // src/commands/syncAgentLayer.ts
 import { execFile as execFile7 } from "child_process";
-import { access as access14, cp as cp6, readFile as readFile21, writeFile as writeFile14 } from "fs/promises";
-import { join as join50 } from "path";
-import process25 from "process";
+import { access as access16, cp as cp6, readFile as readFile24, writeFile as writeFile17 } from "fs/promises";
+import { join as join53 } from "path";
+import process28 from "process";
 import { promisify as promisify6 } from "util";
 var execFileAsync6 = promisify6(execFile7);
-var defaultDeps3 = {
+var defaultDeps4 = {
   resolve: resolveTemplatesSource,
   copy: cp6,
   runSkillsUpdate: async (cwd) => {
-    await execFileAsync6("npx", ["skills", "update", "-y"], { cwd, env: process25.env });
+    await execFileAsync6("npx", ["skills", "update", "-y"], { cwd, env: process28.env });
   },
   pathExists: async (path) => {
     try {
-      await access14(path);
+      await access16(path);
       return true;
     } catch {
       return false;
@@ -21539,7 +22667,7 @@ var resolveSyncTemplate = async (explicit, cwd) => {
 var listMirrorAgentPaths = async (mirrorRoot, pathExists9) => {
   const entries = await Promise.all(
     AGENT_LAYER_PATHS.map(async (path) => {
-      if (await pathExists9(join50(mirrorRoot, path))) {
+      if (await pathExists9(join53(mirrorRoot, path))) {
         return path;
       }
       return null;
@@ -21549,28 +22677,28 @@ var listMirrorAgentPaths = async (mirrorRoot, pathExists9) => {
 };
 var copyAgentLayerPath = async (options) => {
   const { mirrorRoot, cwd, path, copy, pathExists: pathExists9 } = options;
-  const src = join50(mirrorRoot, path);
-  const dest = join50(cwd, path);
+  const src = join53(mirrorRoot, path);
+  const dest = join53(cwd, path);
   if (path !== ".vybekiit") {
     await copy(src, dest, { recursive: true, force: true });
     return;
   }
-  const { readdir: readdir10, stat: stat4, mkdir: mkdir13 } = await import("fs/promises");
+  const { readdir: readdir12, stat: stat4, mkdir: mkdir15 } = await import("fs/promises");
   const walk = async (rel) => {
     const relNorm = rel.split("\\").join("/");
     if (isAgentLayerExtensionPath(relNorm)) {
       return;
     }
-    const srcPath = join50(mirrorRoot, relNorm);
-    const destPath = join50(cwd, relNorm);
+    const srcPath = join53(mirrorRoot, relNorm);
+    const destPath = join53(cwd, relNorm);
     if (!await pathExists9(srcPath)) {
       return;
     }
     const info = await stat4(srcPath);
     if (info.isDirectory()) {
-      await mkdir13(destPath, { recursive: true });
-      const entries = await readdir10(srcPath);
-      await Promise.all(entries.map((entry) => walk(join50(relNorm, entry))));
+      await mkdir15(destPath, { recursive: true });
+      const entries = await readdir12(srcPath);
+      await Promise.all(entries.map((entry) => walk(join53(relNorm, entry))));
       return;
     }
     await copy(srcPath, destPath, { force: true });
@@ -21594,21 +22722,21 @@ var readGoalIndexBeforeSync = async (pathsToSync, cwd, deps) => {
   if (!pathsToSync.includes(".vybekiit")) {
     return;
   }
-  const goalIndexPath = join50(cwd, ".vybekiit/agent/goal-index.md");
+  const goalIndexPath = join53(cwd, ".vybekiit/agent/goal-index.md");
   if (!await deps.pathExists(goalIndexPath)) {
     return;
   }
-  return await readFile21(goalIndexPath, "utf8");
+  return await readFile24(goalIndexPath, "utf8");
 };
 var mergeGoalIndexAfterSync = async (cwd, goalIndexBefore) => {
   if (goalIndexBefore === void 0) {
     return;
   }
-  const goalIndexPath = join50(cwd, ".vybekiit/agent/goal-index.md");
-  const synced = await readFile21(goalIndexPath, "utf8");
+  const goalIndexPath = join53(cwd, ".vybekiit/agent/goal-index.md");
+  const synced = await readFile24(goalIndexPath, "utf8");
   const merged = mergeGoalIndexOnSync(synced, goalIndexBefore);
   if (merged !== synced) {
-    await writeFile14(goalIndexPath, merged, "utf8");
+    await writeFile17(goalIndexPath, merged, "utf8");
   }
 };
 var refreshGeneratedInstructionSections = async (cwd, template, deps) => {
@@ -21619,14 +22747,14 @@ var refreshGeneratedInstructionSections = async (cwd, template, deps) => {
   const rendered = applyAgentLayerSections(fileContents, { template });
   const writes = Object.entries(rendered).map(async ([file, content]) => {
     if (fileContents[file] !== void 0 && content !== fileContents[file]) {
-      await writeFile14(join50(cwd, file), content, "utf8");
+      await writeFile17(join53(cwd, file), content, "utf8");
     }
   });
   await Promise.all(writes);
   return true;
 };
 var refreshPlatformInstructionFiles = async (cwd, deps) => {
-  if (!await deps.pathExists(join50(cwd, "skills-lock.json"))) {
+  if (!await deps.pathExists(join53(cwd, "skills-lock.json"))) {
     return "missing-lock";
   }
   try {
@@ -21636,7 +22764,7 @@ var refreshPlatformInstructionFiles = async (cwd, deps) => {
     return "failed";
   }
 };
-var runSyncAgentLayer = async (args, cwd = process25.cwd(), deps = defaultDeps3) => {
+var runSyncAgentLayer = async (args, cwd = process28.cwd(), deps = defaultDeps4) => {
   const [explicit] = args;
   const template = await resolveSyncTemplate(explicit, cwd);
   if (template === null) {
@@ -21655,7 +22783,7 @@ var runSyncAgentLayer = async (args, cwd = process25.cwd(), deps = defaultDeps3)
     });
     const { cleanup: resolvedCleanup, source } = resolved;
     cleanup = resolvedCleanup;
-    const mirrorRoot = join50(source, template);
+    const mirrorRoot = join53(source, template);
     const mirrorPaths = await listMirrorAgentPaths(mirrorRoot, deps.pathExists);
     const plan = planAgentLayerSync(mirrorPaths);
     const lines = [formatAgentLayerSyncSummary(plan)];
@@ -21691,7 +22819,7 @@ var runSyncAgentLayer = async (args, cwd = process25.cwd(), deps = defaultDeps3)
 };
 
 // src/commands/updateKit.ts
-import process26 from "process";
+import process29 from "process";
 import { Effect as Effect31 } from "effect";
 var runUpdateKit = async (args = []) => {
   const apply = args.includes("--apply");
@@ -21719,21 +22847,21 @@ var runUpdateKit = async (args = []) => {
 var runUpdateKitCommand = async (args) => {
   const result = await runUpdateKit(args);
   for (const line of result.lines) {
-    process26.stdout.write(`${line}
+    process29.stdout.write(`${line}
 `);
   }
   return result.exitCode;
 };
 
 // src/doctor/ensureTool.ts
-import { spawnSync as spawnSync8 } from "child_process";
-import process27 from "process";
+import { spawnSync as spawnSync9 } from "child_process";
+import process30 from "process";
 var toPlatform2 = (platform) => platform === "darwin" || platform === "win32" || platform === "linux" ? platform : null;
-var succeeds2 = (command, args) => spawnSync8(command, [...args], { stdio: "ignore" }).status === 0;
+var succeeds3 = (command, args) => spawnSync9(command, [...args], { stdio: "ignore" }).status === 0;
 var errorCode2 = (error) => error !== void 0 && "code" in error && typeof error.code === "string" ? error.code : void 0;
 var runInstall2 = (action, log) => {
   log.log(`[doctor] setting up ${action.tool}: ${action.command} ${action.args.join(" ")}`);
-  const result = spawnSync8(action.command, [...action.args], { stdio: "inherit" });
+  const result = spawnSync9(action.command, [...action.args], { stdio: "inherit" });
   if (errorCode2(result.error) === "ENOENT") {
     return action.requires ? { ok: false, missingRequirement: action.requires } : { ok: false };
   }
@@ -21743,19 +22871,19 @@ var probeAuth = (tool) => {
   if (tool.auth === void 0) {
     return null;
   }
-  return succeeds2(tool.auth.command, tool.auth.args);
+  return succeeds3(tool.auth.command, tool.auth.args);
 };
 var ensureTool = (name, log = console) => {
   const tool = findToolByName(name);
   if (tool === void 0) {
     return { tool: name, known: false, installed: false, installedNow: false, authed: null };
   }
-  const platform = toPlatform2(process27.platform);
+  const platform = toPlatform2(process30.platform);
   if (!platform) {
-    log.error(`[doctor] This operating system (${process27.platform}) isn't supported yet.`);
+    log.error(`[doctor] This operating system (${process30.platform}) isn't supported yet.`);
     return { tool: name, known: true, installed: false, installedNow: false, authed: null };
   }
-  const present = succeeds2(tool.name, tool.versionArgs);
+  const present = succeeds3(tool.name, tool.versionArgs);
   const presence = [{ tool: tool.name, present }];
   let installedNow = false;
   let missingRequirement;
@@ -21796,9 +22924,9 @@ var formatEnsureResult = (result) => {
 };
 
 // src/prompts/envWizard.ts
-import { readFile as readFile22 } from "fs/promises";
-import { join as join51 } from "path";
-import { cancel as cancel2, isCancel as isCancel3, text } from "@clack/prompts";
+import { readFile as readFile25 } from "fs/promises";
+import { join as join54 } from "path";
+import { cancel as cancel2, isCancel as isCancel4, text } from "@clack/prompts";
 var ENV_KEY_PATTERN = /^[A-Z][A-Z0-9_]*$/;
 var parseExampleEnvKeys = (raw) => raw.split("\n").reduce((keys, line) => {
   const separatorIndex = line.indexOf("=");
@@ -21849,19 +22977,19 @@ ${nextLine}
 `;
 };
 var runEnvWizard = async (cwd = process.cwd()) => {
-  const examplePath = join51(cwd, ".env.example");
+  const examplePath = join54(cwd, ".env.example");
   let raw;
   try {
-    raw = await readFile22(examplePath, "utf8");
+    raw = await readFile25(examplePath, "utf8");
   } catch {
     process.stderr.write("No .env.example in this folder.\n");
     return 1;
   }
   const keys = parseExampleEnvKeys(raw);
-  const envPath = join51(cwd, ".env");
+  const envPath = join54(cwd, ".env");
   let envContent = "";
   try {
-    envContent = await readFile22(envPath, "utf8");
+    envContent = await readFile25(envPath, "utf8");
   } catch {
   }
   for (const key of keys) {
@@ -21873,19 +23001,19 @@ var runEnvWizard = async (cwd = process.cwd()) => {
       defaultValue: current,
       placeholder: current
     });
-    if (isCancel3(value)) {
+    if (isCancel4(value)) {
       cancel2("Cancelled.");
       return 1;
     }
     envContent = upsertEnvLine(envContent, key, value);
   }
-  const { writeFile: writeFile15 } = await import("fs/promises");
-  await writeFile15(envPath, envContent, "utf8");
+  const { writeFile: writeFile18 } = await import("fs/promises");
+  await writeFile18(envPath, envContent, "utf8");
   return 0;
 };
 
 // src/prompts/mainMenu.ts
-import { cancel as cancel3, intro, isCancel as isCancel4, select as select2 } from "@clack/prompts";
+import { cancel as cancel3, intro, isCancel as isCancel5, select as select2 } from "@clack/prompts";
 var promptMainMenu = async () => {
   intro("Welcome to VybeKiit");
   const picked = await select2({
@@ -21918,7 +23046,7 @@ var promptMainMenu = async () => {
       }
     ]
   });
-  if (isCancel4(picked) || typeof picked !== "string") {
+  if (isCancel5(picked) || typeof picked !== "string") {
     cancel3("Cancelled.");
     return null;
   }
@@ -21929,11 +23057,11 @@ var promptMainMenu = async () => {
 };
 
 // src/cliRunner.ts
-var HERE7 = dirname17(fileURLToPath9(import.meta.url));
-var GATE_EXEMPT = /* @__PURE__ */ new Set(["doctor", "setup", "global-install", "update"]);
+var HERE7 = dirname18(fileURLToPath9(import.meta.url));
+var GATE_EXEMPT = /* @__PURE__ */ new Set(["doctor", "setup", "global-install", "update", "feedback"]);
 var readVersion = async () => {
   try {
-    const raw = await readFile23(join52(HERE7, "..", "package.json"), "utf8");
+    const raw = await readFile26(join55(HERE7, "..", "package.json"), "utf8");
     const parsed = JSON.parse(raw);
     if (parsed.version !== void 0 && parsed.version !== "") {
       return parsed.version;
@@ -21958,7 +23086,7 @@ var commandArgs = (context) => {
 };
 var writeLines2 = (lines) => {
   for (const line of lines) {
-    process28.stdout.write(`${line}
+    process31.stdout.write(`${line}
 `);
   }
 };
@@ -21974,20 +23102,20 @@ var runDoctorEnsure = (toolName, json) => {
   if (toolName === void 0 || toolName === "" || toolName.startsWith("--")) {
     const message = "Usage: vybekiit doctor --ensure <tool> [--json]";
     if (json) {
-      process28.stdout.write(`${JSON.stringify({ ok: false, error: message })}
+      process31.stdout.write(`${JSON.stringify({ ok: false, error: message })}
 `);
     } else {
-      process28.stderr.write(`${message}
+      process31.stderr.write(`${message}
 `);
     }
     return 1;
   }
   const result = ensureTool(toolName);
   if (json) {
-    process28.stdout.write(`${JSON.stringify({ ok: result.installed, ...result })}
+    process31.stdout.write(`${JSON.stringify({ ok: result.installed, ...result })}
 `);
   } else {
-    process28.stdout.write(`${formatEnsureResult(result)}
+    process31.stdout.write(`${formatEnsureResult(result)}
 `);
   }
   return result.installed ? 0 : 1;
@@ -22003,47 +23131,47 @@ var handleDoctorCommand = async (context) => {
 var handleBackendCommand = async (context) => {
   if (context.subcommand === "add-route") {
     const result = await runBackendAddRoute([...context.rest]);
-    process28.stdout.write(`${result.message}
+    process31.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "add-crud") {
     const result = await runBackendAddCrud([...context.rest]);
-    process28.stdout.write(`${result.message}
+    process31.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "add-upload") {
     const result = await runBackendAddUpload();
-    process28.stdout.write(`${result.message}
+    process31.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "gen-contract") {
     const result = await runBackendGenContract();
-    process28.stdout.write(`${result.message}
+    process31.stdout.write(`${result.message}
 `);
     return result.exitCode;
   }
-  process28.stderr.write(
+  process31.stderr.write(
     "Unknown backend command. Try: backend add-route | add-crud | add-upload | gen-contract\n"
   );
   return 1;
 };
 var handleEnvCommand = async (context) => {
   if (context.subcommand !== "wizard") {
-    process28.stderr.write("Unknown env command. Try: vybekiit env wizard\n");
+    process31.stderr.write("Unknown env command. Try: vybekiit env wizard\n");
     return 1;
   }
   if (!isInteractive()) {
-    process28.stderr.write("env wizard requires an interactive terminal.\n");
+    process31.stderr.write("env wizard requires an interactive terminal.\n");
     return 1;
   }
   return await runEnvWizard();
 };
 var handleCreateCommand = async (context) => {
   if (context.subcommand !== "app") {
-    process28.stderr.write("Usage: vybekiit create app --web|--mobile|--extension [directory]\n");
+    process31.stderr.write("Usage: vybekiit create app --web|--mobile|--extension [directory]\n");
     return 1;
   }
   return await runCreateApp([...context.rest]);
@@ -22051,7 +23179,7 @@ var handleCreateCommand = async (context) => {
 var wantsFullHelp = (argv) => argv.includes("--all") || argv.includes("-a");
 var runMainMenuChoice = async (choice) => {
   if (choice === "help-all") {
-    process28.stdout.write(`${CLI_HELP_ALL}
+    process31.stdout.write(`${CLI_HELP_ALL}
 `);
     return 0;
   }
@@ -22078,18 +23206,24 @@ var handleAddCommand = async (context) => {
   }
   if (context.subcommand === "page-recipe") {
     const result = await runAddPageRecipe([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
+`);
+    return result.exitCode;
+  }
+  if (context.subcommand === "report-mode") {
+    const result = await runAddReportMode([...context.rest]);
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   }
   if (context.subcommand === "preset") {
     const result = await runApplyPreset([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   }
-  process28.stderr.write(
-    "Unknown add command. Try: vybekiit add page-recipe <id> | add preset <id> | add bridge\n"
+  process31.stderr.write(
+    "Unknown add command. Try: vybekiit add page-recipe <id> | add report-mode | add preset <id> | add bridge\n"
   );
   return 1;
 };
@@ -22117,96 +23251,96 @@ var COMMAND_HANDLERS = {
   "render-agent-layer": async () => (await runRenderAgentLayer()).exitCode,
   "check-goals": async (context) => {
     const result = await runCheckGoals([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "check-agent-layer": async (context) => {
     const result = await runCheckAgentLayer([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "plan-readiness": async (context) => {
     const result = await runPlanReadiness([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "plan-setup": async (context) => {
     const result = await runPlanSetup([...context.rest]);
-    process28.stdout.write(`${result.output}
+    process31.stdout.write(`${result.output}
 `);
     return result.exitCode;
   },
   "plan-data-model": async (context) => {
     const result = await runPlanDataModel([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "apply-preset": async (context) => {
     const result = await runApplyPreset(commandArgs(context));
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "list-presets": () => {
     const result = runListPresets();
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "list-pieces": async (context) => {
     const result = await runListPieces(commandArgs(context));
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "list-page-recipes": async (context) => {
     const result = await runListPageRecipes(commandArgs(context));
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "verify-presets": async (context) => {
     const result = await runVerifyPresets(commandArgs(context));
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "lint-extension-skill": async (context) => {
     const result = await runLintExtensionSkill([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "doc-fallback": (context) => {
     const result = runDocFallback([...context.rest]);
-    process28.stdout.write(`${result.json}
+    process31.stdout.write(`${result.json}
 `);
     return result.exitCode;
   },
   "live-work": async (context) => {
     if (context.subcommand === "data") {
       const result = await runLiveWorkData([...context.rest]);
-      process28.stdout.write(`${result.json}
+      process31.stdout.write(`${result.json}
 `);
       return result.exitCode;
     }
     if (context.subcommand === "host") {
       const result = await runLiveWorkHost([...context.rest]);
-      process28.stdout.write(`${result.json}
+      process31.stdout.write(`${result.json}
 `);
       return result.exitCode;
     }
     if (context.subcommand === "payments") {
       const result = await runLiveWorkPayments([...context.rest]);
-      process28.stdout.write(`${result.json}
+      process31.stdout.write(`${result.json}
 `);
       return result.exitCode;
     }
-    process28.stderr.write(
+    process31.stderr.write(
       "Usage: vybekiit live-work data|host|payments [--mode=demo|dogfood|buyer] [--vendor=\u2026] [--cwd=dir] [--no-pin] [--fresh]\n"
     );
     return 1;
@@ -22214,7 +23348,7 @@ var COMMAND_HANDLERS = {
   dedup: async (context) => {
     const result = await runDedup(commandArgs(context));
     if (result.output !== "") {
-      process28.stdout.write(result.output);
+      process31.stdout.write(result.output);
     }
     return result.exitCode;
   },
@@ -22222,15 +23356,16 @@ var COMMAND_HANDLERS = {
   env: handleEnvCommand,
   scaffold: async (context) => {
     if (context.subcommand !== "backend") {
-      process28.stderr.write("Unknown scaffold command. Try: vybekiit scaffold backend\n");
+      process31.stderr.write("Unknown scaffold command. Try: vybekiit scaffold backend\n");
       return 1;
     }
-    const result = await runScaffoldBackend([...context.rest], process28.cwd());
-    process28.stdout.write(`${result.message}
+    const result = await runScaffoldBackend([...context.rest], process31.cwd());
+    process31.stdout.write(`${result.message}
 `);
     return result.exitCode;
   },
-  backend: handleBackendCommand
+  backend: handleBackendCommand,
+  feedback: (context) => runFeedback(commandArgs(context))
 };
 var COMMAND_NAMES = Object.keys(COMMAND_HANDLERS);
 var runCli = async (argv) => {
@@ -22243,17 +23378,17 @@ var runCli = async (argv) => {
       }
       return await runMainMenuChoice(choice);
     }
-    process28.stdout.write(`${CLI_HELP}
+    process31.stdout.write(`${CLI_HELP}
 `);
     return 0;
   }
   if (context.command === "help" || context.command === "--help" || context.command === "-h") {
-    process28.stdout.write(`${wantsFullHelp(argv) ? CLI_HELP_ALL : CLI_HELP}
+    process31.stdout.write(`${wantsFullHelp(argv) ? CLI_HELP_ALL : CLI_HELP}
 `);
     return 0;
   }
   if (context.command === "--version" || context.command === "-v") {
-    process28.stdout.write(`${await readVersion()}
+    process31.stdout.write(`${await readVersion()}
 `);
     return 0;
   }
@@ -22262,7 +23397,7 @@ var runCli = async (argv) => {
   }
   const handler = COMMAND_HANDLERS[context.command];
   if (handler === void 0) {
-    process28.stderr.write(
+    process31.stderr.write(
       `Unknown command: ${context.command}
 Try: vybekiit   or   vybekiit --help
 `
@@ -22274,9 +23409,9 @@ Try: vybekiit   or   vybekiit --help
 
 // src/bin.ts
 try {
-  process29.exit(await runCli(process29.argv.slice(2)));
+  process32.exit(await runCli(process32.argv.slice(2)));
 } catch (error) {
-  process29.stderr.write(`vybekiit: ${caughtMessage(error)}
+  process32.stderr.write(`vybekiit: ${caughtMessage(error)}
 `);
-  process29.exit(1);
+  process32.exit(1);
 }