@signaliz/cli 1.0.4 → 1.0.5

package/dist/bin.js

@@ -1397,6 +1397,185 @@ function gtmHelpFor(sub) {
   if (!sub) return GTM_HELP;
   return GTM_COMMAND_HELP[sub] || GTM_HELP;
 }
+var OPS_COMMAND_HELP = {
+  proof: `signaliz ops proof [options]
+
+Show whether Ops delivery is proven before scaling a GTM motion.
+
+Options:
+  --window-hours N        Delivery receipt lookback, default 720
+  --json                  Machine-readable output
+`,
+  autopilot: `signaliz ops autopilot [options]
+
+Recommend the next best GTM motion from proof state.
+
+Options:
+  --window-hours N        Delivery receipt lookback, default 720
+  --json                  Machine-readable output
+`,
+  plan: `signaliz ops plan "plain-English GTM goal" [options]
+
+Preview a prompt-first Op plan without creating anything or spending credits.
+
+Options:
+  --blueprint NAME        monitor_companies|build_leads|enrich_list|route_signals|launch_campaign
+  --target-count N        Target row count
+  --cadence NAME          manual|hourly|daily|weekly
+  --destinations a,b      Destinations such as json,csv,slack,airbyte,nango
+  --company-domains a,b   Explicit account/domain list
+  --json                  Machine-readable output
+
+Safe next step:
+  signaliz ops create "same goal" --confirm-spend
+`,
+  create: `signaliz ops create "plain-English GTM goal" [options]
+
+Create a persistent Op from a prompt. Requires --confirm-spend for spendful
+work; otherwise the API returns an approval receipt and retry arguments.
+
+Options:
+  --confirm-spend         Acknowledge estimated credits/external writes
+  --activate              Create as active instead of draft
+  --target-count N        Target row count
+  --destinations a,b      Destinations such as json,csv,slack,airbyte,nango
+  --company-domains a,b   Explicit account/domain list
+  --json                  Machine-readable output
+
+Safe next step:
+  signaliz ops run <op_id>
+`,
+  execute: `signaliz ops execute "plain-English GTM goal" [options]
+
+One-call agent path: plan, create, and safely run an Op when approved.
+
+Options:
+  --dry-run               Return the plan and next step without creating anything
+  --confirm-spend         Acknowledge estimated credits/external writes
+  --auto-run              Run immediately after create when safe
+  --no-auto-run           Create only
+  --target-count N        Target row count
+  --destinations a,b      Destinations such as json,csv,slack,airbyte,nango
+  --json                  Machine-readable output
+`,
+  run: `signaliz ops run <op_id> [options]
+
+Run a created Op immediately.
+`,
+  status: `signaliz ops status <op_id> [options]
+
+Check simple Op status and next action.
+`,
+  results: `signaliz ops results <op_id> [options]
+
+Retrieve latest Op results.
+
+Options:
+  --limit N               Page size, default 100, max 500
+  --cursor ID             Pagination cursor
+  --include-failed-runs   Include failed run output when supported
+  --json                  Machine-readable output
+`
+};
+function opsHelpFor(sub) {
+  if (!sub) {
+    return `signaliz ops <command> [options]
+
+Canonical path:
+  signaliz ops plan "Build 100 verified VP Sales leads"
+  signaliz ops create "Build 100 verified VP Sales leads" --confirm-spend
+  signaliz ops run <op_id>
+  signaliz ops status <op_id>
+  signaliz ops results <op_id>
+
+Common commands:
+  proof, autopilot, plan, execute, create, run, status, results, doctor, connections
+
+Run: signaliz ops help <command>
+`;
+  }
+  return OPS_COMMAND_HELP[sub] || opsHelpFor(void 0);
+}
+var CAMPAIGN_COMMAND_HELP = {
+  scope: `signaliz campaign scope --prompt "client campaign request" [options]
+
+Turn a client/campaign brief into a markdown scope, Brain preflight, and
+ready-to-run build_campaign dry-run arguments.
+
+Options:
+  --client-name NAME      Client/customer name
+  --client-context-file FILE
+                          Markdown notes with ICP, exclusions, offer, proof, approvals
+  --target-count N        Desired target count
+  --destinations a,b      json,csv,webhook,instantly,slack,airbyte,nango
+  --json                  Machine-readable output
+`,
+  build: `signaliz campaign build --prompt "lead search prompt" [options]
+
+Start a campaign build. Use --dry-run first to validate; add --confirm-spend
+only after reviewing estimated credits and output risk.
+
+Options:
+  --target-count N        Number of leads, default 50
+  --outputs json,csv      Delivery outputs, default json
+  --dry-run               Validate and plan without launching spendful work
+  --allow-downscale       Allow oversized target counts to be clamped
+  --confirm-spend         Acknowledge spendful generation
+  --input-file FILE       JSON config file from campaign scope or gtm prepare-build
+  --wait                  Poll until completion
+  --json                  Machine-readable output
+
+Safe next step:
+  signaliz campaign status <campaign_build_id>
+`,
+  status: `signaliz campaign status <campaign_build_id> [options]
+
+Check build status, phase progress, warnings, errors, and next action.
+`,
+  rows: `signaliz campaign rows <campaign_build_id> [options]
+
+Retrieve generated campaign rows.
+
+Options:
+  --limit N               Page size, default 50, max 500
+  --cursor ID             Pagination cursor
+  --qualified             Only qualified rows
+  --disqualified          Only disqualified rows
+  --all                   Dump all rows
+  --json                  Machine-readable output
+`,
+  artifacts: `signaliz campaign artifacts <campaign_build_id> [options]
+
+List generated artifacts and signed download URLs.
+`,
+  approve: `signaliz campaign approve <campaign_build_id> --destination-type <json|csv|webhook>
+
+Approve pending delivery after human review.
+`,
+  cancel: `signaliz campaign cancel <campaign_build_id> [options]
+
+Cancel a running build.
+`
+};
+function campaignHelpFor(sub) {
+  if (!sub) {
+    return `signaliz campaign <command> [options]
+
+Canonical path:
+  signaliz campaign scope --prompt "Build a campaign for my ICP"
+  signaliz campaign build --prompt "VP Sales at B2B SaaS" --dry-run
+  signaliz campaign build --prompt "VP Sales at B2B SaaS" --confirm-spend --wait
+  signaliz campaign rows <campaign_build_id> --limit 100
+  signaliz campaign artifacts <campaign_build_id>
+
+Commands:
+  scope, build, status, rows, artifacts, approve, cancel
+
+Run: signaliz campaign help <command>
+`;
+  }
+  return CAMPAIGN_COMMAND_HELP[sub] || campaignHelpFor(void 0);
+}
 function isHelpRequest(args) {
   return args[0] === "help" || args.includes("--help") || args.includes("-h");
 }
