@codeyam/codeyam-cli 0.1.0-staging.76566f9 → 0.1.0-staging.79ef713

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

@@ -0,0 +1,285 @@
+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";
+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',
+                rule_timestamp: '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',
+                rule_timestamp: '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);
+    });
+});
+//# 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 timestamp-only changes', () => {
+            expect(prompt).toContain('If you only touched timestamps without content changes, still write the notification.');
+        });
+        it('instructs not to write notification when no changes', () => {
+            expect(prompt).toContain('If no rules were changed at all, do NOT write the notification file.');
+        });
+        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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"}

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

@@ -0,0 +1,127 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseTranscript } from "../transcriptParser.js";
+const fixturesDir = path.join(__dirname, 'fixtures');
+function loadFixture(name) {
+    return fs.readFileSync(path.join(fixturesDir, name), 'utf-8');
+}
+describe('transcriptParser', () => {
+    describe('parseTranscript', () => {
+        it('returns empty results for empty input', () => {
+            const result = parseTranscript('');
+            expect(result.userTurnCount).toBe(0);
+            expect(result.snippets).toEqual([]);
+            expect(result.modifiedFiles.size).toBe(0);
+            expect(result.currentLineCount).toBe(0);
+        });
+        it('returns empty results for empty-session fixture', () => {
+            const content = loadFixture('empty-session.jsonl');
+            const result = parseTranscript(content);
+            // Only a system message, no user/assistant
+            expect(result.userTurnCount).toBe(0);
+            expect(result.snippets).toEqual([]);
+        });
+        it('extracts snippets from simple session', () => {
+            const content = loadFixture('simple-session.jsonl');
+            const result = parseTranscript(content);
+            expect(result.userTurnCount).toBe(2);
+            expect(result.snippets.length).toBeGreaterThan(0);
+            // Should have user messages
+            const userSnippets = result.snippets.filter((s) => s.role === 'user');
+            expect(userSnippets.length).toBeGreaterThan(0);
+            expect(userSnippets[0].content).toContain('logout button');
+        });
+        it('tracks modified files from Edit/Write tool_use', () => {
+            const content = loadFixture('simple-session.jsonl');
+            const result = parseTranscript(content);
+            const modifiedArray = Array.from(result.modifiedFiles);
+            expect(modifiedArray.length).toBe(1);
+            expect(modifiedArray[0]).toEqual(['src/components/NavBar.tsx', 'Edit']);
+        });
+        it('tracks both Edit and Write tool uses', () => {
+            const content = loadFixture('user-correction.jsonl');
+            const result = parseTranscript(content);
+            const modifiedArray = Array.from(result.modifiedFiles);
+            const filePaths = modifiedArray.map(([p]) => p);
+            expect(filePaths).toContain('src/api/auth.ts');
+            expect(filePaths).toContain('src/api/sessionAuth.ts');
+            const toolNames = modifiedArray.map(([, t]) => t);
+            expect(toolNames).toContain('Edit');
+            expect(toolNames).toContain('Write');
+        });
+        it('counts user turns from external users only', () => {
+            const content = loadFixture('user-correction.jsonl');
+            const result = parseTranscript(content);
+            // 3 external user messages in the fixture
+            expect(result.userTurnCount).toBe(3);
+        });
+        it('respects lastLine offset', () => {
+            const content = loadFixture('simple-session.jsonl');
+            // Parse all lines first
+            const fullResult = parseTranscript(content);
+            const totalLines = fullResult.currentLineCount;
+            // Parse with offset past all lines
+            const offsetResult = parseTranscript(content, totalLines);
+            expect(offsetResult.userTurnCount).toBe(0);
+            expect(offsetResult.snippets).toEqual([]);
+        });
+        it('returns correct currentLineCount', () => {
+            const content = loadFixture('simple-session.jsonl');
+            const result = parseTranscript(content);
+            const expectedLines = content.split('\n').filter((l) => l.trim()).length;
+            expect(result.currentLineCount).toBe(expectedLines);
+        });
+        it('skips malformed JSON lines gracefully', () => {
+            const content = '{"type":"user","userType":"external","message":{"role":"user","content":"Hello this is a valid message"}}\nnot valid json\n{"type":"assistant","message":{"role":"assistant","content":"Thanks for reaching out, how can I help?"}}';
+            const result = parseTranscript(content);
+            // Should have parsed the valid lines
+            expect(result.snippets.length).toBe(2);
+        });
+        it('skips messages with isMeta flag', () => {
+            const content = '{"type":"user","isMeta":true,"message":{"role":"user","content":"This is a meta message with enough length"}}';
+            const result = parseTranscript(content);
+            expect(result.snippets).toEqual([]);
+        });
+        it('skips short string content (< 20 chars)', () => {
+            const content = '{"type":"user","userType":"external","message":{"role":"user","content":"ok"}}';
+            const result = parseTranscript(content);
+            expect(result.snippets).toEqual([]);
+            expect(result.userTurnCount).toBe(0);
+        });
+        it('skips content starting with [{ or containing <tool_result', () => {
+            const lines = [
+                '{"type":"user","message":{"role":"user","content":"[{something json-like content here}]"}}',
+                '{"type":"user","message":{"role":"user","content":"some text <tool_result>blah</tool_result> more text"}}',
+            ];
+            const result = parseTranscript(lines.join('\n'));
+            expect(result.snippets).toEqual([]);
+        });
+        it('does not count user turns for messages starting with <', () => {
+            const content = '{"type":"user","userType":"external","message":{"role":"user","content":"<system>This is a system-injected message with enough length</system>"}}';
+            const result = parseTranscript(content);
+            // Should still create a snippet but not count as user turn
+            expect(result.userTurnCount).toBe(0);
+            expect(result.snippets.length).toBe(1);
+        });
+        it('extracts text from list content items', () => {
+            const content = loadFixture('debugging-session.jsonl');
+            const result = parseTranscript(content);
+            const assistantSnippets = result.snippets.filter((s) => s.role === 'assistant');
+            expect(assistantSnippets.length).toBeGreaterThan(0);
+            // Should have extracted text from the text content items
+            expect(assistantSnippets.some((s) => s.content.includes('circular dependency'))).toBe(true);
+        });
+        it('skips text content items shorter than 20 chars', () => {
+            const content = JSON.stringify({
+                type: 'assistant',
+                message: {
+                    role: 'assistant',
+                    content: [{ type: 'text', text: 'short' }],
+                },
+            });
+            const result = parseTranscript(content);
+            expect(result.snippets).toEqual([]);
+        });
+    });
+});
+//# sourceMappingURL=transcriptParser.test.js.map

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

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

