@codeyam/codeyam-cli 0.1.0-staging.a77070e → 0.1.0-staging.aa28063

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

@@ -0,0 +1,125 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { readEnvVar, writeEnvVar, parseGitHubRepo } from "../envFile.js";
+let tmpDir;
+beforeEach(() => {
+    tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'envfile-test-'));
+});
+afterEach(() => {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+});
+// ── readEnvVar ────────────────────────────────────────────────────────
+describe('readEnvVar', () => {
+    it('reads a simple key=value from .env.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'VERCEL_TOKEN=tok_abc123\n');
+        expect(readEnvVar(tmpDir, 'VERCEL_TOKEN')).toBe('tok_abc123');
+    });
+    it('reads from .env when .env.local does not exist', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env'), 'MY_KEY=from_env\n');
+        expect(readEnvVar(tmpDir, 'MY_KEY')).toBe('from_env');
+    });
+    it('prefers .env.local over .env', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY=local\n');
+        fs.writeFileSync(path.join(tmpDir, '.env'), 'KEY=base\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('local');
+    });
+    it('strips double quotes from values', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY="quoted_val"\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('quoted_val');
+    });
+    it('strips single quotes from values', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), "KEY='single'\n");
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('single');
+    });
+    it('skips comments', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), '# This is a comment\nKEY=val\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('val');
+    });
+    it('skips blank lines', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), '\n\nKEY=val\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('val');
+    });
+    it('returns null when key is not found', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'OTHER=val\n');
+        expect(readEnvVar(tmpDir, 'MISSING')).toBeNull();
+    });
+    it('returns null when no env files exist', () => {
+        expect(readEnvVar(tmpDir, 'KEY')).toBeNull();
+    });
+    it('returns null for empty values', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY=\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBeNull();
+    });
+    it('handles values with equals signs', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'DATABASE_URL=postgres://user:pass@host/db?ssl=true\n');
+        expect(readEnvVar(tmpDir, 'DATABASE_URL')).toBe('postgres://user:pass@host/db?ssl=true');
+    });
+    it('reads from .env.development.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.development.local'), 'KEY=dev_local\n');
+        expect(readEnvVar(tmpDir, 'KEY')).toBe('dev_local');
+    });
+});
+// ── writeEnvVar ───────────────────────────────────────────────────────
+describe('writeEnvVar', () => {
+    it('creates .env.local if it does not exist', () => {
+        writeEnvVar(tmpDir, 'NEW_KEY', 'new_value');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('NEW_KEY=new_value');
+    });
+    it('appends to existing .env.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'EXISTING=val\n');
+        writeEnvVar(tmpDir, 'NEW_KEY', 'new_val');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('EXISTING=val');
+        expect(content).toContain('NEW_KEY=new_val');
+    });
+    it('updates existing key in .env.local', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), 'KEY=old_val\n');
+        writeEnvVar(tmpDir, 'KEY', 'new_val');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('KEY=new_val');
+        expect(content).not.toContain('old_val');
+    });
+    it('does not modify comments when updating', () => {
+        fs.writeFileSync(path.join(tmpDir, '.env.local'), '# Comment\nKEY=old\n');
+        writeEnvVar(tmpDir, 'KEY', 'new');
+        const content = fs.readFileSync(path.join(tmpDir, '.env.local'), 'utf-8');
+        expect(content).toContain('# Comment');
+        expect(content).toContain('KEY=new');
+    });
+    it('roundtrips with readEnvVar', () => {
+        writeEnvVar(tmpDir, 'TOKEN', 'secret_123');
+        expect(readEnvVar(tmpDir, 'TOKEN')).toBe('secret_123');
+    });
+});
+// ── parseGitHubRepo ───────────────────────────────────────────────────
+describe('parseGitHubRepo', () => {
+    it('parses HTTPS URL', () => {
+        const result = parseGitHubRepo('https://github.com/codeyam-ai/codeyam.git');
+        expect(result).toEqual({ owner: 'codeyam-ai', repo: 'codeyam' });
+    });
+    it('parses HTTPS URL without .git', () => {
+        const result = parseGitHubRepo('https://github.com/jaredcosulich/testapp');
+        expect(result).toEqual({ owner: 'jaredcosulich', repo: 'testapp' });
+    });
+    it('parses SSH URL', () => {
+        const result = parseGitHubRepo('git@github.com:codeyam-ai/codeyam.git');
+        expect(result).toEqual({ owner: 'codeyam-ai', repo: 'codeyam' });
+    });
+    it('parses SSH URL without .git', () => {
+        const result = parseGitHubRepo('git@github.com:owner/repo');
+        expect(result).toEqual({ owner: 'owner', repo: 'repo' });
+    });
+    it('returns null for non-GitHub URLs', () => {
+        expect(parseGitHubRepo('https://gitlab.com/owner/repo.git')).toBeNull();
+    });
+    it('returns null for invalid URLs', () => {
+        expect(parseGitHubRepo('not-a-url')).toBeNull();
+    });
+    it('handles repos with hyphens and underscores', () => {
+        const result = parseGitHubRepo('https://github.com/my-org/my_project-name.git');
+        expect(result).toEqual({ owner: 'my-org', repo: 'my_project-name' });
+    });
+});
+//# sourceMappingURL=envFile.test.js.map

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

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

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

