fullstackgtm 0.53.0 → 0.53.1

package/CHANGELOG.md

@@ -7,6 +7,21 @@ The path to 1.0 is planned in [docs/roadmap-to-1.0.md](https://github.com/fullst
 
 ## [Unreleased]
 
+## [0.53.1] — 2026-07-11
+
+### Changed
+
+- Human-readable `enrich acquire` output shows compact lead cards by default
+  before the governed plan preview; `--verbose` remains the full forensic dump.
+- Acquisition budget counters are labeled as applied-create policy headroom,
+  explicitly distinguished from market size, and no longer duplicated by a
+  second gauge in compact output.
+
+### Fixed
+
+- Multi-line progress renderers reserve their terminal rows before painting,
+  preventing partial spinner frames from scrolling into final output.
+
 ## [0.53.0] — 2026-07-11
 
 ### Added

package/dist/cli/enrich.js

@@ -23,7 +23,7 @@ import { isSpoolPath, readSpoolPath } from "../spoolFiles.js";
 import { isOptionValue, loadIcp, numericOption, option, readSnapshot, saveRequested } from "./shared.js";
 import { providerKey } from "./tam.js";
 import { unknownSubcommandError } from "./suggest.js";
-import { colorEnabled, createProgressRenderer, createStatusLine, formatBar, formatDuration, paint } from "./ui.js";
+import { box, colorEnabled, createProgressRenderer, createStatusLine, formatBar, formatDuration, paint, truncateToWidth } from "./ui.js";
 import { compactPlan, verbosePlanRequested } from "./planOutput.js";
 /**
  * The enrich layer: governed append/refresh of third-party data (Apollo pull,
@@ -785,8 +785,8 @@ function acquireGaugeLine(headroom, budget, p) {
         const painter = fraction >= 0.9 ? p.red : fraction >= 0.7 ? p.yellow : p.green;
         parts.push(`${p.dim(label)} ${painter(formatBar(fraction, 10))} ${fmt(used)}/${fmt(cap)}`);
     };
-    segment("records/day", headroom.records.day, budget.records?.perDay, String);
-    segment("records/mo", headroom.records.month, budget.records?.perMonth, String);
+    segment("applied/day", headroom.records.day, budget.records?.perDay, String);
+    segment("applied/mo", headroom.records.month, budget.records?.perMonth, String);
     segment("spend/day", headroom.spendUsd.day, budget.spend?.perDay, (value) => `$${value.toFixed(2)}`);
     segment("spend/mo", headroom.spendUsd.month, budget.spend?.perMonth, (value) => `$${value.toFixed(2)}`);
     return parts.length > 0 ? parts.join("  ·  ") : null;
@@ -795,10 +795,33 @@ function formatAcquireMeter(headroom, costPerRecord) {
     const n = (v) => (v === null ? "∞" : String(v));
     const money = (v) => (v === null ? "∞" : `$${v.toFixed(2)}`);
     const max = headroom.maxRecords === null ? "unlimited" : `${headroom.maxRecords}`;
-    return (`Acquire meter — creatable now: ${max} lead(s). ` +
-        `Records left: ${n(headroom.records.day)}/day, ${n(headroom.records.month)}/month · ` +
-        `Spend left: ${money(headroom.spendUsd.day)}/day, ${money(headroom.spendUsd.month)}/month ` +
-        `(≈$${costPerRecord.toFixed(2)}/lead).`);
+    return `Apply budget (not market size) — up to ${max} more create(s) may be applied now; ` +
+        `${n(headroom.records.day)} left today, ${n(headroom.records.month)} this month · ` +
+        `spend headroom ${money(headroom.spendUsd.day)}/day, ${money(headroom.spendUsd.month)}/month ` +
+        `(≈$${costPerRecord.toFixed(2)}/lead). Dry runs do not consume this budget.`;
+}
+function renderAcquireLeadCards(result) {
+    const p = paint(colorEnabled(process.stdout));
+    const evidence = new Map((result.plan.evidence ?? []).map((item) => [item.id, item]));
+    return result.plan.operations.map((operation, index) => {
+        const payload = operation.afterValue;
+        const props = payload.properties ?? {};
+        const name = [props.firstname, props.lastname].filter(Boolean).join(" ") || payload.matchValue;
+        const title = props.jobtitle || "Title unavailable";
+        const company = props.company || payload.associateCompanyName || "Company unavailable";
+        let fit;
+        const item = operation.evidenceIds?.[0] ? evidence.get(operation.evidenceIds[0]) : undefined;
+        try {
+            fit = Number(JSON.parse(item?.text ?? "{}").fitScore);
+        }
+        catch { /* malformed evidence remains display-only */ }
+        const lines = [
+            truncateToWidth(name, 84),
+            truncateToWidth(`${title} · ${company}`, 84),
+            truncateToWidth([payload.associateCompanyDomain, props.hs_linkedin_url].filter(Boolean).join(" · "), 84),
+        ];
+        return box(lines, p, `Lead ${index + 1}/${result.plan.operations.length}${Number.isFinite(fit) ? ` · ${Math.round((fit ?? 0) * 100)}% fit` : ""}`).join("\n");
+    }).join("\n");
 }
 function printAcquireOutput(options) {
     const { args, result, meter, meterLine, gaugeLine, saved, planSaved, hostedPlanUrl } = options;
@@ -827,15 +850,13 @@ function printAcquireOutput(options) {
             console.log(`  Plan       ${hostedPlanUrl}`);
     }
     else if (planSaved || !saved) {
+        if (result.plan.operations.length > 0)
+            console.log(renderAcquireLeadCards(result));
         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) {

package/dist/cli/ui.js

@@ -266,6 +266,12 @@ export function createChecklist(items, stream = process.stderr, env = process.en
         // newline on every repaint can scroll the old top row into permanent
         // history when the board sits at the bottom of the terminal, producing
         // apparent duplicate/errored frames in terminal captures.
+        // Reserve the board's rows before the first paint. Writing populated rows
+        // directly at the terminal bottom can scroll the first rows into history,
+        // after which cursor-up repaints target the wrong lines and leave fragments.
+        if (painted === 0 && lines.length > 1) {
+            stream.write(`${"\n".repeat(lines.length - 1)}\u001b[${lines.length - 1}A`);
+        }
         const up = painted > 1 ? `\u001b[${painted - 1}A` : "";
         stream.write(`${up}${lines.map((line) => `\u001b[2K${line}`).join("\n")}`);
         painted = lines.length;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fullstackgtm",
-  "version": "0.53.0",
+  "version": "0.53.1",
   "description": "Open-source agentic GTM ops framework: canonical GTM data model, pluggable deterministic audits, reviewable dry-run patch plans, approval-gated write-back with conflict detection, and cross-system entity resolution. HubSpot, Salesforce, and Stripe connectors included.",
   "license": "Apache-2.0",
   "author": "Full Stack GTM LLC <ryan@fullstackgtm.com> (https://fullstackgtm.com)",

package/src/cli/enrich.ts

@@ -20,12 +20,12 @@ import { ACQUIRE_STAGES, composeListeners, createProgressEmitter } from "../prog
 import { createLinkedInProvider, discoverLinkedInProspects } from "../acquireLinkedIn.ts";
 import { clayPeopleFilterRoutes, 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 type { CanonicalGtmSnapshot, CreateRecordPayload } from "../types.ts";
 import { isSpoolPath, readSpoolPath } from "../spoolFiles.ts";
 import { isOptionValue, loadIcp, numericOption, option, readSnapshot, saveRequested } from "./shared.ts";
 import { providerKey } from "./tam.ts";
 import { unknownSubcommandError } from "./suggest.ts";
-import { colorEnabled, createProgressRenderer, createStatusLine, formatBar, formatDuration, paint, type Paint } from "./ui.ts";
+import { box, colorEnabled, createProgressRenderer, createStatusLine, formatBar, formatDuration, paint, truncateToWidth, type Paint } from "./ui.ts";
 import { compactPlan, verbosePlanRequested } from "./planOutput.ts";
 import type { AcquireBudget } from "../acquireMeter.ts";
 
@@ -903,8 +903,8 @@ function acquireGaugeLine(headroom: AcquireRemaining, budget: AcquireBudget, p:
     const painter = fraction >= 0.9 ? p.red : fraction >= 0.7 ? p.yellow : p.green;
     parts.push(`${p.dim(label)} ${painter(formatBar(fraction, 10))} ${fmt(used)}/${fmt(cap)}`);
   };
-  segment("records/day", headroom.records.day, budget.records?.perDay, String);
-  segment("records/mo", headroom.records.month, budget.records?.perMonth, String);
+  segment("applied/day", headroom.records.day, budget.records?.perDay, String);
+  segment("applied/mo", headroom.records.month, budget.records?.perMonth, String);
   segment("spend/day", headroom.spendUsd.day, budget.spend?.perDay, (value) => `$${value.toFixed(2)}`);
   segment("spend/mo", headroom.spendUsd.month, budget.spend?.perMonth, (value) => `$${value.toFixed(2)}`);
   return parts.length > 0 ? parts.join("  ·  ") : null;
@@ -914,12 +914,31 @@ function formatAcquireMeter(headroom: AcquireRemaining, costPerRecord: number):
   const n = (v: number | null) => (v === null ? "∞" : String(v));
   const money = (v: number | null) => (v === null ? "∞" : `$${v.toFixed(2)}`);
   const max = headroom.maxRecords === null ? "unlimited" : `${headroom.maxRecords}`;
-  return (
-    `Acquire meter — creatable now: ${max} lead(s). ` +
-    `Records left: ${n(headroom.records.day)}/day, ${n(headroom.records.month)}/month · ` +
-    `Spend left: ${money(headroom.spendUsd.day)}/day, ${money(headroom.spendUsd.month)}/month ` +
-    `(≈$${costPerRecord.toFixed(2)}/lead).`
-  );
+  return `Apply budget (not market size) — up to ${max} more create(s) may be applied now; ` +
+    `${n(headroom.records.day)} left today, ${n(headroom.records.month)} this month · ` +
+    `spend headroom ${money(headroom.spendUsd.day)}/day, ${money(headroom.spendUsd.month)}/month ` +
+    `(≈$${costPerRecord.toFixed(2)}/lead). Dry runs do not consume this budget.`;
+}
+
+function renderAcquireLeadCards(result: ReturnType<typeof buildAcquirePlan>): string {
+  const p = paint(colorEnabled(process.stdout));
+  const evidence = new Map((result.plan.evidence ?? []).map((item) => [item.id, item]));
+  return result.plan.operations.map((operation, index) => {
+    const payload = operation.afterValue as CreateRecordPayload;
+    const props = payload.properties ?? {};
+    const name = [props.firstname, props.lastname].filter(Boolean).join(" ") || payload.matchValue;
+    const title = props.jobtitle || "Title unavailable";
+    const company = props.company || payload.associateCompanyName || "Company unavailable";
+    let fit: number | undefined;
+    const item = operation.evidenceIds?.[0] ? evidence.get(operation.evidenceIds[0]) : undefined;
+    try { fit = Number((JSON.parse(item?.text ?? "{}") as { fitScore?: unknown }).fitScore); } catch { /* malformed evidence remains display-only */ }
+    const lines = [
+      truncateToWidth(name, 84),
+      truncateToWidth(`${title} · ${company}`, 84),
+      truncateToWidth([payload.associateCompanyDomain, props.hs_linkedin_url].filter(Boolean).join(" · "), 84),
+    ];
+    return box(lines, p, `Lead ${index + 1}/${result.plan.operations.length}${Number.isFinite(fit) ? ` · ${Math.round((fit ?? 0) * 100)}% fit` : ""}`).join("\n");
+  }).join("\n");
 }
 
 function printAcquireOutput(options: {
@@ -959,12 +978,11 @@ function printAcquireOutput(options: {
     console.log(`  Budget     ${gaugeLine ?? meterLine}`);
     if (hostedPlanUrl) console.log(`  Plan       ${hostedPlanUrl}`);
   } else if (planSaved || !saved) {
+    if (result.plan.operations.length > 0) console.log(renderAcquireLeadCards(result));
     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).");
   }
 

package/src/cli/ui.ts

@@ -328,6 +328,12 @@ export function createChecklist(
     // newline on every repaint can scroll the old top row into permanent
     // history when the board sits at the bottom of the terminal, producing
     // apparent duplicate/errored frames in terminal captures.
+    // Reserve the board's rows before the first paint. Writing populated rows
+    // directly at the terminal bottom can scroll the first rows into history,
+    // after which cursor-up repaints target the wrong lines and leave fragments.
+    if (painted === 0 && lines.length > 1) {
+      stream.write(`${"\n".repeat(lines.length - 1)}\u001b[${lines.length - 1}A`);
+    }
     const up = painted > 1 ? `\u001b[${painted - 1}A` : "";
     stream.write(`${up}${lines.map((line) => `\u001b[2K${line}`).join("\n")}`);
     painted = lines.length;