@signaliz/cli 1.0.17 → 1.0.18

package/README.md

@@ -7,6 +7,12 @@ provider routing for Nango-managed customer API destinations, MCP/Ops
 observability, enrichment primitives, and live email verification at 0.02 fresh
 enrichment credits when a new verification is needed.
 
+Monthly plans include unlimited cache search, Campaign Builder, API, MCP, CLI,
+Ops, and integrations. Team is the $499/month public plan and adds unlimited
+live Find People and Find Companies in Signaliz; Agency stays $999/month with
+higher credits and throughput. Fresh credits are used only when Signaliz
+creates, verifies, or fetches new premium data.
+
 Fresh enrichment throughput now allows Free 60/min, Builder 300/min, Team
 600/min, Agency 1,000/min, and Pay-As-You-Go 1,000/min, with a 5,000/hour
 workspace safety cap.
@@ -183,7 +189,8 @@ signaliz lead local \
 # Poll async lead jobs
 signaliz lead status <job_id>
 
-# Verify or find emails
+# Verify or find emails. `email find` uses the V3 waterfall:
+# primary discovery, secondary enrichment, verified guesses, then paid fallback if needed.
 signaliz email verify jane@example.com
 signaliz email verify-batch --emails jane@example.com,sam@example.com
 signaliz email status <job_id>

package/dist/bin.js

@@ -479,6 +479,32 @@ function layerCommand(layer) {
   const normalized = String(layer || "sender").trim() || "sender";
   return `signaliz connect --layer ${normalized}`;
 }
+function campaignSourcePlanRecord(result) {
+  const root = record(result);
+  const plan = record(root.sourcePlan ?? root.source_plan);
+  if (Object.keys(plan).length > 0) return plan;
+  return record(record(root.plan).source_plan);
+}
+function campaignSourceRouteRecords(result) {
+  const root = record(result);
+  const plan = campaignSourcePlanRecord(result);
+  return firstArray(root.sourceRoutes, root.source_routes, plan.routes).filter((route) => route && typeof route === "object" && !Array.isArray(route)).sort((a, b) => Number(a.priority ?? 0) - Number(b.priority ?? 0));
+}
+function campaignSourceSummary(result) {
+  const plan = campaignSourcePlanRecord(result);
+  if (Object.keys(plan).length === 0) return void 0;
+  const decision = record(plan.route_decision);
+  const intent = capitalizeLabel(plan.intent);
+  const reason = String(decision.selected_reason || "").trim();
+  return [intent, reason].filter(Boolean).join(" - ");
+}
+function campaignSourceRouteLine(route) {
+  const role = capitalizeLabel(route.role);
+  const tool = labelize(route.tool || "source");
+  const providers = firstArray(route.providers).map(labelize).filter(Boolean).join(" + ");
+  const fallback = typeof route.fallback_when === "string" && route.fallback_when.trim() ? ` (${route.fallback_when.trim()})` : "";
+  return `${role ? `${role}: ` : ""}${tool}${providers ? ` via ${providers}` : ""}${fallback}`;
+}
 function blockedRouteLayers(result) {
   const root = record(result);
   const providerActivation = record(root.provider_activation);
@@ -2892,6 +2918,11 @@ async function campaignBuild() {
       console.log("\u2713 Campaign dry-run plan ready");
       console.log(`  Requested: ${result.requestedTargetCount ?? config.targetCount ?? 50} leads`);
       console.log(`  Planned:   ${result.plannedTargetCount ?? result.requestedTargetCount ?? config.targetCount ?? 50} leads`);
+      const sourceSummary = campaignSourceSummary(result);
+      if (sourceSummary) console.log(`  Source:    ${sourceSummary}`);
+      for (const [index, route] of campaignSourceRouteRecords(result).slice(0, 4).entries()) {
+        console.log(`  Route ${index + 1}:  ${campaignSourceRouteLine(route)}`);
+      }
       if (result.estimatedCredits !== void 0) console.log(`  Credits:   ~${result.estimatedCredits}`);
       if (result.estimatedDurationSeconds !== void 0) console.log(`  Duration:  ~${result.estimatedDurationSeconds}s`);
       if (result.learningHoldout?.enabled) console.log(`  Holdout:   enabled (${Math.round(Number(result.learningHoldout.control_percentage || 0) * 100)}% control)`);
@@ -4227,6 +4258,7 @@ function printCampaignAgentBuildStatus(status) {
   if (status.campaignId) console.log(`Campaign ID: ${status.campaignId}`);
   console.log(`Status:   ${status.status}`);
   console.log(`Phase:    ${status.currentPhase || "N/A"}`);
+  if (status.terminalState?.kind) console.log(`Terminal: ${status.terminalState.kind}`);
   console.log(`Rows:     ${status.recordsSucceeded}/${status.recordsTotal} succeeded, ${status.recordsFailed} failed`);
   printCampaignCustomerRowCounts(status);
   console.log(`Artifacts: ${status.artifactCount}`);
@@ -4260,11 +4292,13 @@ function printCampaignAgentBuildReview(review) {
   console.log(`Campaign: ${status.name || review.campaignBuildId}`);
   console.log(`Status:   ${summary.status || status.status}`);
   console.log(`Phase:    ${summary.phase || status.currentPhase || "N/A"}`);
+  console.log(`Terminal state: ${summary.terminalState || status.terminalState?.kind || "unknown"}`);
   console.log(`Rows:     ${summary.sampledRows || 0} sampled, ${summary.availableRows || 0} available`);
   console.log(`Qualified: ${summary.qualifiedRows || 0}`);
   console.log(`Emails:    ${summary.rowsWithEmail || 0}`);
   console.log(`Copy ready: ${summary.copyReadyRows || 0}`);
   console.log(`Artifacts: ${summary.artifactCount || 0}`);
+  printCampaignAgentNorthStarScorecard(review.northStarScorecard);
   if (review.campaignBuildId) printCampaignArtifactDownloadHint(status, review.campaignBuildId);
   console.log(`Delivery approval ready: ${summary.readyForDeliveryApproval === true ? "yes" : "no"}`);
   const gates = Array.isArray(review.gates) ? review.gates : [];
@@ -4285,6 +4319,21 @@ function printCampaignAgentBuildReview(review) {
     for (const action of nextActions) console.log(`- ${action}`);
   }
 }
+function printCampaignAgentNorthStarScorecard(scorecard) {
+  const card = record(scorecard);
+  if (!card.version) return;
+  const score = card.score === null || card.score === void 0 ? "pending" : `${card.score}%`;
+  console.log(`North Star: ${String(card.status || "unknown")} (${score})`);
+  if (card.moatState) console.log(`Moat state: ${card.moatState}`);
+  const metrics = Array.isArray(card.metrics) ? card.metrics : [];
+  if (metrics.length) {
+    console.log("\nNorth Star gates:");
+    for (const metric of metrics.slice(0, 12)) {
+      const item = record(metric);
+      console.log(`- ${String(item.status || "review").toUpperCase()} ${item.label || item.id}: ${item.detail || ""}`);
+    }
+  }
+}
 function createCampaignAgentBuildReview(status, rows, artifacts) {
   const rowList = Array.isArray(rows?.rows) ? rows.rows : [];
   const sampledRows = rowList.length;

package/package.json

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