@codeyam/codeyam-cli 0.1.0-staging.483fdc2 → 0.1.0-staging.4c0c3c9

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

@@ -0,0 +1,82 @@
+import { hasConfusionSignals, CONFUSION_SIGNALS } from "../confusionDetector.js";
+describe('confusionDetector', () => {
+    describe('hasConfusionSignals', () => {
+        it('returns false for an empty array', () => {
+            expect(hasConfusionSignals([])).toBe(false);
+        });
+        it('returns false for a clean conversation', () => {
+            const snippets = [
+                { role: 'user', content: 'Please add a new button to the page' },
+                { role: 'assistant', content: 'Sure, I will add a button component.' },
+                { role: 'user', content: 'Great, thanks!' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(false);
+        });
+        it('detects "no," signal', () => {
+            const snippets = [
+                { role: 'user', content: "No, that's the wrong file" },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('detects "actually," signal', () => {
+            const snippets = [
+                { role: 'user', content: 'Actually, I wanted the other approach' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('detects "wrong" signal', () => {
+            const snippets = [
+                { role: 'user', content: 'That is wrong, please fix it' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('detects "try again" signal', () => {
+            const snippets = [
+                { role: 'user', content: 'Try again with the correct parameters' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('detects "that broke" signal', () => {
+            const snippets = [
+                { role: 'user', content: 'That broke the build' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('detects "error" signal', () => {
+            const snippets = [
+                { role: 'user', content: 'I see an error in the console' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('is case-insensitive', () => {
+            const snippets = [
+                { role: 'user', content: 'ACTUALLY, that is WRONG' },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it('skips assistant messages even if they contain signals', () => {
+            const snippets = [
+                {
+                    role: 'assistant',
+                    content: "I made an error. Let me try again. That's not correct.",
+                },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(false);
+        });
+        it('detects signal in later messages', () => {
+            const snippets = [
+                { role: 'user', content: 'Please update the config' },
+                { role: 'assistant', content: 'Done, I updated the config.' },
+                { role: 'user', content: "No, that's not what I meant" },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+        it.each(CONFUSION_SIGNALS)('detects signal: "%s"', (signal) => {
+            const snippets = [
+                { role: 'user', content: `I think ${signal} something here` },
+            ];
+            expect(hasConfusionSignals(snippets)).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=confusionDetector.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"confusionDetector.test.js","sourceRoot":"","sources":["../../../../../../src/utils/ruleReflection/__tests__/confusionDetector.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9E,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,qCAAqC,EAAE;gBAChE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,sCAAsC,EAAE;gBACtE,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,EAAE;aAC5C,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;YAC9B,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,2BAA2B,EAAE;aACvD,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uCAAuC,EAAE;aACnE,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,8BAA8B,EAAE;aAC1D,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;YACpC,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,uCAAuC,EAAE;aACnE,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE;aAClD,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,+BAA+B,EAAE;aAC3D,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,EAAE;aACrD,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;YAC/D,MAAM,QAAQ,GAA0B;gBACtC;oBACE,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,wDAAwD;iBAClE;aACF,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC1C,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE;gBACrD,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,6BAA6B,EAAE;gBAC7D,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B,EAAE;aACzD,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,sBAAsB,EAAE,CAAC,MAAM,EAAE,EAAE;YAC5D,MAAM,QAAQ,GAA0B;gBACtC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,MAAM,iBAAiB,EAAE;aAC9D,CAAC;YACF,MAAM,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,230 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildStaleRulesContext, buildConversationContext, buildInterruptionContext, } from "../contextBuilder.js";
+const fixturesDir = path.join(__dirname, 'fixtures');
+function loadStaleRules() {
+    return JSON.parse(fs.readFileSync(path.join(fixturesDir, 'stale-rules.json'), 'utf-8'));
+}
+describe('contextBuilder', () => {
+    describe('buildStaleRulesContext', () => {
+        it('returns empty string when no stale rules', () => {
+            const result = buildStaleRulesContext([]);
+            expect(result).toBe('');
+        });
+        it('builds stale rules section with all metadata', () => {
+            const staleRules = loadStaleRules();
+            const result = buildStaleRulesContext(staleRules);
+            expect(result).toContain('# Reflection Step');
+            expect(result).toContain('## Stale Rules to Review');
+            expect(result).toContain('### api-auth-patterns.md');
+            expect(result).toContain('### build-config.md');
+            expect(result).toContain('Rule content:');
+            expect(result).toContain('API Authentication');
+            expect(result).toContain('Changes:');
+            expect(result).toContain('validateSession');
+            expect(result).toContain('Changed file: src/api/auth.ts');
+            expect(result).toContain('Last audited: 2026-01-15T00:00:00Z');
+        });
+        it('includes diff in stale rules section', () => {
+            const staleRules = loadStaleRules();
+            const result = buildStaleRulesContext(staleRules);
+            expect(result).toContain('Changes:');
+            expect(result).toContain('validateSession');
+        });
+        it('includes file metadata', () => {
+            const staleRules = loadStaleRules();
+            const result = buildStaleRulesContext(staleRules);
+            expect(result).toContain('Changed file: src/api/auth.ts');
+            expect(result).toContain('File modified: 2026-02-01T10:30:00Z');
+            expect(result).toContain('Last audited: 2026-01-15T00:00:00Z');
+        });
+        it('includes Build Configuration rule content', () => {
+            const staleRules = loadStaleRules();
+            const result = buildStaleRulesContext(staleRules);
+            expect(result).toContain('Build Configuration');
+        });
+        it('does NOT contain conversation review content', () => {
+            const staleRules = loadStaleRules();
+            const result = buildStaleRulesContext(staleRules);
+            expect(result).not.toContain('## Conversation Review');
+            expect(result).not.toContain('### Your goal');
+            expect(result).not.toContain('### Session transcript');
+            expect(result).not.toContain('User corrections or redirections');
+        });
+    });
+    describe('buildConversationContext', () => {
+        it('returns empty string when no snippets', () => {
+            const result = buildConversationContext([], new Set());
+            expect(result).toBe('');
+        });
+        it('builds conversation review section', () => {
+            const snippets = [
+                { role: 'user', content: 'Please update the configuration file' },
+                { role: 'assistant', content: 'I will update the config now.' },
+            ];
+            const result = buildConversationContext(snippets, new Set());
+            expect(result).toContain('## Conversation Review');
+            expect(result).toContain('### Your goal');
+            expect(result).toContain('### Session transcript');
+            expect(result).toContain('[user]: Please update the configuration file');
+            expect(result).toContain('[assistant]: I will update the config now.');
+        });
+        it('does NOT contain stale rules content', () => {
+            const snippets = [
+                { role: 'user', content: 'Please help me with this code' },
+            ];
+            const result = buildConversationContext(snippets, new Set());
+            expect(result).not.toContain('# Reflection Step');
+            expect(result).not.toContain('## Stale Rules to Review');
+        });
+        it('includes modified files', () => {
+            const snippets = [
+                { role: 'user', content: 'Please fix the auth module for me' },
+            ];
+            const modifiedFiles = new Set([
+                ['src/api/auth.ts', 'Edit'],
+                ['src/api/session.ts', 'Write'],
+            ]);
+            const result = buildConversationContext(snippets, modifiedFiles);
+            expect(result).toContain('Files modified this session:');
+            expect(result).toContain('- src/api/auth.ts (Edit)');
+            expect(result).toContain('- src/api/session.ts (Write)');
+        });
+        it('sorts modified files alphabetically', () => {
+            const snippets = [
+                { role: 'user', content: 'Please fix these files for the feature' },
+            ];
+            const modifiedFiles = new Set([
+                ['src/z-file.ts', 'Edit'],
+                ['src/a-file.ts', 'Write'],
+                ['src/m-file.ts', 'Edit'],
+            ]);
+            const result = buildConversationContext(snippets, modifiedFiles);
+            const aIdx = result.indexOf('src/a-file.ts');
+            const mIdx = result.indexOf('src/m-file.ts');
+            const zIdx = result.indexOf('src/z-file.ts');
+            expect(aIdx).toBeLessThan(mIdx);
+            expect(mIdx).toBeLessThan(zIdx);
+        });
+        it('replaces newlines with spaces in transcript snippets', () => {
+            const snippets = [
+                { role: 'user', content: 'Line one\nLine two\nLine three' },
+            ];
+            const result = buildConversationContext(snippets, new Set());
+            expect(result).toContain('[user]: Line one Line two Line three');
+        });
+        it('includes rule creation guidance', () => {
+            const snippets = [
+                { role: 'user', content: 'Please help me with the build system setup' },
+            ];
+            const result = buildConversationContext(snippets, new Set());
+            expect(result).toContain('User corrections or redirections');
+            expect(result).toContain('Investigation results and debugging knowledge');
+            expect(result).toContain('What makes a rule valuable');
+            expect(result).toContain('.codeyam/rules/instructions.md');
+        });
+    });
+    describe('buildInterruptionContext', () => {
+        it('returns empty string when no snippets', () => {
+            const result = buildInterruptionContext([], 'What should I do instead?', new Set());
+            expect(result).toBe('');
+        });
+        it('builds interruption context with follow-up prompt', () => {
+            const snippets = [
+                {
+                    role: 'user',
+                    content: 'Please refactor the database module to use connection pooling',
+                },
+                {
+                    role: 'assistant',
+                    content: "I'll refactor the database module to use connection pooling.",
+                },
+                {
+                    role: 'assistant',
+                    content: 'I see the current implementation uses a single connection. Let me restructure this to use a connection pool.',
+                },
+            ];
+            const followUpPrompt = "No wait, I don't want a full connection pool rewrite. Just use the pg-pool library we already have as a dependency.";
+            const result = buildInterruptionContext(snippets, followUpPrompt, new Set());
+            expect(result).toContain('## Interruption Review');
+            expect(result).toContain('interrupted Claude mid-response');
+            expect(result).toContain('### Session transcript');
+            expect(result).toContain('[user]: Please refactor the database module');
+            expect(result).toContain('[assistant]:');
+        });
+        it('highlights the user follow-up prompt', () => {
+            const snippets = [
+                {
+                    role: 'user',
+                    content: 'Please update the config file for the project',
+                },
+                {
+                    role: 'assistant',
+                    content: 'I will update the config now with new settings.',
+                },
+            ];
+            const followUpPrompt = 'No, use the existing config format instead';
+            const result = buildInterruptionContext(snippets, followUpPrompt, new Set());
+            expect(result).toContain("### User's follow-up after interruption");
+            expect(result).toContain('No, use the existing config format instead');
+        });
+        it('includes modified files', () => {
+            const snippets = [
+                {
+                    role: 'user',
+                    content: 'Please fix the database connection module here',
+                },
+                {
+                    role: 'assistant',
+                    content: 'Let me fix the connection pooling logic.',
+                },
+            ];
+            const modifiedFiles = new Set([
+                ['src/db/connection.ts', 'Edit'],
+            ]);
+            const result = buildInterruptionContext(snippets, 'Stop, wrong approach', modifiedFiles);
+            expect(result).toContain('Files modified this session:');
+            expect(result).toContain('- src/db/connection.ts (Edit)');
+        });
+        it('includes rule creation guidance', () => {
+            const snippets = [
+                {
+                    role: 'user',
+                    content: 'Please help me refactor the auth module here',
+                },
+                {
+                    role: 'assistant',
+                    content: 'I will restructure the authentication logic.',
+                },
+            ];
+            const result = buildInterruptionContext(snippets, 'Wait, wrong approach', new Set());
+            // Should include the shared guidance from conversation-guidance.txt
+            expect(result).toContain('User corrections or redirections');
+            expect(result).toContain('What makes a rule valuable');
+        });
+        it('does NOT contain stale rules or conversation review headers', () => {
+            const snippets = [
+                {
+                    role: 'user',
+                    content: 'Please update the API endpoints in this project',
+                },
+                {
+                    role: 'assistant',
+                    content: 'I will update all the API endpoints now.',
+                },
+            ];
+            const result = buildInterruptionContext(snippets, 'No stop', new Set());
+            expect(result).not.toContain('# Reflection Step');
+            expect(result).not.toContain('## Stale Rules to Review');
+            expect(result).not.toContain('## Conversation Review');
+        });
+        it('replaces newlines with spaces in transcript snippets', () => {
+            const snippets = [
+                { role: 'assistant', content: 'Line one\nLine two\nLine three' },
+            ];
+            const result = buildInterruptionContext(snippets, 'Stop that', new Set());
+            expect(result).toContain('[assistant]: Line one Line two Line three');
+        });
+    });
+});
+//# sourceMappingURL=contextBuilder.test.js.map

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

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

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

@@ -0,0 +1,67 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseFrontmatter, findMarkdownFiles } from "../../../../rules/parser.js";
+/**
+ * Snapshot all rule files in a directory.
+ */
+export async function snapshotRules(rulesDir) {
+    const files = new Map();
+    const markdownFiles = await findMarkdownFiles(rulesDir);
+    for (const relPath of markdownFiles) {
+        const absPath = path.join(rulesDir, relPath);
+        try {
+            files.set(relPath, fs.readFileSync(absPath, 'utf-8'));
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return { files };
+}
+/**
+ * Diff two rule snapshots to find created, modified, deleted, and unchanged files.
+ */
+export function getRulesChanges(before, after) {
+    const created = [];
+    const modified = [];
+    const deleted = [];
+    const unchanged = [];
+    // Check for new and modified files
+    for (const [filePath, content] of after.files) {
+        const beforeContent = before.files.get(filePath);
+        if (beforeContent === undefined) {
+            created.push(filePath);
+        }
+        else if (beforeContent !== content) {
+            modified.push(filePath);
+        }
+        else {
+            unchanged.push(filePath);
+        }
+    }
+    // Check for deleted files
+    for (const filePath of before.files.keys()) {
+        if (!after.files.has(filePath)) {
+            deleted.push(filePath);
+        }
+    }
+    return { created, modified, deleted, unchanged };
+}
+/**
+ * Assert that a rule file has valid frontmatter with required fields.
+ */
+export function assertValidFrontmatter(content) {
+    const { frontmatter } = parseFrontmatter(content);
+    // Timestamps are now stored in .claude/codeyam-rule-state.json, not in frontmatter
+    expect(frontmatter.paths).toBeDefined();
+    expect(Array.isArray(frontmatter.paths)).toBe(true);
+    expect(frontmatter.paths.length).toBeGreaterThan(0);
+}
+/**
+ * Assert that a rule file's body matches a regex pattern.
+ */
+export function assertRuleContentMatches(content, pattern) {
+    const { body } = parseFrontmatter(content);
+    expect(body).toMatch(pattern);
+}
+//# sourceMappingURL=assertRules.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assertRules.js","sourceRoot":"","sources":["../../../../../../../../src/utils/ruleReflection/__tests__/integration/helpers/assertRules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAM/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,aAAa,GAAG,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAExD,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7C,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC;AASD;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAqB,EACrB,KAAoB;IAEpB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,mCAAmC;IACnC,KAAK,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC9C,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;aAAM,IAAI,aAAa,KAAK,OAAO,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAC3C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAElD,mFAAmF;IACnF,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,WAAW,CAAC,KAAM,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,OAAe;IAEf,MAAM,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,105 @@
+#!/usr/bin/env npx tsx
+/**
+ * Capture a fixture from a real Claude Code session for use in integration tests.
+ *
+ * Usage:
+ *   npx tsx captureFixture.ts --session-id <ID> --output <dir>
+ *
+ * Reads the transcript JSONL from Claude's transcript path, copies current
+ * .claude/rules/, runs `codeyam memory status`, and saves everything as a
+ * structured fixture directory with a manifest.json.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { execSync } from 'child_process';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let sessionId = '';
+    let output = '';
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--session-id' && args[i + 1]) {
+            sessionId = args[++i];
+        }
+        else if (args[i] === '--output' && args[i + 1]) {
+            output = args[++i];
+        }
+    }
+    if (!sessionId || !output) {
+        console.error('Usage: npx tsx captureFixture.ts --session-id <ID> --output <dir>');
+        process.exit(1);
+    }
+    return { sessionId, output };
+}
+function findTranscript(sessionId) {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const claudeDir = path.join(home, '.claude', 'projects');
+    // Search for the transcript in all project directories
+    if (!fs.existsSync(claudeDir)) {
+        throw new Error(`Claude projects directory not found: ${claudeDir}`);
+    }
+    for (const projectDir of fs.readdirSync(claudeDir)) {
+        const transcriptPath = path.join(claudeDir, projectDir, `${sessionId}.jsonl`);
+        if (fs.existsSync(transcriptPath)) {
+            return transcriptPath;
+        }
+    }
+    throw new Error(`Transcript not found for session: ${sessionId}`);
+}
+function copyRules(outputDir) {
+    const rulesDir = path.join(process.cwd(), '.claude', 'rules');
+    const outputRulesDir = path.join(outputDir, 'rules');
+    if (!fs.existsSync(rulesDir)) {
+        console.log('No .claude/rules/ directory found, skipping rules copy.');
+        return;
+    }
+    fs.cpSync(rulesDir, outputRulesDir, { recursive: true });
+    console.log(`Copied rules to ${outputRulesDir}`);
+}
+function getMemoryStatus() {
+    try {
+        return execSync('codeyam memory status', {
+            encoding: 'utf-8',
+            timeout: 30000,
+        });
+    }
+    catch {
+        return 'Failed to get memory status';
+    }
+}
+function main() {
+    const { sessionId, output } = parseArgs();
+    // Create output directory
+    fs.mkdirSync(output, { recursive: true });
+    // Find and copy transcript
+    console.log(`Looking for transcript for session: ${sessionId}`);
+    const transcriptPath = findTranscript(sessionId);
+    const transcriptDest = path.join(output, 'transcript.jsonl');
+    fs.copyFileSync(transcriptPath, transcriptDest);
+    console.log(`Copied transcript to ${transcriptDest}`);
+    // Copy current rules
+    copyRules(output);
+    // Get memory status
+    const memoryStatus = getMemoryStatus();
+    fs.writeFileSync(path.join(output, 'memory-status.txt'), memoryStatus);
+    console.log('Saved memory status');
+    // Create manifest
+    const manifest = {
+        sessionId,
+        capturedAt: new Date().toISOString(),
+        transcriptPath: 'transcript.jsonl',
+        rulesPath: 'rules/',
+        memoryStatusPath: 'memory-status.txt',
+        expectedOutcomes: {
+            description: 'Fill in expected outcomes after reviewing the fixture data',
+            newRules: [],
+            modifiedRules: [],
+            deletedRules: [],
+        },
+    };
+    fs.writeFileSync(path.join(output, 'manifest.json'), JSON.stringify(manifest, null, 2));
+    console.log(`Created manifest at ${path.join(output, 'manifest.json')}`);
+    console.log('\nFixture captured successfully!');
+    console.log('Edit manifest.json to fill in expectedOutcomes for test assertions.');
+}
+main();
+//# sourceMappingURL=captureFixture.js.map

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

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

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

@@ -0,0 +1,34 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const CAPTURED_DIR = path.resolve(__dirname, '../../fixtures/captured');
+/**
+ * Load a captured fixture by name (the short ID directory name).
+ */
+export function loadCapturedFixture(name) {
+    const fixtureDir = path.join(CAPTURED_DIR, name);
+    if (!fs.existsSync(fixtureDir)) {
+        throw new Error(`Captured fixture not found: ${name} (looked in ${fixtureDir})`);
+    }
+    const agentLog = fs.readFileSync(path.join(fixtureDir, 'agent-log.jsonl'), 'utf-8');
+    const contextPath = path.join(fixtureDir, 'context.md');
+    const context = fs.existsSync(contextPath)
+        ? fs.readFileSync(contextPath, 'utf-8')
+        : null;
+    const ruleChanges = JSON.parse(fs.readFileSync(path.join(fixtureDir, 'rule-changes.json'), 'utf-8'));
+    const metadata = JSON.parse(fs.readFileSync(path.join(fixtureDir, 'metadata.json'), 'utf-8'));
+    return { name, agentLog, context, ruleChanges, metadata };
+}
+/**
+ * List all captured fixture directory names.
+ */
+export function listCapturedFixtures() {
+    if (!fs.existsSync(CAPTURED_DIR)) {
+        return [];
+    }
+    return fs
+        .readdirSync(CAPTURED_DIR, { withFileTypes: true })
+        .filter((d) => d.isDirectory())
+        .map((d) => d.name)
+        .sort();
+}
+//# sourceMappingURL=loadCapturedFixture.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadCapturedFixture.js","sourceRoot":"","sources":["../../../../../../../../src/utils/ruleReflection/__tests__/integration/helpers/loadCapturedFixture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;AAsBxE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAEjD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,+BAA+B,IAAI,eAAe,UAAU,GAAG,CAChE,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAC9B,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,iBAAiB,CAAC,EACxC,OAAO,CACR,CAAC;IAEF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC;QACxC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC;QACvC,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,WAAW,GAAiB,IAAI,CAAC,KAAK,CAC1C,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,EAAE,OAAO,CAAC,CACrE,CAAC;IAEF,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAC1C,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,EAAE,OAAO,CAAC,CACjE,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,EAAE;SACN,WAAW,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;SAClB,IAAI,EAAE,CAAC;AACZ,CAAC"}