@warpgogol/werkstatt-shared 0.12.0 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/werkstatt-shared",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "private": false,
   "type": "module",
   "engines": {
@@ -66,22 +66,6 @@
       "types": "./src/integration/index.ts",
       "default": "./src/integration/index.ts"
     },
-    "./integration-adapter-supabase-crm": {
-      "types": "./src/integration-adapter-supabase-crm/index.ts",
-      "default": "./src/integration-adapter-supabase-crm/index.ts"
-    },
-    "./integration-adapter-supabase-crm/tenant-registry": {
-      "types": "./src/integration-adapter-supabase-crm/tenant-registry.ts",
-      "default": "./src/integration-adapter-supabase-crm/tenant-registry.ts"
-    },
-    "./integration-adapter-supabase-crm/worker": {
-      "types": "./src/integration-adapter-supabase-crm/worker.ts",
-      "default": "./src/integration-adapter-supabase-crm/worker.ts"
-    },
-    "./integration/crm-buffer": {
-      "types": "./src/integration/crm-buffer.ts",
-      "default": "./src/integration/crm-buffer.ts"
-    },
     "./integration/port": {
       "types": "./src/integration/port.ts",
       "default": "./src/integration/port.ts"
@@ -414,30 +398,6 @@
       "types": "./src/integration/vitest.config.ts",
       "default": "./src/integration/vitest.config.ts"
     },
-    "./integration-adapter-supabase-crm/adapter": {
-      "types": "./src/integration-adapter-supabase-crm/adapter.ts",
-      "default": "./src/integration-adapter-supabase-crm/adapter.ts"
-    },
-    "./integration-adapter-supabase-crm/client": {
-      "types": "./src/integration-adapter-supabase-crm/client.ts",
-      "default": "./src/integration-adapter-supabase-crm/client.ts"
-    },
-    "./integration-adapter-supabase-crm/index": {
-      "types": "./src/integration-adapter-supabase-crm/index.ts",
-      "default": "./src/integration-adapter-supabase-crm/index.ts"
-    },
-    "./integration-adapter-supabase-crm/pipedrive-sync-target": {
-      "types": "./src/integration-adapter-supabase-crm/pipedrive-sync-target.ts",
-      "default": "./src/integration-adapter-supabase-crm/pipedrive-sync-target.ts"
-    },
-    "./integration-adapter-supabase-crm/supabase-rest": {
-      "types": "./src/integration-adapter-supabase-crm/supabase-rest.ts",
-      "default": "./src/integration-adapter-supabase-crm/supabase-rest.ts"
-    },
-    "./integration-adapter-supabase-crm/vitest.config": {
-      "types": "./src/integration-adapter-supabase-crm/vitest.config.ts",
-      "default": "./src/integration-adapter-supabase-crm/vitest.config.ts"
-    },
     "./observability/conventions": {
       "types": "./src/observability/conventions.ts",
       "default": "./src/observability/conventions.ts"
@@ -670,6 +630,10 @@
       "types": "./src/share/agent/proof.ts",
       "default": "./src/share/agent/proof.ts"
     },
+    "./share/agent/search": {
+      "types": "./src/share/agent/search.ts",
+      "default": "./src/share/agent/search.ts"
+    },
     "./share/content/entity-id": {
       "types": "./src/share/content/entity-id.ts",
       "default": "./src/share/content/entity-id.ts"
@@ -1126,22 +1090,6 @@
       "types": "./src/integration/tests/sharding.test.ts",
       "default": "./src/integration/tests/sharding.test.ts"
     },
