@signaliz/cli 1.0.91 → 1.0.93

package/dist/bin.js

@@ -57,18 +57,27 @@ Product commands:
   signaliz builds status --run-id <uuid> [--limit 100]
   signaliz builds download --run-id <uuid> --out results.csv
   signaliz campaign-os clients [--status active] [--query signaliz] [--limit 100]
-  signaliz campaign-os context --client-id <uuid> [--source-limit 50]
-  signaliz campaign-os knowledge --query "cache first" [--client-id <uuid>] [--record-kind campaign_playbook] [--limit 15]
+  signaliz campaign-os context --client-id <uuid> [--knowledge-snapshot-id <uuid>] [--source-limit 50]
+  signaliz campaign-os knowledge --query "cache first" [--client-id <uuid>] [--knowledge-snapshot-id <uuid>] [--record-kind campaign_playbook] [--limit 15]
   signaliz campaign-os provider-runtime --client-id <uuid> --provider clay|instantly|smartlead|bison
   signaliz campaign-os build --client-id <uuid> --name "Campaign" --objective "Goal" --target-count 500 --idempotency-key <key>
   signaliz campaign-os build-status --build-run-id <uuid>
-  signaliz campaign-os draft --client-id <uuid> --name "Campaign" --campaign-spec-file campaign-spec.json --idempotency-key <key> [--agent codex]
+  signaliz campaign-os draft --client-id <uuid> --name "Campaign" --campaign-spec-file campaign-spec.json --idempotency-key <key> [--knowledge-snapshot-id <uuid>] [--agent codex]
   signaliz campaign-os refine --client-id <uuid> --campaign-id <uuid> --expected-spec-version-id <uuid> --campaign-spec-file campaign-spec.json --change-reason "What changed" --idempotency-key <key> [--agent codex]
   signaliz campaign-os audience-draft --client-id <uuid> --name "Audience" --definition-file audience.json --entity-type people --audience-role campaign_segment --source-mode signaliz_owned --idempotency-key <key>
   signaliz campaign-os materialize-cache-audience --client-id <uuid> --audience-id <uuid> [--campaign-id <uuid>] --target-count <1-500> --idempotency-key <key>
   signaliz campaign-os audience-schedule --client-id <uuid> --audience-id <uuid> [--campaign-id <uuid>] [--cadence-minutes 1440] [--per-run-cap 100] [--source-policy cache_only|cache_then_review] [--enabled yes|no] [--run-now]
   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-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 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]
   signaliz campaign-os request --client-id <uuid> [--campaign-id <uuid>] --agent codex --action provider_load --instructions "..." [--preflight-inputs-file inputs.json] --idempotency-key <key>
   signaliz campaign-os prepare-preflight --client-id <uuid> --request-id <uuid>
   signaliz campaign-os receipts [--client-id <uuid>] [--campaign-id <uuid>] [--limit 50]
