@codeyam/codeyam-cli 0.1.0-staging.d0ad4ae → 0.1.0-staging.d4f25c3

package/codeyam-cli/src/__tests__/memory-scripts/filter-session.test.js

@@ -0,0 +1,196 @@
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+const SCRIPTS_DIR = path.resolve(__dirname, '../../../templates/skills/codeyam-memory/scripts');
+const FILTER_SCRIPT = path.join(SCRIPTS_DIR, 'session-mining/filter-session.mjs');
+function runFilter(lines) {
+    const tmp = path.join(os.tmpdir(), `filter-test-${Date.now()}.jsonl`);
+    try {
+        fs.writeFileSync(tmp, lines.map((l) => JSON.stringify(l)).join('\n'));
+        const stdout = execFileSync('node', [FILTER_SCRIPT, tmp], {
+            encoding: 'utf-8',
+        });
+        return stdout
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((line) => JSON.parse(line));
+    }
+    finally {
+        fs.unlinkSync(tmp);
+    }
+}
+function assistantMsg(content) {
+    return {
+        type: 'assistant',
+        timestamp: '2024-01-15T10:00:00Z',
+        message: { content },
+    };
+}
+function userMsg(content) {
+    return {
+        type: 'user',
+        timestamp: '2024-01-15T10:00:01Z',
+        message: { content },
+    };
+}
+describe('filter-session.mjs', () => {
+    it('passes through assistant text content', () => {
+        const input = assistantMsg([{ type: 'text', text: 'Hello world' }]);
+        const [result] = runFilter([input]);
+        expect(result.type).toBe('assistant');
+        expect(result.ts).toBe('2024-01-15T10:00:00Z');
+        expect(result.content).toEqual([{ t: 'text', text: 'Hello world' }]);
+    });
+    it('truncates thinking at 1000 chars with ...[truncated]', () => {
+        const longThinking = 'x'.repeat(1500);
+        const input = assistantMsg([{ type: 'thinking', thinking: longThinking }]);
+        const [result] = runFilter([input]);
+        const item = result.content[0];
+        expect(item.t).toBe('think');
+        expect(item.thinking).toHaveLength(1000 + '...[truncated]'.length);
+        expect(item.thinking.endsWith('...[truncated]')).toBe(true);
+    });
+    it('does not truncate thinking under 1000 chars', () => {
+        const shortThinking = 'y'.repeat(999);
+        const input = assistantMsg([{ type: 'thinking', thinking: shortThinking }]);
+        const [result] = runFilter([input]);
+        expect(result.content[0].thinking).toBe(shortThinking);
+    });
+    it('stringifies object tool input and truncates at 300 chars with ...', () => {
+        const bigInput = { key: 'v'.repeat(400) };
+        const input = assistantMsg([
+            { type: 'tool_use', name: 'readFile', input: bigInput },
+        ]);
+        const [result] = runFilter([input]);
+        const item = result.content[0];
+        expect(item.t).toBe('tool');
+        expect(item.name).toBe('readFile');
+        expect(item.input).toHaveLength(300 + '...'.length);
+        expect(item.input.endsWith('...')).toBe(true);
+    });
+    it('does not double-stringify string tool input (tostring gotcha)', () => {
+        // jq's `tostring` on a string is a no-op. JSON.stringify("str") would
+        // produce '"str"' with extra quotes. The script must handle this.
+        const input = assistantMsg([
+            { type: 'tool_use', name: 'bash', input: 'echo hello' },
+        ]);
+        const [result] = runFilter([input]);
+        const item = result.content[0];
+        // Should be the raw string, not '"echo hello"'
+        expect(item.input).toBe('echo hello');
+    });
+    it('passes through user string content', () => {
+        const input = userMsg('Please fix the bug');
+        const [result] = runFilter([input]);
+        expect(result.type).toBe('user');
+        expect(result.ts).toBe('2024-01-15T10:00:01Z');
+        expect(result.content).toBe('Please fix the bug');
+    });
+    it('truncates user tool_result content at 500 chars with ...[truncated]', () => {
+        const longContent = 'z'.repeat(600);
+        const input = userMsg([
+            {
+                type: 'tool_result',
+                tool_use_id: 'tool_123',
+                is_error: false,
+                content: longContent,
+            },
+        ]);
+        const [result] = runFilter([input]);
+        const item = result.content[0];
+        expect(item.t).toBe('result');
+        expect(item.id).toBe('tool_123');
+        expect(item.err).toBe(false);
+        expect(item.content).toHaveLength(500 + '...[truncated]'.length);
+        expect(item.content.endsWith('...[truncated]')).toBe(true);
+    });
+    it('does not truncate tool_result content under 500 chars', () => {
+        const input = userMsg([
+            {
+                type: 'tool_result',
+                tool_use_id: 'tool_456',
+                content: 'short result',
+            },
+        ]);
+        const [result] = runFilter([input]);
+        expect(result.content[0].content).toBe('short result');
+    });
+    it('wraps non-tool-result array items as msg with truncation at 500', () => {
+        const longText = 'w'.repeat(600);
+        const input = userMsg([{ type: 'text', text: longText }]);
+        const [result] = runFilter([input]);
+        const item = result.content[0];
+        expect(item.t).toBe('msg');
+        expect(item.text).toHaveLength(500 + '...[truncated]'.length);
+        expect(item.text.endsWith('...[truncated]')).toBe(true);
+    });
+    it('filters out non-user/non-assistant types', () => {
+        const lines = [
+            { type: 'system', timestamp: '2024-01-15T10:00:00Z', message: {} },
+            { type: 'progress', timestamp: '2024-01-15T10:00:00Z', data: {} },
+            userMsg('keep me'),
+        ];
+        const results = runFilter(lines);
+        expect(results).toHaveLength(1);
+        expect(results[0].content).toBe('keep me');
+    });
+    it('silently skips malformed JSON lines', () => {
+        const tmp = path.join(os.tmpdir(), `filter-malformed-${Date.now()}.jsonl`);
+        try {
+            const lines = [
+                JSON.stringify(userMsg('before')),
+                'not valid json {{{',
+                JSON.stringify(userMsg('after')),
+            ].join('\n');
+            fs.writeFileSync(tmp, lines);
+            const stdout = execFileSync('node', [FILTER_SCRIPT, tmp], {
+                encoding: 'utf-8',
+            });
+            const results = stdout
+                .trim()
+                .split('\n')
+                .filter(Boolean)
+                .map((l) => JSON.parse(l));
+            expect(results).toHaveLength(2);
+            expect(results[0].content).toBe('before');
+            expect(results[1].content).toBe('after');
+        }
+        finally {
+            fs.unlinkSync(tmp);
+        }
+    });
+    it('handles multiple content types in a single assistant message', () => {
+        const input = assistantMsg([
+            { type: 'text', text: 'Let me think...' },
+            { type: 'thinking', thinking: 'analyzing the problem' },
+            { type: 'tool_use', name: 'grep', input: { pattern: 'foo' } },
+        ]);
+        const [result] = runFilter([input]);
+        expect(result.content).toHaveLength(3);
+        expect(result.content[0].t).toBe('text');
+        expect(result.content[1].t).toBe('think');
+        expect(result.content[2].t).toBe('tool');
+    });
+    it('defaults is_error to false when not present in tool_result', () => {
+        const input = userMsg([
+            { type: 'tool_result', tool_use_id: 'tool_789', content: 'ok' },
+        ]);
+        const [result] = runFilter([input]);
+        expect(result.content[0].err).toBe(false);
+    });
+    it('preserves is_error=true on tool_result', () => {
+        const input = userMsg([
+            {
+                type: 'tool_result',
+                tool_use_id: 'tool_err',
+                is_error: true,
+                content: 'command failed',
+            },
+        ]);
+        const [result] = runFilter([input]);
+        expect(result.content[0].err).toBe(true);
+    });
+});
+//# sourceMappingURL=filter-session.test.js.map

