fullstackgtm 0.50.0 → 0.51.0

package/src/cli/enrich.ts

@@ -9,6 +9,8 @@ import { createFilePlanStore } from "../planStore.ts";
 import { buildAcquirePlan, buildEnrichPlan, createFileEnrichRunStore, DEFAULT_STALE_DAYS, ENRICH_CONFIG_FILE_NAME, builtinAcquirePreset, builtinEnrichPreset, enrichRunId, inferIngestObjectType, latestStamps, loadEnrichConfig, parseCsv, resolveCrmField, selectStaleWork, stagedSourceRecords, staleDaysFor, type EnrichConfig, type EnrichCounts, type EnrichObjectType, type EnrichRun, type EnrichRunStore, type EnrichSourceRecord } from "../enrich.ts";
 import { loadMeter, remaining, type AcquireRemaining } from "../acquireMeter.ts";
 import { crmContactKeys, fetchExploriumProspects, fetchPipe0CrustdataProspectPage, partitionFreshProspects, pipe0ResolveCompanyDomains, pipe0ResolveWorkEmails, prospectIdentityKeys, type Prospect } from "../connectors/prospectSources.ts";
+import { createClaySearch, runClayPeopleSearchPage } from "../connectors/clay.ts";
+import { runContactWaterfall, type ContactProviderAdapter, type ContactWaterfallStep } from "../contactProviders.ts";
 import { loadSeen, recordSeen } from "../acquireSeen.ts";
 import { acquireCheckpointId, createFileAcquireCheckpointStore, type AcquireCheckpointKey } from "../acquireCheckpoint.ts";
 import { readHostedAcquireCheckpoint, writeHostedAcquireCheckpoint } from "../hostedAcquireCheckpoint.ts";
@@ -16,7 +18,7 @@ import { uploadHostedPatchPlan } from "../hostedPatchPlan.ts";
 import { progressReporter, reportCounts, reportEvent } from "../runReport.ts";
 import { ACQUIRE_STAGES, composeListeners, createProgressEmitter } from "../progress.ts";
 import { createLinkedInProvider, discoverLinkedInProspects } from "../acquireLinkedIn.ts";
-import { fitThreshold, icpToCrustdataFilters, icpToExploriumFilters, scoreProspectAgainstIcp, type Icp } from "../icp.ts";
+import { fitThreshold, icpToClayPeopleFilters, icpToCrustdataFilters, icpToExploriumFilters, scoreProspectAgainstIcp, type Icp } from "../icp.ts";
 import { apolloPullKeysForAppend, apolloPullKeysForRefresh, createApolloClient, pullApolloRecords, type ApolloPullKey } from "../enrichApollo.ts";
 import type { CanonicalGtmSnapshot } from "../types.ts";
 import { isSpoolPath, readSpoolPath } from "../spoolFiles.ts";
@@ -24,6 +26,7 @@ import { isOptionValue, loadIcp, numericOption, option, readSnapshot, saveReques
 import { providerKey } from "./tam.ts";
 import { unknownSubcommandError } from "./suggest.ts";
 import { colorEnabled, createProgressRenderer, createStatusLine, formatBar, formatDuration, paint, type Paint } from "./ui.ts";
+import { compactPlan, verbosePlanRequested } from "./planOutput.ts";
 import type { AcquireBudget } from "../acquireMeter.ts";
 
 
@@ -216,8 +219,8 @@ are phase 2. Recurring execution is the scheduler's job; enrich has no cron.`);
     // additional per-run ceiling, never a way to exceed the budget.
     if (apiSkippedCrm || apiSkippedSeen) {
       console.error(
-        `Pre-email dedup: skipped ${apiSkippedCrm} already-in-CRM + ${apiSkippedSeen} seen before paying for emails ` +
-          `(≈$${((apiSkippedCrm + apiSkippedSeen) * costPerRecord).toFixed(2)} enrichment saved).`,
+        `Pre-enrichment dedup: skipped ${apiSkippedCrm} already-in-CRM + ${apiSkippedSeen} previously seen ` +
+          `(≈$${((apiSkippedCrm + apiSkippedSeen) * costPerRecord).toFixed(2)} downstream spend avoided).`,
       );
     }
     // `cap` is the desired create count bounded by the persistent meter. Raw
@@ -300,20 +303,16 @@ are phase 2. Recurring execution is the scheduler's job; enrich has no cron.`);
     const meterLine = formatAcquireMeter(headroom, costPerRecord);
     const gaugeLine = acquireGaugeLine(headroom, config.acquire.budget ?? {}, paint(colorEnabled(process.stdout)));
     if (!save) {
-      if (rest.includes("--json")) {
-        console.log(
-          JSON.stringify(
-            { plan: result.plan, counts: result.counts, estCostUsd: result.estCostUsd, meter: headroom },
-            null,
-            2,
-          ),
-        );
-      } else {
-        console.log(patchPlanToMarkdown(result.plan));
-        console.log(meterLine);
-        if (gaugeLine) console.log(gaugeLine);
-        console.log("\nDry run — nothing written. Re-run with --save to persist the plan, then approve + apply.");
-      }
+      printAcquireOutput({
+        args: rest,
+        result,
+        meter: headroom,
+        meterLine,
+        gaugeLine,
+        saved: false,
+        planSaved: false,
+        hostedPlanUrl: null,
+      });
       return;
     }
 
@@ -362,24 +361,16 @@ are phase 2. Recurring execution is the scheduler's job; enrich has no cron.`);
         acquireCheckpointSync.hostedVersion,
       );
     }
