fullstackgtm 0.43.0 → 0.45.0

package/dist/icp.js

@@ -55,46 +55,128 @@ export function icpToExploriumFilters(icp) {
     return f;
 }
 /**
- * Crustdata / LinkedIn seniority vocab. ICP job levels are normalized lowercase;
- * Crustdata expects these exact capitalized strings (verified: "CXO",
- * "Vice President", "Director" appear in Crustdata's docs/examples).
+ * Explorium /v1/businesses filters from the ICP — the COMPANY (account) side, for
+ * sizing the account universe (TAM). Firmographics only, no persona: the count is
+ * of matching companies. Field names differ from /v1/prospects (verified live):
+ * `country_code` (not company_country_code), `company_size` (same employee bands),
+ * `naics_category`. `/v1/businesses` total_results is a real count, capped at
+ * 60,000 (see EXPLORIUM_BUSINESS_COUNT_CAP in the connector).
  */
-const CRUSTDATA_SENIORITY = {
-    cxo: "CXO",
-    "c-suite": "CXO",
-    c_suite: "CXO",
-    founder: "Owner",
-    owner: "Owner",
-    partner: "Partner",
-    vp: "Vice President",
-    "vice president": "Vice President",
-    head: "Director",
-    director: "Director",
-    manager: "Manager",
-    senior: "Senior",
-    entry: "Entry",
-};
+export function icpToExploriumBusinessFilters(icp) {
+    const f = {};
+    if (icp.firmographics.geos?.length)
+        f.country_code = { values: icp.firmographics.geos };
+    if (icp.firmographics.employeeBands?.length)
+        f.company_size = { values: icp.firmographics.employeeBands };
+    if (icp.firmographics.naics?.length)
+        f.naics_category = { values: icp.firmographics.naics };
+    return f;
+}
+/**
+ * Collapse provider-agnostic employee bands ("51-200","10001+") into a single
+ * {min,max} envelope for APIs that take integer bounds (TheirStack). An open
+ * top band ("10001+") leaves max undefined.
+ */
+export function employeeBandsToRange(bands) {
+    if (!bands?.length)
+        return {};
+    let min;
+    let max;
+    let openTop = false;
+    for (const band of bands) {
+        const plus = /^(\d+)\+$/.exec(band.trim());
+        if (plus) {
+            const lo = Number(plus[1]);
+            if (min === undefined || lo < min)
+                min = lo;
+            openTop = true;
+            continue;
+        }
+        const range = /^(\d+)\s*-\s*(\d+)$/.exec(band.trim());
+        if (range) {
+            const lo = Number(range[1]);
+            const hi = Number(range[2]);
+            if (min === undefined || lo < min)
+                min = lo;
+            if (max === undefined || hi > max)
+                max = hi;
+        }
+    }
+    return { min, max: openTop ? undefined : max };
+}
 /**
- * ICP industry keyword → LinkedIn industry names Crustdata filters on. Includes
- * the current LinkedIn-v2 names; for software we send the cluster (dev + IT
- * services + internet) so an OR match isn't overly narrow.
+ * TheirStack company-search filter from the ICP: the technographic targeting that
+ * Explorium can't do. `company_technology_slug_or` is the CRM/MAP buying signal
+ * (firmographics.technologies); employee bands become min/max bounds; geos become
+ * ISO2 codes (uppercased).
+ */
+export function icpToTheirStackFilters(icp) {
+    const f = {};
+    if (icp.firmographics.technologies?.length) {
+        f.company_technology_slug_or = icp.firmographics.technologies.map((t) => t.trim().toLowerCase());
+    }
+    if (icp.firmographics.geos?.length) {
+        f.company_country_code_or = icp.firmographics.geos.map((g) => g.trim().toUpperCase());
+    }
+    const range = employeeBandsToRange(icp.firmographics.employeeBands);
+    if (range.min !== undefined)
+        f.min_employee_count = range.min;
+    if (range.max !== undefined)
+        f.max_employee_count = range.max;
+    return f;
+}
+// NOTE: a CRUSTDATA_SENIORITY vocab table lived here until 2026-07-02 — the
+// `current_seniority_levels` filter is broken upstream (see the live findings
+// on icpToCrustdataFilters below), so job levels are no longer sent to the
+// provider at all. Resurrect the table from git history if pipe0 fixes it.
+/**
+ * ICP industry keyword → LinkedIn industry names Crustdata filters on.
+ *
+ * LinkedIn renamed its industry taxonomy (v1 → v2, ~2022), and data vendors
+ * normalize to one generation or the other. Sending ONLY the v2 names risks a
+ * zero-match when Crustdata stores v1 (and vice-versa) — observed live: a RevOps
+ * ICP whose only firmographic constraint was the v2 names returned 0 even though
+ * the title-only search returned plenty. So each cluster sends BOTH generations
+ * (OR-matched within the field): v2 ("Software Development", "IT Services and IT
+ * Consulting", "Technology, Information and Internet") AND v1 ("Computer
+ * Software", "Information Technology & Services", "Internet").
  */
 const CRUSTDATA_INDUSTRY = {
-    software: ["Software Development", "Information Technology and Services", "Internet"],
-    saas: ["Software Development", "Information Technology and Services"],
-    "information technology & services": ["Information Technology and Services"],
-    "information technology and services": ["Information Technology and Services"],
-    internet: ["Internet"],
+    software: [
+        "Software Development",
+        "Computer Software",
+        "IT Services and IT Consulting",
+        "Information Technology & Services",
+        "Information Technology and Services",
+        "Technology, Information and Internet",
+        "Internet",
+    ],
+    saas: ["Software Development", "Computer Software", "IT Services and IT Consulting", "Information Technology & Services"],
+    "information technology & services": ["Information Technology & Services", "IT Services and IT Consulting"],
+    "information technology and services": ["Information Technology & Services", "IT Services and IT Consulting"],
+    internet: ["Internet", "Technology, Information and Internet"],
     fintech: ["Financial Services"],
     "financial services": ["Financial Services"],
 };
 /**
  * pipe0 Crustdata people-search config.filters from the ICP. `current_job_titles`
  * matches real LinkedIn title strings (case-sensitive), so keywords are Title
- * Cased. Seniority + industry are mapped to Crustdata's controlled vocab via the
- * tables above. NOTE: the exact pipe0→Crustdata value set could not be re-run
- * live (pipe0 credits were exhausted) — validate when credits refill; fit
- * scoring is the safety net for persona precision regardless.
+ * Cased. Industry is mapped to Crustdata's controlled vocab via the table above.
+ *
+ * LIVE FINDINGS (2026-06-26, re-confirmed 2026-07-02 with fresh credits):
+ * `current_job_titles` works; `current_title` is rejected (422). The culprit
+ * that zeroed the full ICP filter is `current_seniority_levels`: ANY non-empty
+ * `include` returns 0 results through pipe0's people:profiles:crustdata@1 —
+ * including Crustdata's own documented values ("CXO", "Director",
+ * "Vice President"), lowercase, and SNAKE_CASE variants — while the identical
+ * search without it returns results. (An array instead of the
+ * {include, exclude} object is a 422, so the shape was right; the filter is
+ * broken upstream.) So job levels are NOT sent to the provider: persona
+ * seniority is enforced by fit scoring (scoreProspectAgainstIcp weights
+ * jobLevels), which was always the precision backstop. `locations` and
+ * `current_employers_linkedin_industries` (both-taxonomy hedge) are live-
+ * verified working in combination with titles. Note fit-scoring backs up
+ * PERSONA precision but NOT industry, so the industry filter is load-bearing.
  */
 export function icpToCrustdataFilters(icp) {
     const f = {};
@@ -103,11 +185,6 @@ export function icpToCrustdataFilters(icp) {
     if (icp.firmographics.geos?.length) {
         f.locations = icp.firmographics.geos.map((g) => COUNTRY_NAMES[g.toLowerCase()] ?? g);
     }
-    if (icp.persona.jobLevels?.length) {
-        const include = [...new Set(icp.persona.jobLevels.map((l) => CRUSTDATA_SENIORITY[l.toLowerCase()]).filter(Boolean))];
-        if (include.length)
-            f.current_seniority_levels = { include, exclude: [] };
-    }
     if (icp.firmographics.industries?.length) {
         const inds = [
             ...new Set(icp.firmographics.industries.flatMap((i) => CRUSTDATA_INDUSTRY[i.toLowerCase()] ?? [titleCase(i)])),

package/dist/index.d.ts

@@ -14,6 +14,7 @@ export { activeProfile, credentialsDir, credentialsPath, DEFAULT_PROFILE, delete
 export { generateDemoSnapshot, type DemoSnapshotOptions } from "./demo.ts";
 export { buildEnrichPlan, createFileEnrichRunStore, DEFAULT_STALE_DAYS, ENRICH_CONFIG_FILE_NAME, enrichRunId, inferIngestObjectType, ingestKeyValue, latestStamps, loadEnrichConfig, matchSourceRecord, parseCsv, parseEnrichConfig, resolveCrmField, selectStaleWork, sourceValueAt, stagedSourceRecords, staleDaysFor, type BuildEnrichPlanOptions, type EnrichAmbiguity, type EnrichConfig, type EnrichCounts, type EnrichFieldConfig, type EnrichMatchConfig, type EnrichMode, type EnrichObjectType, type EnrichPlanResult, type EnrichRun, type EnrichRunStore, type EnrichSourceConfig, type EnrichSourceRecord, type EnrichStamp, type EnrichWorkItem, type MatchOutcome, } from "./enrich.ts";
 export { scaffoldWorkspace, starterEnrichConfig, starterIcp, starterPlaybook, type InitProvider, type InitSource, type ScaffoldFile, type ScaffoldOptions, } from "./init.ts";
+export { appendCoverage, classifyAccount, classifyCoverage, computeCoverage, coverageCountsFromSnapshot, coveredAccounts, coverageToText, crmCheckableCriteria, deriveAcvFromClosedWon, deriveBuyersPerAccount, estimateTam, loadTamModel, projectEta, readCoverageTimeline, saveTamModel, tamDir, tamReportToMarkdown, type AccountTamClass, type AcvBasis, type DerivedAcv, type DerivedBuyers, type EstimateTamInput, type TamClassified, type TamCoverage, type TamCoverageCounts, type TamCrossCheck, type TamEta, type TamModel, type TamTargeting, type TamUniverse, } from "./tam.ts";
 export { apolloPullKeysForAppend, apolloPullKeysForRefresh, createApolloClient, pullApolloRecords, type ApolloClient, type ApolloClientOptions, type ApolloPullKey, type ApolloPullResult, } from "./enrichApollo.ts";
 export { diffFindings, diffSnapshots, diffToMarkdown, type CollectionDiff, type FieldChange, type FindingsDrift, type RecordChange, type SnapshotDiff, } from "./diff.ts";
 export { mergeSnapshots, type MergeConflict, type MergeMatch, type MergeReport, type MergeSuggestion, } from "./merge.ts";

package/dist/index.js

@@ -14,6 +14,7 @@ export { activeProfile, credentialsDir, credentialsPath, DEFAULT_PROFILE, delete
 export { generateDemoSnapshot } from "./demo.js";
 export { buildEnrichPlan, createFileEnrichRunStore, DEFAULT_STALE_DAYS, ENRICH_CONFIG_FILE_NAME, enrichRunId, inferIngestObjectType, ingestKeyValue, latestStamps, loadEnrichConfig, matchSourceRecord, parseCsv, parseEnrichConfig, resolveCrmField, selectStaleWork, sourceValueAt, stagedSourceRecords, staleDaysFor, } from "./enrich.js";
 export { scaffoldWorkspace, starterEnrichConfig, starterIcp, starterPlaybook, } from "./init.js";
+export { appendCoverage, classifyAccount, classifyCoverage, computeCoverage, coverageCountsFromSnapshot, coveredAccounts, coverageToText, crmCheckableCriteria, deriveAcvFromClosedWon, deriveBuyersPerAccount, estimateTam, loadTamModel, projectEta, readCoverageTimeline, saveTamModel, tamDir, tamReportToMarkdown, } from "./tam.js";
 export { apolloPullKeysForAppend, apolloPullKeysForRefresh, createApolloClient, pullApolloRecords, } from "./enrichApollo.js";
 export { diffFindings, diffSnapshots, diffToMarkdown, } from "./diff.js";
 export { mergeSnapshots, } from "./merge.js";

package/dist/init.js

@@ -28,6 +28,9 @@ export function starterIcp() {
             industries: ["software", "saas"],
             employeeBands: ["51-200", "201-500", "501-1000"],
             geos: ["us"],
+            // Technographic targeting (the real RevOps signal): companies that USE a
+            // CRM/MAP. Drives `tam estimate|accounts --source theirstack`.
+            technologies: ["salesforce", "hubspot", "pipedrive"],
         },
         persona: {
             jobLevels: ["vp", "director", "manager"],

package/dist/judge.d.ts

@@ -230,6 +230,8 @@ export declare function judgeSignals(opts: {
     promptTemplate?: string;
     llm?: LlmCallOptions;
     now?: Date;
+    /** Per-account progress (presentation only — a throwing callback never fails the run). */
+    onAccount?: (done: number, total: number, domain: string) => void;
 }): Promise<JudgeDecision[]>;
 export declare function judgeDir(baseDir?: string): string;
 export interface JudgeStore {

package/dist/judge.js

@@ -438,6 +438,12 @@ export async function judgeSignals(opts) {
     }
     const decisions = [];
     for (const [domain, signals] of byAccount) {
+        try {
+            opts.onAccount?.(decisions.length, byAccount.size, domain);
+        }
+        catch {
+            // progress is presentation-only
+        }
         // Memory + fit stay gated on --with-history (scoring semantics unchanged).
         const recentlyTouched = opts.withHistory && opts.snapshot ? accountRecentlyTouched(domain, opts.snapshot, now) : false;
         const bestContact = opts.withHistory && opts.icp && opts.snapshot ? bestContactForAccount(domain, opts.snapshot) : undefined;

package/dist/judgeEval.d.ts

@@ -110,6 +110,13 @@ export declare function defaultJudgeFn(opts?: {
     icp?: Icp;
     now?: Date;
 }): EvalJudgeFn;
+/**
+ * The default golden set's clock. Every `firstSeen` below is relative to this
+ * instant, so grading MUST pin `now: new Date(DEFAULT_GOLDEN_NOW_ISO)` —
+ * grading against wall time lets freshness decay rot the "fresh → send" rows,
+ * and the gate starts failing on a calendar date instead of a code change.
+ */
+export declare const DEFAULT_GOLDEN_NOW_ISO = "2026-06-23T12:00:00.000Z";
 /**
  * A starter labeled set covering the four rubric corners, so `icp eval --golden
  * default` runs offline and the deterministic baseline passes it (>= the default

package/dist/judgeEval.js

@@ -85,7 +85,14 @@ export function defaultJudgeFn(opts = {}) {
 }
 // ---------------------------------------------------------------------------
 // The default golden set (ships inline so `icp eval --golden default` is free)
-const GOLD_NOW_ISO = "2026-06-23T12:00:00.000Z";
+/**
+ * The default golden set's clock. Every `firstSeen` below is relative to this
+ * instant, so grading MUST pin `now: new Date(DEFAULT_GOLDEN_NOW_ISO)` —
+ * grading against wall time lets freshness decay rot the "fresh → send" rows,
+ * and the gate starts failing on a calendar date instead of a code change.
+ */
+export const DEFAULT_GOLDEN_NOW_ISO = "2026-06-23T12:00:00.000Z";
+const GOLD_NOW_ISO = DEFAULT_GOLDEN_NOW_ISO;
 function goldSignal(over) {
     const domain = normalizeAccountDomain(over.accountDomain);
     return {

package/dist/marketClassify.d.ts

@@ -11,6 +11,8 @@ export type ClassifyMarketOptions = {
     /** Captures directory override (tests); defaults to the profile market home. */
     capturesDir?: string;
     now?: () => Date;
+    /** Per-vendor progress (presentation only — a throwing callback never fails the run). */
+    onVendor?: (done: number, total: number, vendorId: string) => void;
 };
 export type ClassifyMarketResult = {
     set: ObservationSet;

package/dist/marketClassify.js

@@ -92,7 +92,13 @@ export async function classifyMarket(config, options) {
     const claimIds = config.claims.map((claim) => claim.id);
     const observations = [];
     const retriedVendorIds = [];
-    for (const vendorId of vendorIds) {
+    for (const [vendorIndex, vendorId] of vendorIds.entries()) {
+        try {
+            options.onVendor?.(vendorIndex, vendorIds.length, vendorId);
+        }
+        catch {
+            // progress is presentation-only
+        }
         const vendor = config.vendors.find((candidate) => candidate.id === vendorId);
         if (!vendor)
             throw new Error(`Unknown vendor "${vendorId}"`);

package/dist/mcp-bin.js

@@ -7,8 +7,8 @@ const MISSING_PEER_HELP = `The MCP server needs the optional peer dependencies @
 In a project:
   npm install fullstackgtm @modelcontextprotocol/sdk zod
 
-Zero-install:
-  npx -p fullstackgtm -p @modelcontextprotocol/sdk -p zod fullstackgtm-mcp`;
+Zero-install (the fullstackgtm-mcp wrapper package bundles the peers):
+  npx -y fullstackgtm-mcp`;
 function isMissingPeerError(error) {
     if (!(error instanceof Error))
         return false;