@signaliz/cli 1.0.93 → 1.0.94

package/README.md

@@ -223,6 +223,13 @@ signaliz campaign-os audience-preview --client-id <uuid> \
   --audience-id <uuid> --idempotency-key launch-preview-v1 --json
 signaliz campaign-os compile --client-id <uuid> --campaign-id <uuid> \
   --providers all --json
+signaliz campaign-os alpha-materialize-preflight --client-id <uuid> \
+  --campaign-id <uuid> --audience-run-id <uuid> --validation-run-id <uuid> \
+  --idempotency-key launch-alpha-materialization-v1 --json
+signaliz campaign-os alpha-materialize --materialization-run-id <uuid> \
+  --approval-hash sha256:<64-hex> --confirm-spend --json
+signaliz campaign-os alpha-materialization-status \
+  --materialization-run-id <uuid> --json
 signaliz campaign-os request --client-id <uuid> --campaign-id <uuid> \
   --agent devin --action provider_activation --instructions "Prepare for review" \
   --preflight-inputs-file action-preflight.json \
@@ -245,3 +252,9 @@ activation, real-time arming, queueing, or sending; it does not execute them.
 non-secret provider and artifact identifiers. After a Signaliz superadmin
 approves that proposal, `prepare-preflight` appends or reads the immutable
 no-call continuation and reports missing inputs or unavailable adapters.
+
+`alpha-materialize-preflight` records the exact campaign, Audience run,
+validation receipt, coverage target, batches, and research ceiling without
+spend. `alpha-materialize` requires the returned approval hash and
+`--confirm-spend`; it authorizes only that bounded research. It never calls
+Clay, creates an Audience, loads or activates a provider, queues, or sends.

package/dist/bin.js

@@ -70,11 +70,14 @@ Product commands:
   signaliz campaign-os audience-preview --client-id <uuid> --audience-id <uuid> --idempotency-key <key>
   signaliz campaign-os compile --client-id <uuid> --campaign-id <uuid> [--providers all]
   signaliz campaign-os alpha-plan --client-id <uuid> --client-name "Velox" --offer-summary "..." --icp-summary "..." --idempotency-key <key>
-  signaliz campaign-os alpha-discover --client-id <uuid> --client-name "Velox" --offer-summary "..." --icp-summary "..." --idempotency-key <key> --confirm-spend
+  signaliz campaign-os alpha-discover --client-id <uuid> --campaign-id <uuid> --client-name "Velox" --offer-summary "..." --icp-summary "..." --idempotency-key <key> --confirm-spend
   signaliz campaign-os alpha-status --alpha-run-id <uuid>
   signaliz campaign-os alpha-validate --client-id <uuid> --campaign-id <uuid> --alpha-run-id <uuid> --candidate-index 0 --sample-file sample.json --idempotency-key <key> --confirm-spend
   signaliz campaign-os alpha-validation-status --validation-run-id <uuid>
   signaliz campaign-os alpha-apply --validation-run-id <uuid>
+  signaliz campaign-os alpha-materialize-preflight --client-id <uuid> --campaign-id <uuid> --audience-run-id <uuid> --validation-run-id <uuid> --idempotency-key <key>
+  signaliz campaign-os alpha-materialize --materialization-run-id <uuid> --approval-hash sha256:<64-hex> --confirm-spend
+  signaliz campaign-os alpha-materialization-status --materialization-run-id <uuid>
   signaliz campaign-os connections --client-id <uuid>
   signaliz campaign-os source-binding --client-id <uuid> --binding-id <uuid> --name "CRM list" --source-kind audience --selector-file selector.json --idempotency-key <key>
   signaliz campaign-os source-preflight --client-id <uuid> --source-binding-id <uuid> --idempotency-key <key> [--max-records 25]
