@zenithbuild/cli 0.6.5 → 0.6.7

package/dist/version-check.js

@@ -1,12 +1,7 @@
 import { spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import {
-    readCliPackageVersion,
-    readInstalledPackageVersion,
-    resolveBundlerBin
-} from './toolchain-paths.js';
-
+import { resolve } from 'node:path';
+import { readCliPackageVersion, readInstalledPackageVersion, resolveBundlerBin } from './toolchain-paths.js';
 const PACKAGE_KEYS = [
     ['core', '@zenithbuild/core'],
     ['compiler', '@zenithbuild/compiler'],
@@ -14,7 +9,6 @@ const PACKAGE_KEYS = [
     ['router', '@zenithbuild/router'],
     ['bundlerPackage', '@zenithbuild/bundler']
 ];
-
 function parseVersion(version) {
     const raw = String(version || '').trim();
     const match = raw.match(/^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/);
@@ -30,7 +24,6 @@ function parseVersion(version) {
         prereleaseParts: match[4] ? match[4].split('.') : []
     };
 }
-
 function compareIdentifiers(left, right) {
     const leftNumeric = /^\d+$/.test(left);
     const rightNumeric = /^\d+$/.test(right);
@@ -45,23 +38,21 @@ function compareIdentifiers(left, right) {
     }
     return left.localeCompare(right);
 }
-
 export function compareVersions(leftVersion, rightVersion) {
     const left = parseVersion(leftVersion);
     const right = parseVersion(rightVersion);
-    if (!left && !right) return 0;
-    if (!left) return -1;
-    if (!right) return 1;
-
-    const numberDelta = (
-        (left.major - right.major)
+    if (!left && !right)
+        return 0;
+    if (!left)
+        return -1;
+    if (!right)
+        return 1;
+    const numberDelta = ((left.major - right.major)
         || (left.minor - right.minor)
-        || (left.patch - right.patch)
-    );
+        || (left.patch - right.patch));
     if (numberDelta !== 0) {
         return numberDelta;
     }
-
     if (!left.prerelease && !right.prerelease) {
         return 0;
     }
@@ -71,7 +62,6 @@ export function compareVersions(leftVersion, rightVersion) {
     if (!right.prerelease) {
         return -1;
     }
-
     const len = Math.max(left.prereleaseParts.length, right.prereleaseParts.length);
     for (let index = 0; index < len; index += 1) {
         const leftPart = left.prereleaseParts[index];
@@ -87,10 +77,8 @@ export function compareVersions(leftVersion, rightVersion) {
             return delta;
         }
     }
-
     return 0;
 }
-
 function prereleaseChannel(parsed) {
     if (!parsed || !parsed.prerelease) {
         return 'stable';
@@ -101,7 +89,6 @@ function prereleaseChannel(parsed) {
     }
     return label;
 }
-
 function classifyDifference(expectedVersion, actualVersion) {
     if (!expectedVersion || !actualVersion) {
         return 'unknown';
@@ -122,7 +109,6 @@ function classifyDifference(expectedVersion, actualVersion) {
     }
     return 'soft';
 }
-
 function readProjectPackage(projectRoot) {
     if (!projectRoot) {
         return null;
@@ -133,11 +119,11 @@ function readProjectPackage(projectRoot) {
             return null;
         }
         return JSON.parse(readFileSync(manifestPath, 'utf8'));
-    } catch {
+    }
+    catch {
         return null;
     }
 }
-
 function buildFixCommand(projectRoot, targetVersion) {
     const manifest = readProjectPackage(projectRoot);
     const dependencyNames = [
@@ -148,7 +134,6 @@ function buildFixCommand(projectRoot, targetVersion) {
         '@zenithbuild/router',
         '@zenithbuild/bundler'
     ];
-
     const deps = [];
     const devDeps = [];
     for (const name of dependencyNames) {
@@ -158,7 +143,6 @@ function buildFixCommand(projectRoot, targetVersion) {
         }
         devDeps.push(`${name}@${targetVersion}`);
     }
-
     const commands = [];
     if (deps.length > 0) {
         commands.push(`npm i ${deps.join(' ')}`);
@@ -171,7 +155,6 @@ function buildFixCommand(projectRoot, targetVersion) {
     }
     return commands.join(' && ');
 }
-
 function describeVersions(versions) {
     const entries = [
         ['cli', versions.cli],
@@ -184,17 +167,15 @@ function describeVersions(versions) {
         ['bundler bin', versions.bundlerBinary]
     ];
     return entries
-        .filter(([, version]) => typeof version === 'string' && version.length > 0)
+        .filter((entry) => typeof entry[1] === 'string' && entry[1].length > 0)
         .map(([label, version]) => `${label}=${version}`)
         .join(' ');
 }
-
 function summarizeIssues(issues) {
     const preview = issues.slice(0, 3).map((issue) => issue.summary);
     const suffix = issues.length > 3 ? ` +${issues.length - 3} more` : '';
     return `${preview.join('; ')}${suffix}`;
 }
-
 function determineTargetVersion(versions) {
     const candidates = [
         versions.projectCli,
@@ -205,11 +186,9 @@ function determineTargetVersion(versions) {
         versions.bundlerPackage,
         versions.cli
     ].filter((value) => typeof value === 'string' && value.length > 0);
-
     if (candidates.length === 0) {
         return '0.0.0';
     }
-
     let highest = candidates[0];
     for (const candidate of candidates.slice(1)) {
         if (compareVersions(candidate, highest) > 0) {
@@ -218,7 +197,6 @@ function determineTargetVersion(versions) {
     }
     return highest;
 }
-
 export function getBundlerVersion(bundlerBinPath) {
     const path = String(bundlerBinPath || '').trim();
     if (!path) {
@@ -233,7 +211,6 @@ export function getBundlerVersion(bundlerBinPath) {
             ok: false
         };
     }
-
     const rawOutput = `${result.stdout || ''}\n${result.stderr || ''}`.trim();
     const versionMatch = rawOutput.match(/(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)/);
     return {
@@ -243,32 +220,32 @@ export function getBundlerVersion(bundlerBinPath) {
         ok: result.status === 0 && Boolean(versionMatch)
     };
 }
-
 export function getLocalZenithVersions({ projectRoot, bundlerBinPath } = {}) {
-    const resolvedBundlerBin = bundlerBinPath || resolveBundlerBin(projectRoot);
+    const resolvedBundlerBin = bundlerBinPath || resolveBundlerBin(projectRoot ?? null);
     const bundlerVersion = getBundlerVersion(resolvedBundlerBin);
     const versions = {
         cli: readCliPackageVersion(),
-        projectCli: readInstalledPackageVersion('@zenithbuild/cli', projectRoot),
+        projectCli: readInstalledPackageVersion('@zenithbuild/cli', projectRoot ?? null),
+        core: null,
+        compiler: null,
+        runtime: null,
+        router: null,
+        bundlerPackage: null,
         bundlerBinary: bundlerVersion.version,
         bundlerBinPath: bundlerVersion.path,
         bundlerBinRawOutput: bundlerVersion.rawOutput,
         targetVersion: null
     };
-
     for (const [key, packageName] of PACKAGE_KEYS) {
-        versions[key] = readInstalledPackageVersion(packageName, projectRoot);
+        versions[key] = readInstalledPackageVersion(packageName, projectRoot ?? null);
     }
-
     versions.targetVersion = determineTargetVersion(versions);
     return versions;
 }
-
 export function checkCompatibility(versions) {
-    const targetVersion = versions?.targetVersion || determineTargetVersion(versions || {});
+    const targetVersion = versions.targetVersion || determineTargetVersion(versions);
     const issues = [];
-    const fixCommand = buildFixCommand(versions?.projectRoot, targetVersion);
-
+    const fixCommand = buildFixCommand(versions.projectRoot, targetVersion);
     const addIssue = (code, summary, message) => {
         issues.push({
             code,
@@ -278,16 +255,10 @@ export function checkCompatibility(versions) {
             fixCommand
         });
     };
-
     if (versions.projectCli && versions.cli && versions.projectCli !== versions.cli) {
         const severity = classifyDifference(versions.projectCli, versions.cli);
-        addIssue(
-            severity === 'hard' ? 'CLI_TRAIN_MISMATCH' : 'CLI_OUTDATED',
-            `cli ${versions.cli} != project ${versions.projectCli}`,
-            `Version mismatch detected (may break HMR/refs): executing CLI ${versions.cli} does not match project CLI ${versions.projectCli}.`
-        );
+        addIssue(severity === 'hard' ? 'CLI_TRAIN_MISMATCH' : 'CLI_OUTDATED', `cli ${versions.cli} != project ${versions.projectCli}`, `Version mismatch detected (may break HMR/refs): executing CLI ${versions.cli} does not match project CLI ${versions.projectCli}.`);
     }
-
     for (const [key, label] of [
         ['core', 'core'],
         ['compiler', 'compiler'],
@@ -295,39 +266,23 @@ export function checkCompatibility(versions) {
         ['router', 'router'],
         ['bundlerPackage', 'bundler package']
     ]) {
-        const actual = versions[key];
+        const actual = versions[key] ?? null;
         const difference = classifyDifference(targetVersion, actual);
         if (difference === 'hard') {
-            addIssue(
-                'VERSION_TRAIN_MISMATCH',
-                `${label} ${actual} != ${targetVersion}`,
-                `Version mismatch detected (may break HMR/refs): ${label} ${actual} is on a different Zenith train than ${targetVersion}.`
-            );
-        } else if (difference === 'soft') {
-            addIssue(
-                'VERSION_OUTDATED',
-                `${label} ${actual} != ${targetVersion}`,
-                `Version mismatch detected (may break HMR/refs): ${label} ${actual} is not aligned with ${targetVersion}.`
-            );
+            addIssue('VERSION_TRAIN_MISMATCH', `${label} ${actual} != ${targetVersion}`, `Version mismatch detected (may break HMR/refs): ${label} ${actual} is on a different Zenith train than ${targetVersion}.`);
+        }
+        else if (difference === 'soft') {
+            addIssue('VERSION_OUTDATED', `${label} ${actual} != ${targetVersion}`, `Version mismatch detected (may break HMR/refs): ${label} ${actual} is not aligned with ${targetVersion}.`);
         }
     }
-
     const bundlerExpected = versions.bundlerPackage || targetVersion;
     const bundlerDifference = classifyDifference(bundlerExpected, versions.bundlerBinary);
     if (bundlerDifference === 'hard') {
-        addIssue(
-            'BUNDLER_BINARY_MISMATCH',
-            `bundler bin ${versions.bundlerBinary || 'missing'} != ${bundlerExpected}`,
-            `Version mismatch detected (may break build/IR contracts): bundler binary ${versions.bundlerBinary || 'missing'} does not match ${bundlerExpected}.`
-        );
-    } else if (bundlerDifference === 'soft') {
-        addIssue(
-            'BUNDLER_BINARY_OUTDATED',
-            `bundler bin ${versions.bundlerBinary} != ${bundlerExpected}`,
-            `Version mismatch detected (may break build/IR contracts): bundler binary ${versions.bundlerBinary} is not aligned with ${bundlerExpected}.`
-        );
-    }
-
+        addIssue('BUNDLER_BINARY_MISMATCH', `bundler bin ${versions.bundlerBinary || 'missing'} != ${bundlerExpected}`, `Version mismatch detected (may break build/IR contracts): bundler binary ${versions.bundlerBinary || 'missing'} does not match ${bundlerExpected}.`);
+    }
+    else if (bundlerDifference === 'soft') {
+        addIssue('BUNDLER_BINARY_OUTDATED', `bundler bin ${versions.bundlerBinary} != ${bundlerExpected}`, `Version mismatch detected (may break build/IR contracts): bundler binary ${versions.bundlerBinary} is not aligned with ${bundlerExpected}.`);
+    }
     return {
         status: issues.length === 0 ? 'ok' : 'warn',
         issues,
@@ -340,36 +295,24 @@ export function checkCompatibility(versions) {
         }
     };
 }
-
-export async function maybeWarnAboutZenithVersionMismatch({
-    projectRoot,
-    logger,
-    command = 'build',
-    bundlerBinPath = null
-} = {}) {
+export async function maybeWarnAboutZenithVersionMismatch({ projectRoot, logger, command = 'build', bundlerBinPath = null } = {}) {
     if (!logger || process.env.ZENITH_SKIP_VERSION_CHECK === '1') {
-        return { status: 'ok', issues: [], details: {} };
+        return { status: 'ok', issues: [], details: { targetVersion: '0.0.0', versions: {}, summary: '' } };
     }
-
     const versions = getLocalZenithVersions({ projectRoot, bundlerBinPath });
-    versions.projectRoot = projectRoot;
+    versions.projectRoot = projectRoot ?? null;
     const result = checkCompatibility(versions);
     const onceKey = `zenith-version-check:${describeVersions(versions)}:${result.status}`;
     const verboseTag = command === 'dev' ? 'DEV' : 'BUILD';
-
     if (result.status === 'ok') {
         logger.verbose(verboseTag, `toolchain versions ok ${result.details.summary}`);
         return result;
     }
-
     const primary = result.issues[0];
-    logger.warn(
-        `${primary.message} ${summarizeIssues(result.issues)}`,
-        {
-            onceKey,
-            hint: primary.hint
-        }
-    );
+    logger.warn(`${primary.message} ${summarizeIssues(result.issues)}`, {
+        onceKey,
+        hint: primary.hint
+    });
     logger.verbose(verboseTag, `toolchain versions ${result.details.summary}`);
     if (versions.bundlerBinPath) {
         logger.verbose(verboseTag, `bundler bin path=${versions.bundlerBinPath}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zenithbuild/cli",
-  "version": "0.6.5",
+  "version": "0.6.7",
   "description": "Deterministic project orchestrator for Zenith framework",
   "license": "MIT",
   "type": "module",
@@ -15,22 +15,34 @@
     "dist/**",
     "package.json"
   ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/zenithbuild/framework",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/zenithbuild/framework/issues"
+  },
+  "homepage": "https://github.com/zenithbuild/framework#readme",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "mkdir -p dist && cp -a src/* dist/",
-    "test": "node --experimental-vm-modules $(node -e \"const path=require('node:path');const pkg=require.resolve('jest/package.json');process.stdout.write(path.join(path.dirname(pkg),'bin/jest.js'))\") --config jest.config.js --forceExit --runInBand",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node -e \"const fs=require('fs');if(fs.existsSync('dist/index.js')) fs.chmodSync('dist/index.js',0o755)\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "bun run build && node --experimental-vm-modules $(node -e \"const path=require('node:path');const pkg=require.resolve('jest/package.json');process.stdout.write(path.join(path.dirname(pkg),'bin/jest.js'))\") --config jest.config.js --forceExit --runInBand",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@zenithbuild/compiler": "^0.6.5",
+    "@zenithbuild/compiler": "0.6.7",
     "picocolors": "^1.1.1"
   },
   "devDependencies": {
+    "@types/node": "latest",
     "@jest/globals": "^30.2.0",
     "jest": "^30.2.0",
-    "jest-environment-jsdom": "^30.2.0"
+    "jest-environment-jsdom": "^30.2.0",
+    "typescript": "^5.7.3"
   },
   "private": false
 }