@substrate-ai/core 0.20.77 → 0.20.78

package/dist/index.d.ts

@@ -18,6 +18,7 @@ export * from './git/index.js';
 export * from './version-manager/index.js';
 export * from './supervisor/index.js';
 export * from './budget/index.js';
+export { swallowDebug } from './utils/debug-swallow.js';
 export { estimateCost as estimateCostForProvider } from './cost-tracker/token-rates.js';
 export type { CostTracker, CostTrackerOptions } from './cost-tracker/index.js';
 export { CostTrackerImpl, createCostTracker } from './cost-tracker/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAA;AAI1B,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGpF,cAAc,qBAAqB,CAAA;AAGnC,cAAc,wBAAwB,CAAA;AAGtC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,mBAAmB,CAAA;AAOjC,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,cAAc,sBAAsB,CAAA;AAGpC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,0BAA0B,CAAA;AAGxC,cAAc,gBAAgB,CAAA;AAG9B,cAAc,4BAA4B,CAAA;AAG1C,cAAc,uBAAuB,CAAA;AAGrC,cAAc,mBAAmB,CAAA;AAWjC,OAAO,EAAE,YAAY,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AACvF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAC5F,YAAY,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAC3E,YAAY,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAKvG,YAAY,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAChG,cAAc,oBAAoB,CAAA;AAGlC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAA;AAI1B,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAC/D,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACtD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AACrE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGpF,cAAc,qBAAqB,CAAA;AAGnC,cAAc,wBAAwB,CAAA;AAGtC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,mBAAmB,CAAA;AAOjC,YAAY,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,cAAc,sBAAsB,CAAA;AAGpC,cAAc,qBAAqB,CAAA;AAGnC,cAAc,oBAAoB,CAAA;AAGlC,cAAc,0BAA0B,CAAA;AAGxC,cAAc,gBAAgB,CAAA;AAG9B,cAAc,4BAA4B,CAAA;AAG1C,cAAc,uBAAuB,CAAA;AAGrC,cAAc,mBAAmB,CAAA;AAKjC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAWvD,OAAO,EAAE,YAAY,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AACvF,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC9E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAC5F,YAAY,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAC3E,YAAY,EACV,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAA;AAChC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AACrE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAKvG,YAAY,EAAE,cAAc,IAAI,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAChG,cAAc,oBAAoB,CAAA;AAGlC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -28,6 +28,10 @@ export * from './version-manager/index.js';
 export * from './supervisor/index.js';
 // Budget: BudgetTracker interface and stub implementation
 export * from './budget/index.js';
