@constructive-io/cli 5.1.24 → 5.2.0

package/commands.js

@@ -5,16 +5,14 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.commands = void 0;
 const find_and_require_package_json_1 = require("find-and-require-package-json");
-const pgpm_1 = require("pgpm");
 const codegen_1 = __importDefault(require("./commands/codegen"));
 const explorer_1 = __importDefault(require("./commands/explorer"));
 const get_graphql_schema_1 = __importDefault(require("./commands/get-graphql-schema"));
 const server_1 = __importDefault(require("./commands/server"));
 const utils_1 = require("./utils");
-const createCommandMap = (skipPgTeardown = false) => {
-    const pgpmCommands = (0, pgpm_1.createPgpmCommandMap)(skipPgTeardown);
+const update_check_1 = require("./utils/update-check");
+const createCommandMap = () => {
     return {
-        ...pgpmCommands,
         server: server_1.default,
         explorer: explorer_1.default,
         'get-graphql-schema': get_graphql_schema_1.default,
@@ -26,7 +24,7 @@ const commands = async (argv, prompter, options) => {
     // Run update check early so it shows on help/version paths too
     try {
         const pkg = (0, find_and_require_package_json_1.findAndRequirePackageJson)(__dirname);
-        await (0, pgpm_1.checkForUpdates)({
+        await (0, update_check_1.checkForUpdates)({
             command: command || 'help',
             pkgName: pkg.name,
             pkgVersion: pkg.version,
@@ -53,12 +51,7 @@ const commands = async (argv, prompter, options) => {
         console.log(utils_1.usageText);
         process.exit(0);
     }
-    // Command-specific help for init
-    if (command === 'init' && (argv.help || argv.h)) {
-        console.log((0, pgpm_1.createInitUsageText)('constructive', 'Constructive'));
-        process.exit(0);
-    }
-    const commandMap = createCommandMap(options?.skipPgTeardown);
+    const commandMap = createCommandMap();
     // Prompt if no command provided
     if (!command) {
         const answer = await prompter.prompt(argv, [

package/esm/commands.js

@@ -1,14 +1,12 @@
 import { findAndRequirePackageJson } from 'find-and-require-package-json';
-import { checkForUpdates, createInitUsageText, createPgpmCommandMap } from 'pgpm';
 import codegen from './commands/codegen';
 import explorer from './commands/explorer';
 import getGraphqlSchema from './commands/get-graphql-schema';
 import server from './commands/server';
 import { cliExitWithError, extractFirst, usageText } from './utils';
-const createCommandMap = (skipPgTeardown = false) => {
-    const pgpmCommands = createPgpmCommandMap(skipPgTeardown);
+import { checkForUpdates } from './utils/update-check';
+const createCommandMap = () => {
     return {
-        ...pgpmCommands,
         server,
         explorer,
         'get-graphql-schema': getGraphqlSchema,
@@ -47,12 +45,7 @@ export const commands = async (argv, prompter, options) => {
         console.log(usageText);
         process.exit(0);
     }
-    // Command-specific help for init
-    if (command === 'init' && (argv.help || argv.h)) {
-        console.log(createInitUsageText('constructive', 'Constructive'));
-        process.exit(0);
-    }
-    const commandMap = createCommandMap(options?.skipPgTeardown);
+    const commandMap = createCommandMap();
     // Prompt if no command provided
     if (!command) {
         const answer = await prompter.prompt(argv, [

package/esm/utils/argv.js

@@ -0,0 +1,8 @@
+export const extractFirst = (argv) => {
+    const first = argv._?.[0];
+    const newArgv = {
+        ...argv,
+        _: argv._?.slice(1) ?? []
+    };
+    return { first, newArgv };
+};

package/esm/utils/cli-error.js

@@ -0,0 +1,31 @@
+import { Logger } from '@pgpmjs/logger';
+import { PgpmError } from '@pgpmjs/types';
+const log = new Logger('cli');
+/**
+ * CLI error utility that logs error information and exits with code 1.
+ * Provides consistent error handling and user experience across all CLI commands.
+ */
+export const cliExitWithError = async (error, context) => {
+    if (error instanceof PgpmError) {
+        log.error(`Error: ${error.message}`);
+        if (error.context && Object.keys(error.context).length > 0) {
+            log.debug('Error context:', error.context);
+        }
+        if (context) {
+            log.debug('Additional context:', context);
+        }
+    }
+    else if (error instanceof Error) {
+        log.error(`Error: ${error.message}`);
+        if (context) {
+            log.debug('Context:', context);
+        }
+    }
+    else if (typeof error === 'string') {
+        log.error(`Error: ${error}`);
+        if (context) {
+            log.debug('Context:', context);
+        }
+    }
+    process.exit(1);
+};

package/esm/utils/display.js

@@ -2,63 +2,33 @@ export const usageText = `
   Usage: cnc <command> [options]
          constructive <command> [options]
 
-  Core Database Operations:
-    add                Add database changes to plans and create SQL files
-    deploy             Deploy database changes and migrations
-    verify             Verify database state and migrations
-    revert             Revert database changes and migrations
+  Constructive CLI - API Server and Development Tools
 
-  Project Management:
-    init               Initialize pgpm workspace or module
-    extension          Manage module dependencies
-    plan               Generate module deployment plans
-    package            Package module for distribution
-    update             Update CLI/pgpm (installs pgpm by default)
-    cache              Manage cached templates (clean)
-    upgrade-modules    Upgrade installed pgpm modules to latest versions
-
-  Development Tools:
+  GraphQL Server:
     server             Start a GraphQL server
     explorer           Launch GraphiQL explorer interface
-    docker             Manage PostgreSQL Docker containers (start/stop)
-    export             Export database migrations from existing databases
-    env                Display environment configuration
 
   Code Generation:
     codegen            Generate TypeScript types and SDK from GraphQL schema
     get-graphql-schema Fetch or build GraphQL schema SDL
 
-  Database Administration:
-    kill               Terminate database connections and optionally drop databases
-    install            Install pgpm modules
-    tag                Add tags to changes for versioning
-    clear              Clear database state
-    remove             Remove database changes
-    analyze            Analyze database structure
-    rename             Rename database changes
-    admin-users        Manage admin users
-
-  Testing:
-    test-packages      Run integration tests on all workspace packages
-
-  Migration Tools:
-    migrate            Migration management subcommands
-      init             Initialize migration tracking
-      status           Show migration status
-      list             List all changes
-      deps             Show change dependencies
-
   Global Options:
     -h, --help         Display this help information
     -v, --version      Display version information
     --cwd <directory>  Working directory (default: current directory)
 
   Individual Command Help:
-    constructive <command> --help    Display detailed help for specific command
-    constructive <command> -h        Display detailed help for specific command
+    cnc <command> --help    Display detailed help for specific command
+    cnc <command> -h        Display detailed help for specific command
 
   Examples:
-    cnc deploy --help       Show deploy command options
-    cnc server --port 8080  Start server on port 8080
-    cnc init workspace      Initialize new workspace
+    cnc server                        Start GraphQL server
+    cnc server --port 8080            Start server on custom port
+    cnc explorer                      Launch GraphiQL explorer
+    cnc codegen --schema schema.graphql  Generate types from schema
+    cnc get-graphql-schema --out schema.graphql  Export schema SDL
+
+  Database Operations:
+    For database migrations, packages, and deployment, use pgpm:
+    https://pgpm.io
   `;

package/esm/utils/index.js

@@ -1,3 +1,3 @@
-export { extractFirst } from 'pgpm';
-export { cliExitWithError } from 'pgpm';
+export { extractFirst } from './argv';
+export { cliExitWithError } from './cli-error';
 export { usageText } from './display';

package/esm/utils/update-check.js

@@ -0,0 +1,107 @@
+import { findAndRequirePackageJson } from 'find-and-require-package-json';
+import { Logger } from '@pgpmjs/logger';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+const log = new Logger('update-check');
+const UPDATE_CHECK_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 1 week
+const shouldSkip = (command) => {
+    if (process.env.PGPM_SKIP_UPDATE_CHECK)
+        return true;
+    if (process.env.CI === 'true')
+        return true;
+    return false;
+};
+function getConfigPath(toolName, key) {
+    const configDir = path.join(os.homedir(), `.${toolName}`);
+    return path.join(configDir, `${key}.json`);
+}
+function readConfig(toolName, key) {
+    try {
+        const configPath = getConfigPath(toolName, key);
+        if (!fs.existsSync(configPath))
+            return null;
+        const content = fs.readFileSync(configPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function writeConfig(toolName, key, config) {
+    try {
+        const configPath = getConfigPath(toolName, key);
+        const configDir = path.dirname(configPath);
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+    catch {
+        // Ignore write errors
+    }
+}
+async function fetchLatestVersion(pkgName) {
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${pkgName}/latest`);
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        return data.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareVersions(current, latest) {
+    const currentParts = current.replace(/^v/, '').split('.').map(Number);
+    const latestParts = latest.replace(/^v/, '').split('.').map(Number);
+    for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+        const c = currentParts[i] || 0;
+        const l = latestParts[i] || 0;
+        if (c < l)
+            return -1;
+        if (c > l)
+            return 1;
+    }
+    return 0;
+}
+export async function checkForUpdates(options = {}) {
+    const { pkgName = '@constructive-io/cli', pkgVersion = findAndRequirePackageJson(__dirname).version, command, now = Date.now(), key = 'update-check', toolName = 'constructive' } = options;
+    if (shouldSkip(command)) {
+        return null;
+    }
+    try {
+        const existing = readConfig(toolName, key);
+        let latestKnownVersion = existing?.latestKnownVersion ?? pkgVersion;
+        const needsCheck = !existing?.lastCheckedAt || (now - existing.lastCheckedAt) > UPDATE_CHECK_TTL_MS;
+        if (needsCheck) {
+            const fetched = await fetchLatestVersion(pkgName);
+            if (fetched) {
+                latestKnownVersion = fetched;
+            }
+            writeConfig(toolName, key, {
+                lastCheckedAt: now,
+                latestKnownVersion
+            });
+        }
+        const comparison = compareVersions(pkgVersion, latestKnownVersion);
+        const isOutdated = comparison < 0;
+        if (isOutdated) {
+            const updateInstruction = options.updateCommand ?? `Run npm i -g ${pkgName}@latest to upgrade.`;
+            log.warn(`A new version of ${pkgName} is available (current ${pkgVersion}, latest ${latestKnownVersion}). ${updateInstruction}`);
+            writeConfig(toolName, key, {
+                lastCheckedAt: now,
+                latestKnownVersion
+            });
+        }
+        return {
+            lastCheckedAt: now,
+            latestKnownVersion
+        };
+    }
+    catch (error) {
+        log.debug('Update check skipped due to error:', error);
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/cli",
-  "version": "5.1.24",
+  "version": "5.2.0",
   "author": "Constructive <developers@constructive.io>",
   "description": "Constructive CLI",
   "main": "index.js",
@@ -46,21 +46,21 @@
     "ts-node": "^10.9.2"
   },
   "dependencies": {
-    "@constructive-io/graphql-codegen": "^2.17.32",
-    "@constructive-io/graphql-env": "^2.8.10",
-    "@constructive-io/graphql-explorer": "^2.10.25",
-    "@constructive-io/graphql-server": "^2.10.25",
-    "@pgpmjs/core": "^4.1.1",
+    "@constructive-io/graphql-codegen": "^2.17.33",
+    "@constructive-io/graphql-env": "^2.8.11",
+    "@constructive-io/graphql-explorer": "^2.10.26",
+    "@constructive-io/graphql-server": "^2.10.26",
+    "@pgpmjs/core": "^4.1.2",
     "@pgpmjs/logger": "^1.3.5",
-    "@pgpmjs/server-utils": "^2.8.10",
-    "@pgpmjs/types": "^2.12.7",
+    "@pgpmjs/server-utils": "^2.8.11",
+    "@pgpmjs/types": "^2.12.8",
     "find-and-require-package-json": "^0.8.2",
     "inquirerer": "^2.4.0",
     "js-yaml": "^4.1.0",
     "minimist": "^1.2.8",
-    "pg-cache": "^1.6.10",
+    "pg-cache": "^1.6.11",
     "pg-env": "^1.2.4",
-    "pgpm": "^2.2.1",
+    "pgpm": "^2.3.0",
     "shelljs": "^0.10.0",
     "yanse": "^0.1.8"
   },
@@ -75,5 +75,5 @@
     "postgres",
     "graphile"
   ],
-  "gitHead": "e3d01915223e3d87d263606bc4086e3e88183cab"
+  "gitHead": "c2e68f9808a87e3231d9b9af5e706bef5dbd2af8"
 }

package/utils/argv.d.ts

@@ -0,0 +1,8 @@
+import { ParsedArgs } from 'minimist';
+export declare const extractFirst: (argv: Partial<ParsedArgs>) => {
+    first: string;
+    newArgv: {
+        _: string[];
+        "--"?: string[] | undefined;
+    };
+};

package/utils/argv.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractFirst = void 0;
+const extractFirst = (argv) => {
+    const first = argv._?.[0];
+    const newArgv = {
+        ...argv,
+        _: argv._?.slice(1) ?? []
+    };
+    return { first, newArgv };
+};
+exports.extractFirst = extractFirst;

package/utils/cli-error.d.ts

@@ -0,0 +1,6 @@
+import { PgpmError } from '@pgpmjs/types';
+/**
+ * CLI error utility that logs error information and exits with code 1.
+ * Provides consistent error handling and user experience across all CLI commands.
+ */
+export declare const cliExitWithError: (error: PgpmError | Error | string, context?: Record<string, any>) => Promise<never>;

package/utils/cli-error.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cliExitWithError = void 0;
+const logger_1 = require("@pgpmjs/logger");
+const types_1 = require("@pgpmjs/types");
+const log = new logger_1.Logger('cli');
+/**
+ * CLI error utility that logs error information and exits with code 1.
+ * Provides consistent error handling and user experience across all CLI commands.
+ */
+const cliExitWithError = async (error, context) => {
+    if (error instanceof types_1.PgpmError) {
+        log.error(`Error: ${error.message}`);
+        if (error.context && Object.keys(error.context).length > 0) {
+            log.debug('Error context:', error.context);
+        }
+        if (context) {
+            log.debug('Additional context:', context);
+        }
+    }
+    else if (error instanceof Error) {
+        log.error(`Error: ${error.message}`);
+        if (context) {
+            log.debug('Context:', context);
+        }
+    }
+    else if (typeof error === 'string') {
+        log.error(`Error: ${error}`);
+        if (context) {
+            log.debug('Context:', context);
+        }
+    }
+    process.exit(1);
+};
+exports.cliExitWithError = cliExitWithError;

package/utils/display.d.ts

@@ -1 +1 @@
-export declare const usageText = "\n  Usage: cnc <command> [options]\n         constructive <command> [options]\n\n  Core Database Operations:\n    add                Add database changes to plans and create SQL files\n    deploy             Deploy database changes and migrations\n    verify             Verify database state and migrations\n    revert             Revert database changes and migrations\n\n  Project Management:\n    init               Initialize pgpm workspace or module\n    extension          Manage module dependencies\n    plan               Generate module deployment plans\n    package            Package module for distribution\n    update             Update CLI/pgpm (installs pgpm by default)\n    cache              Manage cached templates (clean)\n    upgrade-modules    Upgrade installed pgpm modules to latest versions\n\n  Development Tools:\n    server             Start a GraphQL server\n    explorer           Launch GraphiQL explorer interface\n    docker             Manage PostgreSQL Docker containers (start/stop)\n    export             Export database migrations from existing databases\n    env                Display environment configuration\n\n  Code Generation:\n    codegen            Generate TypeScript types and SDK from GraphQL schema\n    get-graphql-schema Fetch or build GraphQL schema SDL\n\n  Database Administration:\n    kill               Terminate database connections and optionally drop databases\n    install            Install pgpm modules\n    tag                Add tags to changes for versioning\n    clear              Clear database state\n    remove             Remove database changes\n    analyze            Analyze database structure\n    rename             Rename database changes\n    admin-users        Manage admin users\n\n  Testing:\n    test-packages      Run integration tests on all workspace packages\n\n  Migration Tools:\n    migrate            Migration management subcommands\n      init             Initialize migration tracking\n      status           Show migration status\n      list             List all changes\n      deps             Show change dependencies\n\n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    constructive <command> --help    Display detailed help for specific command\n    constructive <command> -h        Display detailed help for specific command\n\n  Examples:\n    cnc deploy --help       Show deploy command options\n    cnc server --port 8080  Start server on port 8080\n    cnc init workspace      Initialize new workspace\n  ";
+export declare const usageText = "\n  Usage: cnc <command> [options]\n         constructive <command> [options]\n\n  Constructive CLI - API Server and Development Tools\n\n  GraphQL Server:\n    server             Start a GraphQL server\n    explorer           Launch GraphiQL explorer interface\n\n  Code Generation:\n    codegen            Generate TypeScript types and SDK from GraphQL schema\n    get-graphql-schema Fetch or build GraphQL schema SDL\n\n  Global Options:\n    -h, --help         Display this help information\n    -v, --version      Display version information\n    --cwd <directory>  Working directory (default: current directory)\n\n  Individual Command Help:\n    cnc <command> --help    Display detailed help for specific command\n    cnc <command> -h        Display detailed help for specific command\n\n  Examples:\n    cnc server                        Start GraphQL server\n    cnc server --port 8080            Start server on custom port\n    cnc explorer                      Launch GraphiQL explorer\n    cnc codegen --schema schema.graphql  Generate types from schema\n    cnc get-graphql-schema --out schema.graphql  Export schema SDL\n\n  Database Operations:\n    For database migrations, packages, and deployment, use pgpm:\n    https://pgpm.io\n  ";

package/utils/display.js

@@ -5,63 +5,33 @@ exports.usageText = `
   Usage: cnc <command> [options]
          constructive <command> [options]
 
-  Core Database Operations:
-    add                Add database changes to plans and create SQL files
-    deploy             Deploy database changes and migrations
-    verify             Verify database state and migrations
-    revert             Revert database changes and migrations
+  Constructive CLI - API Server and Development Tools
 
-  Project Management:
-    init               Initialize pgpm workspace or module
-    extension          Manage module dependencies
-    plan               Generate module deployment plans
-    package            Package module for distribution
-    update             Update CLI/pgpm (installs pgpm by default)
-    cache              Manage cached templates (clean)
-    upgrade-modules    Upgrade installed pgpm modules to latest versions
-
-  Development Tools:
+  GraphQL Server:
     server             Start a GraphQL server
     explorer           Launch GraphiQL explorer interface
-    docker             Manage PostgreSQL Docker containers (start/stop)
-    export             Export database migrations from existing databases
-    env                Display environment configuration
 
   Code Generation:
     codegen            Generate TypeScript types and SDK from GraphQL schema
     get-graphql-schema Fetch or build GraphQL schema SDL
 
-  Database Administration:
-    kill               Terminate database connections and optionally drop databases
-    install            Install pgpm modules
-    tag                Add tags to changes for versioning
-    clear              Clear database state
-    remove             Remove database changes
-    analyze            Analyze database structure
-    rename             Rename database changes
-    admin-users        Manage admin users
-
-  Testing:
-    test-packages      Run integration tests on all workspace packages
-
-  Migration Tools:
-    migrate            Migration management subcommands
-      init             Initialize migration tracking
-      status           Show migration status
-      list             List all changes
-      deps             Show change dependencies
-
   Global Options:
     -h, --help         Display this help information
     -v, --version      Display version information
     --cwd <directory>  Working directory (default: current directory)
 
   Individual Command Help:
-    constructive <command> --help    Display detailed help for specific command
-    constructive <command> -h        Display detailed help for specific command
+    cnc <command> --help    Display detailed help for specific command
+    cnc <command> -h        Display detailed help for specific command
 
   Examples:
-    cnc deploy --help       Show deploy command options
-    cnc server --port 8080  Start server on port 8080
-    cnc init workspace      Initialize new workspace
+    cnc server                        Start GraphQL server
+    cnc server --port 8080            Start server on custom port
+    cnc explorer                      Launch GraphiQL explorer
+    cnc codegen --schema schema.graphql  Generate types from schema
+    cnc get-graphql-schema --out schema.graphql  Export schema SDL
+
+  Database Operations:
+    For database migrations, packages, and deployment, use pgpm:
+    https://pgpm.io
   `;

package/utils/index.d.ts

@@ -1,3 +1,3 @@
-export { extractFirst } from 'pgpm';
-export { cliExitWithError } from 'pgpm';
+export { extractFirst } from './argv';
+export { cliExitWithError } from './cli-error';
 export { usageText } from './display';

package/utils/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.usageText = exports.cliExitWithError = exports.extractFirst = void 0;
-var pgpm_1 = require("pgpm");
-Object.defineProperty(exports, "extractFirst", { enumerable: true, get: function () { return pgpm_1.extractFirst; } });
-var pgpm_2 = require("pgpm");
-Object.defineProperty(exports, "cliExitWithError", { enumerable: true, get: function () { return pgpm_2.cliExitWithError; } });
+var argv_1 = require("./argv");
+Object.defineProperty(exports, "extractFirst", { enumerable: true, get: function () { return argv_1.extractFirst; } });
+var cli_error_1 = require("./cli-error");
+Object.defineProperty(exports, "cliExitWithError", { enumerable: true, get: function () { return cli_error_1.cliExitWithError; } });
 var display_1 = require("./display");
 Object.defineProperty(exports, "usageText", { enumerable: true, get: function () { return display_1.usageText; } });

package/utils/update-check.d.ts

@@ -0,0 +1,15 @@
+export interface CheckForUpdatesOptions {
+    pkgName?: string;
+    pkgVersion?: string;
+    command?: string;
+    now?: number;
+    updateCommand?: string;
+    toolName?: string;
+    key?: string;
+}
+interface UpdateCheckConfig {
+    lastCheckedAt: number;
+    latestKnownVersion: string;
+}
+export declare function checkForUpdates(options?: CheckForUpdatesOptions): Promise<UpdateCheckConfig | null>;
+export {};

package/utils/update-check.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkForUpdates = checkForUpdates;
+const find_and_require_package_json_1 = require("find-and-require-package-json");
+const logger_1 = require("@pgpmjs/logger");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const os_1 = __importDefault(require("os"));
+const log = new logger_1.Logger('update-check');
+const UPDATE_CHECK_TTL_MS = 7 * 24 * 60 * 60 * 1000; // 1 week
+const shouldSkip = (command) => {
+    if (process.env.PGPM_SKIP_UPDATE_CHECK)
+        return true;
+    if (process.env.CI === 'true')
+        return true;
+    return false;
+};
+function getConfigPath(toolName, key) {
+    const configDir = path_1.default.join(os_1.default.homedir(), `.${toolName}`);
+    return path_1.default.join(configDir, `${key}.json`);
+}
+function readConfig(toolName, key) {
+    try {
+        const configPath = getConfigPath(toolName, key);
+        if (!fs_1.default.existsSync(configPath))
+            return null;
+        const content = fs_1.default.readFileSync(configPath, 'utf8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+function writeConfig(toolName, key, config) {
+    try {
+        const configPath = getConfigPath(toolName, key);
+        const configDir = path_1.default.dirname(configPath);
+        if (!fs_1.default.existsSync(configDir)) {
+            fs_1.default.mkdirSync(configDir, { recursive: true });
+        }
+        fs_1.default.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    }
+    catch {
+        // Ignore write errors
+    }
+}
+async function fetchLatestVersion(pkgName) {
+    try {
+        const response = await fetch(`https://registry.npmjs.org/${pkgName}/latest`);
+        if (!response.ok)
+            return null;
+        const data = await response.json();
+        return data.version || null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareVersions(current, latest) {
+    const currentParts = current.replace(/^v/, '').split('.').map(Number);
+    const latestParts = latest.replace(/^v/, '').split('.').map(Number);
+    for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+        const c = currentParts[i] || 0;
+        const l = latestParts[i] || 0;
+        if (c < l)
+            return -1;
+        if (c > l)
+            return 1;
+    }
+    return 0;
+}
+async function checkForUpdates(options = {}) {
+    const { pkgName = '@constructive-io/cli', pkgVersion = (0, find_and_require_package_json_1.findAndRequirePackageJson)(__dirname).version, command, now = Date.now(), key = 'update-check', toolName = 'constructive' } = options;
+    if (shouldSkip(command)) {
+        return null;
+    }
+    try {
+        const existing = readConfig(toolName, key);
+        let latestKnownVersion = existing?.latestKnownVersion ?? pkgVersion;
+        const needsCheck = !existing?.lastCheckedAt || (now - existing.lastCheckedAt) > UPDATE_CHECK_TTL_MS;
+        if (needsCheck) {
+            const fetched = await fetchLatestVersion(pkgName);
+            if (fetched) {
+                latestKnownVersion = fetched;
+            }
+            writeConfig(toolName, key, {
+                lastCheckedAt: now,
+                latestKnownVersion
+            });
+        }
+        const comparison = compareVersions(pkgVersion, latestKnownVersion);
+        const isOutdated = comparison < 0;
+        if (isOutdated) {
+            const updateInstruction = options.updateCommand ?? `Run npm i -g ${pkgName}@latest to upgrade.`;
+            log.warn(`A new version of ${pkgName} is available (current ${pkgVersion}, latest ${latestKnownVersion}). ${updateInstruction}`);
+            writeConfig(toolName, key, {
+                lastCheckedAt: now,
+                latestKnownVersion
+            });
+        }
+        return {
+            lastCheckedAt: now,
+            latestKnownVersion
+        };
+    }
+    catch (error) {
+        log.debug('Update check skipped due to error:', error);
+        return null;
+    }
+}