@warpgogol/werkstatt-shared 0.14.1 → 0.16.0

package/src/integration/port-barrel.ts

@@ -1,105 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-  RFC-0168: Integration Port barrel — types and pure contracts only. Re-exports from
-  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>
-<non-goals>
-  <item>Do not re-export orchestration.ts, delivery-handler.ts, or adapters.ts — those are runtime.</item>
-  <item>Do not define logic here — pure re-export barrel.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Architecture review: split from index.ts so type-only consumers don't transitively import adapter implementations.</item>
-</CHANGE_SUMMARY>
-*/
-
-export type { IntegrationSecrets } from "./port.ts";
-export type { LeadMessage, Lead, IntegrationChannelAdapter, CrmAdapter } from "./port.ts";
-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 {
-  VisitorFunnelEventPayload,
-  FunnelSystemTrigger,
-  FunnelTransitionTrigger,
-} from "./funnel.ts";
-export {
-  FUNNEL_VERSION,
-  VISITOR_FUNNEL_STAGES,
-  FUNNEL_ENTRY_STAGE,
-  FUNNEL_TERMINAL_STAGES,
-  VISITOR_FUNNEL_EVENT_KINDS,
-  VISITOR_FUNNEL_INTENTS,
-  VISITOR_FUNNEL_SOURCES,
-  VISITOR_BUYER_TYPES,
-  FUNNEL_TRANSITIONS,
-  isValidFunnelStage,
-  BUFFER_DEAL_STAGES,
-  FUNNEL_STAGE_TO_BUFFER_STAGE,
-  bridgeFunnelStage,
-  SYNC_OUTBOX_STATUSES,
-  SYNC_OUTBOX_OPS,
-  canTransition,
-  nextStages,
-  reachableStages,
-  FUNNEL_SYSTEM_TRIGGERS,
-  FUNNEL_TRANSITION_TRIGGERS,
-  LEGACY_FUNNEL_STAGES,
-  scanForMakeComReferences,
-} from "./funnel.ts";
-export type {
-  VisitorFunnelStage,
-  VisitorFunnelEventKind,
-  VisitorFunnelIntent,
-  VisitorFunnelSource,
-  VisitorBuyerType,
-  BufferDealStage,
-  SyncOutboxStatus,
-  SyncOutboxOp,
-} from "./funnel.ts";
-
-export type { LifecycleEventPayload } from "./lifecycle.ts";
-export {
-  LIFECYCLE_EVENT_KINDS,
-  SUBSCRIPTION_STATUSES,
-  INVOICE_KINDS,
-  INVOICE_STATUSES,
-  SUBSCRIPTION_PLANS,
-  LifecycleEventPayloadSchema,
-  isLifecycleEventKind,
-  SUBSCRIPTION_TRANSITIONS,
-  SUBSCRIPTION_TRANSITION_TRIGGERS,
-} from "./lifecycle.ts";
-export type {
-  LifecycleEventKind,
-  SubscriptionStatus,
-  InvoiceKind,
-  InvoiceStatus,
-  SubscriptionPlan,
-} from "./lifecycle.ts";
-
-export type { ShardAssignment, ResolveShardOptions } from "./sharding.ts";
-export { DELIVERY_REGIONS, DELIVERY_TIERS, fnv1a, resolveShard } from "./sharding.ts";
-export type { DeliveryRegion, DeliveryTier } from "./sharding.ts";
-
-export type {
-  DispatchExecuteRequest,
-  DispatchExecuteResult,
-  DispatchNamespaceBinding,
-  DispatchOutcome,
-} from "./dispatch.ts";
-export { DISPATCH_ROUTE, executeDispatch, dispatchToTenant } from "./dispatch.ts";
-
-export type { QstashPublishConfig, IdempotencyLedger, RestRedisConfig } from "./qstash.ts";
-export {
-  QSTASH_EU_BASE,
-  UPSTASH_QSTASH_SECRETS,
-  UPSTASH_REDIS_SECRETS,
-  UPSTASH_DELIVERY_SECRETS,
-  buildQstashPublish,
-  restRedisLedger,
-} from "./qstash.ts";

