@semiont/core 0.5.24 → 0.5.25

package/README.md

@@ -196,6 +196,37 @@ import {
 } from '@semiont/core';
 ```
 
+### PDF anchoring
+
+Text paired with the geometry that indexes it, and the inverse pair that reads
+it in either direction. Pure arithmetic over plain data — this is what *reasons
+over* a coordinate map; producing one (text layer, OCR, tables, forms) lives in
+[`@semiont/content`](../content/README.md), which the browser cannot import
+because it carries pdf.js, Tesseract and `node:fs`.
+
+```typescript
+import { locate, textUnder, anchorRuns, type AnchoredText } from '@semiont/core';
+
+// A model quoted text; find its geometry. One rect per line.
+const { rects } = locate(anchored, match.start, match.end);
+
+// A person drew a box; find its text. '' when it covers no words.
+const quote = textUnder(anchored, pdfCoordinate);
+
+// pdf.js runs -> AnchoredText, the offset/separator convention both the
+// server extractor and the browser canvas share.
+const anchored = anchorRuns(content.items.filter(isTextRun), pageNumber);
+```
+
+Coordinates are PDF points, origin bottom-left, Y increasing upward; the flip to
+canvas pixels happens in the browser. `textUnder` counts a word as covered at
+`RUN_COVERAGE_THRESHOLD` (50%) of its area rather than on any intersection —
+with ~2pt of headroom between lines, a hand-drawn box that overshoots by less
+than the height of a comma would otherwise pull in its neighbours.
+
+See **[ANCHORING.md](../../docs/system/ANCHORING.md)** for how a map is derived,
+stored, served, and turned into a selector.
+
 ### DID Utilities
 
 Generate and parse W3C Decentralized Identifiers for humans and software peers:

package/dist/{chunk-4JTZMWZB.js → chunk-FMFOBVTE.js}

@@ -65,6 +65,7 @@ var BUS_OPERATIONS = {
   "bind:update-body": { result: "bind:body-updated", failure: "bind:body-update-failed" },
   // ── 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: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" },
@@ -104,6 +105,9 @@ var BUS_OPERATIONS = {
   // ── WEAVE ───────────────────────────────────────────────────────
   // Graph-projection rebuild, served by the Weaver (WEAVER-ISOLATION D3)
   "weave:rebuild": { result: "weave:rebuild-ok", failure: "weave:rebuild-failed" },
+  // ── SMELT ────────────────────────────────────────────
+  // Anchored-text rebuild, served by the Smelter (PERSIST-ANCHORS P0)
+  "smelt:rebuild-anchors": { result: "smelt:rebuild-anchors-ok", failure: "smelt:rebuild-anchors-failed" },
   // ── YIELD ───────────────────────────────────────────────────────
   // live in-process (resource-operations.ts emits + awaits via race()); the
   // client also .on()-subscribes -ok for cache invalidation
@@ -326,5 +330,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-4JTZMWZB.js.map
-//# sourceMappingURL=chunk-4JTZMWZB.js.map
+//# sourceMappingURL=chunk-FMFOBVTE.js.map
+//# sourceMappingURL=chunk-FMFOBVTE.js.map

package/dist/chunk-FMFOBVTE.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-FMFOBVTE.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: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 — backend 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 — backend 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: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  // 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  'beckon:focus',\n  'beckon:sparkle',\n  'bus:resume-gap',\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 backend:\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 (backend + 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 backend 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   * 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-3WTQZOGO.js → chunk-I3ZOWCTH.js}

@@ -1,4 +1,4 @@
-import { baseUrl, EventBus, BRIDGED_CHANNELS, BUS_OPERATIONS } from './chunk-4JTZMWZB.js';
+import { baseUrl, EventBus, BRIDGED_CHANNELS, BUS_OPERATIONS } from './chunk-FMFOBVTE.js';
 import { BehaviorSubject, Subject } from 'rxjs';
 
 function isOperation(channel) {
@@ -139,5 +139,5 @@ var FaultyTransport = class {
 };
 
 export { FaultyTransport, retryKeyOf };
-//# sourceMappingURL=chunk-3WTQZOGO.js.map
-//# sourceMappingURL=chunk-3WTQZOGO.js.map
+//# sourceMappingURL=chunk-I3ZOWCTH.js.map
+//# sourceMappingURL=chunk-I3ZOWCTH.js.map

package/dist/{chunk-3WTQZOGO.js.map → chunk-I3ZOWCTH.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/faulty-transport.ts"],"names":[],"mappings":"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","file":"chunk-3WTQZOGO.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<void> {\n    if (this.disposed) return;\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;\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  }\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-I3ZOWCTH.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<void> {\n    if (this.disposed) return;\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;\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  }\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/config/node-config-loader.d.ts

@@ -551,16 +551,32 @@ interface EnvironmentConfig {
  *
  * Ephemeral paths (outside the project root, never committed):
  *   configDir      — $XDG_CONFIG_HOME/semiont/{name}/  (generated config for managed processes)
- *   dataHome       — $XDG_DATA_HOME/semiont/{name}/   (persistent user data, e.g. database files)
  *   stateDir        — $XDG_STATE_HOME/semiont/{name}/
  *   projectionsDir  — stateDir/projections/
  *   jobsDir         — stateDir/jobs/
+ *   anchoredTextDir — supplied by the caller; required, no default
  *   backendLogsDir      — stateDir/backend/
  *   backendAppLogFile   — backendLogsDir/app.log
  *   backendErrorLogFile — backendLogsDir/error.log
  *   runtimeDir      — $XDG_RUNTIME_DIR/semiont/{name}/  (or $TMPDIR fallback)
  *   backendPidFile  — runtimeDir/backend.pid
  *
+ * Everything ephemeral that is DERIVED sits under stateDir together —
+ * projections (from the event log) and jobs. The anchored-text store is
+ * derived too, but its location is declared by the deployment rather than
+ * composed here (see anchoredTextDir). That is the XDG distinction, not a
+ * filing habit:
+ * $XDG_STATE_HOME is for data that persists between restarts but "is not
+ * important or portable enough" for $XDG_DATA_HOME, and losing any of these
+ * costs recomputation rather than information.
+ *
+ * There is no $XDG_DATA_HOME path here, deliberately. Semiont's own system of
+ * record is the committed event log above; the databases live under the
+ * launcher's per-root state, not the backend's. A `dataHome` field existed and
+ * had exactly one consumer — the anchored-text store, which belonged in state
+ * all along — so it went with the move rather than being left for a
+ * hypothetical future user of the DATA tier.
+ *
  * Note: the frontend has no entry here, deliberately. It serves static assets
  * from its own container image and keeps no per-project state on the host, so
  * there is nothing to derive from a project root.
@@ -573,16 +589,33 @@ declare class SemiontProject {
     readonly gitSync: boolean;
     readonly eventsDir: string;
     readonly configDir: string;
-    readonly dataHome: string;
     readonly stateDir: string;
     readonly projectionsDir: string;
     readonly jobsDir: string;
+    readonly anchoredTextDir: string;
     readonly backendLogsDir: string;
     readonly backendAppLogFile: string;
     readonly backendErrorLogFile: string;
     readonly runtimeDir: string;
     readonly backendPidFile: string;
-    constructor(projectRoot: string, name?: string);
+    /**
+     * @param projectRoot  the KB clone this project describes
+     * @param opts.name    seed value: written to `.semiont/config` when that
+     *   file does not yet exist. It does NOT override an existing config — the
+     *   name always comes from the file, so a KB's committed identity wins over
+     *   anything a caller passes.
+     * @param opts.anchoredTextDir  where this deployment keeps the anchored-text
+     *   store. Passed IN, never read from the environment here: the entry point
+     *   owns that read, exactly as it owns SEMIONT_ROOT. Required, and with no
+     *   default — a default would let a deployment that forgot it write a full
+     *   OCR pass per representation into a directory nobody mounted, lose it on
+     *   the next `stop`, and re-derive it forever: silent, expensive, and
+     *   indistinguishable from working.
+     */
+    constructor(projectRoot: string, opts: {
+        anchoredTextDir: string;
+        name?: string;
+    });
     /**
      * Read the current git branch for the project root.
      * Returns null if the project is not a git repo or git is not available.
@@ -590,7 +623,7 @@ declare class SemiontProject {
     gitBranch(): string | null;
     /**
      * Delete all ephemeral state for this project (stateDir + runtimeDir).
-     * Does not touch eventsDir or dataDir.
+     * Does not touch eventsDir — the event log is the system of record.
      */
     destroy(): Promise<void>;
     /**

package/dist/config/node-config-loader.js

@@ -14,19 +14,34 @@ var SemiontProject = class _SemiontProject {
   eventsDir;
   // Ephemeral — config (generated config files for managed processes)
   configDir;
-  // Ephemeral — data (persistent user data managed by semiont)
-  dataHome;
   // Ephemeral — state
   stateDir;
   projectionsDir;
   jobsDir;
+  anchoredTextDir;
   backendLogsDir;
   backendAppLogFile;
   backendErrorLogFile;
   // Ephemeral — runtime
   runtimeDir;
   backendPidFile;
-  constructor(projectRoot, name) {
+  /**
+   * @param projectRoot  the KB clone this project describes
+   * @param opts.name    seed value: written to `.semiont/config` when that
+   *   file does not yet exist. It does NOT override an existing config — the
+   *   name always comes from the file, so a KB's committed identity wins over
+   *   anything a caller passes.
+   * @param opts.anchoredTextDir  where this deployment keeps the anchored-text
+   *   store. Passed IN, never read from the environment here: the entry point
+   *   owns that read, exactly as it owns SEMIONT_ROOT. Required, and with no
+   *   default — a default would let a deployment that forgot it write a full
+   *   OCR pass per representation into a directory nobody mounted, lose it on
+   *   the next `stop`, and re-derive it forever: silent, expensive, and
+   *   indistinguishable from working.
+   */
+  constructor(projectRoot, opts) {
+    const name = opts.name;
+    this.anchoredTextDir = opts.anchoredTextDir;
     this.root = projectRoot;
     if (name !== void 0) {
       const configPath = path.join(projectRoot, ".semiont", "config");
@@ -42,8 +57,6 @@ name = "${name}"
     this.eventsDir = path.join(projectRoot, ".semiont", "events");
     const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), ".config");
     this.configDir = path.join(xdgConfig, "semiont", this.name);
-    const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), ".local", "share");
-    this.dataHome = path.join(xdgData, "semiont", this.name);
     const xdgState = process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local", "state");
     this.stateDir = path.join(xdgState, "semiont", this.name);
     this.projectionsDir = path.join(this.stateDir, "projections");
@@ -73,7 +86,7 @@ name = "${name}"
   }
   /**
    * Delete all ephemeral state for this project (stateDir + runtimeDir).
-   * Does not touch eventsDir or dataDir.
+   * Does not touch eventsDir — the event log is the system of record.
    */
   async destroy() {
     await Promise.all([

package/dist/config/node-config-loader.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/project.ts","../../src/config/node-config-loader.ts"],"names":["fs2","path2","os2"],"mappings":"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","file":"node-config-loader.js","sourcesContent":["import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { execFileSync } from 'child_process';\n\n/**\n * Represents a Semiont project rooted at a given directory.\n *\n * Computes all paths — durable and ephemeral — once at construction time.\n * XDG environment variables are read here and nowhere else.\n *\n * Durable paths (inside the project root, committed or repo-local):\n *   eventsDir — .semiont/events/  (system of record, committed)\n *\n * Ephemeral paths (outside the project root, never committed):\n *   configDir      — $XDG_CONFIG_HOME/semiont/{name}/  (generated config for managed processes)\n *   dataHome       — $XDG_DATA_HOME/semiont/{name}/   (persistent user data, e.g. database files)\n *   stateDir        — $XDG_STATE_HOME/semiont/{name}/\n *   projectionsDir  — stateDir/projections/\n *   jobsDir         — stateDir/jobs/\n *   backendLogsDir      — stateDir/backend/\n *   backendAppLogFile   — backendLogsDir/app.log\n *   backendErrorLogFile — backendLogsDir/error.log\n *   runtimeDir      — $XDG_RUNTIME_DIR/semiont/{name}/  (or $TMPDIR fallback)\n *   backendPidFile  — runtimeDir/backend.pid\n *\n * Note: the frontend has no entry here, deliberately. It serves static assets\n * from its own container image and keeps no per-project state on the host, so\n * there is nothing to derive from a project root.\n */\nexport class SemiontProject {\n  readonly root: string;\n  readonly name: string;\n\n  /** True if [git] sync = true in .semiont/config. When true, semiont stages\n   *  working-tree and event-log changes in the git index automatically. */\n  readonly gitSync: boolean;\n\n  // Durable\n  readonly eventsDir: string;\n\n  // Ephemeral — config (generated config files for managed processes)\n  readonly configDir: string;\n\n  // Ephemeral — data (persistent user data managed by semiont)\n  readonly dataHome: string;\n\n  // Ephemeral — state\n  readonly stateDir: string;\n  readonly projectionsDir: string;\n  readonly jobsDir: string;\n  readonly backendLogsDir: string;\n  readonly backendAppLogFile: string;\n  readonly backendErrorLogFile: string;\n\n  // Ephemeral — runtime\n  readonly runtimeDir: string;\n  readonly backendPidFile: string;\n\n  constructor(projectRoot: string, name?: string) {\n    this.root = projectRoot;\n    if (name !== undefined) {\n      const configPath = path.join(projectRoot, '.semiont', 'config');\n      if (!fs.existsSync(configPath)) {\n        fs.mkdirSync(path.join(projectRoot, '.semiont'), { recursive: true });\n        fs.writeFileSync(configPath, `[project]\\nname = \"${name}\"\\n`);\n      }\n    }\n    this.name = SemiontProject.readName(projectRoot);\n    this.gitSync = SemiontProject.readGitSync(projectRoot);\n\n    this.eventsDir = path.join(projectRoot, '.semiont', 'events');\n\n    const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');\n    this.configDir = path.join(xdgConfig, 'semiont', this.name);\n\n    const xdgData = process.env.XDG_DATA_HOME || path.join(os.homedir(), '.local', 'share');\n    this.dataHome = path.join(xdgData, 'semiont', this.name);\n\n    const xdgState = process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state');\n    this.stateDir = path.join(xdgState, 'semiont', this.name);\n    this.projectionsDir = path.join(this.stateDir, 'projections');\n    this.jobsDir = path.join(this.stateDir, 'jobs');\n    this.backendLogsDir = path.join(this.stateDir, 'backend');\n    this.backendAppLogFile = path.join(this.backendLogsDir, 'app.log');\n    this.backendErrorLogFile = path.join(this.backendLogsDir, 'error.log');\n\n    const xdgRuntime = process.env.XDG_RUNTIME_DIR;\n    const runtimeBase = xdgRuntime ?? process.env.TMPDIR ?? '/tmp';\n    this.runtimeDir = path.join(runtimeBase, 'semiont', this.name);\n    this.backendPidFile = path.join(this.runtimeDir, 'backend.pid');\n  }\n\n  /**\n   * Read the current git branch for the project root.\n   * Returns null if the project is not a git repo or git is not available.\n   */\n  gitBranch(): string | null {\n    try {\n      return execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {\n        cwd: this.root,\n        encoding: 'utf-8',\n        stdio: ['ignore', 'pipe', 'ignore'],\n      }).trim() || null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Delete all ephemeral state for this project (stateDir + runtimeDir).\n   * Does not touch eventsDir or dataDir.\n   */\n  async destroy(): Promise<void> {\n    await Promise.all([\n      fs.promises.rm(this.configDir, { recursive: true, force: true }),\n      fs.promises.rm(this.stateDir, { recursive: true, force: true }),\n      fs.promises.rm(this.runtimeDir, { recursive: true, force: true }),\n    ]);\n  }\n\n  /**\n   * The KB's permanent identity literal — `[site] domain` from the committed\n   * `.semiont/config`, which `kbDid()` renders as `did:web:<domain>`.\n   * `undefined` when the section or key is absent.\n   *\n   * Reads the committed file DIRECTLY, and deliberately not\n   * `EnvironmentConfig.site.domain`, which is the same value only by\n   * accident: the TOML loader defaults a domain-less `[site]` to the string\n   * `'localhost'` (so every domain-less KB on a machine would claim one\n   * fabricated `did:web:localhost`) and lets the environment section\n   * override the KB's own declaration. Either would report an identity the\n   * launcher never minted — an address wearing a name, which is the whole\n   * category error .plans/KB-IDENTITY-VS-ADDRESS.md exists to end. Identity\n   * is declared or absent; it is never defaulted.\n   */\n  siteDomain(): string | undefined {\n    const configPath = path.join(this.root, '.semiont', 'config');\n    if (!fs.existsSync(configPath)) return undefined;\n    const content = fs.readFileSync(configPath, 'utf-8');\n    let inSiteSection = false;\n    for (const line of content.split('\\n')) {\n      const trimmed = line.trim();\n      if (trimmed.startsWith('#')) continue;\n      if (trimmed === '[site]') { inSiteSection = true; continue; }\n      if (trimmed.startsWith('[')) { inSiteSection = false; continue; }\n      if (!inSiteSection) continue;\n      const eq = trimmed.indexOf('=');\n      if (eq < 0) continue;\n      if (trimmed.slice(0, eq).trim() !== 'domain') continue;\n      const value = trimmed.slice(eq + 1).trim().replace(/^\"(.*)\"$/, '$1');\n      return value === '' ? undefined : value;\n    }\n    return undefined;\n  }\n\n  /**\n   * Read [git] sync from .semiont/config.\n   * Defaults to false if the section or key is absent.\n   */\n  private static readGitSync(projectRoot: string): boolean {\n    const configPath = path.join(projectRoot, '.semiont', 'config');\n    if (!fs.existsSync(configPath)) return false;\n    const content = fs.readFileSync(configPath, 'utf-8');\n    let inGitSection = false;\n    for (const line of content.split('\\n')) {\n      const trimmed = line.trim();\n      if (trimmed === '[git]') { inGitSection = true; continue; }\n      if (trimmed.startsWith('[')) { inGitSection = false; continue; }\n      if (inGitSection && trimmed.startsWith('sync') && trimmed.includes('=')) {\n        const value = trimmed.split('=')[1]?.trim();\n        return value === 'true';\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Read the project name from .semiont/config [project] name = \"...\"\n   * Falls back to the directory basename if the config is absent or has no name.\n   */\n  private static readName(projectRoot: string): string {\n    const configPath = path.join(projectRoot, '.semiont', 'config');\n    if (fs.existsSync(configPath)) {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      for (const line of content.split('\\n')) {\n        const trimmed = line.trim();\n        if (trimmed.startsWith('name') && trimmed.includes('=')) {\n          const [, ...rest] = trimmed.split('=');\n          return rest.join('=').trim().replace(/^\"(.*)\"$/, '$1');\n        }\n      }\n    }\n    return path.basename(projectRoot);\n  }\n}\n","import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { createTomlConfigLoader } from './toml-loader.js';\nimport type { EnvironmentConfig } from './config.types.js';\n\nexport { SemiontProject } from '../project.js';\n\nconst nodeTomlFileReader = {\n  readIfExists: (filePath: string): string | null =>\n    fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf-8') : null,\n};\n\n/**\n * Load semiont environment config for a Node.js process.\n *\n * Reads ~/.semiontconfig (global) merged with .semiont/config (project-local),\n * then selects the given environment overlay.\n *\n * This is the canonical config loader for any Node.js process. The environment\n * is resolved by the loader itself — an explicit `environment` argument, else\n * `[defaults] environment` from the committed config — so entry points call this\n * without selecting one; one config selects the environment for the backend the\n * same way the launcher selects it. There is no environment-variable override.\n */\nexport function loadEnvironmentConfig(\n  projectRoot: string,\n  environment?: string\n): EnvironmentConfig {\n  const globalConfigPath = path.join(os.homedir(), '.semiontconfig');\n  return createTomlConfigLoader(\n    nodeTomlFileReader,\n    globalConfigPath,\n    process.env\n  )(projectRoot, environment);\n}\n"]}
+{"version":3,"sources":["../../src/project.ts","../../src/config/node-config-loader.ts"],"names":["fs2","path2","os2"],"mappings":"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","file":"node-config-loader.js","sourcesContent":["import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { execFileSync } from 'child_process';\n\n/**\n * Represents a Semiont project rooted at a given directory.\n *\n * Computes all paths — durable and ephemeral — once at construction time.\n * XDG environment variables are read here and nowhere else.\n *\n * Durable paths (inside the project root, committed or repo-local):\n *   eventsDir — .semiont/events/  (system of record, committed)\n *\n * Ephemeral paths (outside the project root, never committed):\n *   configDir      — $XDG_CONFIG_HOME/semiont/{name}/  (generated config for managed processes)\n *   stateDir        — $XDG_STATE_HOME/semiont/{name}/\n *   projectionsDir  — stateDir/projections/\n *   jobsDir         — stateDir/jobs/\n *   anchoredTextDir — supplied by the caller; required, no default\n *   backendLogsDir      — stateDir/backend/\n *   backendAppLogFile   — backendLogsDir/app.log\n *   backendErrorLogFile — backendLogsDir/error.log\n *   runtimeDir      — $XDG_RUNTIME_DIR/semiont/{name}/  (or $TMPDIR fallback)\n *   backendPidFile  — runtimeDir/backend.pid\n *\n * Everything ephemeral that is DERIVED sits under stateDir together —\n * projections (from the event log) and jobs. The anchored-text store is\n * derived too, but its location is declared by the deployment rather than\n * composed here (see anchoredTextDir). That is the XDG distinction, not a\n * filing habit:\n * $XDG_STATE_HOME is for data that persists between restarts but \"is not\n * important or portable enough\" for $XDG_DATA_HOME, and losing any of these\n * costs recomputation rather than information.\n *\n * There is no $XDG_DATA_HOME path here, deliberately. Semiont's own system of\n * record is the committed event log above; the databases live under the\n * launcher's per-root state, not the backend's. A `dataHome` field existed and\n * had exactly one consumer — the anchored-text store, which belonged in state\n * all along — so it went with the move rather than being left for a\n * hypothetical future user of the DATA tier.\n *\n * Note: the frontend has no entry here, deliberately. It serves static assets\n * from its own container image and keeps no per-project state on the host, so\n * there is nothing to derive from a project root.\n */\nexport class SemiontProject {\n  readonly root: string;\n  readonly name: string;\n\n  /** True if [git] sync = true in .semiont/config. When true, semiont stages\n   *  working-tree and event-log changes in the git index automatically. */\n  readonly gitSync: boolean;\n\n  // Durable\n  readonly eventsDir: string;\n\n  // Ephemeral — config (generated config files for managed processes)\n  readonly configDir: string;\n\n  // Ephemeral — state\n  readonly stateDir: string;\n  readonly projectionsDir: string;\n  readonly jobsDir: string;\n  readonly anchoredTextDir: string;\n  readonly backendLogsDir: string;\n  readonly backendAppLogFile: string;\n  readonly backendErrorLogFile: string;\n\n  // Ephemeral — runtime\n  readonly runtimeDir: string;\n  readonly backendPidFile: string;\n\n  /**\n   * @param projectRoot  the KB clone this project describes\n   * @param opts.name    seed value: written to `.semiont/config` when that\n   *   file does not yet exist. It does NOT override an existing config — the\n   *   name always comes from the file, so a KB's committed identity wins over\n   *   anything a caller passes.\n   * @param opts.anchoredTextDir  where this deployment keeps the anchored-text\n   *   store. Passed IN, never read from the environment here: the entry point\n   *   owns that read, exactly as it owns SEMIONT_ROOT. Required, and with no\n   *   default — a default would let a deployment that forgot it write a full\n   *   OCR pass per representation into a directory nobody mounted, lose it on\n   *   the next `stop`, and re-derive it forever: silent, expensive, and\n   *   indistinguishable from working.\n   */\n  constructor(projectRoot: string, opts: { anchoredTextDir: string; name?: string }) {\n    const name = opts.name;\n    this.anchoredTextDir = opts.anchoredTextDir;\n    this.root = projectRoot;\n    if (name !== undefined) {\n      const configPath = path.join(projectRoot, '.semiont', 'config');\n      if (!fs.existsSync(configPath)) {\n        fs.mkdirSync(path.join(projectRoot, '.semiont'), { recursive: true });\n        fs.writeFileSync(configPath, `[project]\\nname = \"${name}\"\\n`);\n      }\n    }\n    this.name = SemiontProject.readName(projectRoot);\n    this.gitSync = SemiontProject.readGitSync(projectRoot);\n\n    this.eventsDir = path.join(projectRoot, '.semiont', 'events');\n\n    const xdgConfig = process.env.XDG_CONFIG_HOME || path.join(os.homedir(), '.config');\n    this.configDir = path.join(xdgConfig, 'semiont', this.name);\n\n    const xdgState = process.env.XDG_STATE_HOME || path.join(os.homedir(), '.local', 'state');\n    this.stateDir = path.join(xdgState, 'semiont', this.name);\n    this.projectionsDir = path.join(this.stateDir, 'projections');\n    this.jobsDir = path.join(this.stateDir, 'jobs');\n    this.backendLogsDir = path.join(this.stateDir, 'backend');\n    this.backendAppLogFile = path.join(this.backendLogsDir, 'app.log');\n    this.backendErrorLogFile = path.join(this.backendLogsDir, 'error.log');\n\n    const xdgRuntime = process.env.XDG_RUNTIME_DIR;\n    const runtimeBase = xdgRuntime ?? process.env.TMPDIR ?? '/tmp';\n    this.runtimeDir = path.join(runtimeBase, 'semiont', this.name);\n    this.backendPidFile = path.join(this.runtimeDir, 'backend.pid');\n  }\n\n  /**\n   * Read the current git branch for the project root.\n   * Returns null if the project is not a git repo or git is not available.\n   */\n  gitBranch(): string | null {\n    try {\n      return execFileSync('git', ['rev-parse', '--abbrev-ref', 'HEAD'], {\n        cwd: this.root,\n        encoding: 'utf-8',\n        stdio: ['ignore', 'pipe', 'ignore'],\n      }).trim() || null;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Delete all ephemeral state for this project (stateDir + runtimeDir).\n   * Does not touch eventsDir — the event log is the system of record.\n   */\n  async destroy(): Promise<void> {\n    await Promise.all([\n      fs.promises.rm(this.configDir, { recursive: true, force: true }),\n      fs.promises.rm(this.stateDir, { recursive: true, force: true }),\n      fs.promises.rm(this.runtimeDir, { recursive: true, force: true }),\n    ]);\n  }\n\n  /**\n   * The KB's permanent identity literal — `[site] domain` from the committed\n   * `.semiont/config`, which `kbDid()` renders as `did:web:<domain>`.\n   * `undefined` when the section or key is absent.\n   *\n   * Reads the committed file DIRECTLY, and deliberately not\n   * `EnvironmentConfig.site.domain`, which is the same value only by\n   * accident: the TOML loader defaults a domain-less `[site]` to the string\n   * `'localhost'` (so every domain-less KB on a machine would claim one\n   * fabricated `did:web:localhost`) and lets the environment section\n   * override the KB's own declaration. Either would report an identity the\n   * launcher never minted — an address wearing a name, which is the whole\n   * category error .plans/KB-IDENTITY-VS-ADDRESS.md exists to end. Identity\n   * is declared or absent; it is never defaulted.\n   */\n  siteDomain(): string | undefined {\n    const configPath = path.join(this.root, '.semiont', 'config');\n    if (!fs.existsSync(configPath)) return undefined;\n    const content = fs.readFileSync(configPath, 'utf-8');\n    let inSiteSection = false;\n    for (const line of content.split('\\n')) {\n      const trimmed = line.trim();\n      if (trimmed.startsWith('#')) continue;\n      if (trimmed === '[site]') { inSiteSection = true; continue; }\n      if (trimmed.startsWith('[')) { inSiteSection = false; continue; }\n      if (!inSiteSection) continue;\n      const eq = trimmed.indexOf('=');\n      if (eq < 0) continue;\n      if (trimmed.slice(0, eq).trim() !== 'domain') continue;\n      const value = trimmed.slice(eq + 1).trim().replace(/^\"(.*)\"$/, '$1');\n      return value === '' ? undefined : value;\n    }\n    return undefined;\n  }\n\n  /**\n   * Read [git] sync from .semiont/config.\n   * Defaults to false if the section or key is absent.\n   */\n  private static readGitSync(projectRoot: string): boolean {\n    const configPath = path.join(projectRoot, '.semiont', 'config');\n    if (!fs.existsSync(configPath)) return false;\n    const content = fs.readFileSync(configPath, 'utf-8');\n    let inGitSection = false;\n    for (const line of content.split('\\n')) {\n      const trimmed = line.trim();\n      if (trimmed === '[git]') { inGitSection = true; continue; }\n      if (trimmed.startsWith('[')) { inGitSection = false; continue; }\n      if (inGitSection && trimmed.startsWith('sync') && trimmed.includes('=')) {\n        const value = trimmed.split('=')[1]?.trim();\n        return value === 'true';\n      }\n    }\n    return false;\n  }\n\n  /**\n   * Read the project name from .semiont/config [project] name = \"...\"\n   * Falls back to the directory basename if the config is absent or has no name.\n   */\n  private static readName(projectRoot: string): string {\n    const configPath = path.join(projectRoot, '.semiont', 'config');\n    if (fs.existsSync(configPath)) {\n      const content = fs.readFileSync(configPath, 'utf-8');\n      for (const line of content.split('\\n')) {\n        const trimmed = line.trim();\n        if (trimmed.startsWith('name') && trimmed.includes('=')) {\n          const [, ...rest] = trimmed.split('=');\n          return rest.join('=').trim().replace(/^\"(.*)\"$/, '$1');\n        }\n      }\n    }\n    return path.basename(projectRoot);\n  }\n}\n","import * as fs from 'fs';\nimport * as os from 'os';\nimport * as path from 'path';\nimport { createTomlConfigLoader } from './toml-loader.js';\nimport type { EnvironmentConfig } from './config.types.js';\n\nexport { SemiontProject } from '../project.js';\n\nconst nodeTomlFileReader = {\n  readIfExists: (filePath: string): string | null =>\n    fs.existsSync(filePath) ? fs.readFileSync(filePath, 'utf-8') : null,\n};\n\n/**\n * Load semiont environment config for a Node.js process.\n *\n * Reads ~/.semiontconfig (global) merged with .semiont/config (project-local),\n * then selects the given environment overlay.\n *\n * This is the canonical config loader for any Node.js process. The environment\n * is resolved by the loader itself — an explicit `environment` argument, else\n * `[defaults] environment` from the committed config — so entry points call this\n * without selecting one; one config selects the environment for the backend the\n * same way the launcher selects it. There is no environment-variable override.\n */\nexport function loadEnvironmentConfig(\n  projectRoot: string,\n  environment?: string\n): EnvironmentConfig {\n  const globalConfigPath = path.join(os.homedir(), '.semiontconfig');\n  return createTomlConfigLoader(\n    nodeTomlFileReader,\n    globalConfigPath,\n    process.env\n  )(projectRoot, environment);\n}\n"]}