-    "./integration-adapter-supabase-crm/tests/change-balance.pbt.test": {
-      "types": "./src/integration-adapter-supabase-crm/tests/change-balance.pbt.test.ts",
-      "default": "./src/integration-adapter-supabase-crm/tests/change-balance.pbt.test.ts"
-    },
-    "./integration-adapter-supabase-crm/tests/funnel-persistence.test": {
-      "types": "./src/integration-adapter-supabase-crm/tests/funnel-persistence.test.ts",
-      "default": "./src/integration-adapter-supabase-crm/tests/funnel-persistence.test.ts"
-    },
-    "./integration-adapter-supabase-crm/tests/lifecycle-sync.test": {
-      "types": "./src/integration-adapter-supabase-crm/tests/lifecycle-sync.test.ts",
-      "default": "./src/integration-adapter-supabase-crm/tests/lifecycle-sync.test.ts"
-    },
-    "./integration-adapter-supabase-crm/tests/stage-map.test": {
-      "types": "./src/integration-adapter-supabase-crm/tests/stage-map.test.ts",
-      "default": "./src/integration-adapter-supabase-crm/tests/stage-map.test.ts"
-    },
     "./observability/tests/conventions.test": {
       "types": "./src/observability/tests/conventions.test.ts",
       "default": "./src/observability/tests/conventions.test.ts"
@@ -1349,6 +1297,10 @@
     "./share/scripts": {
       "types": "./src/share/scripts/index.ts",
       "default": "./src/share/scripts/index.ts"
+    },
+    "./integration/lagebild-ingress": {
+      "types": "./src/integration/lagebild-ingress.ts",
+      "default": "./src/integration/lagebild-ingress.ts"
     }
   },
   "scripts": {
@@ -1368,18 +1320,18 @@
   ],
   "dependencies": {
     "@lordicon/element": "^2.3.1",
+    "@sindresorhus/slugify": "^3.0.0",
     "@warpgogol/werkstatt-engine": "*",
     "ajv": "^8.20.0",
     "bs58": "^6.0.0",
-    "@sindresorhus/slugify": "^3.0.0",
     "cyrillic-to-translit-js": "^3.2.1",
     "expr-eval": "^2.0.2",
     "github-slugger": "^2.0.0",
-    "hls.js": "^1.6.16",
-    "lenis": "^1.3.25",
+    "gray-matter": "^4.0.3",
+    "hls.js": "^1.7.1",
+    "lenis": "^1.3.26",
     "plyr": "^3.8.4",
     "qrcode": "^1.5.4",
-    "gray-matter": "^4.0.3",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
@@ -1387,18 +1339,18 @@
     "@syrokomskyi/axiom-study": "link:../../../pipelines/packages/axiom/axiom-study"
   },
   "devDependencies": {
-    "@astrojs/markdown-remark": "^7.0.0",
-    "@cloudflare/workers-types": "^5.20260801.1",
-    "@types/node": "^24.0.0",
+    "@astrojs/markdown-remark": "^7.2.4",
+    "@cloudflare/workers-types": "^5.20260823.1",
+    "@types/node": "^26.2.0",
+    "@types/qrcode": "^1.5.6",
     "@warpgogol/werkstatt-engine": "*",
-    "astro": "^7.2.0",
-    "eslint": "^10.8.0",
+    "astro": "^7.2.4",
+    "eslint": "^10.9.0",
     "fast-check": "^4.9.0",
     "gsap": "^3.15.0",
-    "@types/qrcode": "^1.5.5",
     "typescript": "^6.0.3",
-    "typescript-eslint": "8.65.0",
-    "vitest": "^4.1.10"
+    "typescript-eslint": "8.68.0",
+    "vitest": "^4.1.11"
   },
   "packageManager": "pnpm@11.10.0"
 }

package/src/integration/funnel.ts

@@ -8,12 +8,13 @@ types + constants + pure helpers — no I/O, no astro:env, no vendor SDK.</purpo
 <non-goals>
   <item>Do not let a chat vendor own the graph — UChat requests transitions; this module is the authority.</item>
   <item>Do not reference Make.com or carry any legacy UChat goto/stage string as architecture.</item>
-  <item>Do not import astro:env, a Supabase SDK, or a vendor SDK — callers inject persistence.</item>
+  <item>Do not import astro:env or a vendor SDK — callers inject persistence.</item>
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0188 Phase 2 (contract): initial funnel stage/event/transition contracts.</item>
   <item>RFC-0219: add FUNNEL_SYSTEM_TRIGGERS, FunnelTransitionTrigger, FUNNEL_TRANSITION_TRIGGERS — trigger overlay for the state-chart generator.</item>
+  <item>Cleanup: move BUFFER_DEAL_STAGES, FUNNEL_STAGE_TO_BUFFER_STAGE, bridgeFunnelStage, SYNC_OUTBOX_STATUSES, SYNC_OUTBOX_OPS from deleted crm-buffer.ts into this module.</item>
 </CHANGE_SUMMARY>
 */
 
@@ -377,3 +378,79 @@ export function scanForMakeComReferences(text: string): Array<{ line: number; ma
   });
   return hits;
 }