package/src/share/agent/tests/api-catalog.test.ts

@@ -1,8 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { buildApiCatalog } from "../api-catalog.ts";
-
-describe("buildApiCatalog", () => {
-  it("is a function", () => {
-    expect(typeof buildApiCatalog).toBe("function");
-  });
-});

package/src/share/agent/tests/ard-catalog.test.ts

@@ -1,8 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { buildArdCatalog } from "../ard-catalog.ts";
-
-describe("buildArdCatalog", () => {
-  it("is a function", () => {
-    expect(typeof buildArdCatalog).toBe("function");
-  });
-});

package/src/share/agent/tests/capability.test.ts

@@ -1,14 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { resolveActiveCapabilities, capabilityToActionRef } from "../capability.ts";
-
-describe("resolveActiveCapabilities", () => {
-  it("is a function", () => {
-    expect(typeof resolveActiveCapabilities).toBe("function");
-  });
-});
-
-describe("capabilityToActionRef", () => {
-  it("is a function", () => {
-    expect(typeof capabilityToActionRef).toBe("function");
-  });
-});

package/src/share/agent/tests/fleet-catalog.test.ts

@@ -1,15 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { FLEET_AGENT_CATALOG_SCHEMA, buildFleetAgentCatalog } from "../fleet-catalog.ts";
-
-describe("FLEET_AGENT_CATALOG_SCHEMA", () => {
-  it("is a string constant", () => {
-    expect(typeof FLEET_AGENT_CATALOG_SCHEMA).toBe("string");
-    expect(FLEET_AGENT_CATALOG_SCHEMA).toContain("fleet.agent-catalog");
-  });
-});
-
-describe("buildFleetAgentCatalog", () => {
-  it("is a function", () => {
-    expect(typeof buildFleetAgentCatalog).toBe("function");
-  });
-});

package/src/share/agent/tests/knowledge.test.ts

@@ -1,20 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { AGENT_KNOWLEDGE_DOMAINS, isAgentKnowledgeDomain } from "../knowledge.ts";
-
-describe("AGENT_KNOWLEDGE_DOMAINS", () => {
-  it("is a non-empty array", () => {
-    expect(Array.isArray(AGENT_KNOWLEDGE_DOMAINS)).toBe(true);
-    expect(AGENT_KNOWLEDGE_DOMAINS.length).toBeGreaterThan(0);
-  });
-});
-
-describe("isAgentKnowledgeDomain", () => {
-  it("returns true for valid domain", () => {
-    const firstDomain = AGENT_KNOWLEDGE_DOMAINS[0];
-    expect(isAgentKnowledgeDomain(firstDomain)).toBe(true);
-  });
-
-  it("returns false for invalid domain", () => {
-    expect(isAgentKnowledgeDomain("invalid-domain")).toBe(false);
-  });
-});

package/src/share/agent/tests/manifest.test.ts

@@ -1,9 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { AGENT_SURFACE_VERSION } from "../manifest.ts";
-
-describe("AGENT_SURFACE_VERSION", () => {
-  it("is a version string", () => {
-    expect(typeof AGENT_SURFACE_VERSION).toBe("string");
-    expect(AGENT_SURFACE_VERSION).toMatch(/\d+\.\d+\.\d+/);
-  });
-});

package/src/share/agent/tests/mcp-card.test.ts

@@ -1,8 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { buildMcpServerCard } from "../mcp-card.ts";
-
-describe("buildMcpServerCard", () => {
-  it("is a function", () => {
-    expect(typeof buildMcpServerCard).toBe("function");
-  });
-});

package/src/share/agent/tests/openapi.test.ts

@@ -1,8 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { formatAgentOpenApi } from "../openapi.ts";
-
-describe("formatAgentOpenApi", () => {
-  it("is a function", () => {
-    expect(typeof formatAgentOpenApi).toBe("function");
-  });
-});

package/src/share/agent/tests/proof.test.ts

