@codeyam/codeyam-cli 0.1.0-staging.b8a55ba → 0.1.0-staging.c1c8678

package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js

@@ -0,0 +1,75 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { execSync } from 'child_process';
+/**
+ * Create a temporary project directory with the structure expected by rule reflection:
+ * - .claude/rules/ (with optional pre-existing rules)
+ * - .codeyam/rules/instructions.md
+ * - Source files
+ * - Git initialized with initial commit
+ */
+export function setupTempProject(options = {}) {
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'codeyam-rule-test-'));
+    const rulesDir = path.join(dir, '.claude', 'rules');
+    const codeyamRulesDir = path.join(dir, '.codeyam', 'rules');
+    // Create directories
+    fs.mkdirSync(rulesDir, { recursive: true });
+    fs.mkdirSync(codeyamRulesDir, { recursive: true });
+    // Write instructions.md
+    fs.writeFileSync(path.join(codeyamRulesDir, 'instructions.md'), [
+        '# Claude Rules Guide',
+        '',
+        'Rules provide context-specific guidance.',
+        '',
+        '## Required Frontmatter',
+        '',
+        '```yaml',
+        '---',
+        'paths:',
+        "  - 'specific/path/to/file.ts'",
+        'timestamp: 2026-01-30T00:00:00Z',
+        '---',
+        '```',
+        '',
+        '## Content Guidelines',
+        '',
+        '- One concept per rule',
+        '- Be concise',
+        '- Focus on non-obvious knowledge',
+    ].join('\n'));
+    // Write existing rules
+    for (const [filename, content] of Object.entries(options.existingRules || {})) {
+        const filePath = path.join(rulesDir, filename);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, content);
+    }
+    // Write source files
+    for (const [relPath, content] of Object.entries(options.sourceFiles || {})) {
+        const filePath = path.join(dir, relPath);
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, content);
+    }
+    // Initialize git repo
+    execSync('git init', { cwd: dir, stdio: 'ignore' });
+    execSync('git add -A', { cwd: dir, stdio: 'ignore' });
+    execSync('git commit -m "initial commit" --allow-empty', {
+        cwd: dir,
+        stdio: 'ignore',
+        env: {
+            ...process.env,
+            GIT_AUTHOR_NAME: 'Test',
+            GIT_AUTHOR_EMAIL: 'test@test.com',
+            GIT_COMMITTER_NAME: 'Test',
+            GIT_COMMITTER_EMAIL: 'test@test.com',
+        },
+    });
+    return {
+        dir,
+        rulesDir,
+        cleanup: () => {
+            fs.rmSync(dir, { recursive: true, force: true });
+        },
+    };
+}
+//# sourceMappingURL=setupTempProject.js.map

package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/helpers/setupTempProject.js.map

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

package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js