package/codeyam-cli/src/__tests__/memory-scripts/filter-session.test.js.map

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

package/codeyam-cli/src/__tests__/memory-scripts/read-json-field.test.js

@@ -0,0 +1,114 @@
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+const SCRIPTS_DIR = path.resolve(__dirname, '../../../templates/skills/codeyam-memory/scripts');
+const READ_SCRIPT = path.join(SCRIPTS_DIR, 'lib/read-json-field.mjs');
+let tmpFile;
+const testData = {
+    name: 'test-project',
+    version: '1.0.0',
+    stats: {
+        total_exports: 42,
+        total_files: 7,
+    },
+    dependencies: ['react', 'typescript', 'jest'],
+    explicit_markers: [
+        { file: 'a.ts', line: 10 },
+        { file: 'b.ts', line: 20 },
+    ],
+    nested: {
+        deep: {
+            value: 'found-it',
+        },
+    },
+};
+beforeAll(() => {
+    tmpFile = path.join(os.tmpdir(), `read-json-test-${Date.now()}.json`);
+    fs.writeFileSync(tmpFile, JSON.stringify(testData));
+});
+afterAll(() => {
+    fs.unlinkSync(tmpFile);
+});
+function readField(expr) {
+    return execFileSync('node', [READ_SCRIPT, tmpFile, expr], {
+        encoding: 'utf-8',
+    }).trim();
+}
+describe('read-json-field.mjs', () => {
+    describe('simple field access', () => {
+        it('reads a top-level string field', () => {
+            expect(readField('.name')).toBe('test-project');
+        });
+        it('reads a top-level number field', () => {
+            expect(readField('.version')).toBe('1.0.0');
+        });
+        it('reads a nested field with dot path', () => {
+            expect(readField('.stats.total_exports')).toBe('42');
+        });
+        it('reads deeply nested fields', () => {
+            expect(readField('.nested.deep.value')).toBe('found-it');
+        });
+    });
+    describe('pipe expressions', () => {
+        it('gets length of an array', () => {
+            expect(readField('.dependencies | length')).toBe('3');
+        });
+        it('gets length of an object', () => {
+            expect(readField('.stats | length')).toBe('2');
+        });
+        it('gets length of a nested array', () => {
+            expect(readField('.explicit_markers | length')).toBe('2');
+        });
+    });
+    describe('the 4 SKILL.md expressions', () => {
+        // These are the exact expressions used in SKILL.md Step 2
+        it('.dependencies | length', () => {
+            expect(readField('.dependencies | length')).toBe('3');
+        });
+        it('.explicit_markers | length', () => {
+            expect(readField('.explicit_markers | length')).toBe('2');
+        });
+        it('.stats.total_exports', () => {
+            expect(readField('.stats.total_exports')).toBe('42');
+        });
+        it('.stats.total_files', () => {
+            expect(readField('.stats.total_files')).toBe('7');
+        });
+    });
+    describe('error handling', () => {
+        it('exits non-zero for missing field', () => {
+            expect(() => execFileSync('node', [READ_SCRIPT, tmpFile, '.nonexistent.deep'], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            })).toThrow();
+        });
+        it('exits non-zero for missing file', () => {
+            expect(() => execFileSync('node', [READ_SCRIPT, '/tmp/does-not-exist.json', '.foo'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] })).toThrow();
+        });
+        it('exits non-zero with no arguments', () => {
+            expect(() => execFileSync('node', [READ_SCRIPT], {
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            })).toThrow();
+        });
+    });
+    describe('output format', () => {
+        it('prints strings without JSON quotes', () => {
+            // jq prints strings without quotes by default; we match that
+            const result = readField('.name');
+            expect(result.startsWith('"')).toBe(false);
+            expect(result.endsWith('"')).toBe(false);
+        });
+        it('prints numbers as plain values', () => {
+            const result = readField('.stats.total_exports');
+            expect(result).toBe('42');
+            expect(Number(result)).toBe(42);
+        });
+        it('prints arrays as JSON', () => {
+            const result = readField('.dependencies');
+            expect(JSON.parse(result)).toEqual(['react', 'typescript', 'jest']);
+        });
+    });
+});
+//# sourceMappingURL=read-json-field.test.js.map

