@codeyam/codeyam-cli 0.1.0-staging.dd216e0 → 0.1.0-staging.e057775

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

@@ -0,0 +1,113 @@
+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('codeyam memory touch');
+            expect(prompt).toContain('SPECIFIC rule paths');
+            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 write notification even for audit-only changes', () => {
+            expect(prompt).toContain('even if you only ran `codeyam memory touch` without content changes');
+        });
+        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":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAErD,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;QAC/B,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,CAAC;YACnC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,OAAO,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;YACnD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACxC,2CAA2C;YAC3C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAElD,4BAA4B;YAC5B,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;YACtE,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YAC/C,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,OAAO,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,2BAA2B,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACvD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;YAC/C,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;YAEtD,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,OAAO,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,0CAA0C;YAC1C,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;YAClC,MAAM,OAAO,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;YAEpD,wBAAwB;YACxB,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC5C,MAAM,UAAU,GAAG,UAAU,CAAC,gBAAgB,CAAC;YAE/C,mCAAmC;YACnC,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC1D,MAAM,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC3C,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,OAAO,GAAG,WAAW,CAAC,sBAAsB,CAAC,CAAC;YACpD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;YACzE,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,OAAO,GACX,qOAAqO,CAAC;YACxO,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,qCAAqC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;YACzC,MAAM,OAAO,GACX,+GAA+G,CAAC;YAClH,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,OAAO,GACX,gFAAgF,CAAC;YACnF,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;YACnE,MAAM,KAAK,GAAG;gBACZ,4FAA4F;gBAC5F,2GAA2G;aAC5G,CAAC;YACF,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,OAAO,GACX,mJAAmJ,CAAC;YACtJ,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACxC,2DAA2D;YAC3D,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;YACvD,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAExC,MAAM,iBAAiB,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC9C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAC9B,CAAC;YACF,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;YACpD,yDAAyD;YACzD,MAAM,CACJ,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3B,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAC1C,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC7B,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE;oBACP,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;iBAC3C;aACF,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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"}

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

