@prodara/cli 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# @prodara/cli
+
+A thin global CLI wrapper that resolves and delegates to the project-local `@prodara/compiler`.
+
+## Installation
+
+```bash
+npm install -g @prodara/cli
+```
+
+## How It Works
+
+1. Walks up from the current directory to find `node_modules/@prodara/compiler`
+2. Checks version compatibility (major versions must match)
+3. Delegates all commands to the local compiler's CLI binary via `execFileSync`
+
+This ensures you always run the compiler version pinned in your project's `package.json`.
+
+## Usage
+
+```bash
+# In a project with @prodara/compiler installed locally
+prodara build
+prodara validate
+prodara graph
+prodara plan
+prodara test
+prodara doctor
+```
+
+If no local compiler is found, the CLI prints installation instructions.
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+// ---------------------------------------------------------------------------
+// @prodara/cli — Entry Point (thin wrapper)
+// ---------------------------------------------------------------------------
+// This is the global `prodara` command. Its job:
+//   1. Resolve the project-local @prodara/compiler installation
+//   2. Delegate to the local CLI binary
+//   3. If no local install exists, provide a helpful error
+//
+// This mirrors the Angular CLI delegation pattern — the global wrapper
+// finds and exec's the local compiler so users always run the version
+// pinned in their project's package.json.
+import { execFileSync } from 'node:child_process';
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { resolveLocal, checkVersionCompatibility } from './resolve.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function getWrapperVersion() {
+    const pkgPath = resolve(__dirname, '..', 'package.json');
+    if (existsSync(pkgPath)) {
+        try {
+            const raw = readFileSync(pkgPath, 'utf-8');
+            const pkg = JSON.parse(raw);
+            return typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+        }
+        catch {
+            return '0.0.0';
+        }
+    }
+    return '0.0.0';
+}
+function main() {
+    const cwd = process.cwd();
+    const local = resolveLocal(cwd);
+    const wrapperVersion = getWrapperVersion();
+    if (!local) {
+        process.stderr.write('Error: Could not find a local installation of @prodara/compiler.\n' +
+            '\n' +
+            'To set up a Prodara project:\n' +
+            '  npm install --save-dev @prodara/compiler\n' +
+            '  npx prodara init\n' +
+            '\n' +
+            `@prodara/cli v${wrapperVersion}\n`);
+        process.exitCode = 1;
+        return;
+    }
+    // Check version compatibility
+    const compat = checkVersionCompatibility(wrapperVersion, local.version);
+    if (!compat.compatible) {
+        process.stderr.write(`Warning: ${compat.message}\n\n`);
+        // Still attempt delegation — only hard-fail on truly broken resolution
+    }
+    // Check that the local CLI entry exists (package may not be built)
+    if (!existsSync(local.cliEntry)) {
+        process.stderr.write(`Error: Found @prodara/compiler v${local.version} at ${local.packageDir}\n` +
+            'but the CLI binary is not built.\n' +
+            '\n' +
+            'Try: cd <project-root> && npm run build --workspace=packages/compiler\n' +
+            'Or:  npx prodara <command>  (uses the local bin directly)\n');
+        process.exitCode = 1;
+        return;
+    }
+    // Delegate to the local compiler CLI
+    const args = process.argv.slice(2);
+    try {
+        execFileSync(process.execPath, [local.cliEntry, ...args], {
+            cwd,
+            stdio: 'inherit',
+            env: process.env,
+        });
+    }
+    catch (err) {
+        // execFileSync throws if exit code is non-zero; propagate it
+        if (err && typeof err === 'object' && 'status' in err) {
+            process.exitCode = err.status;
+        }
+        else {
+            process.exitCode = 1;
+        }
+    }
+}
+main();
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { resolveLocal, parseSemver, checkVersionCompatibility } from './resolve.js';
+export type { LocalResolution } from './resolve.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// @prodara/cli — Public API
+// ---------------------------------------------------------------------------
+export { resolveLocal, parseSemver, checkVersionCompatibility } from './resolve.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4BAA4B;AAC5B,8EAA8E;AAC9E,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,27 @@
+/** Result of resolving a local @prodara/compiler installation. */
+export interface LocalResolution {
+    /** Absolute path to the local @prodara/compiler package directory */
+    readonly packageDir: string;
+    /** Version string from the local package.json */
+    readonly version: string;
+    /** Absolute path to the local CLI entry point (dist/cli/main.js) */
+    readonly cliEntry: string;
+}
+/**
+ * Walk up from `startDir` looking for node_modules/@prodara/compiler.
+ * Returns null if no local installation is found.
+ */
+export declare function resolveLocal(startDir: string): LocalResolution | null;
+/**
+ * Parse a semver version string into major.minor.patch.
+ * Returns [0,0,0] if parsing fails.
+ */
+export declare function parseSemver(version: string): [number, number, number];
+/**
+ * Check whether two versions are compatible (same major, local >= wrapper).
+ */
+export declare function checkVersionCompatibility(wrapperVersion: string, localVersion: string): {
+    compatible: boolean;
+    message: string;
+};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAUA,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,oEAAoE;IACpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAkCrE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAIrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAe1C"}

