@codeyam/codeyam-cli 0.1.0-staging.323686 → 0.1.0-staging.4813bf3

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