@@ -0,0 +1,378 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { setupTempProject } from "./helpers/setupTempProject.js";
+import { snapshotRules, getRulesChanges, assertValidFrontmatter, } from "./helpers/assertRules.js";
+import { runClaude } from "./helpers/runClaude.js";
+import { buildStaleRulesContext, buildConversationContext, } from "../../contextBuilder.js";
+import { buildStaleRulesPrompt, buildConversationPrompt, } from "../../promptBuilder.js";
+import { loadCapturedFixture, } from "./helpers/loadCapturedFixture.js";
+/**
+ * Extract conversation snippets from a captured fixture's context.md.
+ * The context contains a `### Session transcript` section with lines like:
+ *   [role]: content
+ */
+function extractSnippetsFromFixture(fixture) {
+    if (!fixture.context)
+        return [];
+    const marker = '### Session transcript\n';
+    const idx = fixture.context.indexOf(marker);
+    if (idx === -1)
+        return [];
+    const transcriptSection = fixture.context.slice(idx + marker.length).trim();
+    const snippets = [];
+    for (const line of transcriptSection.split('\n')) {
+        const match = line.match(/^\[(\w+)\]:\s*(.+)$/);
+        if (match) {
+            snippets.push({ role: match[1], content: match[2] });
+        }
+    }
+    return snippets;
+}
+const SKIP = !process.env.CODEYAM_RUN_INTEGRATION;
+const OUTPUT_DIR = path.resolve(__dirname, 'output');
+(SKIP ? describe.skip : describe)('Rule Reflection E2E', () => {
+    let tempProject;
+    afterEach(() => {
+        if (tempProject) {
+            tempProject.cleanup();
+        }
+    });
+    it('updates timestamp for stale rule with empty diff', async () => {
+        const existingRule = [
+            '---',
+            'paths:',
+            "  - 'src/config.ts'",
+            'timestamp: 2026-01-01T00:00:00Z',
+            '---',
+            '',
+            '# Build Configuration',
+            '',
+            'Use `npm run build:prod` for production builds.',
+        ].join('\n');
+        tempProject = setupTempProject({
+            existingRules: { 'build-config.md': existingRule },
+            sourceFiles: {
+                'src/config.ts': 'export const config = { debug: false };',
+            },
+        });
+        const staleRules = [
+            {
+                name: 'build-config.md',
+                last_audited: '2026-01-01T00:00:00Z',
+                newest_file: 'src/config.ts',
+                file_modified: '2026-02-01T00:00:00Z',
+                diff: '',
+                rule_content: '# Build Configuration\n\nUse `npm run build:prod` for production builds.',
+            },
+        ];
+        const contextContent = buildStaleRulesContext(staleRules);
+        const contextFile = path.join(tempProject.dir, '.context.md');
+        fs.writeFileSync(contextFile, contextContent);
+        const notificationFile = path.join(tempProject.dir, 'rule-notification-stale.md');
+        const before = await snapshotRules(tempProject.rulesDir);
+        const prompt = buildStaleRulesPrompt(contextFile, tempProject.dir, notificationFile);
+        runClaude({
+            prompt,
+            cwd: tempProject.dir,
+            saveOutput: { dir: OUTPUT_DIR, label: 'stale-rule-empty-diff' },
+        });
+        const after = await snapshotRules(tempProject.rulesDir);
+        const changes = getRulesChanges(before, after);
+        // The rule should be modified (timestamp updated) or unchanged
+        // Either way the file should still exist and have valid frontmatter
+        const ruleContent = after.files.get('build-config.md') || before.files.get('build-config.md');
+        expect(ruleContent).toBeDefined();
+        if (changes.modified.includes('build-config.md')) {
+            assertValidFrontmatter(ruleContent);
+        }
+    }, 180000);
+    it('creates new rule from user correction conversation', async () => {
+        tempProject = setupTempProject({
+            sourceFiles: {
+                'src/api/auth.ts': 'export function authenticate(req: Request) { /* JWT auth */ }',
+                'src/api/session.ts': 'export function createSession() { /* session tokens */ }',
+            },
+        });
+        const snippets = [
+            {
+                role: 'user',
+                content: 'Update the API endpoint to use the new authentication flow',
+            },
+            {
+                role: 'assistant',
+                content: "I'll modify the authentication to use session tokens instead of JWT.",
+            },
+            {
+                role: 'user',
+                content: "No, that's not right. We need to keep JWT for the API but add session tokens for the web interface. They work together, not replace each other.",
+            },
+            {
+                role: 'assistant',
+                content: 'I understand now. The JWT tokens remain for API authentication while session tokens are added for the web interface.',
+            },
+        ];
+        const modifiedFiles = new Set([
+            ['src/api/auth.ts', 'Edit'],
+            ['src/api/session.ts', 'Write'],
+        ]);
+        const contextContent = buildConversationContext(snippets, modifiedFiles);
+        const contextFile = path.join(tempProject.dir, '.context.md');
+        fs.writeFileSync(contextFile, contextContent);
+        const notificationFile = path.join(tempProject.dir, 'rule-notification-conversation.md');
+        const before = await snapshotRules(tempProject.rulesDir);
+        const prompt = buildConversationPrompt(contextFile, tempProject.dir, notificationFile);
+        runClaude({
+            prompt,
+            cwd: tempProject.dir,
+            saveOutput: { dir: OUTPUT_DIR, label: 'user-correction-conversation' },
+        });
+        const after = await snapshotRules(tempProject.rulesDir);
+        const changes = getRulesChanges(before, after);
+        // Should have created at least one new rule about the auth pattern
+        expect(changes.created.length).toBeGreaterThan(0);
+        // New rule(s) should have valid frontmatter
+        for (const created of changes.created) {
+            const content = after.files.get(created);
+            assertValidFrontmatter(content);
+        }
+    }, 180000);
+    it('handles stale rules and conversation as separate agents', async () => {
+        const existingRule = [
+            '---',
+            'paths:',
+            "  - 'src/api/auth.ts'",
+            'timestamp: 2026-01-15T00:00:00Z',
+            '---',
+            '',
+            '# API Auth',
+            '',
+            'All API endpoints use JWT authentication.',
+        ].join('\n');
+        tempProject = setupTempProject({
+            existingRules: { 'api-auth.md': existingRule },
+            sourceFiles: {
+                'src/api/auth.ts': 'export function authenticate() {}',
+                'src/utils/helpers.ts': 'export function helper() {}',
+            },
+        });
+        const staleRules = [
+            {
+                name: 'api-auth.md',
+                last_audited: '2026-01-15T00:00:00Z',
+                newest_file: 'src/api/auth.ts',
+                file_modified: '2026-02-01T00:00:00Z',
+                diff: '@@ -1 +1,2 @@\n+import { validateSession } from "./session.js"\n export function authenticate() {}',
+                rule_content: '# API Auth\n\nAll API endpoints use JWT authentication.',
+            },
+        ];
+        const snippets = [
+            {
+                role: 'user',
+                content: 'The helpers module needs to be imported before auth because of initialization order',
+            },
+            {
+                role: 'assistant',
+                content: 'I see, there is an initialization dependency between helpers and auth.',
+            },
+        ];
+        const notificationFileStale = path.join(tempProject.dir, 'rule-notification-stale.md');
+        const notificationFileConv = path.join(tempProject.dir, 'rule-notification-conversation.md');
+        // Run stale rules agent
+        const staleContext = buildStaleRulesContext(staleRules);
+        const staleContextFile = path.join(tempProject.dir, '.context-stale.md');
+        fs.writeFileSync(staleContextFile, staleContext);
+        const before = await snapshotRules(tempProject.rulesDir);
+        const stalePrompt = buildStaleRulesPrompt(staleContextFile, tempProject.dir, notificationFileStale);
+        runClaude({
+            prompt: stalePrompt,
+            cwd: tempProject.dir,
+            saveOutput: { dir: OUTPUT_DIR, label: 'combined-stale' },
+        });
+        // Run conversation agent
+        const convContext = buildConversationContext(snippets, new Set());
+        const convContextFile = path.join(tempProject.dir, '.context-conversation.md');
+        fs.writeFileSync(convContextFile, convContext);
+        const convPrompt = buildConversationPrompt(convContextFile, tempProject.dir, notificationFileConv);
+        runClaude({
+            prompt: convPrompt,
+            cwd: tempProject.dir,
+            saveOutput: { dir: OUTPUT_DIR, label: 'combined-conversation' },
+        });
+        const after = await snapshotRules(tempProject.rulesDir);
+        const changes = getRulesChanges(before, after);
+        // Existing rule should still be present
+        expect(after.files.has('api-auth.md')).toBe(true);
+        // Total changes (stale rule update + potential new rule) should be > 0
+        expect(changes.modified.length + changes.created.length).toBeGreaterThan(0);
+    }, 300000);
+    it('writes notification file when rules change', async () => {
+        tempProject = setupTempProject({
+            sourceFiles: {
+                'src/index.ts': 'console.log("hello");',
+            },
+        });
+        const snippets = [
+            {
+                role: 'user',
+                content: "No, that's wrong. You must always run the linter before committing. The pre-commit hook checks this.",
+            },
+            {
+                role: 'assistant',
+                content: 'I see, the pre-commit hook enforces linting. I will run the linter first.',
+            },
+        ];
+        const contextContent = buildConversationContext(snippets, new Set());
+        const contextFile = path.join(tempProject.dir, '.context.md');
+        fs.writeFileSync(contextFile, contextContent);
+        const notificationFile = path.join(tempProject.dir, 'rule-notification-conversation.md');
+        const prompt = buildConversationPrompt(contextFile, tempProject.dir, notificationFile);
+        runClaude({
+            prompt,
+            cwd: tempProject.dir,
+            saveOutput: { dir: OUTPUT_DIR, label: 'notification-file' },
+        });
+        const after = await snapshotRules(tempProject.rulesDir);
+        // If rules were created, notification should exist
+        if (after.files.size > 0) {
+            expect(fs.existsSync(notificationFile)).toBe(true);
+            const notification = fs.readFileSync(notificationFile, 'utf-8');
+            expect(notification.length).toBeGreaterThan(0);
+        }
+    }, 180000);
+    describe('captured fixtures', () => {
+        const FIXTURES_DIR = path.resolve(__dirname, '../fixtures/captured');
+        it('does not create rules from routine implementation conversation (fe1a8b55)', async () => {
+            // This fixture captured a session where the user asked to reorder search
+            // results in the memory audit section. It was purely implementation work
+            // with no user corrections, confusion, or architectural decisions.
+            // The agent incorrectly created a rule about search ordering.
+            //
+            // We rebuild the context using the CURRENT guidance template + the
+            // fixture's transcript so that guidance improvements are tested.
+            tempProject = setupTempProject({
+                sourceFiles: {
+                    'src/webserver/app/components/memory/MemoryAuditSection.tsx': 'export function MemoryAuditSection() { return <div />; }',
+                    'src/webserver/app/lib/memory/types.ts': 'export interface AuditData { topPaths: any[]; allSourceFiles: string[]; }',
+                    'src/webserver/app/routes/api.memory.ts': 'export async function loader() { return Response.json({}); }',
+                },
+            });
+            // Transcript from the captured fixture — the user gave clear
+            // implementation requirements, no corrections or confusion.
+            const snippets = [
+                {
+                    role: 'user',
+                    content: 'Ok can we order the results by path that start with the search string, followed by paths that contain the search string? Within those matches it should be alphabetic. The search results order should not be impacted by the rule count or token count at all. All files in the repo should be included in the search',
+                },
+                {
+                    role: 'assistant',
+                    content: 'Let me look at the current data flow to understand what needs to change.',
+                },
+                {
+                    role: 'assistant',
+                    content: "The API only returns files that have matching rules. I need to also return all source files so search can cover everything. But sending full coverage data for every file would be heavy — I'll return the source file list separately and build search results client-side.",
+                },
+                {
+                    role: 'assistant',
+                    content: 'Now update the search suggestions to use all source files with proper sorting, and build `PathCoverage` entries on the fly for files without rule coverage.',
+                },
+                {
+                    role: 'assistant',
+                    content: "Builds clean. Here's what changed: 1. All files searchable: API now returns allSourceFiles 2. Sorting: Prefix matches first, then contains — alphabetical within each group 3. No rule/token bias: Sorting is purely by path 4. Overflow fix: Removed overflow-hidden so the dropdown isn't clipped",
+                },
+            ];
+            const modifiedFiles = new Set([
+                ['src/webserver/app/components/memory/MemoryAuditSection.tsx', 'Edit'],
+                ['src/webserver/app/lib/memory/types.ts', 'Edit'],
+                ['src/webserver/app/routes/api.memory.ts', 'Edit'],
+            ]);
+            const contextContent = buildConversationContext(snippets, modifiedFiles);
+            const contextFile = path.join(tempProject.dir, '.context.md');
+            fs.writeFileSync(contextFile, contextContent);
+            const notificationFile = path.join(tempProject.dir, 'rule-notification-conversation.md');
+            const before = await snapshotRules(tempProject.rulesDir);
+            const prompt = buildConversationPrompt(contextFile, tempProject.dir, notificationFile);
+            runClaude({
+                prompt,
+                cwd: tempProject.dir,
+                saveOutput: { dir: OUTPUT_DIR, label: 'fixture-fe1a8b55-no-rule' },
+            });
+            const after = await snapshotRules(tempProject.rulesDir);
+            const changes = getRulesChanges(before, after);
+            // No rules should be created — this was routine implementation work.
+            // The user gave clear instructions about search ordering; there were
+            // no corrections, confusion, or non-obvious architectural decisions.
+            expect(changes.created.length).toBe(0);
+        }, 180000);
+        it('does not create rules for a bug fix that is now protected by code and tests (b4e050b8)', async () => {
+            // This fixture captured a session where a crash in ScopeDataStructure.ts
+            // was debugged and fixed: addComplexSourcePathVariables crashed when a
+            // usage equivalency referenced an HTML intrinsic element (<input>) that
+            // has no scope node. The fix added null guards and a reproduction test.
+            //
+            // The agent incorrectly created a rule about "HTML Elements and Scope
+            // Nodes" — but the fix is now in the code (null guards) and verified by
+            // a test, so the rule is redundant. Per guidance: "The specific bug
+            // being fixed (it will be resolved; the rule would be immediately stale)"
+            // and "Any requirements or information that can now be identified by
+            // the code."
+            //
+            // We rebuild the context using the CURRENT guidance template + the
+            // fixture's transcript so that guidance improvements are tested.
+            const fixture = loadCapturedFixture('b4e050b8-conv');
+            const snippets = extractSnippetsFromFixture(fixture);
+            tempProject = setupTempProject({
+                sourceFiles: {
+                    'packages/ai/src/lib/dataStructure/ScopeDataStructure.ts': [
+                        'export class ScopeDataStructure {',
+                        '  addComplexSourcePathVariables() {',
+                        '    // Guard: HTML elements create equivalencies but have no scope node',
+                        '    const usageScopeNode = this.getScopeOrFunctionCallInfo(scopeNodeName);',
+                        '    if (!usageScopeNode) continue;',
+                        '  }',
+                        '  captureComplexSourcePaths() {',
+                        '    const usageScopeNode = this.getScopeOrFunctionCallInfo(scopeNodeName);',
+                        '    if (!usageScopeNode) continue;',
+                        '  }',
+                        '}',
+                    ].join('\n'),
+                    'packages/ai/src/lib/dataStructure/__tests__/analyzeScopeNoAI_memoryAudit.test.ts': [
+                        "describe('MemoryAuditSection', () => {",
+                        "  it('handles HTML element equivalencies without crashing', () => {",
+                        '    // Reproduction test for HTML intrinsic elements like <input>',
+                        '    // that create equivalencies but never register as scope nodes',
+                        '    expect(result).toBeDefined();',
+                        '  });',
+                        '});',
+                    ].join('\n'),
+                },
+            });
+            const modifiedFiles = new Set([
+                ['packages/ai/src/lib/dataStructure/ScopeDataStructure.ts', 'Edit'],
+                [
+                    'packages/ai/src/lib/dataStructure/__tests__/analyzeScopeNoAI_memoryAudit.test.ts',
+                    'Write',
+                ],
+            ]);
+            const contextContent = buildConversationContext(snippets, modifiedFiles);
+            const contextFile = path.join(tempProject.dir, '.context.md');
+            fs.writeFileSync(contextFile, contextContent);
+            const notificationFile = path.join(tempProject.dir, 'rule-notification-conversation.md');
+            const before = await snapshotRules(tempProject.rulesDir);
+            const prompt = buildConversationPrompt(contextFile, tempProject.dir, notificationFile);
+            runClaude({
+                prompt,
+                cwd: tempProject.dir,
+                saveOutput: { dir: OUTPUT_DIR, label: 'fixture-b4e050b8-no-rule' },
+            });
+            const after = await snapshotRules(tempProject.rulesDir);
+            const changes = getRulesChanges(before, after);
+            // No rules should be created — this was a bug fix session.
+            // The null guards and reproduction test are now in the code,
+            // so the information is fully discernible from reading the source.
+            // The guidance explicitly says not to document "the specific bug
+            // being fixed" or information "that can now be identified by the code."
+            expect(changes.created.length).toBe(0);
+        }, 180000);
+    });
+});
+//# sourceMappingURL=ruleReflectionE2E.test.js.map

