@semiont/core 0.5.28 → 0.5.30

package/README.md

@@ -12,9 +12,9 @@ Core types and domain logic for the Semiont semantic knowledge platform. This pa
 
 ## Who Should Use This
 
-- ✅ **Backend** (`apps/backend`) - Server implementation, imports types from core
+- ✅ **Gateway** (`apps/gateway`) - Server implementation, imports types from core
 - ✅ **Packages** - Other monorepo packages that need OpenAPI types, the EventBus, or the transport contract
-- ✅ **Frontend / Browser** - Types and pure utilities (the main barrel is browser-safe)
+- ✅ **Browser / Browser** - Types and pure utilities (the main barrel is browser-safe)
 
 ## Who Should Use `@semiont/core/node` Instead
 
@@ -31,7 +31,7 @@ import { SemiontProject, loadEnvironmentConfig } from '@semiont/core/node';
 
 ## Who Should Use `@semiont/sdk` Instead
 
-Application code talking to a Semiont backend should use [`@semiont/sdk`](../sdk/), which provides `SemiontClient`, the verb-oriented namespaces, and the session layer. The SDK consumes the `ITransport` / `IContentTransport` contracts defined here; the HTTP implementations of those contracts live in [`@semiont/http-transport`](../http-transport/) and are re-exported by the SDK for convenience.
+Application code talking to a Semiont gateway should use [`@semiont/sdk`](../sdk/), which provides `SemiontClient`, the verb-oriented namespaces, and the session layer. The SDK consumes the `ITransport` / `IContentTransport` contracts defined here; the HTTP implementations of those contracts live in [`@semiont/http-transport`](../http-transport/) and are re-exported by the SDK for convenience.
 
 **Rule of thumb**: If you are making API calls, use `@semiont/sdk`. If you only need types and domain logic, use `@semiont/core`. Import from `@semiont/http-transport` directly only when constructing a transport stack by hand.
 