@@ -0,0 +1,500 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { execSync } from 'child_process';
+import { captureStepSnapshot, updateHandoffProgress, generateHandoffContext, formatHandoffContextAsMarkdown, } from "../handoffContext.js";
+jest.mock('child_process', () => ({
+    execSync: jest.fn(),
+}));
+const mockedExecSync = execSync;
+function createTempDir() {
+    return fs.mkdtempSync(path.join(os.tmpdir(), 'handoff-test-'));
+}
+function setupCodeyamDir(root) {
+    const codeyamDir = path.join(root, '.codeyam');
+    fs.mkdirSync(codeyamDir, { recursive: true });
+    return codeyamDir;
+}
+describe('captureStepSnapshot', () => {
+    let root;
+    beforeEach(() => {
+        root = createTempDir();
+        setupCodeyamDir(root);
+        mockedExecSync.mockReturnValue('');
+    });
+    afterEach(() => {
+        fs.rmSync(root, { recursive: true, force: true });
+        jest.restoreAllMocks();
+    });
+    it('returns correct structure with all zero counts for an empty project', () => {
+        const snapshot = captureStepSnapshot(root, 3);
+        expect(snapshot.step).toBe(3);
+        expect(snapshot.label).toBe('Prototype');
+        expect(snapshot.scenarioCount).toBe(0);
+        expect(snapshot.glossaryComponentCount).toBe(0);
+        expect(snapshot.glossaryFunctionCount).toBe(0);
+        expect(snapshot.uncommittedFileCount).toBe(0);
+        expect(snapshot.journalEntryCount).toBe(0);
+        expect(typeof snapshot.timestamp).toBe('string');
+    });
+    it('returns correct step label from STEP_LABELS', () => {
+        expect(captureStepSnapshot(root, 1).label).toBe('Plan');
+        expect(captureStepSnapshot(root, 8).label).toBe('Glossary');
+        expect(captureStepSnapshot(root, 18).label).toBe('Push');
+    });
+    it('returns "Unknown" label for invalid step numbers', () => {
+        expect(captureStepSnapshot(root, 99).label).toBe('Unknown');
+    });
+    it('counts glossary components vs functions correctly', () => {
+        const glossaryPath = path.join(root, '.codeyam', 'glossary.json');
+        const glossary = [
+            { name: 'TaskCard', filePath: 'app/components/TaskCard.tsx' },
+            { name: 'EmptyState', filePath: 'app/components/EmptyState.tsx' },
+            {
+                name: 'formatDate',
+                filePath: 'app/lib/utils.ts',
+                testFile: 'app/lib/__tests__/utils.test.ts',
+            },
+            {
+                name: 'sortTasks',
+                filePath: 'app/lib/tasks.ts',
+                testFile: 'app/lib/__tests__/tasks.test.ts',
+            },
+            {
+                name: 'filterTasks',
+                filePath: 'app/lib/tasks.ts',
+                testFile: 'app/lib/__tests__/tasks.test.ts',
+            },
+        ];
+        fs.writeFileSync(glossaryPath, JSON.stringify(glossary));
+        const snapshot = captureStepSnapshot(root, 7);
+        expect(snapshot.glossaryComponentCount).toBe(2);
+        expect(snapshot.glossaryFunctionCount).toBe(3);
+    });
+    it('handles malformed glossary.json gracefully', () => {
+        const glossaryPath = path.join(root, '.codeyam', 'glossary.json');
+        fs.writeFileSync(glossaryPath, 'not valid json');
+        const snapshot = captureStepSnapshot(root, 7);
+        expect(snapshot.glossaryComponentCount).toBe(0);
+        expect(snapshot.glossaryFunctionCount).toBe(0);
+    });
+    it('handles object-wrapped glossary format', () => {
+        const glossaryPath = path.join(root, '.codeyam', 'glossary.json');
+        // LLMs sometimes write glossary as { components: [...] } instead of an array
+        const glossary = {
+            components: [
+                { name: 'TaskCard', filePath: 'app/components/TaskCard.tsx' },
+            ],
+        };
+        fs.writeFileSync(glossaryPath, JSON.stringify(glossary));
+        const snapshot = captureStepSnapshot(root, 7);
+        // Should handle gracefully — either extract the array or return 0
+        expect(snapshot.glossaryComponentCount).toBe(0);
+        expect(snapshot.glossaryFunctionCount).toBe(0);
+    });
+    it('counts scenario files from editor-scenarios directory', () => {
+        const scenariosDir = path.join(root, '.codeyam', 'editor-scenarios');
+        fs.mkdirSync(scenariosDir, { recursive: true });
+        fs.writeFileSync(path.join(scenariosDir, 'abc123.json'), JSON.stringify({ name: 'Default' }));
+        fs.writeFileSync(path.join(scenariosDir, 'def456.json'), JSON.stringify({ name: 'Empty' }));
+        fs.writeFileSync(path.join(scenariosDir, 'ghi789.json'), JSON.stringify({ name: 'Rich' }));
+        // seed files should not be counted
+        fs.writeFileSync(path.join(scenariosDir, 'abc123.seed.json'), JSON.stringify({}));
+        const snapshot = captureStepSnapshot(root, 10);
+        expect(snapshot.scenarioCount).toBe(3);
+    });
+    it('counts uncommitted files from git status, excluding .codeyam/', () => {
+        mockedExecSync.mockReturnValue([
+            ' M app/components/TaskCard.tsx',
+            '?? app/components/NewComponent.tsx',
+            ' M .codeyam/config.json',
+            ' M .codeyam/glossary.json',
+            'A  app/lib/utils.ts',
+        ].join('\n'));
+        const snapshot = captureStepSnapshot(root, 7);
+        // Should exclude the 2 .codeyam/ files
+        expect(snapshot.uncommittedFileCount).toBe(3);
+    });
+    it('handles git status failure gracefully', () => {
+        mockedExecSync.mockImplementation(() => {
+            throw new Error('Not a git repository');
+        });
+        const snapshot = captureStepSnapshot(root, 7);
+        expect(snapshot.uncommittedFileCount).toBe(0);
+    });
+    it('counts journal entries from journal directory', () => {
+        const journalDir = path.join(root, '.codeyam', 'journal');
+        fs.mkdirSync(journalDir, { recursive: true });
+        fs.writeFileSync(path.join(journalDir, 'entry-001.json'), JSON.stringify({ title: 'Initial setup' }));
+        fs.writeFileSync(path.join(journalDir, 'entry-002.json'), JSON.stringify({ title: 'Added components' }));
+        // Non-json files should not be counted
+        fs.writeFileSync(path.join(journalDir, 'index.md'), '# Journal');
+        const snapshot = captureStepSnapshot(root, 13);
+        expect(snapshot.journalEntryCount).toBe(2);
+    });
+    it('returns a valid ISO timestamp', () => {
+        const snapshot = captureStepSnapshot(root, 1);
+        const parsed = new Date(snapshot.timestamp);
+        expect(parsed.toISOString()).toBe(snapshot.timestamp);
+    });
+});
+describe('updateHandoffProgress', () => {
+    let root;
+    beforeEach(() => {
+        root = createTempDir();
+        setupCodeyamDir(root);
+        mockedExecSync.mockReturnValue('');
+    });
+    afterEach(() => {
+        fs.rmSync(root, { recursive: true, force: true });
+        jest.restoreAllMocks();
+    });
+    it('creates handoff object in config if it does not exist', () => {
+        const configPath = path.join(root, '.codeyam', 'config.json');
+        fs.writeFileSync(configPath, JSON.stringify({ provider: 'claude', projectSlug: 'test' }));
+        updateHandoffProgress(root, 3);
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        expect(config.handoff).toBeDefined();
+        expect(config.handoff.lastStep).toBe(3);
+        expect(config.handoff.lastProvider).toBe('claude');
+        expect(config.handoff.stepHistory).toHaveLength(1);
+        expect(config.handoff.stepHistory[0].step).toBe(3);
+        expect(config.handoff.stepHistory[0].label).toBe('Prototype');
+    });
+    it('appends snapshot to existing stepHistory array', () => {
+        const configPath = path.join(root, '.codeyam', 'config.json');
+        const existingHistory = [
+            {
+                step: 1,
+                label: 'Plan',
+                timestamp: '2026-03-30T10:00:00.000Z',
+                scenarioCount: 0,
+                glossaryComponentCount: 0,
+                glossaryFunctionCount: 0,
+                uncommittedFileCount: 0,
+                journalEntryCount: 0,
+            },
+            {
+                step: 2,
+                label: 'Prepare',
+                timestamp: '2026-03-30T10:05:00.000Z',
+                scenarioCount: 0,
+                glossaryComponentCount: 0,
+                glossaryFunctionCount: 0,
+                uncommittedFileCount: 5,
+                journalEntryCount: 0,
+            },
+        ];
+        fs.writeFileSync(configPath, JSON.stringify({
+            provider: 'claude',
+            handoff: {
+                stepHistory: existingHistory,
+                lastStep: 2,
+                lastProvider: 'claude',
+            },
+        }));
+        updateHandoffProgress(root, 3);
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        expect(config.handoff.stepHistory).toHaveLength(3);
+        expect(config.handoff.stepHistory[2].step).toBe(3);
+        expect(config.handoff.lastStep).toBe(3);
+    });
+    it('creates stepHistory array if missing from existing handoff', () => {
+        const configPath = path.join(root, '.codeyam', 'config.json');
+        fs.writeFileSync(configPath, JSON.stringify({
+            provider: 'gemini',
+            handoff: {
+                summary: 'Previous work',
+                lastStep: 5,
+                lastProvider: 'claude',
+            },
+        }));
+        updateHandoffProgress(root, 6);
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        expect(config.handoff.stepHistory).toHaveLength(1);
+        expect(config.handoff.stepHistory[0].step).toBe(6);
+    });
+    it('updates lastProvider, lastStep, lastUpdated alongside step history', () => {
+        const configPath = path.join(root, '.codeyam', 'config.json');
+        fs.writeFileSync(configPath, JSON.stringify({ provider: 'gemini', projectSlug: 'test' }));
+        updateHandoffProgress(root, 7);
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        expect(config.handoff.lastProvider).toBe('gemini');
+        expect(config.handoff.lastStep).toBe(7);
+        expect(typeof config.handoff.lastUpdated).toBe('string');
+        // Verify it's a valid ISO timestamp
+        expect(new Date(config.handoff.lastUpdated).toISOString()).toBe(config.handoff.lastUpdated);
+    });
+    it('preserves existing summary field when updating progress', () => {
+        const configPath = path.join(root, '.codeyam', 'config.json');
+        fs.writeFileSync(configPath, JSON.stringify({
+            provider: 'claude',
+            handoff: {
+                summary: 'Built the TaskCard',
+                lastStep: 5,
+                lastProvider: 'claude',
+            },
+        }));
+        updateHandoffProgress(root, 6);
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        expect(config.handoff.summary).toBe('Built the TaskCard');
+        expect(config.handoff.lastStep).toBe(6);
+    });
+    it('handles missing config.json gracefully (non-fatal)', () => {
+        // No config.json written — should not throw
+        expect(() => updateHandoffProgress(root, 3)).not.toThrow();
+    });
+    it('defaults provider to claude when not specified in config', () => {
+        const configPath = path.join(root, '.codeyam', 'config.json');
+        fs.writeFileSync(configPath, JSON.stringify({ projectSlug: 'test' }));
+        updateHandoffProgress(root, 1);
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        expect(config.handoff.lastProvider).toBe('claude');
+    });
+});
+describe('generateHandoffContext', () => {
+    let root;
+    beforeEach(() => {
+        root = createTempDir();
+        setupCodeyamDir(root);
+        mockedExecSync.mockReturnValue('');
+    });
+    afterEach(() => {
+        fs.rmSync(root, { recursive: true, force: true });
+        jest.restoreAllMocks();
+    });
+    it('includes step history from handoff in the context', () => {
+        const stepHistory = [
+            {
+                step: 1,
+                label: 'Plan',
+                timestamp: '2026-03-30T10:00:00.000Z',
+                scenarioCount: 0,
+                glossaryComponentCount: 0,
+                glossaryFunctionCount: 0,
+                uncommittedFileCount: 0,
+                journalEntryCount: 0,
+            },
+            {
+                step: 3,
+                label: 'Prototype',
+                timestamp: '2026-03-30T10:15:00.000Z',
+                scenarioCount: 0,
+                glossaryComponentCount: 3,
+                glossaryFunctionCount: 2,
+                uncommittedFileCount: 12,
+                journalEntryCount: 0,
+            },
+        ];
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'claude',
+            newProvider: 'gemini',
+            handoff: { summary: 'Built stuff', lastStep: 3, stepHistory },
+        });
+        expect(context.previousProvider).toBe('claude');
+        expect(context.newProvider).toBe('gemini');
+        expect(context.stepHistory).toEqual(stepHistory);
+        expect(context.lastStep).toBe(3);
+        expect(context.lastStepLabel).toBe('Prototype');
+    });
+    it('includes uncommitted files from git status', () => {
+        mockedExecSync.mockReturnValue([
+            ' M app/components/Card.tsx',
+            '?? app/components/New.tsx',
+            ' M .codeyam/config.json',
+        ].join('\n'));
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'claude',
+            newProvider: 'codex',
+            handoff: null,
+        });
+        expect(context.uncommittedChanges.files).toHaveLength(2);
+        expect(context.uncommittedChanges.files[0].path).toBe('app/components/Card.tsx');
+        expect(context.uncommittedChanges.files[0].status).toBe('modified');
+        expect(context.uncommittedChanges.files[1].path).toBe('app/components/New.tsx');
+        expect(context.uncommittedChanges.files[1].status).toBe('untracked');
+    });
+    it('includes existing handoff summary if present', () => {
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'claude',
+            newProvider: 'gemini',
+            handoff: { summary: 'Built the TaskCard and registered scenarios' },
+        });
+        expect(context.handoffSummary).toBe('Built the TaskCard and registered scenarios');
+    });
+    it('handles null handoff gracefully', () => {
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'claude',
+            newProvider: 'gemini',
+            handoff: null,
+        });
+        expect(context.stepHistory).toEqual([]);
+        expect(context.handoffSummary).toBeNull();
+        expect(context.lastStep).toBeNull();
+        expect(context.lastStepLabel).toBeNull();
+    });
+    it('handles no uncommitted changes', () => {
+        mockedExecSync.mockReturnValue('');
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'gemini',
+            newProvider: 'claude',
+            handoff: { lastStep: 5 },
+        });
+        expect(context.uncommittedChanges.files).toHaveLength(0);
+        expect(context.uncommittedChanges.summary).toBe('0 files changed');
+    });
+    it('generates correct summary string for multiple changes', () => {
+        mockedExecSync.mockReturnValue([
+            ' M file1.tsx',
+            ' M file2.tsx',
+            '?? file3.tsx',
+            'A  file4.tsx',
+            ' D file5.tsx',
+        ].join('\n'));
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'claude',
+            newProvider: 'gemini',
+            handoff: null,
+        });
+        expect(context.uncommittedChanges.summary).toBe('5 files changed');
+    });
+    it('sets generatedAt to a valid ISO timestamp', () => {
+        const context = generateHandoffContext({
+            projectRoot: root,
+            previousProvider: 'claude',
+            newProvider: 'gemini',
+            handoff: null,
+        });
+        expect(new Date(context.generatedAt).toISOString()).toBe(context.generatedAt);
+    });
+});
+describe('formatHandoffContextAsMarkdown', () => {
+    function makeContext(overrides = {}) {
+        return {
+            previousProvider: 'claude',
+            newProvider: 'gemini',
+            lastStep: 8,
+            lastStepLabel: 'Glossary',
+            handoffSummary: null,
+            stepHistory: [],
+            uncommittedChanges: { summary: '0 files changed', files: [] },
+            generatedAt: '2026-03-31T12:00:00.000Z',
+            ...overrides,
+        };
+    }
+    it('includes provider names and step info in the header', () => {
+        const md = formatHandoffContextAsMarkdown(makeContext());
+        expect(md).toContain('Claude');
+        expect(md).toContain('Gemini');
+        expect(md).toContain('Step 8');
+        expect(md).toContain('Glossary');
+    });
+    it('generates a progress timeline table from step history', () => {
+        const stepHistory = [
+            {
+                step: 1,
+                label: 'Plan',
+                timestamp: '2026-03-30T10:00:00.000Z',
+                scenarioCount: 0,
+                glossaryComponentCount: 0,
+                glossaryFunctionCount: 0,
+                uncommittedFileCount: 0,
+                journalEntryCount: 0,
+            },
+            {
+                step: 3,
+                label: 'Prototype',
+                timestamp: '2026-03-30T10:15:00.000Z',
+                scenarioCount: 0,
+                glossaryComponentCount: 3,
+                glossaryFunctionCount: 2,
+                uncommittedFileCount: 12,
+                journalEntryCount: 0,
+            },
+            {
+                step: 7,
+                label: 'Extract',
+                timestamp: '2026-03-30T11:00:00.000Z',
+                scenarioCount: 4,
+                glossaryComponentCount: 6,
+                glossaryFunctionCount: 5,
+                uncommittedFileCount: 22,
+                journalEntryCount: 0,
+            },
+        ];
+        const md = formatHandoffContextAsMarkdown(makeContext({ stepHistory, lastStep: 7, lastStepLabel: 'Extract' }));
+        expect(md).toContain('Progress Timeline');
+        expect(md).toContain('| Step | Label | Scenarios | Components | Functions | Files Changed |');
+        expect(md).toContain('| 1 | Plan | 0 | 0 | 0 | 0 |');
+        expect(md).toContain('| 3 | Prototype | 0 | 3 | 2 | 12 |');
+        expect(md).toContain('| 7 | Extract | 4 | 6 | 5 | 22 |');
+    });
+    it('includes previous provider notes when present', () => {
+        const md = formatHandoffContextAsMarkdown(makeContext({
+            handoffSummary: 'Built the TaskCard component with 3 scenarios',
+        }));
+        expect(md).toContain("Previous Provider's Notes");
+        expect(md).toContain('Built the TaskCard component with 3 scenarios');
+    });
+    it('omits notes section when no summary is present', () => {
+        const md = formatHandoffContextAsMarkdown(makeContext({ handoffSummary: null }));
+        expect(md).not.toContain("Previous Provider's Notes");
+    });
+    it('lists uncommitted files with their status', () => {
+        const files = [
+            { path: 'app/components/TaskCard.tsx', status: 'modified' },
+            { path: 'app/components/NewFile.tsx', status: 'added' },
+            { path: 'app/lib/old.ts', status: 'deleted' },
+        ];
+        const md = formatHandoffContextAsMarkdown(makeContext({
+            uncommittedChanges: { summary: '3 files changed', files },
+        }));
+        expect(md).toContain('Uncommitted Changes');
+        expect(md).toContain('`app/components/TaskCard.tsx`');
+        expect(md).toContain('modified');
+        expect(md).toContain('`app/components/NewFile.tsx`');
+        expect(md).toContain('added');
+    });
+    it('truncates file list at 30 entries with a summary', () => {
+        const files = Array.from({ length: 40 }, (_, i) => ({
+            path: `app/file${i}.tsx`,
+            status: 'modified',
+        }));
+        const md = formatHandoffContextAsMarkdown(makeContext({
+            uncommittedChanges: { summary: '40 files changed', files },
+        }));
+        // Should show first 30 files
+        expect(md).toContain('`app/file0.tsx`');
+        expect(md).toContain('`app/file29.tsx`');
+        // Should NOT show file30+
+        expect(md).not.toContain('`app/file30.tsx`');
+        // Should have a "... and N more" message
+        expect(md).toContain('... and 10 more');
+    });
+    it('omits uncommitted changes section when no files changed', () => {
+        const md = formatHandoffContextAsMarkdown(makeContext({
+            uncommittedChanges: { summary: '0 files changed', files: [] },
+        }));
+        expect(md).not.toContain('Uncommitted Changes');
+    });
+    it('omits progress timeline section when step history is empty', () => {
+        const md = formatHandoffContextAsMarkdown(makeContext({ stepHistory: [] }));
+        expect(md).not.toContain('Progress Timeline');
+    });
+    it('includes continuation instructions referencing the correct step', () => {
+        const md = formatHandoffContextAsMarkdown(makeContext({
+            lastStep: 8,
+            lastStepLabel: 'Glossary',
+        }));
+        expect(md).toContain('Instructions');
+        expect(md).toContain('Step 8');
+        expect(md).toContain('Glossary');
+    });
+});
+//# sourceMappingURL=handoffContext.test.js.map