@@ -1,15 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { AGENT_PROOF_DOMAIN, buildAgentSigningPayload } from "../proof.ts";
-
-describe("AGENT_PROOF_DOMAIN", () => {
-  it("is a string constant", () => {
-    expect(typeof AGENT_PROOF_DOMAIN).toBe("string");
-    expect(AGENT_PROOF_DOMAIN.length).toBeGreaterThan(0);
-  });
-});
-
-describe("buildAgentSigningPayload", () => {
-  it("is a function", () => {
-    expect(typeof buildAgentSigningPayload).toBe("function");
-  });
-});

package/src/share/content/index.ts

@@ -1,16 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/content/index.ts as an authored share content module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not introduce app-specific runtime composition or deployment behavior into this reusable package source file.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0133: backfilled MODULE_MAP and CHANGE_SUMMARY markers for compass.validate compliance.</item>
-  <item>Removed dispatch.ts re-export (merged into entity-id.ts).</item>
-</CHANGE_SUMMARY>
-*/
-
-export * from "./entity-id.ts";
-export * from "./merge.ts";
-export * from "./resolve-field-path.ts";

package/src/share/content-discipline/index.ts

@@ -1,14 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Maintains packages/share/src/content-discipline/index.ts as an authored share authored module so agents can evolve it without rediscovering local boundaries.</purpose>
-<non-goals>
-  <item>Do not define validation logic here.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Added barrel exports for content-discipline submodules.</item>
-</CHANGE_SUMMARY>
-*/
-
-export * from "./types.ts";
-export * from "./parsers.ts";

package/src/share/index.ts

@@ -1,86 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>
-Deprecated compatibility barrel for @warpgogol/werkstatt-shared/share (RFC-0264). New code MUST
-import from the domain subpath instead — see the map in
-packages/share/AGENTS.md. This root barrel re-exports each subpath module
-unchanged (never new logic) so existing consumers keep working while they
-migrate. The `page` and `i18n` domains have completed their migration wave:
-their re-export blocks are deleted here — import them from
-`@warpgogol/werkstatt-shared/share/page` / `@warpgogol/werkstatt-shared/share/i18n`.
-</purpose>
-<non-goals>
-  <item>Do not add business logic here — keep as a pure re-export barrel.</item>
-  <item>Do not re-add the page or i18n domains — those are fully migrated; import the subpath directly.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>Initial barrel created alongside package extraction.</item>
-  <item>RFC-0264: split into subpath entry points. Root barrel shrunk to a deprecated compatibility surface; page and i18n domains fully migrated (root re-export blocks deleted, all consumers rewritten).</item>
-  <item>C6: image-utils.ts shim deleted; root barrel re-exports from @warpgogol/werkstatt-site/content-source directly. page-handler.ts shim deleted; export map points to resolve-route.ts.</item>
-</CHANGE_SUMMARY>
-*/
-
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/content" instead */
-export * from "./content/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/semantic" instead */
-export * from "./semantic/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/middleware" instead */
-export * from "./middleware/language-redirect.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/entitlement" instead */
-export * from "./entitlement.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/offer-capacity" instead */
-export * from "./offer-capacity.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/knowledge" instead */
-export * from "./knowledge/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/schemas" instead */
-export * from "./schemas/index.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/feature-policy" instead */
-export * from "./feature-policy.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/counter-utils" instead */
-export * from "./counter-utils.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/image-provider" instead */
-export * from "./image-provider.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/runtime-context" instead */
-export { EMPTY_RUNTIME_CONTEXT } from "./runtime-context.ts";
-export type { RuntimeContext } from "./runtime-context.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/visibility" instead */
-export * from "./visibility.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/wrap-inline-numbers" instead */
-export * from "./wrap-inline-numbers.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/text-normalize" instead */
-export * from "./text-normalize.ts";
-// dev-props-validator is NOT re-exported from the root barrel. It imports
-// node:fs/promises and @warpgogol/werkstatt-shared/ontology/schemas (which also imports node:fs),
-// so re-exporting it here pulls Node-only modules into the Vite client bundle.
-// The sole consumer (resolve-route.ts) imports it via relative path.
-// Import from "@warpgogol/werkstatt-shared/share/dev-props-validator" subpath directly if needed.
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/rfc0042-utils" instead */
-export { need, cast, withDefault } from "./rfc0042-utils.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/shared-context" instead */
-export * from "./shared-context.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/content-discipline" instead */
-export * from "./content-discipline/types.ts";
-export * from "./content-discipline/parsers.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/legal" instead */
-export { resolveTranslationContext, TRANSLATION_STATUSES } from "./legal/translation-policy.ts";
-export type {
-  TranslationStatus,
-  PageTranslationPolicy,
-  ResolvedTranslationContext,
-} from "./legal/translation-policy.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/material-credits" instead */
-export {
-  parseMaterialCreditMap,
-  findMaterialCredit,
-  creditByTarget,
-  buildMaterialCreditJsonLd,
-  langFromCreditPath,
-} from "./material-credits.ts";
-export type { MaterialCreditRecord, RawMaterialCreditMap } from "./material-credits.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/attribution-display" instead */
-export * from "./attribution-display.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/string-utils" instead */
-export { toKebabCase } from "./string-utils.ts";
-/** @deprecated import from "@warpgogol/werkstatt-shared/share/css-value-normalize" instead */
-export { normalizeCssValue } from "./css-value-normalize.ts";

