vralphy 0.8.0

package/dist/lib/file-injection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-injection.d.ts","sourceRoot":"","sources":["../../src/lib/file-injection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAClE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAE9E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAIxF;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAsD1B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,eAAe,CAAC,CAkE1B"}

package/dist/lib/file-injection.js

@@ -0,0 +1,138 @@
+/**
+ * Utilities for marker-based content injection and removal in files
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+/**
+ * Check if content already has injection markers
+ */
+export function hasMarkers(content, markers) {
+    return content.includes(markers.start) && content.includes(markers.end);
+}
+/**
+ * Check if content has incomplete markers (only start or end)
+ */
+export function hasIncompleteMarkers(content, markers) {
+    const hasStart = content.includes(markers.start);
+    const hasEnd = content.includes(markers.end);
+    return (hasStart && !hasEnd) || (!hasStart && hasEnd);
+}
+/**
+ * Inject content into a file between markers
+ * If markers exist, replaces content between them
+ * If markers don't exist, appends to end of file
+ */
+export async function injectContent(filePath, content, markers) {
+    try {
+        // Check if file exists
+        if (!existsSync(filePath)) {
+            return {
+                success: false,
+                action: 'skipped',
+                message: 'File does not exist',
+            };
+        }
+        const fileContent = await readFile(filePath, 'utf-8');
+        // Check for incomplete markers
+        if (hasIncompleteMarkers(fileContent, markers)) {
+            return {
+                success: false,
+                action: 'skipped',
+                message: 'File has incomplete markers (only start or end)',
+            };
+        }
+        // Build the injection block
+        const injectionBlock = `${markers.start}${content}${markers.end}`;
+        let newContent;
+        let action;
+        if (hasMarkers(fileContent, markers)) {
+            // Replace existing content between markers
+            const startIdx = fileContent.indexOf(markers.start);
+            const endIdx = fileContent.indexOf(markers.end) + markers.end.length;
+            newContent = fileContent.slice(0, startIdx) + injectionBlock + fileContent.slice(endIdx);
+            action = 'replaced';
+        }
+        else {
+            // Append to end of file
+            const separator = fileContent.endsWith('\n') ? '\n' : '\n\n';
+            newContent = fileContent + separator + injectionBlock + '\n';
+            action = 'injected';
+        }
+        await writeFile(filePath, newContent);
+        return {
+            success: true,
+            action,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Remove injected content from a file
+ * Removes everything between and including the markers
+ */
+export async function removeInjectedContent(filePath, markers) {
+    try {
+        // Check if file exists
+        if (!existsSync(filePath)) {
+            return {
+                success: false,
+                action: 'skipped',
+                message: 'File does not exist',
+            };
+        }
+        const fileContent = await readFile(filePath, 'utf-8');
+        // Check for incomplete markers
+        if (hasIncompleteMarkers(fileContent, markers)) {
+            return {
+                success: false,
+                action: 'skipped',
+                message: 'File has incomplete markers (only start or end)',
+            };
+        }
+        // Check if markers exist
+        if (!hasMarkers(fileContent, markers)) {
+            return {
+                success: false,
+                action: 'skipped',
+                message: 'No injection markers found',
+            };
+        }
+        // Remove content between markers (including markers)
+        const startIdx = fileContent.indexOf(markers.start);
+        const endIdx = fileContent.indexOf(markers.end) + markers.end.length;
+        // Include any trailing newline in removal
+        let removeEndIdx = endIdx;
+        if (fileContent[endIdx] === '\n') {
+            removeEndIdx = endIdx + 1;
+        }
+        // Include any leading newlines if preceded by content
+        let removeStartIdx = startIdx;
+        if (startIdx > 0 && fileContent[startIdx - 1] === '\n') {
+            removeStartIdx = startIdx - 1;
+            // Remove extra blank line if there's another newline before
+            if (removeStartIdx > 0 && fileContent[removeStartIdx - 1] === '\n') {
+                removeStartIdx = removeStartIdx - 1;
+            }
+        }
+        const newContent = fileContent.slice(0, removeStartIdx) + fileContent.slice(removeEndIdx);
+        await writeFile(filePath, newContent);
+        return {
+            success: true,
+            action: 'removed',
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            action: 'error',
+            message: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=file-injection.js.map

package/dist/lib/file-injection.js.map

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

package/dist/lib/file-injection.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-injection.test.d.ts.map

package/dist/lib/file-injection.test.d.ts.map

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

package/dist/lib/file-injection.test.js

@@ -0,0 +1,508 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdir, writeFile, readFile, rm } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { injectContent, removeInjectedContent, hasMarkers, hasIncompleteMarkers, } from './file-injection.js';
+import { INJECTION_MARKERS, CLAUDE_MD_INJECTION, AGENTS_MD_INJECTION } from './templates/injections.js';
+const TEST_DIR = '/tmp/vralphy-injection-test';
+describe('file-injection', () => {
+    beforeEach(async () => {
+        if (existsSync(TEST_DIR)) {
+            await rm(TEST_DIR, { recursive: true, force: true });
+        }
+        await mkdir(TEST_DIR, { recursive: true });
+    });
+    afterEach(async () => {
+        if (existsSync(TEST_DIR)) {
+            await rm(TEST_DIR, { recursive: true, force: true });
+        }
+    });
+    describe('hasMarkers', () => {
+        it('should return true when both markers present', () => {
+            const content = `# Title\n${INJECTION_MARKERS.start}\nInjected\n${INJECTION_MARKERS.end}\n`;
+            expect(hasMarkers(content, INJECTION_MARKERS)).toBe(true);
+        });
+        it('should return false when no markers present', () => {
+            const content = '# Title\nSome content\n';
+            expect(hasMarkers(content, INJECTION_MARKERS)).toBe(false);
+        });
+        it('should return false when only start marker present', () => {
+            const content = `# Title\n${INJECTION_MARKERS.start}\nContent\n`;
+            expect(hasMarkers(content, INJECTION_MARKERS)).toBe(false);
+        });
+        it('should return false when only end marker present', () => {
+            const content = `# Title\n${INJECTION_MARKERS.end}\nContent\n`;
+            expect(hasMarkers(content, INJECTION_MARKERS)).toBe(false);
+        });
+        it('should work with markers in middle of file', () => {
+            const content = `# Header\n\nParagraph.\n\n${INJECTION_MARKERS.start}\nMiddle\n${INJECTION_MARKERS.end}\n\n## Footer\n`;
+            expect(hasMarkers(content, INJECTION_MARKERS)).toBe(true);
+        });
+        it('should work with custom markers', () => {
+            const customMarkers = { start: '<!-- BEGIN -->', end: '<!-- END -->' };
+            const content = '# Title\n<!-- BEGIN -->\nContent\n<!-- END -->\n';
+            expect(hasMarkers(content, customMarkers)).toBe(true);
+        });
+    });
+    describe('hasIncompleteMarkers', () => {
+        it('should return true when only start marker present', () => {
+            const content = `# Title\n${INJECTION_MARKERS.start}\nContent\n`;
+            expect(hasIncompleteMarkers(content, INJECTION_MARKERS)).toBe(true);
+        });
+        it('should return true when only end marker present', () => {
+            const content = `# Title\n${INJECTION_MARKERS.end}\nContent\n`;
+            expect(hasIncompleteMarkers(content, INJECTION_MARKERS)).toBe(true);
+        });
+        it('should return false when both markers present', () => {
+            const content = `# Title\n${INJECTION_MARKERS.start}\nInjected\n${INJECTION_MARKERS.end}\n`;
+            expect(hasIncompleteMarkers(content, INJECTION_MARKERS)).toBe(false);
+        });
+        it('should return false when no markers present', () => {
+            const content = '# Title\nSome content\n';
+            expect(hasIncompleteMarkers(content, INJECTION_MARKERS)).toBe(false);
+        });
+    });
+    describe('injectContent', () => {
+        it('should inject content at end of file when no markers exist', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, '# Title\n\nExisting content.\n');
+            const result = await injectContent(filePath, '\nNew section\n', INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('injected');
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain(INJECTION_MARKERS.start);
+            expect(content).toContain('New section');
+            expect(content).toContain(INJECTION_MARKERS.end);
+            expect(content).toContain('Existing content.');
+        });
+        it('should replace content when markers already exist', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Title\n\n${INJECTION_MARKERS.start}\nOld content\n${INJECTION_MARKERS.end}\n\nMore content.\n`);
+            const result = await injectContent(filePath, '\nNew content\n', INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('replaced');
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('New content');
+            expect(content).not.toContain('Old content');
+            expect(content).toContain('More content.');
+        });
+        it('should skip when file does not exist', async () => {
+            const filePath = join(TEST_DIR, 'nonexistent.md');
+            const result = await injectContent(filePath, '\nContent\n', INJECTION_MARKERS);
+            expect(result.success).toBe(false);
+            expect(result.action).toBe('skipped');
+            expect(result.message).toBe('File does not exist');
+        });
+        it('should skip when file has incomplete markers', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Title\n\n${INJECTION_MARKERS.start}\nBroken content\n`);
+            const result = await injectContent(filePath, '\nContent\n', INJECTION_MARKERS);
+            expect(result.success).toBe(false);
+            expect(result.action).toBe('skipped');
+            expect(result.message).toContain('incomplete markers');
+        });
+        it('should preserve content before and after injection point', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            const originalContent = `# Header
+
+First paragraph with important info.
+
+## Section A
+
+Content A.
+
+## Section B
+
+Content B.
+`;
+            await writeFile(filePath, originalContent);
+            await injectContent(filePath, '\n## Injected\n\nNew stuff.\n', INJECTION_MARKERS);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('# Header');
+            expect(content).toContain('First paragraph with important info.');
+            expect(content).toContain('## Section A');
+            expect(content).toContain('Content A.');
+            expect(content).toContain('## Section B');
+            expect(content).toContain('Content B.');
+            expect(content).toContain('## Injected');
+            expect(content).toContain('New stuff.');
+        });
+        it('should handle empty file', async () => {
+            const filePath = join(TEST_DIR, 'empty.md');
+            await writeFile(filePath, '');
+            const result = await injectContent(filePath, '\nContent\n', INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain(INJECTION_MARKERS.start);
+            expect(content).toContain('Content');
+            expect(content).toContain(INJECTION_MARKERS.end);
+        });
+        it('should handle file without trailing newline', async () => {
+            const filePath = join(TEST_DIR, 'no-newline.md');
+            await writeFile(filePath, '# Title\n\nNo trailing newline');
+            const result = await injectContent(filePath, '\nContent\n', INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('No trailing newline');
+            expect(content).toContain(INJECTION_MARKERS.start);
+        });
+        it('should work with actual CLAUDE_MD_INJECTION content', async () => {
+            const filePath = join(TEST_DIR, 'CLAUDE.md');
+            await writeFile(filePath, `# vralphy
+
+CLI tool implementing the Ralph Playbook.
+
+## Commands
+
+\`\`\`bash
+npm run build
+npm test
+\`\`\`
+`);
+            const result = await injectContent(filePath, CLAUDE_MD_INJECTION, INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('injected');
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('## vralphy Integration');
+            expect(content).toContain('@.vralphy/README.md');
+            expect(content).toContain('@.vralphy/AGENTS.md');
+            expect(content).toContain('@IMPLEMENTATION_PLAN.md');
+            // Original content preserved
+            expect(content).toContain('# vralphy');
+            expect(content).toContain('npm run build');
+        });
+        it('should work with actual AGENTS_MD_INJECTION content', async () => {
+            const filePath = join(TEST_DIR, 'AGENTS.md');
+            await writeFile(filePath, `# AGENTS.md
+
+Operational guide for AI agents.
+
+## Build & Validate
+
+\`\`\`bash
+npm install
+\`\`\`
+`);
+            const result = await injectContent(filePath, AGENTS_MD_INJECTION, INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('## vralphy');
+            expect(content).toContain('.vralphy/README.md');
+            // Original content preserved
+            expect(content).toContain('# AGENTS.md');
+            expect(content).toContain('Operational guide');
+        });
+        it('should handle multiple inject/replace cycles', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, '# Project\n');
+            // First injection
+            await injectContent(filePath, '\nVersion 1\n', INJECTION_MARKERS);
+            let content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('Version 1');
+            // Second injection (replace)
+            await injectContent(filePath, '\nVersion 2\n', INJECTION_MARKERS);
+            content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('Version 2');
+            expect(content).not.toContain('Version 1');
+            // Third injection (replace)
+            await injectContent(filePath, '\nVersion 3\n', INJECTION_MARKERS);
+            content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('Version 3');
+            expect(content).not.toContain('Version 2');
+            // Markers should appear exactly once
+            const startCount = (content.match(new RegExp(INJECTION_MARKERS.start, 'g')) || []).length;
+            const endCount = (content.match(new RegExp(INJECTION_MARKERS.end, 'g')) || []).length;
+            expect(startCount).toBe(1);
+            expect(endCount).toBe(1);
+        });
+    });
+    describe('removeInjectedContent', () => {
+        it('should remove injected content and markers', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Title\n\n${INJECTION_MARKERS.start}\nInjected content\n${INJECTION_MARKERS.end}\n\nRemaining content.\n`);
+            const result = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            expect(result.action).toBe('removed');
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).not.toContain(INJECTION_MARKERS.start);
+            expect(content).not.toContain('Injected content');
+            expect(content).not.toContain(INJECTION_MARKERS.end);
+            expect(content).toContain('# Title');
+            expect(content).toContain('Remaining content.');
+        });
+        it('should skip when file does not exist', async () => {
+            const filePath = join(TEST_DIR, 'nonexistent.md');
+            const result = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(result.success).toBe(false);
+            expect(result.action).toBe('skipped');
+            expect(result.message).toBe('File does not exist');
+        });
+        it('should skip when no markers found', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, '# Title\n\nNo markers here.\n');
+            const result = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(result.success).toBe(false);
+            expect(result.action).toBe('skipped');
+            expect(result.message).toBe('No injection markers found');
+        });
+        it('should skip when file has incomplete markers', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Title\n\n${INJECTION_MARKERS.start}\nBroken\n`);
+            const result = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(result.success).toBe(false);
+            expect(result.action).toBe('skipped');
+            expect(result.message).toContain('incomplete markers');
+        });
+        it('should leave file non-empty after removal', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Project\n\n${INJECTION_MARKERS.start}\nInjected\n${INJECTION_MARKERS.end}\n`);
+            await removeInjectedContent(filePath, INJECTION_MARKERS);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content.length).toBeGreaterThan(0);
+            expect(content).toContain('# Project');
+        });
+        it('should preserve content before injection', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Header
+
+First section.
+
+## Section A
+
+Content A.
+
+${INJECTION_MARKERS.start}
+## Injected Section
+
+This will be removed.
+${INJECTION_MARKERS.end}
+`);
+            await removeInjectedContent(filePath, INJECTION_MARKERS);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('# Header');
+            expect(content).toContain('First section.');
+            expect(content).toContain('## Section A');
+            expect(content).toContain('Content A.');
+            expect(content).not.toContain('Injected Section');
+            expect(content).not.toContain('This will be removed');
+        });
+        it('should preserve content after injection', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Header
+
+${INJECTION_MARKERS.start}
+## Injected Section
+
+This will be removed.
+${INJECTION_MARKERS.end}
+
+## Footer Section
+
+Footer content.
+`);
+            await removeInjectedContent(filePath, INJECTION_MARKERS);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('# Header');
+            expect(content).toContain('## Footer Section');
+            expect(content).toContain('Footer content.');
+            expect(content).not.toContain('Injected Section');
+        });
+        it('should handle injection in middle of file', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, `# Header
+
+Before content.
+
+${INJECTION_MARKERS.start}
+Injected middle.
+${INJECTION_MARKERS.end}
+
+After content.
+
+## Footer
+`);
+            await removeInjectedContent(filePath, INJECTION_MARKERS);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('Before content.');
+            expect(content).toContain('After content.');
+            expect(content).toContain('## Footer');
+            expect(content).not.toContain('Injected middle');
+        });
+        it('should work with actual CLAUDE_MD_INJECTION content', async () => {
+            const filePath = join(TEST_DIR, 'CLAUDE.md');
+            const originalContent = `# vralphy
+
+CLI tool implementing the Ralph Playbook.
+
+## Commands
+
+\`\`\`bash
+npm run build
+npm test
+\`\`\`
+`;
+            await writeFile(filePath, originalContent);
+            // Inject first
+            await injectContent(filePath, CLAUDE_MD_INJECTION, INJECTION_MARKERS);
+            // Then remove
+            const result = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(result.success).toBe(true);
+            const content = await readFile(filePath, 'utf-8');
+            expect(content).not.toContain('## vralphy Integration');
+            expect(content).not.toContain('@.vralphy/README.md');
+            // Original content preserved
+            expect(content).toContain('# vralphy');
+            expect(content).toContain('npm run build');
+        });
+        it('should handle inject-remove-inject cycle', async () => {
+            const filePath = join(TEST_DIR, 'test.md');
+            await writeFile(filePath, '# Project\n\nOriginal content.\n');
+            // Inject
+            await injectContent(filePath, '\nFirst injection\n', INJECTION_MARKERS);
+            let content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('First injection');
+            // Remove
+            await removeInjectedContent(filePath, INJECTION_MARKERS);
+            content = await readFile(filePath, 'utf-8');
+            expect(content).not.toContain('First injection');
+            expect(content).toContain('Original content.');
+            // Inject again
+            await injectContent(filePath, '\nSecond injection\n', INJECTION_MARKERS);
+            content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('Second injection');
+            expect(content).toContain('Original content.');
+        });
+    });
+    describe('integration with real file structures', () => {
+        it('should handle CLAUDE.md structure like the real project', async () => {
+            const filePath = join(TEST_DIR, 'CLAUDE.md');
+            // Mimic the real CLAUDE.md structure
+            await writeFile(filePath, `# vralphy
+
+CLI tool implementing the Ralph Playbook - autonomous AI development where agents plan, build, test, and commit code.
+
+## Commands
+
+\`\`\`bash
+npm run build      # Compile TypeScript
+npm run test       # Run tests (vitest)
+npm run typecheck  # Type check only
+npm run lint       # ESLint
+\`\`\`
+
+## Architecture
+
+- \`src/commands/\` - CLI commands (build, plan, spec, init, cleanup)
+- \`src/lib/engines/\` - Engine abstraction (Claude, OpenCode, Codex)
+- \`src/lib/\` - Core: config, prompts, events, slack, plan parsing
+
+## Critical Rules
+
+- IMPORTANT: Run \`npm run typecheck && npm test\` before committing
+- IMPORTANT: Tests are colocated (\`*.test.ts\` next to source)
+- IMPORTANT: Import paths use \`.js\` extension (ES modules)
+- Use TypeScript strict mode, avoid \`any\`
+
+## Conventions
+
+- Async/await over callbacks
+- Composition over inheritance
+- Named exports preferred
+- Silent failure for non-critical operations (slack, events)
+
+## Detailed References
+
+@.claude/docs/architecture.md
+@.claude/docs/commands.md
+@.claude/docs/engines.md
+@.claude/docs/testing.md
+`);
+            // Inject
+            const injectResult = await injectContent(filePath, CLAUDE_MD_INJECTION, INJECTION_MARKERS);
+            expect(injectResult.success).toBe(true);
+            let content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('## vralphy Integration');
+            expect(content).toContain('## Commands'); // Original preserved
+            expect(content).toContain('## Critical Rules'); // Original preserved
+            // Remove
+            const removeResult = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(removeResult.success).toBe(true);
+            content = await readFile(filePath, 'utf-8');
+            expect(content).not.toContain('## vralphy Integration');
+            expect(content).toContain('## Commands');
+            expect(content).toContain('## Critical Rules');
+            expect(content).toContain('@.claude/docs/architecture.md');
+        });
+        it('should handle AGENTS.md structure like the real project', async () => {
+            const filePath = join(TEST_DIR, 'AGENTS.md');
+            // Mimic the real AGENTS.md structure
+            await writeFile(filePath, `# AGENTS.md
+
+Operational guide for AI agents working on vralphy.
+
+## Build & Validate
+
+\`\`\`bash
+npm install        # Install dependencies
+npm run build      # Compile TypeScript to dist/
+npm run test       # Run vitest tests
+npm run typecheck  # Type check without emit
+npm run lint       # ESLint check
+\`\`\`
+
+## Project Structure
+
+\`\`\`
+src/
+├── index.ts           # CLI entry (commander.js)
+├── commands/          # build, plan, spec, init, cleanup
+└── lib/
+    ├── engines/       # Claude, OpenCode, Codex implementations
+    ├── config.ts      # Config resolution (CLI > env > file > defaults)
+    ├── prompts.ts     # Prompt loading & interpolation
+    ├── events.ts      # Event logging with rotation
+    ├── slack.ts       # Slack notifications (fire-and-forget)
+    └── plan.ts        # IMPLEMENTATION_PLAN.md parsing
+\`\`\`
+
+## Tech Stack
+
+- TypeScript (ES2022, strict mode)
+- Node.js >= 18
+- Commander.js for CLI
+- Vitest for testing
+
+## Key Patterns
+
+- **Engine interface**: All engines implement \`Engine\` from \`base.ts\`
+- **Config hierarchy**: CLI flags > env vars > config file > defaults
+- **Streaming output**: Engines yield \`Chunk\` objects (text, tool_use, error, done)
+- **Silent failures**: Logging/notifications never break execution
+
+## Code Style
+
+- Async/await, no callbacks
+- Named exports, single responsibility
+- \`_\` prefix for intentionally unused vars
+- Import paths include \`.js\` extension
+`);
+            // Inject
+            const injectResult = await injectContent(filePath, AGENTS_MD_INJECTION, INJECTION_MARKERS);
+            expect(injectResult.success).toBe(true);
+            let content = await readFile(filePath, 'utf-8');
+            expect(content).toContain('## vralphy');
+            expect(content).toContain('.vralphy/README.md');
+            expect(content).toContain('## Build & Validate'); // Original preserved
+            expect(content).toContain('## Tech Stack'); // Original preserved
+            // Remove
+            const removeResult = await removeInjectedContent(filePath, INJECTION_MARKERS);
+            expect(removeResult.success).toBe(true);
+            content = await readFile(filePath, 'utf-8');
+            expect(content).not.toContain(INJECTION_MARKERS.start);
+            expect(content).toContain('## Build & Validate');
+            expect(content).toContain('## Tech Stack');
+            expect(content).toContain('# AGENTS.md');
+        });
+    });
+});
+//# sourceMappingURL=file-injection.test.js.map