@cleocode/core 2026.4.30 → 2026.4.35

package/dist/system/dependencies.js

@@ -0,0 +1,466 @@
+/**
+ * Central dependency registry for CLEO runtime dependency verification.
+ *
+ * This is the SSoT for all external dependency checks. Every CLEO subsystem
+ * that needs to gate a feature on tool availability MUST use functions from
+ * this module rather than implementing ad-hoc `which` / `commandExists` calls.
+ *
+ * Relationship to other modules:
+ *   - `platform.ts` — provides `commandExists()` and `PLATFORM` utilities.
+ *   - `health.ts` — calls `checkAllDependencies()` inside `coreDoctorReport()`.
+ *   - `code/parser.ts` — `isTreeSitterAvailable()` is delegated here for the
+ *     `tree-sitter` dependency check.
+ *
+ * @task T507
+ */
+import { execFileSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { PLATFORM } from '../platform.js';
+/** ESM-safe require function for loading native addons. */
+const _require = createRequire(import.meta.url);
+/** Directory of this compiled file (packages/core/dist/system/). */
+const _dirname = dirname(fileURLToPath(import.meta.url));
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Run a command and return its stdout trimmed, or `null` on failure.
+ *
+ * @param cmd - Executable name or path.
+ * @param args - Arguments to pass.
+ * @param timeoutMs - Max execution time in milliseconds (default: 3000).
+ */
+function tryExec(cmd, args, timeoutMs = 3000) {
+    try {
+        return execFileSync(cmd, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: timeoutMs,
+        })
+            .toString()
+            .trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve the absolute path of a command on PATH, or `null` if absent.
+ *
+ * Uses `which` on POSIX and `where` on Windows, matching `commandExists()`
+ * in `platform.ts`.
+ */
+function which(cmd) {
+    const tool = PLATFORM === 'windows' ? 'where' : 'which';
+    return tryExec(tool, [cmd]);
+}
+/**
+ * Parse a semver-style major version from an arbitrary version string.
+ * Returns the numeric major version, or `null` if unparseable.
+ *
+ * @param raw - Raw version string (e.g. "git version 2.43.0", "v24.1.0").
+ */
+function parseMajorVersion(raw) {
+    // Match first sequence of digits (possibly preceded by "v")
+    const match = /\bv?(\d+)/.exec(raw);
+    if (!match)
+        return null;
+    const major = Number(match[1]);
+    return Number.isNaN(major) ? null : major;
+}
+// ============================================================================
+// Dependency registry — static specifications
+// ============================================================================
+/** All known CLEO dependencies, ordered: required first, then optional/feature. */
+const DEPENDENCY_SPECS = [
+    // ── Required ────────────────────────────────────────────────────────────
+    {
+        name: 'node',
+        category: 'required',
+        description: 'Node.js runtime — the execution environment for all CLEO operations.',
+        versionConstraint: '>=24.0.0',
+        documentationUrl: 'https://nodejs.org/en/download/',
+        installCommand: 'curl -fsSL https://fnm.vercel.app/install | bash && fnm install 24',
+    },
+    {
+        name: 'git',
+        category: 'required',
+        description: 'Git version control — required for cleo checkpoint, cleo init, and hook management.',
+        documentationUrl: 'https://git-scm.com/downloads',
+        installCommand: 'apt install git  # or: brew install git',
+    },
+    // ── Optional (feature-gating) ────────────────────────────────────────────
+    {
+        name: 'tree-sitter',
+        category: 'optional',
+        description: 'Tree-sitter native Node module — enables cleo code outline, cleo code search, and AST analysis. Bundled as a regular dependency; re-run pnpm install if missing.',
+        documentationUrl: 'https://tree-sitter.github.io/tree-sitter/',
+        installCommand: 'pnpm install',
+    },
+    {
+        name: 'gh',
+        category: 'optional',
+        description: 'GitHub CLI — enables cleo issue, cleo release, and GitHub-integrated workflows.',
+        documentationUrl: 'https://cli.github.com/',
+        installCommand: 'brew install gh  # or: apt install gh',
+    },
+    {
+        name: 'unzip',
+        category: 'optional',
+        description: 'unzip — required for cleo agent archive import (extracting .cleo-export bundles).',
+        documentationUrl: 'https://infozip.sourceforge.net/',
+        installCommand: 'apt install unzip  # or: brew install unzip',
+        platforms: ['linux', 'darwin'],
+    },
+    {
+        name: 'zip',
+        category: 'optional',
+        description: 'zip — required for cleo agent archive export (creating .cleo-export bundles).',
+        documentationUrl: 'https://infozip.sourceforge.net/',
+        installCommand: 'apt install zip  # or: brew install zip',
+        platforms: ['linux', 'darwin'],
+    },
+    // ── Feature (native addons — internally managed) ─────────────────────────
+    {
+        name: 'cant-napi',
+        category: 'feature',
+        description: 'Native CANT parser (Rust/napi-rs) — accelerates CANT DSL parsing. Falls back to TS implementation when absent.',
+        documentationUrl: 'https://github.com/kryptobaseddev/cleocode',
+        installCommand: 'cargo build --release -p cant-napi',
+    },
+    {
+        name: 'lafs-napi',
+        category: 'feature',
+        description: 'Native LAFS validator (Rust/napi-rs) — accelerates envelope validation. Falls back to AJV when absent.',
+        documentationUrl: 'https://github.com/kryptobaseddev/cleocode',
+        installCommand: 'cargo build --release -p lafs-napi',
+    },
+];
+// ============================================================================
+// Individual dependency check functions
+// ============================================================================
+/**
+ * Check Node.js availability and version constraint (>=24.0.0).
+ *
+ * Node is always present when CLEO runs — this check validates the VERSION
+ * meets the minimum requirement, not merely that Node exists.
+ */
+function checkNode() {
+    const raw = process.version; // e.g. "v24.1.0"
+    const version = raw.replace(/^v/, '');
+    const major = parseMajorVersion(raw) ?? 0;
+    const healthy = major >= 24;
+    return {
+        name: 'node',
+        category: 'required',
+        installed: true,
+        version,
+        location: process.execPath,
+        healthy,
+        ...(healthy
+            ? {}
+            : {
+                error: `Node.js ${version} does not meet the minimum requirement of >=24.0.0`,
+                suggestedFix: 'Upgrade Node.js: curl -fsSL https://fnm.vercel.app/install | bash && fnm install 24',
+            }),
+    };
+}
+/**
+ * Check git availability.
+ *
+ * Runs `git --version` to detect the installed version string.
+ */
+function checkGit() {
+    const location = which('git');
+    if (!location) {
+        return {
+            name: 'git',
+            category: 'required',
+            installed: false,
+            healthy: false,
+            error: 'git not found on PATH',
+            suggestedFix: 'Install git: https://git-scm.com/downloads',
+        };
+    }
+    const raw = tryExec('git', ['--version']) ?? '';
+    // "git version 2.43.0" -> "2.43.0"
+    const version = raw.replace(/^git version\s*/i, '').split(/\s/)[0] ?? raw;
+    return {
+        name: 'git',
+        category: 'required',
+        installed: true,
+        version: version || undefined,
+        location: location.split('\n')[0] ?? location, // `where` may return multiple lines on Windows
+        healthy: true,
+    };
+}
+/**
+ * Check tree-sitter native Node module availability.
+ *
+ * Delegates to `isTreeSitterAvailable()` from `packages/core/src/code/parser.ts`
+ * which probes whether the `tree-sitter` native module loads successfully.
+ * No CLI binary on PATH is required — the module ships as a bundled dependency.
+ */
+async function checkTreeSitter() {
+    // Lazy import to avoid circular dependency and to keep this module lightweight
+    const { isTreeSitterAvailable } = await import('../code/parser.js');
+    const available = isTreeSitterAvailable();
+    // Read the installed package version from its package.json if available
+    let version;
+    if (available) {
+        try {
+            const pkgJson = _require('tree-sitter/package.json');
+            version = pkgJson.version;
+        }
+        catch {
+            version = undefined;
+        }
+    }
+    return {
+        name: 'tree-sitter',
+        category: 'optional',
+        installed: available,
+        version,
+        location: available ? 'node_modules/tree-sitter (native binding)' : undefined,
+        // Optional: missing is healthy (feature simply disabled)
+        healthy: true,
+        ...(available
+            ? {}
+            : {
+                error: 'tree-sitter native module not loaded — cleo code outline/search/unfold features are disabled',
+                suggestedFix: 'pnpm install',
+            }),
+    };
+}
+/**
+ * Check GitHub CLI (`gh`) availability.
+ */
+function checkGh() {
+    const location = which('gh');
+    if (!location) {
+        return {
+            name: 'gh',
+            category: 'optional',
+            installed: false,
+            healthy: true, // optional — absence is acceptable
+            error: 'gh not found — cleo issue and cleo release features are disabled',
+            suggestedFix: 'Install GitHub CLI: https://cli.github.com/',
+        };
+    }
+    const versionRaw = tryExec('gh', ['--version']) ?? '';
+    // "gh version 2.40.1 (2024-01-15)" -> "2.40.1"
+    const versionMatch = /\bgh version\s+(\S+)/.exec(versionRaw);
+    const version = versionMatch?.[1] ?? undefined;
+    return {
+        name: 'gh',
+        category: 'optional',
+        installed: true,
+        version,
+        location: location.split('\n')[0] ?? location,
+        healthy: true,
+    };
+}
+/**
+ * Check availability of a simple CLI tool (unzip, zip, etc.).
+ *
+ * @param name - Tool name as it appears on PATH.
+ * @param category - Dependency category for the spec.
+ * @param errorMsg - Human-readable description of what is disabled when absent.
+ * @param fixHint - Install hint to show the user.
+ */
+function checkSimpleTool(name, category, errorMsg, fixHint) {
+    const location = which(name);
+    if (!location) {
+        return {
+            name,
+            category,
+            installed: false,
+            healthy: true, // optional — absence is acceptable
+            error: errorMsg,
+            suggestedFix: fixHint,
+        };
+    }
+    return {
+        name,
+        category,
+        installed: true,
+        location: location.split('\n')[0] ?? location,
+        healthy: true,
+    };
+}
+/**
+ * Check cant-napi native addon availability.
+ *
+ * Probes the native binary directly using the same path resolution that
+ * `packages/cant/src/native-loader.ts` uses, without importing the cant
+ * package (which would create a circular dep: core → cant → core).
+ *
+ * The resolution order mirrors the cant native-loader:
+ *   1. `packages/cant/napi/cant.linux-x64-gnu.node` (installed binary)
+ *   2. `crates/cant-napi/index.cjs` (dev build output)
+ */
+function checkCantNapi() {
+    let available = false;
+    try {
+        // From packages/core/dist/system/ the relative path to the cant binary:
+        // ../../../cant/napi/cant.linux-x64-gnu.node
+        const binary = _require.resolve('../../../cant/napi/cant.linux-x64-gnu.node', {
+            paths: [_dirname],
+        });
+        _require(binary);
+        available = true;
+    }
+    catch {
+        try {
+            const fallback = _require.resolve('../../../../crates/cant-napi/index.cjs', {
+                paths: [_dirname],
+            });
+            _require(fallback);
+            available = true;
+        }
+        catch {
+            available = false;
+        }
+    }
+    return {
+        name: 'cant-napi',
+        category: 'feature',
+        installed: available,
+        healthy: true, // feature: TypeScript fallback is always present
+        ...(available
+            ? {}
+            : {
+                error: 'cant-napi native addon not loaded — using TypeScript CANT parser (slower)',
+                suggestedFix: 'cargo build --release -p cant-napi',
+            }),
+    };
+}
+/**
+ * Check lafs-napi native addon availability.
+ *
+ * Attempts to load the native module via `createRequire` using the same
+ * resolution strategy as `packages/lafs/src/native-loader.ts`, without
+ * importing the lafs package as a module (the `./native-loader` subpath is
+ * not exported in the lafs `package.json` exports map).
+ *
+ * The resolution order mirrors the lafs native-loader:
+ *   1. `@cleocode/lafs-native` npm package
+ *   2. `crates/lafs-napi/index.cjs` (dev build output)
+ */
+function checkLafsNapi() {
+    let available = false;
+    try {
+        _require.resolve('@cleocode/lafs-native', { paths: [_dirname] });
+        _require('@cleocode/lafs-native');
+        available = true;
+    }
+    catch {
+        try {
+            const fallback = _require.resolve('../../../../crates/lafs-napi/index.cjs', {
+                paths: [_dirname],
+            });
+            _require(fallback);
+            available = true;
+        }
+        catch {
+            available = false;
+        }
+    }
+    return {
+        name: 'lafs-napi',
+        category: 'feature',
+        installed: available,
+        healthy: true, // feature: AJV fallback is always present
+        ...(available
+            ? {}
+            : {
+                error: 'lafs-napi native addon not loaded — using AJV validator (slower)',
+                suggestedFix: 'cargo build --release -p lafs-napi',
+            }),
+    };
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Return all registered dependency specifications.
+ *
+ * Useful for generating documentation, help text, or install guides without
+ * running any system checks.
+ *
+ * @returns Immutable array of {@link DependencySpec} objects.
+ */
+export function getDependencySpecs() {
+    return DEPENDENCY_SPECS;
+}
+/**
+ * Check a single dependency by name and return its runtime result.
+ *
+ * @param name - Canonical dependency identifier (must match a registered spec).
+ * @returns The check result, or an error result if the name is unknown.
+ */
+export async function checkDependency(name) {
+    switch (name) {
+        case 'node':
+            return Promise.resolve(checkNode());
+        case 'git':
+            return Promise.resolve(checkGit());
+        case 'tree-sitter':
+            return checkTreeSitter();
+        case 'gh':
+            return Promise.resolve(checkGh());
+        case 'unzip':
+            return Promise.resolve(checkSimpleTool('unzip', 'optional', 'unzip not found — cleo agent archive import is disabled', 'apt install unzip  # or: brew install unzip'));
+        case 'zip':
+            return Promise.resolve(checkSimpleTool('zip', 'optional', 'zip not found — cleo agent archive export is disabled', 'apt install zip  # or: brew install zip'));
+        case 'cant-napi':
+            return Promise.resolve(checkCantNapi());
+        case 'lafs-napi':
+            return Promise.resolve(checkLafsNapi());
+        default:
+            return Promise.resolve({
+                name,
+                category: 'optional',
+                installed: false,
+                healthy: false,
+                error: `Unknown dependency: "${name}" — not registered in the CLEO dependency registry`,
+            });
+    }
+}
+/**
+ * Check all registered CLEO dependencies and return a consolidated report.
+ *
+ * Skips platform-specific dependencies that do not apply to the current OS.
+ * For example, `unzip` and `zip` are only checked on Linux and macOS.
+ *
+ * @returns A {@link DependencyReport} with results for every applicable dependency.
+ */
+export async function checkAllDependencies() {
+    const timestamp = new Date().toISOString();
+    const platform = process.platform;
+    const nodeVersion = process.version.replace(/^v/, '');
+    const applicableSpecs = DEPENDENCY_SPECS.filter((spec) => {
+        if (!spec.platforms)
+            return true;
+        return spec.platforms.includes(platform);
+    });
+    const results = await Promise.all(applicableSpecs.map((spec) => checkDependency(spec.name)));
+    const requiredResults = results.filter((r) => r.category === 'required');
+    const allRequiredMet = requiredResults.every((r) => r.healthy);
+    const warnings = [];
+    for (const result of results) {
+        if (!result.installed && result.error) {
+            warnings.push(result.error);
+        }
+    }
+    return {
+        timestamp,
+        platform,
+        nodeVersion,
+        results,
+        allRequiredMet,
+        warnings,
+    };
+}
+//# sourceMappingURL=dependencies.js.map

package/dist/system/dependencies.js.map

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

package/dist/system/health.d.ts

@@ -3,6 +3,7 @@
  * @task T4783
  * @task T4795
  */
+import type { DependencyReport } from '@cleocode/contracts';
 import { type SystemInfo } from '../platform.js';
 export interface HealthCheck {
     name: string;
@@ -51,6 +52,8 @@ export interface DoctorReport {
     errors: number;
     warnings: number;
     checks: DoctorCheck[];
+    /** Dependency registry report — populated by `checkAllDependencies()`. */
+    dependencies?: DependencyReport;
 }
 /**
  * Run comprehensive doctor diagnostics combining dependency checks,

package/dist/system/health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/system/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,OAAO,EAAiB,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAqGhE,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACzC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,IAAI,GAAG,UAAU,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,2DAA2D;AAC3D,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5B,OAAO,CAAC,YAAY,CAAC,CAsKvB;AAED,qDAAqD;AACrD,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAC3B,OAAO,CAAC,iBAAiB,CAAC,CA8G5B;AAMD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAwJD;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyOjF;AAMD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA2J9E;AAMD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,6DAA6D;IAC7D,KAAK,EAAE,YAAY,CAAC;IACpB,0EAA0E;IAC1E,aAAa,EAAE,OAAO,CAAC;IACvB,kEAAkE;IAClE,cAAc,EAAE,OAAO,CAAC;IACxB,wDAAwD;IACxD,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,wEAAwE;IACxE,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA8O3F"}
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/system/health.ts"],"names":[],"mappings":"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"}