@@ -1835,6 +2014,10 @@ async function ai(sub, rest) {
   });
 }
 async function campaignBuild() {
+  if (isHelpRequest(process.argv.slice(4))) {
+    process.stdout.write(campaignHelpFor("build"));
+    return;
+  }
   const sdk = getSdk();
   let config;
   const inputFile = flagArg("input-file");
@@ -1986,14 +2169,22 @@ async function campaignStatus() {
     console.log(`Phase:    ${status.currentPhase || "N/A"}`);
     console.log(`Rows:     ${status.recordsSucceeded}/${status.recordsTotal} succeeded, ${status.recordsFailed} failed`);
     console.log(`Artifacts: ${status.artifactCount}`);
-    if (status.warnings.length) console.log(`Warnings: ${status.warnings.length}`);
-    if (status.errors.length) console.log(`Errors:   ${status.errors.length}`);
+    if (status.warnings.length) {
+      console.log(`Warnings: ${status.warnings.length}`);
+      for (const warning of status.warnings.slice(0, 3)) console.log(`  - ${warning}`);
+    }
+    if (status.errors.length) {
+      console.log(`Errors:   ${status.errors.length}`);
+      for (const error of status.errors.slice(0, 3)) console.log(`  - ${error}`);
+    }
     if (status.status === "completed") {
       hint(`signaliz campaign rows ${buildId} --limit 100`);
     } else if (status.status === "running" || status.status === "queued") {
       hint(`signaliz campaign status ${buildId} (poll again in ~10s)`);
     } else if (status.status === "pending_approval") {
       hint(`signaliz campaign approve ${buildId} --destination-type webhook`);
+    } else if (status.status === "failed" && status.nextAction) {
+      hint(status.nextAction);
     }
   });
 }
@@ -2115,6 +2306,14 @@ async function campaignCancel() {
   });
 }
 async function campaign(sub) {
+  if (sub === "help") {
+    process.stdout.write(campaignHelpFor(process.argv[4]));
+    return;
+  }
+  if (isHelpRequest(process.argv.slice(4))) {
+    process.stdout.write(campaignHelpFor(sub));
+    return;
+  }
   switch (sub) {
     case "scope":
       return campaignScope();
@@ -3141,6 +3340,14 @@ async function keys(sub, rest) {
   if (!res.ok) process.exit(1);
 }
 async function ops(sub, rest) {
+  if (sub === "help") {
+    process.stdout.write(opsHelpFor(rest[0]));
+    return;
+  }
+  if (isHelpRequest(rest)) {
+    process.stdout.write(opsHelpFor(sub));
+    return;
+  }
   if (sub === "saved" || sub === "save") {
     const savedSub = sub === "save" ? "save" : rest[0];
     const savedRest = sub === "save" ? rest : rest.slice(1);
@@ -3883,12 +4090,18 @@ async function main() {
       return email(rest[0], rest.slice(1));
     case "campaign": {
       const sub = rest[0];
-      if (!sub) die("Usage: signaliz campaign <build|status|rows|artifacts|cancel>");
+      if (!sub || sub === "--help" || sub === "-h") {
+        process.stdout.write(campaignHelpFor(void 0));
+        return;
+      }
       return campaign(sub);
     }
     case "ops": {
       const sub = rest[0];
-      if (!sub) die("Usage: signaliz ops <proof|autopilot|plan|execute|quickstart|create|run|status|results|run-status|queue|logs|replay|dashboard|doctor|connections|sinks|routines|attach-sink|saved>");
+      if (!sub || sub === "--help" || sub === "-h") {
+        process.stdout.write(opsHelpFor(void 0));
+        return;
+      }
       if (sub === "logs" || sub === "log-stream") {
         const runId = rest[1] || flagArg("run-id");
         if (!runId) die("Usage: signaliz ops logs <run_id>");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Signaliz CLI — GTM Kernel, Nango routes, MCP, and enrichment operations.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -17,7 +17,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.4"
+    "@signaliz/sdk": "^1.0.6"
   },
   "devDependencies": {
     "tsup": "^8.0.0",