@signaliz/cli 1.0.10 → 1.0.12

package/dist/bin.js

@@ -1077,6 +1077,16 @@ Campaign Builder:
   campaign-agent dry-run  Execute build_campaign with dry_run=true
   campaign-agent build-approved
                           Launch only after explicit approval metadata
+  campaign-agent review <id>
+                          Review rows, artifacts, and delivery gates
+  campaign-agent status <id>
+                          Inspect a campaign-agent build
+  campaign-agent rows <id>
+                          Retrieve reviewable rows
+  campaign-agent artifacts <id>
+                          List generated artifacts
+  campaign-agent approve <id>
+                          Approve a reviewed delivery destination
 
   campaign scope          Scope a workspace/account campaign into a markdown brief + dry-run args
     --prompt "..."        Campaign request or outcome (required)
@@ -2785,6 +2795,11 @@ Strategy-template campaign builder:
   commit-plan       Dry-run or write a reviewed GTM campaign object
   dry-run           Execute build_campaign with dry_run=true
   build-approved    Launch only after explicit approval metadata
+  review            Review status, rows, artifacts, and delivery gates
+  status            Inspect a campaign-agent build
+  rows              Retrieve reviewable campaign-agent rows
+  artifacts         List generated artifacts
+  approve           Approve a reviewed delivery destination
 
 Examples:
   signaliz campaign-agent init --strategy-template non-medical-home-care --target-count 250 --use-local-leads --json > campaign-request.json
@@ -2794,6 +2809,9 @@ Examples:
   signaliz campaign-agent dry-run --goal "Build a local services campaign" --target-count 250 --use-local-leads --json
   signaliz campaign-agent build-approved --goal "Build a strategy-template campaign" --confirm-launch --approve-all --approved-by operator@example.com --spend-limit 500
   signaliz campaign-agent build-approved --request-file campaign-builder-agent-request.json --confirm-launch --approve-all --approved-by operator@example.com --spend-limit 500 --wait --approve-delivery --delivery-destination-type json
+  signaliz campaign-agent review <campaign_build_id> --limit 100 --json
+  signaliz campaign-agent status <campaign_build_id> --json
+  signaliz campaign-agent rows <campaign_build_id> --limit 100 --json
 
 Plan options:
   --goal TEXT             Campaign goal or brief
@@ -2846,6 +2864,10 @@ async function campaignAgent(sub, rest) {
     process.stdout.write(CAMPAIGN_AGENT_HELP);
     return;
   }
+  if (["review", "status", "rows", "artifacts", "approve", "approve-delivery"].includes(sub)) {
+    await campaignAgentReview(sub, rest);
+    return;
+  }
   if (!["init", "template", "request-template", "new", "plan", "proof", "smoke", "commit-plan", "dry-run", "build-approved", "launch-approved"].includes(sub)) {
     process.stdout.write(CAMPAIGN_AGENT_HELP);
     return;
@@ -2949,6 +2971,89 @@ async function campaignAgent(sub, rest) {
   }
   return output(plan, () => printCampaignAgentPlan(plan));
 }