package/dist/resolve.js

@@ -0,0 +1,69 @@
+// ---------------------------------------------------------------------------
+// @prodara/cli — Local Resolution
+// ---------------------------------------------------------------------------
+// Resolves the project-local @prodara/compiler installation.
+// Walks up from cwd looking for node_modules/@prodara/compiler.
+// Returns the resolved path or null if not found.
+import { existsSync, readFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+/**
+ * Walk up from `startDir` looking for node_modules/@prodara/compiler.
+ * Returns null if no local installation is found.
+ */
+export function resolveLocal(startDir) {
+    let current = startDir;
+    for (;;) {
+        const candidate = join(current, 'node_modules', '@prodara', 'compiler');
+        const pkgPath = join(candidate, 'package.json');
+        if (existsSync(pkgPath)) {
+            try {
+                const raw = readFileSync(pkgPath, 'utf-8');
+                const pkg = JSON.parse(raw);
+                const version = typeof pkg.version === 'string' ? pkg.version : '0.0.0';
+                // The CLI entry is either the bin field or the conventional path
+                const cliEntry = join(candidate, 'dist', 'cli', 'main.js');
+                if (existsSync(cliEntry)) {
+                    return { packageDir: candidate, version, cliEntry };
+                }
+                // Package found but not built — this is a valid resolution but with a
+                // missing binary. We still return it so the caller can give a helpful message.
+                return { packageDir: candidate, version, cliEntry };
+            }
+            catch {
+                // Corrupted package.json — skip this candidate
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            break; // reached filesystem root
+        current = parent;
+    }
+    return null;
+}
+/**
+ * Parse a semver version string into major.minor.patch.
+ * Returns [0,0,0] if parsing fails.
+ */
+export function parseSemver(version) {
+    const match = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (!match)
+        return [0, 0, 0];
+    return [Number(match[1]), Number(match[2]), Number(match[3])];
+}
+/**
+ * Check whether two versions are compatible (same major, local >= wrapper).
+ */
+export function checkVersionCompatibility(wrapperVersion, localVersion) {
+    const [wMajor] = parseSemver(wrapperVersion);
+    const [lMajor] = parseSemver(localVersion);
+    if (wMajor !== lMajor) {
+        return {
+            compatible: false,
+            message: `Version mismatch: @prodara/cli v${wrapperVersion} (major ${wMajor}) ` +
+                `is incompatible with local @prodara/compiler v${localVersion} (major ${lMajor}).\n` +
+                `Update one of them so the major versions match.`,
+        };
+    }
+    return { compatible: true, message: '' };
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAC9E,6DAA6D;AAC7D,gEAAgE;AAChE,kDAAkD;AAElD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAY1C;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,IAAI,OAAO,GAAG,QAAQ,CAAC;IAEvB,SAAS,CAAC;QACR,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QACxE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;QAEhD,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuD,CAAC;gBAClF,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;gBAExE,iEAAiE;gBACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;gBAE3D,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACzB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACtD,CAAC;gBAED,sEAAsE;gBACtE,+EAA+E;gBAC/E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,+CAA+C;YACjD,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM,CAAC,0BAA0B;QACzD,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,MAAM,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,cAAsB,EACtB,YAAoB;IAEpB,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;IAE3C,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,UAAU,EAAE,KAAK;YACjB,OAAO,EACL,mCAAmC,cAAc,WAAW,MAAM,IAAI;gBACtE,iDAAiD,YAAY,WAAW,MAAM,MAAM;gBACpF,iDAAiD;SACpD,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAC3C,CAAC"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@prodara/cli",
+  "version": "0.1.0",
+  "description": "Prodara CLI — thin wrapper that delegates to the project-local @prodara/compiler",
+  "author": "Prodara Contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prodara-ai/prodara.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/prodara-ai/prodara/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/prodara-ai/prodara/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "prodara": "dist/bin.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "prodara",
+    "cli",
+    "compiler"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@prodara/compiler": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "^5.5.0"
+  }
+}