@requence/service 0.8.2-edge.1151 → 0.8.2-edge.1155

package/build/types/helpers/src/protocol/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../../helpers/src/protocol/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAK1B,eAAO,MAAM,kBAAkB;;;iBAG7B,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAA;AAE7D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6B3B,CAAA;AAEL,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAA;AAE/D,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAAqD,CAAA;AAC/E,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA;AACnD,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAA"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../../../../helpers/src/protocol/command.ts"],"names":[],"mappings":"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"}

package/build/types/helpers/src/protocol/index.d.ts

@@ -4,6 +4,7 @@ export * from './configurationScript.ts';
 export * from './logicLanguages.ts';
 export * from './loopDetection.ts';
 export * from './nodeType.ts';
+export * from './sliceTreeList.ts';
 export * from './update.ts';
 export * from './treeNodes.ts';
 export * from './validateTreeStructure.ts';

package/build/types/helpers/src/protocol/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../helpers/src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../helpers/src/protocol/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA;AACrC,cAAc,cAAc,CAAA;AAC5B,cAAc,0BAA0B,CAAA;AACxC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,eAAe,CAAA;AAC7B,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,4BAA4B,CAAA;AAC1C,cAAc,eAAe,CAAA;AAC7B,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA"}

package/build/types/helpers/src/protocol/sliceTreeList.d.ts

@@ -0,0 +1,81 @@
+import { type InputTreeList, type TreeList } from './treeNodes.ts';
+import { type SliceOptions, type SliceStats } from '../utils/sliceClock.ts';
+/**
+ * THE SLICED TREE-LIST VALIDATOR (#134).
+ *
+ * `treeListSchema.parse` is one uninterruptible call. It walks the main tree,
+ * every reference tree and every JSON schema, and each of those JSON schemas
+ * costs an AJV compile — measured at ~3.4 ms each, ~12 ms for a service node
+ * carrying three of them, ~4 s for a 1.2 MB tree list with 23 references. For
+ * that whole time NO callback can run, the AMQP heartbeat included. On
+ * 2026-08-07 that is exactly what happened: the loop went past the 30 s
+ * heartbeat, the broker closed the connection, and every publish issued inside
+ * the dead window was lost (#130).
+ *
+ * The caching of #132 bounds the REPEAT and the semaphore of #133 bounds how
+ * many parses interleave. Neither bounds a single cold parse. This is the one
+ * that does.
+ *
+ * WHAT IT DOES: the same validation, item by item, yielding to the event loop
+ * whenever the current slice has run longer than `budgetMs`. Total CPU is
+ * unchanged — slightly higher, in fact. The difference is that heartbeats,
+ * confirms and timers get through. Slow is acceptable; a stall is not.
+ *
+ * WHAT IT IS NOT: it is not incremental, not resumable and not cancellable, and
+ * it does not bound EVERY call — the structural pass over the finished graph is
+ * still one call, deliberately (see it below). A rejected tree list is rejected
+ * with exactly the issues `treeListSchema` would have produced, which
+ * `sliceTreeList.spec.ts` asserts case by case rather than against hand-written
+ * expectations.
+ *
+ * WHY NOT A WORKER THREAD (#135). The alternative to this module was to move the
+ * parse off the loop entirely, and that ticket set the test itself: if handing
+ * the parsed result back costs a large fraction of the parse, slicing wins.
+ * Measured on Node 24 over a 267 kB tree list — 23 references, 564 JSON
+ * schemas, the shape of the tree that caused #130 —
+ *
+ *   whole-schema parse, one call     ~2000 ms total   ~2000 ms worst block
+ *   sliced (this module)             ~1900 ms total    ~50-90 ms worst block
+ *   one CREATE through a worker      ~2000 ms total     ~7-15 ms worst block
+ *   burst of 4 cold, sliced     ~7400-8100 ms total   ~85-140 ms worst block
+ *   burst of 4 cold, 2 workers       ~4100 ms total     ~5-17 ms worst block
+ *
+ * — the return trip is NOT that large fraction: 7 ms for a `structuredClone` of
+ * the result, 1.6 ms for a msgpack decode of it, against ~2000 ms of parse. So
+ * on the ticket's own terms the worker thread wins, and it is still the wrong
+ * build:
+ *
+ * 1. It improves a number that no longer has a problem. What took the
+ *    connection down was the 30 s AMQP heartbeat, and the operator warns at
+ *    `LAG_WARN_THRESHOLD` (1000 ms, its `utils/eventLoopLag.ts`). Slicing already
+ *    sits an order of magnitude under the warn threshold and more than two under
+ *    the heartbeat; cutting 90 ms to 15 ms prevents no incident this does not.
+ * 2. Its real win is wall clock on a COLD burst — 7.5 s to 4.1 s — and that is
+ *    parallelism, bought with cores and ~270 MB of RSS for two warm workers, on
+ *    a box #135 itself calls deliberately small. That is latency, not stall
+ *    safety, and #130's rule is that slow is acceptable.
+ * 3. It cannot keep the guarantee the spec above asserts. A `ZodError` does not
+ *    survive `postMessage`: it arrives as a plain `Error` with `issues` gone, so
+ *    identical rejection would have to be rebuilt by hand-serialising issues —
+ *    a second place for the two validators to drift, which is the whole reason
+ *    the rules here are shared rather than copied. Nor is the ticket's zero-copy
+ *    return available: a tree list may carry a `URL` (a service node's
+ *    `configuration` is `z.any()`, and the msgpack codec supports a `URL`
+ *    deliberately), and `structuredClone` throws `DataCloneError` on one.
+ *
+ * Closed as `wontfix`. What would re-open it is a change in the RATE of cold
+ * parses, not in their cost — `ColdParseStats.coldParses` against `parses` in
+ * `treeListCache.ts` is the number that would say so.
+ */
+export type SlicedTreeList = SliceStats & {
+    treeList: TreeList;
+};
+/**
+ * `treeListSchema.parse`, sliced.
+ *
+ * Rejects with the `ZodError` that parse would have produced. Resolves with the
+ * validated tree list and what the walk cost, so the caller can log the stall it
+ * did not cause.
+ */
+export declare function parseTreeListSliced(input: InputTreeList, options?: SliceOptions): Promise<SlicedTreeList>;
+//# sourceMappingURL=sliceTreeList.d.ts.map

package/build/types/helpers/src/protocol/sliceTreeList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliceTreeList.d.ts","sourceRoot":"","sources":["../../../../../../helpers/src/protocol/sliceTreeList.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,QAAQ,EAMd,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,UAAU,EAEhB,MAAM,wBAAwB,CAAA;AAE/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkEG;AAEH,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG;IACxC,QAAQ,EAAE,QAAQ,CAAA;CACnB,CAAA;AAuJD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,cAAc,CAAC,CA2GzB"}