+async function campaignAgentReview(sub, rest) {
+  const flags = parseCommandFlags(rest);
+  const buildId = rest[0] && !rest[0].startsWith("--") ? rest[0] : commandStringFlag(flags, "campaign-build-id", "build-id");
+  if (!buildId) die(`campaign-agent ${sub} requires <campaign_build_id> or --campaign-build-id`);
+  const sdk = getSdk();
+  const agent = sdk.campaignBuilderAgent;
+  const campaigns = sdk.campaigns || {};
+  if (sub === "review") {
+    const rowOptions = {
+      limit: commandNumberFlag(flags, "limit") ?? 100,
+      cursor: commandStringFlag(flags, "cursor"),
+      segment: commandStringFlag(flags, "segment"),
+      rowStatus: commandStringFlag(flags, "row-status"),
+      qualified: commandBooleanFlag(flags, "qualified") ? true : commandBooleanFlag(flags, "disqualified") ? false : void 0
+    };
+    const review = await agent.reviewBuild?.(buildId, rowOptions) || await campaignAgentBuildReviewFromCampaignApis(agent, campaigns, buildId, rowOptions);
+    const operatorReview = {
+      ...review,
+      rows: {
+        ...review.rows,
+        rows: formatCampaignRowsForOperator(review.rows?.rows || [])
+      }
+    };
+    return output(operatorReview, () => printCampaignAgentBuildReview(operatorReview));
+  }
+  if (sub === "status") {
+    const status = await (agent.getBuildStatus?.bind(agent) || campaigns.status?.bind(campaigns) || campaigns.getCampaignBuildStatus?.bind(campaigns))?.(buildId);
+    if (!status) die("campaign-agent status requires a compatible @signaliz/sdk campaign status API");
+    return output(status, () => printCampaignAgentBuildStatus(status));
+  }
+  if (sub === "rows") {
+    const rowOptions = {
+      limit: commandNumberFlag(flags, "limit"),
+      cursor: commandStringFlag(flags, "cursor"),
+      segment: commandStringFlag(flags, "segment"),
+      rowStatus: commandStringFlag(flags, "row-status"),
+      qualified: commandBooleanFlag(flags, "qualified") ? true : commandBooleanFlag(flags, "disqualified") ? false : void 0
+    };
+    const result2 = await (agent.getBuildRows?.bind(agent) || campaigns.rows?.bind(campaigns) || campaigns.getCampaignBuildRows?.bind(campaigns))?.(buildId, rowOptions);
+    if (!result2) die("campaign-agent rows requires a compatible @signaliz/sdk campaign rows API");
+    const operatorResult = {
+      ...result2,
+      rows: formatCampaignRowsForOperator(result2.rows)
+    };
+    return output(operatorResult, () => printCampaignAgentRows(operatorResult));
+  }
+  if (sub === "artifacts") {
+    const artifacts = await (agent.listBuildArtifacts?.bind(agent) || campaigns.artifacts?.bind(campaigns) || campaigns.listCampaignBuildArtifacts?.bind(campaigns))?.(buildId);
+    if (!artifacts) die("campaign-agent artifacts requires a compatible @signaliz/sdk campaign artifacts API");
+    return output(artifacts, () => {
+      if (artifacts.length === 0) {
+        console.log("No artifacts yet.");
+        hint(`signaliz campaign-agent status ${buildId}`);
+        return;
+      }
+      for (const artifact of artifacts) {
+        console.log(`${artifact.artifactType || "artifact"} - ${artifact.rowCount} rows${artifact.signedUrl ? `
+  ${artifact.signedUrl}` : ""}`);
+      }
+    });
+  }
+  const destinationType = commandStringFlag(flags, "destination-type", "delivery-destination-type", "type");
+  if (!destinationType || !["json", "csv", "webhook"].includes(destinationType)) {
+    die("campaign-agent approve requires --destination-type json|csv|webhook");
+  }
+  const deliveryOptions = {
+    destinationId: commandStringFlag(flags, "destination-id", "delivery-destination-id"),
+    destinationConfig: campaignAgentJsonObjectInput(flags, ["destination-config", "delivery-config"], ["destination-config-file", "delivery-config-file"])
+  };
+  const result = await (agent.approveDelivery?.bind(agent) || campaigns.approveCampaignDelivery?.bind(campaigns))?.(buildId, destinationType, deliveryOptions);
+  if (!result) die("campaign-agent approve requires a compatible @signaliz/sdk campaign delivery API");
+  return output(result, () => {
+    console.log(`Delivery ${result.status}: ${result.destinationType}`);
+    if (result.message) console.log(result.message);
+  });
+}
+async function campaignAgentBuildReviewFromCampaignApis(agent, campaigns, buildId, rowOptions) {
+  const status = await (agent.getBuildStatus?.bind(agent) || campaigns.status?.bind(campaigns) || campaigns.getCampaignBuildStatus?.bind(campaigns))?.(buildId);
+  const rows = await (agent.getBuildRows?.bind(agent) || campaigns.rows?.bind(campaigns) || campaigns.getCampaignBuildRows?.bind(campaigns))?.(buildId, rowOptions);
+  const artifacts = await (agent.listBuildArtifacts?.bind(agent) || campaigns.artifacts?.bind(campaigns) || campaigns.listCampaignBuildArtifacts?.bind(campaigns))?.(buildId);
+  if (!status || !rows || !artifacts) die("campaign-agent review requires compatible @signaliz/sdk build status, rows, and artifacts APIs");
+  return createCampaignAgentBuildReview(status, rows, artifacts);
+}
 function campaignAgentRequestTemplateFromFlags(flags, rest) {
   const goal = commandStringFlag(flags, "goal", "brief") || promptArg(rest) || "Build a strategy-template campaign for mature operators in the target ICP.";
   const request = campaignAgentRequestFromFlags(goal, flags, { includeDefaults: true });
@@ -3257,6 +3362,184 @@ function printCampaignAgentExecution(plan, result) {
   console.log("\nResult:");
   console.log(JSON.stringify(result, null, 2));
 }
+function printCampaignAgentBuildStatus(status) {
+  console.log(`Campaign: ${status.name || status.campaignBuildId}`);
+  if (status.campaignId) console.log(`Campaign ID: ${status.campaignId}`);
+  console.log(`Status:   ${status.status}`);
+  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.triggerRunId) console.log(`Trigger:  ${status.triggerRunId}`);
+  if (Array.isArray(status.warnings) && status.warnings.length) {
+    console.log(`Warnings: ${status.warnings.length}`);
+    for (const warning of status.warnings.slice(0, 3)) console.log(`  - ${warning}`);
+  }
+  if (Array.isArray(status.errors) && 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-agent rows ${status.campaignBuildId} --limit 100`);
+  } else if (status.status === "pending_approval") {
+    hint(`signaliz campaign-agent approve ${status.campaignBuildId} --destination-type webhook`);
+  } else if ((status.status === "running" || status.status === "queued") && status.triggerRunId) {
+    hint(`signaliz ops run-status ${status.triggerRunId} --watch`);
+  }
+}
+function printCampaignAgentBuildReview(review) {
+  const summary = record(review.summary);
+  const status = record(review.status);
+  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(`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}`);
+  console.log(`Delivery approval ready: ${summary.readyForDeliveryApproval === true ? "yes" : "no"}`);
+  const gates = Array.isArray(review.gates) ? review.gates : [];
+  if (gates.length) {
+    console.log("\nGates:");
+    for (const gate of gates) {
+      console.log(`- ${gate.passed ? "PASS" : "BLOCKED"} ${gate.label}: ${gate.detail}`);
+    }
+  }
+  const warnings = Array.isArray(summary.warnings) ? summary.warnings : [];
+  if (warnings.length) {
+    console.log("\nWarnings:");
+    for (const warning of warnings.slice(0, 5)) console.log(`- ${warning}`);
+  }
+  const nextActions = Array.isArray(review.nextActions) ? review.nextActions : [];
+  if (nextActions.length) {
+    console.log("\nNext:");
+    for (const action of nextActions) console.log(`- ${action}`);
+  }
+}
+function createCampaignAgentBuildReview(status, rows, artifacts) {
+  const rowList = Array.isArray(rows?.rows) ? rows.rows : [];
+  const sampledRows = rowList.length;
+  const availableRows = Number(rows?.count || sampledRows);
+  const qualifiedRows = rowList.filter((row) => row?.qualified !== false).length;
+  const operatorRows = formatCampaignRowsForOperator(rowList);
+  const rowsWithEmail = operatorRows.filter((row) => Boolean(row.email)).length;
+  const copyReadyRows = operatorRows.filter((row) => Boolean(row.has_copy || row.status === "copy_ready")).length;
+  const artifactCount = artifacts.length || Number(status?.artifactCount || status?.artifact_count || 0);
+  const buildStatus = String(status?.status || "unknown");
+  const gates = [
+    {
+      id: "build_completed",
+      label: "Build completed",
+      passed: buildStatus === "completed",
+      detail: buildStatus === "completed" ? "The campaign build is completed." : `The campaign build is ${buildStatus}; review again after completion.`
+    },
+    {
+      id: "rows_available",
+      label: "Rows available",
+      passed: sampledRows > 0,
+      detail: sampledRows > 0 ? `${sampledRows} sampled row(s) are available for review.` : "No rows were returned for review."
+    },
+    {
+      id: "qualified_sample",
+      label: "Sample rows qualified",
+      passed: sampledRows > 0 && qualifiedRows === sampledRows,
+      detail: sampledRows > 0 ? `${qualifiedRows}/${sampledRows} sampled row(s) are marked qualified.` : "Qualification could not be checked without sampled rows."
+    },
+    {
+      id: "email_coverage",
+      label: "Email coverage",
+      passed: sampledRows > 0 && rowsWithEmail === sampledRows,
+      detail: sampledRows > 0 ? `${rowsWithEmail}/${sampledRows} sampled row(s) include an email.` : "Email coverage could not be checked without sampled rows."
+    },
+    {
+      id: "artifact_available",
+      label: "Artifact available",
+      passed: artifactCount > 0,
+      detail: artifactCount > 0 ? `${artifactCount} artifact(s) are available.` : "No delivery artifact is available yet."
+    },
+    {
+      id: "no_failed_rows",
+      label: "No failed rows",
+      passed: Number(status?.recordsFailed || status?.records_failed || 0) === 0,
+      detail: Number(status?.recordsFailed || status?.records_failed || 0) === 0 ? "The build reports zero failed rows." : `${status.recordsFailed || status.records_failed} row(s) failed during the build.`
+    }
+  ];
+  const blockedReasons = gates.filter((gate) => !gate.passed).map((gate) => gate.detail);
+  const warnings = [
+    rows?.hasMore || rows?.has_more ? "This review is based on a row sample; page through remaining rows before final approval." : void 0,
+    sampledRows > 0 && copyReadyRows < sampledRows ? `${copyReadyRows}/${sampledRows} sampled row(s) include generated copy.` : void 0,
+    ...Array.isArray(status?.warnings) ? status.warnings : []
+  ].filter(Boolean);
+  const readyForDeliveryApproval = blockedReasons.length === 0;
+  return {
+    campaignBuildId: status.campaignBuildId || status.campaign_build_id || rows.campaignBuildId || rows.campaign_build_id || "",
+    status,
+    rows,
+    artifacts,
+    gates,
+    summary: {
+      status: buildStatus,
+      phase: status.currentPhase || status.current_phase || null,
+      sampledRows,
+      availableRows,
+      qualifiedRows,
+      rowsWithEmail,
+      copyReadyRows,
+      artifactCount,
+      readyForDeliveryApproval,
+      blockedReasons,
+      warnings
+    },
+    nextActions: campaignAgentReviewNextActions(status, readyForDeliveryApproval)
+  };
+}
+function campaignAgentReviewNextActions(status, readyForDeliveryApproval) {
+  const buildId = status.campaignBuildId || status.campaign_build_id;
+  const buildStatus = String(status.status || "unknown");
+  if (!buildId) return [];
+  if (buildStatus === "completed" && readyForDeliveryApproval) {
+    return [
+      `signaliz campaign-agent approve ${buildId} --destination-type json`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (buildStatus === "completed") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent artifacts ${buildId}`
+    ];
+  }
+  if (buildStatus === "pending_approval") {
+    return [
+      `signaliz campaign-agent rows ${buildId} --limit 100`,
+      `signaliz campaign-agent approve ${buildId} --destination-type json`
+    ];
+  }
+  if ((buildStatus === "queued" || buildStatus === "running") && status.triggerRunId) {
+    return [`signaliz ops run-status ${status.triggerRunId} --watch`];
+  }
+  return [`signaliz campaign-agent status ${buildId}`];
+}
+function printCampaignAgentRows(result) {
+  if (!Array.isArray(result.rows) || result.rows.length === 0) {
+    console.log("No rows found.");
+    return;
+  }
+  console.table(result.rows.map((row) => ({
+    email: row.email || "",
+    name: row.name || "",
+    title: row.title || "",
+    company: row.company || row.domain || "",
+    segment: row.segment || "",
+    status: row.status || "",
+    score: row.score ?? ""
+  })));
+  console.log(`
+Showing ${result.rows.length} row(s)${result.hasMore ? " (more available)" : ""}`);
+  if (result.nextCursor) {
+    hint(`signaliz campaign-agent rows ${result.campaignBuildId} --limit ${result.pageSize || 50} --cursor ${result.nextCursor}`);
+  }
+}
 function createCampaignAgentProofReceipt(plan, result) {
   const strategyMemory = record(plan.strategyMemoryStatus);
   const dryRunResult = record(result);

package/package.json

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