@whisperr/wizard 0.1.1 → 0.1.2

package/dist/index.js

@@ -6,7 +6,7 @@ import * as p from "@clack/prompts";
 
 // src/core/config.ts
 var DEFAULT_API_BASE = "https://api.whisperr.net";
-var DEFAULT_MODEL = "claude-opus-4-8";
+var DEFAULT_MODEL = "claude-sonnet-4-6";
 function resolveConfig(flags = {}) {
   const apiBaseUrl = (flags.apiBaseUrl ?? process.env.WHISPERR_WIZARD_API_BASE ?? DEFAULT_API_BASE).replace(/\/+$/, "");
   const llmBaseUrl = (process.env.WHISPERR_WIZARD_LLM_BASE ?? `${apiBaseUrl}/wizard/llm`).replace(/\/+$/, "");
@@ -18,7 +18,7 @@ function resolveConfig(flags = {}) {
     apiBaseUrl,
     llmBaseUrl,
     model: flags.model ?? process.env.WHISPERR_WIZARD_MODEL ?? DEFAULT_MODEL,
-    maxTurns: Number(process.env.WHISPERR_WIZARD_MAX_TURNS ?? 40),
+    maxTurns: Number(process.env.WHISPERR_WIZARD_MAX_TURNS ?? 55),
     directAnthropicKey,
     offline
   };
@@ -596,84 +596,83 @@ 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. You are running
-INSIDE a customer's code repository. Your single job: integrate the Whisperr SDK
-so the product starts sending the right events to Whisperr, then stop.
+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).
 
-Whisperr is a churn-prevention engine. It needs two things from the app:
-  1. identify() \u2014 tell Whisperr who the end-user is (a stable external user id)
-     plus traits and contact channels, called right after the user is known
-     (login / session restore / signup).
-  2. track() \u2014 emit the specific business events listed in the integration
-     manifest, at the exact places in the code where those user actions happen.
-     These named events drive the customer's churn interventions, so placing
-     them at the correct call sites matters more than anything else you do.
+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.
 
-Operating rules:
-- Work autonomously. Make the edits directly; do not ask for confirmation.
-- Be surgical. Add the SDK dependency, initialize it once at app startup, wire
-  identify() where the user becomes known, and add track() calls for the
-  manifest events. Do not refactor unrelated code, restyle, or "improve" things.
-- Find the RIGHT call site for each named event by reading the code, not by
-  guessing. If you genuinely cannot find where an event occurs, add a clearly
-  commented TODO with the exact Whisperr call to make, and report it at the end
-  rather than firing the event from a wrong place.
-- Never invent event types. Use the exact snake_case event_type strings from the
-  manifest. Custom data goes under properties.
-- Keep the API key out of source where the SDK/platform supports env/secrets;
-  otherwise place it where the manifest guidance says and flag it.
-- Match the repository's existing conventions (imports, formatting, state
-  management, file layout).
+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.
+- Make several related edits in a row before pausing to think.
 
-When done, output a concise summary:
-  - files changed
-  - where identify() was wired
-  - each manifest event -> the call site you instrumented (or TODO + reason)
-  - any follow-ups the human must do (env var, push token, etc.)
+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.
+
+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.
+
+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.
+
+End every task with a short summary: what you changed, and any follow-ups the
+human should handle (events you intentionally skipped + why).
 `.trim();
-function renderManifestBrief(m) {
+function renderIdentifyBrief(m) {
   const lines = [];
-  lines.push(`# Whisperr integration manifest for app: ${m.appName ?? m.appId}`);
-  lines.push("");
+  lines.push(`App: ${m.appName ?? m.appId}`);
   lines.push(`Ingestion base URL: ${m.ingestionBaseUrl}`);
   lines.push(`Ingestion API key:  ${m.ingestionApiKey}`);
   if (m.businessContext) {
     lines.push("");
-    lines.push("## Business context");
-    lines.push(m.businessContext);
+    lines.push(`Context: ${m.businessContext}`);
   }
   lines.push("");