package/codeyam-cli/src/__tests__/memory-scripts/read-json-field.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-json-field.test.js","sourceRoot":"","sources":["../../../../../src/__tests__/memory-scripts/read-json-field.test.ts"],"names":[],"mappings":"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"}

package/codeyam-cli/src/__tests__/memory-scripts/ripgrep-fallback.test.js

@@ -0,0 +1,149 @@
+import { execFileSync } from 'child_process';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+const SCRIPTS_DIR = path.resolve(__dirname, '../../../templates/skills/codeyam-memory/scripts');
+const RG_FALLBACK = path.resolve(SCRIPTS_DIR, 'lib/ripgrep-fallback.mjs');
+let tmpDir;
+let harnessPath;
+beforeAll(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'rg-fallback-test-'));
+    // Create test source files
+    const srcDir = path.join(tmpDir, 'src');
+    fs.mkdirSync(srcDir);
+    fs.writeFileSync(path.join(srcDir, 'hello.ts'), [
+        'export function greet(name: string) {',
+        '  return `Hello, ${name}!`;',
+        '}',
+        '',
+        'export const DEFAULT_NAME = "World";',
+    ].join('\n'));
+    fs.writeFileSync(path.join(srcDir, 'math.ts'), [
+        'export function add(a: number, b: number) {',
+        '  return a + b;',
+        '}',
+    ].join('\n'));
+    // A file in node_modules that should be excluded
+    const nmDir = path.join(tmpDir, 'node_modules', 'some-pkg');
+    fs.mkdirSync(nmDir, { recursive: true });
+    fs.writeFileSync(path.join(nmDir, 'index.ts'), 'export function shouldNotMatch() {}');
+    // Harness that calls _nodeFallback directly (the pure-Node path)
+    harnessPath = path.join(tmpDir, 'harness.mjs');
+    fs.writeFileSync(harnessPath, `const { _nodeFallback } = await import(${JSON.stringify(RG_FALLBACK)});
+const result = await _nodeFallback(process.argv[2], JSON.parse(process.argv[3]));
+process.stdout.write(result);
+`);
+});
+afterAll(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+function runFallback(pattern, opts) {
+    return execFileSync('node', [harnessPath, pattern, JSON.stringify({ cwd: tmpDir, ...opts })], { encoding: 'utf-8', timeout: 10000 });
+}
+describe('ripgrep-fallback.mjs — Node fallback path', () => {
+    it('finds matching lines with file:line:text format', () => {
+        const result = runFallback('^export', { types: ['ts'] });
+        const lines = result.trim().split('\n').filter(Boolean);
+        expect(lines.length).toBeGreaterThanOrEqual(3);
+        for (const line of lines) {
+            expect(line).toMatch(/^[^:]+:\d+:.+$/);
+        }
+    });
+    it('filters by file type', () => {
+        const result = runFallback('^export', { types: ['ts'] });
+        const files = result
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((l) => l.split(':')[0]);
+        for (const f of files) {
+            expect(f).toMatch(/\.ts$/);
+        }
+    });
+    it('respects glob ignore patterns', () => {
+        const result = runFallback('export function', {
+            types: ['ts'],
+            globs: ['!node_modules'],
+        });
+        const files = result
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((l) => l.split(':')[0]);
+        for (const f of files) {
+            expect(f).not.toContain('node_modules');
+        }
+    });
+    it('returns empty string for no matches', () => {
+        const result = runFallback('xyzzy_no_match_12345', { types: ['ts'] });
+        expect(result).toBe('');
+    });
+    it('includes correct line numbers', () => {
+        const result = runFallback('DEFAULT_NAME', {
+            types: ['ts'],
+            lineNumbers: true,
+        });
+        const lines = result.trim().split('\n').filter(Boolean);
+        expect(lines).toHaveLength(1);
+        // Line 5 of hello.ts: export const DEFAULT_NAME = "World";
+        expect(lines[0]).toMatch(/hello\.ts:5:/);
+    });
+    it('excludes files matching negative glob extensions', () => {
+        // Add a .d.ts file that should be excluded
+        fs.writeFileSync(path.join(tmpDir, 'src', 'types.d.ts'), 'export type Foo = string;');
+        const result = runFallback('^export', {
+            types: ['ts'],
+            globs: ['!*.d.ts'],
+        });
+        const files = result
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map((l) => l.split(':')[0]);
+        for (const f of files) {
+            expect(f).not.toMatch(/\.d\.ts$/);
+        }
+    });
+});
+// Test the full ripgrepSearch (rg path) if rg is installed
+const rgAvailable = (() => {
+    try {
+        execFileSync('rg', ['--version'], { encoding: 'utf-8' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+})();
+(rgAvailable ? describe : describe.skip)('ripgrep-fallback.mjs — rg path (rg installed)', () => {
+    let rgHarness;
+    beforeAll(() => {
+        rgHarness = path.join(tmpDir, 'harness-rg.mjs');
+        fs.writeFileSync(rgHarness, `const { ripgrepSearch } = await import(${JSON.stringify(RG_FALLBACK)});
+const result = await ripgrepSearch(process.argv[2], JSON.parse(process.argv[3]));
+process.stdout.write(result);
+`);
+    });
+    function runRg(pattern, opts) {
+        return execFileSync('node', [rgHarness, pattern, JSON.stringify({ cwd: tmpDir, ...opts })], { encoding: 'utf-8', timeout: 10000 });
+    }
+    it('finds matching lines', () => {
+        const result = runRg('^export', { types: ['ts'] });
+        const lines = result.trim().split('\n').filter(Boolean);
+        expect(lines.length).toBeGreaterThanOrEqual(3);
+    });
+    it('returns empty string for no matches', () => {
+        const result = runRg('xyzzy_no_match_12345', { types: ['ts'] });
+        expect(result).toBe('');
+    });
+    it('completes without hanging (regression: rg must not read stdin)', () => {
+        // Without explicit '.' path arg, rg reads stdin and hangs under execFile.
+        const result = runRg('DEFAULT_NAME', {
+            types: ['ts'],
+            lineNumbers: true,
+        });
+        const lines = result.trim().split('\n').filter(Boolean);
+        expect(lines).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=ripgrep-fallback.test.js.map

package/codeyam-cli/src/__tests__/memory-scripts/ripgrep-fallback.test.js.map

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

package/codeyam-cli/src/cli.js

@@ -6,10 +6,8 @@ import { installSignalHandlers } from "../../packages/process/index.js";
 import initCommand from "./commands/init.js";
 import analyzeCommand from "./commands/analyze.js";
 import statusCommand from "./commands/status.js";
-import listCommand from "./commands/list.js";
 import entitiesCommand from "./commands/entities.js";
 import suggestCommand from "./commands/suggest.js";
-import detectUniversalMocksCommand from "./commands/detect-universal-mocks.js";
 import testStartupCommand from "./commands/test-startup.js";
 import startCommand from "./commands/start.js";
 import stopCommand from "./commands/stop.js";
@@ -23,10 +21,17 @@ import reportCommand from "./commands/report.js";
 import debugCommand from "./commands/debug.js";
 import recaptureCommand from "./commands/recapture.js";
 import setupSandboxCommand from "./commands/setup-sandbox.js";
-import webappInfoCommand from "./commands/webapp-info.js";
 import wipeCommand from "./commands/wipe.js";
 import baselineCommand from "./commands/baseline.js";
+import memoryCommand from "./commands/memory.js";
+import editorCommand from "./commands/editor.js";
+import setupSimulationsCommand from "./commands/setup-simulations.js";
 import { syncMocksMiddleware } from "./utils/syncMocksMiddleware.js";
+import { telemetryMiddleware } from "./utils/telemetryMiddleware.js";
+import { captureEvent } from "./utils/telemetry.js";
+import { getDisplayVersion } from "./utils/versionInfo.js";
+import { simulationGateMiddleware, buildSimulationEpilogue, } from "./utils/simulationGateMiddleware.js";
+import telemetryCommand from "./commands/telemetry.js";
 // Install global signal handlers for automatic process cleanup
 // This ensures all child processes (analyzer, capture, etc.) are cleaned up on:
 // - Ctrl+C (SIGINT)
@@ -35,41 +40,56 @@ import { syncMocksMiddleware } from "./utils/syncMocksMiddleware.js";
 // - Unhandled promise rejections
 // - Normal process exit
 installSignalHandlers();
+// Hide simulation commands from the default "Commands:" section
+// They'll appear in the epilogue under "Simulation Commands:"
+function withoutDescribe(cmd) {
+    return { ...cmd, describe: false };
+}
 // Set up the CLI with yargs
 yargs(hideBin(process.argv))
     .scriptName('codeyam')
-    .version('0.1.0')
+    .version(getDisplayVersion())
     .usage('CodeYam local development CLI')
+    .middleware(simulationGateMiddleware)
     .middleware(syncMocksMiddleware)
+    .middleware(telemetryMiddleware)
+    // Core commands (always visible in help)
     .command(defaultCommand)
-    .command(initCommand)
-    .command(analyzeCommand)
-    .command(queueCommand)
-    .command(statusCommand)
-    .command(listCommand)
-    .command(entitiesCommand)
-    .command(suggestCommand)
-    .command(detectUniversalMocksCommand)
-    .command(testStartupCommand)
     .command(startCommand)
     .command(stopCommand)
-    .command(updateConfigCommand)
-    .command(verifyCommand)
-    .command(generateMocksCommand)
-    .command(validateMockCommand)
-    .command(debugCommand)
-    .command(recaptureCommand)
-    .command(setupSandboxCommand)
-    .command(webappInfoCommand)
-    .command(reportCommand)
-    .command(wipeCommand)
-    .command(baselineCommand)
+    .command(memoryCommand)
+    .command(telemetryCommand)
+    // Hidden commands (shown in epilogue when simulations are enabled)
+    .command(withoutDescribe(initCommand))
+    .command(withoutDescribe(updateConfigCommand))
+    .command(withoutDescribe(setupSimulationsCommand))
+    .command(withoutDescribe(analyzeCommand))
+    .command(withoutDescribe(verifyCommand))
+    .command(withoutDescribe(testStartupCommand))
+    .command(withoutDescribe(setupSandboxCommand))
+    .command(withoutDescribe(recaptureCommand))
+    .command(withoutDescribe(baselineCommand))
+    .command(withoutDescribe(debugCommand))
+    .command(withoutDescribe(generateMocksCommand))
+    .command(withoutDescribe(suggestCommand))
+    .command(withoutDescribe(statusCommand))
+    .command(withoutDescribe(entitiesCommand))
+    .command(withoutDescribe(queueCommand))
+    .command(withoutDescribe(validateMockCommand))
+    .command(withoutDescribe(reportCommand))
+    .command(withoutDescribe(wipeCommand))
+    .command(withoutDescribe(editorCommand))
+    .epilogue(buildSimulationEpilogue())
     .demandCommand(1)
     .help()
     .alias('help', 'h')
     .strict()
     .parseAsync()
     .catch((error) => {
+    captureEvent('cli_error', {
+        command: process.argv[2] ?? 'unknown',
+        error_type: error?.constructor?.name ?? 'Error',
+    });
     console.error('CLI Error:', error.message);
     process.exit(1);
 });

package/codeyam-cli/src/cli.js.map

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

package/codeyam-cli/src/codeyam-cli.js

@@ -1,4 +1,20 @@
 #!/usr/bin/env node --no-warnings
-// Main CLI entry point - simply exports from cli.ts
-export * from "./cli.js";
+// Version check MUST run before any dependency imports.
+// Using dynamic import() so this code executes before the module tree loads.
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 20) {
+    console.error('');
+    console.error(`  CodeYam requires Node.js >= 20.0.0`);
+    console.error(`  You are running Node.js ${process.version}`);
+    console.error('');
+    console.error('  Please upgrade: https://nodejs.org/');
+    console.error('');
+    process.exit(1);
+}
+import('./cli.js').catch((err) => {
+    console.error('');
+    console.error('  CodeYam failed to start:', err.message);
+    console.error('');
+    process.exit(1);
+});
 //# sourceMappingURL=codeyam-cli.js.map