@substrate-ai/core 0.19.54

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

@@ -0,0 +1,223 @@
+/**
+ * VersionManagerImpl — concrete implementation of the VersionManager interface.
+ *
+ * Handles update checks with caching, upgrade previews, and config migration delegation.
+ * (AC6, FR62, FR64)
+ */
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { readFileSync } from 'node:fs';
+import * as semver from 'semver';
+import { UpdateChecker } from './update-checker.js';
+import { VersionCache } from './version-cache.js';
+import { defaultConfigMigrator } from '../config/index.js';
+import { SUPPORTED_CONFIG_FORMAT_VERSIONS, SUPPORTED_TASK_GRAPH_VERSIONS, } from '../config/index.js';
+// ---------------------------------------------------------------------------
+// VersionManagerImpl
+// ---------------------------------------------------------------------------
+/**
+ * Concrete implementation of VersionManager.
+ *
+ * @param deps - Optional overrides for cache and updateChecker (for testing)
+ */
+export class VersionManagerImpl {
+    cache;
+    updateChecker;
+    updateCheckEnabled;
+    constructor(deps = {}) {
+        this.cache = deps.cache ?? new VersionCache();
+        this.updateChecker = deps.updateChecker ?? new UpdateChecker();
+        this.updateCheckEnabled = deps.updateCheckEnabled !== false;
+    }
+    /**
+     * Read the current package version from the bundled package.json.
+     * Tries multiple relative paths because the bundler may place this chunk
+     * at different depths (e.g. dist/version-manager-impl-xxx.js vs
+     * src/modules/version-manager/version-manager-impl.ts).
+     * Falls back to '0.0.0' if the file is unreadable.
+     */
+    getCurrentVersion() {
+        try {
+            const __dirname = dirname(fileURLToPath(import.meta.url));
+            const candidates = [
+                resolve(__dirname, '../package.json'), // dist/chunk.js → repo root
+                resolve(__dirname, '../../package.json'), // dist/cli/index.js → repo root
+                resolve(__dirname, '../../../package.json'), // src/modules/version-manager/ → repo root
+                resolve(__dirname, '../../../../package.json'), // packages/core/src/version-manager/ → core root
+            ];
+            for (const candidate of candidates) {
+                try {
+                    const raw = readFileSync(candidate, 'utf-8');
+                    const pkg = JSON.parse(raw);
+                    if (pkg.name === 'substrate-ai' && typeof pkg.version === 'string' && pkg.version.length > 0) {
+                        return pkg.version;
+                    }
+                }
+                catch {
+                    // try next
+                }
+            }
+            return '0.0.0';
+        }
+        catch {
+            return '0.0.0';
+        }
+    }
+    /**
+     * Check whether a newer version is available on npm.
+     *
+     * Respects:
+     * 1. update_check config setting (AC5)
+     * 2. SUBSTRATE_NO_UPDATE_CHECK env var
+     * 3. Cache TTL (24h by default), unless forceRefresh is true
+     *
+     * Returns updateAvailable: false without a network call when checks are disabled
+     * or the cache is fresh (and forceRefresh is not set).
+     *
+     * @param forceRefresh - When true, skips the cache and always makes a fresh network request.
+     */
+    async checkForUpdates(forceRefresh = false) {
+        const currentVersion = this.getCurrentVersion();
+        // Check config suppression (AC5: update_check: false in config)
+        if (!this.updateCheckEnabled) {
+            return {
+                currentVersion,
+                latestVersion: currentVersion,
+                updateAvailable: false,
+                isBreaking: false,
+                changelog: '',
+            };
+        }
+        // Check env var suppression
+        if (process.env['SUBSTRATE_NO_UPDATE_CHECK'] === '1') {
+            return {
+                currentVersion,
+                latestVersion: currentVersion,
+                updateAvailable: false,
+                isBreaking: false,
+                changelog: '',
+            };
+        }
+        // Check cache — if fresh and not forcing a refresh, return cached result without a network call.
+        // Always use the live currentVersion (not the cached one) since the package may have been upgraded.
+        if (!forceRefresh) {
+            const cached = this.cache.read();
+            if (cached !== null) {
+                const updateAvailable = semver.gt(cached.latestVersion, currentVersion);
+                return {
+                    currentVersion,
+                    latestVersion: cached.latestVersion,
+                    updateAvailable,
+                    isBreaking: this.updateChecker.isBreaking(currentVersion, cached.latestVersion),
+                    changelog: this.updateChecker.getChangelog(cached.latestVersion),
+                };
+            }
+        }
+        // Cache miss, expired, or forceRefresh — fetch from npm
+        try {
+            const latestVersion = await this.updateChecker.fetchLatestVersion('substrate-ai');
+            const updateAvailable = semver.gt(latestVersion, currentVersion);
+            // Write to cache (even when forceRefresh was used, so subsequent calls benefit)
+            this.cache.write({
+                lastChecked: new Date().toISOString(),
+                latestVersion,
+                currentVersion,
+            });
+            return {
+                currentVersion,
+                latestVersion,
+                updateAvailable,
+                isBreaking: this.updateChecker.isBreaking(currentVersion, latestVersion),
+                changelog: this.updateChecker.getChangelog(latestVersion),
+            };
+        }
+        catch {
+            // Network error — return no-update result (never block CLI)
+            return {
+                currentVersion,
+                latestVersion: currentVersion,
+                updateAvailable: false,
+                isBreaking: false,
+                changelog: '',
+            };
+        }
+    }
+    /**
+     * Return an upgrade preview for the given target version.
+     */
+    getUpgradePreview(targetVersion) {
+        const fromVersion = this.getCurrentVersion();
+        const breaking = this.updateChecker.isBreaking(fromVersion, targetVersion);
+        return {
+            fromVersion,
+            toVersion: targetVersion,
+            breakingChanges: breaking
+                ? [`Major version bump from v${fromVersion} to v${targetVersion}`]
+                : [],
+            migrationSteps: [this.updateChecker.getChangelog(targetVersion)],
+            automaticMigrations: breaking ? ['Run defaultConfigMigrator.migrate() if config changed'] : [],
+            manualStepsRequired: breaking
+                ? ['Review breaking changes at the changelog URL above']
+                : [],
+        };
+    }
+    /**
+     * Migrate the project configuration from one format version to another.
+     * Delegates to the shared defaultConfigMigrator singleton.
+     * Loads the actual config from the project config file so migration functions receive real data.
+     */
+    migrateConfiguration(fromVersion, toVersion) {
+        let configObj = {};
+        try {
+            const _require = createRequire(import.meta.url);
+            const fs = _require('fs');
+            const path = _require('path');
+            const yaml = _require('js-yaml');
+            const configPath = path.join(process.cwd(), '.substrate', 'config.yaml');
+            try {
+                const raw = fs.readFileSync(configPath, 'utf-8');
+                configObj = yaml.load(raw) ?? {};
+            }
+            catch {
+                // No project config file — use empty object
+                configObj = {};
+            }
+        }
+        catch {
+            configObj = {};
+        }
+        const { result } = defaultConfigMigrator.migrate(configObj, fromVersion, toVersion);
+        return result;
+    }
+    /**
+     * Migrate a task graph file from one format version to another.
+     * Delegates to the shared defaultConfigMigrator singleton.
+     */
+    migrateTaskGraphFormat(fromVersion, toVersion, filePath) {
+        const { result } = defaultConfigMigrator.migrate({}, fromVersion, toVersion, filePath);
+        return result;
+    }
+    /**
+     * Check whether the given config format version is supported by this toolkit.
+     */
+    isConfigCompatible(configVersion) {
+        return SUPPORTED_CONFIG_FORMAT_VERSIONS.includes(configVersion);
+    }
+    /**
+     * Check whether the given task graph format version is supported by this toolkit.
+     */
+    isTaskGraphCompatible(graphVersion) {
+        return SUPPORTED_TASK_GRAPH_VERSIONS.includes(graphVersion);
+    }
+}
+// ---------------------------------------------------------------------------
+// Factory function
+// ---------------------------------------------------------------------------
+/**
+ * Create a new VersionManager instance with optional dependency overrides.
+ */
+export function createVersionManager(deps = {}) {
+    return new VersionManagerImpl(deps);
+}
+//# sourceMappingURL=version-manager-impl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager-impl.js","sourceRoot":"","sources":["../../src/version-manager/version-manager-impl.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,70 @@
+/**
+ * VersionManager interface and type definitions.
+ *
+ * Defines the contract for version checking, upgrade previews, and
+ * configuration migration delegation (FR62, FR64).
+ */
+import type { MigrationResult } from '../config/index.js';
+/**
+ * Result of a version check against the npm registry.
+ */
+export interface VersionCheckResult {
+    currentVersion: string;
+    latestVersion: string;
+    updateAvailable: boolean;
+    isBreaking: boolean;
+    changelog: string;
+}
+/**
+ * Preview of a pending upgrade, including breaking changes and migration steps.
+ */
+export interface UpgradePreview {
+    fromVersion: string;
+    toVersion: string;
+    breakingChanges: string[];
+    migrationSteps: string[];
+    automaticMigrations: string[];
+    manualStepsRequired: string[];
+}
+/**
+ * Provides version checking, upgrade previews, and config migration delegation.
+ *
+ * Create an instance via `createVersionManager()` from version-manager-impl.ts.
+ */
+export interface VersionManager {
+    /**
+     * Return the current installed version from the bundled package.json.
+     */
+    getCurrentVersion(): string;
+    /**
+     * Check whether a newer version is available on npm.
+     * Respects cache TTL and update_check config / SUBSTRATE_NO_UPDATE_CHECK env var.
+     *
+     * @param forceRefresh - When true, bypasses the cache and always makes a fresh network request.
+     *   Used by `substrate upgrade --check` to show the latest npm data.
+     */
+    checkForUpdates(forceRefresh?: boolean): Promise<VersionCheckResult>;
+    /**
+     * Return a preview of what upgrading to targetVersion would entail.
+     */
+    getUpgradePreview(targetVersion: string): UpgradePreview;
+    /**
+     * Migrate the project configuration file from one format version to another.
+     * Delegates to defaultConfigMigrator.
+     */
+    migrateConfiguration(fromVersion: string, toVersion: string): MigrationResult;
+    /**
+     * Migrate a task graph file from one format version to another.
+     * Delegates to defaultConfigMigrator.
+     */
+    migrateTaskGraphFormat(fromVersion: string, toVersion: string, filePath: string): MigrationResult;
+    /**
+     * Check whether the given config format version is compatible with this toolkit.
+     */
+    isConfigCompatible(configVersion: string): boolean;
+    /**
+     * Check whether the given task graph format version is compatible with this toolkit.
+     */
+    isTaskGraphCompatible(graphVersion: string): boolean;
+}
+//# sourceMappingURL=version-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.d.ts","sourceRoot":"","sources":["../../src/version-manager/version-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAMzD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,OAAO,CAAA;IACxB,UAAU,EAAE,OAAO,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,cAAc,EAAE,MAAM,EAAE,CAAA;IACxB,mBAAmB,EAAE,MAAM,EAAE,CAAA;IAC7B,mBAAmB,EAAE,MAAM,EAAE,CAAA;CAC9B;AAMD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,iBAAiB,IAAI,MAAM,CAAA;IAE3B;;;;;;OAMG;IACH,eAAe,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAA;IAEpE;;OAEG;IACH,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,cAAc,CAAA;IAExD;;;OAGG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,CAAA;IAE7E;;;OAGG;IACH,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAAA;IAEjG;;OAEG;IACH,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAA;IAElD;;OAEG;IACH,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAA;CACrD"}

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

@@ -0,0 +1,8 @@
+/**
+ * VersionManager interface and type definitions.
+ *
+ * Defines the contract for version checking, upgrade previews, and
+ * configuration migration delegation (FR62, FR64).
+ */
+export {};
+//# sourceMappingURL=version-manager.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.js","sourceRoot":"","sources":["../../src/version-manager/version-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@substrate-ai/core",
+  "version": "0.19.54",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "dependencies": {
+    "js-yaml": "^4.1.1",
+    "semver": "^7.6.3",
+    "zod": "^4.3.6"
+  },
+  "optionalDependencies": {
+    "mysql2": "^3.20.0"
+  }
+}