-  lines.push("## identify()");
+  lines.push("identify():");
   if (m.identify.traits?.length) {
-    lines.push("Traits to send when available:");
+    lines.push("  Send these traits when available:");
     for (const t of m.identify.traits) {
-      lines.push(`  - ${t.name}${t.description ? ` \u2014 ${t.description}` : ""}`);
+      lines.push(`    - ${t.name}${t.description ? ` (${t.description})` : ""}`);
     }
   }
   if (m.identify.channels?.length) {
-    lines.push(`Channels in use: ${m.identify.channels.join(", ")}`);
+    lines.push(`  Channels in use: ${m.identify.channels.join(", ")}`);
   }
-  if (m.identify.notes) lines.push(m.identify.notes);
-  lines.push("");
-  lines.push("## Events to instrument (use these exact event_type strings)");
+  if (m.identify.notes) lines.push(`  ${m.identify.notes}`);
+  return lines.join("\n");
+}
+function renderEventsBrief(m) {
   const events = [...m.events].sort(
     (a, b) => (b.importance ?? 0) - (a.importance ?? 0)
   );
+  const lines = [];
+  lines.push(
+    `${events.length} candidate events (highest-impact first). Emit each with its EXACT name via track('<event_type>', { ...properties }).`
+  );
+  lines.push("");
   for (const e of events) {
-    lines.push("");
-    lines.push(`### ${e.eventType}${e.label ? `  (${e.label})` : ""}`);
-    if (e.description) lines.push(e.description);
+    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}`);
     if (e.properties?.length) {
-      lines.push("Properties:");
-      for (const p2 of e.properties) {
-        lines.push(
-          `  - ${p2.name}${p2.required ? " (required)" : ""}${p2.description ? ` \u2014 ${p2.description}` : ""}`
-        );
-      }
-    }
-    if (e.interventions?.length) {
-      const drv = e.interventions.map((i) => i.label ?? i.code).join(", ");
-      lines.push(`Drives: ${drv}`);
+      lines.push(
+        `    properties: ${e.properties.map((p2) => p2.name).join(", ")}`
+      );
     }
   }
   return lines.join("\n");
@@ -684,40 +683,94 @@ async function runIntegrationAgent(opts) {
   const { repoPath, config, session, playbook, manifest, progress } = opts;
   applyModelAuthEnv(config, session);
   const systemPrompt6 = [BASE_WIZARD_PROMPT, playbook.systemPrompt].join("\n\n");
-  const verifyHint = playbook.verifyCommand ? `
-
-When finished, run \`${playbook.verifyCommand}\` and fix anything it flags.` : "";
-  const prompt = [
-    `Integrate the Whisperr ${playbook.target.displayName} SDK into this repository.`,
+  const started = Date.now();
+  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}`,
     "",
-    "Here is the integration manifest derived from this customer's Whisperr",
-    "onboarding. Wire identify() and instrument every event below at the correct",
-    "call site, following the SDK guide in your system prompt.",
+    "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.",
     "",
-    "----- MANIFEST -----",
-    renderManifestBrief(manifest),
-    "----- END MANIFEST -----",
-    verifyHint
+    "Do NOT instrument product events yet \u2014 that is a separate step." + verifyHint,
+    "",
+    "----- IDENTIFY -----",
+    renderIdentifyBrief(manifest),
+    "----- END -----"
   ].join("\n");
-  const started = Date.now();
+  const core = await runPass({
+    prompt: corePrompt,
+    systemPrompt: systemPrompt6,
+    repoPath,
+    model: config.model,
+    maxTurns: 20,
+    progress
+  });
+  costUsd += core.costUsd;
+  if (core.summary) summaries.push(`Core setup:
+${core.summary}`);
+  let eventsComplete = true;
+  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.",
+      "",
+      "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.",
+      "",
+      "----- EVENTS -----",
+      renderEventsBrief(manifest),
+      "----- END -----"
+    ].join("\n");
+    const events = await runPass({
+      prompt: eventsPrompt,
+      systemPrompt: systemPrompt6,
+      repoPath,
+      model: config.model,
+      maxTurns: config.maxTurns,
+      progress
+    });
+    costUsd += events.costUsd;
+    eventsComplete = !events.maxedOut;
+    if (events.summary) summaries.push(`Events:
+${events.summary}`);
+  }
+  return {
+    summary: summaries.join("\n\n"),
+    costUsd,
+    durationMs: Date.now() - started,
+    coreOk: core.ok,
+    eventsComplete
+  };
+}
+async function runPass(opts) {
+  const { prompt, systemPrompt: systemPrompt6, repoPath, model, maxTurns, progress } = opts;
   let summary = "";
-  let costUsd;
+  let costUsd = 0;
   let ok = false;
+  let maxedOut = false;
   const response = query({
     prompt,
     options: {
-      model: config.model,
+      model,
       cwd: repoPath,
       systemPrompt: systemPrompt6,
-      // Full file-system agent toolset.
       allowedTools: ["Read", "Edit", "Write", "Bash", "Glob", "Grep"],
-      // Fully autonomous edits (the user opted into auto-apply; the wizard takes
-      // a git checkpoint before this runs so revert is one command).
       permissionMode: "bypassPermissions",
-      maxTurns: config.maxTurns,
-      // Don't pick up the user's own CLAUDE.md / settings — the wizard's prompt
-      // is the single source of truth.
+      maxTurns,
       settingSources: []
     }
   });
@@ -732,12 +785,12 @@ When finished, run \`${playbook.verifyCommand}\` and fix anything it flags.` : "
       }
     } else if (message.type === "result") {
       ok = message.subtype === "success";
-      costUsd = message.total_cost_usd;
+      maxedOut = (message.subtype ?? "").includes("max_turns");
+      costUsd = message.total_cost_usd ?? 0;
       summary = message.result ?? extractLastText(message) ?? summary;
     }
   }