-    if (planIds.length > 0) {
-      const hostedRuns = hostedRunsUrl();
-      console.log(`\nSaved plan ${result.plan.id}`);
-      console.log(`  Leads      ${result.counts.created} net-new`);
-      console.log(`  Est. cost  $${result.estCostUsd.toFixed(2)}`);
-      console.log(`  Budget     ${gaugeLine ?? meterLine}`);
-      if (hostedPlanUrl) console.log(`  Plan       ${hostedPlanUrl}`);
-      if (hostedRuns) console.log(`  Observe    ${hostedRuns}`);
-      console.log("\nNext steps");
-      console.log(`  Review     fullstackgtm plans show ${result.plan.id}`);
-      console.log(`  Approve    fullstackgtm plans approve ${result.plan.id} --operations all`);
-      console.log(`  Apply      fullstackgtm apply --plan-id ${result.plan.id} --provider hubspot`);
-      console.log("\nThe meter is charged only when a create lands at apply.");
-    } else {
-      console.log(meterLine);
-      if (gaugeLine) console.log(gaugeLine);
-      console.log("No net-new leads to create (everything sourced already matched, or was withheld by the meter).");
-    }
+    printAcquireOutput({
+      args: rest,
+      result,
+      meter: headroom,
+      meterLine,
+      gaugeLine,
+      saved: true,
+      planSaved: planIds.length > 0,
+      hostedPlanUrl,
+    });
     return;
   }
 
@@ -514,7 +505,7 @@ are phase 2. Recurring execution is the scheduler's job; enrich has no cron.`);
     if (rest.includes("--json")) {
       console.log(JSON.stringify(result.plan, null, 2));
     } else {
-      console.log(patchPlanToMarkdown(result.plan));
+      console.log(verbosePlanRequested(rest) ? patchPlanToMarkdown(result.plan) : compactPlan(result.plan));
       console.log(formatEnrichCounts(result.counts, result.ambiguities.length));
       console.log("\nDry run — nothing written. Re-run with --save to persist the plan and the run record.");
     }