+
+// ---------------------------------------------------------------------------
+// Generic deal stage bridge (formerly in crm-buffer.ts — RFC-0188 Phase 3)
+// ---------------------------------------------------------------------------
+
+/**
+ * Closed catalog of deal funnel stages. Order matters — later stages come after
+ * earlier ones. Mirrors the standard Pipedrive pipeline stages.
+ */
+export const BUFFER_DEAL_STAGES = [
+  "new",
+  "contacted",
+  "qualified",
+  "proposal",
+  "negotiation",
+  "won",
+  "lost",
+] as const;
+
+export type BufferDealStage = (typeof BUFFER_DEAL_STAGES)[number];
+
+/**
+ * RFC-0188 keeps the precise, platform-owned VisitorFunnelStage on the deal
+ * (`funnel_stage`) while bridging it down to the generic BufferDealStage the
+ * Pipedrive sync worker already understands. Exhaustive by construction.
+ */
+export const FUNNEL_STAGE_TO_BUFFER_STAGE: Record<VisitorFunnelStage, BufferDealStage> = {
+  new_session: "new",
+  privacy_acknowledged: "new",
+  intent_selected: "contacted",
+  organization_selected: "contacted",
+  qualification_priority: "qualified",
+  qualification_company: "qualified",
+  qualification_service: "qualified",
+  qualification_region: "qualified",
+  offer_presented: "proposal",
+  payment_pending: "proposal",
+  payment_confirmed: "negotiation",
+  start_choice_pending: "negotiation",
+  start_deferred: "negotiation",
+  buyer_type_pending: "negotiation",
+  b2b_start_consent_pending: "negotiation",
+  b2c_withdrawal_consent_pending: "negotiation",
+  start_approved: "negotiation",
+  legal_data_requested: "negotiation",
+  materials_requested: "negotiation",
+  production_ready: "negotiation",
+  change_balance_checked: "contacted",
+  change_payment_pending: "proposal",
+  change_description_requested: "negotiation",
+  operator_review: "negotiation",
+  won: "won",
+  lost: "lost",
+};
+
+/** Bridge a canonical funnel stage down to the generic stage the sync worker maps. */
+export function bridgeFunnelStage(stage: VisitorFunnelStage): BufferDealStage {
+  return FUNNEL_STAGE_TO_BUFFER_STAGE[stage];
+}
+
+// ---------------------------------------------------------------------------
+// Sync outbox statuses (formerly in crm-buffer.ts)
+// ---------------------------------------------------------------------------
+
+export const SYNC_OUTBOX_STATUSES = ["pending", "processing", "done", "failed", "dead"] as const;
+export type SyncOutboxStatus = (typeof SYNC_OUTBOX_STATUSES)[number];
+
+export const SYNC_OUTBOX_OPS = [
+  "upsert_contact",
+  "upsert_deal",
+  "update_deal_stage",
+  "upsert_organization",
+  "upsert_subscription",
+  "upsert_invoice",
+] as const;
+export type SyncOutboxOp = (typeof SYNC_OUTBOX_OPS)[number];

package/src/integration/index.ts