@@ -2136,7 +2145,11 @@ async function campaignOs(args) {
     if (!clientId) throw new CliInputError("signaliz campaign-os context requires --client-id <uuid>");
     const sourceLimit = numberFlag("source-limit") ?? 50;
     requireIntegerInRange(sourceLimit, "--source-limit", 1, 100);
-    const result = await client.getCampaignOsClientContext(clientId, sourceLimit);
+    const result = await client.getCampaignOsClientContext(
+      clientId,
+      sourceLimit,
+      flag("knowledge-snapshot-id")
+    );
     output(result, () => {
       const selected = result.client;
       process.stdout.write(`${String(selected.name || clientId)} \xB7 Brain v${String(selected.brain_version || "?")}
@@ -2154,15 +2167,7 @@ async function campaignOs(args) {
     }
     const limit = numberFlag("limit") ?? 15;
     requireIntegerInRange(limit, "--limit", 1, 50);
-    const allowedKinds = [
-      "client_brain",
-      "campaign_register",
-      "campaign_learning",
-      "campaign_methodology",
-      "campaign_genome",
-      "campaign_playbook",
-      "knowledge_inventory"
-    ];
+    const allowedKinds = import_sdk.CAMPAIGN_OS_KNOWLEDGE_RECORD_KINDS;
     const recordKind = flag("record-kind");
     if (recordKind && !allowedKinds.includes(recordKind)) {
       throw new CliInputError(`--record-kind must be one of: ${allowedKinds.join(", ")}`);
@@ -2170,6 +2175,7 @@ async function campaignOs(args) {
     const result = await client.searchCampaignOsKnowledge({
       query,
       clientId: flag("client-id"),
+      knowledgeSnapshotId: flag("knowledge-snapshot-id"),
       recordKind,
       limit
     });
@@ -2282,6 +2288,7 @@ async function campaignOs(args) {
       targetCount,
       audienceBindingId: flag("audience-binding-id"),
       audienceDefinitionId: flag("audience-definition-id"),
+      knowledgeSnapshotId: flag("knowledge-snapshot-id"),
       campaignSpec,
       agentVendor: campaignOsAgentFlag(),
       idempotencyKey
@@ -2456,6 +2463,187 @@ async function campaignOs(args) {
     output(result, () => process.stdout.write("Compile preview recorded \xB7 provider calls 0 \xB7 no campaign created or sent\n"));
     return;
   }
+  if (action === "alpha-plan" || action === "alpha-discover") {
+    const clientId = flag("client-id");
+    const clientName = flag("client-name");
+    const offerSummary = flag("offer-summary");
+    const icpSummary = flag("icp-summary");
+    const idempotencyKey = flag("idempotency-key")?.trim();
+    if (!clientId || !clientName || !offerSummary || !icpSummary || !idempotencyKey) {
+      throw new CliInputError(`signaliz campaign-os ${action} requires --client-id, --client-name, --offer-summary, --icp-summary, and --idempotency-key`);
+    }
+    const params = {
+      clientId,
+      campaignId: flag("campaign-id"),
+      clientName,
+      offerSummary,
+      icpSummary,
+      buyerPersonas: csvFlag("buyer-personas"),
+      knownEvidence: csvFlag("known-evidence"),
+      preferredSources: csvFlag("preferred-sources"),
+      idempotencyKey
+    };
+    if (action === "alpha-plan") {
+      const result2 = await client.planCampaignOsAlpha(params);
+      output(result2, () => {
+        process.stdout.write("Signaliz Alpha plan ready \xB7 model calls 0 \xB7 web searches 0 \xB7 spend $0.00\n");
+        process.stdout.write("Candidates will remain unvalidated until a measured sample proves them.\n");
+      });
+      return;
+    }
+    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);
+    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
+`);
+      process.stdout.write("Output is candidate-only. Clay, audience creation, provider load, activation, queue, and send remain locked.\n");
+    });
+    return;
+  }
+  if (action === "alpha-status") {
+    const alphaRunId = flag("alpha-run-id");
+    if (!alphaRunId) {
+      throw new CliInputError("signaliz campaign-os alpha-status requires --alpha-run-id <uuid>");
+    }
+    const result = await client.getCampaignOsAlphaRun(alphaRunId);
+    output(result, () => {
+      const run = record(result.run);
+      process.stdout.write(`Signaliz Alpha run: ${String(run.status || "unknown")} \xB7 ${String(run.id || alphaRunId)}
+`);
+      process.stdout.write("Completed output remains a source-cited candidate until a measured validation receipt exists.\n");
+    });
+    return;
+  }
+  if (action === "alpha-validate") {
+    const clientId = flag("client-id");
+    const campaignId = flag("campaign-id");
+    const alphaRunId = flag("alpha-run-id");
+    const candidateIndex = numberFlag("candidate-index");
+    const sampleFile = flag("sample-file");
+    const idempotencyKey = flag("idempotency-key")?.trim();
+    if (!clientId || !campaignId || !alphaRunId || candidateIndex === void 0 || !sampleFile || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os alpha-validate requires --client-id, --campaign-id, --alpha-run-id, --candidate-index, --sample-file, and --idempotency-key");
+    }
+    requireIntegerInRange(candidateIndex, "--candidate-index", 0, 4);
+    if (!hasFlag("confirm-spend")) {
+      throw new CliInputError("signaliz campaign-os alpha-validate requires --confirm-spend for the fixed $0.25 maximum");
+    }
+    let sampleEntities;
+    try {
+      const parsed = JSON.parse((0, import_node_fs.readFileSync)(sampleFile, "utf8"));
+      if (!Array.isArray(parsed) || parsed.length < 3 || parsed.length > 20) {
+        throw new Error("file must contain a JSON array of 3-20 sample entities");
+      }
+      sampleEntities = parsed;
+    } catch (error) {
+      throw new CliInputError(`Unable to read --sample-file: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const result = await client.startCampaignOsAlphaValidation({
+      clientId,
+      campaignId,
+      alphaRunId,
+      candidateIndex,
+      sampleEntities,
+      idempotencyKey
+    });
+    output(result, () => {
+      const run = record(result.run);
+      process.stdout.write(`Signaliz Alpha validation started: ${String(run.id || "")} \xB7 ${String(run.status || "queued")} \xB7 maximum $0.25
+`);
+      process.stdout.write("Passing status is receipt-derived. Clay and delivery providers remain locked.\n");
+    });
+    return;
+  }
+  if (action === "alpha-validation-status" || action === "alpha-apply") {
+    const validationRunId = flag("validation-run-id");
+    if (!validationRunId) {
+      throw new CliInputError(`signaliz campaign-os ${action} requires --validation-run-id <uuid>`);
+    }
+    const result = action === "alpha-apply" ? await client.applyCampaignOsValidatedAlpha(validationRunId) : await client.getCampaignOsAlphaValidationRun(validationRunId);
+    output(result, () => {
+      const run = record(result.run);
+      if (action === "alpha-apply") {
+        process.stdout.write(`Validated Alpha applied to immutable CampaignSpec: ${String(run.applied_spec_version_id || "complete")}
+`);
+        process.stdout.write("Provider load, activation, queue, and send remain locked.\n");
+      } else {
+        process.stdout.write(`Signaliz Alpha validation: ${String(run.status || "unknown")} \xB7 ${String(run.matched_count || 0)}/${String(run.sample_size || 0)} matched
+`);
+        process.stdout.write(`Validation passed: ${run.validation_passed === true ? "yes" : "no"}
+`);
+      }
+    });
+    return;
+  }
+  if (action === "connections") {
+    const clientId = flag("client-id");
+    if (!clientId) throw new CliInputError("signaliz campaign-os connections requires --client-id <uuid>");
+    const result = await client.listCampaignOsConnections(clientId);
+    output(result, () => {
+      process.stdout.write(`${result.bindings.length} client binding(s) \xB7 ${result.source_bindings.length} exact source binding(s)
+`);
+      process.stdout.write("OAuth tokens and raw provider values were not returned; no provider call occurred.\n");
+    });
+    return;
+  }
+  if (action === "source-binding" || action === "source-policy") {
+    const clientId = flag("client-id");
+    const bindingId = flag("binding-id");
+    const name = flag("name");
+    const sourceKind = flag("source-kind");
+    const selectorFile = flag("selector-file");
+    const idempotencyKey = flag("idempotency-key")?.trim();
+    if (!clientId || !bindingId || !name || !sourceKind || !selectorFile || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os source-binding requires --client-id, --binding-id, --name, --source-kind, --selector-file, and --idempotency-key");
+    }
+    if (!["memory", "data", "audience", "trigger"].includes(sourceKind)) {
+      throw new CliInputError("--source-kind must be memory, data, audience, or trigger");
+    }
+    let selector;
+    try {
+      const parsed = JSON.parse((0, import_node_fs.readFileSync)(selectorFile, "utf8"));
+      if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) throw new Error("file must contain one JSON object");
+      selector = parsed;
+    } catch (error) {
+      throw new CliInputError(`Unable to read --selector-file: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const result = await client.createCampaignOsSourceBinding({
+      clientId,
+      bindingId,
+      name,
+      sourceKind,
+      remoteObjectType: flag("remote-object-type"),
+      remoteRef: flag("remote-ref"),
+      selector,
+      audienceId: flag("audience-id"),
+      idempotencyKey
+    });
+    output(result, () => {
+      const sourceBinding = record(result.source_binding);
+      process.stdout.write(`Draft source binding: ${String(sourceBinding.name || name)} (${String(sourceBinding.id || "")})
+`);
+      process.stdout.write("Provider calls: 0 \xB7 hydration: locked \xB7 realtime armed: false \xB7 send authorized: false\n");
+    });
+    return;
+  }
+  if (action === "source-preflight") {
+    const clientId = flag("client-id");
+    const sourceBindingId = flag("source-binding-id") || flag("source-policy-id");
+    const idempotencyKey = flag("idempotency-key")?.trim();
+    const maxRecords = numberFlag("max-records") ?? 25;
+    if (!clientId || !sourceBindingId || !idempotencyKey) {
+      throw new CliInputError("signaliz campaign-os source-preflight requires --client-id, --source-binding-id, and --idempotency-key");
+    }
+    requireIntegerInRange(maxRecords, "--max-records", 1, 25);
+    const result = await client.preflightCampaignOsSourceBinding(clientId, sourceBindingId, idempotencyKey, maxRecords);
+    output(result, () => {
+      process.stdout.write("Source binding preflight recorded \xB7 provider calls 0 \xB7 source approval unchanged\n");
+    });
+    return;
+  }
   if (action === "request") {
     const clientId = flag("client-id");
     const actionType = flag("action");
@@ -2560,7 +2748,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|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|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.91",
+  "version": "1.0.93",
   "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.95"
+    "@signaliz/sdk": "^1.0.97"
   },
   "devDependencies": {
     "tsup": "^8.0.0",