@@ -110,7 +110,7 @@ function handle(event: PersistedEvent) {
 
 ### EventBus
 
-The RxJS-based event bus shared by backend and clients, with a typed channel protocol:
+The RxJS-based event bus shared by gateway and clients, with a typed channel protocol:
 
 ```typescript
 import { EventBus, ScopedEventBus, burstBuffer, serializePerKey } from '@semiont/core';
@@ -128,7 +128,7 @@ import type { EventMap, EventName } from '@semiont/core';
 The interfaces every concrete transport must satisfy, plus the channel set transports bridge into a client's bus:
 
 ```typescript
-import type { ITransport, IContentTransport, IBackendOperations, ConnectionState } from '@semiont/core';
+import type { ITransport, IContentTransport, IGatewayOperations, ConnectionState } from '@semiont/core';
 import { BRIDGED_CHANNELS } from '@semiont/core';
 ```
 
@@ -292,7 +292,7 @@ import type { SemiontConfig, EnvironmentConfig, ServicesConfig } from '@semiont/
 
 Filesystem-backed loading (`SemiontProject`, `loadEnvironmentConfig`) is in `@semiont/core/node` — see above.
 
-### Backend Internal Types
+### Gateway Internal Types
 
 Types not in the OpenAPI spec:
 
@@ -315,7 +315,7 @@ Semiont follows a **spec-first architecture**:
 
 1. **OpenAPI Specification** ([specs/src/](../../specs/src/)) is the source of truth
 2. **@semiont/core** generates types from OpenAPI and provides domain utilities
-3. Every other package imports types from `@semiont/core`; application code talks to the backend through `@semiont/sdk`, whose transports implement core's `ITransport` contract
+3. Every other package imports types from `@semiont/core`; application code talks to the gateway through `@semiont/sdk`, whose transports implement core's `ITransport` contract
 
 **Type Yield Flow**: OpenAPI spec → `@semiont/core/src/types.ts` (via `openapi-typescript`) → imported across the monorepo. This ensures no circular dependencies and clear build order.
 
@@ -340,8 +340,8 @@ Apache-2.0
 
 - [`@semiont/sdk`](../sdk/) - The Semiont SDK (`SemiontClient`) - use this for application development
 - [`@semiont/http-transport`](../http-transport/) - HTTP implementations of core's transport contract
-- [`@semiont/backend`](../../apps/backend/) - Backend API server
-- [`@semiont/frontend`](../../apps/frontend/) - Web application
+- [`@semiont/gateway`](../../apps/gateway/) - Gateway API server
+- [`@semiont/browser`](../../apps/browser/) - Web application
 
 ## Learn More
 

package/dist/{chunk-CUPZGI7I.js → chunk-EWOITHBH.js}

@@ -66,6 +66,7 @@ var BUS_OPERATIONS = {
   // ── BROWSE (reads) ──────────────────────────────────────────────
   "browse:resource-requested": { result: "browse:resource-result", failure: "browse:resource-failed" },
   "browse:anchored-text-requested": { result: "browse:anchored-text-result", failure: "browse:anchored-text-failed" },
+  "browse:anchored-text-by-checksum-requested": { result: "browse:anchored-text-by-checksum-result", failure: "browse:anchored-text-by-checksum-failed" },
   "browse:resources-requested": { result: "browse:resources-result", failure: "browse:resources-failed" },
   "browse:annotation-requested": { result: "browse:annotation-result", failure: "browse:annotation-failed" },
   "browse:annotations-requested": { result: "browse:annotations-result", failure: "browse:annotations-failed" },
@@ -76,7 +77,7 @@ var BUS_OPERATIONS = {
   "browse:tag-schemas-requested": { result: "browse:tag-schemas-result", failure: "browse:tag-schemas-failed" },
   "browse:agents-requested": { result: "browse:agents-result", failure: "browse:agents-failed" },
   "browse:directory-requested": { result: "browse:directory-result", failure: "browse:directory-failed" },
-  // dormant — backend handler complete, no client caller yet (annotation-detail capability)
+  // dormant — gateway handler complete, no client caller yet (annotation-detail capability)
   "browse:annotation-context-requested": { result: "browse:annotation-context-result", failure: "browse:annotation-context-failed" },
   // ── FRAME (KB schema writes) ────────────────────────────────────
   "frame:add-entity-type": { result: "frame:entity-type-add-ok", failure: "frame:entity-type-add-failed" },
@@ -85,7 +86,7 @@ var BUS_OPERATIONS = {
   // streaming: take-1 result + failure plus an intermediate progress channel
   "gather:requested": { result: "gather:complete", failure: "gather:failed", progress: "gather:annotation-progress" },
   "gather:resource-requested": { result: "gather:resource-complete", failure: "gather:resource-failed" },
-  // dormant — backend handler complete, no client caller yet (annotation summary)
+  // dormant — gateway handler complete, no client caller yet (annotation summary)
   "gather:summary-requested": { result: "gather:summary-result", failure: "gather:summary-failed" },
   // ── JOB ─────────────────────────────────────────────────────────
   "job:create": { result: "job:created", failure: "job:create-failed" },
@@ -95,6 +96,7 @@ var BUS_OPERATIONS = {
   "job:claim": { result: "job:claimed", failure: "job:claim-failed" },
   // ── MARK ────────────────────────────────────────────────────────
   "mark:create-request": { result: "mark:create-ok", failure: "mark:create-failed" },
+  "mark:commit": { result: "mark:commit-ok", failure: "mark:commit-failed" },
   "mark:delete": { result: "mark:delete-ok", failure: "mark:delete-failed" },
   "mark:archive": { result: "mark:archive-ok", failure: "mark:archive-failed" },
   "mark:unarchive": { result: "mark:unarchive-ok", failure: "mark:unarchive-failed" },
@@ -112,6 +114,7 @@ var BUS_OPERATIONS = {
   // live in-process (resource-operations.ts emits + awaits via race()); the
   // client also .on()-subscribes -ok for cache invalidation
   "yield:create": { result: "yield:create-ok", failure: "yield:create-failed" },
+  "yield:clone-persist": { result: "yield:clone-persist-ok", failure: "yield:clone-persist-failed" },
   // dormant — handler in stower exists, no request emitter; client pre-subscribes -ok
   "yield:update": { result: "yield:update-ok", failure: "yield:update-failed" },
   "yield:clone-create": { result: "yield:clone-created", failure: "yield:clone-create-failed" },
@@ -126,6 +129,10 @@ var BRIDGED_BROADCASTS = [
   "job:fail",
   "frame:entity-type-added",
   "frame:tag-schema-added",
+  "yield:created",
+  "yield:updated",
+  "yield:cloned",
+  "yield:moved",
   "beckon:focus",
   "beckon:sparkle",
   "bus:resume-gap",
@@ -248,6 +255,19 @@ var EventBus = class {
   getDomainEvent(eventType) {
     return this.get(eventType);
   }
+  /**
+   * Channel names with at least one live observer right now. Introspection
+   * for composition-parity gates: `get()` creates subjects lazily, so mere
+   * access does not count — only real subscriptions do. Scoped channels
+   * appear under their namespaced key (`<scope>:<channel>`).
+   */
+  observedChannels() {
+    const out = [];
+    for (const [name, subject] of this.subjects) {
+      if (subject.observed) out.push(String(name));
+    }
+    return out;
+  }
   /**
    * Destroy the event bus and complete all subjects
    *
@@ -335,5 +355,5 @@ var ScopedEventBus = class _ScopedEventBus {
 };
 
 export { BRIDGED_CHANNELS, BUS_OPERATIONS, EventBus, ScopedEventBus, accessToken, annotationUri, authCode, baseUrl, busLog, busLogEnabled, cloneToken, email, entityType, googleCredential, jobId, mcpToken, refreshToken, resourceAnnotationUri, resourceUri, searchQuery, setBusLogTraceIdProvider, userDID };
-//# sourceMappingURL=chunk-CUPZGI7I.js.map
-//# sourceMappingURL=chunk-CUPZGI7I.js.map
+//# sourceMappingURL=chunk-EWOITHBH.js.map
+//# sourceMappingURL=chunk-EWOITHBH.js.map

package/dist/chunk-EWOITHBH.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/branded-types.ts","../src/bus-operations.ts","../src/bridged-channels.ts","../src/bus-log.ts","../src/event-bus.ts"],"names":[],"mappings":"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","file":"chunk-EWOITHBH.js","sourcesContent":["/**\n * Branded string types for compile-time type safety\n *\n * These types are zero-cost at runtime but prevent mixing\n * different string types at compile time.\n */\n\nimport type { components } from './types';\n\n// ============================================================================\n// OPENAPI-GENERATED TYPES (use directly from spec)\n// ============================================================================\n\nexport type Motivation = components['schemas']['Motivation'];\nexport type ContentFormat = components['schemas']['ContentFormat'];\n\n// ============================================================================\n// AUTHENTICATION & TOKENS\n// ============================================================================\n\nexport type Email = string & { readonly __brand: 'Email' };\nexport type AuthCode = string & { readonly __brand: 'AuthCode' };\nexport type GoogleCredential = string & { readonly __brand: 'GoogleCredential' };\nexport type AccessToken = string & { readonly __brand: 'AccessToken' };\nexport type RefreshToken = string & { readonly __brand: 'RefreshToken' };\nexport type MCPToken = string & { readonly __brand: 'MCPToken' };\nexport type CloneToken = string & { readonly __brand: 'CloneToken' };\n\n// ============================================================================\n// SYSTEM IDENTIFIERS\n// ============================================================================\n\nexport type JobId = string & { readonly __brand: 'JobId' };\nexport type UserDID = string & { readonly __brand: 'UserDID' };\nexport type EntityType = string & { readonly __brand: 'EntityType' };\nexport type SearchQuery = string & { readonly __brand: 'SearchQuery' };\nexport type BaseUrl = string & { readonly __brand: 'BaseUrl' };\n\n// ============================================================================\n// HELPER FUNCTIONS (minimal validation, just branding)\n// ============================================================================\n\nexport function email(value: string): Email { return value as Email; }\nexport function authCode(value: string): AuthCode { return value as AuthCode; }\nexport function googleCredential(value: string): GoogleCredential { return value as GoogleCredential; }\nexport function accessToken(value: string): AccessToken { return value as AccessToken; }\nexport function refreshToken(value: string): RefreshToken { return value as RefreshToken; }\nexport function mcpToken(value: string): MCPToken { return value as MCPToken; }\nexport function cloneToken(value: string): CloneToken { return value as CloneToken; }\nexport function jobId(value: string): JobId { return value as JobId; }\nexport function userDID(value: string): UserDID { return value as UserDID; }\nexport function entityType(value: string): EntityType { return value as EntityType; }\nexport function searchQuery(value: string): SearchQuery { return value as SearchQuery; }\nexport function baseUrl(value: string): BaseUrl { return value as BaseUrl; }\n\n// Motivation is an OpenAPI enum — use its values directly, no helper needed.\n// ContentFormat is a free-form MIME string whose base type must be a\n// SupportedMediaType; validation lives in media-types.ts, not in a brand.\n\n// ============================================================================\n// HTTP URI TYPES\n// ============================================================================\n\n// Branded type definitions for HTTP URIs returned by the API\nexport type ResourceUri = string & { readonly __brand: 'ResourceUri' };\n\n// W3C flat format for content negotiation: http://localhost:4000/annotations/{id}\nexport type AnnotationUri = string & { readonly __brand: 'AnnotationUri' };\n\n// Nested format for CRUD operations: http://localhost:4000/resources/{resourceId}/annotations/{annotationId}\nexport type ResourceAnnotationUri = string & { readonly __brand: 'ResourceAnnotationUri' };\n\n// Factory functions with runtime validation\nexport function resourceUri(uri: string): ResourceUri {\n  if (!uri.startsWith('http://') && !uri.startsWith('https://')) {\n    throw new TypeError(`Expected ResourceUri, got: ${uri}`);\n  }\n  return uri as ResourceUri;\n}\n\nexport function annotationUri(uri: string): AnnotationUri {\n  if (!uri.startsWith('http://') && !uri.startsWith('https://')) {\n    throw new TypeError(`Expected AnnotationUri, got: ${uri}`);\n  }\n  return uri as AnnotationUri;\n}\n\nexport function resourceAnnotationUri(uri: string): ResourceAnnotationUri {\n  if (!uri.startsWith('http://') && !uri.startsWith('https://')) {\n    throw new TypeError(`Expected ResourceAnnotationUri, got: ${uri}`);\n  }\n  // Additional validation: must contain /resources/ and /annotations/\n  if (!uri.includes('/resources/') || !uri.includes('/annotations/')) {\n    throw new TypeError(`Expected nested ResourceAnnotationUri format, got: ${uri}`);\n  }\n  return uri as ResourceAnnotationUri;\n}\n","// ⚠ GENERATED FILE — do not edit.\n//\n// Authority:   specs/src/bus/registry.json  (channels, payloads, operations)\n// Regenerate:  node scripts/bus/generate-ts.mjs\n// Go counterpart: node scripts/bus/generate-go.mjs → packages/sdk-go/bus\n//\n// Payload schemas themselves live in the OpenAPI components; the registry\n// names which one each channel carries. Add or change a channel THERE.\n\nimport type { EventName, EmittableChannel } from './bus-protocol';\n\n/**\n * BUS_OPERATIONS — the request/reply operations registry (Tier 1).\n *\n * Each entry declares ONE operation as the triple that was previously three\n * loose, independently-maintained facts spread across call sites:\n *   - the request channel (the key — an `EmittableChannel`),\n *   - the `result` channel (success reply),\n *   - the `failure` channel,\n *   - and, for a streaming op, an optional `progress` channel.\n *\n * `BridgedChannel` / `BRIDGED_CHANNELS` are DERIVED from this map\n * (bridged-channels.ts): every reply lands in the bridged fan-in set by\n * construction, so \"a reply channel forgotten from BRIDGED_CHANNELS\" — the\n * recurring bug class (gather:resource-complete, frame:*-add-failed) — is no\n * longer representable. See .plans/BUS-OPERATIONS-REGISTRY.md.\n *\n * `Partial<Record<EmittableChannel, …>>` enforces that every key is a real\n * emittable request. `result`/`failure`/`progress` stay `EventName` rather than\n * `BridgedChannel` to avoid a circular reference (BridgedChannel derives from\n * this map); the derivation closes the loop instead.\n */\nexport interface BusOperationSpec {\n  result: EventName;\n  failure: EventName;\n  /** Streaming ops only: an intermediate channel that also bridges. */\n  progress?: EventName;\n}\n\nexport const BUS_OPERATIONS = {\n  // ── BIND ────────────────────────────────────────────────────────\n  'bind:update-body':                    { result: 'bind:body-updated',              failure: 'bind:body-update-failed' },\n\n  // ── BROWSE (reads) ──────────────────────────────────────────────\n  'browse:resource-requested':           { result: 'browse:resource-result',         failure: 'browse:resource-failed' },\n  'browse:anchored-text-requested':      { result: 'browse:anchored-text-result',    failure: 'browse:anchored-text-failed' },\n  'browse:anchored-text-by-checksum-requested': { result: 'browse:anchored-text-by-checksum-result', failure: 'browse:anchored-text-by-checksum-failed' },\n  'browse:resources-requested':          { result: 'browse:resources-result',        failure: 'browse:resources-failed' },\n  'browse:annotation-requested':         { result: 'browse:annotation-result',       failure: 'browse:annotation-failed' },\n  'browse:annotations-requested':        { result: 'browse:annotations-result',      failure: 'browse:annotations-failed' },\n  'browse:annotation-history-requested': { result: 'browse:annotation-history-result', failure: 'browse:annotation-history-failed' },\n  'browse:events-requested':             { result: 'browse:events-result',           failure: 'browse:events-failed' },\n  'browse:referenced-by-requested':      { result: 'browse:referenced-by-result',    failure: 'browse:referenced-by-failed' },\n  'browse:entity-types-requested':       { result: 'browse:entity-types-result',     failure: 'browse:entity-types-failed' },\n  'browse:tag-schemas-requested':        { result: 'browse:tag-schemas-result',      failure: 'browse:tag-schemas-failed' },\n  'browse:agents-requested':             { result: 'browse:agents-result',           failure: 'browse:agents-failed' },\n  'browse:directory-requested':          { result: 'browse:directory-result',        failure: 'browse:directory-failed' },\n  // dormant — gateway handler complete, no client caller yet (annotation-detail capability)\n  'browse:annotation-context-requested': { result: 'browse:annotation-context-result', failure: 'browse:annotation-context-failed' },\n\n  // ── FRAME (KB schema writes) ────────────────────────────────────\n  'frame:add-entity-type':               { result: 'frame:entity-type-add-ok',       failure: 'frame:entity-type-add-failed' },\n  'frame:add-tag-schema':                { result: 'frame:tag-schema-add-ok',        failure: 'frame:tag-schema-add-failed' },\n\n  // ── GATHER ──────────────────────────────────────────────────────\n  // streaming: take-1 result + failure plus an intermediate progress channel\n  'gather:requested':                    { result: 'gather:complete',                failure: 'gather:failed', progress: 'gather:annotation-progress' },\n  'gather:resource-requested':           { result: 'gather:resource-complete',       failure: 'gather:resource-failed' },\n  // dormant — gateway handler complete, no client caller yet (annotation summary)\n  'gather:summary-requested':            { result: 'gather:summary-result',          failure: 'gather:summary-failed' },\n\n  // ── JOB ─────────────────────────────────────────────────────────\n  'job:create':                          { result: 'job:created',                    failure: 'job:create-failed' },\n  'job:status-requested':                { result: 'job:status-result',              failure: 'job:status-failed' },\n  'job:cancel-requested':                { result: 'job:cancel-ok',                  failure: 'job:cancel-failed' },\n  // worker-side: the worker claims a queued job (not an SDK call)\n  'job:claim':                           { result: 'job:claimed',                    failure: 'job:claim-failed' },\n\n  // ── MARK ────────────────────────────────────────────────────────\n  'mark:create-request':                 { result: 'mark:create-ok',                 failure: 'mark:create-failed' },\n  'mark:commit':                         { result: 'mark:commit-ok',                 failure: 'mark:commit-failed' },\n  'mark:delete':                         { result: 'mark:delete-ok',                 failure: 'mark:delete-failed' },\n  'mark:archive':                        { result: 'mark:archive-ok',                failure: 'mark:archive-failed' },\n  'mark:unarchive':                      { result: 'mark:unarchive-ok',              failure: 'mark:unarchive-failed' },\n  'mark:update-entity-types':            { result: 'mark:update-entity-types-ok',    failure: 'mark:update-entity-types-failed' },\n\n  // ── MATCH ───────────────────────────────────────────────────────\n  // take-1 dressed as an Observable in the SDK; no progress channel\n  'match:search-requested':              { result: 'match:search-results',           failure: 'match:search-failed' },\n\n  // ── WEAVE ───────────────────────────────────────────────────────\n  // Graph-projection rebuild, served by the Weaver (WEAVER-ISOLATION D3)\n  'weave:rebuild':                       { result: 'weave:rebuild-ok',               failure: 'weave:rebuild-failed' },\n\n  // ── SMELT ────────────────────────────────────────────\n  // Anchored-text rebuild, served by the Smelter (PERSIST-ANCHORS P0)\n  'smelt:rebuild-anchors':               { result: 'smelt:rebuild-anchors-ok',       failure: 'smelt:rebuild-anchors-failed' },\n\n  // ── YIELD ───────────────────────────────────────────────────────\n  // live in-process (resource-operations.ts emits + awaits via race()); the\n  // client also .on()-subscribes -ok for cache invalidation\n  'yield:create':                        { result: 'yield:create-ok',                failure: 'yield:create-failed' },\n  'yield:clone-persist':                 { result: 'yield:clone-persist-ok',         failure: 'yield:clone-persist-failed' },\n  // dormant — handler in stower exists, no request emitter; client pre-subscribes -ok\n  'yield:update':                        { result: 'yield:update-ok',                failure: 'yield:update-failed' },\n  'yield:clone-create':                  { result: 'yield:clone-created',            failure: 'yield:clone-create-failed' },\n  'yield:clone-resource-requested':      { result: 'yield:clone-resource-result',    failure: 'yield:clone-resource-failed' },\n  'yield:clone-token-requested':         { result: 'yield:clone-token-generated',    failure: 'yield:clone-token-failed' },\n} as const satisfies Partial<Record<EmittableChannel, BusOperationSpec>>;\n\n/** The request-channel key of a registered operation — what `busRequest` takes. */\nexport type BusOperationKey = keyof typeof BUS_OPERATIONS;\n","// ⚠ GENERATED FILE — do not edit.\n//\n// Authority:   specs/src/bus/registry.json  (channels, payloads, operations)\n// Regenerate:  node scripts/bus/generate-ts.mjs\n// Go counterpart: node scripts/bus/generate-go.mjs → packages/sdk-go/bus\n//\n// Payload schemas themselves live in the OpenAPI components; the registry\n// names which one each channel carries. Add or change a channel THERE.\n\nimport type { EventName } from './bus-protocol';\nimport { BUS_OPERATIONS } from './bus-operations';\n\n/**\n * BRIDGED_CHANNELS\n *\n * The set of bus channels that any concrete transport bridges into the\n * caller-supplied bus via `bridgeInto`. Transport-neutral: every concrete\n * `ITransport` shares the same set; HTTP delivers them via SSE, in-process\n * transports forward them directly from the local actor bus.\n *\n * This is the *fan-in* set — channels for events the transport receives and\n * pushes onto the client's bus. It is not the same as the channels the client\n * emits (which is open-ended).\n *\n * It is DERIVED, not hand-listed: the request/reply replies come from\n * `BUS_OPERATIONS` (bus-operations.ts), so no operation's reply can be\n * forgotten here — that was the recurring unbridged-reply bug class. The only\n * hand-maintained part is `BRIDGED_BROADCASTS`: the genuine non-request/reply\n * minority (lifecycle events and UI/infra signals that no single requester\n * owns). See .plans/BUS-OPERATIONS-REGISTRY.md.\n *\n * Resource-scoped channels (joined/left via `subscribeToResource`) are tracked\n * separately by transports that care about scope (HTTP).\n */\n\n/**\n * Bridged channels with no owning operation: job-lifecycle events (multi-viewer,\n * no single requester owns the reply), KB-global frame domain events, UI signals,\n * and SSE infrastructure. A reply channel must NOT go here — declare its\n * operation in `BUS_OPERATIONS` instead.\n */\nexport const BRIDGED_BROADCASTS = [\n  'job:report-progress',\n  'job:complete',\n  'job:fail',\n  'frame:entity-type-added',\n  'frame:tag-schema-added',\n  'yield:created',\n  'yield:updated',\n  'yield:cloned',\n  'yield:moved',\n  'beckon:focus',\n  'beckon:sparkle',\n  'bus:resume-gap',\n  'browse:resource-open',\n  'browse:resource-viewed',\n  'session:joined',\n  'session:left',\n  'browse:click',\n] as const satisfies readonly EventName[];\n\n// ── Derivation ──────────────────────────────────────────────────────────────\n// Every operation's result + failure (+ progress) channel bridges, by\n// construction. Type and runtime are derived from the same `BUS_OPERATIONS`.\n\ntype OpSpecs = (typeof BUS_OPERATIONS)[keyof typeof BUS_OPERATIONS];\n\n// Generic wrapper so the conditional distributes over each union member (a bare\n// `OpSpecs extends …` would test the whole union at once and collapse to never\n// because only the streaming ops carry `progress`).\ntype ProgressChannel<O> = O extends { progress: infer P extends EventName } ? P : never;\n\n/** The union of every reply channel declared in the registry. */\ntype RegistryReply = OpSpecs['result'] | OpSpecs['failure'] | ProgressChannel<OpSpecs>;\n\n// Iterate by typed key so each op's literal reply types survive — the element\n// type stays `RegistryReply` (no widening to `EventName`), so the composed\n// array is `BridgedChannel[]` with no narrowing assertion. The runtime proof\n// that this derived set is exactly the intended one is the equality test in\n// __tests__/bus-invariants.test.ts.\nconst REGISTRY_REPLIES = (Object.keys(BUS_OPERATIONS) as (keyof typeof BUS_OPERATIONS)[]).flatMap(\n  (key) => {\n    const op = BUS_OPERATIONS[key];\n    return 'progress' in op ? [op.result, op.failure, op.progress] : [op.result, op.failure];\n  },\n);\n\nexport const BRIDGED_CHANNELS: readonly BridgedChannel[] = [\n  ...REGISTRY_REPLIES,\n  ...BRIDGED_BROADCASTS,\n];\n\n/**\n * The SUBSCRIBE-side subset of `EventName` — the channels a client can receive\n * over a concrete transport. See the family note on `EventName` in\n * bus-protocol.ts (emit on an `EmittableChannel`, subscribe on a `BridgedChannel`).\n */\nexport type BridgedChannel = RegistryReply | (typeof BRIDGED_BROADCASTS)[number];\n","/**\n * Bus logging — runtime-toggleable cross-wire visibility.\n *\n * One line per event that crosses a process boundary, in a grep-able\n * format that's symmetric across frontend and gateway:\n *\n *   [bus EMIT] <channel> [scope=X] [cid=<first8>] <payload>\n *   [bus RECV] <channel> [scope=X] [cid=<first8>] <payload>\n *   [bus SSE]  <channel> [scope=X] [cid=<first8>] <payload>\n *\n * Tier 1 of `.plans/OBSERVABILITY.md`. Forward-compatible with Tier 2:\n * the `cid` printed here is exactly the prefix of the W3C trace-id we\n * adopt later.\n *\n * Cost when disabled: one property read per call, zero allocations.\n *\n * Enable:\n *   - Browser:  `window.__SEMIONT_BUS_LOG__ = true` (DevTools or e2e init)\n *   - Node:     `SEMIONT_BUS_LOG=1` in the process env (read at module load)\n */\n\nimport { BRIDGED_CHANNELS } from './bridged-channels';\n\nconst NODE_BUS_LOG =\n  typeof process !== 'undefined' && !!process.env?.SEMIONT_BUS_LOG;\n\nconst IS_NODE =\n  typeof process !== 'undefined' && !!process.versions?.node;\n\nexport type BusOp = 'EMIT' | 'RECV' | 'SSE' | 'PUT' | 'GET';\n\nexport function busLogEnabled(): boolean {\n  const g = globalThis as { __SEMIONT_BUS_LOG__?: boolean };\n  if (g.__SEMIONT_BUS_LOG__) return true;\n  return NODE_BUS_LOG;\n}\n\n/**\n * Optional active-span trace-id provider. When a Tier 2 OTel SDK is\n * initialized, `@semiont/observability` registers a provider here that\n * returns the active span's W3C `trace_id`. busLog appends it to each\n * emitted line so the grep-timeline correlates with the span tree in\n * an APM UI.\n *\n * Decoupling: `@semiont/core` does not depend on `@opentelemetry/api`.\n * If no provider is registered (Tier 1-only deployments, or before\n * `initObservabilityNode` runs), the field is omitted from the line —\n * same shape as before this hook existed.\n */\nlet traceIdProvider: (() => string | undefined) | undefined;\n\nexport function setBusLogTraceIdProvider(fn: (() => string | undefined) | undefined): void {\n  traceIdProvider = fn;\n}\n\nexport function busLog(\n  op: BusOp,\n  channel: string,\n  payload: unknown,\n  scope?: string,\n): void {\n  if (!busLogEnabled()) return;\n  const cidRaw = (payload as { correlationId?: unknown } | null | undefined)?.correlationId;\n  const cid = typeof cidRaw === 'string' ? cidRaw.slice(0, 8) : undefined;\n  let traceId: string | undefined;\n  if (traceIdProvider) {\n    try { traceId = traceIdProvider(); } catch { /* noop */ }\n  }\n  const tag =\n    `[bus ${op}] ${channel}` +\n    (scope ? ` scope=${scope}` : '') +\n    (cid ? ` cid=${cid}` : '') +\n    (traceId ? ` trace=${traceId.slice(0, 8)}` : '');\n  // eslint-disable-next-line no-console\n  console.debug(tag, payload);\n}\n\n/**\n * Whether to run the unobserved-reply check on every local emit.\n *\n * On in Node (gateway + worker + smelter), where a dropped reply is a real\n * delivery bug; off in the browser, where a 0-observer bridged reply just\n * means the awaiting `busRequest` already resolved/timed out (benign).\n *\n * Always-on (no env flag) by design: the failure it catches is rare and\n * high-signal, and the whole point is that it fires with zero setup — the\n * incident that motivated it (.plans/bugs/gather-resource-complete-not-bridged.md)\n * ran with bus-logging off, so a flag-gated check would have stayed silent.\n */\nexport function warnUnobservedRepliesEnabled(): boolean {\n  return IS_NODE;\n}\n\n/** One line per channel per process — a missing fan-in wiring is a config\n *  bug, so the first dropped reply is enough; we don't spam on retries. */\nconst unobservedReplyWarned = new Set<string>();\n\n/**\n * The silent-dropped-reply detector.\n *\n * A correlation-bearing payload is a request/reply *reply* (`*-result`,\n * `*-complete`, `*-failed`, …). If one is emitted on the gateway bus with\n * **zero local observers**, nothing forwards it — no SSE subscription, no\n * in-process consumer — so the awaiting client never receives it and times\n * out 30 s later with no error logged anywhere. That is exactly how\n * `gather:resource-complete` failed when it was missing from\n * `BRIDGED_CHANNELS` (.plans/bugs/gather-resource-complete-not-bridged.md).\n *\n * Emits one WARN per channel naming the likely fix. Ignored (no warning):\n * non-reply emits (no `correlationId`), emits with observers, and — crucially —\n * channels already in `BRIDGED_CHANNELS`: a 0-observer emit there is a redundant\n * copy, not a gap (see .plans/bugs/BRIDGE-GAPS.md). So the detector fires only\n * for a genuine missing forwarder, and its remediation text is always correct.\n */\nexport function warnIfUnobservedReply(\n  channel: string,\n  payload: unknown,\n  observerCount: number,\n): void {\n  if (observerCount > 0) return;\n  const cidRaw = (payload as { correlationId?: unknown } | null | undefined)?.correlationId;\n  if (typeof cidRaw !== 'string' || cidRaw.length === 0) return;\n  // A 0-observer emit on a *bridged* channel is a redundant copy (a global +\n  // resource-scoped dual-emit, or an SSE reconnect replay), not a missing\n  // forwarder — the first copy already reached the awaiting `take(1)`\n  // subscriber. Only a NOT-bridged channel is a genuine drop. (`busRequest` now\n  // types its reply channels `BridgedChannel`, so an unbridged reply is a\n  // compile error; this runtime check covers non-`busRequest` correlation\n  // emits.) See .plans/bugs/BRIDGE-GAPS.md.\n  if ((BRIDGED_CHANNELS as readonly string[]).includes(channel)) return;\n  if (unobservedReplyWarned.has(channel)) return;\n  unobservedReplyWarned.add(channel);\n  // eslint-disable-next-line no-console\n  console.warn(\n    `[bus DROP] ${channel} cid=${cidRaw.slice(0, 8)} emitted with 0 subscribers and not in ` +\n      `BRIDGED_CHANNELS — a correlation reply with no forwarder is dropped, so the awaiting ` +\n      `client times out (no error). Bridge it by declaring its operation in BUS_OPERATIONS ` +\n      `(packages/core/src/bus-operations.ts) — or, if it is a non-reply broadcast, add it to ` +\n      `BRIDGED_BROADCASTS (packages/core/src/bridged-channels.ts) — so transports subscribe to it.`,\n  );\n}\n","/**\n * RxJS-based Event Bus\n *\n * Framework-agnostic event bus providing direct access to typed RxJS Subjects.\n *\n * Can be used in Node.js, browser, workers, CLI - anywhere RxJS runs.\n */\n\nimport { Subject } from 'rxjs';\nimport { busLog, busLogEnabled, warnIfUnobservedReply, warnUnobservedRepliesEnabled } from './bus-log';\nimport type { EventMap } from './bus-protocol';\nimport type { StoredEvent } from './event-base';\nimport type { PersistedEventType } from './persisted-events';\n\n/**\n * RxJS-based event bus\n *\n * Provides direct access to RxJS Subjects for each event type.\n * Use standard RxJS patterns for emitting and subscribing.\n *\n * @example\n * ```typescript\n * const eventBus = new EventBus();\n *\n * // Emit events\n * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });\n *\n * // Subscribe to events\n * const subscription = eventBus.get('beckon:hover').subscribe(({ annotationId }) => {\n *   console.log('Hover:', annotationId);\n * });\n *\n * // Use RxJS operators\n * import { debounceTime } from 'rxjs/operators';\n * eventBus.get('beckon:hover')\n *   .pipe(debounceTime(100))\n *   .subscribe(handleHover);\n *\n * // Cleanup\n * subscription.unsubscribe();\n * eventBus.destroy();\n * ```\n */\nexport class EventBus {\n  private subjects: Map<keyof EventMap, Subject<any>>;\n  private isDestroyed: boolean;\n\n  constructor() {\n    this.subjects = new Map();\n    this.isDestroyed = false;\n  }\n\n  /**\n   * Get the RxJS Subject for an event\n   *\n   * Returns a typed Subject that can be used with all RxJS operators.\n   * Subjects are created lazily on first access.\n   *\n   * @param eventName - The event name\n   * @returns The RxJS Subject for this event\n   *\n   * @example\n   * ```typescript\n   * // Emit\n   * eventBus.get('beckon:hover').next({ annotationId: 'ann-1' });\n   *\n   * // Subscribe\n   * const sub = eventBus.get('beckon:hover').subscribe(handleHover);\n   *\n   * // With operators\n   * eventBus.get('beckon:hover')\n   *   .pipe(debounceTime(100), distinctUntilChanged())\n   *   .subscribe(handleHover);\n   * ```\n   */\n  get<K extends keyof EventMap>(eventName: K): Subject<EventMap[K]> {\n    if (this.isDestroyed) {\n      throw new Error(`Cannot access event '${String(eventName)}' on destroyed bus`);\n    }\n\n    if (!this.subjects.has(eventName)) {\n      const subject = new Subject<EventMap[K]>();\n      // When bus-log is enabled (`SEMIONT_BUS_LOG=1` or\n      // `window.__SEMIONT_BUS_LOG__ = true`), wrap `.next()` so every\n      // local emit on this channel produces a `[bus EMIT] <channel> ...`\n      // line on `console.debug` — same shape as cross-wire emits from\n      // HttpTransport. This is what makes local-only fan-out signals\n      // (`beckon.hover`, `beckon.sparkle`, `mark.request`, etc.)\n      // visible to the e2e bus capture and to a developer's DevTools.\n      // The `busLogEnabled()` check is at first-`get` time per channel;\n      // setting the flag after channels are constructed won't\n      // retroactively wrap them. The bus capture fixture uses\n      // `addInitScript` so the flag is set before any namespace\n      // construction, which is when `get()` is first called.\n      //\n      // Independently, on Node we wrap `.next()` to catch *dropped replies*:\n      // a correlation-bearing payload emitted with zero observers (see\n      // `warnIfUnobservedReply`). This needs no flag — it's how the\n      // `gather:resource-complete` bridge gap stayed invisible until a 30 s\n      // timeout. The two wraps share one closure when both are active.\n      const wantBusLog = busLogEnabled();\n      const wantDropCheck = warnUnobservedRepliesEnabled();\n      if (wantBusLog || wantDropCheck) {\n        const wrapped = subject;\n        const originalNext = subject.next.bind(subject);\n        subject.next = (value: EventMap[K]): void => {\n          if (wantBusLog) busLog('EMIT', String(eventName), value as object);\n          if (wantDropCheck) warnIfUnobservedReply(String(eventName), value, wrapped.observers.length);\n          originalNext(value);\n        };\n      }\n      this.subjects.set(eventName, subject);\n    }\n    return this.subjects.get(eventName)!;\n  }\n\n  /**\n   * Get the RxJS Subject for a domain event type (PersistedEventType).\n   *\n   * Domain event channels carry `StoredEvent`. This method avoids the need\n   * for `as keyof EventMap` casts when subscribing to domain event channels\n   * using runtime `PersistedEventType` strings.\n   */\n  getDomainEvent(eventType: PersistedEventType): Subject<StoredEvent> {\n    return this.get(eventType as keyof EventMap) as unknown as Subject<StoredEvent>;\n  }\n\n  /**\n   * Channel names with at least one live observer right now. Introspection\n   * for composition-parity gates: `get()` creates subjects lazily, so mere\n   * access does not count — only real subscriptions do. Scoped channels\n   * appear under their namespaced key (`<scope>:<channel>`).\n   */\n  observedChannels(): string[] {\n    const out: string[] = [];\n    for (const [name, subject] of this.subjects) {\n      if (subject.observed) out.push(String(name));\n    }\n    return out;\n  }\n\n  /**\n   * Destroy the event bus and complete all subjects\n   *\n   * After calling destroy(), no new events can be emitted or subscribed to.\n   * All active subscriptions will be completed.\n   */\n  destroy(): void {\n    if (this.isDestroyed) {\n      return;\n    }\n\n    for (const subject of this.subjects.values()) {\n      subject.complete();\n    }\n\n    this.subjects.clear();\n    this.isDestroyed = true;\n  }\n\n  /**\n   * Check if the event bus has been destroyed\n   */\n  get destroyed(): boolean {\n    return this.isDestroyed;\n  }\n\n  /**\n   * Create a resource-scoped event bus\n   *\n   * Events emitted or subscribed through the scoped bus are isolated to that resource.\n   * Internally, events are namespaced but the API remains identical to the parent bus.\n   *\n   * @param resourceId - Resource identifier to scope events to\n   * @returns A scoped event bus for this resource\n   *\n   * @example\n   * ```typescript\n   * const eventBus = new EventBus();\n   * const resource1 = eventBus.scope('resource-1');\n   * const resource2 = eventBus.scope('resource-2');\n   *\n   * // These are isolated - only resource1 subscribers will fire\n   * resource1.get('detection:progress').next({ status: 'started' });\n   * ```\n   */\n  scope(resourceId: string): ScopedEventBus {\n    return new ScopedEventBus(this, resourceId);\n  }\n}\n\n/**\n * Resource-scoped event bus\n *\n * Provides isolated event streams per resource while maintaining the same API\n * as the parent EventBus. Events are internally namespaced by resourceId.\n */\nexport class ScopedEventBus {\n  constructor(\n    private parent: EventBus,\n    private scopePrefix: string\n  ) {}\n\n  /**\n   * Get the RxJS Subject for a scoped event\n   *\n   * Returns the same type as the parent bus, but events are isolated to this scope.\n   * Internally uses namespaced keys but preserves type safety.\n   *\n   * @param event - The event name\n   * @returns The RxJS Subject for this scoped event\n   */\n  get<E extends keyof EventMap>(event: E): Subject<EventMap[E]> {\n    // Internally namespace the event key, but preserve return type\n    const scopedKey = `${this.scopePrefix}:${event as string}`;\n\n    // Access parent's subjects map directly (needs cast for private access)\n    const parentSubjects = (this.parent as any).subjects as Map<string, Subject<any>>;\n\n    if (!parentSubjects.has(scopedKey)) {\n      parentSubjects.set(scopedKey, new Subject<EventMap[E]>());\n    }\n    return parentSubjects.get(scopedKey)!;\n  }\n\n  /** Get the RxJS Subject for a domain event type on this scoped bus. */\n  getDomainEvent(eventType: PersistedEventType): Subject<StoredEvent> {\n    return this.get(eventType as keyof EventMap) as unknown as Subject<StoredEvent>;\n  }\n\n  /**\n   * Create a nested scope\n   *\n   * Allows hierarchical scoping like `resource-1:subsystem-a`\n   *\n   * @param subScope - Additional scope level\n   * @returns A nested scoped event bus\n   */\n  scope(subScope: string): ScopedEventBus {\n    return new ScopedEventBus(this.parent, `${this.scopePrefix}:${subScope}`);\n  }\n}\n"]}

package/dist/{chunk-PPUO5IPX.js → chunk-IQGH6UJN.js}

@@ -1,4 +1,4 @@
-import { baseUrl, EventBus, BRIDGED_CHANNELS, BUS_OPERATIONS } from './chunk-CUPZGI7I.js';
+import { baseUrl, EventBus, BRIDGED_CHANNELS, BUS_OPERATIONS } from './chunk-EWOITHBH.js';
 import { BehaviorSubject, Subject } from 'rxjs';
 
 function isOperation(channel) {
@@ -28,13 +28,13 @@ var FaultyTransport = class {
   }
   /**
    * Queue responses for `op`, consumed FIFO — one per request that reaches
-   * the simulated backend — before falling back to `makeResponse`
-   * (SDK-TESTING-DOUBLE.md, gap 2). The queue scripts the BACKEND; the fault
+   * the simulated gateway — before falling back to `makeResponse`
+   * (SDK-TESTING-DOUBLE.md, gap 2). The queue scripts the GATEWAY; the fault
    * schedule scripts the WIRE. Consequences, deliberately: `duplicate-reply`
    * replays one entry's body twice, and a `drop-reply` still consumes its
-   * entry (the backend answered; the wire ate it) — so "first reply lost,
+   * entry (the gateway answered; the wire ate it) — so "first reply lost,
    * the retry sees the NEXT page" is expressible. `reject-emit` consumes
-   * nothing: that request never reached the backend.
+   * nothing: that request never reached the gateway.
    */
   queueReply(op, ...responses) {
     const q = this.replyQueues.get(op) ?? [];
@@ -140,5 +140,5 @@ var FaultyTransport = class {
 };
 
 export { FaultyTransport, retryKeyOf };
-//# sourceMappingURL=chunk-PPUO5IPX.js.map
-//# sourceMappingURL=chunk-PPUO5IPX.js.map
+//# sourceMappingURL=chunk-IQGH6UJN.js.map
+//# sourceMappingURL=chunk-IQGH6UJN.js.map

package/dist/{chunk-PPUO5IPX.js.map → chunk-IQGH6UJN.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/faulty-transport.ts"],"names":[],"mappings":"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","file":"chunk-PPUO5IPX.js","sourcesContent":["/**\n * FaultyTransport — a seeded, scriptable `ITransport` simulator for the\n * liveness axioms (`.plans/LIVENESS-AXIOMS.md`). fast-check draws a fault\n * schedule; the transport applies one `FaultAction` per request-channel emit\n * and synthesizes replies from the `BUS_OPERATIONS` registry, so real\n * compositions (`busRequest`, SWR caches, live queries) run unmodified against\n * generated wire behavior no hand-written test names.\n *\n * Home is core (not sdk/test-utils) for the same reason as\n * `assertStateUnitAxioms`: it needs only core types, and every layer —\n * including `http-transport`, below sdk — can consume it via\n * `@semiont/core/testing` without a dependency cycle.\n *\n * Deterministic-by-construction: no `Date.now`, no randomness of its own —\n * all variation comes in through the schedule (fast-check owns the seed).\n * Time is real `setTimeout` at millisecond scale; properties pass a small\n * explicit `timeoutMs` to `busRequest`, so nothing waits 30 s.\n */\n\nimport { BehaviorSubject, Subject, type Observable } from 'rxjs';\nimport type { SemiontError } from './errors';\nimport type { BaseUrl } from './branded-types';\nimport { baseUrl as makeBaseUrl } from './branded-types';\nimport type { ResourceId } from './identifiers';\nimport type { EventMap } from './bus-protocol';\nimport type { ConnectionState, ITransport } from './transport';\nimport { EventBus } from './event-bus';\nimport { BRIDGED_CHANNELS } from './bridged-channels';\nimport { BUS_OPERATIONS, type BusOperationKey } from './bus-operations';\n\n/** One wire behavior, applied to a single request-channel emit. */\nexport type FaultAction =\n  | { kind: 'deliver' }\n  | { kind: 'drop-reply' }\n  | { kind: 'delay'; ms: number }\n  | { kind: 'duplicate-reply' }\n  | { kind: 'reject-emit' };\n\n/** requestLog entry — one per request-channel emit, in arrival order. */\nexport interface RequestLogEntry {\n  channel: BusOperationKey;\n  /** The action the schedule assigned to this emit. */\n  action: FaultAction;\n  correlationId: string | undefined;\n  /**\n   * Request identity for retry accounting: channel + payload minus the\n   * per-issue fields (`correlationId`, `_trace`, `_userId`). Two emits with\n   * the same key are the same logical request re-issued.\n   */\n  retryKey: string;\n  /**\n   * The payload as emitted — envelope, options, params, `correlationId` and\n   * all. This is the surface for \"assert what my orchestrator actually SENT\"\n   * (SDK-TESTING-DOUBLE gap 6): without it every consumer harness re-invented\n   * a per-channel `transport.on(...)` wire recorder alongside this log.\n   *\n   * SHALLOW snapshot: the top level is copied at emit time, so a caller that\n   * mutates its own payload object afterwards cannot rewrite history. Nested\n   * objects are shared by reference — deep-freeze is not worth the cost in a\n   * double, and no in-repo caller mutates nested request payloads.\n   */\n  payload: Record<string, unknown>;\n}\n\nexport interface FaultyTransportConfig {\n  /**\n   * The i-th request-channel emit applies `schedule[i % schedule.length]`.\n   * Empty/omitted → every request delivers.\n   */\n  schedule?: readonly FaultAction[];\n  /**\n   * Synthesize the `response` value for a delivered reply. Return `undefined`\n   * for a void ack (`{ correlationId }` only). Default: `{}` for every op.\n   */\n  makeResponse?: (operation: BusOperationKey, payload: Record<string, unknown>) => unknown;\n}\n\nfunction isOperation(channel: string): channel is BusOperationKey {\n  return channel in BUS_OPERATIONS;\n}\n\n/** Stable request identity: channel + sorted payload minus per-issue fields. */\nexport function retryKeyOf(channel: string, payload: Record<string, unknown>): string {\n  const entries = Object.entries(payload)\n    .filter(([k]) => k !== 'correlationId' && k !== '_trace' && k !== '_userId')\n    .sort(([a], [b]) => (a < b ? -1 : 1));\n  return `${channel} ${JSON.stringify(entries)}`;\n}\n\nexport class FaultyTransport implements ITransport {\n  readonly baseUrl: BaseUrl = makeBaseUrl('faulty://simulator');\n  readonly state$ = new BehaviorSubject<ConnectionState>('open');\n  private readonly errorsSubject = new Subject<SemiontError>();\n  readonly errors$: Observable<SemiontError> = this.errorsSubject.asObservable();\n\n  /** Every request-channel emit, in order — the L2 accounting surface. */\n  readonly requestLog: RequestLogEntry[] = [];\n\n  private readonly bus = new EventBus();\n  private readonly schedule: readonly FaultAction[];\n  private readonly makeResponse: (op: BusOperationKey, payload: Record<string, unknown>) => unknown;\n  private readonly replyQueues = new Map<BusOperationKey, unknown[]>();\n  private requestCount = 0;\n  private readonly timers = new Set<ReturnType<typeof setTimeout>>();\n  private disposed = false;\n\n  constructor(cfg: FaultyTransportConfig = {}) {\n    this.schedule = cfg.schedule ?? [];\n    this.makeResponse = cfg.makeResponse ?? (() => ({}));\n  }\n\n  /**\n   * Queue responses for `op`, consumed FIFO — one per request that reaches\n   * the simulated backend — before falling back to `makeResponse`\n   * (SDK-TESTING-DOUBLE.md, gap 2). The queue scripts the BACKEND; the fault\n   * schedule scripts the WIRE. Consequences, deliberately: `duplicate-reply`\n   * replays one entry's body twice, and a `drop-reply` still consumes its\n   * entry (the backend answered; the wire ate it) — so \"first reply lost,\n   * the retry sees the NEXT page\" is expressible. `reject-emit` consumes\n   * nothing: that request never reached the backend.\n   */\n  queueReply(op: BusOperationKey, ...responses: unknown[]): void {\n    const q = this.replyQueues.get(op) ?? [];\n    q.push(...responses);\n    this.replyQueues.set(op, q);\n  }\n\n  // ── Bus primitives ──────────────────────────────────────────────────────\n\n  async emit<K extends keyof EventMap>(\n    channel: K,\n    payload: EventMap[K],\n    resourceScope?: ResourceId,\n  ): Promise<number> {\n    // The double models exactly one connected participant, so a delivered\n    // emit reports `1`; post-dispose it is inert and reports the `-1`\n    // \"count unknown\" sentinel.\n    if (this.disposed) return -1;\n    const name = channel as string;\n    if (!isOperation(name)) {\n      // Non-request channel: forward as-is (scoped or global).\n      const target = resourceScope === undefined\n        ? this.bus.get(channel)\n        : this.bus.scope(resourceScope as string).get(channel);\n      target.next(payload);\n      return 1;\n    }\n\n    const record = payload as Record<string, unknown>;\n    const action: FaultAction = this.schedule.length === 0\n      ? { kind: 'deliver' }\n      : this.schedule[this.requestCount % this.schedule.length]!;\n    this.requestCount += 1;\n    this.requestLog.push({\n      channel: name,\n      action,\n      correlationId: typeof record.correlationId === 'string' ? record.correlationId : undefined,\n      retryKey: retryKeyOf(name, record),\n      payload: { ...record },\n    });\n\n    if (action.kind === 'reject-emit') {\n      // Models a /bus/emit 4xx: the request never reaches the bus.\n      throw new Error(`FaultyTransport: emit rejected by schedule (reject-emit) on ${name}`);\n    }\n\n    // The request itself is observable (handlers-eye view), then the\n    // simulator plays backend: synthesize the registry reply per the action.\n    this.bus.get(channel).next(payload);\n\n    // The backend's answer is computed ONCE per request that reaches it —\n    // the reply QUEUE scripts the backend, the fault schedule scripts the\n    // wire (SDK-TESTING-DOUBLE.md Phase 2). So `duplicate-reply` replays the\n    // same body twice, and a `drop-reply` still consumes its queue entry:\n    // the backend answered, the wire ate it.\n    const queue = this.replyQueues.get(name);\n    const response = queue && queue.length > 0 ? queue.shift() : this.makeResponse(name, record);\n\n    const reply = (): void => {\n      if (this.disposed) return;\n      const replyPayload = response === undefined\n        ? { correlationId: record.correlationId }\n        : { correlationId: record.correlationId, response };\n      const resultChannel = BUS_OPERATIONS[name].result as keyof EventMap;\n      this.bus.get(resultChannel).next(replyPayload as EventMap[keyof EventMap]);\n    };\n\n    switch (action.kind) {\n      case 'deliver':\n        queueMicrotask(reply);\n        break;\n      case 'duplicate-reply':\n        queueMicrotask(reply);\n        queueMicrotask(reply);\n        break;\n      case 'delay': {\n        const t = setTimeout(() => { this.timers.delete(t); reply(); }, action.ms);\n        this.timers.add(t);\n        break;\n      }\n      case 'drop-reply':\n        break;\n    }\n    return 1;\n  }\n\n  on<K extends keyof EventMap>(channel: K, handler: (payload: EventMap[K]) => void): () => void {\n    const sub = this.bus.get(channel).subscribe(handler);\n    return () => sub.unsubscribe();\n  }\n\n  stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]> {\n    return this.bus.get(channel);\n  }\n\n  subscribeToResource(_rid: ResourceId): () => void {\n    // Mirrors the real HttpTransport: distinct scopes COMPOSE\n    // (MULTI-RESOURCE-SCOPE). Delivery here is bus-direct and never\n    // scope-gated, so acquisition needs no bookkeeping and release\n    // (idempotent by construction) is a no-op.\n    return () => {};\n  }\n\n  /**\n   * Correlated-reply tracking (BUS-RESUMPTION.md Phase 2 / SDK-DEBT S1),\n   * exposed for assertions: `busRequest` registers each cid here before its\n   * emit and releases on settle, so a test can pin the tracked set at any\n   * point of a request's lifecycle. Delivery in this double is bus-direct\n   * (nothing to replay), so tracking has no behavioral effect.\n   */\n  readonly pendingReplies = new Set<string>();\n\n  trackReply(correlationId: string): () => void {\n    this.pendingReplies.add(correlationId);\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.pendingReplies.delete(correlationId);\n    };\n  }\n\n  bridgeInto(bus: EventBus): void {\n    for (const channel of BRIDGED_CHANNELS) {\n      this.bus.get(channel as keyof EventMap).subscribe((payload) => {\n        bus.get(channel as keyof EventMap).next(payload as EventMap[keyof EventMap]);\n      });\n    }\n  }\n\n  // ── Lifecycle ───────────────────────────────────────────────────────────\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    for (const t of this.timers) clearTimeout(t);\n    this.timers.clear();\n    this.state$.next('closed');\n    this.state$.complete();\n    this.errorsSubject.complete();\n    // Completes every subject: in-flight busRequests resolve `bus.closed`.\n    this.bus.destroy();\n  }\n}\n"]}
+{"version":3,"sources":["../src/faulty-transport.ts"],"names":[],"mappings":"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","file":"chunk-IQGH6UJN.js","sourcesContent":["/**\n * FaultyTransport — a seeded, scriptable `ITransport` simulator for the\n * liveness axioms (`.plans/LIVENESS-AXIOMS.md`). fast-check draws a fault\n * schedule; the transport applies one `FaultAction` per request-channel emit\n * and synthesizes replies from the `BUS_OPERATIONS` registry, so real\n * compositions (`busRequest`, SWR caches, live queries) run unmodified against\n * generated wire behavior no hand-written test names.\n *\n * Home is core (not sdk/test-utils) for the same reason as\n * `assertStateUnitAxioms`: it needs only core types, and every layer —\n * including `http-transport`, below sdk — can consume it via\n * `@semiont/core/testing` without a dependency cycle.\n *\n * Deterministic-by-construction: no `Date.now`, no randomness of its own —\n * all variation comes in through the schedule (fast-check owns the seed).\n * Time is real `setTimeout` at millisecond scale; properties pass a small\n * explicit `timeoutMs` to `busRequest`, so nothing waits 30 s.\n */\n\nimport { BehaviorSubject, Subject, type Observable } from 'rxjs';\nimport type { SemiontError } from './errors';\nimport type { BaseUrl } from './branded-types';\nimport { baseUrl as makeBaseUrl } from './branded-types';\nimport type { ResourceId } from './identifiers';\nimport type { EventMap } from './bus-protocol';\nimport type { ConnectionState, ITransport } from './transport';\nimport { EventBus } from './event-bus';\nimport { BRIDGED_CHANNELS } from './bridged-channels';\nimport { BUS_OPERATIONS, type BusOperationKey } from './bus-operations';\n\n/** One wire behavior, applied to a single request-channel emit. */\nexport type FaultAction =\n  | { kind: 'deliver' }\n  | { kind: 'drop-reply' }\n  | { kind: 'delay'; ms: number }\n  | { kind: 'duplicate-reply' }\n  | { kind: 'reject-emit' };\n\n/** requestLog entry — one per request-channel emit, in arrival order. */\nexport interface RequestLogEntry {\n  channel: BusOperationKey;\n  /** The action the schedule assigned to this emit. */\n  action: FaultAction;\n  correlationId: string | undefined;\n  /**\n   * Request identity for retry accounting: channel + payload minus the\n   * per-issue fields (`correlationId`, `_trace`, `_userId`). Two emits with\n   * the same key are the same logical request re-issued.\n   */\n  retryKey: string;\n  /**\n   * The payload as emitted — envelope, options, params, `correlationId` and\n   * all. This is the surface for \"assert what my orchestrator actually SENT\"\n   * (SDK-TESTING-DOUBLE gap 6): without it every consumer harness re-invented\n   * a per-channel `transport.on(...)` wire recorder alongside this log.\n   *\n   * SHALLOW snapshot: the top level is copied at emit time, so a caller that\n   * mutates its own payload object afterwards cannot rewrite history. Nested\n   * objects are shared by reference — deep-freeze is not worth the cost in a\n   * double, and no in-repo caller mutates nested request payloads.\n   */\n  payload: Record<string, unknown>;\n}\n\nexport interface FaultyTransportConfig {\n  /**\n   * The i-th request-channel emit applies `schedule[i % schedule.length]`.\n   * Empty/omitted → every request delivers.\n   */\n  schedule?: readonly FaultAction[];\n  /**\n   * Synthesize the `response` value for a delivered reply. Return `undefined`\n   * for a void ack (`{ correlationId }` only). Default: `{}` for every op.\n   */\n  makeResponse?: (operation: BusOperationKey, payload: Record<string, unknown>) => unknown;\n}\n\nfunction isOperation(channel: string): channel is BusOperationKey {\n  return channel in BUS_OPERATIONS;\n}\n\n/** Stable request identity: channel + sorted payload minus per-issue fields. */\nexport function retryKeyOf(channel: string, payload: Record<string, unknown>): string {\n  const entries = Object.entries(payload)\n    .filter(([k]) => k !== 'correlationId' && k !== '_trace' && k !== '_userId')\n    .sort(([a], [b]) => (a < b ? -1 : 1));\n  return `${channel} ${JSON.stringify(entries)}`;\n}\n\nexport class FaultyTransport implements ITransport {\n  readonly baseUrl: BaseUrl = makeBaseUrl('faulty://simulator');\n  readonly state$ = new BehaviorSubject<ConnectionState>('open');\n  private readonly errorsSubject = new Subject<SemiontError>();\n  readonly errors$: Observable<SemiontError> = this.errorsSubject.asObservable();\n\n  /** Every request-channel emit, in order — the L2 accounting surface. */\n  readonly requestLog: RequestLogEntry[] = [];\n\n  private readonly bus = new EventBus();\n  private readonly schedule: readonly FaultAction[];\n  private readonly makeResponse: (op: BusOperationKey, payload: Record<string, unknown>) => unknown;\n  private readonly replyQueues = new Map<BusOperationKey, unknown[]>();\n  private requestCount = 0;\n  private readonly timers = new Set<ReturnType<typeof setTimeout>>();\n  private disposed = false;\n\n  constructor(cfg: FaultyTransportConfig = {}) {\n    this.schedule = cfg.schedule ?? [];\n    this.makeResponse = cfg.makeResponse ?? (() => ({}));\n  }\n\n  /**\n   * Queue responses for `op`, consumed FIFO — one per request that reaches\n   * the simulated gateway — before falling back to `makeResponse`\n   * (SDK-TESTING-DOUBLE.md, gap 2). The queue scripts the GATEWAY; the fault\n   * schedule scripts the WIRE. Consequences, deliberately: `duplicate-reply`\n   * replays one entry's body twice, and a `drop-reply` still consumes its\n   * entry (the gateway answered; the wire ate it) — so \"first reply lost,\n   * the retry sees the NEXT page\" is expressible. `reject-emit` consumes\n   * nothing: that request never reached the gateway.\n   */\n  queueReply(op: BusOperationKey, ...responses: unknown[]): void {\n    const q = this.replyQueues.get(op) ?? [];\n    q.push(...responses);\n    this.replyQueues.set(op, q);\n  }\n\n  // ── Bus primitives ──────────────────────────────────────────────────────\n\n  async emit<K extends keyof EventMap>(\n    channel: K,\n    payload: EventMap[K],\n    resourceScope?: ResourceId,\n  ): Promise<number> {\n    // The double models exactly one connected participant, so a delivered\n    // emit reports `1`; post-dispose it is inert and reports the `-1`\n    // \"count unknown\" sentinel.\n    if (this.disposed) return -1;\n    const name = channel as string;\n    if (!isOperation(name)) {\n      // Non-request channel: forward as-is (scoped or global).\n      const target = resourceScope === undefined\n        ? this.bus.get(channel)\n        : this.bus.scope(resourceScope as string).get(channel);\n      target.next(payload);\n      return 1;\n    }\n\n    const record = payload as Record<string, unknown>;\n    const action: FaultAction = this.schedule.length === 0\n      ? { kind: 'deliver' }\n      : this.schedule[this.requestCount % this.schedule.length]!;\n    this.requestCount += 1;\n    this.requestLog.push({\n      channel: name,\n      action,\n      correlationId: typeof record.correlationId === 'string' ? record.correlationId : undefined,\n      retryKey: retryKeyOf(name, record),\n      payload: { ...record },\n    });\n\n    if (action.kind === 'reject-emit') {\n      // Models a /bus/emit 4xx: the request never reaches the bus.\n      throw new Error(`FaultyTransport: emit rejected by schedule (reject-emit) on ${name}`);\n    }\n\n    // The request itself is observable (handlers-eye view), then the\n    // simulator plays gateway: synthesize the registry reply per the action.\n    this.bus.get(channel).next(payload);\n\n    // The gateway's answer is computed ONCE per request that reaches it —\n    // the reply QUEUE scripts the gateway, the fault schedule scripts the\n    // wire (SDK-TESTING-DOUBLE.md Phase 2). So `duplicate-reply` replays the\n    // same body twice, and a `drop-reply` still consumes its queue entry:\n    // the gateway answered, the wire ate it.\n    const queue = this.replyQueues.get(name);\n    const response = queue && queue.length > 0 ? queue.shift() : this.makeResponse(name, record);\n\n    const reply = (): void => {\n      if (this.disposed) return;\n      const replyPayload = response === undefined\n        ? { correlationId: record.correlationId }\n        : { correlationId: record.correlationId, response };\n      const resultChannel = BUS_OPERATIONS[name].result as keyof EventMap;\n      this.bus.get(resultChannel).next(replyPayload as EventMap[keyof EventMap]);\n    };\n\n    switch (action.kind) {\n      case 'deliver':\n        queueMicrotask(reply);\n        break;\n      case 'duplicate-reply':\n        queueMicrotask(reply);\n        queueMicrotask(reply);\n        break;\n      case 'delay': {\n        const t = setTimeout(() => { this.timers.delete(t); reply(); }, action.ms);\n        this.timers.add(t);\n        break;\n      }\n      case 'drop-reply':\n        break;\n    }\n    return 1;\n  }\n\n  on<K extends keyof EventMap>(channel: K, handler: (payload: EventMap[K]) => void): () => void {\n    const sub = this.bus.get(channel).subscribe(handler);\n    return () => sub.unsubscribe();\n  }\n\n  stream<K extends keyof EventMap>(channel: K): Observable<EventMap[K]> {\n    return this.bus.get(channel);\n  }\n\n  subscribeToResource(_rid: ResourceId): () => void {\n    // Mirrors the real HttpTransport: distinct scopes COMPOSE\n    // (MULTI-RESOURCE-SCOPE). Delivery here is bus-direct and never\n    // scope-gated, so acquisition needs no bookkeeping and release\n    // (idempotent by construction) is a no-op.\n    return () => {};\n  }\n\n  /**\n   * Correlated-reply tracking (BUS-RESUMPTION.md Phase 2 / SDK-DEBT S1),\n   * exposed for assertions: `busRequest` registers each cid here before its\n   * emit and releases on settle, so a test can pin the tracked set at any\n   * point of a request's lifecycle. Delivery in this double is bus-direct\n   * (nothing to replay), so tracking has no behavioral effect.\n   */\n  readonly pendingReplies = new Set<string>();\n\n  trackReply(correlationId: string): () => void {\n    this.pendingReplies.add(correlationId);\n    let released = false;\n    return () => {\n      if (released) return;\n      released = true;\n      this.pendingReplies.delete(correlationId);\n    };\n  }\n\n  bridgeInto(bus: EventBus): void {\n    for (const channel of BRIDGED_CHANNELS) {\n      this.bus.get(channel as keyof EventMap).subscribe((payload) => {\n        bus.get(channel as keyof EventMap).next(payload as EventMap[keyof EventMap]);\n      });\n    }\n  }\n\n  // ── Lifecycle ───────────────────────────────────────────────────────────\n\n  dispose(): void {\n    if (this.disposed) return;\n    this.disposed = true;\n    for (const t of this.timers) clearTimeout(t);\n    this.timers.clear();\n    this.state$.next('closed');\n    this.state$.complete();\n    this.errorsSubject.complete();\n    // Completes every subject: in-flight busRequests resolve `bus.closed`.\n    this.bus.destroy();\n  }\n}\n"]}

package/dist/{chunk-JWTQJVKM.js → chunk-UGI6IOOX.js}

@@ -38,6 +38,7 @@ function resolveEnvVars(obj, env) {
   }
   return obj;
 }
+var DEFAULT_ARCHIVIST_PORT = 24103;
 function requirePlatform(value, serviceName) {
   if (!value) {
     throw new Error(`platform is required for service '${serviceName}' \u2014 add 'platform = "posix"|"container"|"external"' to its config section`);
@@ -141,7 +142,12 @@ function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env)
       workers[wt] = mergeWithFlatInference(specific);
     }
   }
-  const backend = resolved.backend;
+  if (resolved.gateway && resolved.backend) {
+    throw new Error(
+      `Environment '${resolvedEnvironment}' declares both [gateway] and [backend]. They are one section under two spellings; keep [gateway] and delete [backend].`
+    );
+  }
+  const gateway = resolved.gateway ?? resolved.backend;
   const site = resolved.site ?? projectSite;
   const inferenceSection = resolved.inference;
   let inferenceProviders;
@@ -194,7 +200,6 @@ function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env)
   if (makeMeaningSection?.actors?.matcher?.inference) {
     topLevelActors["matcher"] = { inference: { type: makeMeaningSection.actors.matcher.inference.type, model: makeMeaningSection.actors.matcher.inference.model } };
   }
-  const frontend = resolved.frontend;
   if (!resolved.vectors?.type) {
     throw new Error(
       `[environments.${resolvedEnvironment}] names no vector store \u2014 add [environments.${resolvedEnvironment}.vectors] with type = "qdrant" or "memory". Semiont requires a vector store; nothing is defaulted.`
@@ -226,19 +231,18 @@ function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env)
       } : void 0
     }
   };