@@ -2465,6 +2468,7 @@ async function campaignOs(args) {
   }
   if (action === "alpha-plan" || action === "alpha-discover") {
     const clientId = flag("client-id");
+    const campaignId = flag("campaign-id");
     const clientName = flag("client-name");
     const offerSummary = flag("offer-summary");
     const icpSummary = flag("icp-summary");
@@ -2474,7 +2478,7 @@ async function campaignOs(args) {
     }
     const params = {
       clientId,
-      campaignId: flag("campaign-id"),
+      campaignId,
       clientName,
       offerSummary,
       icpSummary,
@@ -2494,7 +2498,13 @@ async function campaignOs(args) {
     if (!hasFlag("confirm-spend")) {
       throw new CliInputError("signaliz campaign-os alpha-discover requires --confirm-spend for the $0.10 authorization ceiling");
     }
-    const result = await client.startCampaignOsAlphaDiscovery(params);
+    if (!campaignId) {
+      throw new CliInputError("signaliz campaign-os alpha-discover requires --campaign-id for one saved immutable CampaignSpec");
+    }
+    const result = await client.startCampaignOsAlphaDiscovery({
+      ...params,
+      campaignId
+    });
     output(result, () => {
       const run = record(result.run);
       process.stdout.write(`Signaliz Alpha discovery started: ${String(run.id || "")} \xB7 ${String(run.status || "queued")} \xB7 authorized ceiling $0.10
@@ -2578,6 +2588,70 @@ async function campaignOs(args) {
     });
     return;
   }
+  if (action === "alpha-materialize-preflight") {
+    const clientId = flag("client-id");
+    const campaignId = flag("campaign-id");
+    const audienceRunId = flag("audience-run-id");
+    const validationRunId = flag("validation-run-id");
+    const idempotencyKey = flag("idempotency-key")?.trim();
+    if (!clientId || !campaignId || !audienceRunId || !validationRunId || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os alpha-materialize-preflight requires --client-id, --campaign-id, --audience-run-id, --validation-run-id, and --idempotency-key");
+    }
+    const result = await client.preflightCampaignOsAlphaMaterialization({
+      clientId,
+      campaignId,
+      audienceRunId,
+      validationRunId,
+      idempotencyKey
+    });
+    output(result, () => {
+      const run = record(result.run);
+      process.stdout.write(`Signaliz Alpha materialization preflight: ${String(run.id || "")} \xB7 ${String(run.selected_count || 0)} membership(s) \xB7 ${String(run.batch_count || 0)} batch(es)
+`);
+      process.stdout.write(`Research ceiling: $${String(run.max_cost_usd || "0.00")} \xB7 no research, Clay, audience creation, provider load, activation, queue, or send occurred.
+`);
+    });
+    return;
+  }
+  if (action === "alpha-materialize") {
+    const materializationRunId = flag("materialization-run-id");
+    const approvalHash = flag("approval-hash");
+    if (!materializationRunId || !approvalHash) {
+      throw new CliInputError("signaliz campaign-os alpha-materialize requires --materialization-run-id and --approval-hash");
+    }
+    if (!/^sha256:[0-9a-f]{64}$/.test(approvalHash)) {
+      throw new CliInputError("--approval-hash must be the exact sha256:<64-hex> preflight hash");
+    }
+    if (!hasFlag("confirm-spend")) {
+      throw new CliInputError("signaliz campaign-os alpha-materialize requires --confirm-spend for the approval-bound research ceiling");
+    }
+    const result = await client.startCampaignOsAlphaMaterialization({
+      materializationRunId,
+      approvalHash,
+      confirmSpend: true
+    });
+    output(result, () => {
+      const run = record(result.run);
+      process.stdout.write(`Signaliz Alpha materialization started: ${String(run.id || materializationRunId)} \xB7 ${String(run.status || "queued")}
+`);
+      process.stdout.write("Only preflight-bounded research spend is authorized. Clay, audience creation, provider load, activation, queue, and send remain locked.\n");
+    });
+    return;
+  }
+  if (action === "alpha-materialization-status") {
+    const materializationRunId = flag("materialization-run-id");
+    if (!materializationRunId) {
+      throw new CliInputError("signaliz campaign-os alpha-materialization-status requires --materialization-run-id <uuid>");
+    }
+    const result = await client.getCampaignOsAlphaMaterialization(materializationRunId);
+    output(result, () => {
+      const run = record(result.run);
+      process.stdout.write(`Signaliz Alpha materialization: ${String(run.status || "unknown")} \xB7 ${String(run.processed_entity_count || 0)}/${String(run.entity_count || 0)} entities \xB7 ${String(run.covered_membership_count || 0)}/${String(run.selected_count || 0)} memberships
+`);
+      process.stdout.write("Status read only \xB7 no new research, spend, Clay, provider load, activation, queue, or send.\n");
+    });
+    return;
+  }
   if (action === "connections") {
     const clientId = flag("client-id");
     if (!clientId) throw new CliInputError("signaliz campaign-os connections requires --client-id <uuid>");
@@ -2748,7 +2822,7 @@ async function campaignOs(args) {
     });
     return;
   }
-  throw new CliInputError("Usage: signaliz campaign-os clients|context|knowledge|provider-runtime|build|build-status|draft|refine|audience-draft|materialize-cache-audience|audience-schedule|audience-preview|compile|alpha-plan|alpha-discover|alpha-status|alpha-validate|alpha-validation-status|alpha-apply|connections|source-binding|source-preflight|request|prepare-preflight|receipts");
+  throw new CliInputError("Usage: signaliz campaign-os clients|context|knowledge|provider-runtime|build|build-status|draft|refine|audience-draft|materialize-cache-audience|audience-schedule|audience-preview|compile|alpha-plan|alpha-discover|alpha-status|alpha-validate|alpha-validation-status|alpha-apply|alpha-materialize-preflight|alpha-materialize|alpha-materialization-status|connections|source-binding|source-preflight|request|prepare-preflight|receipts");
 }
 async function main() {
   const [, , command, ...args] = process.argv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaliz/cli",
-  "version": "1.0.93",
+  "version": "1.0.94",
   "description": "Signaliz CLI for Campaign OS, core products, Signal Awareness, Signaliz Flow, and reusable managed builds.",
   "bin": {
     "signaliz": "dist/bin.js"
@@ -30,7 +30,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@signaliz/sdk": "^1.0.97"
+    "@signaliz/sdk": "^1.0.98"
   },
   "devDependencies": {
     "tsup": "^8.0.0",