@whisperr/wizard 0.5.4 → 0.6.0

package/dist/index.js

@@ -1,9 +1,8 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFileSync, realpathSync } from "fs";
-import { dirname as dirname2, join as join4 } from "path";
-import { fileURLToPath } from "url";
+import { realpathSync } from "fs";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/cli.ts
 import { resolve as resolve2 } from "path";
@@ -13,7 +12,7 @@ import open2 from "open";
 // src/core/config.ts
 var DEFAULT_API_BASE = "https://api.whisperr.net";
 var DEFAULT_MODEL = "claude-sonnet-5";
-var DEFAULT_PLANNER_MODEL = "claude-opus-4-8";
+var DEFAULT_PLANNER_MODEL = "claude-opus-5";
 var DEFAULT_EFFORT = "high";
 var EFFORT_LEVELS = ["low", "medium", "high", "xhigh", "max"];
 function resolveEffort() {
@@ -41,7 +40,10 @@ function resolveConfig(flags = {}) {
     // cleanly and keeps whatever already landed. Real runs finish well under it.
     budgetUsd: Number(process.env.WHISPERR_WIZARD_BUDGET_USD) || 25,
     directAnthropicKey,
-    offline
+    offline,
+    reviewPlan: flags.reviewPlan ?? false,
+    proposeOnly: flags.proposeOnly ?? false,
+    strictReview: flags.strictReview ?? false
   };
 }
 