@@ -560,8 +551,9 @@ function formatEnrichCounts(counts: EnrichCounts, ambiguities: number) {
 /**
  * Pull net-new prospects from an API acquire source into source records the
  * acquire builder dedupes + turns into create_record ops. Explorium discovers;
- * pipe0 (when resolveEmailsWith=pipe0) fills real work emails. Only rows that
- * carry the dedupe key (email) survive — you cannot resolve-first without it.
+ * A field-level provider waterfall fills missing contact data. Existing
+ * email-keyed and resolveEmailsWith=pipe0 configs translate to an implicit
+ * Pipe0 work-email step. Only rows that carry the configured dedupe key survive.
  */
 async function acquireFromApi(
   config: EnrichConfig,
@@ -601,7 +593,9 @@ async function acquireFromApi(
     ? (icp ? icpToExploriumFilters(icp) : (disc.filters ?? {}))
     : disc.provider === "pipe0"
       ? (icp ? icpToCrustdataFilters(icp) : (disc.filters ?? {}))
-      : {};
+      : disc.provider === "clay"
+        ? (icp ? icpToClayPeopleFilters(icp) : (disc.filters ?? {}))
+        : {};
   const queryFingerprint = createHash("sha256")
     .update(JSON.stringify({ source, provider: disc.provider, listId, filters, icp: icp ?? null }))
     .digest("hex");
@@ -676,6 +670,19 @@ async function acquireFromApi(
       page = result.prospects;
       cursor = result.nextCursor;
       exhausted = result.nextCursor === null;
+    } else if (disc.provider === "clay") {
+      if (!cursor) {
+        progress.note("creating Clay people-search iterator");
+        cursor = await createClaySearch({
+          apiKey: providerKey("clay"), sourceType: "people", filters,
+        });
+      }
+      const result = await runClayPeopleSearchPage({
+        apiKey: providerKey("clay"), searchId: cursor, limit: requestSize,
+      });
+      page = result.prospects;
+      offset += page.length;
+      exhausted = !result.hasMore;
     } else if (disc.provider === "explorium") {
       const pageNumber = offset + 1;
       exploriumPage = pageNumber;
@@ -694,7 +701,7 @@ async function acquireFromApi(
       offset += page.length;
       exhausted = page.length < requestSize;
     } else {
-      throw new Error(`enrich acquire: unknown discovery provider "${disc.provider}" (explorium | pipe0 | linkedin).`);
+      throw new Error(`enrich acquire: unknown discovery provider "${disc.provider}" (clay | explorium | pipe0 | linkedin).`);
     }
     discovered += page.length;
     progress.items(discovered, scanLimit);
@@ -746,23 +753,37 @@ async function acquireFromApi(
   progress.stage(ACQUIRE_STAGES[1], 1, ACQUIRE_STAGES.length);
   progress.note("checking work-email requirements");
 
-  // 3. Resolve real work emails. Triggered either when email IS the dedupe key
-  //    (Explorium's email is hashed, Crustdata returns none) or when a source
-  //    that keys on something else opts in via `resolveEmailsWith: "pipe0"`
-  //    (e.g. LinkedIn keys on the profile URL but still wants outreach emails).
-  //    pipe0 waterfall, chunked; resolves from name + company domain/name.
-  if (matchKey === "email" || disc.resolveEmailsWith === "pipe0") {
-    // The waterfall needs a company DOMAIN; LinkedIn/HeyReach lists carry only
-    // names. Resolve domains first (pipe0 company:identity) so resolution can
-    // actually land — without it, name-only resolution fails for every lead.
-    if (prospects.some((p) => !p.companyDomain && p.companyName)) {
-      progress.note(`resolving company domains for ${prospects.length} candidate(s)`);
-      const resolved = await pipe0ResolveCompanyDomains({ apiKey: providerKey("pipe0"), prospects });
-      prospects.splice(0, prospects.length, ...resolved);
+  // 3. Resolve contact fields through the ordered, fill-only waterfall. Keep
+  // legacy behavior: email-keyed acquisition and resolveEmailsWith=pipe0 imply
+  // a Pipe0 work-email step when no explicit waterfall is configured.
+  const implicitPipe0 = matchKey === "email" || disc.resolveEmailsWith === "pipe0";
+  const contactWaterfall: ContactWaterfallStep[] = disc.contactWaterfall ?? (
+    implicitPipe0 ? [{ provider: "pipe0", fields: ["work_email"] }] : []
+  );
+  if (contactWaterfall.length > 0) {
+    const adapters: Record<string, ContactProviderAdapter> = {
+      pipe0: {
+        provider: "pipe0",
+        resolve: async (candidates, fields) => {
+          let resolved = candidates;
+          if (fields.includes("work_email") && resolved.some((p) => !p.companyDomain && p.companyName)) {
+            progress.note(`resolving company domains for ${resolved.length} candidate(s)`);
+            resolved = await pipe0ResolveCompanyDomains({ apiKey: providerKey("pipe0"), prospects: resolved });
+          }
+          if (fields.includes("work_email")) {
+            progress.note(`resolving work emails with pipe0 for ${resolved.length} candidate(s)`);
+            resolved = await pipe0ResolveWorkEmails({ apiKey: providerKey("pipe0"), prospects: resolved });
+          }
+          return resolved;
+        },
+      },
+    };
+    const result = await runContactWaterfall({ prospects, steps: contactWaterfall, adapters });
+    prospects.splice(0, prospects.length, ...result.prospects);
+    for (const attempt of result.attempts) {
+      const added = Object.entries(attempt.added).map(([field, count]) => `${count} ${field}`).join(", ") || "0 fields";
+      progress.note(`${attempt.provider}: ${attempt.attempted} attempted · ${added} added`);
     }
-    progress.note(`resolving work emails for ${prospects.length} candidate(s)`);
-    const resolved = await pipe0ResolveWorkEmails({ apiKey: providerKey("pipe0"), prospects });
-    prospects.splice(0, prospects.length, ...resolved);
   }
   progress.items(prospects.length, prospects.length);
   progress.note(`${prospects.length} candidate(s) ready for planning`);
@@ -875,6 +896,61 @@ function formatAcquireMeter(headroom: AcquireRemaining, costPerRecord: number):
   );
 }
 
+function printAcquireOutput(options: {
+  args: readonly string[];
+  result: ReturnType<typeof buildAcquirePlan>;
+  meter: AcquireRemaining;
+  meterLine: string;
+  gaugeLine: string | null;
+  /** The acquisition run/checkpoint was persisted. */
+  saved: boolean;
+  /** A non-empty plan was persisted to the plan store. */
+  planSaved: boolean;
+  hostedPlanUrl: string | null;
+}): void {
+  const { args, result, meter, meterLine, gaugeLine, saved, planSaved, hostedPlanUrl } = options;
+  if (args.includes("--json")) {
+    console.log(JSON.stringify({
+      plan: result.plan,
+      counts: result.counts,
+      estCostUsd: result.estCostUsd,
+      meter,
+      persistence: {
+        runSaved: saved,
+        planSaved,
+        planId: planSaved ? result.plan.id : null,
+        hostedPlanUrl,
+      },
+    }, null, 2));
+    return;
+  }
+
+  if (verbosePlanRequested(args)) {
+    console.log(patchPlanToMarkdown(result.plan));
+    console.log(`\nAcquisition`);
+    console.log(`  Leads      ${result.counts.created} net-new · ${result.counts.unassigned} unassigned`);
+    console.log(`  Est. cost  $${result.estCostUsd.toFixed(2)}`);
+    console.log(`  Budget     ${gaugeLine ?? meterLine}`);
+    if (hostedPlanUrl) console.log(`  Plan       ${hostedPlanUrl}`);
+  } else if (planSaved || !saved) {
+    console.log(compactPlan(result.plan, { saved: planSaved }));
+    console.log(meterLine);
+    if (gaugeLine) console.log(gaugeLine);
+  } else {
+    console.log(meterLine);
+    if (gaugeLine) console.log(gaugeLine);
+    console.log("No net-new leads to create (everything sourced already matched, or was withheld by the meter).");
+  }
+
+  if (planSaved) {
+    console.log(`\nApprove  fullstackgtm plans approve ${result.plan.id} --operations all`);
+    console.log(`Apply    fullstackgtm apply --plan-id ${result.plan.id} --provider <hubspot|salesforce>`);
+    const hostedRuns = hostedRunsUrl();
+    if (hostedRuns) console.log(`Observe  ${hostedRuns}`);
+    console.log("The meter is charged only when a create lands at apply.");
+  }
+}
+
 function hostedRunsUrl(): string | null {
   const baseUrl = getCredential("broker")?.baseUrl?.replace(/\/+$/, "");
   return baseUrl ? `${baseUrl}/dashboard/runs` : null;

package/src/cli/fix.ts

@@ -22,6 +22,7 @@ import { progressReporter } from "../runReport.ts";
 import type { PatchPlan, PatchPlanRun } from "../types.ts";
 import { confirmRequested, connectorFor, isOptionValue, numericOption, option, readSnapshot, repeatedOption, saveRequested } from "./shared.ts";
 import { box, colorEnabled, createProgressRenderer, paint } from "./ui.ts";
+import { compactPlan, verbosePlanRequested } from "./planOutput.ts";
 
 
 /**
@@ -107,8 +108,10 @@ async function emitPlan(plan: PatchPlan, args: string[]) {
   }
   if (args.includes("--json")) {
     console.log(JSON.stringify(plan, null, 2));
-  } else {
+  } else if (verbosePlanRequested(args)) {
     console.log(patchPlanToMarkdown(plan));
+  } else {
+    console.log(compactPlan(plan, { saved: saveRequested(args) }));
   }
 }
 
@@ -181,8 +184,7 @@ export async function reassignCommand(args: string[]) {
   const store = saveRequested(args) ? createFilePlanStore() : null;
   for (const plan of plans) {
     if (store) await store.save(plan);
-    console.log(`${plan.id}  ${String(plan.operations.length).padStart(3)} operation(s)  ${plan.title}`);
-    console.log(`    ${plan.summary}`);
+    console.log(verbosePlanRequested(args) ? patchPlanToMarkdown(plan) : compactPlan(plan, { saved: Boolean(store) }));
   }
   if (store) {
     console.log(

package/src/cli/help.ts

@@ -20,13 +20,16 @@ Usage:
   fullstackgtm login salesforce --instance-url <url> [--no-validate]  advanced: paste access token
   fullstackgtm login stripe [--no-validate]
   fullstackgtm login anthropic | openai        store an LLM API key for call parse/score
-  fullstackgtm login apollo                    store an Apollo API key for enrich pulls\n  fullstackgtm login pipe0 | explorium | theirstack  store a discovery-provider key (theirstack = technographic TAM)\n  fullstackgtm login heyreach                  store a HeyReach key for enrich acquire --source linkedin\n  fullstackgtm logout <hubspot|salesforce|stripe|anthropic|openai|apollo|pipe0|explorium|heyreach|broker>
+  fullstackgtm login apollo | clay             store a data-provider Public API key
+  fullstackgtm login pipe0 | explorium | theirstack  store a discovery-provider key (theirstack = technographic TAM)
+  fullstackgtm login heyreach                  store a HeyReach key for enrich acquire --source linkedin
+  fullstackgtm logout <hubspot|salesforce|stripe|anthropic|openai|apollo|clay|pipe0|explorium|heyreach|broker>
 
   Secrets (tokens, client secrets) are NEVER passed as flags — they leak via
   the process list and shell history. Pipe them on stdin or enter them at the
   interactive prompt:
     echo "$HUBSPOT_TOKEN" | fullstackgtm login hubspot --private-token
-  fullstackgtm init [--source pipe0|explorium|linkedin] [--provider hubspot|salesforce] [--out <dir>] [--force]
+  fullstackgtm init [--source pipe0|explorium|clay|linkedin] [--provider hubspot|salesforce] [--out <dir>] [--force]
                                                cold start: scaffold icp.json + enrich.config.json + a
                                                PLAYBOOK wired for this workspace (the CLI ships primitives,
                                                your agent is the orchestrator — see docs/recipes.md)
@@ -76,7 +79,7 @@ Usage:
   fullstackgtm tam estimate [--name <n>] [--icp <path>] (--accounts <n> | --source theirstack|explorium) (--acv <annual-usd> | --acv-from-crm --deal-period monthly|quarterly|annual) [--acv-basis account|buyer] [--buyers-per-account <n>] [--cross-checks <file.json>] [source options] [--json]
   fullstackgtm tam status [--name <n>] <source options> [--save] [--json]
   fullstackgtm tam report [--name <n>] [--out <path>]
-  fullstackgtm tam populate [--name <n>] --cron "<expr>" [--source pipe0|explorium|linkedin] [--provider hubspot|salesforce] [--label <l>]
+  fullstackgtm tam populate [--name <n>] --cron "<expr>" [--source pipe0|explorium|clay|linkedin] [--provider hubspot|salesforce] [--label <l>]
                                                size the reachable market FROM the ICP (a real account count ×
                                                ACV; buyers/account = the contact population target), then fill
                                                it: populate schedules plan-only enrich acquire --save (apply
@@ -180,11 +183,11 @@ Usage:
   fullstackgtm suggest --plan-id <id> | --plan <path>  [source options] [--json] [--out <path>]
                                                derive values for requires_human_* placeholders
                                                from snapshot evidence, with confidence + reasons
-  fullstackgtm plans list [--status <s>] | show <id> | sync | reject <id>
+  fullstackgtm plans list [--status <s>] | show <id> [--verbose] | sync | reject <id>
   fullstackgtm plans approve <id> --operations <ids|all> [--value <opId>=<v>]
   fullstackgtm plans approve <id> --values-from <suggestions.json> [--min-confidence high|low] [--include-creates]
   fullstackgtm plans recover <id> --acknowledge-uncertain-writes
-  fullstackgtm apply --plan-id <id> --provider <name>
+  fullstackgtm apply --plan-id <id> --provider <name> [--verbose|--json]
   fullstackgtm apply --plan-id <id> --channel outbox          (render approved openers; transmits nothing)
   fullstackgtm apply --plan <path> --provider <name> --approve <ids|all> [options]
   fullstackgtm audit-log export [--out <path>] | verify --in <path>   tamper-evident apply-run record
@@ -298,7 +301,7 @@ export const HELP: Record<string, HelpEntry> = {
     summary: "scaffold a workspace (icp.json + enrich.config.json + PLAYBOOK)",
     phase: "Setup",
     synopsis: [
-      "fullstackgtm init [--source pipe0|explorium|linkedin] [--provider hubspot|salesforce] [--out <dir>] [--force]",
+      "fullstackgtm init [--source pipe0|explorium|clay|linkedin] [--provider hubspot|salesforce] [--out <dir>] [--force]",
     ],
     detail:
       "Cold start: writes a starter ICP, an acquire-ready enrich.config.json (with a visible assign seam so leads are never ownerless), and a PLAYBOOK wired with the cold-start + outbound-loop recipes for this workspace. Pure file-writer — no network, keeps existing files unless --force. The CLI ships governed primitives; your coding agent is the orchestrator (see docs/recipes.md).",
@@ -312,7 +315,7 @@ export const HELP: Record<string, HelpEntry> = {
       "fullstackgtm login hubspot | salesforce          hosted browser OAuth (default)",
       "fullstackgtm login --via <hosted url>            pair with a team deployment",
       "fullstackgtm login stripe",
-      "fullstackgtm login anthropic | openai | apollo",
+      "fullstackgtm login anthropic | openai | apollo | clay",
     ],
     detail:
       "HubSpot/Salesforce use hosted browser OAuth by default; BYO app/token paths are advanced. Secrets are NEVER passed as flags — pipe on stdin or enter at the prompt: `echo \"$TOKEN\" | fullstackgtm login hubspot --private-token`.",
@@ -321,7 +324,7 @@ export const HELP: Record<string, HelpEntry> = {
   logout: {
     summary: "remove stored credentials for a provider",
     phase: "Setup",
-    synopsis: ["fullstackgtm logout <hubspot|salesforce|stripe|anthropic|openai|apollo|pipe0|explorium|broker>"],
+    synopsis: ["fullstackgtm logout <hubspot|salesforce|stripe|anthropic|openai|apollo|clay|pipe0|explorium|broker>"],
     seeAlso: ["login", "doctor"],
   },
   doctor: {
@@ -550,7 +553,7 @@ export const HELP: Record<string, HelpEntry> = {
     summary: "replicated plan lifecycle: list / show / sync / approve / reject",
     phase: "Govern",
     synopsis: [
-      "fullstackgtm plans list [--status <s>] | show <id> | sync | reject <id>",
+      "fullstackgtm plans list [--status <s>] | show <id> [--verbose] | sync | reject <id>",
       "fullstackgtm plans approve <id> --operations <ids|all> [--value <opId>=<v>]",
       "fullstackgtm plans approve <id> --values-from <suggestions.json> [--min-confidence high|low]",
       "fullstackgtm plans recover <id> --acknowledge-uncertain-writes",
@@ -563,12 +566,12 @@ export const HELP: Record<string, HelpEntry> = {
     summary: "write ONLY explicitly approved operations to a provider",
     phase: "Govern / Verify",
     synopsis: [
-      "fullstackgtm apply --plan-id <id> --provider <name>",
+      "fullstackgtm apply --plan-id <id> --provider <name> [--verbose|--json]",
       "fullstackgtm apply --plan-id <id> --channel outbox   (render approved drafted openers to the outbox; transmits nothing)",
       "fullstackgtm apply --plan <path> --provider <name> --approve <ids|all> [--value <opId>=<v>]",
     ],
     detail:
-      "The CLI CRM-write verb. Writes only operations approved locally or imported from the shared hosted replica, with an online execution claim when available, stable operation ids, compare-and-set, resolve-before-create, and readback. Hosted may execute the same synchronized plan when it has a compatible CRM connection; its exact operation receipts are imported on the next CLI check-in. Never writes requires_human_* placeholders without a --value override.",
+      "The CLI CRM-write verb. Writes only operations approved locally or imported from the shared hosted replica, with an online execution claim when available, stable operation ids, compare-and-set, resolve-before-create, and readback. Default output is a compact outcome card; --verbose prints the full run document and --json preserves structured output. Hosted may execute the same synchronized plan when it has a compatible CRM connection; its exact operation receipts are imported on the next CLI check-in. Never writes requires_human_* placeholders without a --value override.",
     seeAlso: ["plans", "suggest", "audit-log"],
   },
   "audit-log": {
@@ -658,7 +661,7 @@ export const BESPOKE_HELP = ["init", "call", "market", "tam", "enrich", "schedul
 export const GLOBAL_FLAGS = ["--help", "--full"];
 export const GLOBAL_SHORT_FLAGS = ["-h"];
 export const SOURCE_FLAGS = ["--provider", "--token-env", "--input", "--demo", "--sample", "--seed", "--today"];
-export const AUDIT_FLAGS = ["--config", "--allow-plugins", "--no-plugins", "--rules", "--stale-days", "--fail-on", "--save", "--dry-run", "--json", "--out", "--full"];
+export const AUDIT_FLAGS = ["--config", "--allow-plugins", "--no-plugins", "--rules", "--stale-days", "--fail-on", "--save", "--dry-run", "--json", "--out", "--full", "--verbose"];
 
 // Complete per-command flag registry used by runCli's fail-closed flag
 // validation. Keep this next to HELP so focused help, machine capabilities,
@@ -667,7 +670,7 @@ export const COMMAND_FLAGS: Record<string, string[]> = {
   init: ["--source", "--provider", "--out", "--force"],
   login: ["--via", "--hosted", "--private-token", "--token", "--key", "--api-key", "--client-id", "--client-secret", "--scopes", "--port", "--oauth", "--device", "--instance-url", "--login-url", "--no-validate"],
   logout: [],
-  doctor: ["--json"],
+  doctor: ["--verbose", "--json"],
   capabilities: ["--json"],
   "robot-docs": [],
   profiles: ["--json"],
@@ -681,24 +684,24 @@ export const COMMAND_FLAGS: Record<string, string[]> = {
   hierarchy: [...SOURCE_FLAGS, "--json", "--out"],
   relationships: [...SOURCE_FLAGS, "--account-id", "--domain", "--json", "--out"],
   route: [...SOURCE_FLAGS, "--match", "--no-inherit-owner", "--reassign-owned", "--policy", "--reason", "--max-operations", "--save", "--dry-run", "--json", "--out"],
-  fix: [...SOURCE_FLAGS, "--config", "--allow-plugins", "--no-plugins", "--rule", "--provider", "--min-confidence", "--include-creates", "--yes", "--confirm", "--dry-run"],
-  "bulk-update": [...SOURCE_FLAGS, "--where", "--set", "--guard", "--require", "--create-task", "--archive", "--force-archive-duplicates", "--reason", "--max-operations", "--save", "--dry-run", "--json", "--out"],
-  dedupe: [...SOURCE_FLAGS, "--key", "--keep", "--reason", "--max-operations", "--save", "--dry-run", "--json", "--out"],
-  reassign: [...SOURCE_FLAGS, "--from", "--assign-unowned", "--to", "--objects", "--where", "--except-deal-stage", "--include-closed-deals", "--reason", "--max-operations", "--save", "--dry-run", "--json", "--out"],
-  backfill: [...SOURCE_FLAGS, "--since", "--pipeline", "--match-property", "--skip-unmatched", "--save", "--dry-run", "--json"],
-  enrich: [...SOURCE_FLAGS, "--config", "--source", "--icp", "--input", "--provider", "--list", "--stale-days", "--assign-owner", "--objects", "--max", "--scan-limit", "--staged-run", "--run-label", "--label", "--runs", "--save", "--dry-run", "--json", "--out"],
-  call: [...SOURCE_FLAGS, "--transcript", "--title", "--source", "--model", "--deterministic", "--heuristics", "--llm", "--json", "--ndjson", "--out", "--call", "--call-type", "--rubric", "--list", "--list-rubrics", "--attendees", "--domain", "--deal", "--save", "--dry-run"],
+  fix: [...SOURCE_FLAGS, "--config", "--allow-plugins", "--no-plugins", "--rule", "--provider", "--min-confidence", "--include-creates", "--yes", "--confirm", "--dry-run", "--verbose"],
+  "bulk-update": [...SOURCE_FLAGS, "--where", "--set", "--guard", "--require", "--create-task", "--archive", "--force-archive-duplicates", "--reason", "--max-operations", "--save", "--dry-run", "--verbose", "--json", "--out"],
+  dedupe: [...SOURCE_FLAGS, "--key", "--keep", "--reason", "--max-operations", "--save", "--dry-run", "--verbose", "--json", "--out"],
+  reassign: [...SOURCE_FLAGS, "--from", "--assign-unowned", "--to", "--objects", "--where", "--except-deal-stage", "--include-closed-deals", "--reason", "--max-operations", "--save", "--dry-run", "--verbose", "--json", "--out"],
+  backfill: [...SOURCE_FLAGS, "--since", "--pipeline", "--match-property", "--skip-unmatched", "--save", "--dry-run", "--verbose", "--json"],
+  enrich: [...SOURCE_FLAGS, "--config", "--source", "--icp", "--input", "--provider", "--list", "--stale-days", "--assign-owner", "--objects", "--max", "--scan-limit", "--staged-run", "--run-label", "--label", "--runs", "--save", "--dry-run", "--verbose", "--json", "--out"],
+  call: [...SOURCE_FLAGS, "--transcript", "--title", "--source", "--model", "--deterministic", "--heuristics", "--llm", "--verbose", "--json", "--ndjson", "--out", "--call", "--call-type", "--rubric", "--list", "--list-rubrics", "--attendees", "--domain", "--deal", "--save", "--dry-run"],
   suggest: [...SOURCE_FLAGS, "--plan-id", "--plan", "--json", "--out"],
-  plans: ["--status", "--operations", "--value", "--values-from", "--min-confidence", "--include-creates", "--acknowledge-uncertain-writes", "--json"],
-  apply: ["--plan", "--plan-id", "--provider", "--channel", "--token-env", "--approve", "--value", "--json", "--config"],
+  plans: ["--status", "--operations", "--value", "--values-from", "--min-confidence", "--include-creates", "--acknowledge-uncertain-writes", "--verbose", "--json"],
+  apply: ["--plan", "--plan-id", "--provider", "--channel", "--token-env", "--approve", "--value", "--verbose", "--json", "--config"],
   "audit-log": ["--in", "--out", "--json"],
   merge: ["--input", "--out", "--json"],
-  market: ["--category", "--config", "--vendor", "--snapshot", "--task-account", "--task-deal", "--capture-run", "--run", "--prior-run", "--diff", "--from", "--calls", "--anchor", "--min-mentions", "--max-claims", "--promote-lift", "--model", "--format", "--auto", "--unverified", "--save", "--dry-run", "--json", "--out"],
-  tam: [...SOURCE_FLAGS, "--source", "--name", "--icp", "--accounts", "--acv", "--acv-basis", "--acv-from-crm", "--deal-period", "--buyers-per-account", "--cross-checks", "--max", "--max-credits", "--usd-per-credit", "--dry-run", "--confirm", "--cron", "--label", "--save", "--json", "--out"],
-  icp: [...SOURCE_FLAGS, "--name", "--signals-from", "--with-history", "--prompt", "--min-score", "--from-judge", "--golden", "--against-outcomes", "--min-accuracy", "--model", "--label", "--save", "--json", "--out"],
-  signals: ["--bucket", "--source", "--connector", "--connector-opt", "--watchlist", "--keywords", "--from", "--label", "--since", "--account", "--contact", "--unjudged", "--touch", "--result", "--save", "--json", "--explain"],
-  draft: ["--from-judge", "--min-score", "--prompt", "--model", "--channel", "--save", "--dry-run", "--json", "--out"],
-  schedule: ["--cron", "--label", "--provider", "--trigger", "--timer", "--runs", "--json"],
+  market: ["--category", "--config", "--vendor", "--snapshot", "--task-account", "--task-deal", "--capture-run", "--run", "--prior-run", "--diff", "--from", "--calls", "--anchor", "--min-mentions", "--max-claims", "--promote-lift", "--model", "--format", "--auto", "--unverified", "--save", "--dry-run", "--verbose", "--json", "--out"],
+  tam: [...SOURCE_FLAGS, "--source", "--name", "--icp", "--accounts", "--acv", "--acv-basis", "--acv-from-crm", "--deal-period", "--buyers-per-account", "--cross-checks", "--max", "--max-credits", "--usd-per-credit", "--dry-run", "--confirm", "--cron", "--label", "--save", "--verbose", "--json", "--out"],
+  icp: [...SOURCE_FLAGS, "--name", "--signals-from", "--with-history", "--prompt", "--min-score", "--from-judge", "--golden", "--against-outcomes", "--min-accuracy", "--model", "--label", "--save", "--verbose", "--json", "--out"],
+  signals: ["--bucket", "--source", "--connector", "--connector-opt", "--watchlist", "--keywords", "--from", "--label", "--since", "--account", "--contact", "--unjudged", "--touch", "--result", "--save", "--verbose", "--json", "--explain"],
+  draft: ["--from-judge", "--min-score", "--prompt", "--model", "--channel", "--save", "--dry-run", "--verbose", "--json", "--out"],
+  schedule: ["--cron", "--label", "--provider", "--trigger", "--timer", "--runs", "--verbose", "--json"],
 };
 
 export const FLAGS_WITH_VALUES = new Set([

package/src/cli/icp.ts

@@ -12,6 +12,18 @@ import { loadIcp, numericOption, option, readSnapshot, resolveLlmBaseUrls, saveR
 import { createStatusLine } from "./ui.ts";
 import { unknownSubcommandError } from "./suggest.ts";
 
+function renderJudgeDecisions(decisions: Awaited<ReturnType<typeof judgeSignals>>): string {
+  if (decisions.length === 0) return "No accounts cleared the score threshold.";
+  const lines = [`ICP decisions (${decisions.length})`, ""];
+  for (const decision of decisions) {
+    const target = decision.contact?.email || decision.contact?.title;
+    lines.push(`${decision.decision.toUpperCase().padEnd(7)} ${String(decision.score).padStart(3)}  ${decision.accountDomain}${target ? ` · ${target}` : ""}`);
+    if (decision.whyNow) lines.push(`            ${decision.whyNow.replace(/\s+/g, " ").trim()}`);
+    if (decision.play) lines.push(`            Next: ${decision.play.replace(/\s+/g, " ").trim()}`);
+  }
+  return lines.join("\n");
+}
+
 
 /**
  * `icp` — develop and inspect the Ideal Customer Profile that targets acquire.
@@ -158,7 +170,7 @@ ops. Develop one by interview, then \`enrich acquire\` picks up ./icp.json.
     decisions = decisions.filter((d) => d.score >= minScore);
 
     // 5) Ranked decisions to stdout (JSON), guidance to stderr.
-    console.log(JSON.stringify(decisions, null, 2));
+    console.log(rest.includes("--json") || rest.includes("--verbose") ? JSON.stringify(decisions, null, 2) : renderJudgeDecisions(decisions));
     console.error(
       `Judged ${unjudged.length} signal(s) across ${new Set(decisions.map((d) => d.accountDomain)).size} account(s): ` +
         `${decisions.filter((d) => d.decision === "send").length} send, ` +

package/src/cli/init.ts

@@ -16,7 +16,7 @@ import { option } from "./shared.ts";
 export function initCommand(args: string[]) {
   if (args.includes("--help") || args.includes("-h")) {
     console.log(`Usage:
-  fullstackgtm init [--source pipe0|explorium|linkedin] [--provider hubspot|salesforce] [--out <dir>] [--force]
+  fullstackgtm init [--source pipe0|explorium|clay|linkedin] [--provider hubspot|salesforce] [--out <dir>] [--force]
 
 Scaffolds a workspace so the first acquire/signals/judge/draft commands work:
   icp.json            starter ICP (edit, or rebuild with \`icp interview\`)
@@ -28,8 +28,8 @@ docs/recipes.md for the full play set. Existing files are kept unless --force.`)
     return;
   }
   const source = (option(args, "--source") ?? "pipe0") as InitSource;
-  if (!["pipe0", "explorium", "linkedin"].includes(source)) {
-    throw new Error(`init: --source must be pipe0|explorium|linkedin (got "${source}")`);
+  if (!["pipe0", "explorium", "clay", "linkedin"].includes(source)) {
+    throw new Error(`init: --source must be pipe0|explorium|clay|linkedin (got "${source}")`);
   }
   const provider = (option(args, "--provider") ?? "hubspot") as InitProvider;
   if (!["hubspot", "salesforce"].includes(provider)) {

package/src/cli/market.ts

@@ -499,8 +499,19 @@ Rules:
     if (outPath) {
       writeFileSync(resolve(process.cwd(), outPath), output);
       console.log(`Wrote ${outPath}`);
-    } else {
+    } else if (rest.includes("--verbose") || option(rest, "--format")) {
       console.log(output);
+    } else {
+      const fronts = computeFrontStates(config, set);
+      const counts = new Map<string, number>();
+      for (const front of fronts) counts.set(front.state, (counts.get(front.state) ?? 0) + 1);
+      console.log(`${config.category} market · ${set.runLabel}`);
+      console.log(`${fronts.length} claim fronts · ${["open", "contested", "owned", "saturated", "vacant"].filter((state) => counts.has(state)).map((state) => `${counts.get(state)} ${state}`).join(" · ")}`);
+      for (const front of fronts) {
+        const owner = front.loudVendorIds.length ? ` · ${front.loudVendorIds.join(", ")}` : "";
+        console.log(`\n${front.state.toUpperCase()}  ${front.claimId}${owner}`);
+      }
+      console.log("\nUse --verbose for the full evidence report, or --out <path> to write it.");
     }
     return;
   }

package/src/cli/planOutput.ts

@@ -0,0 +1,30 @@
+import type { PatchPlan } from "../types.ts";
+import { box, colorEnabled, paint, truncateToWidth } from "./ui.ts";
+
+export function compactPlan(plan: PatchPlan, options: { saved?: boolean } = {}): string {
+  const counts = new Map<string, number>();
+  for (const operation of plan.operations) {
+    const action = operation.operation || operation.field || "change";
+    counts.set(action, (counts.get(action) ?? 0) + 1);
+  }
+  const mix = [...counts]
+    .sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]))
+    .slice(0, 4)
+    .map(([action, count]) => `${count} ${action}`)
+    .join(" · ");
+  const lines = [
+    truncateToWidth(plan.title, 100),
+    `Status   ${options.saved ? "SAVED · NEEDS APPROVAL" : "DRY RUN · NOTHING WRITTEN"}`,
+    truncateToWidth(`Scope    ${plan.operations.length} operation${plan.operations.length === 1 ? "" : "s"}${mix ? ` · ${mix}` : ""}`, 100),
+    truncateToWidth(`Effect   ${plan.summary}`, 100),
+    options.saved ? `Next     fullstackgtm plans show ${plan.id}` : "Next     re-run with --save to stage this plan for approval",
+  ];
+  return [
+    ...box(lines, paint(colorEnabled(process.stdout)), "Plan preview"),
+    `Details: re-run with --verbose${options.saved ? `; JSON: fullstackgtm plans show ${plan.id} --json` : "; machine output: --json"}`,
+  ].join("\n");
+}
+
+export function verbosePlanRequested(args: readonly string[]) {
+  return args.includes("--verbose") || args.includes("--full");
+}