@whisperr/wizard 0.1.11 → 0.1.13

package/dist/index.js

@@ -25,7 +25,13 @@ function resolveConfig(flags = {}) {
     llmBaseUrl,
     model: flags.model ?? process.env.WHISPERR_WIZARD_MODEL ?? DEFAULT_MODEL,
     effort: resolveEffort(),
-    maxTurns: Number(process.env.WHISPERR_WIZARD_MAX_TURNS ?? 55),
+    // Cost is the real limiter (budgetUsd below). maxTurns is only a high safety
+    // backstop against a stuck loop — it should NOT bind on a normal run. (It
+    // used to be 55, which guillotined high-effort multi-phase runs mid-work.)
+    maxTurns: Number(process.env.WHISPERR_WIZARD_MAX_TURNS) || 200,
+    // Hard ceiling on TOTAL spend across all phases. If hit, the run stops
+    // cleanly and keeps whatever already landed. Real runs finish well under it.
+    budgetUsd: Number(process.env.WHISPERR_WIZARD_BUDGET_USD) || 10,
     directAnthropicKey,
     offline
   };
@@ -67,7 +73,7 @@ var systemPrompt = `
 This SDK is published on pub.dev. Integrate it as follows.
 
 1) Dependency. Add to pubspec.yaml under dependencies:
-     whisperr: ^0.2.0
+     whisperr: ^0.2.2
    Then the SDK expects \`flutter pub get\` to be run (run it via bash).
 
 2) Initialize once, early, before runApp(), in lib/main.dart:
@@ -1208,14 +1214,21 @@ async function runIntegrationAgent(opts) {
     repoPath,
     model: config.model,
     effort: config.effort,
-    maxTurns: 35,
+    maxTurns: 50,
+    budgetUsd: config.budgetUsd - costUsd,
     progress
   });
   costUsd += core.costUsd;
   if (core.summary) summaries.push(`Core setup:
 ${core.summary}`);
+  const BUDGET_FLOOR = 0.25;
   let eventsComplete = true;
-  if (manifest.events.length > 0) {
+  if (manifest.events.length > 0 && config.budgetUsd - costUsd <= BUDGET_FLOOR) {
+    eventsComplete = false;
+    summaries.push(
+      "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) {
     progress?.onPhase?.("Instrumenting your events");
     const eventsPrompt = [
       `The Whisperr ${playbook.target.displayName} SDK is already installed and`,
@@ -1241,6 +1254,7 @@ ${core.summary}`);
       model: config.model,
       effort: config.effort,
       maxTurns: config.maxTurns,
+      budgetUsd: config.budgetUsd - costUsd,
       progress
     });
     costUsd += events.costUsd;
@@ -1248,7 +1262,7 @@ ${core.summary}`);
     if (events.summary) summaries.push(`Events:
 ${events.summary}`);
   }
-  if (core.ok) {
+  if (core.ok && config.budgetUsd - costUsd > BUDGET_FLOOR) {
     progress?.onPhase?.("Reviewing & correcting placements");
     const reviewPrompt = [
       `You wired the Whisperr ${playbook.target.displayName} SDK into this repo.`,
@@ -1279,7 +1293,8 @@ ${events.summary}`);
       repoPath,
       model: config.model,
       effort: config.effort,
-      maxTurns: 25,
+      maxTurns: 40,
+      budgetUsd: config.budgetUsd - costUsd,
       progress
     });
     costUsd += review.costUsd;