@@ -1,10 +1,10 @@
 /*
 <MODULE_CONTRACT>
 <purpose>
-  RFC-0168: Integration Port barrel. Re-exports types from port.ts, crm-buffer.ts,
+  RFC-0168: Integration Port barrel. Re-exports types from port.ts,
   funnel.ts, lifecycle.ts, sharding.ts, dispatch.ts, qstash.ts, and runtime
   orchestration (registries + fan-out) from orchestration.ts. Type-only consumers
-  (agent-gate, supabase-crm tests) import from `./port-barrel.ts` (`@warpgogol/werkstatt-shared/share/integration/port`)
+  import from `./port-barrel.ts` (`@warpgogol/werkstatt-shared/share/integration/port`)
   to avoid transitively pulling in adapter implementations; consumers needing
   runtime logic import from here — the orchestration module is re-exported transparently.
 </purpose>
@@ -54,3 +54,20 @@ export {
   consumeIntegrationBatch,
   upsertLead,
 } from "./orchestration.ts";
+
+// Lagebild ingress client (POST /v1/ingress — WebsiteIngress contract v1)
+export {
+  submitIngress,
+  buildIdempotencyKey,
+  LAGEBILD_INGRESS_CONTRACT_VERSION,
+  type LagebildIngressConfig,
+  type IngressSubmitInput,
+  type WebsiteIngressPayload,
+  type IngressResult,
+  type IngressInteractionKind,
+  type IdentityClaimType,
+  type IdentityClaim,
+  type IngressOrigin,
+  type ExplicitPolicyAssertion,
+  type PolicyAssertionKind,
+} from "./lagebild-ingress.ts";

package/src/integration/lagebild-ingress.ts

@@ -0,0 +1,169 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Thin HTTP client for Lagebild API POST /v1/ingress. Werkstatt does NOT
+recreate Lagebild semantics locally — it only calls the public WebsiteIngress v1
+contract. The client builds the payload from form data, sends it with a service
+principal API key, and returns the acceptance result. Replay protection is
+built-in via a stable idempotency_key (derived from submission_id + tenant).</purpose>
+<non-goals>
+  <item>Do not implement Lagebild domain logic — only the HTTP call.</item>
+  <item>Do not persist anything locally — the API owns canonical state.</item>
+  <item>Do not retry on non-2xx — the caller decides retry strategy.</item>
+</non-goals>
+</MODULE_CONTRACT>
+*/
+
+export const LAGEBILD_INGRESS_CONTRACT_VERSION = 1 as const;
+
+export type IngressInteractionKind =
+  | "inquiry"
+  | "contact_message"
+  | "callback_request"
+  | "appointment_request"
+  | "other";
+
+export type IdentityClaimType =
+  | "person_name"
+  | "organization_name"
+  | "email"
+  | "phone"
+  | "website"
+  | "postal_address"
+  | "other";
+
+export interface IdentityClaim {
+  readonly claim_type: IdentityClaimType;
+  readonly value: string;
+  readonly label?: string | null;
+}
+
+export interface IngressOrigin {
+  readonly page_uri?: string | null;
+  readonly referrer_uri?: string | null;
+  readonly locale?: string | null;
+}
+
+export type PolicyAssertionKind = "consent" | "objection" | "preference";
+
+export interface ExplicitPolicyAssertion {
+  readonly kind: PolicyAssertionKind;
+  readonly purpose: string;
+  readonly channel?: string | null;
+  readonly value: boolean;
+  readonly statement_ref?: string | null;
+}
+
+export interface WebsiteIngressPayload {
+  readonly contract_version: typeof LAGEBILD_INGRESS_CONTRACT_VERSION;
+  readonly tenant_id: string;
+  readonly source_system_id: string;
+  readonly submission_id: string;
+  readonly idempotency_key: string;
+  readonly occurred_at: string;
+  readonly interaction_kind: IngressInteractionKind;
+  readonly identity_claims: readonly IdentityClaim[];
+  readonly message?: string | null;
+  readonly origin?: IngressOrigin;
+  readonly explicit_policy_assertions?: readonly ExplicitPolicyAssertion[];
+  readonly correlation_id?: string | null;
+}
+
+export interface IngressResult {
+  readonly submission_id: string | null;
+  readonly accepted: boolean;
+  readonly is_replay: boolean;
+  readonly rejection_class?: string | null;
+  readonly correlation_id?: string | null;
+}
+
+export interface LagebildIngressConfig {
+  readonly apiUrl: string;
+  readonly apiKey: string;
+  readonly tenantId: string;
+  readonly sourceSystemId: string;
+}
+
+export interface IngressSubmitInput {
+  readonly submissionId: string;
+  readonly idempotencyKey: string;
+  readonly interactionKind: IngressInteractionKind;
+  readonly identityClaims: readonly IdentityClaim[];
+  readonly message?: string | null;
+  readonly origin?: IngressOrigin;
+  readonly explicitPolicyAssertions?: readonly ExplicitPolicyAssertion[];
+  readonly correlationId?: string | null;
+}
+
+/**
+ * Submit a website ingress event to the Lagebild API.
+ * Returns the acceptance result. Does not throw on non-2xx — returns
+ * a result with accepted=false so the caller can decide retry strategy.
+ */
+export async function submitIngress(
+  config: LagebildIngressConfig,
+  input: IngressSubmitInput,
+): Promise<IngressResult> {
+  const payload: WebsiteIngressPayload = {
+    contract_version: LAGEBILD_INGRESS_CONTRACT_VERSION,
+    tenant_id: config.tenantId,
+    source_system_id: config.sourceSystemId,
+    submission_id: input.submissionId,
+    idempotency_key: input.idempotencyKey,
+    occurred_at: new Date().toISOString(),
+    interaction_kind: input.interactionKind,
+    identity_claims: input.identityClaims,
+    ...(input.message != null ? { message: input.message } : {}),
+    ...(input.origin != null ? { origin: input.origin } : {}),
+    ...(input.explicitPolicyAssertions != null
+      ? { explicit_policy_assertions: input.explicitPolicyAssertions }
+      : {}),
+    ...(input.correlationId != null ? { correlation_id: input.correlationId } : {}),
+  };
+
+  const url = config.apiUrl.replace(/\/$/, "") + "/v1/ingress";
+
+  let response: Response;
+  try {
+    response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: "Bearer " + config.apiKey,
+      },
+      body: JSON.stringify(payload),
+    });
+  } catch {
+    return {
+      submission_id: input.submissionId,
+      accepted: false,
+      is_replay: false,
+      rejection_class: "network_error",
+      correlation_id: input.correlationId ?? null,
+    };
+  }
+
+  let body: unknown;
+  try {
+    body = await response.json();
+  } catch {
+    body = {};
+  }
+
+  const result = body as Partial<IngressResult>;
+  return {
+    submission_id: result.submission_id ?? input.submissionId,
+    accepted: result.accepted ?? response.ok,
+    is_replay: result.is_replay ?? false,
+    rejection_class: result.rejection_class ?? null,
+    correlation_id: result.correlation_id ?? input.correlationId ?? null,
+  };
+}
+
+/**
+ * Build a stable idempotency key from tenant + submission ID.
+ * This ensures retries within the same submission are deduplicated
+ * by the Lagebild API.
+ */
+export function buildIdempotencyKey(tenantId: string, submissionId: string): string {
+  return tenantId + ":" + submissionId;
+}

