sproutkit-code 0.15.0 → 0.17.0

package/dist/index.js

@@ -30557,6 +30557,147 @@ var require_llm = __commonJS({
   }
 });
 
+// ../desktop/dist/main/lib/qa.js
+var require_qa = __commonJS({
+  "../desktop/dist/main/lib/qa.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.staticChecks = staticChecks;
+    exports2.reviewWithClaude = reviewWithClaude;
+    exports2.fixIssues = fixIssues;
+    var llm_1 = require_llm();
+    function staticChecks(args) {
+      const { code, photoCount, phone, businessName } = args;
+      const issues = [];
+      const deadHrefs = code.match(/href\s*=\s*["'`]\s*#\s*["'`]/g)?.length ?? 0;
+      if (deadHrefs > 0) {
+        issues.push({
+          severity: "warn",
+          code: "dead_href",
+          detail: `${deadHrefs} placeholder href="#" link(s) \u2014 nav/CTAs should point somewhere real (tel:, /book, or a section id).`
+        });
+      }
+      if (/lorem ipsum|todo:|placeholder text/i.test(code)) {
+        issues.push({
+          severity: "error",
+          code: "placeholder_copy",
+          detail: "Placeholder copy (lorem ipsum / TODO) left in the page."
+        });
+      }
+      if (businessName && !code.includes(businessName.split(" ")[0])) {
+        issues.push({
+          severity: "error",
+          code: "missing_business_name",
+          detail: `The business name ("${businessName}") doesn't appear in the page.`
+        });
+      }
+      if (phone && !code.includes("tel:")) {
+        issues.push({
+          severity: "warn",
+          code: "missing_phone_cta",
+          detail: "A phone number is on file but there's no tel: link to call it."
+        });
+      }
+      const referenced = new Set((code.match(/\/photo(\d+)\.jpg/g) ?? []).map((m) => Number(m.match(/\d+/)[0])));
+      const overRef = [...referenced].filter((n) => n > photoCount);
+      if (overRef.length > 0) {
+        issues.push({
+          severity: "error",
+          code: "broken_image_ref",
+          detail: `References /photo${overRef.join(", /photo")}.jpg but only ${photoCount} photo(s) were shipped \u2014 those images will be broken.`
+        });
+      }
+      if (photoCount > 0 && referenced.size === 0 && !code.includes("PHOTOS")) {
+        issues.push({
+          severity: "warn",
+          code: "unused_photos",
+          detail: `${photoCount} real photo(s) were shipped but the page uses none of them.`
+        });
+      }
+      if (/>\s*(Opening Hours|Hours)\s*<\/[a-z0-9]+>\s*<\/(div|section)>/i.test(code)) {
+        issues.push({
+          severity: "warn",
+          code: "empty_section",
+          detail: "An Opening Hours heading appears with no content under it \u2014 omit the section instead of rendering it empty."
+        });
+      }
+      return issues;
+    }
+    async function reviewWithClaude(args) {
+      const prompt = `You are reviewing a generated single-page React site (App.jsx) for a real local business before it's shown to the owner. Find only genuine DEFECTS \u2014 things that would look broken, unfinished, or wrong to that owner.
+
+Business: "${args.businessName}" (${args.businessType})
+
+Look for: sections that render empty or with placeholder content; copy that doesn't match this business/industry; links that go nowhere; text that's cut off mid-sentence; duplicated sections; contact details that contradict each other; obviously broken layout (e.g. a grid with one item, overlapping fixed elements).
+Do NOT report style preferences, colour choices, or "could be improved" suggestions. Only defects.
+
+Respond with ONLY compact JSON, no prose:
+{"issues":[{"severity":"error"|"warn","code":"short_slug","detail":"one sentence"}]}
+If there are no real defects, return {"issues":[]}.
+
+App.jsx:
+\`\`\`jsx
+${args.code.slice(0, 45e3)}
+\`\`\``;
+      try {
+        const res = await (0, llm_1.generateText)({
+          apiKey: args.apiKey,
+          prompt,
+          maxTokens: 2048,
+          timeoutMs: 18e4
+        });
+        const raw = res.text.replace(/^```(?:json)?\s*/i, "").replace(/\s*```\s*$/, "").trim();
+        const match = raw.match(/\{[\s\S]*\}/);
+        if (!match)
+          return [];
+        const parsed = JSON.parse(match[0]);
+        if (!Array.isArray(parsed.issues))
+          return [];
+        return parsed.issues.filter((i) => !!i && typeof i.detail === "string").slice(0, 12).map((i) => ({
+          severity: i.severity === "error" ? "error" : "warn",
+          code: String(i.code || "issue").slice(0, 40),
+          detail: String(i.detail).slice(0, 300)
+        }));
+      } catch {
+        return [];
+      }
+    }
+    async function fixIssues(args) {
+      if (args.issues.length === 0)
+        return null;
+      const list = args.issues.map((i, n) => `${n + 1}. [${i.severity}] ${i.detail}`).join("\n");
+      const prompt = `Fix these specific defects in the React component below. Change ONLY what's needed to fix them \u2014 do not redesign, restyle, rewrite copy that isn't faulty, or remove working sections.
+
+Defects:
+${list}
+
+Rules: keep the same design language and structure; if a section can't be filled with real content, remove the section entirely rather than leaving it empty; never invent image URLs (only use the existing PHOTOS entries); the file must remain a single component ending in \`export default App;\`.
+
+Return ONLY the complete corrected App.jsx \u2014 no markdown fences, no commentary.
+
+\`\`\`jsx
+${args.code.slice(0, 45e3)}
+\`\`\``;
+      try {
+        const res = await (0, llm_1.generateText)({
+          apiKey: args.apiKey,
+          prompt,
+          maxTokens: 64e3,
+          timeoutMs: 3e5
+        });
+        const cleaned = res.text.replace(/^```[a-z]*\s*/i, "").replace(/\s*```$/, "").trim();
+        if (!cleaned.includes("export default App"))
+          return null;
+        if (cleaned.length < args.code.length * 0.5)
+          return null;
+        return cleaned;
+      } catch {
+        return null;
+      }
+    }
+  }
+});
+
 // ../desktop/dist/main/lib/models.js
 var require_models = __commonJS({
   "../desktop/dist/main/lib/models.js"(exports2) {
@@ -35390,7 +35531,7 @@ var require_cross_spawn = __commonJS({
       enoent.hookChildProcess(spawned, parsed);
       return spawned;
     }
-    function spawnSync3(command, args, options) {
+    function spawnSync4(command, args, options) {
       const parsed = parse(command, args, options);
       const result = cp.spawnSync(parsed.command, parsed.args, parsed.options);
       result.error = result.error || enoent.verifyENOENTSync(result.status, parsed);
@@ -35398,7 +35539,7 @@ var require_cross_spawn = __commonJS({
     }
     module2.exports = spawn2;
     module2.exports.spawn = spawn2;
-    module2.exports.sync = spawnSync3;
+    module2.exports.sync = spawnSync4;
     module2.exports._parse = parse;
     module2.exports._enoent = enoent;
   }
@@ -79518,6 +79659,7 @@ var require_builder = __commonJS({
     var runtime_1 = require_runtime();
     var db_1 = require_db();
     var llm_1 = require_llm();
+    var qa_1 = require_qa();
     var fs3 = __importStar(require("fs"));
     var path3 = __importStar(require("path"));
     var models_1 = require_models();
@@ -79760,7 +79902,7 @@ var require_builder = __commonJS({
       }
     }
     async function buildAndDeploySite(args) {
-      const { lead, anthropicKey, vercelToken, placesKey, customInstructions, onProgress, includeCms, blobToken, reuseAdminPassword, skipContentExtraction, multipage, pages } = args;
+      const { lead, anthropicKey, vercelToken, placesKey, customInstructions, onProgress, includeCms, blobToken, reuseAdminPassword, skipContentExtraction, multipage, pages, skipQa } = args;
       const pageList = multipage && (!pages || pages.length === 0) ? ["Home", "Services", "About", "Contact"] : pages ?? [];
       if (includeCms && !blobToken) {
         throw new Error("CMS is enabled but no Vercel Blob token is set. Add it in Settings \u2192 Vercel Blob token.");
@@ -80073,6 +80215,35 @@ ${prompt}` : prompt;
         }
       }
       appCode = appCode.replace("REPLACE_PHOTOS", JSON.stringify(photoPaths));
+      if (!skipQa) {
+        onProgress("Reviewing the site for defects\u2026");
+        const staticIssues = (0, qa_1.staticChecks)({
+          code: appCode,
+          photoCount: photoFiles.length,
+          phone: lead.phone ?? "",
+          businessName: lead.name
+        });
+        const modelIssues = await (0, qa_1.reviewWithClaude)({
+          code: appCode,
+          businessName: lead.name,
+          businessType: lead.type ?? "local business",
+          apiKey: anthropicKey
+        });
+        const issues = [...staticIssues, ...modelIssues];
+        if (issues.length > 0) {
+          const errors = issues.filter((i) => i.severity === "error").length;
+          onProgress(`QA found ${issues.length} issue${issues.length === 1 ? "" : "s"}${errors ? ` (${errors} serious)` : ""} \u2014 fixing\u2026`);
+          const fixed = await (0, qa_1.fixIssues)({ code: appCode, issues, apiKey: anthropicKey });
+          if (fixed) {
+            appCode = fixed;
+            onProgress("QA fixes applied.");
+          } else {
+            onProgress("QA fix didn't come back clean \u2014 deploying the original.");
+          }
+        } else {
+          onProgress("QA passed.");
+        }
+      }
       onProgress("Deploying to Vercel...");
       const indexHtml = `<!DOCTYPE html>
 <html lang="en"><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${lead.name}</title></head>
@@ -92713,6 +92884,77 @@ var require_email = __commonJS({
   }
 });
 
+// ../desktop/dist/main/lib/email-harvest.js
+var require_email_harvest = __commonJS({
+  "../desktop/dist/main/lib/email-harvest.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.harvestEmail = harvestEmail;
+    var llm_1 = require_llm();
+    var BAD_EMAIL_DOMAINS = [
+      "yelp.com",
+      "yell.com",
+      "tripadvisor",
+      "facebook.com",
+      "instagram.com",
+      "google.com",
+      "justeat",
+      "deliveroo",
+      "ubereats",
+      "treatwell",
+      "fresha.com",
+      "booking.com",
+      "example.com",
+      "sentry.io",
+      "wixpress.com",
+      "squarespace.com"
+    ];
+    function plausibleEmail(raw) {
+      if (typeof raw !== "string")
+        return null;
+      const email = raw.trim().toLowerCase();
+      if (!/^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/.test(email))
+        return null;
+      const domain = email.split("@")[1] ?? "";
+      if (BAD_EMAIL_DOMAINS.some((d) => domain.includes(d)))
+        return null;
+      return email;
+    }
+    async function harvestEmail(args) {
+      const prompt = `Search the web for the contact email address of this specific local business.
+
+Business: "${args.name}"
+Address: ${args.address}${args.city ? `, ${args.city}` : ""}
+
+Rules \u2014 be strict:
+- The email must clearly belong to THIS business at THIS address/city. A business with the same or similar name in a different town or country is NOT a match \u2014 return null.
+- Prefer an email on the business's own website or its official social profile.
+- Do NOT return an email belonging to a directory, aggregator or booking platform (Yelp, Yell, TripAdvisor, JustEat, Deliveroo, Treatwell, Fresha, etc.).
+- Do NOT guess, construct, or infer an address (e.g. never invent info@<name>.com).
+- If you cannot confirm a real email for this exact business, return null.
+
+Respond with ONLY compact JSON, no prose: {"email": string|null}`;
+      try {
+        const res = await (0, llm_1.generateText)({
+          apiKey: args.apiKey,
+          prompt,
+          allowWebSearch: true,
+          maxTokens: 512,
+          timeoutMs: 9e4
+        });
+        const raw = res.text.replace(/^```(?:json)?\s*/i, "").replace(/\s*```\s*$/, "").trim();
+        const match = raw.match(/\{[\s\S]*\}/);
+        if (!match)
+          return null;
+        const parsed = JSON.parse(match[0]);
+        return plausibleEmail(parsed.email);
+      } catch {
+        return null;
+      }
+    }
+  }
+});
+
 // ../desktop/dist/main/lib/chat-tools.js
 var require_chat_tools = __commonJS({
   "../desktop/dist/main/lib/chat-tools.js"(exports2) {
@@ -92726,6 +92968,7 @@ var require_chat_tools = __commonJS({
     var lead_search_1 = require_lead_search();
     var places_1 = require_places();
     var email_1 = require_email();
+    var email_harvest_1 = require_email_harvest();
     exports2.TOOLS = [
       {
         name: "find_leads",
@@ -92846,6 +93089,10 @@ var require_chat_tools = __commonJS({
             multipage: {
               type: "boolean",
               description: "When true, build a MULTI-PAGE site (Home/Services/About/Contact as real routed pages with a nav) instead of a single long-scroll page. Use when the user asks for a multipage site or a bigger site with separate pages."
+            },
+            skipQa: {
+              type: "boolean",
+              description: "Skip the post-build QA review (a review + fix pass that catches broken links, empty sections, broken image refs). Only set true when the user explicitly wants maximum speed/volume over quality."
             }
           },
           required: ["id"]
@@ -92975,6 +93222,7 @@ var require_chat_tools = __commonJS({
           customInstructions: args.instructions,
           includeCms: args.includeCms,
           multipage: args.multipage,
+          skipQa: args.skipQa,
           blobToken,
           onProgress: (msg) => args.ctx.emitProgress?.({
             channel: "sites:progress",
@@ -93160,7 +93408,7 @@ Interested?`;
         }
         case "prepare_outreach": {
           const explicit = input.ids;
-          const rows = explicit && explicit.length > 0 ? db2.all(`SELECT id, name, phone, email, site_url FROM leads WHERE id IN (${explicit.map(() => "?").join(",")})`, explicit) : db2.all("SELECT id, name, phone, email, site_url FROM leads WHERE status = 'site_built' AND site_url IS NOT NULL AND site_url != '' ORDER BY score DESC NULLS LAST, id DESC", []);
+          const rows = explicit && explicit.length > 0 ? db2.all(`SELECT id, name, phone, email, address, city, site_url FROM leads WHERE id IN (${explicit.map(() => "?").join(",")})`, explicit) : db2.all("SELECT id, name, phone, email, address, city, site_url FROM leads WHERE status = 'site_built' AND site_url IS NOT NULL AND site_url != '' ORDER BY score DESC NULLS LAST, id DESC", []);
           const eligible = rows.filter((r) => r.site_url);
           if (eligible.length === 0) {
             return {
@@ -93174,9 +93422,27 @@ Interested?`;
           const smtp = (0, email_1.smtpFromSettings)((k) => getDecryptedSetting(k));
           const emailSubject = getDecryptedSetting("outreach_email_subject") || "A free demo website for {name}";
           const prepared = [];
+          let harvested = 0;
           for (const r of eligible) {
             const message = template.replace(/\{name\}/g, r.name).replace(/\{site_url\}/g, r.site_url ?? "");
             const e164 = toE164(r.phone ?? "");
+            if (!e164 && !r.email && smtp) {
+              ctx.emitProgress?.({
+                channel: "outreach:progress",
+                payload: { msg: `Looking up an email for ${r.name}\u2026` }
+              });
+              const found = await (0, email_harvest_1.harvestEmail)({
+                name: r.name,
+                address: r.address ?? "",
+                city: r.city ?? "",
+                apiKey: getDecryptedSetting("anthropic_key")
+              });
+              if (found) {
+                db2.run("UPDATE leads SET email = ? WHERE id = ?", [found, r.id]);
+                r.email = found;
+                harvested++;
+              }
+            }
             if (e164) {
               prepared.push({
                 id: r.id,
@@ -93227,6 +93493,7 @@ Interested?`;
             phoneLinks: prepared.filter((p) => p.via === "phone").length,
             emailsSent,
             emailsFailed,
+            emailsFound: harvested,
             unreachable,
             // Guide the user if email-only leads were skipped for want of SMTP.
             note: smtpMissing ? "Some leads have only an email but SMTP isn't set up \u2014 run 'sproutkit setup' to add SMTP and email them." : void 0,
@@ -93248,6 +93515,7 @@ Interested?`;
             instructions: input.instructions,
             includeCms: !!input.includeCms,
             multipage: !!input.multipage,
+            skipQa: input.skipQa === true,
             ctx
           });
           return { ...result, id };
@@ -93265,6 +93533,7 @@ Interested?`;
             id,
             instructions,
             multipage: !!input.multipage,
+            skipQa: input.skipQa === true,
             ctx
           });
           return { ...result, id };
@@ -94328,7 +94597,7 @@ var require_package2 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "sproutkit-code",
-      version: "0.15.0",
+      version: "0.17.0",
       description: "Sproutkit in your terminal \u2014 find leads, build sites, run outreach, all via chat.",
       bin: {
         sproutkit: "./dist/index.js"
@@ -94589,10 +94858,10 @@ var Status = class {
       this.timer = null;
     }
     const label = finalLabel ?? this.label;
-    const mark = ok ? c.green("\u2713") : c.red("\u2717");
-    if (this.tty) process.stdout.write(`\r\x1B[2K  ${mark} ${label}
+    const mark2 = ok ? c.green("\u2713") : c.red("\u2717");
+    if (this.tty) process.stdout.write(`\r\x1B[2K  ${mark2} ${label}
 `);
-    else say(`  ${mark} ${label}`);
+    else say(`  ${mark2} ${label}`);
   }
 };
 var STATE_MARK = {
@@ -94641,16 +94910,16 @@ var StatusBoard = class {
     else this.render();
   }
   line(r) {
-    const mark = r.state === "building" ? c.cyan(FRAMES[this.frame]) : STATE_MARK[r.state]();
+    const mark2 = r.state === "building" ? c.cyan(FRAMES[this.frame]) : STATE_MARK[r.state]();
     const detail = r.detail ? c.dim(` \xB7 ${r.detail}`) : "";
-    return `  ${mark} ${r.label}${detail}`;
+    return `  ${mark2} ${r.label}${detail}`;
   }
   logRowIfChanged(r) {
     const sig = `${r.state}:${r.detail ?? ""}`;
     if (this.lastSig.get(r.key) === sig) return;
     this.lastSig.set(r.key, sig);
-    const mark = r.state === "built" ? "\u2713" : r.state === "failed" ? "\u2717" : r.state === "skipped" ? "\u2013" : "\u2026";
-    say(`    ${mark} ${r.label}${r.detail ? ` \xB7 ${r.detail}` : ""}`);
+    const mark2 = r.state === "built" ? "\u2713" : r.state === "failed" ? "\u2717" : r.state === "skipped" ? "\u2013" : "\u2026";
+    say(`    ${mark2} ${r.label}${r.detail ? ` \xB7 ${r.detail}` : ""}`);
   }
   render() {
     if (this.lastLineCount > 0) process.stdout.write(`\x1B[${this.lastLineCount}A`);
@@ -95485,7 +95754,8 @@ async function cmdBuild(argv) {
         id,
         instructions: flags.instructions ? String(flags.instructions) : void 0,
         includeCms: !!flags.cms,
-        multipage: !!flags.multipage
+        multipage: !!flags.multipage,
+        skipQa: !!flags["skip-qa"]
       },
       makeCtx({ json, status })
     );
@@ -95540,6 +95810,7 @@ async function cmdOutreach(argv) {
   say();
   const parts = [];
   if (result.phoneLinks) parts.push(`${result.phoneLinks} message link${result.phoneLinks === 1 ? "" : "s"} to open`);
+  if (result.emailsFound) parts.push(c.dim(`${result.emailsFound} email${result.emailsFound === 1 ? "" : "s"} found`));
   if (result.emailsSent) parts.push(`${result.emailsSent} emailed`);
   if (result.emailsFailed) parts.push(c.red(`${result.emailsFailed} email failed`));
   if (result.unreachable) parts.push(c.amber(`${result.unreachable} unreachable`));
@@ -95569,7 +95840,7 @@ async function cmdRegenerate(argv) {
   try {
     const result = await runTool(
       "regenerate_site",
-      { id, instructions, multipage: !!flags.multipage },
+      { id, instructions, multipage: !!flags.multipage, skipQa: !!flags["skip-qa"] },
       makeCtx({ json, status })
     );
     if (result && result.ok === false) {
@@ -95845,13 +96116,136 @@ function runClaudeTurn(args) {
   });
 }
 
-// src/index.ts
+// src/doctor.ts
 var import_child_process4 = require("child_process");
+function mark(l) {
+  return l === "ok" ? c.green("\u2713") : l === "warn" ? c.amber("!") : c.red("\u2717");
+}
+async function runDoctor() {
+  const rows = [];
+  const backend = getBackend();
+  const lic = await check();
+  rows.push(
+    lic.status === "active" ? { level: "ok", label: "Licence", detail: "active" } : {
+      level: "fail",
+      label: "Licence",
+      detail: lic.status,
+      fix: "Run 'sproutkit setup' and enter your key, or buy one at https://sproutkit.app"
+    }
+  );
+  if (backend === "claude_code") {
+    const present = (() => {
+      try {
+        return (0, import_child_process4.spawnSync)(claudeBin(), ["--version"], { stdio: "ignore", timeout: 1e4 }).status === 0;
+      } catch {
+        return false;
+      }
+    })();
+    if (!present) {
+      rows.push({
+        level: "fail",
+        label: "Claude Code",
+        detail: "CLI not found",
+        fix: "Install Claude Code, run 'claude /login', then 'sproutkit setup'."
+      });
+    } else {
+      const auth = await checkClaudeCodeAuth();
+      rows.push(
+        auth.ok ? {
+          level: "ok",
+          label: "Claude (subscription)",
+          detail: `logged in \xB7 model: ${getClaudeCodeModel() ?? "default"}`
+        } : {
+          level: "fail",
+          label: "Claude (subscription)",
+          detail: auth.reason,
+          fix: "Run 'claude /login' in another terminal, then re-run doctor."
+        }
+      );
+    }
+  } else {
+    rows.push(
+      getSetting("anthropic_key") ? { level: "ok", label: "Anthropic API key", detail: "set" } : {
+        level: "fail",
+        label: "Anthropic API key",
+        detail: "missing",
+        fix: "Run 'sproutkit setup' (or switch to the Claude subscription backend)."
+      }
+    );
+  }
+  rows.push(
+    getSetting("places_key") ? { level: "ok", label: "Google Places key", detail: "set \u2014 lead search works" } : {
+      level: "fail",
+      label: "Google Places key",
+      detail: "missing",
+      fix: "Run 'sproutkit setup'. Without it, 'find' can't search for leads."
+    }
+  );
+  rows.push(
+    getSetting("vercel_token") ? { level: "ok", label: "Vercel token", detail: "set \u2014 deploys work" } : {
+      level: "fail",
+      label: "Vercel token",
+      detail: "missing",
+      fix: "Run 'sproutkit setup'. Without it, sites can't deploy."
+    }
+  );
+  rows.push(
+    getSetting("blob_token") ? { level: "ok", label: "Vercel Blob token", detail: "set \u2014 booking & CMS work" } : {
+      level: "warn",
+      label: "Vercel Blob token",
+      detail: "missing \u2014 booking sites & CMS will fail",
+      fix: "Create a Blob store at https://vercel.com/dashboard/stores, copy BLOB_READ_WRITE_TOKEN, then 'sproutkit setup'. One token covers all your sites."
+    }
+  );
+  const smtpReady = !!(getSetting("smtp_host") && getSetting("smtp_user") && getSetting("smtp_pass"));
+  rows.push(
+    smtpReady ? { level: "ok", label: "SMTP (email outreach)", detail: `via ${getSetting("smtp_host")}` } : {
+      level: "warn",
+      label: "SMTP (email outreach)",
+      detail: "not set \u2014 leads without a phone can't be emailed",
+      fix: "Run 'sproutkit setup' and add SMTP host/user/password."
+    }
+  );
+  rows.push(
+    getSetting("resend_key") ? { level: "ok", label: "Resend key", detail: "set \u2014 booking emails notify the owner" } : {
+      level: "warn",
+      label: "Resend key",
+      detail: "not set \u2014 bookings are stored but the owner isn't emailed",
+      fix: "Optional. Add it in 'sproutkit setup' if you want booking notifications."
+    }
+  );
+  rows.push(
+    skillInstalled() ? { level: "ok", label: "Claude Code skill", detail: skillTargetDir() } : {
+      level: "warn",
+      label: "Claude Code skill",
+      detail: "not installed",
+      fix: "Run 'sproutkit setup' and say yes to installing the skill, so `claude` can drive Sproutkit."
+    }
+  );
+  say();
+  say(c.greenBold("  Sproutkit doctor"));
+  say(c.dim(`  Backend: ${backend === "claude_code" ? "Claude subscription" : "Anthropic API key"}`));
+  say();
+  for (const r of rows) {
+    say(`  ${mark(r.level)} ${c.bold(r.label)}${r.detail ? c.dim(` \u2014 ${r.detail}`) : ""}`);
+    if (r.fix && r.level !== "ok") say(c.dim(`      \u2192 ${r.fix}`));
+  }
+  say();
+  const fails = rows.filter((r) => r.level === "fail").length;
+  const warns = rows.filter((r) => r.level === "warn").length;
+  if (fails === 0 && warns === 0) say(c.green("  All good \u2014 you're ready to find leads and build sites."));
+  else if (fails === 0) say(c.amber(`  Ready to build, with ${warns} optional thing${warns === 1 ? "" : "s"} unset (see above).`));
+  else say(c.red(`  ${fails} blocking issue${fails === 1 ? "" : "s"} \u2014 fix those first.`));
+  say();
+}
+
+// src/index.ts
+var import_child_process5 = require("child_process");
 process.env.SPROUTKIT_HEADLESS = "1";
 function claudePresent() {
   try {
     const bin = process.env.SPROUTKIT_CLAUDE_BIN || "claude";
-    return (0, import_child_process4.spawnSync)(bin, ["--version"], { stdio: "ignore", timeout: 1e4 }).status === 0;
+    return (0, import_child_process5.spawnSync)(bin, ["--version"], { stdio: "ignore", timeout: 1e4 }).status === 0;
   } catch {
     return false;
   }
@@ -95892,6 +96286,11 @@ async function main() {
     closeTty();
     return;
   }
+  if (arg === "doctor") {
+    await runDoctor();
+    closeTty();
+    return;
+  }
   if (arg === "find" || arg === "list" || arg === "build" || arg === "build-all" || arg === "regenerate" || arg === "cms" || arg === "book" || arg === "outreach") {
     const subArgs = process.argv.slice(3);
     const lic2 = await check();
@@ -95929,6 +96328,7 @@ async function main() {
     say(`  ${c.bold("sproutkit book <id>")}           booking site (--standalone for own-URL)`);
     say(`  ${c.bold("sproutkit outreach")}            prep outreach links (--ids 3,5)`);
     say(`  ${c.bold("sproutkit setup")}               set or update keys, licence, backend`);
+    say(`  ${c.bold("sproutkit doctor")}              check everything is wired up`);
     say(`  ${c.bold("sproutkit models")}              list Claude models and pick one`);
     say(`  ${c.bold("sproutkit sync")}                push your leads into the desktop app`);
     say(`  ${c.bold("sproutkit update")}              update to the latest version`);
@@ -95999,7 +96399,7 @@ async function main() {
     }
     const direct = line.replace(/^\//, "");
     const verb = direct.split(/\s+/)[0]?.toLowerCase();
-    const DIRECT_VERBS = ["find", "list", "build", "build-all", "regenerate", "cms", "book", "outreach"];
+    const DIRECT_VERBS = ["find", "list", "build", "build-all", "regenerate", "cms", "book", "outreach", "doctor"];
     if (verb === "commands" || verb === "help" || line === "/help" || line === "/?") {
       say();
       say(c.bold("  Commands (type with or without a leading /):"));
@@ -96012,7 +96412,7 @@ async function main() {
       say(`    ${c.greenBold("book")} <id> [--standalone] [--archetype slots|reservation|enquiry] [--email \u2026]`);
       say(`    ${c.dim("        ")}                                          booking on the site, or --standalone for its own URL`);
       say(`    ${c.greenBold("outreach")} [--ids 3,5]                       prepare outreach links`);
-      say(c.dim("    /freemode \u2014 open conversation & custom tweaks \xB7 /taskmode \u2014 precise \xB7 exit \u2014 quit"));
+      say(c.dim("    doctor \u2014 check your setup \xB7 /freemode \u2014 open chat \xB7 /taskmode \u2014 precise \xB7 exit"));
       say(c.dim("    Or just talk: \u201Cfind cafes in Leeds and build the best two\u201D."));
       say();
       continue;
@@ -96029,6 +96429,7 @@ async function main() {
         else if (verb === "cms") await cmdCms(argv);
         else if (verb === "book") await cmdBook(argv);
         else if (verb === "outreach") await cmdOutreach(argv);
+        else if (verb === "doctor") await runDoctor();
       } catch (e) {
         say(c.red(`  Error: ${e.message}`));
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sproutkit-code",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "Sproutkit in your terminal — find leads, build sites, run outreach, all via chat.",
   "bin": {
     "sproutkit": "./dist/index.js"