-  if (backend) {
-    services.backend = {
-      platform: { type: requirePlatform(backend.platform, "backend") },
-      port: backend.port ?? 4e3,
-      publicURL: backend.publicURL ?? `http://localhost:${backend.port ?? 4e3}`
+  if (gateway) {
+    services.gateway = {
+      platform: { type: requirePlatform(gateway.platform, "gateway") },
+      port: gateway.port ?? 4e3,
+      publicURL: gateway.publicURL ?? `http://localhost:${gateway.port ?? 4e3}`
     };
   }
-  if (frontend) {
-    services.frontend = {
-      platform: { type: requirePlatform(frontend.platform, "frontend") },
-      port: frontend.port ?? 3e3,
-      siteName: site?.siteName ?? "Semiont",
-      publicURL: frontend.publicURL
+  if (resolved.archivist?.host) {
+    services.archivist = {
+      platform: { type: "external" },
+      host: resolved.archivist.host,
+      port: resolved.archivist.port ?? DEFAULT_ARCHIVIST_PORT
     };
   }
   if (resolved.graph) {
@@ -264,11 +268,25 @@ function loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env)
   }
   const config = {
     services,
+    // From the GLOBAL file's root only — an [environments.X.kb] section is
+    // inert by construction, which is what "not overridable" means here.
+    ...raw.kb?.name ? { kb: {
+      name: raw.kb.name,
+      ...raw.kb.domain ? { domain: raw.kb.domain } : {},
+      ...raw.kb.oauthAllowedDomains ? { oauthAllowedDomains: raw.kb.oauthAllowedDomains } : {}
+    } } : {},
     ...inferenceProviders ? { inference: inferenceProviders } : {},
     ...Object.keys(topLevelWorkers).length > 0 ? { workers: topLevelWorkers } : {},
     ...Object.keys(topLevelActors).length > 0 ? { actors: topLevelActors } : {},
     site: site ? {
-      domain: site.domain ?? "localhost",
+      // NO 'localhost' default. A `[site]` section is routinely added for an
+      // unrelated key — `oauthAllowedDomains` is the usual one — and
+      // manufacturing a domain for it silently renamed the KB's agents to
+      // `did:web:localhost`, an identity that collides with every other
+      // domain-less KB on the machine. Absent now means absent, so a consumer
+      // either falls back to the committed `[kb] domain` or refuses; neither
+      // can be done on top of a fabricated value.
+      ...site.domain ? { domain: site.domain } : {},
       siteName: site.siteName,
       adminEmail: site.adminEmail,
       oauthAllowedDomains: site.oauthAllowedDomains
@@ -296,6 +314,6 @@ function createTomlConfigLoader(reader, globalConfigPath, env) {
   };
 }
 
-export { createTomlConfigLoader, loadTomlConfig };
-//# sourceMappingURL=chunk-JWTQJVKM.js.map
-//# sourceMappingURL=chunk-JWTQJVKM.js.map
+export { DEFAULT_ARCHIVIST_PORT, createTomlConfigLoader, loadTomlConfig };
+//# sourceMappingURL=chunk-UGI6IOOX.js.map
+//# sourceMappingURL=chunk-UGI6IOOX.js.map

package/dist/chunk-UGI6IOOX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/toml-loader.ts"],"names":["parseToml"],"mappings":"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","file":"chunk-UGI6IOOX.js","sourcesContent":["/**\n * TOML Config Loader\n *\n * Reads ~/.semiontconfig (TOML) and .semiont/config (TOML) and produces\n * an EnvironmentConfig for the requested environment.\n *\n * File format: see TOML-XDG-CONFIG.md\n *\n * Loading sequence:\n *   1. Read .semiont/config  → projectName, site, environments.<env>.* (project base)\n *   2. Read ~/.semiontconfig → defaults, environments.<env>.* (user overrides)\n *   3. Deep-merge: project base ← user overrides (user wins on conflicts)\n *      Any environment name is valid (local, staging, production, custom, ...)\n *   4. Resolve ${VAR} references from process.env\n *   5. Apply inheritance: workers.<name> → workers.default → error\n *   6. Map to EnvironmentConfig shape\n */\n\nimport { parse as parseToml } from 'smol-toml';\nimport type { EnvironmentConfig, OllamaProviderConfig, AnthropicProviderConfig } from './config.types';\nimport type { PlatformType } from './config.types';\n\n/**\n * Deep merge two plain objects. Arrays and primitives in `override` replace those in `base`.\n * Nested objects are merged recursively. `override` takes precedence on conflicts.\n */\nfunction deepMerge<T extends Record<string, unknown>>(base: T, override: Partial<T>): T {\n  const result = { ...base } as Record<string, unknown>;\n  for (const key of Object.keys(override)) {\n    const b = base[key];\n    const o = override[key];\n    if (o !== undefined && o !== null && typeof o === 'object' && !Array.isArray(o) &&\n        b !== undefined && b !== null && typeof b === 'object' && !Array.isArray(b)) {\n      result[key] = deepMerge(b as Record<string, unknown>, o as Record<string, unknown>);\n    } else if (o !== undefined) {\n      result[key] = o;\n    }\n  }\n  return result as T;\n}\n\nfunction resolveEnvVars(obj: unknown, env: Record<string, string | undefined>): unknown {\n  if (typeof obj === 'string') {\n    return obj.replace(/\\$\\{([^}]+)\\}/g, (match, expr: string) => {\n      const sepIdx = expr.indexOf(':-');\n      const varName = sepIdx >= 0 ? expr.slice(0, sepIdx) : expr;\n      const defaultValue = sepIdx >= 0 ? expr.slice(sepIdx + 2) : undefined;\n      const value = env[varName];\n      if (value !== undefined) return value;\n      if (defaultValue !== undefined) return defaultValue;\n      throw new Error(`Environment variable ${varName} is not set (referenced in config as ${match})`);\n    });\n  }\n  if (Array.isArray(obj)) {\n    return obj.map(item => resolveEnvVars(item, env));\n  }\n  if (obj !== null && typeof obj === 'object') {\n    const resolved: Record<string, unknown> = {};\n    for (const key in obj as Record<string, unknown>) {\n      resolved[key] = resolveEnvVars((obj as Record<string, unknown>)[key], env);\n    }\n    return resolved;\n  }\n  return obj;\n}\n\n// ── Inference config types (mirrored from packages/make-meaning/src/config.ts) ─\n// Kept here to avoid a circular dependency: core cannot import make-meaning.\n\nexport interface InferenceConfig {\n  type: 'anthropic' | 'ollama';\n  model: string;\n  maxTokens?: number;\n  apiKey?: string;\n  endpoint?: string;\n  baseURL?: string;\n}\n\nexport interface ActorInferenceConfig {\n  gatherer?: InferenceConfig;\n  matcher?: InferenceConfig;\n}\n\nexport interface WorkerInferenceConfig {\n  default?: InferenceConfig;\n  'reference-annotation'?: InferenceConfig;\n  'highlight-annotation'?: InferenceConfig;\n  'assessment-annotation'?: InferenceConfig;\n  'comment-annotation'?: InferenceConfig;\n  'tag-annotation'?: InferenceConfig;\n  'generation'?: InferenceConfig;\n}\n\n// ── Types for ~/.semiontconfig ────────────────────────────────────────────────\n\n/** The archivist's default port — the ONE home; node-config-loader imports it. */\nexport const DEFAULT_ARCHIVIST_PORT = 24103;\n\ninterface SemiontConfigFile {\n  user?: {\n    name?: string;\n    email?: string;\n  };\n  defaults?: {\n    environment?: string;\n    platform?: string;\n  };\n  // The KB's committed identity, staged by the launcher (SINGLE-KB-MOUNT D4).\n  // Top-level DELIBERATELY: [site] lives inside environment sections, where an\n  // override can report an identity the KB never declared; [kb] sits beside\n  // [defaults] in the file root, out of any environment section's reach.\n  kb?: {\n    name?: string;\n    domain?: string;\n    oauthAllowedDomains?: string[];\n  };\n  environments?: Record<string, EnvironmentSection>;\n}\n\ninterface GraphSection {\n  platform?: string;\n  type?: string;\n  name?: string;\n  uri?: string;\n  username?: string;\n  password?: string;\n  database?: string;\n  [key: string]: unknown;\n}\n\ninterface InferenceFlatSection {\n  // Flat (single-provider) format: type = \"anthropic\"|\"ollama\" at this level\n  type?: 'anthropic' | 'ollama';\n  platform?: string;\n  model?: string;\n  maxTokens?: number;\n  apiKey?: string;\n  endpoint?: string;\n  baseURL?: string;\n  // Keyed (multi-provider) format: [inference.anthropic] / [inference.ollama]\n  anthropic?: { platform?: string; apiKey?: string; endpoint?: string };\n  ollama?: { platform?: string; baseURL?: string; port?: number };\n}\n\ninterface GatewaySection {\n  platform?: string;\n  port?: number;\n  publicURL?: string;\n}\n\ninterface EnvironmentSection {\n  gateway?: GatewaySection;\n  /**\n   * The pre-rename spelling of `gateway`. Accepted so the KB fleet — whose\n   * TOMLs live in repos this build cannot reach — keeps loading across the\n   * rename. Retires when every fleet repo says `gateway`; that trigger is a\n   * release-checklist item, not something CI here can observe.\n   */\n  backend?: GatewaySection;\n  archivist?: {\n    host?: string;\n    port?: number;\n  };\n  site?: {\n    domain?: string;\n    siteName?: string;\n    adminEmail?: string;\n    oauthAllowedDomains?: string[];\n    enableLocalAuth?: boolean;\n  };\n  database?: {\n    platform?: string;\n    image?: string;\n    host?: string;\n    port?: number;\n    name?: string;\n    user?: string;\n    password?: string;\n  };\n  graph?: GraphSection;\n  vectors?: {\n    type?: 'qdrant' | 'memory';\n    host?: string;\n    port?: number;\n    // Legacy: embedding nested under vectors (migrated to top-level)\n    embedding?: {\n      type?: 'voyage' | 'ollama';\n      model?: string;\n      apiKey?: string;\n      baseURL?: string;\n      endpoint?: string;\n    };\n    chunking?: {\n      chunkSize?: number;\n      overlap?: number;\n    };\n  };\n  embedding?: {\n    type?: 'voyage' | 'ollama';\n    model?: string;\n    apiKey?: string;\n    baseURL?: string;\n    endpoint?: string;\n    chunking?: {\n      chunkSize?: number;\n      overlap?: number;\n    };\n  };\n  inference?: InferenceFlatSection;\n  'make-meaning'?: {\n    graph?: Record<string, unknown>;\n    actors?: {\n      gatherer?: { inference?: InferenceConfig };\n      matcher?: { inference?: InferenceConfig };\n    };\n    default?: { inference?: InferenceConfig };\n    /**\n     * Resource-gather knobs. `settleTimeoutMs` bounds the semanticContext\n     * read-your-writes barrier (SMELTER-INDEX-SYNC D3/D5) — how long a gather\n     * waits for the vector projection to settle before degrading to an absent\n     * semanticContext. Must nest INSIDE downstream watchdogs (job-worker\n     * liveness, client stall watchdogs) — see SMELTER-INDEX-SYNC A4.\n     */\n    gather?: { settleTimeoutMs?: number };\n    /**\n     * Search knobs. `semanticFloor` is the minimum cosine score a vector hit\n     * needs to appear in the semantic fallback (SEMANTIC-FALLBACK decision\n     * #1) — fired only when a lexical search returns nothing. The loader is\n     * the ONE home of the default: 0.6, midway between the Matcher's\n     * recall-oriented 0.4 (which feeds a composite scorer) and a\n     * precision-strict 0.8 — a guess to be tuned from the fallback's own\n     * score-distribution debug line, revisable here in one line.\n     */\n    search?: { semanticFloor?: number };\n  };\n  workers?: Record<string, { inference?: InferenceConfig }>;\n  actors?: Record<string, { inference?: InferenceConfig }>;\n  logLevel?: 'error' | 'warn' | 'info' | 'http' | 'debug';\n}\n\n// ── File reader abstraction (same pattern as createConfigLoader) ──────────────\n\nexport type TomlFileReader = {\n  readIfExists: (path: string) => string | null;\n};\n\nfunction requirePlatform(value: string | undefined, serviceName: string): PlatformType {\n  if (!value) {\n    throw new Error(`platform is required for service '${serviceName}' — add 'platform = \"posix\"|\"container\"|\"external\"' to its config section`);\n  }\n  return value as PlatformType;\n}\n\n// ── Main loader function ──────────────────────────────────────────────────────\n\n/**\n * Parse ~/.semiontconfig and .semiont/config and return EnvironmentConfig.\n *\n * @param projectRoot - Path to the project root (contains .semiont/config)\n * @param environment - Environment name (e.g. 'local', 'production'); when\n *   undefined, resolved from `[defaults] environment`\n * @param globalConfigPath - Path to ~/.semiontconfig (caller resolves ~ expansion)\n * @param reader - File reader abstraction\n * @param env - Environment variables for ${VAR} resolution\n */\nexport function loadTomlConfig(\n  projectRoot: string | null,\n  environment: string | undefined,\n  globalConfigPath: string,\n  reader: TomlFileReader,\n  env: Record<string, string | undefined>\n): EnvironmentConfig {\n  // 1. Read + parse project config from .semiont/config (skipped when no project root)\n  const projectConfigContent = projectRoot ? reader.readIfExists(`${projectRoot}/.semiont/config`) : null;\n  const projectConfig = projectConfigContent\n    ? (parseToml(projectConfigContent) as {\n        project?: { name?: string; version?: string };\n        site?: EnvironmentSection['site'];\n        environments?: Record<string, EnvironmentSection>;\n      })\n    : undefined;\n  const projectName = projectConfig?.project?.name ?? 'semiont-project';\n  const projectVersion = projectConfig?.project?.version;\n  const projectSite = projectConfig?.site;\n\n  // 2. Read global config (optional — missing config yields empty environments)\n  const globalContent = reader.readIfExists(globalConfigPath);\n  const raw = globalContent ? (parseToml(globalContent) as SemiontConfigFile) : ({} as SemiontConfigFile);\n\n  // 3. Resolve WHICH environment to load. `[defaults] environment` is the key the\n  //    launcher selects from (config.go: cfg.Defaults.Environment); the gateway\n  //    resolves from the SAME key so one config selects the environment for both\n  //    halves. TWO inputs only — an explicit argument (tests pass one) and the\n  //    committed config — and they cannot contradict each other, because the\n  //    explicit one is legible at the call site. There is deliberately NO ambient\n  //    environment variable in this chain: `SEMIONT_ENV` was removed because an\n  //    invisible input that can disagree with the staged config is precisely the\n  //    bug shape #1108 fixed. And no silent 'local'/'development' fallback — an\n  //    unselected environment is a config error, not a default.\n  const resolvedEnvironment = environment ?? raw.defaults?.environment;\n  if (!resolvedEnvironment) {\n    throw new Error(\n      'No environment selected: pass one explicitly, or declare ' +\n        '`[defaults] environment` in ~/.semiontconfig.',\n    );\n  }\n\n  // 4. A named environment with no [environments.X] section ANYWHERE is a config\n  //    error, not a silent empty {}. The silent {} is what let a KB declaring\n  //    `environment = \"staging\"` (with no [environments.staging]) load nothing and\n  //    let every downstream default fire, back when a domain-less [site]\n  //    still resolved to 'localhost',\n  //    the fabricated colliding did:web:localhost identity. Fail loud instead.\n  const projectHasSection =\n    projectConfig?.environments != null && resolvedEnvironment in projectConfig.environments;\n  const globalHasSection = raw.environments != null && resolvedEnvironment in raw.environments;\n  if (!projectHasSection && !globalHasSection) {\n    throw new Error(\n      `Environment \"${resolvedEnvironment}\" is selected but no [environments.${resolvedEnvironment}] ` +\n        'section exists in the project (.semiont/config) or global (~/.semiontconfig) config. ' +\n        'Declare the section, or select an environment that exists.',\n    );\n  }\n\n  // 5. Deep-merge: project base + user overrides (user wins on conflicts)\n  const projectEnvSection: EnvironmentSection = projectConfig?.environments?.[resolvedEnvironment] ?? {};\n  const userEnvSection: EnvironmentSection = raw.environments?.[resolvedEnvironment] ?? {};\n  const envSection: EnvironmentSection = deepMerge(\n    projectEnvSection as Record<string, unknown>,\n    userEnvSection as Record<string, unknown>\n  ) as EnvironmentSection;\n\n  // 4. Resolve ${VAR} references\n  const resolved = resolveEnvVars(envSection, env) as EnvironmentSection;\n\n  // 5. Build make-meaning actor/worker inference config with inheritance\n  // The flat [inference] section provides defaults (apiKey, maxTokens, endpoint/baseURL).\n  // Actor/worker sections only need to specify type and model; missing fields fall back\n  // to the flat inference section.\n  const flatInference = resolved.inference;\n  const makeMeaningSection = resolved['make-meaning'];\n  const workersSection = resolved.workers ?? {};\n  const actorsSection = resolved.actors ?? {};\n  const defaultWorkerInference = workersSection['default']?.inference;\n  const defaultMakeMeaningInference = makeMeaningSection?.default?.inference;\n\n  function mergeWithFlatInference(specific: InferenceConfig): InferenceConfig {\n    if (!flatInference) return specific;\n    // For keyed sub-sections, inherit credentials from the matching provider sub-section.\n    // For flat (legacy) format, flatInference.type is required to know which fields apply.\n    const providerDefaults: Partial<InferenceConfig> = {};\n    if (specific.type === 'anthropic') {\n      const a = flatInference.anthropic;\n      if (a) {\n        providerDefaults.apiKey = a.apiKey;\n        providerDefaults.endpoint = a.endpoint;\n      } else {\n        if (!flatInference.type) {\n          throw new Error(\n            `[environments.${resolvedEnvironment}.inference] is missing 'type'. ` +\n            `Add type = \"anthropic\" or use [inference.anthropic] sub-section.`\n          );\n        }\n        providerDefaults.apiKey = flatInference.apiKey;\n        providerDefaults.endpoint = flatInference.endpoint;\n      }\n    } else if (specific.type === 'ollama') {\n      const o = flatInference.ollama;\n      if (o) {\n        providerDefaults.baseURL = o.baseURL;\n      } else {\n        if (!flatInference.type) {\n          throw new Error(\n            `[environments.${resolvedEnvironment}.inference] is missing 'type'. ` +\n            `Add type = \"ollama\" or use [inference.ollama] sub-section.`\n          );\n        }\n        providerDefaults.baseURL = flatInference.baseURL;\n      }\n    }\n    return {\n      maxTokens: flatInference.maxTokens,\n      ...providerDefaults,\n      ...specific,\n    };\n  }\n\n  function resolveActorInference(fromMakeMeaning?: InferenceConfig, fromActors?: InferenceConfig): InferenceConfig | undefined {\n    const base = fromMakeMeaning ?? fromActors ?? defaultMakeMeaningInference;\n    if (!base) return undefined;\n    return mergeWithFlatInference(base);\n  }\n\n  const actors: ActorInferenceConfig = {};\n  const gathererInference = resolveActorInference(\n    makeMeaningSection?.actors?.gatherer?.inference,\n    actorsSection['gatherer']?.inference\n  );\n  if (gathererInference) actors.gatherer = gathererInference;\n\n  const matcherInference = resolveActorInference(\n    makeMeaningSection?.actors?.matcher?.inference,\n    actorsSection['matcher']?.inference\n  );\n  if (matcherInference) actors.matcher = matcherInference;\n\n  const workers: WorkerInferenceConfig = {};\n  const workerTypes = ['reference-annotation', 'highlight-annotation', 'assessment-annotation', 'comment-annotation', 'tag-annotation', 'generation'] as const;\n  if (defaultWorkerInference) {\n    workers.default = mergeWithFlatInference(defaultWorkerInference);\n  }\n  for (const wt of workerTypes) {\n    const specific = workersSection[wt]?.inference;\n    if (specific) {\n      (workers as Record<string, InferenceConfig>)[wt] = mergeWithFlatInference(specific);\n    }\n  }\n\n  // 6. Map to EnvironmentConfig\n  // `gateway` is the current spelling; `backend` is the pre-rename one, still\n  // accepted for the fleet. A file carrying BOTH is half-migrated — a mistake\n  // someone just made, not a state worth supporting — so it fails loudly here\n  // instead of picking a winner the next reader cannot identify.\n  if (resolved.gateway && resolved.backend) {\n    throw new Error(\n      `Environment '${resolvedEnvironment}' declares both [gateway] and [backend]. ` +\n      `They are one section under two spellings; keep [gateway] and delete [backend].`\n    );\n  }\n  const gateway = resolved.gateway ?? resolved.backend;\n  const site = resolved.site ?? projectSite;\n  const inferenceSection = resolved.inference;\n\n  // Build inference providers config.\n  // Supports two formats:\n  //   Flat:  [environments.local.inference] type = \"anthropic\"|\"ollama\"  (single provider)\n  //   Keyed: [environments.local.inference.anthropic] / [environments.local.inference.ollama] (multi-provider)\n  let inferenceProviders: EnvironmentConfig['inference'] | undefined;\n  if (inferenceSection) {\n    inferenceProviders = {};\n    // Keyed sub-sections take priority\n    if (inferenceSection.anthropic) {\n      const a = inferenceSection.anthropic;\n      inferenceProviders.anthropic = {\n        platform: requirePlatform(a.platform, 'inference.anthropic'),\n        endpoint: a.endpoint ?? 'https://api.anthropic.com',\n        apiKey: a.apiKey ?? '',\n      } as AnthropicProviderConfig;\n    } else if (inferenceSection.type === 'anthropic') {\n      inferenceProviders.anthropic = {\n        platform: requirePlatform(inferenceSection.platform, 'inference'),\n        endpoint: inferenceSection.endpoint ?? 'https://api.anthropic.com',\n        apiKey: inferenceSection.apiKey ?? '',\n      } as AnthropicProviderConfig;\n    }\n    if (inferenceSection.ollama) {\n      const o = inferenceSection.ollama;\n      inferenceProviders.ollama = {\n        platform: { type: requirePlatform(o.platform, 'inference.ollama') },\n        baseURL: o.baseURL,\n        port: o.baseURL ? undefined : (o.port ?? 11434),\n      } as OllamaProviderConfig;\n    } else if (inferenceSection.type === 'ollama') {\n      inferenceProviders.ollama = {\n        platform: { type: requirePlatform(inferenceSection.platform, 'inference') },\n        baseURL: inferenceSection.baseURL,\n        port: inferenceSection.baseURL ? undefined : 11434,\n      } as OllamaProviderConfig;\n    }\n  }\n\n  // Build top-level workers/actors maps for EnvironmentConfig\n  const topLevelWorkers: EnvironmentConfig['workers'] = {};\n  for (const [name, w] of Object.entries(workersSection)) {\n    if (w.inference) {\n      topLevelWorkers[name] = { inference: { type: w.inference.type, model: w.inference.model } };\n    }\n  }\n  const topLevelActors: EnvironmentConfig['actors'] = {};\n  for (const [name, a] of Object.entries(actorsSection)) {\n    if (a.inference) {\n      topLevelActors[name] = { inference: { type: a.inference.type, model: a.inference.model } };\n    }\n  }\n  // Also include make-meaning actors\n  if (makeMeaningSection?.actors?.gatherer?.inference) {\n    topLevelActors['gatherer'] = { inference: { type: makeMeaningSection.actors.gatherer.inference.type, model: makeMeaningSection.actors.gatherer.inference.model } };\n  }\n  if (makeMeaningSection?.actors?.matcher?.inference) {\n    topLevelActors['matcher'] = { inference: { type: makeMeaningSection.actors.matcher.inference.type, model: makeMeaningSection.actors.matcher.inference.model } };\n  }\n\n  // Semantic search is always available, so a config must NAME both a vector\n  // store and an embedding provider — nothing is defaulted, and absence\n  // refuses the load with a config-actionable message (MANDATORY-EMBEDDING\n  // D0+D1: explicit opt-in; `memory` is a first-class choice, not a fallback).\n  if (!resolved.vectors?.type) {\n    throw new Error(\n      `[environments.${resolvedEnvironment}] names no vector store — add [environments.${resolvedEnvironment}.vectors] with type = \"qdrant\" or \"memory\". Semiont requires a vector store; nothing is defaulted.`,\n    );\n  }\n  const embeddingSource = resolved.embedding ?? resolved.vectors?.embedding;\n  if (!embeddingSource?.type || !embeddingSource.model) {\n    throw new Error(\n      `[environments.${resolvedEnvironment}] names no embedding provider — add [environments.${resolvedEnvironment}.embedding] with type = \"voyage\" or \"ollama\" and a model. Semiont requires an embedding provider; nothing is defaulted.`,\n    );\n  }\n\n  const services: EnvironmentConfig['services'] = {\n    vectors: {\n      platform: { type: 'external' as PlatformType },\n      type: resolved.vectors.type,\n      host: resolved.vectors.host,\n      port: resolved.vectors.port ?? 6333,\n    } as EnvironmentConfig['services']['vectors'],\n    embedding: {\n      platform: { type: 'external' as PlatformType },\n      type: embeddingSource.type,\n      model: embeddingSource.model,\n      apiKey: embeddingSource.apiKey,\n      baseURL: embeddingSource.baseURL,\n      endpoint: embeddingSource.endpoint,\n      chunking: (resolved.embedding?.chunking ?? resolved.vectors?.chunking) ? {\n        chunkSize: (resolved.embedding?.chunking ?? resolved.vectors?.chunking)?.chunkSize ?? 512,\n        overlap: (resolved.embedding?.chunking ?? resolved.vectors?.chunking)?.overlap ?? 64,\n      } : undefined,\n    } as EnvironmentConfig['services']['embedding'],\n  };\n\n  if (gateway) {\n    services.gateway = {\n      platform: { type: requirePlatform(gateway.platform, 'gateway') },\n      port: gateway.port ?? 4000,\n      publicURL: gateway.publicURL ?? `http://localhost:${gateway.port ?? 4000}`,\n    };\n  }\n\n  // The Archivist's D1 read path: the gateway replays SSE resumes from it\n  // (EXTRACT-ARCHIVIST P3). Internal host:port like vectors — never a\n  // publicURL; the Archivist is not public. Without this mapping the\n  // section parses and then VANISHES: fetchArchivistReplay reads\n  // services.archivist, finds nothing, and every resume silently degrades\n  // to a gap — the exact failure D1's gate exists to catch. (The cutover\n  // added the schema and the consumer; this mapping is the missing middle.)\n  if (resolved.archivist?.host) {\n    services.archivist = {\n      platform: { type: 'external' as PlatformType },\n      host: resolved.archivist.host,\n      port: resolved.archivist.port ?? DEFAULT_ARCHIVIST_PORT,\n    } as EnvironmentConfig['services']['archivist'];\n  }\n\n  // No browser service is emitted. The Browser is machine-level — one Browser\n  // serves many KBs — so a KB neither knows nor affects its port or publicURL\n  // (FRONTEND-IS-THE-BROWSER D5). `[browser]` and the older `[frontend]` are\n  // inert unknown sections: tolerated, never read, never refused.\n\n  if (resolved.graph) {\n    services.graph = {\n      ...resolved.graph,\n      platform: { type: requirePlatform(resolved.graph.platform as string | undefined, 'graph') },\n      type: (resolved.graph.type ?? 'neo4j') as import('./config.types').GraphDatabaseType,\n    } as EnvironmentConfig['services']['graph'];\n  } else if (makeMeaningSection?.graph) {\n    services.graph = makeMeaningSection.graph as EnvironmentConfig['services']['graph'];\n  }\n\n  if (resolved.database) {\n    services.database = {\n      platform: { type: requirePlatform(resolved.database.platform, 'database') },\n      type: 'postgres',\n      image: resolved.database.image,\n      host: resolved.database.host ?? 'localhost',\n      port: resolved.database.port ?? 5432,\n      name: resolved.database.name,\n      user: resolved.database.user,\n      password: resolved.database.password,\n    } as EnvironmentConfig['services']['database'];\n  }\n\n  const config: EnvironmentConfig = {\n    services,\n    // From the GLOBAL file's root only — an [environments.X.kb] section is\n    // inert by construction, which is what \"not overridable\" means here.\n    ...(raw.kb?.name\n      ? { kb: {\n          name: raw.kb.name,\n          ...(raw.kb.domain ? { domain: raw.kb.domain } : {}),\n          ...(raw.kb.oauthAllowedDomains ? { oauthAllowedDomains: raw.kb.oauthAllowedDomains } : {}),\n        } }\n      : {}),\n    ...(inferenceProviders ? { inference: inferenceProviders } : {}),\n    ...(Object.keys(topLevelWorkers).length > 0 ? { workers: topLevelWorkers } : {}),\n    ...(Object.keys(topLevelActors).length > 0 ? { actors: topLevelActors } : {}),\n    site: site ? {\n      // NO 'localhost' default. A `[site]` section is routinely added for an\n      // unrelated key — `oauthAllowedDomains` is the usual one — and\n      // manufacturing a domain for it silently renamed the KB's agents to\n      // `did:web:localhost`, an identity that collides with every other\n      // domain-less KB on the machine. Absent now means absent, so a consumer\n      // either falls back to the committed `[kb] domain` or refuses; neither\n      // can be done on top of a fabricated value.\n      ...(site.domain ? { domain: site.domain } : {}),\n      siteName: site.siteName,\n      adminEmail: site.adminEmail,\n      oauthAllowedDomains: site.oauthAllowedDomains as [string, ...string[]] | undefined,\n    } : undefined,\n    logLevel: resolved.logLevel,\n    _metadata: {\n      environment: resolvedEnvironment,\n      projectRoot,\n      projectName,\n      projectVersion,\n      ...(Object.keys(actors).length > 0 ? { actors } : {}),\n      ...(Object.keys(workers).length > 0 ? { workers } : {}),\n      // Always set — the loader is the ONE home of this default (D5).\n      // Consuming code (make-meaning's gather path) receives a required\n      // value and defaults nothing.\n      gather: { settleTimeoutMs: makeMeaningSection?.gather?.settleTimeoutMs ?? 15_000 },\n      search: { semanticFloor: makeMeaningSection?.search?.semanticFloor ?? 0.6 },\n    },\n  };\n\n  return config;\n}\n\n/**\n * Create a TOML config loader backed by a file reader.\n * Drop-in replacement for createConfigLoader that reads TOML instead of JSON.\n * The caller must resolve globalConfigPath (e.g. expand '~' using process.env.HOME).\n */\nexport function createTomlConfigLoader(\n  reader: TomlFileReader,\n  globalConfigPath: string,\n  env: Record<string, string | undefined>\n) {\n  return (projectRoot: string | null, environment?: string): EnvironmentConfig => {\n    return loadTomlConfig(projectRoot, environment, globalConfigPath, reader, env);\n  };\n}\n"]}