@@ -1294,8 +1309,12 @@ ${review.summary}`);
     eventsComplete
   };
 }
+function isLimitStop(err) {
+  const msg = err?.message ?? "";
+  return /max(imum)?[\s_-]*(turn|budget)|budget.*exceeded|number of turns/i.test(msg);
+}
 async function runPass(opts) {
-  const { prompt, systemPrompt: systemPrompt9, repoPath, model, effort, maxTurns, progress } = opts;
+  const { prompt, systemPrompt: systemPrompt9, repoPath, model, effort, maxTurns, budgetUsd, progress } = opts;
   let summary = "";
   let costUsd = 0;
   let ok = false;
@@ -1314,23 +1333,36 @@ async function runPass(opts) {
       allowedTools: ["Read", "Edit", "Write", "Bash", "Glob", "Grep"],
       permissionMode: "bypassPermissions",
       maxTurns,
+      // Native SDK hard cost cap. Stops this pass with an `error_max_budget_usd`
+      // result once spend exceeds the remaining budget — this, not maxTurns, is
+      // the real limiter. Omitted when there's no positive budget left.
+      ...budgetUsd && budgetUsd > 0 ? { maxBudgetUsd: budgetUsd } : {},
       settingSources: []
     }
   });
-  for await (const message of response) {
-    if (message.type === "assistant") {
-      for (const block of message.message?.content ?? []) {
-        if (isTextBlock(block) && block.text?.trim()) {
-          progress?.onActivity?.(firstLine(block.text));
-        } else if (isToolUseBlock(block)) {
-          progress?.onActivity?.(describeToolUse(block));
+  try {
+    for await (const message of response) {
+      if (message.type === "assistant") {
+        for (const block of message.message?.content ?? []) {
+          if (isTextBlock(block) && block.text?.trim()) {
+            progress?.onActivity?.(firstLine(block.text));
+          } else if (isToolUseBlock(block)) {
+            progress?.onActivity?.(describeToolUse(block));
+          }
         }
+      } else if (message.type === "result") {
+        ok = message.subtype === "success";
+        const sub = message.subtype ?? "";
+        maxedOut = sub.includes("max_turns") || sub.includes("max_budget");
+        costUsd = message.total_cost_usd ?? 0;
+        summary = message.result ?? extractLastText(message) ?? summary;
       }
-    } else if (message.type === "result") {
-      ok = message.subtype === "success";
-      maxedOut = (message.subtype ?? "").includes("max_turns");
-      costUsd = message.total_cost_usd ?? 0;
-      summary = message.result ?? extractLastText(message) ?? summary;
+    }
+  } catch (err) {
+    if (isLimitStop(err)) {
+      maxedOut = true;
+    } else {
+      throw err;
     }
   }
   return { summary, costUsd, ok, maxedOut };
@@ -1507,6 +1539,51 @@ async function pollFirstEvent(config, session, opts = {}) {
   return { received: false };
 }
 
+// src/core/postflight.ts
+import { spawn as spawn2 } from "child_process";
+var MAX_OUTPUT = 4e3;
+var DEFAULT_TIMEOUT_MS = 18e4;
+function runVerifyCommand(repoPath, command, opts = {}) {
+  if (!command || !command.trim()) {
+    return Promise.resolve({ ran: false, ok: true, output: "" });
+  }
+  const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  return new Promise((resolve2) => {
+    const child = spawn2(command, { cwd: repoPath, shell: true, env: process.env });
+    let out = "";
+    const append = (d) => {
+      out += d.toString();
+      if (out.length > MAX_OUTPUT * 4) out = out.slice(-MAX_OUTPUT * 2);
+    };
+    child.stdout?.on("data", append);
+    child.stderr?.on("data", append);
+    const timer = setTimeout(() => {
+      child.kill("SIGKILL");
+      resolve2({ ran: true, ok: false, command, output: tail(out), timedOut: true });
+    }, timeoutMs);
+    child.on("close", (code) => {
+      clearTimeout(timer);
+      resolve2({
+        ran: true,
+        ok: code === 0,
+        command,
+        exitCode: code,
+        output: tail(out),
+        // 127 = "command not found": the verify tool isn't on PATH here.
+        toolMissing: code === 127
+      });
+    });
+    child.on("error", () => {
+      clearTimeout(timer);
+      resolve2({ ran: true, ok: false, command, output: tail(out), toolMissing: true });
+    });
+  });
+}
+function tail(s) {
+  const t = s.trim();
+  return t.length > MAX_OUTPUT ? `\u2026${t.slice(-MAX_OUTPUT)}` : t;
+}
+
 // src/core/report.ts
 async function postRunReport(config, session, report) {
   if (config.offline) return;
@@ -1673,6 +1750,40 @@ Flutter is live today; ${theme.bright(
       return 1;
     }
   }
+  let verified = null;
+  if (chosen.playbook.verifyCommand && files.length) {
+    const cmd = chosen.playbook.verifyCommand;
+    const vspin = p.spinner();
+    vspin.start(`Verifying the integration \u2014 ${theme.muted(cmd)}`);
+    const verdict = await runVerifyCommand(repoPath, cmd);
+    if (verdict.toolMissing) {
+      vspin.stop(
+        theme.warn("Couldn't verify automatically") + theme.muted(` \u2014 \`${cmd}\` isn't available here. Run it yourself before committing.`)
+      );
+    } else if (verdict.timedOut) {
+      vspin.stop(
+        theme.warn(`Verification timed out \u2014 \`${cmd}\``) + theme.muted(" \u2014 run it yourself before committing.")
+      );
+    } else if (verdict.ok) {
+      verified = true;
+      vspin.stop(theme.success("Verified \u2713") + theme.muted(` (${cmd})`));
+    } else {
+      verified = false;
+      vspin.stop(theme.alert(`Verification failed \u2014 ${cmd}`));
+      if (verdict.output) {
+        p.note(verdict.output, theme.warn("Verifier output"));
+      }
+      const reverted = await maybeRevert(
+        repoPath,
+        checkpoint,
+        "The integration didn't pass its build/lint check, so the edits may be broken."
+      );
+      if (reverted) {
+        p.outro(theme.muted("Reverted \u2014 nothing was left in your working tree."));
+        return 1;
+      }
+    }
+  }
   const wiredMap = await scanWiredEvents(
     repoPath,
     files,
@@ -1687,6 +1798,7 @@ Flutter is live today; ${theme.bright(
     target: chosen.playbook.target.id,
     repo_fingerprint: fingerprint,
     identify_wired: outcome.coreOk,
+    verified,
     cost_usd: outcome.costUsd,
     duration_ms: outcome.durationMs,
     summary: outcome.summary.slice(0, 4e3),
@@ -1694,7 +1806,7 @@ Flutter is live today; ${theme.bright(
   });
   p.log.info(
     theme.muted(
-      `${wiredMap.size}/${manifest.events.length} events wired \xB7 ${files.length} file${files.length === 1 ? "" : "s"} changed \xB7 ${Math.round(outcome.durationMs / 1e3)}s`
+      `${wiredMap.size}/${manifest.events.length} events wired \xB7 ${files.length} file${files.length === 1 ? "" : "s"} changed \xB7 ` + (verified === true ? "verified \xB7 " : verified === false ? "unverified \xB7 " : "") + `${Math.round(outcome.durationMs / 1e3)}s`
     )
   );
   if (!config.offline) {
@@ -1890,7 +2002,7 @@ async function main() {
     return;
   }
   if ("version" in parsed) {
-    console.log("0.1.11");
+    console.log("0.1.12");
     return;
   }
   try {

package/package.json

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