+// Utilities: small cross-cutting helpers
+// swallowDebug: build a `.catch()` handler that silently swallows errors in
+// production but surfaces them to stderr when SUBSTRATE_DEBUG enables the label
+export { swallowDebug } from './utils/debug-swallow.js';
 // CostTracker: token rates, cost tracking, and subscriber
 // estimateCost: telemetry's (model, tokens) version is the canonical @substrate-ai/core export (exported above).
 // estimateCostForProvider: cost-tracker variant (provider, model, inputTokens, outputTokens, rateTable?)

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,qEAAqE;AACrE,+EAA+E;AAC/E,4EAA4E;AAC5E,cAAc,YAAY,CAAA;AAM1B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGrE,wFAAwF;AACxF,cAAc,qBAAqB,CAAA;AAEnC,gGAAgG;AAChG,cAAc,wBAAwB,CAAA;AAEtC,6EAA6E;AAC7E,cAAc,oBAAoB,CAAA;AAElC,4CAA4C;AAC5C,cAAc,mBAAmB,CAAA;AAQjC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yFAAyF;AACzF,cAAc,qBAAqB,CAAA;AAEnC,6FAA6F;AAC7F,cAAc,oBAAoB,CAAA;AAElC,wEAAwE;AACxE,cAAc,0BAA0B,CAAA;AAExC,sDAAsD;AACtD,cAAc,gBAAgB,CAAA;AAE9B,0FAA0F;AAC1F,cAAc,4BAA4B,CAAA;AAE1C,sDAAsD;AACtD,cAAc,uBAAuB,CAAA;AAErC,0DAA0D;AAC1D,cAAc,mBAAmB,CAAA;AAEjC,0DAA0D;AAC1D,iHAAiH;AACjH,yGAAyG;AACzG,wFAAwF;AACxF,4FAA4F;AAC5F,qEAAqE;AACrE,sFAAsF;AACtF,qFAAqF;AACrF,gGAAgG;AAChG,OAAO,EAAE,YAAY,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAEvF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAS5F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAMvG,cAAc,oBAAoB,CAAA;AAElC,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,qEAAqE;AACrE,+EAA+E;AAC/E,4EAA4E;AAC5E,cAAc,YAAY,CAAA;AAM1B,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGrE,wFAAwF;AACxF,cAAc,qBAAqB,CAAA;AAEnC,gGAAgG;AAChG,cAAc,wBAAwB,CAAA;AAEtC,6EAA6E;AAC7E,cAAc,oBAAoB,CAAA;AAElC,4CAA4C;AAC5C,cAAc,mBAAmB,CAAA;AAQjC,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,cAAc,sBAAsB,CAAA;AAEpC,yFAAyF;AACzF,cAAc,qBAAqB,CAAA;AAEnC,6FAA6F;AAC7F,cAAc,oBAAoB,CAAA;AAElC,wEAAwE;AACxE,cAAc,0BAA0B,CAAA;AAExC,sDAAsD;AACtD,cAAc,gBAAgB,CAAA;AAE9B,0FAA0F;AAC1F,cAAc,4BAA4B,CAAA;AAE1C,sDAAsD;AACtD,cAAc,uBAAuB,CAAA;AAErC,0DAA0D;AAC1D,cAAc,mBAAmB,CAAA;AAEjC,yCAAyC;AACzC,4EAA4E;AAC5E,gFAAgF;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,0DAA0D;AAC1D,iHAAiH;AACjH,yGAAyG;AACzG,wFAAwF;AACxF,4FAA4F;AAC5F,qEAAqE;AACrE,sFAAsF;AACtF,qFAAqF;AACrF,gGAAgG;AAChG,OAAO,EAAE,YAAY,IAAI,uBAAuB,EAAE,MAAM,+BAA+B,CAAA;AAEvF,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC5E,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAA;AAS5F,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAMvG,cAAc,oBAAoB,CAAA;AAElC,kEAAkE;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/utils/debug-swallow.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Debug-mode unmasking for `.catch()` wrappers that silently swallow errors.
+ *
+ * Background: many substrate code paths use `.catch(() => {})` to make a
+ * background or non-critical operation non-blocking — version checks,
+ * telemetry outbox drains, manifest updates after a process exits. The
+ * pattern is correct (these failures must NOT block the user-facing flow)
+ * but it hides ship-blocking bugs. v0.20.74's pre-dispatch version advisory
+ * silently failed to fire in production for 4 CI-green ships because tsdown
+ * bundled a broken lazy-chunk; the chunk's SyntaxError on instantiation was
+ * swallowed by the advisory's `.catch(() => {})`. Caught only by user-driven
+ * e2e smoke against the published bundle.
+ *
+ * **The discipline (codified here):** every `.catch(() => {})` should be
+ * replaced with `.catch(swallowDebug('label'))`. When `SUBSTRATE_DEBUG`
+ * contains the label (or `*`), the swallowed error surfaces to stderr.
+ * Otherwise the original silent-failure semantic is preserved.
+ *
+ * Usage:
+ *   import { swallowDebug } from '@substrate-ai/core'
+ *   await fooThatMayFail().catch(swallowDebug('advisory'))
+ *
+ *   # In production: silent
+ *   substrate run --stories 1-1
+ *
+ *   # When investigating silent failure:
+ *   SUBSTRATE_DEBUG=advisory substrate run --stories 1-1
+ *   SUBSTRATE_DEBUG=* substrate run --stories 1-1   # all swallow sites
+ *   SUBSTRATE_DEBUG=advisory,mesh substrate run --stories 1-1
+ */
+/**
+ * Build an error handler that silently swallows errors in normal operation
+ * but writes them to stderr when `SUBSTRATE_DEBUG` enables the given label.
+ *
+ * Match rules: `SUBSTRATE_DEBUG=*` enables every label; otherwise the env
+ * var is parsed as a comma-separated list (whitespace-tolerant) and matches
+ * by exact label string.
+ */
+export declare function swallowDebug(label: string): (err: unknown) => void;
+//# sourceMappingURL=debug-swallow.d.ts.map

