@whisperr/wizard 0.1.2 → 0.1.4

package/dist/index.js

@@ -597,41 +597,53 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 // src/core/playbooks/shared-prompt.ts
 var BASE_WIZARD_PROMPT = `
 You are the Whisperr Wizard \u2014 an expert integration agent running INSIDE a
-customer's code repository. Your job: wire up the Whisperr SDK so the product
-sends the right events to Whisperr, then stop. Whisperr is a churn-prevention
-engine that needs identify() (who the user is) and track() (what they do).
+customer's code repository.
 
-You are billed per step and the user is watching the clock. Work FAST and
-DECISIVELY. Most failures come from over-exploring \u2014 do not do that.
+MISSION:
+Whisperr predicts churn and fires retention interventions from product events.
+Two things make that work: (1) identify() tying events to a real user, and
+(2) track() events fired at the right moment WITH the properties that give them
+meaning. A well-placed event carrying its real properties is gold; a bare or
+mis-placed event is noise that corrupts the customer's churn data. Your mission:
+wire up everything in the plan that genuinely exists in this app, and for each
+event you place, capture the properties that are actually available right there
+in the code. You will NOT find everything \u2014 some events live server-side or
+aren't in this codebase at all. That is expected and fine. Get what is here, get
+it right, report the rest. Know exactly what you're doing; never hunt blindly.
+
+You are billed per step and the user is watching. Work FAST and DECISIVELY.
 
 EFFICIENCY \u2014 non-negotiable:
 - Use Grep and Glob to find code. Do NOT read whole files; read the smallest
   slice you need.
 - NEVER re-read a file you just edited. Trust your edit.
-- Do not run the app, build, or heavy test suites. At most one quick static
-  check, and only if the SDK guide tells you to.
+- Do not run the app, build, or the analyzer/test suites. The human reviews the
+  diff.
 - Make several related edits in a row before pausing to think.
 
 DECISIVENESS:
 - When you find the right spot, edit it and move on immediately.
-- If you cannot find a clear place for something within ~2 searches, STOP
-  looking for it. Either drop a single-line \`// TODO(whisperr): track(...)\`
-  if an obvious spot exists, or just note it as a follow-up. Do not keep hunting.
+- If you can't find a clear place for something within ~2 searches, STOP looking.
+  Leave a one-line \`// TODO(whisperr): ...\` only if an obvious spot exists,
+  otherwise just note it as a follow-up. Do not keep hunting.
 
-SCOPE REALISM:
-- Not every event exists in THIS app. Many are server-side (billing webhooks,
-  delivery callbacks) or simply absent. That is expected. Instrument what
-  clearly exists on the client; list the rest as follow-ups. Do not treat a
-  missing call site as a problem to solve.
+PROPERTY CAPTURE (this is the craft):
+- For each event you place, look at what's in scope AT THAT CALL SITE \u2014 function
+  arguments, the object/model/state you're inside, nearby local variables \u2014 and
+  populate every listed property you can source from those values.
+- Omit a property only if it genuinely isn't available there. Do NOT fetch,
+  compute, or invent data to fill a property, and do NOT wander off to find it.
+- If a property marked (required) can't be sourced at your chosen site, that's a
+  strong hint you've picked the wrong site \u2014 reconsider; if it's still the best
+  spot, add the track() call and note the missing property.
 
 CORRECTNESS:
 - Match the app's existing conventions (imports, state management, file layout).
 - Use the EXACT snake_case event names given. Never invent or rename events.
-- A wrongly-placed business event corrupts churn data \u2014 worse than a missing one.
-  Only place an event where you are confident the user action truly happens.
+- Only place an event where you're confident the user action truly happens.
 
-End every task with a short summary: what you changed, and any follow-ups the
-human should handle (events you intentionally skipped + why).
+End every task with a short summary: what you changed, which events you wired
+(and the properties you attached), and the follow-ups you intentionally left.
 `.trim();
 function renderIdentifyBrief(m) {
   const lines = [];
@@ -640,14 +652,14 @@ function renderIdentifyBrief(m) {
   lines.push(`Ingestion API key:  ${m.ingestionApiKey}`);
   if (m.businessContext) {
     lines.push("");
-    lines.push(`Context: ${m.businessContext}`);
+    lines.push(`Business context: ${m.businessContext}`);
   }
   lines.push("");
   lines.push("identify():");
   if (m.identify.traits?.length) {
-    lines.push("  Send these traits when available:");
+    lines.push("  Send these traits when readily available:");
     for (const t of m.identify.traits) {
-      lines.push(`    - ${t.name}${t.description ? ` (${t.description})` : ""}`);
+      lines.push(`    - ${t.name}${t.description ? ` \u2014 ${t.description}` : ""}`);
     }
   }
   if (m.identify.channels?.length) {
@@ -661,18 +673,25 @@ function renderEventsBrief(m) {
     (a, b) => (b.importance ?? 0) - (a.importance ?? 0)
   );
   const lines = [];
+  if (m.businessContext) {
+    lines.push(`Business context: ${m.businessContext}`);
+    lines.push("");
+  }
   lines.push(
-    `${events.length} candidate events (highest-impact first). Emit each with its EXACT name via track('<event_type>', { ...properties }).`
+    `${events.length} candidate events (highest-impact first). For each: fire track('<event_type>', { ...properties }) at the real moment it happens, and attach every listed property you can source from values in scope there. Skip an event entirely if it has no clear client-side trigger.`
   );
-  lines.push("");
   for (const e of events) {
-    const drivers = e.interventions?.length ? `  \u2014 drives: ${e.interventions.map((i) => i.label ?? i.code).join(", ")}` : "";
-    lines.push(`- ${e.eventType}${e.label ? `  (${e.label})` : ""}${drivers}`);
-    if (e.description) lines.push(`    ${e.description}`);
+    lines.push("");
+    const why = e.interventions?.length ? `  \xB7  drives: ${e.interventions.map((i) => i.label ?? i.code).join(", ")}` : "";
+    lines.push(`\u25A0 ${e.eventType}${e.label ? `  (${e.label})` : ""}${why}`);
+    if (e.description) lines.push(`  ${e.description}`);
     if (e.properties?.length) {
-      lines.push(
-        `    properties: ${e.properties.map((p2) => p2.name).join(", ")}`
-      );
+      lines.push("  properties to capture if available:");
+      for (const p2 of e.properties) {
+        const req = p2.required ? " (required)" : "";
+        const desc = p2.description ? ` \u2014 ${p2.description}` : "";
+        lines.push(`    \xB7 ${p2.name}${req}${desc}`);
+      }
     }
   }
   return lines.join("\n");
@@ -687,7 +706,6 @@ async function runIntegrationAgent(opts) {
   let costUsd = 0;
   const summaries = [];
   progress?.onPhase?.("Installing the SDK & wiring identify()");
-  const verifyHint = playbook.verifyCommand ? ` Finish with a single \`${playbook.verifyCommand}\` and fix only what it flags.` : "";
   const corePrompt = [
     `Integrate the Whisperr ${playbook.target.displayName} SDK \u2014 CORE SETUP ONLY.`,
     `Project root: ${repoPath}`,
@@ -695,10 +713,16 @@ async function runIntegrationAgent(opts) {
     "Do exactly these, then stop:",
     `1. Add the Whisperr SDK dependency and install it (${playbook.packageRef}).`,
     "2. Initialize it once at app startup with the key + base URL below.",
-    "3. Wire identify() where the end-user becomes known (login / signup /",
-    "   session restore), and reset() on logout.",
+    "3. Wire identify() at the PRIMARY place the user becomes authenticated",
+    "   (after a successful login) and on session restore at app startup; call",
+    "   reset() on logout. Do NOT enumerate every auth method \u2014 one primary",
+    "   login path plus session restore is enough. Keep channels minimal: pass",
+    "   email if it's readily at hand; phone/push are optional, skip them if not",
+    "   obvious. Do not go hunting through every auth file.",
     "",
-    "Do NOT instrument product events yet \u2014 that is a separate step." + verifyHint,
+    "This is a real app \u2014 be quick and decisive, aim to finish in ~15 steps.",
+    "Do NOT instrument product events yet \u2014 that is a separate step. Do not run",
+    "the analyzer or build; the human will review the diff.",
     "",
     "----- IDENTIFY -----",
     renderIdentifyBrief(manifest),
@@ -709,7 +733,7 @@ async function runIntegrationAgent(opts) {
     systemPrompt: systemPrompt6,
     repoPath,
     model: config.model,
-    maxTurns: 20,
+    maxTurns: 35,
     progress
   });
   costUsd += core.costUsd;
@@ -719,17 +743,15 @@ ${core.summary}`);
   if (manifest.events.length > 0) {
     progress?.onPhase?.("Instrumenting your events");
     const eventsPrompt = [
-      `The Whisperr ${playbook.target.displayName} SDK is already installed,`,
-      "initialized, and identify() is wired. Now add track() calls for product",
-      "events.",
+      `The Whisperr ${playbook.target.displayName} SDK is already installed and`,
+      "initialized, and identify() is wired. Now instrument the product events",
+      "below with track().",
       "",
-      "How to work:",
-      "- Go in the order listed (highest-impact first).",
-      "- For each event, Grep for where that user action happens. If there is a",
-      "  clear client-side call site, add the track() call with the exact name.",
-      "  If not, SKIP it (most server-side events won't exist here) \u2014 do not hunt.",
-      "- You have a limited number of steps; spend them placing events, not",
-      "  exploring. Stop once the events that clearly exist in this app are wired.",
+      "Work in importance order. Place each event at its real call site and",
+      "attach the properties you can source from what's in scope there (see the",
+      "property-capture rule in your instructions). Skip fast when an event has",
+      "no clear client-side trigger \u2014 spend steps placing events, not exploring.",
+      "Stop once the events that clearly exist in this app are wired.",
       "",
       "----- EVENTS -----",
       renderEventsBrief(manifest),
@@ -991,7 +1013,15 @@ Flutter is live today; ${theme.bright(
   }
   const spin = p.spinner();
   let phaseLabel = "Integrating";
-  spin.start(theme.bright(phaseLabel) + theme.muted(" \u2014 the agent is working in your code"));
+  let lastLine = "";
+  const startedAt = Date.now();
+  spin.start(theme.bright(phaseLabel));
+  const tick = setInterval(() => {
+    const secs = Math.round((Date.now() - startedAt) / 1e3);
+    spin.message(
+      theme.bright(phaseLabel) + theme.muted(` \xB7 ${secs}s`) + (lastLine ? theme.muted(` \u2014 ${lastLine}`) : "")
+    );
+  }, 1e3);
   const outcome = await runIntegrationAgent({
     repoPath,
     config,
@@ -1001,18 +1031,21 @@ Flutter is live today; ${theme.bright(
     progress: {
       onPhase(label) {
         phaseLabel = label;
-        spin.message(theme.bright(label));
+        lastLine = "";
       },
       onActivity(line) {
-        spin.message(theme.bright(phaseLabel) + theme.muted(` \u2014 ${line}`));
+        lastLine = line;
       }
     }
   }).catch((err) => {
-    spin.stop(theme.alert("Integration stopped"));
     p.log.error(err.message);
     return null;
   });
-  if (!outcome) return 1;
+  clearInterval(tick);
+  if (!outcome) {
+    spin.stop(theme.alert("Integration stopped"));
+    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");
   spin.stop(stopLabel);
   const files = await changedFiles(repoPath, checkpoint);
@@ -1193,7 +1226,7 @@ async function main() {
     return;
   }
   if ("version" in parsed) {
-    console.log("0.1.2");
+    console.log("0.1.4");
     return;
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whisperr/wizard",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Whisperr Wizard — one command to integrate the Whisperr SDK into your app. Authenticates with your onboarded account and uses an AI coding agent to wire up identify() and your business events automatically.",
   "license": "UNLICENSED",
   "private": false,