package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js

@@ -0,0 +1,50 @@
+/**
+ * Signals that indicate confusion, mistakes, or user corrections.
+ * Ported from rule-reflection-hook.py CONFUSION_SIGNALS.
+ */
+export const CONFUSION_SIGNALS = [
+    'no,',
+    'no ',
+    "that's not",
+    'thats not',
+    'that is not',
+    'wrong',
+    'incorrect',
+    'actually,',
+    'actually ',
+    'i meant',
+    'i mean',
+    'not what i',
+    'stop',
+    'wait',
+    "don't do",
+    'dont do',
+    "shouldn't",
+    'should not',
+    'try again',
+    'let me clarify',
+    'to clarify',
+    'that broke',
+    'that failed',
+    'error',
+    'bug',
+];
+/**
+ * Check if conversation snippets contain signals of confusion or user corrections.
+ * Only checks user messages (skips assistant messages).
+ */
+export function hasConfusionSignals(snippets) {
+    for (const snippet of snippets) {
+        if (snippet.role !== 'user') {
+            continue;
+        }
+        const contentLower = snippet.content.toLowerCase();
+        for (const signal of CONFUSION_SIGNALS) {
+            if (contentLower.includes(signal)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
+//# sourceMappingURL=confusionDetector.js.map

package/codeyam-cli/src/utils/ruleReflection/confusionDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confusionDetector.js","sourceRoot":"","sources":["../../../../../src/utils/ruleReflection/confusionDetector.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,KAAK;IACL,KAAK;IACL,YAAY;IACZ,WAAW;IACX,aAAa;IACb,OAAO;IACP,WAAW;IACX,WAAW;IACX,WAAW;IACX,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,WAAW;IACX,YAAY;IACZ,WAAW;IACX,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,aAAa;IACb,OAAO;IACP,KAAK;CACN,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAA+B;IACjE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACnD,KAAK,MAAM,MAAM,IAAI,iBAAiB,EAAE,CAAC;YACvC,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}