package/codeyam-cli/src/utils/ruleReflection/__tests__/integration/ruleReflectionE2E.test.js.map

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

package/codeyam-cli/src/utils/ruleReflection/__tests__/promptBuilder.test.js

@@ -0,0 +1,115 @@
+import { buildStaleRulesPrompt, buildConversationPrompt, buildInterruptionPrompt, } from "../promptBuilder.js";
+describe('promptBuilder', () => {
+    describe('buildStaleRulesPrompt', () => {
+        const contextFile = '/tmp/claude-rule-markers/abc123-stale.context';
+        const projectDir = '/home/user/my-project';
+        const notificationFile = '/tmp/claude-rule-markers/rule-notification-stale.md';
+        let prompt;
+        beforeAll(() => {
+            prompt = buildStaleRulesPrompt(contextFile, projectDir, notificationFile);
+        });
+        it('references instructions.md', () => {
+            expect(prompt).toContain('.codeyam/rules/instructions.md');
+        });
+        it('includes context file path', () => {
+            expect(prompt).toContain(contextFile);
+        });
+        it('includes notification file path', () => {
+            expect(prompt).toContain(notificationFile);
+        });
+        it('includes project dir', () => {
+            expect(prompt).toContain(`The project root is ${projectDir}`);
+        });
+        it('includes codeyam memory touch instruction', () => {
+            expect(prompt).toContain('codeyam memory touch');
+        });
+        it('instructs to read instructions.md first', () => {
+            const firstIdx = prompt.indexOf('.codeyam/rules/instructions.md');
+            const contextIdx = prompt.indexOf(contextFile);
+            expect(firstIdx).toBeLessThan(contextIdx);
+        });
+        it('includes stale rule review steps', () => {
+            expect(prompt).toContain('Review the inline rule content and the diff');
+            expect(prompt).toContain("If the diff is empty or doesn't affect the rule, just run `codeyam memory touch`");
+            expect(prompt).toContain('edit the rule file in .claude/rules/');
+        });
+        it('includes notification format example', () => {
+            expect(prompt).toContain('The background rule-reflection agent updated the following rules:');
+        });
+        it('instructs to still notify for audit-only changes', () => {
+            expect(prompt).toContain('still write the notification');
+        });
+        it('instructs to only write notification when rules changed', () => {
+            expect(prompt).toContain('Only write the notification file when rules are changed.');
+        });
+        it('does NOT mention conversation analysis', () => {
+            expect(prompt).not.toContain('conversation review section');
+            expect(prompt).not.toContain('Analyze the conversation transcript');
+        });
+    });
+    describe('buildConversationPrompt', () => {
+        const contextFile = '/tmp/claude-rule-markers/abc123-conversation.context';
+        const projectDir = '/home/user/my-project';
+        const notificationFile = '/tmp/claude-rule-markers/rule-notification-conversation.md';
+        let prompt;
+        beforeAll(() => {
+            prompt = buildConversationPrompt(contextFile, projectDir, notificationFile);
+        });
+        it('references instructions.md', () => {
+            expect(prompt).toContain('.codeyam/rules/instructions.md');
+        });
+        it('includes context file path', () => {
+            expect(prompt).toContain(contextFile);
+        });
+        it('includes notification file path', () => {
+            expect(prompt).toContain(notificationFile);
+        });
+        it('includes project dir', () => {
+            expect(prompt).toContain(`The project root is ${projectDir}`);
+        });
+        it('mentions conversation analysis topics', () => {
+            expect(prompt).toContain('Analyze the conversation transcript');
+            expect(prompt).toContain('User corrections');
+            expect(prompt).toContain('Investigation results');
+            expect(prompt).toContain('Architecture and relationships');
+        });
+        it('does NOT mention stale rule review steps', () => {
+            expect(prompt).not.toContain('Review the inline rule content and the diff');
+            expect(prompt).not.toContain('codeyam memory touch');
+            expect(prompt).not.toContain("If the diff is empty or doesn't affect the rule");
+        });
+    });
+    describe('buildInterruptionPrompt', () => {
+        const contextFile = '/tmp/claude-rule-markers/abc123-interruption.context';
+        const projectDir = '/home/user/my-project';
+        const notificationFile = '/tmp/claude-rule-markers/rule-notification-interruption.md';
+        let prompt;
+        beforeAll(() => {
+            prompt = buildInterruptionPrompt(contextFile, projectDir, notificationFile);
+        });
+        it('references instructions.md', () => {
+            expect(prompt).toContain('.codeyam/rules/instructions.md');
+        });
+        it('includes context file path', () => {
+            expect(prompt).toContain(contextFile);
+        });
+        it('includes notification file path', () => {
+            expect(prompt).toContain(notificationFile);
+        });
+        it('includes project dir', () => {
+            expect(prompt).toContain(`The project root is ${projectDir}`);
+        });
+        it('mentions interruption as a strong confusion signal', () => {
+            expect(prompt).toContain('interrupted Claude mid-response');
+        });
+        it('mentions analyzing both interrupted output and follow-up', () => {
+            expect(prompt).toContain('interrupted output');
+            expect(prompt).toContain('follow-up');
+        });
+        it('does NOT mention stale rule review steps', () => {
+            expect(prompt).not.toContain('Review the inline rule content and the diff');
+            expect(prompt).not.toContain('codeyam memory touch');
+        });
+    });
+});
+//# sourceMappingURL=promptBuilder.test.js.map

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

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