@signaliz/cli 1.0.13 → 1.0.15

package/README.md

@@ -65,6 +65,7 @@ signaliz auth login
 signaliz start
 
 # 3. Plan something. Pick the surface that matches the job.
+signaliz campaign-agent kit --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json
 signaliz campaign build --prompt "VP Sales at B2B SaaS, 50-500 employees" --target-count 100 --dry-run
 signaliz gtm plan "VP Sales at B2B SaaS, 50-500 employees" --target-count 100 --json > plan.json
 signaliz ops plan "Build 100 verified VP Sales leads at B2B SaaS companies"

package/dist/bin.js

@@ -838,6 +838,28 @@ function getSdk() {
     throw new Error(`Unable to load a compatible @signaliz/sdk: ${primaryMessage}; fallback failed: ${fallbackError.message}`);
   }
 }
+function getCampaignBuilderBuildKitFactory() {
+  let primaryError;
+  try {
+    const sdk = require("@signaliz/sdk");
+    if (typeof sdk.createCampaignBuilderBuildKit === "function") {
+      return sdk.createCampaignBuilderBuildKit;
+    }
+    primaryError = new Error("SDK missing createCampaignBuilderBuildKit");
+  } catch (err) {
+    primaryError = err;
+  }
+  try {
+    const sdk = require((0, import_node_path.join)(__dirname, "..", "..", "sdk", "dist", "index.js"));
+    if (typeof sdk.createCampaignBuilderBuildKit === "function") {
+      return sdk.createCampaignBuilderBuildKit;
+    }
+    throw new Error("local SDK missing createCampaignBuilderBuildKit");
+  } catch (fallbackError) {
+    const primaryMessage = primaryError instanceof Error ? primaryError.message : String(primaryError || "SDK missing campaign build kit helper");
+    throw new Error(`Unable to load campaign build kit helper: ${primaryMessage}; fallback failed: ${fallbackError.message}`);
+  }
+}
 function prompt(question) {
   const rl = (0, import_node_readline.createInterface)({ input: process.stdin, output: process.stderr });
   return new Promise((resolve) => {
@@ -1064,6 +1086,8 @@ Email:
 Campaign Builder:
   campaign-agent init     Emit reusable CampaignBuilderAgentRequest JSON
     --output-file FILE    Optional request file to write
+  campaign-agent kit      Emit request JSON, CLI commands, MCP calls, SDK example, and BYO pattern
+    --kit-file FILE       Optional kit JSON file to write
   campaign-agent plan     Compose an approval-gated strategy-template MCP flow
     --goal "..."          Campaign goal or brief
     --request-file FILE   Reusable JSON CampaignBuilderAgentRequest
@@ -2791,6 +2815,7 @@ var CAMPAIGN_AGENT_HELP = `signaliz campaign-agent <command> [options]
 
 Strategy-template campaign builder:
   init              Emit reusable CampaignBuilderAgentRequest JSON
+  kit               Emit request JSON, CLI commands, MCP calls, SDK example, and BYO pattern
   plan              Compose an approval-gated strategy-template MCP flow
   doctor           Inspect built-in lanes, BYO routes, Memory, Brain, and approvals
   proof             Prove memory, plan, approvals, and build dry-run without spend
@@ -2805,6 +2830,7 @@ Strategy-template campaign builder:
 
 Examples:
   signaliz campaign-agent init --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json > campaign-request.json
+  signaliz campaign-agent kit --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json
   signaliz campaign-agent doctor --request-file campaign-request.json --json
   signaliz campaign-agent plan --goal "Build a strategy-template campaign for my ICP" --strategy-template non-medical-home-care --target-count 500 --builtins lead_generation,email_finding,email_verification,signals
   signaliz campaign-agent proof --goal "Build a strategy-template campaign for my ICP" --strategy-template non-medical-home-care --target-count 100 --json
@@ -2819,6 +2845,9 @@ Examples:
 Plan options:
   --goal TEXT             Campaign goal or brief
   --output-file FILE      Write init output to a reusable request JSON file
+  --kit-file FILE         Write campaign-agent kit output to a JSON file
+  --request-output-file FILE
+                          Request filename to reference inside kit commands
   --request-file FILE     Reusable JSON CampaignBuilderAgentRequest; flags override file fields
   --campaign-name NAME    Optional campaign label
   --workspace-label NAME  Optional workspace/account label
@@ -2871,7 +2900,7 @@ async function campaignAgent(sub, rest) {
     await campaignAgentReview(sub, rest);
     return;
   }
-  if (!["init", "template", "request-template", "new", "plan", "doctor", "readiness", "preflight", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(sub)) {
+  if (!["init", "template", "request-template", "new", "kit", "build-kit", "blueprint", "plan", "doctor", "readiness", "preflight", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(sub)) {
     process.stdout.write(CAMPAIGN_AGENT_HELP);
     return;
   }
@@ -2888,6 +2917,35 @@ async function campaignAgent(sub, rest) {
     console.log(`Next: signaliz campaign-agent plan --request-file ${outputFile} --json`);
     return;
   }
+  if (["kit", "build-kit", "blueprint"].includes(sub)) {
+    const requestFromFile2 = campaignAgentRequestFileFromFlags(flags);
+    const goal2 = commandStringFlag(flags, "goal", "brief") || promptArg(rest) || campaignAgentStringValue(requestFromFile2?.goal) || "Build a strategy-template campaign for mature operators in the target ICP.";
+    const request2 = requestFromFile2 ? mergeCampaignAgentRequests(
+      requestFromFile2,
+      campaignAgentRequestFromFlags(goal2, flags, { includeDefaults: false })
+    ) : campaignAgentRequestTemplateFromFlags(flags, rest);
+    const createBuildKit = getCampaignBuilderBuildKitFactory();
+    const kit = createBuildKit({
+      ...request2,
+      includeLocalLeads: commandBooleanFlag(flags, "use-local-leads"),
+      includeCustomToolPlaceholder: commandBooleanFlag(flags, "with-byo-placeholder") || commandBooleanFlag(flags, "include-custom-tool-placeholder") || commandBooleanFlag(flags, "include-byo-placeholder"),
+      includeNango: !commandBooleanFlag(flags, "no-nango-catalog"),
+      requestFile: commandStringFlag(flags, "request-output-file", "request-file-name") || commandStringFlag(flags, "request-file") || "campaign-request.json",
+      cliPackage: commandStringFlag(flags, "cli-package"),
+      sdkPackage: commandStringFlag(flags, "sdk-package")
+    });
+    const outputFile = commandStringFlag(flags, "kit-file", "output-file", "out");
+    if (outputFile) {
+      (0, import_node_fs.writeFileSync)(outputFile, `${JSON.stringify(kit, null, 2)}
+`, "utf8");
+    }
+    if (!outputFile || jsonMode()) return output(kit, () => printCampaignAgentBuildKit(kit));
+    console.log(`Campaign build kit written: ${outputFile}`);
+    const commands = firstArray(kit.cli_commands);
+    const proof = commands.find((command) => command.id === "proof_shortcut");
+    if (proof?.command) console.log(`Next: ${proof.command}`);
+    return;
+  }
   const requestFromFile = campaignAgentRequestFileFromFlags(flags);
   const isDoctor = sub === "doctor" || sub === "readiness" || sub === "preflight";
   const goal = commandStringFlag(flags, "goal", "brief") || promptArg(rest) || campaignAgentStringValue(requestFromFile?.goal) || (isDoctor ? "Build a strategy-template campaign for the target ICP." : void 0);
@@ -2921,15 +2979,20 @@ async function campaignAgent(sub, rest) {
     if (!readiness.summary?.ready) process.exitCode = 1;
     return output(readiness, () => printCampaignAgentReadiness(readiness));
   }
-  const plan = await agent.createPlan(request, planOptions);
   if (sub === "proof" || sub === "smoke") {
-    const result = await agent.dryRunPlan(plan, {
+    const proof = typeof agent.proof === "function" ? await agent.proof(request, {
+      ...planOptions,
       idempotencyKey: commandStringFlag(flags, "idempotency-key")
-    });
-    const proof = createCampaignAgentProofReceipt(plan, result);
+    }) : await (async () => {
+      const plan2 = await agent.createPlan(request, planOptions);
+      return createCampaignAgentProofReceipt(plan2, await agent.dryRunPlan(plan2, {
+        idempotencyKey: commandStringFlag(flags, "idempotency-key")
+      }));
+    })();
     if (!proof.success) process.exitCode = 1;
     return output(proof, () => printCampaignAgentProof(proof));
   }
+  const plan = await agent.createPlan(request, planOptions);
   if (isCommitPlan) {
     const result = await agent.commitPlan(plan, {
       confirm: isConfirmedCommit,
@@ -3510,6 +3573,37 @@ function printCampaignAgentReadiness(readiness) {
     for (const action of nextActions) console.log(`- ${action}`);
   }
 }
+function printCampaignAgentBuildKit(kit) {
+  console.log(`Campaign build kit: ${kit.strategy_template || "custom strategy"}`);
+  if (kit.request_file) console.log(`Request file: ${kit.request_file}`);
+  console.log(`Built-ins: ${firstArray(kit.built_in_lanes).join(", ") || "none"}`);
+  console.log(`Playbooks: ${firstArray(kit.operating_playbooks).join(", ") || "none"}`);
+  console.log(`BYO routes: ${firstArray(kit.custom_routes).length}`);
+  const commands = firstArray(kit.cli_commands);
+  if (commands.length) {
+    console.log("\nCLI:");
+    for (const command of commands.slice(0, 4)) {
+      console.log(`- ${command.label || command.id}: ${command.command}`);
+    }
+  }
+  const calls = firstArray(kit.mcp_calls);
+  if (calls.length) {
+    console.log("\nMCP:");
+    for (const call of calls.slice(0, 3)) {
+      console.log(`- ${call.tool}: ${call.safety}`);
+    }
+  }
+  const byo = record(kit.byo_tool_pattern);
+  if (byo.cli_flag) {
+    console.log("\nBYO tool pattern:");
+    console.log(`- ${byo.cli_flag}`);
+  }
+  const nextActions = firstArray(kit.next_actions);
+  if (nextActions.length) {
+    console.log("\nNext:");
+    for (const action of nextActions.slice(0, 4)) console.log(`- ${action}`);
+  }
+}
 function printCampaignAgentPlan(plan) {
   console.log(`Plan: ${plan.campaignName || plan.goal || plan.planId}`);
   if (plan.planId) console.log(`Plan ID: ${plan.planId}`);
@@ -5746,18 +5840,19 @@ async function simpleJob(cmd, rest) {
     if (isHelpRequest(rest) || !promptArg(rest) && !flagArg("prompt") && !flagArg("brief") && !flagArg("campaign-brief")) {
       process.stdout.write(`signaliz build "campaign brief" [options]
 
-Plan a campaign without spending credits or writing to providers.
+Run the campaign-agent proof path: strategy memory, Kernel plan, approvals, and
+a forced build_campaign dry-run without spend or provider writes.
 
 Examples:
   signaliz build "Build a campaign for industrial maintenance buyers" --target-count 50
-  signaliz build "Audit prior Instantly performance and build the next campaign" --preferred-providers instantly
+  signaliz build "Build a strategy-template campaign for local operators" --strategy-template non-medical-home-care --use-local-leads --json
 
 Equivalent:
-  signaliz gtm plan "campaign brief"
+  signaliz campaign-agent proof "campaign brief"
 `);
       return;
     }
-    return gtm("plan", rest);
+    return campaignAgent("proof", rest);
   }
   if (cmd === "connect") {
     if (isHelpRequest(rest)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.13",
+  "version": "1.0.15",
   "description": "Signaliz CLI — GTM Kernel, Nango routes, MCP, and enrichment operations.",
   "bin": {
     "signaliz": "dist/bin.js"