package/src/share/knowledge/tests/claim.test.ts

@@ -1,11 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { CLAIM_PROVENANCE_KINDS } from "../claim.ts";
-
-describe("CLAIM_PROVENANCE_KINDS", () => {
-  it("contains expected provenance kinds", () => {
-    expect(CLAIM_PROVENANCE_KINDS).toContain("external");
-    expect(CLAIM_PROVENANCE_KINDS).toContain("derived");
-    expect(CLAIM_PROVENANCE_KINDS).toContain("asserted");
-    expect(CLAIM_PROVENANCE_KINDS).toContain("generated");
-  });
-});

package/src/share/knowledge/tests/derivation.test.ts

@@ -1,30 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { normalizeForHash, hashSourceValue, derivedState } from "../derivation.ts";
-
-describe("normalizeForHash", () => {
-  it("is a function", () => {
-    expect(typeof normalizeForHash).toBe("function");
-  });
-
-  it("normalizes whitespace", () => {
-    const result = normalizeForHash("  hello  world  ");
-    expect(typeof result).toBe("string");
-  });
-});
-
-describe("hashSourceValue", () => {
-  it("is a function", () => {
-    expect(typeof hashSourceValue).toBe("function");
-  });
-
-  it("returns a string hash", () => {
-    const result = hashSourceValue("test");
-    expect(typeof result).toBe("string");
-  });
-});
-
-describe("derivedState", () => {
-  it("is a function", () => {
-    expect(typeof derivedState).toBe("function");
-  });
-});

package/src/share/knowledge/tests/freshness.test.ts

@@ -1,18 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { addDuration } from "../freshness.ts";
-
-describe("addDuration", () => {
-  it("is a function", () => {
-    expect(typeof addDuration).toBe("function");
-  });
-
-  it("adds months to a date", () => {
-    const result = addDuration("2026-01-01", "P3M");
-    expect(result).not.toBeNull();
-  });
-
-  it("returns null for invalid duration", () => {
-    const result = addDuration("2026-01-01", "invalid");
-    expect(result).toBeNull();
-  });
-});

package/src/share/knowledge/tests/ledger.test.ts

@@ -1,35 +0,0 @@
-import { describe, it, expect } from "vitest";
-import type { ClaimEvent, ClaimLineage } from "../ledger.ts";
-
-describe("ledger types", () => {
-  it("ClaimEvent is a valid type", () => {
-    const event: ClaimEvent = {
-      id: "evt-1",
-      ts: "2026-01-01T00:00:00Z",
-      subject: "test",
-      provenance: "asserted",
-      asOf: "2026-01-01",
-      actor: "agent",
-      event: "asserted" as ClaimEvent["event"],
-    };
-    expect(event).toBeDefined();
-  });
-
-  it("ClaimLineage is a valid type", () => {
-    const event: ClaimEvent = {
-      id: "evt-1",
-      ts: "2026-01-01T00:00:00Z",
-      subject: "test",
-      provenance: "asserted",
-      asOf: "2026-01-01",
-      actor: "agent",
-      event: "asserted" as ClaimEvent["event"],
-    };
-    const lineage: ClaimLineage = {
-      subject: "test",
-      current: event,
-      history: [event],
-    };
-    expect(lineage).toBeDefined();
-  });
-});

