@cleocode/contracts 2026.9.15 → 2026.9.16

package/dist/code-symbol.d.ts

@@ -65,7 +65,7 @@ export declare const PARSER_WORKER_HEAP_MIN_MB = 8;
 /** Largest V8 old-space a parse worker may be given, in MiB. */
 export declare const PARSER_WORKER_HEAP_MAX_MB = 4096;
 /** Default V8 old-space per parse worker, in MiB. */
-export declare const PARSER_WORKER_HEAP_DEFAULT_MB = 128;
+export declare const PARSER_WORKER_HEAP_DEFAULT_MB = 512;
 /** Bounds for one native parser invocation; cancellation is cooperative in-process. */
 export interface ParserExecutionLimits {
     /** Maximum UTF-8 source bytes; defaults to 512 KiB. */
@@ -87,6 +87,18 @@ export interface ParserProcessHandle {
     nativeMemory: 'unverified';
     /** Kill owned execution and wait until it has exited. */
     stop(): Promise<void>;
+    /**
+     * The tail of the child's own standard error, bounded in size.
+     *
+     * The stream was drained and discarded so a full pipe could not block the
+     * child. Draining is right; discarding is not — it threw away the only
+     * account of why a worker died, leaving the parent to report the broken pipe
+     * it noticed afterwards. Retaining a bounded tail keeps the pipe moving and
+     * keeps the cause (T12313).
+     *
+     * @returns Captured stderr, newest content last; empty when the child said nothing.
+     */
+    stderrTail(): string;
 }
 /** Dependency-inverted access to the existing runtime process containment service. */
 export interface ParserExecutionPort {

package/dist/code-symbol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-symbol.d.ts","sourceRoot":"","sources":["../src/code-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,QAAQ,GACR,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,qDAAqD;AACrD,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,KAAK,EAAE,YAAY,CAAC;IACpB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,YAAY,EAAE,YAAY,CAAC;IAC3B,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;CAC/E"}
+{"version":3,"file":"code-symbol.d.ts","sourceRoot":"","sources":["../src/code-symbol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,QAAQ,GACR,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,CAAC;AAEX,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,cAAc,CAAC;IACrB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,gCAAgC;IAChC,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,sDAAsD;IACtD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,gEAAgE;AAChE,eAAO,MAAM,yBAAyB,OAAQ,CAAC;AAE/C,qDAAqD;AACrD,eAAO,MAAM,6BAA6B,MAAM,CAAC;AAEjD,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kFAAkF;IAClF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,gFAAgF;AAChF,MAAM,WAAW,mBAAmB;IAClC,0EAA0E;IAC1E,KAAK,EAAE,YAAY,CAAC;IACpB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,YAAY,EAAE,YAAY,CAAC;IAC3B,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;;;;;OAUG;IACH,UAAU,IAAI,MAAM,CAAC;CACtB;AAED,sFAAsF;AACtF,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;CAC/E"}

package/dist/code-symbol.js

@@ -17,5 +17,5 @@ export const PARSER_WORKER_HEAP_MIN_MB = 8;
 /** Largest V8 old-space a parse worker may be given, in MiB. */
 export const PARSER_WORKER_HEAP_MAX_MB = 4_096;
 /** Default V8 old-space per parse worker, in MiB. */
-export const PARSER_WORKER_HEAP_DEFAULT_MB = 128;
+export const PARSER_WORKER_HEAP_DEFAULT_MB = 512;
 //# sourceMappingURL=code-symbol.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cleocode/contracts",
-  "version": "2026.9.15",
+  "version": "2026.9.16",
   "description": "Domain types, interfaces, and contracts for the CLEO ecosystem",
   "type": "module",
   "main": "./dist/index.js",
@@ -194,7 +194,7 @@
   "dependencies": {
     "zod": "^4.3.6",
     "zod-to-json-schema": "^3.25.2",
-    "@cleocode/lafs": "2026.9.15"
+    "@cleocode/lafs": "2026.9.16"
   },
   "scripts": {
     "build": "tsc -b --force && node scripts/copy-assets.mjs && node scripts/emit-schemas.mjs",

package/src/code-symbol.ts

@@ -87,7 +87,7 @@ export const PARSER_WORKER_HEAP_MIN_MB = 8;
 export const PARSER_WORKER_HEAP_MAX_MB = 4_096;
 
 /** Default V8 old-space per parse worker, in MiB. */
-export const PARSER_WORKER_HEAP_DEFAULT_MB = 128;
+export const PARSER_WORKER_HEAP_DEFAULT_MB = 512;
 
 /** Bounds for one native parser invocation; cancellation is cooperative in-process. */
 export interface ParserExecutionLimits {
@@ -111,6 +111,18 @@ export interface ParserProcessHandle {
   nativeMemory: 'unverified';
   /** Kill owned execution and wait until it has exited. */
   stop(): Promise<void>;
+  /**
+   * The tail of the child's own standard error, bounded in size.
+   *
+   * The stream was drained and discarded so a full pipe could not block the
+   * child. Draining is right; discarding is not — it threw away the only
+   * account of why a worker died, leaving the parent to report the broken pipe
+   * it noticed afterwards. Retaining a bounded tail keeps the pipe moving and
+   * keeps the cause (T12313).
+   *
+   * @returns Captured stderr, newest content last; empty when the child said nothing.
+   */
+  stderrTail(): string;
 }
 
 /** Dependency-inverted access to the existing runtime process containment service. */