@warpgogol/werkstatt-shared 0.13.0 → 0.14.1

package/README.md

@@ -4,6 +4,8 @@
 
 Stack-agnostic shared infrastructure extracted from `werkstatt-site` (RFC-0868). Owns checks, integration, ontology, passport, share, and surface domains consumed by both the Werkstatt engine and the site plugin.
 
+> Engineered at [Warpgogol](https://warpgogol.com) · Released as open source.
+
 ---
 
 ## What this package does
@@ -62,36 +64,36 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ### Semantic extraction (RFC-0901)
 
-| Export | Purpose |
-| --- | --- |
+| Export                          | Purpose                                                     |
+| ------------------------------- | ----------------------------------------------------------- |
 | `splitSentences(text, locale?)` | Locale-aware sentence boundary detection (`de`, `uk`, `en`) |
 
 ### Canonical entity URL (RFC-0910)
 
-| Export | Purpose |
-| --- | --- |
+| Export                      | Purpose                                         |
+| --------------------------- | ----------------------------------------------- |
 | `canonicalRootUrl(baseUrl)` | Unprefixed root URL for JSON-LD entity identity |
 
 ### Placeholder route filtering (RFC-0917)
 
-| Export | Purpose |
-| --- | --- |
+| Export                         | Purpose                                                      |
+| ------------------------------ | ------------------------------------------------------------ |
 | `hasPlaceholderRoutes(routes)` | Detect Astro dynamic route templates (`[slug]`, `[version]`) |
 
 ---
 
 ## Architecture
 
-| Directory | Purpose |
-| --- | --- |
-| `src/index.ts` | Main barrel export |
-| `src/checks/` | Content validators, SEO validators, surface expand/bake |
-| `src/integration/` | CRM, funnel, hub, sharding, QStash adapters |
-| `src/ontology/` | Catalogs, enums, Sternsystem owner types |
-| `src/passport/` | DHT signing, identity signing, schema validation |
-| `src/share/` | Slug, semantic, URL canonicalization, routes, middleware, access protection |
-| `src/surface/` | Surface expand/bake helpers and labels |
-| `src/content/` | SystemManifest types and content schema |
+| Directory          | Purpose                                                                     |
+| ------------------ | --------------------------------------------------------------------------- |
+| `src/index.ts`     | Main barrel export                                                          |
+| `src/checks/`      | Content validators, SEO validators, surface expand/bake                     |
+| `src/integration/` | CRM, funnel, hub, sharding, QStash adapters                                 |
+| `src/ontology/`    | Catalogs, enums, Sternsystem owner types                                    |
+| `src/passport/`    | DHT signing, identity signing, schema validation                            |
+| `src/share/`       | Slug, semantic, URL canonicalization, routes, middleware, access protection |
+| `src/surface/`     | Surface expand/bake helpers and labels                                      |
+| `src/content/`     | SystemManifest types and content schema                                     |
 
 ---
 
@@ -133,3 +135,11 @@ After CI completes, verify the new version on [npmjs.com/package/@warpgogol/werk
 ## License
 
 Apache-2.0
+
+## Open Engineering
+
+This package originated from production engineering work at [Warpgogol](https://warpgogol.com), an engineering studio in Germany.
+
+We publish reusable parts of our infrastructure when they can be useful beyond our own projects. It is published independently of any Warpgogol commercial service. Using this package does not create any dependency on Warpgogol.
+
+Built for real systems. Shared openly.

package/README.uk.md

@@ -4,6 +4,8 @@
 
 Спільна інфраструктура, незалежна від стеку, витягнута з `werkstatt-site` (RFC-0868). Володіє доменами checks, integration, ontology, passport, share та surface, які споживають рушій Werkstatt та site-плагін.
 
+> Розроблено в [Warpgogol](https://warpgogol.com) · Опубліковано як open source.
+
 ---
 
 ## Що робить цей пакет
@@ -62,14 +64,14 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ### Семантична екстракція (RFC-0901)
 
-| Експорт | Призначення |
-| --- | --- |
+| Експорт                         | Призначення                                          |
+| ------------------------------- | ---------------------------------------------------- |
 | `splitSentences(text, locale?)` | Локалізоване виявлення меж речень (`de`, `uk`, `en`) |
 
 ### Канонічний URL сутності (RFC-0910)
 
-| Експорт | Призначення |
-| --- | --- |
+| Експорт                     | Призначення                                                     |
+| --------------------------- | --------------------------------------------------------------- |
 | `canonicalRootUrl(baseUrl)` | Непрефіксований кореневий URL для JSON-LD ідентичності сутності |
 
 ### Фільтрація плейсхолдер-маршрутів (RFC-0917)
@@ -82,16 +84,16 @@ const url = slugUrl("Über uns", "de"); // "ueber-uns"
 
 ## Архітектура
 
-| Директорія | Призначення |
-| --- | --- |
-| `src/index.ts` | Головний barrel-експорт |
-| `src/checks/` | Валідатори контенту, SEO-валідатори, surface expand/bake |
-| `src/integration/` | Адаптери CRM, funnel, hub, sharding, QStash |
-| `src/ontology/` | Каталоги, enum-и, типи Sternsystem owner |
-| `src/passport/` | DHT-підписування, підписування ідентичності, валідація схем |
-| `src/share/` | Slug, семантика, канонізація URL, маршрути, middleware, захист доступу |
-| `src/surface/` | Хелпери surface expand/bake та мітки |
-| `src/content/` | Типи SystemManifest та схема контенту |
+| Директорія         | Призначення                                                            |
+| ------------------ | ---------------------------------------------------------------------- |
+| `src/index.ts`     | Головний barrel-експорт                                                |
+| `src/checks/`      | Валідатори контенту, SEO-валідатори, surface expand/bake               |
+| `src/integration/` | Адаптери CRM, funnel, hub, sharding, QStash                            |
+| `src/ontology/`    | Каталоги, enum-и, типи Sternsystem owner                               |
+| `src/passport/`    | DHT-підписування, підписування ідентичності, валідація схем            |
+| `src/share/`       | Slug, семантика, канонізація URL, маршрути, middleware, захист доступу |
+| `src/surface/`     | Хелпери surface expand/bake та мітки                                   |
+| `src/content/`     | Типи SystemManifest та схема контенту                                  |
 
 ---
 
@@ -133,3 +135,11 @@ pnpm exec repo-extract --config packages/werkstatt-shared/extract.config.yaml --
 ## Ліцензія
 
 Apache-2.0
+
+## Відкрита інженерія
+
+Цей пакет походить із виробничої інженерної роботи в [Warpgogol](https://warpgogol.com), інженерній студії в Німеччині.
+
+Ми публікуємо багаторазові частини нашої інфраструктури, коли вони можуть бути корисними поза нашими власними проєктами. Він публікується незалежно від будь-якого комерційного сервісу Warpgogol. Використання цього пакету не створює жодної залежності від Warpgogol.
+
+Створено для реальних систем. Поширюється відкрито.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/werkstatt-shared",
-  "version": "0.13.0",
+  "version": "0.14.1",
   "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"
@@ -278,6 +262,10 @@
       "types": "./src/share/redirects.ts",
       "default": "./src/share/redirects.ts"
     },
+    "./share/remediation": {
+      "types": "./src/share/remediation/remediation-catalog.ts",
+      "default": "./src/share/remediation/remediation-catalog.ts"
+    },
     "./share/rfc0042-utils": {
       "types": "./src/share/rfc0042-utils.ts",
       "default": "./src/share/rfc0042-utils.ts"
@@ -414,30 +402,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 +634,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 +1094,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 +1301,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": {
@@ -1357,6 +1313,7 @@
     "build": "pnpm exec tsc -p tsconfig.json --noEmit",
     "build:check": "pnpm exec tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:watch": "vitest"
   },
   "publishConfig": {
@@ -1368,18 +1325,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 +1344,19 @@
     "@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/coverage-v8": "^4.1.11",
+    "vitest": "^4.1.11"
   },
   "packageManager": "pnpm@11.10.0"
 }

package/src/checks/result-helpers.ts

@@ -13,6 +13,7 @@ ruleId = command; diagnosticsResult takes rich Diagnostic[] with registered ids.
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0029 review: Initial creation to fix systemic exit-code bug across check files.</item>
+  <item>RFC-1027: Auto-populate Diagnostic.remediation from REMEDIATION_CATALOG in diagnosticsResult().</item>
 </CHANGE_SUMMARY>
 */
 
@@ -22,6 +23,7 @@ import type {
   KernelCommandResult,
   KernelNextStep,
 } from "@warpgogol/werkstatt-engine/kernel";
+import { lookupRemediation } from "../share/remediation/remediation-catalog.ts";
 
 function defaultFailNextSteps(command: string): KernelNextStep[] {
   return [
@@ -66,10 +68,25 @@ export function diagnosticsResult(
   diagnostics: Diagnostic[],
   nextSteps?: KernelNextStep[],
 ): KernelCommandResult<CheckResult> {
+  const enrichedDiagnostics = diagnostics.map((d) => {
+    if (d.remediation) return d;
+    const pattern = lookupRemediation(d.ruleId);
+    if (!pattern) return d;
+    return {
+      ...d,
+      remediation: {
+        ruleId: pattern.ruleId,
+        action: pattern.action,
+        ...(pattern.template !== undefined && { template: pattern.template }),
+        ...(pattern.docRef !== undefined && { docRef: pattern.docRef }),
+        ...(pattern.targetFiles !== undefined && { targetFiles: pattern.targetFiles }),
+      },
+    };
+  });
   const summary = {
-    error: diagnostics.filter((d) => d.severity === "error").length,
-    warning: diagnostics.filter((d) => d.severity === "warning").length,
-    info: diagnostics.filter((d) => d.severity === "info").length,
+    error: enrichedDiagnostics.filter((d) => d.severity === "error").length,
+    warning: enrichedDiagnostics.filter((d) => d.severity === "warning").length,
+    info: enrichedDiagnostics.filter((d) => d.severity === "info").length,
   };
   const status: CheckResult["status"] =
     summary.error > 0 ? "fail" : summary.warning > 0 ? "warn" : "pass";
@@ -77,7 +94,7 @@ export function diagnosticsResult(
     nextSteps ?? (summary.error > 0 ? defaultFailNextSteps(command) : undefined);
   const counts = formatCounts(summary.error, summary.warning);
   return {
-    data: { command, status, diagnostics, summary },
+    data: { command, status, diagnostics: enrichedDiagnostics, summary },
     exitCode: summary.error > 0 ? 1 : 0,
     summary: counts ? `[${command}] ${counts}` : `[${command}]`,
     nextSteps: resolvedNextSteps,

package/src/checks/tests/remediation-auto-populate.test.ts

@@ -0,0 +1,83 @@
+/*
+<MODULE_CONTRACT>
+  <purpose>RFC-1027: unit tests for diagnosticsResult() remediation auto-population.</purpose>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1027: initial tests for remediation auto-population from REMEDIATION_CATALOG.</item>
+</CHANGE_SUMMARY>
+*/
+
+import { test, expect } from "vitest";
+import { diagnosticsResult } from "../result-helpers.ts";
+import type { Diagnostic } from "@warpgogol/werkstatt-engine/kernel";
+
+test("diagnosticsResult: auto-populates remediation from catalog for known ruleId", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "GEN-FILES-01",
+      severity: "error",
+      message: "Generated file is stale",
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation).toBeDefined();
+  expect(result.data!.diagnostics[0].remediation?.ruleId).toBe("GEN-FILES-01");
+  expect(result.data!.diagnostics[0].remediation?.action).toContain("Regenerate");
+  expect(result.data!.diagnostics[0].remediation?.docRef).toBe(
+    "docs/authoring/generated-files-and-templates.md",
+  );
+});
+
+test("diagnosticsResult: does not overwrite existing remediation field", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "GEN-FILES-01",
+      severity: "error",
+      message: "Stale file",
+      remediation: {
+        ruleId: "GEN-FILES-01",
+        action: "Custom action — do not overwrite",
+      },
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation?.action).toBe("Custom action — do not overwrite");
+});
+
+test("diagnosticsResult: no remediation for unknown ruleId", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "UNKNOWN-RULE-999",
+      severity: "warning",
+      message: "Some warning",
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation).toBeUndefined();
+});
+
+test("diagnosticsResult: preserves fixHint alongside remediation", () => {
+  const diagnostics: Diagnostic[] = [
+    {
+      ruleId: "GEN-FILES-01",
+      severity: "error",
+      message: "Stale",
+      fixHint: "Run the generator",
+    },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].fixHint).toBe("Run the generator");
+  expect(result.data!.diagnostics[0].remediation).toBeDefined();
+});
+
+test("diagnosticsResult: multiple diagnostics get independent remediation", () => {
+  const diagnostics: Diagnostic[] = [
+    { ruleId: "GEN-FILES-01", severity: "error", message: "err 1" },
+    { ruleId: "PARITY-SECTION-COUNT", severity: "error", message: "err 2" },
+    { ruleId: "UNKNOWN", severity: "info", message: "info 1" },
+  ];
+  const result = diagnosticsResult("test.command", diagnostics);
+  expect(result.data!.diagnostics[0].remediation?.ruleId).toBe("GEN-FILES-01");
+  expect(result.data!.diagnostics[1].remediation?.ruleId).toBe("PARITY-SECTION-COUNT");
+  expect(result.data!.diagnostics[2].remediation).toBeUndefined();
+});

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";