@semiont/make-meaning 0.4.19 → 0.4.20

package/dist/index.d.ts

@@ -72,6 +72,15 @@ interface MakeMeaningConfig {
  *   BURST_WINDOW_MS  = 50   — debounce window before flushing a batch
  *   MAX_BATCH_SIZE   = 500  — force flush to bound memory
  *   IDLE_TIMEOUT_MS  = 200  — silence before returning to passthrough
+ *
+ * ## Per-resource serialization
+ *
+ * `groupBy(resourceId) + concatMap(...)` is the stream-consumer flavor of
+ * per-resource serialization — the same invariant enforced by `Smelter`,
+ * `Gatherer`, and (in a different shape) `ViewManager`. See
+ * `packages/core/src/serialize-per-key.ts` for the shared primitive used
+ * by RPC-style services, and `.plans/PerResourceSerializer.md` for the
+ * broader design that would unify the two shapes.
  */
 
 declare class GraphDBConsumer {
@@ -224,6 +233,16 @@ declare class EmbeddingStore {
  *   5. Index vectors into the VectorStore (Qdrant) for fast similarity search
  *
  * Uses the same burst-buffer RxJS pipeline as GraphDBConsumer.
+ *
+ * ## Per-resource serialization
+ *
+ * Smelter processes events strictly in order per resourceId via
+ * `groupBy(resourceId) + concatMap(...)`. This is the stream-consumer
+ * flavor of per-resource serialization — the same invariant enforced by
+ * `GraphDBConsumer`, `Gatherer`, and (in a different shape) `ViewManager`.
+ * See `packages/core/src/serialize-per-key.ts` for the shared primitive
+ * used by RPC-style services, and `.plans/PerResourceSerializer.md` for
+ * the broader design that would unify the two shapes.
  */
 
 declare class Smelter {
@@ -400,6 +419,15 @@ declare class Stower {
  * - gather:resource-requested — resource-level LLM context assembly
  *
  * RxJS pipeline uses groupBy(resourceId) + concatMap for per-resource isolation.
+ *
+ * ## Per-resource serialization
+ *
+ * `groupBy(resourceId) + concatMap(...)` is the stream-consumer flavor of
+ * per-resource serialization — the same invariant enforced by `Smelter`,
+ * `GraphDBConsumer`, and (in a different shape) `ViewManager`. See
+ * `packages/core/src/serialize-per-key.ts` for the shared primitive used
+ * by RPC-style services, and `.plans/PerResourceSerializer.md` for the
+ * broader design that would unify the two shapes.
  */
 
 declare class Gatherer {

package/dist/index.js

@@ -10000,7 +10000,7 @@ import { WorkingTreeStore } from "@semiont/content";
 var import_rxjs = __toESM(require_cjs(), 1);
 var import_operators = __toESM(require_operators(), 1);
 import { EventQuery } from "@semiont/event-sourcing";
-import { didToAgent, burstBuffer } from "@semiont/core";
+import { didToAgent, burstBuffer, errField } from "@semiont/core";
 import { resourceId as makeResourceId, annotationId as makeAnnotationId, findBodyItem } from "@semiont/core";
 
 // src/batch-utils.ts
@@ -10109,7 +10109,7 @@ var GraphDBConsumer = class _GraphDBConsumer {
       this.logger.error("Failed to apply event to graph", {
         eventType: storedEvent.type,
         resourceId: storedEvent.resourceId,
-        error
+        error: errField(error)
       });
     }
   }
@@ -10148,7 +10148,7 @@ var GraphDBConsumer = class _GraphDBConsumer {
         this.logger.error("Failed to process batch run", {
           eventType: run[0].type,
           runSize: run.length,
-          error
+          error: errField(error)
         });
       }
       const last = run[run.length - 1];
@@ -10305,8 +10305,7 @@ var GraphDBConsumer = class _GraphDBConsumer {
         } catch (error) {
           this.logger.error("Error in annotation.body.updated handler", {
             annotationId: event.payload.annotationId,
-            error,
-            stack: error instanceof Error ? error.stack : void 0
+            error: errField(error)
           });
         }
         break;
@@ -10418,7 +10417,7 @@ var GraphDBConsumer = class _GraphDBConsumer {
 // src/smelter.ts
 var import_rxjs2 = __toESM(require_cjs(), 1);
 var import_operators2 = __toESM(require_operators(), 1);
-import { burstBuffer as burstBuffer2 } from "@semiont/core";
+import { burstBuffer as burstBuffer2, errField as errField2 } from "@semiont/core";
 import { resourceId as makeResourceId2, annotationId as makeAnnotationId2 } from "@semiont/core";
 import { chunkText, DEFAULT_CHUNKING_CONFIG } from "@semiont/vectors";
 import { getExactText, getTargetSelector } from "@semiont/api-client";
@@ -10617,7 +10616,7 @@ var Smelter = class _Smelter {
         this.logger.error("Smelter failed to process batch run", {
           eventType: run[0].type,
           runSize: run.length,
-          error
+          error: errField2(error)
         });
       }
     }
@@ -11092,7 +11091,7 @@ async function createKnowledgeBase(eventStore, project, graphDb, eventBus, logge
 // src/gatherer.ts
 var import_rxjs3 = __toESM(require_cjs(), 1);
 var import_operators3 = __toESM(require_operators(), 1);
-import { annotationId as makeAnnotationId3, resourceId } from "@semiont/core";
+import { annotationId as makeAnnotationId3, resourceId, errField as errField3 } from "@semiont/core";
 
 // src/generation/resource-generation.ts
 async function generateResourceSummary(resourceName, content, entityTypes, client) {
@@ -11880,7 +11879,7 @@ var Gatherer = class {
     } catch (error) {
       this.logger.error("Gather annotation context failed", {
         annotationId: event.annotationId,
-        error
+        error: errField3(error)
       });
       resultBus.get("gather:failed").next({
         correlationId: event.correlationId,
@@ -11909,7 +11908,7 @@ var Gatherer = class {
     } catch (error) {
       this.logger.error("Gather resource context failed", {
         resourceId: event.resourceId,
-        error
+        error: errField3(error)
       });
       resultBus.get("gather:resource-failed").next({
         correlationId: event.correlationId,
@@ -11938,7 +11937,7 @@ var Gatherer = class {
 // src/matcher.ts
 var import_rxjs4 = __toESM(require_cjs(), 1);
 var import_operators4 = __toESM(require_operators(), 1);
-import { resourceId as resourceId2 } from "@semiont/core";
+import { resourceId as resourceId2, errField as errField4 } from "@semiont/core";
 import { getResourceId as getResourceId4, getResourceEntityTypes as getResourceEntityTypes4 } from "@semiont/api-client";
 var Matcher = class {
   constructor(kb, eventBus, logger, inferenceClient, embeddingProvider) {
@@ -11987,7 +11986,7 @@ var Matcher = class {
     } catch (error) {
       this.logger.error("Bind search failed", {
         referenceId: event.referenceId,
-        error
+        error: errField4(error)
       });
       this.eventBus.scope(event.resourceId).get("match:search-failed").next({
         correlationId: event.correlationId,
@@ -12601,7 +12600,7 @@ var import_rxjs6 = __toESM(require_cjs(), 1);
 var import_operators6 = __toESM(require_operators(), 1);
 import { promises as fs4 } from "fs";
 import * as path3 from "path";
-import { resourceId as resourceId4, annotationId } from "@semiont/core";
+import { resourceId as resourceId4, annotationId, errField as errField5 } from "@semiont/core";
 import { getExactText as getExactText2, getTargetSource as getTargetSource2, getTargetSelector as getTargetSelector3, getResourceEntityTypes as getResourceEntityTypes5, getBodySource as getBodySource2 } from "@semiont/api-client";
 import { EventQuery as EventQuery2 } from "@semiont/event-sourcing";
 import { getEntityTypes as getEntityTypes2 } from "@semiont/ontology";
@@ -12684,7 +12683,7 @@ var Browser = class {
         }
       });
     } catch (error) {
-      this.logger.error("Browse resource failed", { resourceId: event.resourceId, error });
+      this.logger.error("Browse resource failed", { resourceId: event.resourceId, error: errField5(error) });
       this.eventBus.get("browse:resource-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12714,7 +12713,7 @@ var Browser = class {
         }
       });
     } catch (error) {
-      this.logger.error("Browse resources failed", { error });
+      this.logger.error("Browse resources failed", { error: errField5(error) });
       this.eventBus.get("browse:resources-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12732,7 +12731,7 @@ var Browser = class {
         }
       });
     } catch (error) {
-      this.logger.error("Browse annotations failed", { resourceId: event.resourceId, error });
+      this.logger.error("Browse annotations failed", { resourceId: event.resourceId, error: errField5(error) });
       this.eventBus.get("browse:annotations-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12764,7 +12763,7 @@ var Browser = class {
         }
       });
     } catch (error) {
-      this.logger.error("Browse annotation failed", { resourceId: event.resourceId, annotationId: event.annotationId, error });
+      this.logger.error("Browse annotation failed", { resourceId: event.resourceId, annotationId: event.annotationId, error: errField5(error) });
       this.eventBus.get("browse:annotation-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12796,7 +12795,7 @@ var Browser = class {
         }
       });
     } catch (error) {
-      this.logger.error("Browse events failed", { resourceId: event.resourceId, error });
+      this.logger.error("Browse events failed", { resourceId: event.resourceId, error: errField5(error) });
       this.eventBus.get("browse:events-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12832,7 +12831,7 @@ var Browser = class {
         }
       });
     } catch (error) {
-      this.logger.error("Browse annotation history failed", { resourceId: event.resourceId, annotationId: event.annotationId, error });
+      this.logger.error("Browse annotation history failed", { resourceId: event.resourceId, annotationId: event.annotationId, error: errField5(error) });
       this.eventBus.get("browse:annotation-history-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12874,7 +12873,7 @@ var Browser = class {
         response: { referencedBy }
       });
     } catch (error) {
-      this.logger.error("Referenced-by query failed", { resourceId: event.resourceId, error });
+      this.logger.error("Referenced-by query failed", { resourceId: event.resourceId, error: errField5(error) });
       this.eventBus.get("browse:referenced-by-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)
@@ -12889,7 +12888,7 @@ var Browser = class {
         response: { entityTypes }
       });
     } catch (error) {
-      this.logger.error("Entity types read failed", { error });
+      this.logger.error("Entity types read failed", { error: errField5(error) });
       this.eventBus.get("browse:entity-types-failed").next({
         correlationId: event.correlationId,
         message: error instanceof Error ? error.message : String(error)