@@ -0,0 +1,116 @@
+import { readFileSync } from 'fs';
+import path from 'path';
+const TEMPLATES_DIR = path.resolve(__dirname, '../../../templates/prompts');
+let _guidanceCache = null;
+function loadGuidance() {
+    if (_guidanceCache === null) {
+        _guidanceCache = readFileSync(path.join(TEMPLATES_DIR, 'conversation-guidance.txt'), 'utf-8');
+    }
+    return _guidanceCache;
+}
+function buildStaleRulesSection(staleRules) {
+    const parts = [];
+    for (const rule of staleRules) {
+        parts.push(`### ${rule.name}`);
+        if (rule.rule_content) {
+            parts.push('  Rule content:');
+            for (const line of rule.rule_content.split('\n')) {
+                parts.push(`    ${line}`);
+            }
+        }
+        if (rule.newest_file) {
+            parts.push(`  Changed file: ${rule.newest_file}`);
+        }
+        if (rule.file_modified) {
+            parts.push(`  File modified: ${rule.file_modified}`);
+        }
+        if (rule.last_audited) {
+            parts.push(`  Last audited: ${rule.last_audited}`);
+        }
+        if (rule.diff) {
+            parts.push('  Changes:');
+            for (const line of rule.diff.split('\n')) {
+                parts.push(`    ${line}`);
+            }
+        }
+        parts.push('');
+    }
+    return parts;
+}
+function buildConversationSection(snippets, modifiedFiles) {
+    const parts = [];
+    parts.push(loadGuidance());
+    if (modifiedFiles.size > 0) {
+        parts.push('Files modified this session:');
+        const sorted = Array.from(modifiedFiles).sort((a, b) => a[0].localeCompare(b[0]));
+        for (const [filePath, toolName] of sorted) {
+            parts.push(`- ${filePath} (${toolName})`);
+        }
+        parts.push('');
+    }
+    parts.push('### Session transcript\n');
+    const summaryLines = [];
+    for (const snippet of snippets) {
+        const content = snippet.content.replace(/\n/g, ' ');
+        summaryLines.push(`[${snippet.role}]: ${content}`);
+    }
+    parts.push(summaryLines.join('\n'));
+    return parts;
+}
+/**
+ * Build context for stale rules review only.
+ * Returns the stale rules section string, or empty string if no stale rules.
+ */
+export function buildStaleRulesContext(staleRules) {
+    if (staleRules.length === 0) {
+        return '';
+    }
+    const parts = [];
+    parts.push('# Reflection Step\n');
+    parts.push('Please review the stale rules below to determine if any need updating based on recent code changes.\n');
+    parts.push('Please show your thinking regarding the stale rules.\n');
+    parts.push('## Stale Rules to Review\n');
+    parts.push('The following rules have files that changed since the rule was last reviewed.');
+    parts.push('For each rule, review the rule content and the diff of changes, then:');
+    parts.push('1. Determine if the rule content needs updating based on the code changes');
+    parts.push('2. Update the rule if needed');
+    parts.push('3. Run `codeyam memory touch <rule-path1> <rule-path2> ...` with the SPECIFIC rule paths you reviewed to mark them as audited\n');
+    parts.push(...buildStaleRulesSection(staleRules));
+    return parts.join('\n');
+}
+/**
+ * Build context for conversation review only.
+ * Returns the conversation review section string, or empty string if no snippets.
+ */
+export function buildConversationContext(snippets, modifiedFiles) {
+    if (snippets.length === 0) {
+        return '';
+    }
+    const parts = [];
+    parts.push('## Conversation Review\n');
+    parts.push('Review this session for rule-worthy learnings: architectural decisions, tribal knowledge, ' +
+        'confusion, mistakes, or corrections that future sessions would benefit from knowing.\n');
+    parts.push(...buildConversationSection(snippets, modifiedFiles));
+    return parts.join('\n');
+}
+/**
+ * Build context for an interrupted session.
+ * Includes the conversation transcript up to the interruption point,
+ * plus the user's follow-up prompt that signals what went wrong.
+ * Returns empty string if no snippets.
+ */
+export function buildInterruptionContext(snippets, followUpPrompt, modifiedFiles) {
+    if (snippets.length === 0) {
+        return '';
+    }
+    const parts = [];
+    parts.push('## Interruption Review\n');
+    parts.push('The user interrupted Claude mid-response — a strong signal of confusion or misunderstanding. ' +
+        "Review the interrupted conversation and the user's follow-up to identify rule-worthy learnings.\n");
+    parts.push(...buildConversationSection(snippets, modifiedFiles));
+    parts.push('');
+    parts.push("### User's follow-up after interruption\n");
+    parts.push(followUpPrompt);
+    return parts.join('\n');
+}
+//# sourceMappingURL=contextBuilder.js.map

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

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

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

@@ -0,0 +1,5 @@
+export { CONFUSION_SIGNALS, hasConfusionSignals } from "./confusionDetector.js";
+export { parseTranscript } from "./transcriptParser.js";
+export { buildStaleRulesContext, buildConversationContext, buildInterruptionContext, } from "./contextBuilder.js";
+export { buildStaleRulesPrompt, buildConversationPrompt, buildInterruptionPrompt, } from "./promptBuilder.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/ruleReflection/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,iBAAiB,CAAC"}

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

