sproutkit-code 0.16.0 → 0.18.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) {
@@ -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>
@@ -92918,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"]
@@ -93047,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",
@@ -93339,6 +93515,7 @@ Interested?`;
             instructions: input.instructions,
             includeCms: !!input.includeCms,
             multipage: !!input.multipage,
+            skipQa: input.skipQa === true,
             ctx
           });
           return { ...result, id };
@@ -93356,6 +93533,7 @@ Interested?`;
             id,
             instructions,
             multipage: !!input.multipage,
+            skipQa: input.skipQa === true,
             ctx
           });
           return { ...result, id };
@@ -94419,7 +94597,7 @@ var require_package2 = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "sproutkit-code",
-      version: "0.16.0",
+      version: "0.18.0",
       description: "Sproutkit in your terminal \u2014 find leads, build sites, run outreach, all via chat.",
       bin: {
         sproutkit: "./dist/index.js"
@@ -95576,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 })
     );
@@ -95639,6 +95818,90 @@ async function cmdOutreach(argv) {
   if (result.note) say(c.dim("  " + result.note));
   say();
 }
+async function cmdPipeline(argv) {
+  const { flags, rest } = parseArgs(argv);
+  const json = !!flags.json;
+  const xArg = rest.find((r) => /^x\d+$/i.test(r));
+  const concurrency = Math.min(
+    Math.max(Number(flags.concurrency ?? (xArg ? xArg.slice(1) : 2)), 1),
+    4
+  );
+  const withBooking = !!flags.book;
+  const limit = Math.min(Math.max(Number(flags.limit ?? 10), 1), 50);
+  const explicitIds = String(flags.ids ?? "").split(",").map((s) => Number(s.trim())).filter((n) => !Number.isNaN(n) && n > 0);
+  const all = await runTool("list_leads", { limit: 100 }, makeCtx({ json }));
+  const targets = (explicitIds.length ? all.filter((l) => explicitIds.includes(l.id)) : all.filter((l) => !l.site_url)).slice(0, limit);
+  if (targets.length === 0) {
+    const msg = "No leads to run. Find some first, or pass --ids.";
+    json ? emitJson({ ok: false, error: msg }) : say(c.amber("  " + msg));
+    return;
+  }
+  const board = json ? null : new StatusBoard();
+  const rowFor = (t, state, detail) => ({ key: t.id, label: `#${t.id} ${t.name}`, state, detail });
+  if (board) {
+    board.start(
+      `Pipeline for ${targets.length} client${targets.length === 1 ? "" : "s"} (${concurrency} at a time)`,
+      targets.map((t) => rowFor(t, "queued"))
+    );
+  }
+  const results = [];
+  const queue = [...targets];
+  async function runOne(t) {
+    const setRow = (state, detail) => board?.update(rowFor(t, state, detail));
+    setRow("building", "building site\u2026");
+    try {
+      const built = await runTool(
+        "build_site",
+        { id: t.id, skipQa: !!flags["skip-qa"], multipage: !!flags.multipage },
+        makeCtx({ json: true })
+        // suppress per-tool spinners; the board is the UI
+      );
+      if (built && built.ok === false) {
+        setRow("failed", built.error ?? "build failed");
+        results.push({ id: t.id, name: t.name, ok: false, error: built.error });
+        return;
+      }
+      if (withBooking) {
+        setRow("building", "adding booking\u2026");
+        try {
+          await runTool("add_booking_site", { id: t.id }, makeCtx({ json: true }));
+        } catch (e) {
+          setRow("building", `booking skipped (${e.message.slice(0, 40)})`);
+        }
+      }
+      setRow("building", "preparing outreach\u2026");
+      await runTool("prepare_outreach", { ids: [t.id] }, makeCtx({ json: true }));
+      setRow("built", built.url ?? "done");
+      results.push({ id: t.id, name: t.name, ok: true, url: built.url });
+    } catch (e) {
+      setRow("failed", e.message.slice(0, 60));
+      results.push({ id: t.id, name: t.name, ok: false, error: e.message });
+    }
+  }
+  const workers = Array.from({ length: Math.min(concurrency, queue.length) }, async () => {
+    for (; ; ) {
+      const next = queue.shift();
+      if (!next) return;
+      await runOne(next);
+    }
+  });
+  await Promise.all(workers);
+  board?.stop();
+  autoSync();
+  const ok = results.filter((r) => r.ok).length;
+  const failed = results.length - ok;
+  if (json) {
+    emitJson({ ok: failed === 0, ran: results.length, succeeded: ok, failed, concurrency, results });
+    if (failed > 0) process.exitCode = 1;
+    return;
+  }
+  say();
+  say(
+    c.green(`  Pipeline done \u2014 ${ok} client${ok === 1 ? "" : "s"} built + outreach prepared`) + (failed ? c.red(`, ${failed} failed`) : "") + c.dim(` (concurrency ${concurrency}).`)
+  );
+  say(c.dim("  Open the message links above, or check emailed leads in your Contacted column."));
+  say();
+}
 async function cmdRegenerate(argv) {
   const { flags, rest } = parseArgs(argv);
   const json = !!flags.json;
@@ -95661,7 +95924,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) {
@@ -95844,6 +96107,7 @@ COMMANDS:
 - sproutkit cms <id> --json                                     \u2014 add the editable CMS on top of the site we built them
 - sproutkit book <id> --json [--standalone] [--instructions "..."] [--archetype slots|reservation|enquiry] [--email x@y.com]  \u2014 booking site (--standalone = its own URL for clients who already have a website)
 - sproutkit outreach --json [--ids 3,5]                         \u2014 prepare outreach links
+- sproutkit pipeline x3 --json [--book] [--limit 10]            \u2014 full pipeline (build\u2192booking\u2192outreach) for many clients concurrently
 
 If no command fits the request, say so in one line and name the closest thing you can do. Never invent results.`;
 var FREE_SYSTEM_PROMPT = `You are Sproutkit's assistant, talking with the user about their lead-generation and website work. You can run the sproutkit CLI (find, list, build, build-all, book, outreach \u2014 all support --json) via Bash, and you can help with small custom changes and questions. Be conversational and helpful, but stay within Sproutkit's domain (leads, demo sites, booking, outreach). You don't need to collapse everything to a single command here \u2014 it's fine to discuss, then act.`;
@@ -96112,7 +96376,7 @@ async function main() {
     closeTty();
     return;
   }
-  if (arg === "find" || arg === "list" || arg === "build" || arg === "build-all" || arg === "regenerate" || arg === "cms" || arg === "book" || arg === "outreach") {
+  if (arg === "find" || arg === "list" || arg === "build" || arg === "build-all" || arg === "regenerate" || arg === "cms" || arg === "book" || arg === "outreach" || arg === "pipeline") {
     const subArgs = process.argv.slice(3);
     const lic2 = await check();
     if (lic2.status !== "active") {
@@ -96130,6 +96394,7 @@ async function main() {
     else if (arg === "regenerate") await cmdRegenerate(subArgs);
     else if (arg === "cms") await cmdCms(subArgs);
     else if (arg === "book") await cmdBook(subArgs);
+    else if (arg === "pipeline") await cmdPipeline(subArgs);
     else await cmdOutreach(subArgs);
     closeTty();
     return;
@@ -96148,6 +96413,7 @@ async function main() {
     say(`  ${c.bold("sproutkit cms <id>")}            add the editable CMS to a built site`);
     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 pipeline x3")}         build+outreach many clients concurrently`);
     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`);
@@ -96220,7 +96486,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", "doctor"];
+    const DIRECT_VERBS = ["find", "list", "build", "build-all", "regenerate", "cms", "book", "outreach", "pipeline", "doctor"];
     if (verb === "commands" || verb === "help" || line === "/help" || line === "/?") {
       say();
       say(c.bold("  Commands (type with or without a leading /):"));
@@ -96233,6 +96499,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.greenBold("pipeline")} x3 [--book] [--limit 10]           build + outreach many, concurrently`);
       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();
@@ -96250,6 +96517,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 === "pipeline") await cmdPipeline(argv);
         else if (verb === "doctor") await runDoctor();
       } catch (e) {
         say(c.red(`  Error: ${e.message}`));

package/dist/skill/SKILL.md

@@ -66,6 +66,12 @@ you can parse results reliably, then summarise them for the user in prose.
   - Use `book --standalone` when the user says the client "already has a
     website" or "just needs a booking page".
 
+- **Run the full pipeline for many clients** — `sproutkit pipeline x3 --json` (optional `--book`, `--limit 10`, `--ids 3,5`)
+  - Builds → (optionally adds booking) → prepares outreach for several clients
+    CONCURRENTLY (capped at 4), refilling as each finishes. Use for "run the
+    pipeline", "do the whole thing for my leads", "build and message them all".
+  - Run `sproutkit find` FIRST — pipeline works through leads you already have.
+
 - **Prepare outreach** — `sproutkit outreach --json` (optional `--ids 3,5,9`)
   - Per lead: if it has a PHONE, returns a WhatsApp/SMS link for the user to
     open (not auto-sent); if it has NO phone but an EMAIL (and SMTP is set up),

package/package.json

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