package/src/integration/orchestration.ts

@@ -31,8 +31,9 @@ import type {
   IntegrationSecrets,
   Lead,
   LeadMessage,
+  EXECUTION_MODES,
 } from "./port.ts";
-import { DESTINATION_KINDS, EXECUTION_MODES, eventToLeadMessage } from "./port.ts";
+import { DESTINATION_KINDS, eventToLeadMessage } from "./port.ts";
 import { LifecycleEventPayloadSchema } from "./lifecycle.ts";
 import { z } from "zod";
 
@@ -171,20 +172,14 @@ export const DESTINATION_ADAPTERS: readonly DestinationAdapter[] = [pipedriveDes
  * `extraAdapters`; the validator checks vendor + secrets against these catalogs.
  */
 export const EXTERNAL_DESTINATION_VENDORS: Readonly<Record<DestinationKind, readonly string[]>> = {
-  crm: ["supabase-buffer"],
+  crm: [],
   calendar: [],
   email: [],
   scheduler: [],
 };
 
 /** Per `(kind, vendor)` → required secret names for externally-implemented adapters. */
-export const EXTERNAL_DESTINATION_SECRETS: Readonly<Record<string, readonly string[]>> = {
-  "crm:supabase-buffer": [
-    "SUPABASE_BUFFER_URL",
-    "SUPABASE_BUFFER_SERVICE_KEY",
-    "SUPABASE_BUFFER_TENANT_ID",
-  ],
-};
+export const EXTERNAL_DESTINATION_SECRETS: Readonly<Record<string, readonly string[]>> = {};
 
 /** Closed per-kind vendor catalog, derived from the registry + external vendors (RFC-0176/0186). */
 export const DESTINATION_VENDORS_BY_KIND: Readonly<Record<DestinationKind, readonly string[]>> =
@@ -318,8 +313,7 @@ export function authenticateInbound(headers: Headers, secret: string | undefined
  * supplied. `seen` is the optional dedup set (RFC-0176).
  *
  * `extraAdapters` lets a specific site's delivery callback inject additional
- * DestinationAdapters (e.g. supabaseBufferDestinationAdapter) without modifying
- * the closed shared registry. They are self-enabling (skip if secrets absent).
+ * DestinationAdapters without modifying the closed shared registry. They are self-enabling (skip if secrets absent).
  */
 export function routeEventToReady(
   event: IntegrationEvent,
@@ -350,8 +344,8 @@ export interface DeliverEventResult {
  * destinations (CRM), with the client's own tokens. Email is NOT here — it is sent via
  * Cloudflare Email Routing (send_email binding) in the callback route. `seen` dedups the
  * destination side on redelivery. Best-effort per sink; the caller decides ack vs retry.
- * `extraAdapters` lets a specific site inject additional DestinationAdapters (e.g.
- * supabaseBufferDestinationAdapter) without modifying the closed shared registry.
+ * `extraAdapters` lets a specific site inject additional DestinationAdapters
+ * without modifying the closed shared registry.
  */
 export async function deliverEvent(
   event: IntegrationEvent,

package/src/integration/port-barrel.ts

@@ -2,7 +2,7 @@
 <MODULE_CONTRACT>
 <purpose>
   RFC-0168: Integration Port barrel — types and pure contracts only. Re-exports from
-  port.ts, crm-buffer.ts, funnel.ts, lifecycle.ts, sharding.ts, dispatch.ts, and qstash.ts.
+  port.ts, funnel.ts, lifecycle.ts, sharding.ts, dispatch.ts, and qstash.ts.
   Type-only consumers import from here to avoid transitively pulling in adapter
   implementations (orchestration.ts → adapters.ts).
 </purpose>
@@ -22,33 +22,6 @@ export type { IntegrationEvent, DestinationAdapter } from "./port.ts";
 export { DESTINATION_KINDS, EXECUTION_MODES, eventToLeadMessage, eventToLead } from "./port.ts";
 export type { DestinationKind, ExecutionMode } from "./port.ts";
 
-export type {
-  BufferContact,
-  BufferOrganization,
-  BufferDeal,
-  BufferStageTransition,
-  BufferFunnelEvent,
-  BufferConsentEvent,
-  BufferSubscription,
-  BufferInvoice,
-  BufferUpsertResult,
-  OutboxWriteResult,
-  CrmBufferWriter,
-  CrmBufferReader,
-  CrmBufferClient,
-  DealPipedriveIdPatch,
-  SyncOutboxRow,
-} from "./crm-buffer.ts";
-export {
-  BUFFER_DEAL_STAGES,
-  FUNNEL_STAGE_TO_BUFFER_STAGE,
-  bridgeFunnelStage,
-  isFunnelStage,
-  SYNC_OUTBOX_STATUSES,
-  SYNC_OUTBOX_OPS,
-} from "./crm-buffer.ts";
-export type { BufferDealStage, SyncOutboxStatus, SyncOutboxOp } from "./crm-buffer.ts";
-
 export type {
   VisitorFunnelEventPayload,
   FunnelSystemTrigger,
@@ -65,6 +38,11 @@ export {
   VISITOR_BUYER_TYPES,
   FUNNEL_TRANSITIONS,
   isValidFunnelStage,
+  BUFFER_DEAL_STAGES,
+  FUNNEL_STAGE_TO_BUFFER_STAGE,
+  bridgeFunnelStage,
+  SYNC_OUTBOX_STATUSES,
+  SYNC_OUTBOX_OPS,
   canTransition,
   nextStages,
   reachableStages,
@@ -79,6 +57,9 @@ export type {
   VisitorFunnelIntent,
   VisitorFunnelSource,
   VisitorBuyerType,
+  BufferDealStage,
+  SyncOutboxStatus,
+  SyncOutboxOp,
 } from "./funnel.ts";
 
 export type { LifecycleEventPayload } from "./lifecycle.ts";

package/src/integration/tests/funnel-bridge.test.ts

@@ -17,9 +17,9 @@ import {
   BUFFER_DEAL_STAGES,
   FUNNEL_STAGE_TO_BUFFER_STAGE,
   bridgeFunnelStage,
-  isFunnelStage,
-} from "../crm-buffer.ts";
-import { VISITOR_FUNNEL_STAGES } from "../funnel.ts";
+  VISITOR_FUNNEL_STAGES,
+  isValidFunnelStage,
+} from "../funnel.ts";
 
 test("the bridge maps every canonical funnel stage onto a valid generic stage", () => {
   const generic = new Set<string>(BUFFER_DEAL_STAGES);
@@ -39,8 +39,8 @@ test("terminal funnel stages bridge to their generic equivalents", () => {
   expect(bridgeFunnelStage("new_session")).toBe("new");
 });
 
-test("isFunnelStage guards the canonical catalog", () => {
-  expect(isFunnelStage("offer_presented")).toBe(true);
-  expect(isFunnelStage("q_website_tier")).toBe(false); // legacy UChat string
-  expect(isFunnelStage("new")).toBe(false); // generic buffer stage, not a funnel stage
+test("isValidFunnelStage guards the canonical catalog", () => {
+  expect(isValidFunnelStage("offer_presented")).toBe(true);
+  expect(isValidFunnelStage("q_website_tier")).toBe(false); // legacy UChat string
+  expect(isValidFunnelStage("new")).toBe(false); // generic buffer stage, not a funnel stage
 });