@@ -0,0 +1,44 @@
+import { readFileSync } from 'fs';
+import path from 'path';
+const TEMPLATES_DIR = path.resolve(__dirname, '../../../templates/prompts');
+function loadTemplate(name, vars) {
+    let text = readFileSync(path.join(TEMPLATES_DIR, name), 'utf-8');
+    for (const [key, value] of Object.entries(vars)) {
+        text = text.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value);
+    }
+    return text;
+}
+/**
+ * Build the prompt for the stale rules `claude -p` invocation.
+ * Reads from templates/prompts/stale-rules-prompt.txt.
+ */
+export function buildStaleRulesPrompt(contextFilePath, projectDir, notificationFilePath) {
+    return loadTemplate('stale-rules-prompt.txt', {
+        CONTEXT_FILE: contextFilePath,
+        NOTIFICATION_FILE: notificationFilePath,
+        PROJECT_DIR: projectDir,
+    });
+}
+/**
+ * Build the prompt for the conversation review `claude -p` invocation.
+ * Reads from templates/prompts/conversation-prompt.txt.
+ */
+export function buildConversationPrompt(contextFilePath, projectDir, notificationFilePath) {
+    return loadTemplate('conversation-prompt.txt', {
+        CONTEXT_FILE: contextFilePath,
+        NOTIFICATION_FILE: notificationFilePath,
+        PROJECT_DIR: projectDir,
+    });
+}
+/**
+ * Build the prompt for the interruption review `claude -p` invocation.
+ * Reads from templates/prompts/interruption-prompt.txt.
+ */
+export function buildInterruptionPrompt(contextFilePath, projectDir, notificationFilePath) {
+    return loadTemplate('interruption-prompt.txt', {
+        CONTEXT_FILE: contextFilePath,
+        NOTIFICATION_FILE: notificationFilePath,
+        PROJECT_DIR: projectDir,
+    });
+}
+//# sourceMappingURL=promptBuilder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"promptBuilder.js","sourceRoot":"","sources":["../../../../../src/utils/ruleReflection/promptBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;AAE5E,SAAS,YAAY,CAAC,IAAY,EAAE,IAA4B;IAC9D,IAAI,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,SAAS,GAAG,QAAQ,EAAE,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,eAAuB,EACvB,UAAkB,EAClB,oBAA4B;IAE5B,OAAO,YAAY,CAAC,wBAAwB,EAAE;QAC5C,YAAY,EAAE,eAAe;QAC7B,iBAAiB,EAAE,oBAAoB;QACvC,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,UAAkB,EAClB,oBAA4B;IAE5B,OAAO,YAAY,CAAC,yBAAyB,EAAE;QAC7C,YAAY,EAAE,eAAe;QAC7B,iBAAiB,EAAE,oBAAoB;QACvC,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CACrC,eAAuB,EACvB,UAAkB,EAClB,oBAA4B;IAE5B,OAAO,YAAY,CAAC,yBAAyB,EAAE;QAC7C,YAAY,EAAE,eAAe;QAC7B,iBAAiB,EAAE,oBAAoB;QACvC,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,85 @@
+/**
+ * Parse a JSONL transcript string and extract conversation snippets and modified files.
+ * Ported from rule-reflection-hook.py get_conversation_context().
+ *
+ * @param jsonlContent - Raw JSONL string (one JSON object per line)
+ * @param lastLine - Line offset to start from (skip already-processed lines)
+ */
+export function parseTranscript(jsonlContent, lastLine = 0) {
+    const allLines = jsonlContent.split('\n').filter((line) => line.trim());
+    const currentLineCount = allLines.length;
+    const newLines = allLines.slice(lastLine);
+    if (newLines.length === 0) {
+        return {
+            userTurnCount: 0,
+            snippets: [],
+            modifiedFiles: new Set(),
+            currentLineCount,
+        };
+    }
+    let userTurnCount = 0;
+    const snippets = [];
+    const modifiedFiles = new Set();
+    for (const line of newLines) {
+        let obj;
+        try {
+            obj = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const msgType = obj.type;
+        if (msgType !== 'user' && msgType !== 'assistant') {
+            continue;
+        }
+        const message = obj.message;
+        if (!message)
+            continue;
+        const content = message.content;
+        const isExternalUser = msgType === 'user' && obj.userType === 'external';
+        if (typeof content === 'string') {
+            if (obj.isMeta || content.length < 20) {
+                continue;
+            }
+            if (content.startsWith('[{') || content.includes('<tool_result')) {
+                continue;
+            }
+            if (isExternalUser && !content.startsWith('<')) {
+                userTurnCount++;
+            }
+            snippets.push({
+                role: message.role || msgType,
+                content,
+            });
+        }
+        else if (Array.isArray(content)) {
+            for (const item of content) {
+                if (typeof item !== 'object' || item === null) {
+                    continue;
+                }
+                const typedItem = item;
+                // Extract text snippets
+                if (typedItem.type === 'text') {
+                    const text = typedItem.text || '';
+                    if (text.length > 20) {
+                        snippets.push({
+                            role: message.role || msgType,
+                            content: text,
+                        });
+                    }
+                }
+                // Track file modifications from tool_use entries
+                if (typedItem.type === 'tool_use') {
+                    const toolName = typedItem.name || '';
+                    const toolInput = typedItem.input || {};
+                    if ((toolName === 'Edit' || toolName === 'Write') &&
+                        typeof toolInput.file_path === 'string') {
+                        modifiedFiles.add([toolInput.file_path, toolName]);
+                    }
+                }
+            }
+        }
+    }
+    return { userTurnCount, snippets, modifiedFiles, currentLineCount };
+}
+//# sourceMappingURL=transcriptParser.js.map

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

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

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

@@ -0,0 +1,5 @@
+/**
+ * Shared types for rule reflection prompt building and testing.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/utils/ruleReflection/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}