@codeyam/codeyam-cli 0.1.0-staging.a890816 → 0.1.0-staging.ae0de75

package/codeyam-cli/src/utils/__tests__/git.editor.test.js

@@ -0,0 +1,134 @@
+import { validateCommitSha, verifyCommitExists, gitStash, gitCheckout, } from "../git.js";
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+describe('git editor utilities', () => {
+    describe('validateCommitSha', () => {
+        it('should accept a valid 7-char short SHA', () => {
+            expect(validateCommitSha('abc1234')).toBe(true);
+        });
+        it('should accept a valid 40-char full SHA', () => {
+            expect(validateCommitSha('abc1234567890def1234567890abc123456789de')).toBe(true);
+        });
+        it('should accept uppercase hex chars', () => {
+            expect(validateCommitSha('ABC1234DEF')).toBe(true);
+        });
+        it('should reject too-short SHAs (< 7 chars)', () => {
+            expect(validateCommitSha('abc12')).toBe(false);
+        });
+        it('should reject too-long SHAs (> 40 chars)', () => {
+            expect(validateCommitSha('a'.repeat(41))).toBe(false);
+        });
+        it('should reject non-hex characters', () => {
+            expect(validateCommitSha('abcdefg')).toBe(false);
+        });
+        it('should reject empty string', () => {
+            expect(validateCommitSha('')).toBe(false);
+        });
+        it('should reject command injection attempts', () => {
+            expect(validateCommitSha('abc1234; rm -rf /')).toBe(false);
+        });
+    });
+    describe('verifyCommitExists', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'git-test-'));
+            execSync('git init', { cwd: tempDir, stdio: 'pipe' });
+            execSync('git config user.email "test@test.com"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+            execSync('git config user.name "Test"', { cwd: tempDir, stdio: 'pipe' });
+            fs.writeFileSync(path.join(tempDir, 'file.txt'), 'hello');
+            execSync('git add -A && git commit -m "initial"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+        });
+        afterEach(() => {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        });
+        it('should return true for an existing commit', () => {
+            const sha = execSync('git rev-parse HEAD', {
+                cwd: tempDir,
+                encoding: 'utf8',
+            }).trim();
+            expect(verifyCommitExists(tempDir, sha)).toBe(true);
+        });
+        it('should return false for a non-existent commit', () => {
+            expect(verifyCommitExists(tempDir, 'deadbeefdeadbeef')).toBe(false);
+        });
+    });
+    describe('gitStash', () => {
+        let tempDir;
+        beforeEach(() => {
+            tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'git-stash-test-'));
+            execSync('git init', { cwd: tempDir, stdio: 'pipe' });
+            execSync('git config user.email "test@test.com"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+            execSync('git config user.name "Test"', { cwd: tempDir, stdio: 'pipe' });
+            fs.writeFileSync(path.join(tempDir, 'file.txt'), 'hello');
+            execSync('git add -A && git commit -m "initial"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+        });
+        afterEach(() => {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        });
+        it('should stash uncommitted changes', () => {
+            fs.writeFileSync(path.join(tempDir, 'file.txt'), 'modified');
+            const result = gitStash(tempDir, 'test stash');
+            expect(result.stashed).toBe(true);
+            // File should be restored to committed state
+            const content = fs.readFileSync(path.join(tempDir, 'file.txt'), 'utf8');
+            expect(content).toBe('hello');
+        });
+        it('should return stashed=false when nothing to stash', () => {
+            const result = gitStash(tempDir, 'test stash');
+            expect(result.stashed).toBe(false);
+        });
+    });
+    describe('gitCheckout', () => {
+        let tempDir;
+        let firstSha;
+        beforeEach(() => {
+            tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'git-checkout-test-'));
+            execSync('git init', { cwd: tempDir, stdio: 'pipe' });
+            execSync('git config user.email "test@test.com"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+            execSync('git config user.name "Test"', { cwd: tempDir, stdio: 'pipe' });
+            fs.writeFileSync(path.join(tempDir, 'file.txt'), 'v1');
+            execSync('git add -A && git commit -m "first"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+            firstSha = execSync('git rev-parse HEAD', {
+                cwd: tempDir,
+                encoding: 'utf8',
+            }).trim();
+            fs.writeFileSync(path.join(tempDir, 'file.txt'), 'v2');
+            execSync('git add -A && git commit -m "second"', {
+                cwd: tempDir,
+                stdio: 'pipe',
+            });
+        });
+        afterEach(() => {
+            fs.rmSync(tempDir, { recursive: true, force: true });
+        });
+        it('should checkout a specific commit', () => {
+            gitCheckout(tempDir, firstSha);
+            const content = fs.readFileSync(path.join(tempDir, 'file.txt'), 'utf8');
+            expect(content).toBe('v1');
+        });
+        it('should throw on invalid ref', () => {
+            expect(() => gitCheckout(tempDir, 'nonexistent_ref')).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=git.editor.test.js.map

package/codeyam-cli/src/utils/__tests__/git.editor.test.js.map

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

package/codeyam-cli/src/utils/__tests__/project.test.js

@@ -0,0 +1,65 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { findProjectRoot, isForbiddenProjectRoot } from "../project.js";
+describe('isForbiddenProjectRoot', () => {
+    it('returns true for the home directory', () => {
+        expect(isForbiddenProjectRoot(os.homedir())).toBe(true);
+    });
+    it('returns true for the filesystem root', () => {
+        expect(isForbiddenProjectRoot('/')).toBe(true);
+    });
+    it('returns true for home dir with trailing slash', () => {
+        expect(isForbiddenProjectRoot(os.homedir() + '/')).toBe(true);
+    });
+    it('returns false for a normal project directory', () => {
+        expect(isForbiddenProjectRoot(path.join(os.homedir(), 'projects', 'my-app'))).toBe(false);
+    });
+    it('returns false for a directory just inside home', () => {
+        expect(isForbiddenProjectRoot(path.join(os.homedir(), 'my-project'))).toBe(false);
+    });
+});
+describe('findProjectRoot', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codeyam-test-'));
+    });
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    it('finds a project in the start directory', () => {
+        const codeyamDir = path.join(tempDir, '.codeyam');
+        fs.mkdirSync(codeyamDir);
+        fs.writeFileSync(path.join(codeyamDir, 'config.json'), JSON.stringify({ projectSlug: 'test' }));
+        expect(findProjectRoot(tempDir)).toBe(tempDir);
+    });
+    it('finds a project in a parent directory', () => {
+        const codeyamDir = path.join(tempDir, '.codeyam');
+        fs.mkdirSync(codeyamDir);
+        fs.writeFileSync(path.join(codeyamDir, 'config.json'), JSON.stringify({ projectSlug: 'test' }));
+        const subDir = path.join(tempDir, 'src', 'components');
+        fs.mkdirSync(subDir, { recursive: true });
+        expect(findProjectRoot(subDir)).toBe(tempDir);
+    });
+    it('returns null when no project is found', () => {
+        const subDir = path.join(tempDir, 'src');
+        fs.mkdirSync(subDir, { recursive: true });
+        expect(findProjectRoot(subDir)).toBeNull();
+    });
+    it('does not return the home directory as a project root', () => {
+        // Even if ~/.codeyam/config.json exists, findProjectRoot should skip it.
+        // We can't create files in the real home dir in a test, but we can verify
+        // the guard logic by checking that findProjectRoot stops at home.
+        // Start from a subdirectory of home with no .codeyam anywhere —
+        // it should return null without ever checking ~.
+        const subDir = path.join(os.homedir(), 'nonexistent-codeyam-test-dir');
+        // Don't create it — findProjectRoot uses existsSync on config.json, not the dir
+        expect(findProjectRoot(subDir)).toBeNull();
+    });
+    it('does not return the filesystem root as a project root', () => {
+        // Starting from /tmp/something with no .codeyam, should return null
+        // (and not check / for .codeyam/config.json)
+        expect(findProjectRoot(tempDir)).toBeNull();
+    });
+});
+//# sourceMappingURL=project.test.js.map

package/codeyam-cli/src/utils/__tests__/project.test.js.map

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

package/codeyam-cli/src/utils/__tests__/scenarioMarkers.test.js

@@ -0,0 +1,121 @@
+import { transformScenarioMarkers, createMarkerTransformer, } from "../scenarioMarkers.js";
+const PORT = '3111';
+describe('scenarioMarkers', () => {
+    describe('transformScenarioMarkers', () => {
+        it('should transform a simple marker into an OSC 8 hyperlink', () => {
+            const input = '{{scenario:Default:abc-123}}';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).toContain('\x1b]8;;');
+            expect(result).toContain('http://localhost:3111/editor?scenario=abc-123&ref=link');
+            expect(result).toContain('Default');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should transform a marker with spaces in the name', () => {
+            const input = '{{scenario:Long Name:abc-123}}';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).toContain('Long Name');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should transform multiple markers in one string', () => {
+            const input = '| DrinkCard | {{scenario:Default:id1}} |\n| | {{scenario:Dark Mode:id2}} |';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).not.toContain('{{scenario:');
+            expect(result).toContain('Default');
+            expect(result).toContain('Dark Mode');
+        });
+        it('should return input unchanged when no markers present', () => {
+            const input = 'Hello world, no markers here';
+            expect(transformScenarioMarkers(input, PORT)).toBe(input);
+        });
+        it('should handle markers with ANSI escape codes interleaved', () => {
+            // Claude Code's renderer inserts ANSI styling within marker text
+            const input = '\x1b[33m{{scenario:\x1b[1mDefault\x1b[22m:\x1b[0mabc-123\x1b[33m}}\x1b[0m';
+            const result = transformScenarioMarkers(input, PORT);
+            expect(result).toContain('Default');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should pad the replacement to maintain table alignment', () => {
+            const input = '{{scenario:Tea:abc-123}}';
+            const result = transformScenarioMarkers(input, PORT);
+            // The original marker is 24 chars visible, "Tea" is 3 chars → 21 spaces of padding
+            const linkEnd = '\x1b]8;;\x07';
+            const afterLink = result.slice(result.lastIndexOf(linkEnd) + linkEnd.length);
+            // Should have padding spaces
+            expect(afterLink.length).toBeGreaterThan(0);
+        });
+    });
+    describe('createMarkerTransformer (cross-chunk buffering)', () => {
+        it('should handle a marker split across two chunks', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('before {{scenario:Def');
+            const out2 = transform('ault:abc-123}} after');
+            const combined = out1 + out2;
+            expect(combined).toContain('Default');
+            expect(combined).not.toContain('{{scenario:');
+            expect(combined).toContain('before');
+            expect(combined).toContain('after');
+        });
+        it('should handle a marker split across three chunks', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('│ {{scenario:');
+            const out2 = transform('Long Name:');
+            const out3 = transform('abc-123}} │');
+            const combined = out1 + out2 + out3;
+            expect(combined).toContain('Long Name');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should handle complete markers in a single chunk', () => {
+            const transform = createMarkerTransformer(PORT);
+            const result = transform('│ {{scenario:Default:abc-123}} │');
+            expect(result).toContain('Default');
+            expect(result).not.toContain('{{scenario:');
+        });
+        it('should handle multiple complete markers in a single chunk', () => {
+            const transform = createMarkerTransformer(PORT);
+            const result = transform('{{scenario:A:id1}} and {{scenario:B:id2}}');
+            expect(result).not.toContain('{{scenario:');
+            expect(result).toContain('A');
+            expect(result).toContain('B');
+        });
+        it('should discard stale buffer on carriage return (Ink line rewrite)', () => {
+            const transform = createMarkerTransformer(PORT);
+            // Ink renders partial: "│ {{scenario:Lo"
+            const out1 = transform('│ {{scenario:Lo');
+            // Ink rewrites the line with more content
+            const out2 = transform('\r\x1b[K│ {{scenario:Long Na');
+            // Ink completes the line
+            const out3 = transform('me:abc-123}} │\n');
+            const combined = out1 + out2 + out3;
+            // The final output should have the transformed marker, not the raw one
+            expect(combined).toContain('Long Name');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should handle carriage return mid-buffer without losing the new marker', () => {
+            const transform = createMarkerTransformer(PORT);
+            // Buffer has partial marker, then line gets rewritten with a complete marker
+            const out1 = transform('{{scenario:Te');
+            const out2 = transform('\r\x1b[K{{scenario:Tea:id1}} │');
+            const combined = out1 + out2;
+            expect(combined).toContain('Tea');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should handle ANSI codes within a split marker', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('\x1b[33m{{scenario:\x1b[1mDef');
+            const out2 = transform('ault\x1b[22m:abc-123\x1b[0m}}');
+            const combined = out1 + out2;
+            expect(combined).toContain('Default');
+            expect(combined).not.toContain('{{scenario:');
+        });
+        it('should flush stale partial on carriage return even without \\x1b[K', () => {
+            const transform = createMarkerTransformer(PORT);
+            const out1 = transform('│ {{scenario:Partia');
+            // Just \r, no erase sequence — Ink sometimes does this
+            const out2 = transform('\r│ {{scenario:Full Name:id1}} │');
+            const combined = out1 + out2;
+            expect(combined).toContain('Full Name');
+            expect(combined).not.toContain('{{scenario:');
+        });
+    });
+});
+//# sourceMappingURL=scenarioMarkers.test.js.map

package/codeyam-cli/src/utils/__tests__/scenarioMarkers.test.js.map

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

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

@@ -0,0 +1,4 @@
+export const IS_INTERNAL_BUILD = typeof false !== 'undefined'
+    ? false
+    : false;
+//# sourceMappingURL=buildFlags.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"buildFlags.js","sourceRoot":"","sources":["../../../../src/utils/buildFlags.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,OAAO,0BAA0B,KAAK,WAAW;IAC/C,CAAC,CAAC,0BAA0B;IAC5B,CAAC,CAAC,KAAK,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * Pure logic for `codeyam editor audit` — zero I/O, fully testable.
+ *
+ * Cross-references glossary entries against registered scenarios (components)
+ * and test files (functions) to detect gaps Claude may have missed.
+ */
+// ─── Logic ───────────────────────────────────────────────────────────
+const COMPONENT_RETURN_PATTERNS = ['JSX', 'React', 'Element', 'ReactNode'];
+/**
+ * Returns true when the entry's returnType indicates a React component
+ * (contains "JSX", "React", "Element", or "ReactNode").
+ */
+export function isComponent(entry) {
+    if (!entry.returnType)
+        return false;
+    return COMPONENT_RETURN_PATTERNS.some((pat) => entry.returnType.includes(pat));
+}
+/**
+ * Split glossary entries into components (JSX-returning) and functions (everything else).
+ */
+export function classifyGlossaryEntries(entries) {
+    const components = [];
+    const functions = [];
+    for (const entry of entries) {
+        if (isComponent(entry)) {
+            components.push(entry);
+        }
+        else {
+            functions.push(entry);
+        }
+    }
+    return { components, functions };
+}
+/**
+ * Given classified entries and coverage data, produce a structured audit result.
+ *
+ * @param components  - Glossary entries classified as components
+ * @param functions   - Glossary entries classified as functions
+ * @param scenarioCounts - Map of component_name → number of registered scenarios
+ * @param testFileExistence - Map of testFile path → whether the file exists on disk
+ */
+export function computeAudit({ components, functions, scenarioCounts, testFileExistence, }) {
+    const componentResults = components.map((c) => {
+        const count = scenarioCounts[c.name] || 0;
+        return {
+            name: c.name,
+            filePath: c.filePath,
+            scenarioCount: count,
+            status: count > 0 ? 'ok' : 'missing',
+        };
+    });
+    const functionResults = functions.map((f) => {
+        const exists = f.testFile
+            ? (testFileExistence[f.testFile] ?? false)
+            : false;
+        return {
+            name: f.name,
+            filePath: f.filePath,
+            testFile: f.testFile,
+            testFileExists: exists,
+            status: exists ? 'ok' : 'missing',
+        };
+    });
+    const componentsOk = componentResults.filter((c) => c.status === 'ok').length;
+    const componentsMissing = componentResults.length - componentsOk;
+    const functionsOk = functionResults.filter((f) => f.status === 'ok').length;
+    const functionsMissing = functionResults.length - functionsOk;
+    return {
+        components: componentResults,
+        functions: functionResults,
+        summary: {
+            totalComponents: componentResults.length,
+            componentsOk,
+            componentsMissing,
+            totalFunctions: functionResults.length,
+            functionsOk,
+            functionsMissing,
+            allPassing: componentsMissing === 0 && functionsMissing === 0,
+        },
+    };
+}
+//# sourceMappingURL=editorAudit.js.map

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

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

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

@@ -0,0 +1,98 @@
+/**
+ * Dev server process management utilities for the editor.
+ *
+ * Extracted from inline logic in api.editor-dev-server.ts.
+ */
+import fs from 'fs';
+import path from 'path';
+/**
+ * Detect the package manager and start script for a project.
+ *
+ * Returns `{ command, args }` on success, or `{ error }` if the project
+ * lacks a runnable dev/start script or package.json.
+ */
+export function detectPackageManagerAndScript(projectRoot) {
+    const packageJsonPath = path.join(projectRoot, 'package.json');
+    if (!fs.existsSync(packageJsonPath)) {
+        return { error: 'No package.json found.' };
+    }
+    let command = 'npm';
+    let args = ['run', 'dev'];
+    try {
+        const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+        // Detect package manager from lockfile
+        if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) {
+            command = 'pnpm';
+        }
+        else if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) {
+            command = 'yarn';
+        }
+        else if (fs.existsSync(path.join(projectRoot, 'bun.lockb'))) {
+            command = 'bun';
+        }
+        // Check for dev or start script
+        if (!pkg.scripts?.dev) {
+            if (pkg.scripts?.start) {
+                args = ['run', 'start'];
+            }
+            else {
+                return { error: 'No "dev" or "start" script found in package.json.' };
+            }
+        }
+    }
+    catch {
+        // Use defaults (npm run dev)
+    }
+    return { command, args };
+}
+/** URL patterns matched in dev server output to detect the running URL. */
+const URL_PATTERNS = [
+    /Local:\s+(https?:\/\/[^\s]+)/, // Vite
+    /Ready on\s+(https?:\/\/[^\s]+)/i, // Next.js
+    /started at\s+(https?:\/\/[^\s]+)/i, // Remix
+    /listening on\s+(https?:\/\/[^\s]+)/i, // Generic
+    /http:\/\/localhost:\d+/, // Bare URL
+];
+/**
+ * Extract a dev server URL from process output text.
+ * Matches common patterns from Vite, Next.js, Remix, and generic servers.
+ * Strips ANSI codes from the result.
+ * Returns null if no URL is found.
+ */
+export function extractDevServerUrl(text) {
+    for (const pattern of URL_PATTERNS) {
+        const match = text.match(pattern);
+        if (match) {
+            const url = match[1] || match[0];
+            return stripAnsiCodes(url).trim();
+        }
+    }
+    return null;
+}
+/**
+ * Remove ANSI escape sequences from text.
+ */
+export function stripAnsiCodes(text) {
+    return text.replace(/\x1b\[[0-9;]*m/g, '');
+}
+/**
+ * Determine what action to take when the dev server process exits.
+ *
+ * - Quick failure (< 10s) on first attempt → retry
+ * - Non-zero exit after retry or after long uptime → error
+ * - Zero or null exit → stopped normally
+ */
+export function determineProcessExitState(params) {
+    const { exitCode, uptime, retryCount } = params;
+    const quickFailure = uptime < 10000;
+    if (exitCode !== 0 && exitCode !== null && quickFailure && retryCount === 0) {
+        return { action: 'retry' };
+    }
+    else if (exitCode !== 0 && exitCode !== null) {
+        return { action: 'error' };
+    }
+    else {
+        return { action: 'stopped' };
+    }
+}
+//# sourceMappingURL=editorDevServer.js.map

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

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