@@ -1124,7 +1126,18 @@ function mockManifest(appId, config) {
     appName: "Acme (dev)",
     ingestionApiKey: "wrk_offline_demo_key_do_not_use",
     ingestionBaseUrl: config.apiBaseUrl,
-    businessContext: "B2C subscription app. Free trial converts to a paid monthly plan. Churn risk concentrates around trial end and the first failed payment.",
+    // Same labelled shape whisperr-go renders from the app's onboarding
+    // business context, so an offline run exercises the real prompt.
+    businessContext: [
+      "Product: Acme (Acme Inc)",
+      "What it does: B2C subscription app; a free trial converts to a paid monthly plan",
+      "Industry: Software / Productivity",
+      "Who the paying end user is: individual consumers on the trial-to-paid path",
+      "How it charges: monthly subscription",
+      "Activation moment: first project created after signup",
+      "Churn-risk signals onboarding identified: trial ending unused; first failed payment",
+      "Healthy-usage signals: weekly active project edits"
+    ].join("\n"),
     identify: {
       traits: [
         { name: "plan", description: "free | trial | pro" },
@@ -1181,8 +1194,8 @@ import {
 // src/core/git.ts
 import { spawn } from "child_process";
 import { createHash } from "crypto";
-import { mkdir, readFile as readFile2, rm, writeFile } from "fs/promises";
-import { basename, dirname, join as join2 } from "path";
+import { readFile as readFile2 } from "fs/promises";
+import { basename, join as join2 } from "path";
 async function takeCheckpoint(repoPath) {
   const isRepo = (await run(repoPath, ["rev-parse", "--is-inside-work-tree"])).ok;
   if (!isRepo) return { isRepo: false };
@@ -1213,21 +1226,6 @@ function revertHint(checkpoint) {
   if (!checkpoint.isRepo || !checkpoint.baseRef) return void 0;
   return `git restore . && git clean -fd   (back to ${checkpoint.baseRef.slice(0, 7)})`;
 }
-async function wasTrackedAtCheckpoint(repoPath, checkpoint, file) {
-  if (!checkpoint.isRepo) return false;
-  if (checkpoint.baseRef) {
-    const res2 = await run(repoPath, [
-      "ls-tree",
-      "--name-only",
-      checkpoint.baseRef,
-      "--",
-      file
-    ]);
-    return res2.ok && res2.stdout.trim() !== "";
-  }
-  const res = await run(repoPath, ["ls-files", "--", file]);
-  return res.ok && res.stdout.trim() !== "";
-}
 async function isWorkingTreeClean(repoPath) {
   const status = await run(repoPath, ["status", "--porcelain"]);
   return status.ok && status.stdout.trim() === "";
@@ -1243,54 +1241,6 @@ async function revertToCheckpoint(repoPath, checkpoint) {
   const clean = await run(repoPath, ["clean", "-fd"]);
   return restore.ok && clean.ok;
 }
-async function snapshotChanges(repoPath, checkpoint) {
-  const snapshot = /* @__PURE__ */ new Map();
-  for (const file of await changedFiles(repoPath, checkpoint)) {
-    try {
-      snapshot.set(file, await readFile2(join2(repoPath, file)));
-    } catch {
-      snapshot.set(file, null);
-    }
-  }
-  return snapshot;
-}
-function snapshotsEqual(a, b) {
-  if (a.size !== b.size) return false;
-  for (const [file, content] of a) {
-    const other = b.get(file);
-    if (other === void 0) return false;
-    if (content === null || other === null) {
-      if (content !== other) return false;
-    } else if (!content.equals(other)) {
-      return false;
-    }
-  }
-  return true;
-}
-async function restoreToSnapshot(repoPath, checkpoint, snapshot) {
-  try {
-    const current = await changedFiles(repoPath, checkpoint);
-    for (const file of /* @__PURE__ */ new Set([...current, ...snapshot.keys()])) {
-      const recorded = snapshot.get(file);
-      const path = join2(repoPath, file);
-      if (recorded === void 0) {
-        if (checkpoint.baseRef) {
-          const co = await run(repoPath, ["checkout", checkpoint.baseRef, "--", file]);
-          if (co.ok) continue;
-        }
-        await rm(path, { force: true });
-      } else if (recorded === null) {
-        await rm(path, { force: true });
-      } else {
-        await mkdir(dirname(path), { recursive: true });
-        await writeFile(path, recorded);
-      }
-    }
-    return true;
-  } catch {
-    return false;
-  }
-}
 async function repoFingerprint(repoPath) {
   const remote = await run(repoPath, ["remote", "get-url", "origin"]);
   const seed = remote.ok && remote.stdout.trim() ? normalizeRemote(remote.stdout.trim()) : `dir:${basename(repoPath)}`;
@@ -1352,248 +1302,6 @@ function run(cwd, args) {
   });
 }
 
-// src/core/opportunities.ts
-import { readFile as readFile3, rm as rm2 } from "fs/promises";
-import { join as join3 } from "path";
-var OPPORTUNITIES_FILE = "whisperr-opportunities.json";
-function normalizeCode(value) {
-  return value.trim().toLowerCase().replace(/[ \-./]/g, "_").replace(/[^a-z0-9_]/g, "").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
-}
-async function collectOpportunities(repoPath, manifest, checkpoint) {
-  const path = join3(repoPath, OPPORTUNITIES_FILE);
-  if (await wasTrackedAtCheckpoint(repoPath, checkpoint, OPPORTUNITIES_FILE)) {
-    return { events: [], interventions: [] };
-  }
-  let rawText;
-  try {
-    rawText = await readFile3(path, "utf8");
-  } catch {
-    return { events: [], interventions: [] };
-  }
-  await rm2(path, { force: true }).catch(() => {
-  });
-  let raw;
-  try {
-    raw = JSON.parse(rawText);
-  } catch {
-    return { events: [], interventions: [] };
-  }
-  return sanitizeOpportunities(raw, manifest);
-}
-function sanitizeOpportunities(raw, manifest) {
-  const out = { events: [], interventions: [] };
-  if (typeof raw !== "object" || raw === null) return out;
-  const doc = raw;
-  const knownEvents = new Set(manifest.events.map((e) => normalizeCode(e.eventType)));
-  const knownInterventions = /* @__PURE__ */ new Set([
-    ...manifest.events.flatMap((e) => e.interventions ?? []).map((i) => normalizeCode(i.code)),
-    ...(manifest.interventions ?? []).map((i) => normalizeCode(i.code))
-  ]);
-  const seenEvents = /* @__PURE__ */ new Set();
-  for (const entry of asArray(doc.events)) {
-    const ev = coerceEvent(entry);
-    if (!ev) continue;
-    if (knownEvents.has(ev.code) || seenEvents.has(ev.code)) continue;
-    seenEvents.add(ev.code);
-    out.events.push(ev);
-  }
-  const seenInterventions = /* @__PURE__ */ new Set();
-  for (const entry of asArray(doc.interventions)) {
-    const iv = coerceIntervention(entry);
-    if (!iv) continue;
-    if (knownInterventions.has(iv.code) || seenInterventions.has(iv.code)) continue;
-    seenInterventions.add(iv.code);
-    out.interventions.push(iv);
-  }
-  return out;
-}
-var SUBMIT_TIMEOUT_MS = 3e4;
-async function submitAdditions(config, session, target9, repoFingerprint2, opportunities) {
-  const res = await fetch(`${config.apiBaseUrl}/wizard/universe/additions`, {
-    method: "POST",
-    signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${session.token}`
-    },
-    body: JSON.stringify({
-      target: target9,
-      repoFingerprint: repoFingerprint2,
-      events: opportunities.events,
-      interventions: opportunities.interventions
-    })
-  });
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(
-      `Submitting universe additions failed (${res.status})${body ? `: ${body.slice(0, 300)}` : ""}`
-    );
-  }
-  return await res.json();
-}
-async function submitSuggestions(config, session, target9, repoFingerprint2, opportunities) {
-  const res = await fetch(`${config.apiBaseUrl}/wizard/universe/suggestions`, {
-    method: "POST",
-    signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
-    headers: {
-      "Content-Type": "application/json",
-      Authorization: `Bearer ${session.token}`
-    },
-    body: JSON.stringify({
-      target: target9,
-      repoFingerprint: repoFingerprint2,
-      events: opportunities.events,
-      interventions: opportunities.interventions
-    })
-  });
-  if (res.status === 404) return null;
-  if (!res.ok) {
-    const body = await res.text().catch(() => "");
-    throw new Error(
-      `Submitting universe suggestions failed (${res.status})${body ? `: ${body.slice(0, 300)}` : ""}`
-    );
-  }
-  return await res.json();
-}
-async function fetchSuggestions(config, session, statuses) {
-  if (config.offline) return [];
-  try {
-    const statusQuery = statuses.map(encodeURIComponent).join(",");
-    const url = `${config.apiBaseUrl}/wizard/universe/suggestions${statusQuery ? `?status=${statusQuery}` : ""}`;
-    const res = await fetch(url, {
-      signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
-      headers: { Authorization: `Bearer ${session.token}` }
-    });
-    if (!res.ok) return [];
-    const body = await res.json();
-    return Array.isArray(body) && body.every(isSuggestionRecord) ? body : [];
-  } catch {
-    return [];
-  }
-}
-function isSuggestionRecord(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const record = value;
-  return typeof record.id === "string" && (record.kind === "event" || record.kind === "intervention") && typeof record.code === "string" && (record.status === "proposed" || record.status === "approved" || record.status === "rejected" || record.status === "integrated") && typeof record.payload === "object" && record.payload !== null;
-}
-async function markSuggestionIntegrated(config, session, id, target9, repoFingerprint2) {
-  if (config.offline) return false;
-  try {
-    const res = await fetch(
-      `${config.apiBaseUrl}/wizard/universe/suggestions/${encodeURIComponent(id)}/integrated`,
-      {
-        method: "POST",
-        signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${session.token}`
-        },
-        body: JSON.stringify({ target: target9, repoFingerprint: repoFingerprint2 })
-      }
-    );
-    return res.status === 200;
-  } catch {
-    return false;
-  }
-}
-function asArray(value) {
-  return Array.isArray(value) ? value : [];
-}
-function asString(value) {
-  if (typeof value !== "string") return void 0;
-  const cleaned = value.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)?/g, "").replace(/[\x00-\x1f\x7f]/g, " ").replace(/ {2,}/g, " ").trim();
-  return cleaned ? cleaned : void 0;
-}
-function asConfidence(value) {
-  if (typeof value !== "number" || Number.isNaN(value)) return void 0;
-  return Math.min(1, Math.max(0, value));
-}
-function asWeight(value) {
-  if (typeof value !== "number" || Number.isNaN(value)) return void 0;
-  if (value < 0 || value > 1) return void 0;
-  return value;
-}
-function coerceEvent(entry) {
-  if (typeof entry !== "object" || entry === null) return null;
-  const e = entry;
-  const code = normalizeCode(asString(e.code) ?? "");
-  if (!code) return null;
-  const properties = [];
-  for (const prop of asArray(e.properties)) {
-    if (typeof prop === "string") {
-      if (prop.trim()) properties.push({ name: prop.trim() });
-      continue;
-    }
-    if (typeof prop !== "object" || prop === null) continue;
-    const pr = prop;
-    const name = asString(pr.name);
-    if (!name) continue;
-    const desc = asString(pr.description);
-    properties.push({
-      name,
-      ...desc ? { description: desc } : {},
-      ...pr.required === true ? { required: true } : {}
-    });
-  }
-  const links = [];
-  for (const link of asArray(e.links)) {
-    if (typeof link !== "object" || link === null) continue;
-    const l = link;
-    const interventionCode = normalizeCode(asString(l.interventionCode) ?? "");
-    if (!interventionCode) continue;
-    const weight = asWeight(l.weight);
-    links.push({ interventionCode, ...weight !== void 0 ? { weight } : {} });
-  }
-  const side = normalizeSide(asString(e.side));
-  return {
-    code,
-    label: asString(e.label),
-    description: asString(e.description),
-    ...side ? { side } : {},
-    rationale: asString(e.rationale),
-    expectedEffect: asString(e.expectedEffect),
-    confidence: asConfidence(e.confidence),
-    ...properties.length ? { properties } : {},
-    ...links.length ? { links } : {}
-  };
-}
-function coerceIntervention(entry) {
-  if (typeof entry !== "object" || entry === null) return null;
-  const i = entry;
-  const code = normalizeCode(asString(i.code) ?? "");
-  if (!code) return null;
-  const links = [];
-  for (const link of asArray(i.links)) {
-    if (typeof link !== "object" || link === null) continue;
-    const l = link;
-    const eventCode = normalizeCode(asString(l.eventCode) ?? "");
-    if (!eventCode) continue;
-    const weight = asWeight(l.weight);
-    links.push({ eventCode, ...weight !== void 0 ? { weight } : {} });
-  }
-  return {
-    code,
-    label: asString(i.label),
-    description: asString(i.description),
-    rationale: asString(i.rationale),
-    expectedEffect: asString(i.expectedEffect),
-    confidence: asConfidence(i.confidence),
-    ...links.length ? { links } : {}
-  };
-}
-function normalizeSide(value) {
-  switch (value?.toLowerCase()) {
-    case "frontend":
-      return "frontend";
-    case "backend":
-      return "backend";
-    case "either":
-      return "either";
-    default:
-      return void 0;
-  }
-}
-
 // src/core/playbooks/shared-prompt.ts
 var BASE_WIZARD_PROMPT = `
 You are the Whisperr Wizard \u2014 an expert integration agent running INSIDE a
@@ -1770,55 +1478,51 @@ function renderEventsBrief(m) {
   }
   return lines.join("\n");
 }
-function renderOpportunitiesBrief(m, opportunitiesFile) {
+function renderOpportunitiesBrief(m) {
   const eventCodes = m.events.map((e) => e.eventType);
   const interventionCodes = [
-    ...new Set(m.events.flatMap((e) => e.interventions ?? []).map((i) => i.code))
+    .../* @__PURE__ */ new Set([
+      ...m.events.flatMap((e) => e.interventions ?? []).map((i) => i.code),
+      ...(m.interventions ?? []).map((i) => i.code)
+    ])
   ];
   return [
-    "UNIVERSE OPPORTUNITIES (do this LAST, after your corrections):",
-    "While auditing you read this app's real lifecycle. Now sweep it",
-    "deliberately: walk each surface the plan should care about \u2014 signup and",
-    "auth, billing/payments (renewals, failures, upgrades, downgrades,",
-    "cancellation), the core engagement loop, support/feedback/refund flows,",
-    "sharing/invites, and any expiry or dormancy mechanics you saw \u2014 and for",
-    "each one ask: does a churn-relevant moment happen here that the plan does",
-    "NOT cover? Record those as PROPOSALS. Do NOT add track() calls for them.",
-    `Write a single JSON file at the repo root named ${opportunitiesFile}:`,
+    "Rules for `opportunities` \u2014 what this app's plan is MISSING:",
+    "You are reading this app's real lifecycle anyway. Sweep it deliberately:",
+    "walk each surface the plan should care about \u2014 signup and auth,",
+    "billing/payments (renewals, failures, upgrades, downgrades, cancellation),",
+    "the core engagement loop, support/feedback/refund flows, sharing/invites,",
+    "and any expiry or dormancy mechanics you see \u2014 and for each ask: does a",
+    "churn-relevant moment happen here that the plan does NOT cover?",
     "",
-    "{",
-    '  "events": [{',
-    '    "code": "snake_case_event", "label": "...", "description": "...",',
+    "Entry shapes:",
+    '  events: [{"code": "snake_case_event", "label": "...", "description": "...",',
     '    "side": "frontend|backend|either", "rationale": "what in the code shows this",',
     '    "expectedEffect": "one sentence: what improves if this is adopted",',
     '    "confidence": 0.0-1.0,',
     '    "properties": [{"name": "...", "description": "...", "required": false}],',
-    '    "links": [{"interventionCode": "existing_or_proposed", "weight": 0.0-1.0}]',
-    "  }],",
-    '  "interventions": [{',
-    '    "code": "snake_case_strategy", "label": "...", "description": "...",',
-    '    "rationale": "...", "confidence": 0.0-1.0,',
-    '    "expectedEffect": "one sentence: what improves if this is adopted",',
-    '    "links": [{"eventCode": "existing_or_proposed", "weight": 0.0-1.0}]',
-    "  }]",
-    "}",
+    '    "links": [{"interventionCode": "existing_or_proposed", "weight": 0.0-1.0}]}]',
+    '  interventions: [{"code": "snake_case_strategy", "label": "...", "description": "...",',
+    '    "rationale": "...", "confidence": 0.0-1.0, "expectedEffect": "...",',
+    '    "links": [{"eventCode": "existing_or_proposed", "weight": 0.0-1.0}]}]',
     "",
-    "Rules:",
     `- The plan already covers these events: ${eventCodes.join(", ") || "(none)"}.`,
     `  And these interventions: ${interventionCodes.join(", ") || "(none)"}.`,
     "  Propose ONLY what is genuinely missing \u2014 never re-propose or rename these.",
-    "- Every proposal needs concrete code evidence in its rationale (file/flow),",
-    "  not speculation. VERIFY before you write: re-open the file you are citing",
-    "  and confirm the flow exists as described \u2014 a false suggestion costs more",
-    "  trust than a missed one, so drop anything you cannot point at real code.",
+    "- These go straight into the customer's universe, and the events you propose",
+    "  get instrumented in this same run. That raises the bar on evidence, not the",
+    "  volume: every proposal needs concrete code backing in its rationale, with",
+    "  the file/flow named. VERIFY before you write it \u2014 re-open the file you are",
+    "  citing and confirm the flow exists as you describe. Drop anything you",
+    "  cannot point at real code; a false proposal costs more trust than a missed one.",
+    "- Say where you saw it in `rationale` precisely enough to wire from later \u2014",
+    "  it is the only placement note the wiring pass will have for these.",
     "- Be thorough, not shy: a feature-rich product typically yields 3-6 solid",
-    "  event proposals and 1-3 interventions. An empty file is only the right",
-    "  answer when the plan genuinely already covers the product's lifecycle \u2014",
-    "  never because you stopped looking early.",
-    "- Every proposal should include expectedEffect: one sentence explaining what adoption should improve.",
+    "  event proposals and 1-3 interventions. Empty is only right when the plan",
+    "  genuinely covers the product's lifecycle \u2014 never because you stopped early.",
+    "- Every proposal should include expectedEffect: one sentence on what adoption improves.",
     "- Link each proposed event to the intervention(s) it should feed (existing",
-    "  codes or ones you propose in the same file).",
-    "- This file is metadata for the wizard, not app code \u2014 write it and move on."
+    "  codes or ones you propose alongside it)."
   ].join("\n");
 }
 function coverageNote(coverage) {
@@ -2140,36 +1844,56 @@ function tokenizeShellSegment(segment) {
 
 // src/core/agent.ts
 async function runIntegrationAgent(opts) {
-  const { repoPath, config, session, playbook, manifest, progress, onPlanReady } = opts;
-  applyModelAuthEnv(config, session);
-  const systemPrompt9 = [BASE_WIZARD_PROMPT, playbook.systemPrompt].join("\n\n");
-  const started = Date.now();
-  let costUsd = 0;
+  const {
+    repoPath,
+    config,
+    session,
+    playbook,
+    manifest,
+    progress,
+    onPlanReady,
+    onOpportunitiesReady
+  } = opts;
+  applyModelAuthEnv(config, session);
+  const systemPrompt9 = [BASE_WIZARD_PROMPT, playbook.systemPrompt].join("\n\n");
+  const started = Date.now();
+  let costUsd = 0;
   const summaries = [];
   let repoMap = "";
   let eventOutcomes = [];
   const phaseTimings = [];
   const BUDGET_FLOOR = 0.25;
+  let planning = { repoMap: "", plan: null, opportunities: emptyOpportunities() };
   if (config.budgetUsd - costUsd > BUDGET_FLOOR) {
     try {
-      const map = await runTimedPass("Mapping your codebase", {
-        prompt: renderRepoMapPrompt(repoPath),
+      const pass = await runTimedPass("Planning your integration", {
+        prompt: renderPlanningPrompt(repoPath, playbook, manifest),
         systemPrompt: systemPrompt9,
         repoPath,
         model: config.plannerModel,
         effort: "high",
-        maxTurns: 40,
-        budgetUsd: Math.min(config.budgetUsd - costUsd, config.budgetUsd * 0.15),
+        maxTurns: 60,
+        budgetUsd: Math.min(config.budgetUsd - costUsd, config.budgetUsd * 0.3),
         allowedTools: READ_ONLY_TOOLS,
         progress
       }, phaseTimings);
-      costUsd += map.costUsd;
-      repoMap = sliceRepoMap(map.summary);
+      costUsd += pass.costUsd;
+      planning = parsePlanningResult(pass.summary);
     } catch (err) {
-      debugNote(`repo map pass failed: ${err.message}`);
-      repoMap = "";
+      debugNote(`planning pass failed: ${err.message}`);
     }
   }
+  repoMap = planning.repoMap;
+  let scopedPlan = null;
+  if (planning.plan) {
+    scopedPlan = planForManifest(planning.plan, manifest);
+    const reviewedPlan = await onPlanReady?.(scopedPlan);
+    if (reviewedPlan !== void 0 && reviewedPlan !== null) {
+      scopedPlan = planForManifest(reviewedPlan, manifest);
+    }
+  }
+  let appliedOpportunityEvents = [];
+  const opportunitiesProposed = planning.opportunities.events.length + planning.opportunities.interventions.length;
   const corePrompt = [
     `Integrate the Whisperr ${playbook.target.displayName} SDK \u2014 CORE SETUP ONLY.`,
     `Project root: ${repoPath}`,
@@ -2212,6 +1936,13 @@ async function runIntegrationAgent(opts) {
   costUsd += core.costUsd;
   if (core.summary) summaries.push(`Core setup:
 ${core.summary}`);
+  if (onOpportunitiesReady && opportunitiesProposed > 0 && core.ok) {
+    try {
+      appliedOpportunityEvents = await onOpportunitiesReady(planning.opportunities);
+    } catch (err) {
+      debugNote(`universe additions failed: ${err.message}`);
+    }
+  }
   let eventsComplete = true;
   if (manifest.events.length > 0 && config.budgetUsd - costUsd <= BUDGET_FLOOR) {
     eventsComplete = false;
@@ -2224,20 +1955,7 @@ ${core.summary}`);
       "Events: skipped \u2014 the spend limit was reached during core setup. Re-run with a higher WHISPERR_WIZARD_BUDGET_USD to instrument events."
     );
   } else if (manifest.events.length > 0) {
-    const planPass = await runTimedPass("Planning event placements", {
-      prompt: renderEventPlanPrompt(repoPath, playbook, manifest, repoMap),
-      systemPrompt: systemPrompt9,
-      repoPath,
-      model: config.plannerModel,
-      effort: "high",
-      maxTurns: 40,
-      budgetUsd: config.budgetUsd - costUsd,
-      allowedTools: READ_ONLY_TOOLS,
-      progress
-    }, phaseTimings);
-    costUsd += planPass.costUsd;
-    const plan = parseEventPlan(planPass.summary);
-    if (!plan) {
+    if (!scopedPlan) {
       debugNote("event plan parse failed; falling back to direct event wiring");
       progress?.onActivity?.("Event plan was not parseable; falling back to direct wiring");
       const direct = await runDirectEventsPass({
@@ -2257,21 +1975,23 @@ ${core.summary}`);
       if (direct.pass.summary) summaries.push(`Events:
 ${direct.pass.summary}`);
     } else {
-      let scopedPlan = planForManifest(plan, manifest);
-      const reviewedPlan = await onPlanReady?.(scopedPlan);
-      if (reviewedPlan !== void 0 && reviewedPlan !== null) {
-        scopedPlan = planForManifest(reviewedPlan, manifest);
-      }
       const placeEntries = scopedPlan.filter((entry) => entry.decision === "place");
       const unsureEntries = scopedPlan.filter((entry) => entry.decision === "unsure");
       let wire;
-      if (placeEntries.length && config.budgetUsd - costUsd > BUDGET_FLOOR) {
+      const hasWorkToWire = placeEntries.length > 0 || appliedOpportunityEvents.length > 0;
+      if (hasWorkToWire && config.budgetUsd - costUsd > BUDGET_FLOOR) {
         wire = await runTimedPass("Instrumenting planned events", {
-          prompt: renderEventWirePrompt(repoPath, playbook, repoMap, placeEntries),
+          prompt: renderEventWirePrompt(
+            repoPath,
+            playbook,
+            repoMap,
+            placeEntries,
+            appliedOpportunityEvents
+          ),
           systemPrompt: systemPrompt9,
           repoPath,
           model: config.model,
-          effort: "high",
+          effort: "medium",
           maxTurns: config.maxTurns,
           budgetUsd: config.budgetUsd - costUsd,
           progress
@@ -2279,7 +1999,7 @@ ${direct.pass.summary}`);
         costUsd += wire.costUsd;
         if (wire.summary) summaries.push(`Events:
 ${wire.summary}`);
-      } else if (!placeEntries.length) {
+      } else if (!hasWorkToWire) {
         summaries.push("Events: no events had a confident placement in this surface.");
       }
       let wired = await scanManifestEvents(repoPath, manifest);
@@ -2303,7 +2023,7 @@ ${followUp.summary}`);
         wired = await scanManifestEvents(repoPath, manifest);
       }
       eventOutcomes = buildEventOutcomes(manifest, scopedPlan, wired);
-      eventsComplete = !planPass.maxedOut && !(wire?.maxedOut ?? false) && !(followUp?.maxedOut ?? false);
+      eventsComplete = !(wire?.maxedOut ?? false) && !(followUp?.maxedOut ?? false);
     }
   }
   if (core.ok && config.budgetUsd - costUsd > BUDGET_FLOOR) {
@@ -2313,7 +2033,7 @@ ${followUp.summary}`);
       `Project root: ${repoPath}`,
       "",
       ...renderRepoMapSection(repoMap),
-      "Run `git diff` and read the surrounding code to see exactly what you added.",
+      "Run `git diff` and read ONLY the code immediately around each change.",
       "For every identify() and track() call, verify \u2014 and FIX in place:",
       "1. Subject \u2014 keys to the END USER, never an admin/staff/operator/seller.",
       "   identify() sits on the SAME surface as account_created (same person).",
@@ -2327,21 +2047,19 @@ ${followUp.summary}`);
       "   / payment_source / amount / plan). Add the ones you missed.",
       "4. Coverage \u2014 every gateway/callback path that should emit an event does;",
       "   no recurring or secondary path left as a dead zone.",
-      "Change ONLY what is genuinely wrong or incomplete \u2014 do not churn correct",
-      "calls or re-explore the whole repo. Be surgical.",
-      "",
-      renderOpportunitiesBrief(manifest, OPPORTUNITIES_FILE),
+      "Work from the diff. Do NOT re-explore the repository, do NOT propose new",
+      "events, and change ONLY what is genuinely wrong or incomplete. Be surgical.",
       "",
       "End with a one-line, plain-text note of what you corrected (or 'No",
-      "corrections needed.'), plus one line on what you proposed, if anything."
+      "corrections needed.')."
     ].join("\n");
     const review = await runTimedPass("Reviewing & correcting placements", {
       prompt: reviewPrompt,
       systemPrompt: systemPrompt9,
       repoPath,
-      model: config.plannerModel,
+      model: config.strictReview ? config.plannerModel : config.model,
       effort: "medium",
-      maxTurns: 40,
+      maxTurns: config.strictReview ? 40 : 15,
       budgetUsd: config.budgetUsd - costUsd,
       progress
     }, phaseTimings);
@@ -2364,57 +2082,11 @@ ${review.summary}`);
     coreOk: core.ok,
     eventsComplete,
     eventOutcomes,
-    repoMap: repoMap || void 0
+    repoMap: repoMap || void 0,
+    opportunitiesProposed,
+    opportunitiesApplied: appliedOpportunityEvents.length
   };
 }