-  progress?.onResult?.(summary, costUsd);
-  return { summary, costUsd, ok, durationMs: Date.now() - started };
+  return { summary, costUsd, ok, maxedOut };
 }
 function applyModelAuthEnv(config, session) {
   if (config.directAnthropicKey) {
@@ -937,8 +990,8 @@ Flutter is live today; ${theme.bright(
     );
   }
   const spin = p.spinner();
-  spin.start(theme.bright("Integrating") + theme.muted(" \u2014 the agent is working in your code"));
-  let lastLine = "";
+  let phaseLabel = "Integrating";
+  spin.start(theme.bright(phaseLabel) + theme.muted(" \u2014 the agent is working in your code"));
   const outcome = await runIntegrationAgent({
     repoPath,
     config,
@@ -946,20 +999,22 @@ Flutter is live today; ${theme.bright(
     playbook: chosen.playbook,
     manifest,
     progress: {
+      onPhase(label) {
+        phaseLabel = label;
+        spin.message(theme.bright(label));
+      },
       onActivity(line) {
-        lastLine = line;
-        spin.message(theme.bright("Integrating") + theme.muted(` \u2014 ${line}`));
+        spin.message(theme.bright(phaseLabel) + theme.muted(` \u2014 ${line}`));
       }
     }
   }).catch((err) => {
-    spin.stop(theme.alert("Integration failed"));
+    spin.stop(theme.alert("Integration stopped"));
     p.log.error(err.message);
     return null;
   });
   if (!outcome) return 1;
-  spin.stop(
-    outcome.ok ? theme.success("Integration complete") : theme.warn("Integration finished with notes")
-  );
+  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);
   if (files.length) {
     p.note(files.map((f) => theme.muted("\u2022 ") + f).join("\n"), "Files changed");
@@ -967,6 +1022,11 @@ Flutter is live today; ${theme.bright(
   if (outcome.summary.trim()) {
     p.log.message(outcome.summary.trim());
   }
+  p.log.info(
+    theme.muted(
+      `${files.length} file${files.length === 1 ? "" : "s"} changed \xB7 ~$${outcome.costUsd.toFixed(2)} \xB7 ${Math.round(outcome.durationMs / 1e3)}s`
+    )
+  );
   if (!config.offline) {
     p.log.step(
       theme.bright("Run your app once") + theme.muted(" and trigger any tracked action \u2014 I'll watch for the first event.")
@@ -997,7 +1057,6 @@ Flutter is live today; ${theme.bright(
   ].filter(Boolean).join("\n");
   p.note(nextSteps, theme.bright("Next"));
   p.outro(theme.signal("\u2301 ") + theme.bright("Whisperr is wired in."));
-  void lastLine;
   return 0;
 }
 async function chooseTarget(detections) {
@@ -1134,7 +1193,7 @@ async function main() {
     return;
   }
   if ("version" in parsed) {
-    console.log("0.1.1");
+    console.log("0.1.2");
     return;
   }
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@whisperr/wizard",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "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,