package/dist/utils/debug-swallow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-swallow.d.ts","sourceRoot":"","sources":["../../src/utils/debug-swallow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAelE"}

package/dist/utils/debug-swallow.js

@@ -0,0 +1,56 @@
+/**
+ * Debug-mode unmasking for `.catch()` wrappers that silently swallow errors.
+ *
+ * Background: many substrate code paths use `.catch(() => {})` to make a
+ * background or non-critical operation non-blocking — version checks,
+ * telemetry outbox drains, manifest updates after a process exits. The
+ * pattern is correct (these failures must NOT block the user-facing flow)
+ * but it hides ship-blocking bugs. v0.20.74's pre-dispatch version advisory
+ * silently failed to fire in production for 4 CI-green ships because tsdown
+ * bundled a broken lazy-chunk; the chunk's SyntaxError on instantiation was
+ * swallowed by the advisory's `.catch(() => {})`. Caught only by user-driven
+ * e2e smoke against the published bundle.
+ *
+ * **The discipline (codified here):** every `.catch(() => {})` should be
+ * replaced with `.catch(swallowDebug('label'))`. When `SUBSTRATE_DEBUG`
+ * contains the label (or `*`), the swallowed error surfaces to stderr.
+ * Otherwise the original silent-failure semantic is preserved.
+ *
+ * Usage:
+ *   import { swallowDebug } from '@substrate-ai/core'
+ *   await fooThatMayFail().catch(swallowDebug('advisory'))
+ *
+ *   # In production: silent
+ *   substrate run --stories 1-1
+ *
+ *   # When investigating silent failure:
+ *   SUBSTRATE_DEBUG=advisory substrate run --stories 1-1
+ *   SUBSTRATE_DEBUG=* substrate run --stories 1-1   # all swallow sites
+ *   SUBSTRATE_DEBUG=advisory,mesh substrate run --stories 1-1
+ */
+/**
+ * Build an error handler that silently swallows errors in normal operation
+ * but writes them to stderr when `SUBSTRATE_DEBUG` enables the given label.
+ *
+ * Match rules: `SUBSTRATE_DEBUG=*` enables every label; otherwise the env
+ * var is parsed as a comma-separated list (whitespace-tolerant) and matches
+ * by exact label string.
+ */
+export function swallowDebug(label) {
+    return (err) => {
+        const debugEnv = process.env['SUBSTRATE_DEBUG'];
+        if (debugEnv === undefined || debugEnv === '')
+            return;
+        const enabled = debugEnv === '*' ||
+            debugEnv
+                .split(',')
+                .map((s) => s.trim())
+                .includes(label);
+        if (!enabled)
+            return;
+        const message = err instanceof Error ? `${err.name}: ${err.message}` : String(err);
+        const stack = err instanceof Error && err.stack ? `\n${err.stack}` : '';
+        process.stderr.write(`[debug:${label}] swallowed: ${message}${stack}\n`);
+    };
+}
+//# sourceMappingURL=debug-swallow.js.map

package/dist/utils/debug-swallow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-swallow.js","sourceRoot":"","sources":["../../src/utils/debug-swallow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,CAAC,GAAY,EAAQ,EAAE;QAC5B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAA;QAC/C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,EAAE;YAAE,OAAM;QACrD,MAAM,OAAO,GACX,QAAQ,KAAK,GAAG;YAChB,QAAQ;iBACL,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;iBACpB,QAAQ,CAAC,KAAK,CAAC,CAAA;QACpB,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAClF,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,gBAAgB,OAAO,GAAG,KAAK,IAAI,CAAC,CAAA;IAC1E,CAAC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrate-ai/core",
-  "version": "0.20.77",
+  "version": "0.20.78",
   "type": "module",
   "license": "MIT",
   "repository": {