-async function runAdditionsInstrumentationPass(opts) {
-  const { repoPath, config, session, playbook, acceptedEvents, budgetUsd, repoMap, progress } = opts;
-  if (!acceptedEvents.length || budgetUsd <= 0) {
-    return { summary: "", costUsd: 0, ran: false };
-  }
-  applyModelAuthEnv(config, session);
-  const systemPrompt9 = [BASE_WIZARD_PROMPT, playbook.systemPrompt].join("\n\n");
-  const eventLines = [];
-  for (const e of acceptedEvents) {
-    eventLines.push("");
-    eventLines.push(`\u25A0 ${e.code}${e.label ? `  (${e.label})` : ""}`);
-    if (e.description) eventLines.push(`  ${e.description}`);
-    if (e.rationale) eventLines.push(`  where: ${e.rationale}`);
-    if (e.properties?.length) {
-      eventLines.push("  properties to capture if available:");
-      for (const prop of e.properties) {
-        eventLines.push(`    \xB7 ${prop.name}${prop.required ? " (required)" : ""}${prop.description ? ` \u2014 ${prop.description}` : ""}`);
-      }
-    }
-  }
-  progress?.onPhase?.("Instrumenting the newly added events");
-  const prompt = [
-    "You proposed these events as universe opportunities while reviewing this",
-    "repo, and the user just APPROVED adding them to the plan. Instrument them",
-    "now with track(), exactly like the plan's other events: place each at the",
-    "real call site (your own rationale tells you where you saw it), attach the",
-    "properties available in scope, and skip anything that turns out not to have",
-    "a clear trigger after all. The SDK is already installed and initialized.",
-    `Project root: ${repoPath}`,
-    "",
-    ...renderRepoMapSection(repoMap),
-    "----- APPROVED NEW EVENTS -----",
-    ...eventLines,
-    "",
-    "----- END -----"
-  ].join("\n");
-  const pass = await runPass({
-    prompt,
-    systemPrompt: systemPrompt9,
-    repoPath,
-    model: config.model,
-    effort: config.effort,
-    maxTurns: 25,
-    budgetUsd,
-    progress
-  });
-  return { summary: pass.summary, costUsd: pass.costUsd, ran: true };
-}
 async function runRepairPass(opts) {
   const {
     repoPath,
@@ -2458,11 +2130,64 @@ async function runRepairPass(opts) {
 }
 var READ_ONLY_TOOLS = ["Read", "Glob", "Grep"];
 var FULL_TOOLS = ["Read", "Edit", "Write", "Bash", "Glob", "Grep"];
+var PLANNING_JSON_FENCE = /```json\s*([\s\S]*?)```/;
+function scrubTerminalText(value) {
+  return value.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)?/g, "").replace(/[\x00-\x1f\x7f]/g, " ").replace(/ {2,}/g, " ").trim();
+}
+function emptyOpportunities() {
+  return { events: [], interventions: [] };
+}
+function parsePlanningResult(text) {
+  const fenced = PLANNING_JSON_FENCE.exec(text);
+  const payload = parseJsonObject(fenced?.[1]) ?? parseJsonObject(sliceLastJsonObject(text));
+  const mapText = fenced ? text.slice(0, fenced.index) : text;
+  const repoMap = sliceRepoMap(stripMapMarkers(mapText));
+  if (!payload) {
+    return { repoMap, plan: parseEventPlan(text), opportunities: emptyOpportunities() };
+  }
+  return {
+    repoMap,
+    plan: Array.isArray(payload.plan) ? coerceEventPlan(payload.plan) : null,
+    opportunities: coerceOpportunities(payload.opportunities)
+  };
+}
+function parseJsonObject(raw) {
+  if (!raw?.trim()) return null;
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+      const obj = parsed;
+      if ("plan" in obj || "opportunities" in obj) return obj;
+    }
+  } catch {
+  }
+  return null;
+}
+function sliceLastJsonObject(text) {
+  const start = text.lastIndexOf("{\n");
+  const from = start >= 0 ? start : text.indexOf("{");
+  if (from < 0) return null;
+  return sliceBalanced(text, from, "{", "}");
+}
+function stripMapMarkers(text) {
+  return text.replace(/^-+\s*REPO MAP\s*-+$/gim, "").replace(/^-+\s*END REPO MAP\s*-+$/gim, "").trim();
+}
+function coerceOpportunities(raw) {
+  if (!raw || typeof raw !== "object" || Array.isArray(raw)) return emptyOpportunities();
+  const doc = raw;
+  return {
+    events: Array.isArray(doc.events) ? doc.events : [],
+    interventions: Array.isArray(doc.interventions) ? doc.interventions : []
+  };
+}
 function parseEventPlan(text) {
   const parsed = parseFirstJsonArray(text);
   if (!Array.isArray(parsed)) return null;
+  return coerceEventPlan(parsed);
+}
+function coerceEventPlan(items) {
   const entries = [];
-  for (const item of parsed) {
+  for (const item of items) {
     if (!item || typeof item !== "object" || Array.isArray(item)) return null;
     const obj = item;
     const event = typeof obj.event === "string" ? obj.event.trim() : "";
@@ -2473,7 +2198,10 @@ function parseEventPlan(text) {
     const entry = {
       event,
       decision,
-      reason: typeof obj.reason === "string" ? obj.reason.trim() : ""
+      // Model-authored text that ends up in the customer's terminal and in
+      // the run report — scrub it like every other string we take from the
+      // model, so it cannot restyle or spoof the surrounding UI.
+      reason: typeof obj.reason === "string" ? scrubTerminalText(obj.reason) : ""
     };
     if (typeof obj.file === "string" && obj.file.trim()) {
       entry.file = obj.file.trim();
@@ -2491,7 +2219,7 @@ function parseEventPlan(text) {
 function parseFirstJsonArray(text) {
   const start = text.indexOf("[");
   if (start < 0) return null;
-  const json = sliceJsonArray(text, start);
+  const json = sliceBalanced(text, start, "[", "]");
   if (!json) return null;
   try {
     return JSON.parse(json);
@@ -2499,7 +2227,7 @@ function parseFirstJsonArray(text) {
     return null;
   }
 }
-function sliceJsonArray(text, start) {
+function sliceBalanced(text, start, open3, close) {
   let depth = 0;
   let inString = false;
   let escaped = false;
@@ -2517,31 +2245,15 @@ function sliceJsonArray(text, start) {
     }
     if (ch === '"') {
       inString = true;
-    } else if (ch === "[") {
+    } else if (ch === open3) {
       depth++;
-    } else if (ch === "]") {
+    } else if (ch === close) {
       depth--;
       if (depth === 0) return text.slice(start, i + 1);
     }
   }
   return null;
 }
-function renderRepoMapPrompt(repoPath) {
-  return [
-    "Map this repository for a Whisperr SDK integration. This is READ-ONLY.",
-    `Project root: ${repoPath}`,
-    "",
-    "Produce a concise structured repo map as final text with these exact sections:",
-    "- framework + entry points",
-    "- auth flows enumerated: END-USER vs admin/staff, with precise file paths",
-    "- billing/payment/webhook surfaces",
-    "- analytics/tracking wrapper if any",
-    "- state management",
-    "- directory guide: which dirs hold pages/controllers/services",
-    "",
-    "This map guides event placement. List file paths precisely. No prose beyond the map."
-  ].join("\n");
-}
 function sliceRepoMap(map) {
   return map.trim().slice(0, 8e3);
 }
@@ -2550,30 +2262,46 @@ function renderRepoMapSection(repoMap) {
   if (!map) return [];
   return ["----- REPO MAP -----", map, "----- END REPO MAP -----", ""];
 }
-function renderEventPlanPrompt(repoPath, playbook, manifest, repoMap) {
+function renderPlanningPrompt(repoPath, playbook, manifest) {
   return [
-    `Plan Whisperr ${playbook.target.displayName} event placements. This is READ-ONLY.`,
+    `Plan the Whisperr ${playbook.target.displayName} integration for this repo.`,
+    "This pass is READ-ONLY \u2014 do not edit anything. You are deciding what the",
+    "editing passes will do, so be precise about files and anchors.",
     `Project root: ${repoPath}`,
     "",
-    ...renderRepoMapSection(repoMap),
-    "Use the repo map and the events brief to decide where each event belongs.",
-    "Return ONLY a JSON code block containing an array with this shape:",
-    '[{"event":"event_name","decision":"place|skip|unsure","file":"path","anchor":"function/route/handler","properties":["prop"],"reason":"short reason"}]',
+    "Produce your answer in TWO parts, in this order.",
     "",
-    "Rules:",
+    "PART 1 \u2014 the repo map, as plain text under these exact sections:",
+    "- framework + entry points",
+    "- auth flows enumerated: END-USER vs admin/staff, with precise file paths",
+    "- billing/payment/webhook surfaces",
+    "- analytics/tracking wrapper if any",
+    "- state management",
+    "- directory guide: which dirs hold pages/controllers/services",
+    "List file paths precisely. No prose beyond the map.",
+    "",
+    "PART 2 \u2014 a single ```json fenced block, and nothing after it:",
+    "{",
+    '  "plan": [{"event":"event_name","decision":"place|skip|unsure","file":"path",',
+    '            "anchor":"function/route/handler","properties":["prop"],"reason":"short reason"}],',
+    '  "opportunities": {"events": [], "interventions": []}',
+    "}",
+    "",
+    "Rules for `plan` \u2014 one entry per event in the brief below:",
     "- decision=place only when there is a concrete end-user call site in this repo.",
     "- decision=skip when the event clearly lives on another surface or does not exist here.",
     "- decision=unsure when there is a plausible surface but the exact anchor is not proven.",
     "- For place decisions, include file and anchor precisely.",
     "- properties should list only properties likely available at that anchor.",
-    "- No prose beyond the JSON code block.",
+    "",
+    renderOpportunitiesBrief(manifest),
     "",
     "----- EVENTS -----",
     renderEventsBrief(manifest),
     "----- END EVENTS -----"
   ].join("\n");
 }
-function renderEventWirePrompt(repoPath, playbook, repoMap, entries) {
+function renderEventWirePrompt(repoPath, playbook, repoMap, entries, addedEvents = []) {
   return [
     `The Whisperr ${playbook.target.displayName} SDK is installed and initialized.`,
     "Wire only the planned event placements below with track().",
@@ -2586,9 +2314,39 @@ function renderEventWirePrompt(repoPath, playbook, repoMap, entries) {
     "",
     "----- EVENT WIRING PLAN -----",
     ...renderPlanEntryLines(entries),
-    "----- END EVENT WIRING PLAN -----"
+    "----- END EVENT WIRING PLAN -----",
+    // Events the planner proposed and the universe accepted this run. They have
+    // no plan entry (they weren't in the manifest when the plan was written), so
+    // the rationale carries the placement — the planner already saw the site.
+    ...addedEvents.length ? [
+      "",
+      "----- NEWLY ADDED EVENTS -----",
+      "You proposed these while planning and they are now part of this app's",
+      "universe. Wire them the same way \u2014 your own rationale says where you",
+      "saw each one. Skip any that turn out not to have a clear trigger.",
+      ...renderAddedEventLines(addedEvents),
+      "----- END NEWLY ADDED EVENTS -----"
+    ] : []
   ].join("\n");
 }
+function renderAddedEventLines(events) {
+  const lines = [];
+  for (const event of events) {
+    lines.push("");
+    lines.push(`\u25A0 ${event.code}${event.label ? `  (${event.label})` : ""}`);
+    if (event.description) lines.push(`  ${event.description}`);
+    if (event.rationale) lines.push(`  where: ${event.rationale}`);
+    if (event.properties?.length) {
+      lines.push("  properties to capture if available:");
+      for (const prop of event.properties) {
+        lines.push(
+          `    \xB7 ${prop.name}${prop.required ? " (required)" : ""}${prop.description ? ` \u2014 ${prop.description}` : ""}`
+        );
+      }
+    }
+  }
+  return lines;
+}
 function renderEventReconcilePrompt(repoPath, playbook, repoMap, entries) {
   return [
     `One targeted follow-up for Whisperr ${playbook.target.displayName} events.`,
@@ -2933,6 +2691,224 @@ function short(s, max = 60) {
   return s.length > max ? `${s.slice(0, max - 1)}\u2026` : s;
 }
 
+// src/core/opportunities.ts
+function normalizeCode(value) {
+  return value.trim().toLowerCase().replace(/[ \-./]/g, "_").replace(/[^a-z0-9_]/g, "").replace(/_+/g, "_").replace(/^_+|_+$/g, "");
+}
+function sanitizeOpportunities(raw, manifest) {
+  const out = { events: [], interventions: [] };
+  if (typeof raw !== "object" || raw === null) return out;
+  const doc = raw;
+  const knownEvents = new Set(manifest.events.map((e) => normalizeCode(e.eventType)));
+  const knownInterventions = /* @__PURE__ */ new Set([
+    ...manifest.events.flatMap((e) => e.interventions ?? []).map((i) => normalizeCode(i.code)),
+    ...(manifest.interventions ?? []).map((i) => normalizeCode(i.code))
+  ]);
+  const seenEvents = /* @__PURE__ */ new Set();
+  for (const entry of asArray(doc.events)) {
+    const ev = coerceEvent(entry);
+    if (!ev) continue;
+    if (knownEvents.has(ev.code) || seenEvents.has(ev.code)) continue;
+    seenEvents.add(ev.code);
+    out.events.push(ev);
+  }
+  const seenInterventions = /* @__PURE__ */ new Set();
+  for (const entry of asArray(doc.interventions)) {
+    const iv = coerceIntervention(entry);
+    if (!iv) continue;
+    if (knownInterventions.has(iv.code) || seenInterventions.has(iv.code)) continue;
+    seenInterventions.add(iv.code);
+    out.interventions.push(iv);
+  }
+  return out;
+}
+var SUBMIT_TIMEOUT_MS = 3e4;
+async function submitAdditions(config, session, target9, repoFingerprint2, opportunities) {
+  const res = await fetch(`${config.apiBaseUrl}/wizard/universe/additions`, {
+    method: "POST",
+    signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${session.token}`
+    },
+    body: JSON.stringify({
+      target: target9,
+      repoFingerprint: repoFingerprint2,
+      events: opportunities.events,
+      interventions: opportunities.interventions
+    })
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(
+      `Submitting universe additions failed (${res.status})${body ? `: ${body.slice(0, 300)}` : ""}`
+    );
+  }
+  return await res.json();
+}
+async function submitSuggestions(config, session, target9, repoFingerprint2, opportunities) {
+  const res = await fetch(`${config.apiBaseUrl}/wizard/universe/suggestions`, {
+    method: "POST",
+    signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${session.token}`
+    },
+    body: JSON.stringify({
+      target: target9,
+      repoFingerprint: repoFingerprint2,
+      events: opportunities.events,
+      interventions: opportunities.interventions
+    })
+  });
+  if (res.status === 404) return null;
+  if (!res.ok) {
+    const body = await res.text().catch(() => "");
+    throw new Error(
+      `Submitting universe suggestions failed (${res.status})${body ? `: ${body.slice(0, 300)}` : ""}`
+    );
+  }
+  return await res.json();
+}
+async function fetchSuggestions(config, session, statuses) {
+  if (config.offline) return [];
+  try {
+    const statusQuery = statuses.map(encodeURIComponent).join(",");
+    const url = `${config.apiBaseUrl}/wizard/universe/suggestions${statusQuery ? `?status=${statusQuery}` : ""}`;
+    const res = await fetch(url, {
+      signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
+      headers: { Authorization: `Bearer ${session.token}` }
+    });
+    if (!res.ok) return [];
+    const body = await res.json();
+    return Array.isArray(body) && body.every(isSuggestionRecord) ? body : [];
+  } catch {
+    return [];
+  }
+}
+function isSuggestionRecord(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const record = value;
+  return typeof record.id === "string" && (record.kind === "event" || record.kind === "intervention") && typeof record.code === "string" && (record.status === "proposed" || record.status === "approved" || record.status === "rejected" || record.status === "integrated") && typeof record.payload === "object" && record.payload !== null;
+}
+async function markSuggestionIntegrated(config, session, id, target9, repoFingerprint2) {
+  if (config.offline) return false;
+  try {
+    const res = await fetch(
+      `${config.apiBaseUrl}/wizard/universe/suggestions/${encodeURIComponent(id)}/integrated`,
+      {
+        method: "POST",
+        signal: AbortSignal.timeout(SUBMIT_TIMEOUT_MS),
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${session.token}`
+        },
+        body: JSON.stringify({ target: target9, repoFingerprint: repoFingerprint2 })
+      }
+    );
+    return res.status === 200;
+  } catch {
+    return false;
+  }
+}
+function asArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+function asString(value) {
+  if (typeof value !== "string") return void 0;
+  const cleaned = value.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)?/g, "").replace(/[\x00-\x1f\x7f]/g, " ").replace(/ {2,}/g, " ").trim();
+  return cleaned ? cleaned : void 0;
+}
+function asConfidence(value) {
+  if (typeof value !== "number" || Number.isNaN(value)) return void 0;
+  return Math.min(1, Math.max(0, value));
+}
+function asWeight(value) {
+  if (typeof value !== "number" || Number.isNaN(value)) return void 0;
+  if (value < 0 || value > 1) return void 0;
+  return value;
+}
+function coerceEvent(entry) {
+  if (typeof entry !== "object" || entry === null) return null;
+  const e = entry;
+  const code = normalizeCode(asString(e.code) ?? "");
+  if (!code) return null;
+  const properties = [];
+  for (const prop of asArray(e.properties)) {
+    if (typeof prop === "string") {
+      if (prop.trim()) properties.push({ name: prop.trim() });
+      continue;
+    }
+    if (typeof prop !== "object" || prop === null) continue;
+    const pr = prop;
+    const name = asString(pr.name);
+    if (!name) continue;
+    const desc = asString(pr.description);
+    properties.push({
+      name,
+      ...desc ? { description: desc } : {},
+      ...pr.required === true ? { required: true } : {}
+    });
+  }
+  const links = [];
+  for (const link of asArray(e.links)) {
+    if (typeof link !== "object" || link === null) continue;
+    const l = link;
+    const interventionCode = normalizeCode(asString(l.interventionCode) ?? "");
+    if (!interventionCode) continue;
+    const weight = asWeight(l.weight);
+    links.push({ interventionCode, ...weight !== void 0 ? { weight } : {} });
+  }
+  const side = normalizeSide(asString(e.side));
+  return {
+    code,
+    label: asString(e.label),
+    description: asString(e.description),
+    ...side ? { side } : {},
+    rationale: asString(e.rationale),
+    expectedEffect: asString(e.expectedEffect),
+    confidence: asConfidence(e.confidence),
+    ...properties.length ? { properties } : {},
+    ...links.length ? { links } : {}
+  };
+}
+function coerceIntervention(entry) {
+  if (typeof entry !== "object" || entry === null) return null;
+  const i = entry;
+  const code = normalizeCode(asString(i.code) ?? "");
+  if (!code) return null;
+  const links = [];
+  for (const link of asArray(i.links)) {
+    if (typeof link !== "object" || link === null) continue;
+    const l = link;
+    const eventCode = normalizeCode(asString(l.eventCode) ?? "");
+    if (!eventCode) continue;
+    const weight = asWeight(l.weight);
+    links.push({ eventCode, ...weight !== void 0 ? { weight } : {} });
+  }
+  return {
+    code,
+    label: asString(i.label),
+    description: asString(i.description),
+    rationale: asString(i.rationale),
+    expectedEffect: asString(i.expectedEffect),
+    confidence: asConfidence(i.confidence),
+    ...links.length ? { links } : {}
+  };
+}
+function normalizeSide(value) {
+  switch (value?.toLowerCase()) {
+    case "frontend":
+      return "frontend";
+    case "backend":
+      return "backend";
+    case "either":
+      return "either";
+    default:
+      return void 0;
+  }
+}
+
 // src/core/verify.ts
 async function pollFirstEvent(config, session, opts = {}) {
   if (config.offline) return { received: false };
@@ -3053,6 +3029,25 @@ function scrubTerminalControls(value) {
   return value.replace(/\x1b\[[0-9;?]*[ -/]*[@-~]/g, "").replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)?/g, "").replace(/[\x00-\x1f\x7f]/g, " ").replace(/ {2,}/g, " ").trim();
 }
 
+// src/core/version.ts
+import { readFileSync } from "fs";
+import { dirname as dirname2, join as join3, parse } from "path";
+import { fileURLToPath } from "url";
+var PACKAGE_NAME = "@whisperr/wizard";
+function packageVersion() {
+  let dir = dirname2(fileURLToPath(import.meta.url));
+  const { root } = parse(dir);
+  while (true) {
+    try {
+      const pkg = JSON.parse(readFileSync(join3(dir, "package.json"), "utf8"));
+      if (pkg.name === PACKAGE_NAME && pkg.version) return pkg.version;
+    } catch {
+    }
+    if (dir === root) return "0.0.0";
+    dir = dirname2(dir);
+  }
+}
+
 // src/core/gapreport.ts
 function buildGapReport(input) {
   const outcomes = new Map(
@@ -3280,39 +3275,56 @@ Flutter is live today; ${theme.bright(
     p.log.step(theme.bright(phaseLabel));
   }
   const tick = useIntegrationSpinner ? setInterval(updateIntegrationMessage, 1e3) : void 0;
+  const additions = { proposed: 0, applied: [] };
+  const interactive = Boolean(process.stdout.isTTY && process.stdin.isTTY);
   const outcome = await runIntegrationAgent({
     repoPath,
     config,
     session,
     playbook: chosen.playbook,
     manifest,
-    ...process.stdout.isTTY && process.stdin.isTTY ? {
-      async onPlanReady(plan) {
-        if (useIntegrationSpinner) {
-          spin.stop(theme.success("Placement plan ready"));
-        }
-        p.note(renderPlacementPlan(plan), "Placement plan");
-        const placeEntries = plan.filter((entry) => entry.decision === "place");
-        let selectedEvents = placeEntries.map((entry) => entry.event);
-        if (placeEntries.length) {
-          const selection = await p.multiselect({
-            message: "Wire these events?",
-            options: placeEntries.map((entry) => ({
-              value: entry.event,
-              label: entry.event,
-              hint: `${entry.file ?? "unknown file"}@${entry.anchor ?? "unknown anchor"}`
-            })),
-            initialValues: selectedEvents,
-            required: false
-          });
-          selectedEvents = p.isCancel(selection) ? [] : selection;
-        }
-        if (useIntegrationSpinner) {
-          spin.start(theme.bright("Continuing integration"));
-        }
-        return filterEventPlan(plan, selectedEvents);
+    // The plan is always shown — it's the last look at what's about to change
+    // in their code. It only becomes a question under --review-plan; the
+    // default run reads it out and keeps going.
+    async onPlanReady(plan) {
+      if (useIntegrationSpinner) {
+        spin.stop(theme.success("Placement plan ready"));
       }
-    } : {},
+      p.note(renderPlacementPlan(plan), "Placement plan");
+      const placeEntries = plan.filter((entry) => entry.decision === "place");
+      let selectedEvents = placeEntries.map((entry) => entry.event);
+      if (config.reviewPlan && interactive && placeEntries.length) {
+        const selection = await p.multiselect({
+          message: "Wire these events?",
+          options: placeEntries.map((entry) => ({
+            value: entry.event,
+            label: entry.event,
+            hint: `${entry.file ?? "unknown file"}@${entry.anchor ?? "unknown anchor"}`
+          })),
+          initialValues: selectedEvents,
+          required: false
+        });
+        selectedEvents = p.isCancel(selection) ? [] : selection;
+      }
+      if (useIntegrationSpinner) {
+        spin.start(theme.bright("Continuing integration"));
+      }
+      return filterEventPlan(plan, selectedEvents);
+    },
+    async onOpportunitiesReady(raw) {
+      if (useIntegrationSpinner) spin.stop(theme.success("Planning done"));
+      const applied = await applyOpportunities({
+        config,
+        session,
+        playbook: chosen.playbook,
+        manifest,
+        fingerprint,
+        raw,
+        additions
+      });
+      if (useIntegrationSpinner) spin.start(theme.bright("Continuing integration"));
+      return applied;
+    },
     progress: {
       onPhase(label) {
         phaseLabel = label;
@@ -3336,13 +3348,78 @@ Flutter is live today; ${theme.bright(
     return null;
   });
   if (tick) clearInterval(tick);
+  let verified = null;
+  let reported = false;
+  const collectReportEvents = async () => {
+    if (!outcome) return [];
+    const eventOutcomeByType = new Map(
+      outcome.eventOutcomes.map((event) => [event.event, event])
+    );
+    const eventTypes = [
+      ...manifest.events.map((e) => e.eventType),
+      ...additions.applied.map((e) => e.code)
+    ];
+    let wired = /* @__PURE__ */ new Map();
+    try {
+      wired = await scanWiredEvents(
+        repoPath,
+        await changedFiles(repoPath, checkpoint),
+        eventTypes
+      );
+    } catch {
+    }
+    return eventTypes.map((eventType) => ({
+      event_type: eventType,
+      status: wired.has(eventType) ? "wired" : "skipped",
+      file: wired.get(eventType),
+      // The agent's own words on why it skipped — the field that answers "why
+      // didn't it wire X" without anyone opening the repo.
+      reason: wired.has(eventType) ? void 0 : eventOutcomeByType.get(eventType)?.reason
+    }));
+  };
+  const reportRun = async (exitClass) => {
+    if (reported) return [];
+    reported = true;
+    const reportEvents2 = await collectReportEvents();
+    const result = await postRunReport(config, session, {
+      target: chosen.playbook.target.id,
+      repo_fingerprint: fingerprint,
+      identify_wired: outcome?.coreOk ?? false,
+      verified,
+      cost_usd: outcome?.costUsd ?? 0,
+      duration_ms: outcome?.durationMs ?? Date.now() - startedAt,
+      summary: scrubSummary(outcome?.summary ?? "").slice(0, 4e3),
+      events: reportEvents2,
+      wizard_version: packageVersion(),
+      planner_model: config.plannerModel,
+      editor_model: config.model,
+      effort: config.effort,
+      exit_class: exitClass,
+      phase_timings: outcome?.phaseTimings ?? [],
+      opportunities_proposed: additions.proposed,
+      opportunities_applied: additions.applied.length
+    });
+    if (!result.ok) {
+      p.log.warn(
+        theme.warn("Couldn't record this run's coverage on the server") + theme.muted(
+          ` (${formatReportFailure(result)}) \u2014 future runs may re-propose events already wired here.`
+        )
+      );
+    }
+    return reportEvents2;
+  };
   if (!outcome) {
     if (useIntegrationSpinner) {
       spin.stop(theme.alert("Integration stopped"));
     } else {
       p.log.error(theme.alert("Integration stopped"));
     }
-    await maybeRevert(repoPath, checkpoint, "The run stopped before finishing.");
+    const reverted = await maybeRevert(
+      repoPath,
+      checkpoint,
+      "The run stopped before finishing."
+    );
+    await reportRun(reverted ? "reverted" : "agent_error");
     return 1;
   }
   const stopLabel = !outcome.coreOk ? theme.warn("Stopped early \u2014 partial setup is in your working tree") : outcome.eventsComplete ? theme.success("Integration complete") : theme.success("Core integration done") + theme.muted(" \u2014 some events left as follow-ups");
@@ -3353,7 +3430,6 @@ Flutter is live today; ${theme.bright(
   } else {
     p.log.success(stopLabel);
   }
-  const opportunities = await collectOpportunities(repoPath, manifest, checkpoint);
   let files = await changedFiles(repoPath, checkpoint);
   if (files.length) {
     p.note(files.map((f) => theme.muted("\u2022 ") + f).join("\n"), "Files changed");
@@ -3366,11 +3442,12 @@ Flutter is live today; ${theme.bright(
       "The core setup didn't complete, so these changes may be incomplete."
     );
     if (reverted) {
+      await reportRun("reverted");
       p.outro(theme.muted("Reverted \u2014 nothing was left in your working tree."));
       return 1;
     }
+    await reportRun("core_failed");
   }
-  let verified = null;
   if (chosen.playbook.verifyCommand && files.length) {
     const cmd = chosen.playbook.verifyCommand;
     const vspin = p.spinner();
@@ -3450,94 +3527,21 @@ ${repair.summary}`].filter(Boolean).join("\n\n");
           "The integration didn't pass its build/lint check, so the edits may be broken."
         );
         if (reverted) {
+          await reportRun("reverted");
           p.outro(theme.muted("Reverted \u2014 nothing was left in your working tree."));
           return 1;
         }
+        await reportRun("verify_failed");
       }
     }
   }
-  const { acceptedEvents, instrumentationSnapshot } = await offerOpportunities({
-    repoPath,
-    config,
-    session,
-    playbook: chosen.playbook,
-    manifest,
-    opportunities,
-    fingerprint,
-    checkpoint,
-    remainingBudgetUsd: config.budgetUsd - outcome.costUsd,
-    repoMap: outcome.repoMap
-  });
-  if (instrumentationSnapshot && chosen.playbook.verifyCommand) {
-    const cmd = chosen.playbook.verifyCommand;
-    const preInstrumentationVerified = verified;
-    const vspin = p.spinner();
-    vspin.start(`Re-verifying after instrumenting the new events \u2014 ${theme.muted(cmd)}`);
-    const verdict = await runVerifyCommand(repoPath, cmd);
-    verified = verdictToVerified(verdict);
-    if (verdict.toolMissing) {
-      vspin.stop(
-        theme.warn("Couldn't re-verify automatically") + theme.muted(` \u2014 \`${cmd}\` isn't available here. Run it yourself before committing.`)
-      );
-    } else if (verdict.timedOut) {
-      vspin.stop(
-        theme.warn(`Re-verification timed out \u2014 \`${cmd}\``) + theme.muted(" \u2014 run it yourself before committing.")
-      );
-    } else if (verdict.ok) {
-      vspin.stop(theme.success("Verified \u2713") + theme.muted(` (${cmd})`));
-    } else {
-      vspin.stop(theme.alert(`Verification failed after instrumenting the new events \u2014 ${cmd}`));
-      if (verdict.output) {
-        p.note(verdict.output, theme.warn("Verifier output"));
-      }
-      const doRevert = await p.confirm({
-        message: "Instrumenting the new events didn't pass the build/lint check. Revert just those edits? (The events stay in your universe \u2014 wire them on a future run.)",
-        initialValue: true
-      });
-      if (!p.isCancel(doRevert) && doRevert) {
-        if (await restoreToSnapshot(repoPath, checkpoint, instrumentationSnapshot)) {
-          verified = preInstrumentationVerified;
-          p.log.success(theme.success("Reverted the instrumentation edits."));
-        } else {
-          p.log.warn(
-            theme.warn("Couldn't revert automatically \u2014 undo manually: ") + (revertHint(checkpoint) ?? "git reset --hard")
-          );
-        }
-      } else {
-        p.log.info(
-          theme.muted("Left in your working tree \u2014 fix the verifier errors before committing.")
-        );
-      }
-    }
-  }
-  const filesForScan = acceptedEvents.length ? await changedFiles(repoPath, checkpoint) : files;
-  const eventTypesToScan = [
-    ...manifest.events.map((e) => e.eventType),
-    ...acceptedEvents.map((e) => e.code)
-  ];
-  const wiredMap = await scanWiredEvents(repoPath, filesForScan, eventTypesToScan);
-  const reportEvents = eventTypesToScan.map((eventType) => ({
-    event_type: eventType,
-    status: wiredMap.has(eventType) ? "wired" : "skipped",
-    file: wiredMap.get(eventType)
-  }));
-  const reportResult = await postRunReport(config, session, {
-    target: chosen.playbook.target.id,
-    repo_fingerprint: fingerprint,
-    identify_wired: outcome.coreOk,
-    verified,
-    cost_usd: outcome.costUsd,
-    duration_ms: outcome.durationMs,
-    summary: scrubSummary(outcome.summary).slice(0, 4e3),
-    events: reportEvents
-  });
-  if (!reportResult.ok) {
-    p.log.warn(
-      theme.warn("Couldn't record this run's coverage on the server") + theme.muted(
-        ` (${formatReportFailure(reportResult)}) \u2014 future runs may re-propose events already wired here.`
-      )
-    );
-  }
+  const reportedEvents = await reportRun(
+    outcome.eventsComplete ? "completed" : "events_incomplete"
+  );
+  const reportEvents = reportedEvents.length ? reportedEvents : await collectReportEvents();
+  const wiredMap = new Map(
+    reportEvents.filter((event) => event.status === "wired").map((event) => [event.event_type, event.file ?? ""])
+  );
   try {
     const approvedSuggestions = await approvedSuggestionsPromise;
     if (approvedSuggestions?.length) {
@@ -3577,15 +3581,12 @@ ${repair.summary}`].filter(Boolean).join("\n\n");
   if (eventLines) {
     p.note(eventLines, "Events");
   }
-  const eventOutcomeByType = new Map(
-    outcome.eventOutcomes.map((event) => [event.event, event])
-  );
   const gapReport = buildGapReport({
     manifest,
     events: reportEvents.map((event) => ({
       eventType: event.event_type,
       status: event.status,
-      reason: eventOutcomeByType.get(event.event_type)?.reason
+      reason: event.reason
     }))
   });
   if (gapReport.hasContent) {
@@ -3594,7 +3595,7 @@ ${repair.summary}`].filter(Boolean).join("\n\n");
       theme.signal("What you could be doing")
     );
   }
-  const eventDenominator = manifest.universeSummary?.wireableHere ?? eventTypesToScan.length;
+  const eventDenominator = manifest.universeSummary?.wireableHere ?? reportEvents.length;
   const eventStatsLabel = manifest.universeSummary ? "events wired here" : "events wired";
   const timingDetails = outcome.phaseTimings.map(({ phase, ms }) => `${shortPhaseLabel(phase)} ${formatDuration(ms)}`).join(" \xB7 ");
   p.log.info(
@@ -3634,25 +3635,21 @@ ${repair.summary}`].filter(Boolean).join("\n\n");
   p.outro(theme.signal("\u2301 ") + theme.bright("Whisperr is wired in."));
   return 0;
 }
-var NO_ADDITIONS = { acceptedEvents: [], instrumentationSnapshot: null };
-async function offerOpportunities(opts) {
-  const { manifest, config, session } = opts;
+async function applyOpportunities(opts) {
+  const { config, session, playbook, manifest, fingerprint, raw, additions } = opts;
+  const clean = sanitizeOpportunities(raw, manifest);
   const openSuggestions = await fetchSuggestions(config, session, ["proposed", "approved"]);
-  const openSuggestionKeys = new Set(
-    openSuggestions.map(
-      (suggestion) => `${suggestion.kind}:${normalizeCode(suggestion.code)}`
-    )
+  const openKeys = new Set(
+    openSuggestions.map((s) => `${s.kind}:${normalizeCode(s.code)}`)
   );
   const opportunities = {
-    events: opts.opportunities.events.filter(
-      (event) => !openSuggestionKeys.has(`event:${normalizeCode(event.code)}`)
-    ),
-    interventions: opts.opportunities.interventions.filter(
-      (intervention) => !openSuggestionKeys.has(`intervention:${normalizeCode(intervention.code)}`)
+    events: clean.events.filter((e) => !openKeys.has(`event:${normalizeCode(e.code)}`)),
+    interventions: clean.interventions.filter(
+      (i) => !openKeys.has(`intervention:${normalizeCode(i.code)}`)
     )
   };
-  const total = opportunities.events.length + opportunities.interventions.length;
-  if (total === 0) return NO_ADDITIONS;
+  additions.proposed = opportunities.events.length + opportunities.interventions.length;
+  if (additions.proposed === 0) return [];
   const describe = (kind, code, why) => `${theme.muted(`${kind}: `)}${theme.bright(code)}${why ? theme.muted(` \u2014 ${why}`) : ""}`;
   p.note(
     [
@@ -3665,110 +3662,29 @@ async function offerOpportunities(opts) {
   );
   if (config.offline) {
     p.log.info(theme.muted("Offline mode \u2014 proposals shown only, nothing submitted."));
-    return NO_ADDITIONS;
-  }
-  if (!process.stdout.isTTY || !process.stdin.isTTY) {
-    p.log.info(
-      theme.muted("Non-interactive run \u2014 proposals were not submitted. Re-run interactively to add them.")
-    );
-    return NO_ADDITIONS;
-  }
-  const selection = await p.multiselect({
-    message: "Send these to your dashboard for approval?",
-    options: [
-      ...opportunities.events.map((e) => ({
-        value: `e:${e.code}`,
-        label: `event \xB7 ${e.code}`,
-        hint: e.description ?? e.rationale
-      })),
-      ...opportunities.interventions.map((i) => ({
-        value: `i:${i.code}`,
-        label: `intervention \xB7 ${i.code}`,
-        hint: i.description ?? i.rationale
-      }))
-    ],
-    // Opt-in per item: nothing is pre-selected, so submitting a suggestion is
-    // an explicit choice rather than an opt-out the user has to notice and undo.
-    initialValues: [],
-    required: false
-  });
-  if (p.isCancel(selection) || selection.length === 0) {
-    p.log.info(theme.muted("Skipped \u2014 your universe is unchanged."));
-    return NO_ADDITIONS;
+    return [];
   }
-  const chosenSet = new Set(selection);
-  const knownInterventionCodes = new Set(
-    manifest.events.flatMap((e) => e.interventions ?? []).map((i) => i.code)
-  );
-  const knownEventCodes = new Set(manifest.events.map((e) => e.eventType));
-  const pickedEvents = opportunities.events.filter((e) => chosenSet.has(`e:${e.code}`));
-  const pickedInterventions = opportunities.interventions.filter(
-    (i) => chosenSet.has(`i:${i.code}`)
-  );
-  const pickedInterventionCodes = new Set(pickedInterventions.map((i) => i.code));
-  const pickedEventCodes = new Set(pickedEvents.map((e) => e.code));
-  const submitted = {
-    events: pickedEvents.map((e) => ({
-      ...e,
-      links: e.links?.filter(
-        (l) => knownInterventionCodes.has(l.interventionCode) || pickedInterventionCodes.has(l.interventionCode)
-      )
-    })),
-    interventions: pickedInterventions.map((i) => ({
-      ...i,
-      links: i.links?.filter(
-        (l) => knownEventCodes.has(l.eventCode) || pickedEventCodes.has(l.eventCode)
-      )
-    }))
-  };
-  let stageResult;
-  try {
-    stageResult = await withSpinner(
-      "Sending suggestions for approval",
-      () => submitSuggestions(config, session, opts.playbook.target.id, opts.fingerprint, submitted)
-    );
-  } catch (err) {
-    p.log.warn(
-      theme.warn("Couldn't send the proposals") + theme.muted(` \u2014 ${err.message}. Nothing was submitted.`)
-    );
-    return NO_ADDITIONS;
-  }
-  if (stageResult) {
-    const lines2 = stageResult.outcomes.map((outcome) => {
-      const mark = outcome.status === "staged" ? theme.success("\u2713") : outcome.status === "duplicate" ? theme.muted("=") : theme.warn("\u2717");
-      const reason = outcome.reason ?? (outcome.duplicateOf && outcome.duplicateOf !== outcome.code ? `already queued as ${outcome.duplicateOf}` : void 0);
-      const detail = reason ? theme.muted(` (${reason})`) : "";
-      return `${mark} ${outcome.kind} ${theme.bright(outcome.code)}${detail}`;
-    });
-    lines2.push(
-      theme.muted(
-        `${stageResult.staged} staged \xB7 ${stageResult.duplicates} already queued \xB7 ${stageResult.invalid} rejected`
-      )
-    );
-    p.note(lines2.join("\n"), theme.signal("Suggestions submitted"));
-    const where = stageResult.approvalsUrl ? `approve at ${theme.bright(stageResult.approvalsUrl)}` : "approve them in your Whisperr dashboard";
-    p.log.info(
-      theme.muted(
-        `${stageResult.staged} proposal${stageResult.staged === 1 ? "" : "s"} sent \u2014 ${where}. The next wizard run wires whatever you approve.`
-      )
-    );
-    return NO_ADDITIONS;
+  if (config.proposeOnly) {
+    await stageOpportunities(config, session, playbook, fingerprint, opportunities);
+    return [];
   }
   let result;
   try {
     result = await withSpinner(
       "Adding to your universe",
-      () => submitAdditions(config, session, opts.playbook.target.id, opts.fingerprint, submitted)
+      () => submitAdditions(config, session, playbook.target.id, fingerprint, opportunities)
     );
   } catch (err) {
     p.log.warn(
       theme.warn("Couldn't add the proposals") + theme.muted(` \u2014 ${err.message}. Your universe is unchanged.`)
     );
-    return NO_ADDITIONS;
+    return [];
   }
   const lines = result.outcomes.map((o) => {
     const mark = o.status === "applied" ? theme.success("\u2713") : o.status === "duplicate" ? theme.muted("=") : theme.warn("\u2717");
-    const detail = o.status === "duplicate" ? theme.muted(` (already in your universe${o.duplicateOf && o.duplicateOf !== o.code ? ` as ${o.duplicateOf}` : ""})`) : o.status === "invalid" && o.reason ? theme.muted(` (${o.reason})`) : "";
+    const detail = o.status === "duplicate" ? theme.muted(
+      ` (already in your universe${o.duplicateOf && o.duplicateOf !== o.code ? ` as ${o.duplicateOf}` : ""})`
+    ) : o.status === "invalid" && o.reason ? theme.muted(` (${o.reason})`) : "";
     return `${mark} ${o.kind} ${theme.bright(o.code)}${detail}`;
   });
   lines.push(
@@ -3776,7 +3692,7 @@ async function offerOpportunities(opts) {
       `${result.applied} added \xB7 ${result.duplicates} already present \xB7 ${result.invalid} rejected`
     )
   );
-  if (submitted.interventions.length) {
+  if (opportunities.interventions.length) {
     lines.push(theme.muted("New interventions start paused \u2014 activate them in your dashboard."));
   }
   if (result.policyRegen?.status === "pending") {
@@ -3799,41 +3715,49 @@ async function offerOpportunities(opts) {
       )
     );
   }
-  const appliedEventCodes = new Set(
+  const appliedCodes = new Set(
     result.outcomes.filter((o) => o.kind === "event" && o.status === "applied").map((o) => o.code)
   );
-  const acceptedEvents = pickedEvents.filter((e) => appliedEventCodes.has(e.code));
-  if (!acceptedEvents.length) return NO_ADDITIONS;
-  const prePass = await snapshotChanges(opts.repoPath, opts.checkpoint);
-  const spin = p.spinner();
-  spin.start(theme.bright("Instrumenting the newly added events"));
+  const applied = opportunities.events.filter((e) => appliedCodes.has(e.code));
+  additions.applied = applied;
+  return applied;
+}
+async function stageOpportunities(config, session, playbook, fingerprint, opportunities) {
+  let stageResult;
   try {
-    const pass = await runAdditionsInstrumentationPass({
-      repoPath: opts.repoPath,
-      config,
-      session,
-      playbook: opts.playbook,
-      acceptedEvents,
-      budgetUsd: opts.remainingBudgetUsd,
-      repoMap: opts.repoMap
-    });
-    if (pass.ran) {
-      spin.stop(theme.success("New events instrumented"));
-      logAgentSummary(pass.summary);
-    } else {
-      spin.stop(
-        theme.warn("Skipped instrumenting the new events") + theme.muted(
-          " \u2014 the spend limit was reached. They're in your universe; wire them on a future run."
-        )
-      );
-    }
+    stageResult = await withSpinner(
+      "Sending suggestions for approval",
+      () => submitSuggestions(config, session, playbook.target.id, fingerprint, opportunities)
+    );
   } catch (err) {
-    spin.stop(
-      theme.warn("Couldn't instrument the new events") + theme.muted(` \u2014 ${err.message}. They're in your universe; wire them on a future run.`)
+    p.log.warn(
+      theme.warn("Couldn't send the proposals") + theme.muted(` \u2014 ${err.message}. Nothing was submitted.`)
     );
+    return;
   }
-  const edited = !snapshotsEqual(prePass, await snapshotChanges(opts.repoPath, opts.checkpoint));
-  return { acceptedEvents, instrumentationSnapshot: edited ? prePass : null };
+  if (!stageResult) {
+    p.log.warn(
+      theme.warn("This Whisperr backend has no approval queue") + theme.muted(" \u2014 nothing was submitted. Re-run without --propose-only to add them directly.")
+    );
+    return;
+  }
+  const lines = stageResult.outcomes.map((outcome) => {
+    const mark = outcome.status === "staged" ? theme.success("\u2713") : outcome.status === "duplicate" ? theme.muted("=") : theme.warn("\u2717");
+    const reason = outcome.reason ?? (outcome.duplicateOf && outcome.duplicateOf !== outcome.code ? `already queued as ${outcome.duplicateOf}` : void 0);
+    return `${mark} ${outcome.kind} ${theme.bright(outcome.code)}${reason ? theme.muted(` (${reason})`) : ""}`;
+  });
+  lines.push(
+    theme.muted(
+      `${stageResult.staged} staged \xB7 ${stageResult.duplicates} already queued \xB7 ${stageResult.invalid} rejected`
+    )
+  );
+  p.note(lines.join("\n"), theme.signal("Suggestions submitted"));
+  const where = stageResult.approvalsUrl ? `approve at ${theme.bright(stageResult.approvalsUrl)}` : "approve them in your Whisperr dashboard";
+  p.log.info(
+    theme.muted(
+      `${stageResult.staged} proposal${stageResult.staged === 1 ? "" : "s"} sent \u2014 ${where}. The next wizard run wires whatever you approve.`
+    )
+  );
 }
 async function maybeRevert(repoPath, checkpoint, reason) {
   if (!checkpoint.isRepo) return false;
@@ -3993,12 +3917,10 @@ function logAgentSummary(summary) {
 }
 function shortPhaseLabel(phase) {
   switch (phase) {
-    case "Mapping your codebase":
-      return "map";
+    case "Planning your integration":
+      return "plan";
     case "Installing the SDK & wiring identify()":
       return "core";
-    case "Planning event placements":
-      return "plan";
     case "Instrumenting planned events":
     case "Instrumenting your events":
       return "wire";
@@ -4031,12 +3953,7 @@ function formatReportFailure(result) {
 }
 
 // src/index.ts
-var modulePath = fileURLToPath(import.meta.url);
-function packageVersion() {
-  const packagePath = join4(dirname2(modulePath), "..", "package.json");
-  const pkg = JSON.parse(readFileSync(packagePath, "utf8"));
-  return pkg.version ?? "0.0.0";
-}
+var modulePath = fileURLToPath2(import.meta.url);
 function parseArgs(argv) {
   const args = [...argv];
   const opts = {};
@@ -4056,6 +3973,15 @@ function parseArgs(argv) {
       case "--force":
         opts.force = true;
         break;
+      case "--review-plan":
+        opts.reviewPlan = true;
+        break;
+      case "--propose-only":
+        opts.proposeOnly = true;
+        break;
+      case "--strict-review":
+        opts.strictReview = true;
+        break;
       case "--api":
         opts.apiBaseUrl = args[++i];
         break;
@@ -4082,6 +4008,10 @@ function printHelp() {
       `  ${theme.bright("Options")}`,
       "    --offline         Use a demo manifest, no account/browser needed",
       "    --force           Proceed without a clean git tree (no safe undo)",
+      "    --review-plan     Confirm the placement plan before anything is wired",
+      "    --propose-only    Send new events/interventions for dashboard approval",
+      "                      instead of adding them to your universe now",
+      "    --strict-review   Review the finished diff with the deeper planner model",
       "    --api <url>       Override the Whisperr API base URL",
       "    --model <id>      Override the coding-agent model",
       "    -h, --help        Show this help",