@substrate-ai/core 0.20.73 → 0.20.75

package/dist/version-manager/index.d.ts

@@ -8,4 +8,6 @@ export type { VersionManagerDeps } from './version-manager-impl.js';
 export { UpdateChecker, UpdateCheckError } from './update-checker.js';
 export { VersionCache } from './version-cache.js';
 export type { VersionCacheEntry } from './version-cache.js';
+export { classifyVersionGap } from './version-gap.js';
+export type { VersionGap } from './version-gap.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/version-manager/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version-manager/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC9F,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version-manager/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC9F,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACpF,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AACnE,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/version-manager/index.js

@@ -5,4 +5,5 @@
 export { VersionManagerImpl, createVersionManager } from './version-manager-impl.js';
 export { UpdateChecker, UpdateCheckError } from './update-checker.js';
 export { VersionCache } from './version-cache.js';
+export { classifyVersionGap } from './version-gap.js';
 //# sourceMappingURL=index.js.map

package/dist/version-manager/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/version-manager/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEpF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/version-manager/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AAEpF,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/version-manager/version-gap.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Version-gap classification for the pre-dispatch advisory (obs_2026-05-02_019).
+ *
+ * Background: when a consumer's locally-installed substrate binary lags the
+ * published version by more than a single patch, dispatching produces work
+ * that may rely on prompt content / behavior the running binary does not yet
+ * implement — leading to false-alarm reopens (canonical incident: a strata
+ * reopen claimed "dispatched under v0.20.42" when the binary was v0.20.41).
+ *
+ * The existing background notification (`Update available: X → Y` to stderr
+ * on every CLI invocation) is easy to miss — buried under NDJSON event
+ * streams, scrolled out of the terminal before dispatch starts. The
+ * pre-dispatch advisory uses this classifier to decide when to escalate
+ * the warning into a prominent block at `substrate run` startup.
+ *
+ * Threshold: > 1 patch hop. Same major + same minor + (latest.patch -
+ * current.patch) <= 1 is `'none'` or `'patch-1'`. Anything larger is
+ * `'significant'` and warrants the prominent advisory.
+ */
+export type VersionGap = 'none' | 'patch-1' | 'significant';
+/**
+ * Classify the gap between the running version and the latest published version.
+ *
+ * @returns
+ *   - `'none'` — versions equal, or current is ahead of latest (e.g., dev build)
+ *   - `'patch-1'` — single patch hop (e.g., 0.20.71 → 0.20.72) — non-prominent
+ *   - `'significant'` — > 1 patch hop, or any minor/major gap — prominent advisory
+ */
+export declare function classifyVersionGap(current: string, latest: string): VersionGap;
+//# sourceMappingURL=version-gap.d.ts.map

package/dist/version-manager/version-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-gap.d.ts","sourceRoot":"","sources":["../../src/version-manager/version-gap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,aAAa,CAAA;AAE3D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAe9E"}

package/dist/version-manager/version-gap.js

@@ -0,0 +1,46 @@
+/**
+ * Version-gap classification for the pre-dispatch advisory (obs_2026-05-02_019).
+ *
+ * Background: when a consumer's locally-installed substrate binary lags the
+ * published version by more than a single patch, dispatching produces work
+ * that may rely on prompt content / behavior the running binary does not yet
+ * implement — leading to false-alarm reopens (canonical incident: a strata
+ * reopen claimed "dispatched under v0.20.42" when the binary was v0.20.41).
+ *
+ * The existing background notification (`Update available: X → Y` to stderr
+ * on every CLI invocation) is easy to miss — buried under NDJSON event
+ * streams, scrolled out of the terminal before dispatch starts. The
+ * pre-dispatch advisory uses this classifier to decide when to escalate
+ * the warning into a prominent block at `substrate run` startup.
+ *
+ * Threshold: > 1 patch hop. Same major + same minor + (latest.patch -
+ * current.patch) <= 1 is `'none'` or `'patch-1'`. Anything larger is
+ * `'significant'` and warrants the prominent advisory.
+ */
+import * as semver from 'semver';
+/**
+ * Classify the gap between the running version and the latest published version.
+ *
+ * @returns
+ *   - `'none'` — versions equal, or current is ahead of latest (e.g., dev build)
+ *   - `'patch-1'` — single patch hop (e.g., 0.20.71 → 0.20.72) — non-prominent
+ *   - `'significant'` — > 1 patch hop, or any minor/major gap — prominent advisory
+ */
+export function classifyVersionGap(current, latest) {
+    const c = semver.coerce(current);
+    const l = semver.coerce(latest);
+    if (c === null || l === null)
+        return 'none';
+    // semver.lte covers "equal" and "current ahead of latest"
+    if (semver.lte(l, c))
+        return 'none';
+    // Different major or minor → always significant
+    if (l.major !== c.major || l.minor !== c.minor)
+        return 'significant';
+    // Same major.minor — measure patch gap
+    const patchDelta = l.patch - c.patch;
+    if (patchDelta <= 1)
+        return 'patch-1';
+    return 'significant';
+}
+//# sourceMappingURL=version-gap.js.map

package/dist/version-manager/version-gap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-gap.js","sourceRoot":"","sources":["../../src/version-manager/version-gap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAIhC;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe,EAAE,MAAc;IAChE,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAChC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC/B,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAA;IAE3C,0DAA0D;IAC1D,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAAE,OAAO,MAAM,CAAA;IAEnC,gDAAgD;IAChD,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;QAAE,OAAO,aAAa,CAAA;IAEpE,uCAAuC;IACvC,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAA;IACpC,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA;IACrC,OAAO,aAAa,CAAA;AACtB,CAAC"}

package/package.json

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