package/src/share/knowledge/tests/plan.test.ts

@@ -1,19 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { stableTaskId } from "../plan.ts";
-
-describe("stableTaskId", () => {
-  it("is a function", () => {
-    expect(typeof stableTaskId).toBe("function");
-  });
-
-  it("returns a string id", () => {
-    const result = stableTaskId("subject-1", "review-due");
-    expect(typeof result).toBe("string");
-  });
-
-  it("is deterministic for same inputs", () => {
-    const a = stableTaskId("subject-1", "review-due");
-    const b = stableTaskId("subject-1", "review-due");
-    expect(a).toBe(b);
-  });
-});

package/src/share/knowledge/tests/source.test.ts

@@ -1,19 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { SOURCE_KINDS, sourceToleranceSchema } from "../source.ts";
-
-describe("SOURCE_KINDS", () => {
-  it("contains expected source kinds", () => {
-    expect(SOURCE_KINDS).toContain("http-json");
-    expect(SOURCE_KINDS).toContain("manual");
-  });
-});
-
-describe("sourceToleranceSchema", () => {
-  it("is defined", () => {
-    expect(sourceToleranceSchema).toBeDefined();
-  });
-
-  it("rejects null", () => {
-    expect(() => sourceToleranceSchema.parse(null)).toThrow();
-  });
-});

package/src/share/legal/index.ts

@@ -1 +0,0 @@
-export * from "./translation-policy.ts";

package/src/share/redirects.ts

@@ -1,54 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>App-agnostic _redirects file parsing for reuse across site-kernel-checks and site-kernel-handoff (RFC-0588).</purpose>
-<non-goals>
-  <item>Do not handle advanced Cloudflare Pages syntax (query parameters, placeholders) — only whitespace-delimited `from to status` lines.</item>
-  <item>Do not perform glob-to-regex conversion — that is the consumer's responsibility.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0588: extracted parseRedirectRules and RedirectRule from site-kernel-checks/managed-public.ts into @warpgogol/werkstatt-shared/share/redirects subpath.</item>
-  <item>RFC-0595: add extractRedirectTarget helper for parsing url= from meta-refresh tags.</item>
-</CHANGE_SUMMARY>
-*/
-
-export type RedirectRule = {
-  from: string;
-  to: string | undefined;
-  status: number;
-  line: string;
-};
-
-export function parseRedirectRules(body: string): RedirectRule[] {
-  return body
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter((line) => line && !line.startsWith("#"))
-    .map((line) => {
-      const [from, to, statusRaw] = line.split(/\s+/);
-      return {
-        from: from ?? "",
-        to,
-        status: Number(statusRaw ?? 301),
-        line,
-      };
-    })
-    .filter((rule) => rule.from.length > 0);
-}
-
-/**
- * Extract the redirect target URL from a `<meta http-equiv="refresh" content="0;url=...">` tag.
- * Returns the immediate target only (first hop). Returns null if the tag is
- * absent or the url= value cannot be parsed.
- */
-export function extractRedirectTarget(html: string): string | null {
-  const m = html.match(
-    /<meta[^>]+http-equiv=["']refresh["'][^>]*content=["']\s*\d+\s*;\s*url=([^"']+)['"][^>]*>/i,
-  );
-  if (m?.[1]) return m[1].trim();
-  const m2 = html.match(
-    /<meta[^>]+content=["']\s*\d+\s*;\s*url=([^"']+)['"][^>]*http-equiv=["']refresh["'][^>]*>/i,
-  );
-  if (m2?.[1]) return m2[1].trim();
-  return null;
-}