@codeyam/codeyam-cli 0.1.0-staging.6e699e5 → 0.1.0-staging.79ef713

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

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

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

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

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

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

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.rule_timestamp) {
+            parts.push(`  Rule timestamp: ${rule.rule_timestamp}`);
+        }
+        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. ALWAYS update the timestamp (run `codeyam memory touch`)\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"}

package/codeyam-cli/src/utils/rules/__tests__/ruleState.test.js

@@ -0,0 +1,293 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { loadRuleState, saveRuleState, syncRuleState, touchTimestamps, setReviewed, getRuleTimestamp, isRuleReviewed, hashRuleContent, } from "../ruleState.js";
+describe('ruleState', () => {
+    let tempDir;
+    beforeEach(() => {
+        tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codeyam-rulestate-'));
+        // Create .claude directory
+        fs.mkdirSync(path.join(tempDir, '.claude', 'rules'), { recursive: true });
+    });
+    afterEach(() => {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    });
+    describe('hashRuleContent', () => {
+        it('produces consistent hashes for identical content', () => {
+            const content = '# My Rule\n\nSome content here.';
+            expect(hashRuleContent(content)).toBe(hashRuleContent(content));
+        });
+        it('strips category field from hash calculation', () => {
+            const withCategory = '---\ncategory: testing\n---\n# My Rule\n\nSome content.';
+            const withoutCategory = '---\n---\n# My Rule\n\nSome content.';
+            expect(hashRuleContent(withCategory)).toBe(hashRuleContent(withoutCategory));
+        });
+        it('produces different hashes for different content', () => {
+            const a = '# Rule A\n\nContent A';
+            const b = '# Rule B\n\nContent B';
+            expect(hashRuleContent(a)).not.toBe(hashRuleContent(b));
+        });
+    });
+    describe('loadRuleState', () => {
+        it('returns empty state when file does not exist', async () => {
+            const state = await loadRuleState(tempDir);
+            expect(state).toEqual({ version: 1, rules: {} });
+        });
+        it('loads existing state from file', async () => {
+            const data = {
+                version: 1,
+                rules: {
+                    'test-rule.md': {
+                        timestamp: '2026-01-01T00:00:00Z',
+                        contentHash: 'abc123',
+                        reviewed: true,
+                    },
+                },
+            };
+            fs.writeFileSync(path.join(tempDir, '.claude', 'codeyam-rule-state.json'), JSON.stringify(data));
+            const state = await loadRuleState(tempDir);
+            expect(state.rules['test-rule.md']).toEqual({
+                timestamp: '2026-01-01T00:00:00Z',
+                contentHash: 'abc123',
+                reviewed: true,
+            });
+        });
+        it('returns empty state for unknown version', async () => {
+            const data = { version: 999, rules: {} };
+            fs.writeFileSync(path.join(tempDir, '.claude', 'codeyam-rule-state.json'), JSON.stringify(data));
+            const state = await loadRuleState(tempDir);
+            expect(state).toEqual({ version: 1, rules: {} });
+        });
+    });
+    describe('saveRuleState', () => {
+        it('writes state to .claude/codeyam-rule-state.json', async () => {
+            const data = {
+                version: 1,
+                rules: {
+                    'my-rule.md': {
+                        contentHash: 'hash123',
+                        reviewed: false,
+                    },
+                },
+            };
+            await saveRuleState(tempDir, data);
+            const content = fs.readFileSync(path.join(tempDir, '.claude', 'codeyam-rule-state.json'), 'utf-8');
+            const parsed = JSON.parse(content);
+            expect(parsed.version).toBe(1);
+            expect(parsed.rules['my-rule.md'].contentHash).toBe('hash123');
+        });
+        it('creates .claude directory if it does not exist', async () => {
+            const freshDir = fs.mkdtempSync(path.join(os.tmpdir(), 'codeyam-fresh-'));
+            try {
+                await saveRuleState(freshDir, { version: 1, rules: {} });
+                expect(fs.existsSync(path.join(freshDir, '.claude', 'codeyam-rule-state.json'))).toBe(true);
+            }
+            finally {
+                fs.rmSync(freshDir, { recursive: true, force: true });
+            }
+        });
+    });
+    describe('syncRuleState', () => {
+        function makeRule(filePath, content) {
+            const absolutePath = path.join(tempDir, '.claude', 'rules', filePath);
+            return {
+                filePath,
+                absolutePath,
+                frontmatter: {},
+                body: content,
+            };
+        }
+        it('creates entries for new rules', async () => {
+            const ruleContent = '# New Rule\n\nThis is a new rule.';
+            fs.writeFileSync(path.join(tempDir, '.claude', 'rules', 'new-rule.md'), ruleContent);
+            const rules = [makeRule('new-rule.md', ruleContent)];
+            const state = await syncRuleState(tempDir, rules);
+            expect(state.rules['new-rule.md']).toBeDefined();
+            expect(state.rules['new-rule.md'].reviewed).toBe(false);
+            expect(state.rules['new-rule.md'].contentHash).toBeTruthy();
+        });
+        it('preserves reviewed status when content has not changed', async () => {
+            const ruleContent = '# Existing Rule\n\nSame content.';
+            const hash = hashRuleContent(ruleContent);
+            // Write initial state with reviewed: true
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'existing.md': {
+                        timestamp: '2026-01-01T00:00:00Z',
+                        contentHash: hash,
+                        reviewed: true,
+                    },
+                },
+            });
+            fs.writeFileSync(path.join(tempDir, '.claude', 'rules', 'existing.md'), ruleContent);
+            const rules = [makeRule('existing.md', ruleContent)];
+            const state = await syncRuleState(tempDir, rules);
+            expect(state.rules['existing.md'].reviewed).toBe(true);
+            expect(state.rules['existing.md'].timestamp).toBe('2026-01-01T00:00:00Z');
+        });
+        it('resets reviewed to false when content changes', async () => {
+            const oldContent = '# Old Rule\n\nOld content.';
+            const newContent = '# Old Rule\n\nUpdated content.';
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'changing.md': {
+                        timestamp: '2026-01-01T00:00:00Z',
+                        contentHash: hashRuleContent(oldContent),
+                        reviewed: true,
+                    },
+                },
+            });
+            fs.writeFileSync(path.join(tempDir, '.claude', 'rules', 'changing.md'), newContent);
+            const rules = [makeRule('changing.md', newContent)];
+            const state = await syncRuleState(tempDir, rules);
+            expect(state.rules['changing.md'].reviewed).toBe(false);
+            expect(state.rules['changing.md'].contentHash).toBe(hashRuleContent(newContent));
+            // Timestamp should be preserved
+            expect(state.rules['changing.md'].timestamp).toBe('2026-01-01T00:00:00Z');
+        });
+        it('removes entries for deleted rules', async () => {
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'deleted.md': {
+                        contentHash: 'old-hash',
+                        reviewed: true,
+                    },
+                },
+            });
+            // Sync with empty rules list
+            const state = await syncRuleState(tempDir, []);
+            expect(state.rules['deleted.md']).toBeUndefined();
+        });
+    });
+    describe('touchTimestamps', () => {
+        it('sets timestamp to now for listed rules', async () => {
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'rule-a.md': { contentHash: 'hash-a', reviewed: false },
+                    'rule-b.md': {
+                        contentHash: 'hash-b',
+                        reviewed: false,
+                        timestamp: '2026-01-01T00:00:00Z',
+                    },
+                },
+            });
+            const before = Date.now();
+            await touchTimestamps(tempDir, ['rule-a.md', 'rule-b.md']);
+            const after = Date.now();
+            const state = await loadRuleState(tempDir);
+            for (const rulePath of ['rule-a.md', 'rule-b.md']) {
+                const ts = new Date(state.rules[rulePath].timestamp).getTime();
+                expect(ts).toBeGreaterThanOrEqual(before);
+                expect(ts).toBeLessThanOrEqual(after);
+            }
+        });
+        it('does not modify rules not in the list', async () => {
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'touched.md': { contentHash: 'hash-t', reviewed: false },
+                    'untouched.md': {
+                        contentHash: 'hash-u',
+                        reviewed: true,
+                        timestamp: '2026-01-01T00:00:00Z',
+                    },
+                },
+            });
+            await touchTimestamps(tempDir, ['touched.md']);
+            const state = await loadRuleState(tempDir);
+            expect(state.rules['untouched.md'].timestamp).toBe('2026-01-01T00:00:00Z');
+        });
+    });
+    describe('setReviewed', () => {
+        it('marks a rule as reviewed and updates content hash', async () => {
+            const ruleContent = '# Test Rule\n\nSome content.';
+            fs.writeFileSync(path.join(tempDir, '.claude', 'rules', 'test.md'), ruleContent);
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'test.md': { contentHash: 'old-hash', reviewed: false },
+                },
+            });
+            await setReviewed(tempDir, 'test.md', true);
+            const state = await loadRuleState(tempDir);
+            expect(state.rules['test.md'].reviewed).toBe(true);
+            expect(state.rules['test.md'].contentHash).toBe(hashRuleContent(ruleContent));
+        });
+        it('marks a rule as unreviewed', async () => {
+            await saveRuleState(tempDir, {
+                version: 1,
+                rules: {
+                    'test.md': { contentHash: 'hash', reviewed: true },
+                },
+            });
+            await setReviewed(tempDir, 'test.md', false);
+            const state = await loadRuleState(tempDir);
+            expect(state.rules['test.md'].reviewed).toBe(false);
+        });
+        it('creates entry for new rule when marking as reviewed', async () => {
+            const ruleContent = '# Brand New Rule\n\nContent.';
+            fs.writeFileSync(path.join(tempDir, '.claude', 'rules', 'brand-new.md'), ruleContent);
+            await setReviewed(tempDir, 'brand-new.md', true);
+            const state = await loadRuleState(tempDir);
+            expect(state.rules['brand-new.md']).toBeDefined();
+            expect(state.rules['brand-new.md'].reviewed).toBe(true);
+        });
+    });
+    describe('getRuleTimestamp', () => {
+        it('returns timestamp when it exists', () => {
+            const state = {
+                version: 1,
+                rules: {
+                    'rule.md': {
+                        contentHash: 'hash',
+                        reviewed: false,
+                        timestamp: '2026-02-01T00:00:00Z',
+                    },
+                },
+            };
+            expect(getRuleTimestamp(state, 'rule.md')).toBe('2026-02-01T00:00:00Z');
+        });
+        it('returns null when rule has no timestamp', () => {
+            const state = {
+                version: 1,
+                rules: {
+                    'rule.md': { contentHash: 'hash', reviewed: false },
+                },
+            };
+            expect(getRuleTimestamp(state, 'rule.md')).toBeNull();
+        });
+        it('returns null when rule does not exist', () => {
+            const state = { version: 1, rules: {} };
+            expect(getRuleTimestamp(state, 'nonexistent.md')).toBeNull();
+        });
+    });
+    describe('isRuleReviewed', () => {
+        it('returns true for reviewed rules', () => {
+            const state = {
+                version: 1,
+                rules: {
+                    'rule.md': { contentHash: 'hash', reviewed: true },
+                },
+            };
+            expect(isRuleReviewed(state, 'rule.md')).toBe(true);
+        });
+        it('returns false for unreviewed rules', () => {
+            const state = {
+                version: 1,
+                rules: {
+                    'rule.md': { contentHash: 'hash', reviewed: false },
+                },
+            };
+            expect(isRuleReviewed(state, 'rule.md')).toBe(false);
+        });
+        it('returns false for nonexistent rules', () => {
+            const state = { version: 1, rules: {} };
+            expect(isRuleReviewed(state, 'nonexistent.md')).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=ruleState.test.js.map