@codeyam/codeyam-cli 0.1.0-staging.483fdc2 → 0.1.0-staging.62d4615

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

@@ -0,0 +1,128 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildStaleRulesContext, buildConversationContext, } 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('Rule timestamp: 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('Rule timestamp: 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('When NOT to create a rule');
+            expect(result).toContain('.codeyam/rules/instructions.md');
+        });
+    });
+});
+//# 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"}

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

@@ -0,0 +1,162 @@
+import { execSync } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+/** Resolve the absolute path to the `claude` binary once at module load. */
+function findClaude() {
+    try {
+        return execSync('which claude', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        // Fallback: check common locations
+        const homeDir = process.env.HOME || process.env.USERPROFILE || '';
+        const candidates = [
+            path.join(homeDir, '.local', 'bin', 'claude'),
+            '/usr/local/bin/claude',
+        ];
+        for (const p of candidates) {
+            if (fs.existsSync(p))
+                return p;
+        }
+        return 'claude'; // fall through and let execSync fail with a clear error
+    }
+}
+const CLAUDE_BIN = findClaude();
+/**
+ * Run `claude -p` synchronously and capture the result.
+ * Mirrors the production invocation from rule-reflection-hook.py.
+ */
+export function runClaude(options) {
+    const { prompt, cwd, model = 'haiku', timeoutMs = 180000, allowedTools = ['Read', 'Edit', 'Write', 'Bash', 'Glob', 'Grep'], saveOutput, } = options;
+    const args = [
+        CLAUDE_BIN,
+        '-p',
+        prompt,
+        '--model',
+        model,
+        '--output-format',
+        'stream-json',
+        '--verbose',
+        '--allowedTools',
+        allowedTools.join(','),
+    ];
+    let result;
+    try {
+        const stdout = execSync(args.map(shellEscape).join(' '), {
+            cwd,
+            timeout: timeoutMs,
+            encoding: 'utf-8',
+            env: {
+                ...process.env,
+                CODEYAM_RULE_AGENT: '1',
+            },
+            stdio: ['ignore', 'pipe', 'pipe'],
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+        });
+        result = { exitCode: 0, stdout, stderr: '' };
+    }
+    catch (err) {
+        const error = err;
+        result = {
+            exitCode: error.status ?? 1,
+            stdout: error.stdout ?? '',
+            stderr: error.stderr ?? error.message ?? '',
+        };
+    }
+    if (saveOutput) {
+        fs.mkdirSync(saveOutput.dir, { recursive: true });
+        const parts = [];
+        parts.push(`# Rule Reflection Conversation Log\n`);
+        parts.push(`**Exit code:** ${result.exitCode}\n`);
+        if (result.stderr) {
+            parts.push(`**Stderr:**\n\`\`\`\n${result.stderr.slice(0, 2000)}\n\`\`\`\n`);
+        }
+        if (!result.stdout.trim()) {
+            parts.push(`**No stdout from claude CLI.**\n`);
+        }
+        else {
+            parts.push(formatConversation(result.stdout));
+        }
+        const outPath = path.join(saveOutput.dir, `${saveOutput.label}.md`);
+        fs.writeFileSync(outPath, parts.join('\n'));
+        console.log(`\n💬 Conversation log (exit=${result.exitCode}): ${outPath}\n`);
+    }
+    return result;
+}
+/**
+ * Parse stream-json stdout into a readable markdown conversation log.
+ *
+ * Stream-json format (one JSON object per line):
+ * - {"type":"system","subtype":"init",...}
+ * - {"type":"assistant","message":{"content":[{"type":"text","text":"..."}]}}
+ * - {"type":"assistant","message":{"content":[{"type":"tool_use","name":"...","input":{...}}]}}
+ * - {"type":"user","message":{"content":[{"type":"tool_result","content":"..."}]}}
+ * - {"type":"result","result":"..."}
+ */
+function formatConversation(stdout) {
+    const lines = [];
+    for (const rawLine of stdout.split('\n')) {
+        if (!rawLine.trim())
+            continue;
+        let event;
+        try {
+            event = JSON.parse(rawLine);
+        }
+        catch {
+            continue;
+        }
+        const type = event.type;
+        const message = event.message;
+        const contentBlocks = (message?.content ?? []);
+        if (type === 'assistant' && message) {
+            for (const block of contentBlocks) {
+                if (block.type === 'text') {
+                    lines.push(`\n**Assistant:**\n${String(block.text)}\n`);
+                }
+                else if (block.type === 'tool_use') {
+                    const name = block.name;
+                    const input = block.input;
+                    lines.push(`\n---\n**Tool: ${name}**`);
+                    if (input) {
+                        for (const [k, v] of Object.entries(input)) {
+                            const val = typeof v === 'string' ? v : JSON.stringify(v);
+                            const display = val.length > 300 ? val.slice(0, 300) + '...' : val;
+                            lines.push(`- ${k}: \`${display}\``);
+                        }
+                    }
+                }
+            }
+        }
+        else if (type === 'user' && message) {
+            for (const block of contentBlocks) {
+                if (block.type === 'tool_result') {
+                    const content = String(block.content ?? '').slice(0, 500);
+                    if (content) {
+                        lines.push(`\n> Result (${content.length >= 500 ? 'truncated' : 'full'}):\n> ${content.replace(/\n/g, '\n> ')}${String(block.content ?? '').length > 500 ? '...' : ''}`);
+                    }
+                    lines.push('\n---\n');
+                }
+            }
+        }
+        else if (type === 'result') {
+            const text = String(event.result ?? '');
+            if (text) {
+                lines.push(`\n## Final Result\n\n${text}`);
+            }
+            const cost = event.total_cost_usd;
+            const turns = event.num_turns;
+            const duration = event.duration_ms;
+            if (cost || turns || duration) {
+                lines.push(`\n---\n*Turns: ${turns} | Duration: ${Number(duration) / 1000}s | Cost: $${Number(cost).toFixed(4)}*`);
+            }
+        }
+    }
+    return lines.join('\n');
+}
+function shellEscape(arg) {
+    // If the arg contains special chars, wrap in single quotes
+    if (/[^a-zA-Z0-9_\-./:=,]/.test(arg)) {
+        return `'${arg.replace(/'/g, "'\\''")}'`;
+    }
+    return arg;
+}
+//# sourceMappingURL=runClaude.js.map

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

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

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

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

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

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