@codeyam/codeyam-cli 0.1.0-staging.596f0eb → 0.1.0-staging.62d4615

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

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

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

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

@@ -0,0 +1,6 @@
+// Re-export all rule utilities
+export * from "./parser.js";
+export * from "./pathMatcher.js";
+export * from "./staleness.js";
+export * from "./ruleState.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/utils/rules/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/codeyam-cli/src/utils/rules/parser.js

@@ -0,0 +1,78 @@
+// Rule parsing utilities for Claude Rules
+import path from 'path';
+import fs from 'fs/promises';
+/**
+ * Parse YAML frontmatter from a markdown file
+ */
+export function parseFrontmatter(content) {
+    const frontmatterRegex = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/;
+    const match = content.match(frontmatterRegex);
+    if (!match) {
+        return { frontmatter: {}, body: content };
+    }
+    const yamlContent = match[1];
+    const body = match[2];
+    // Simple YAML parser for our specific format
+    const frontmatter = {};
+    // Parse paths array
+    const pathsMatch = yamlContent.match(/paths:\s*\n((?:\s+-\s+[^\n]+\n?)*)/);
+    if (pathsMatch) {
+        frontmatter.paths = pathsMatch[1]
+            .split('\n')
+            .filter((line) => line.trim().startsWith('-'))
+            .map((line) => line
+            .replace(/^\s*-\s*/, '')
+            .replace(/['"]/g, '')
+            .trim())
+            .filter(Boolean);
+    }
+    return { frontmatter, body };
+}
+/**
+ * Recursively find all .md files in a directory
+ */
+export async function findMarkdownFiles(dir, basePath = '') {
+    const results = [];
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const relativePath = basePath ? `${basePath}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                const subResults = await findMarkdownFiles(path.join(dir, entry.name), relativePath);
+                results.push(...subResults);
+            }
+            else if (entry.isFile() && entry.name.endsWith('.md')) {
+                results.push(relativePath);
+            }
+        }
+    }
+    catch {
+        // Directory doesn't exist or not readable
+    }
+    return results;
+}
+/**
+ * Load all rules from a rules directory
+ */
+export async function loadAllRules(rulesDir) {
+    const files = await findMarkdownFiles(rulesDir);
+    const rules = [];
+    for (const relativePath of files) {
+        const absolutePath = path.join(rulesDir, relativePath);
+        try {
+            const content = await fs.readFile(absolutePath, 'utf-8');
+            const { frontmatter, body } = parseFrontmatter(content);
+            rules.push({
+                filePath: relativePath,
+                absolutePath,
+                frontmatter,
+                body,
+            });
+        }
+        catch {
+            // Skip files that can't be read
+        }
+    }
+    return rules;
+}
+//# sourceMappingURL=parser.js.map

package/codeyam-cli/src/utils/rules/parser.js.map

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

package/codeyam-cli/src/utils/rules/pathMatcher.js

@@ -0,0 +1,18 @@
+// Path matching utilities for Claude Rules
+import { minimatch } from 'minimatch';
+/**
+ * Check if a file path matches any of a rule's path patterns
+ */
+export function doesPathMatchRule(filePath, rule) {
+    if (!rule.frontmatter.paths || rule.frontmatter.paths.length === 0) {
+        return false;
+    }
+    return rule.frontmatter.paths.some((pattern) => minimatch(filePath, pattern, { matchBase: true }));
+}
+/**
+ * Find all rules that match a given file path
+ */
+export function getRulesForPath(filePath, rules) {
+    return rules.filter((rule) => doesPathMatchRule(filePath, rule));
+}
+//# sourceMappingURL=pathMatcher.js.map

package/codeyam-cli/src/utils/rules/pathMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathMatcher.js","sourceRoot":"","sources":["../../../../../src/utils/rules/pathMatcher.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB,EAAE,IAAU;IAC5D,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAC7C,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAClD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,KAAa;IAC7D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}

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

@@ -0,0 +1,150 @@
+// Consolidated rule metadata management
+// Single source of truth for timestamps, content hashes, and review status
+import path from 'path';
+import fs from 'fs/promises';
+import crypto from 'crypto';
+const RULE_STATE_FILE = 'codeyam-rule-state.json';
+const CURRENT_VERSION = 1;
+/**
+ * Hash the meaningful content of a rule, excluding metadata that doesn't
+ * affect the rule's substance (category field).
+ */
+export function hashRuleContent(content) {
+    const normalized = content.replace(/^category:\s*.+$\n?/m, '');
+    return crypto.createHash('sha256').update(normalized).digest('hex');
+}
+/**
+ * Get the path to .claude/codeyam-rule-state.json
+ */
+function getRuleStatePath(projectRoot) {
+    return path.join(projectRoot, '.claude', RULE_STATE_FILE);
+}
+/**
+ * Load rule state from .claude/codeyam-rule-state.json
+ * Returns empty state if the file doesn't exist.
+ */
+export async function loadRuleState(projectRoot) {
+    const filePath = getRuleStatePath(projectRoot);
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const data = JSON.parse(content);
+        if (data.version !== CURRENT_VERSION) {
+            console.warn(`[ruleState] Unknown version ${data.version}, using empty state`);
+            return { version: CURRENT_VERSION, rules: {} };
+        }
+        return data;
+    }
+    catch {
+        return { version: CURRENT_VERSION, rules: {} };
+    }
+}
+/**
+ * Save rule state to .claude/codeyam-rule-state.json
+ */
+export async function saveRuleState(projectRoot, data) {
+    const filePath = getRuleStatePath(projectRoot);
+    // Ensure .claude directory exists
+    const claudeDir = path.dirname(filePath);
+    await fs.mkdir(claudeDir, { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(data, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Sync rule state with current rules on disk.
+ * - Recomputes content hashes for all current rules
+ * - Marks `reviewed: false` for rules whose hash changed
+ * - Removes entries for deleted rules
+ * - Preserves timestamps and reviewed status for unchanged rules
+ */
+export async function syncRuleState(projectRoot, rules) {
+    const state = await loadRuleState(projectRoot);
+    const currentRulePaths = new Set(rules.map((r) => r.filePath));
+    // Remove entries for deleted rules
+    for (const key of Object.keys(state.rules)) {
+        if (!currentRulePaths.has(key)) {
+            delete state.rules[key];
+        }
+    }
+    // Update entries for current rules
+    for (const rule of rules) {
+        const fullContent = await fs.readFile(rule.absolutePath, 'utf-8');
+        const newHash = hashRuleContent(fullContent);
+        const existing = state.rules[rule.filePath];
+        if (existing) {
+            if (existing.contentHash !== newHash) {
+                // Content changed — reset reviewed status, keep timestamp
+                state.rules[rule.filePath] = {
+                    ...existing,
+                    contentHash: newHash,
+                    reviewed: false,
+                };
+            }
+            // If hash matches, keep everything as-is
+        }
+        else {
+            // New rule — not yet reviewed, no timestamp
+            state.rules[rule.filePath] = {
+                contentHash: newHash,
+                reviewed: false,
+            };
+        }
+    }
+    await saveRuleState(projectRoot, state);
+    return state;
+}
+/**
+ * Set timestamp to now for the listed rule file paths.
+ * Only modifies .claude/codeyam-rule-state.json.
+ */
+export async function touchTimestamps(projectRoot, ruleFilePaths) {
+    const state = await loadRuleState(projectRoot);
+    const now = new Date().toISOString();
+    for (const filePath of ruleFilePaths) {
+        if (state.rules[filePath]) {
+            state.rules[filePath].timestamp = now;
+        }
+    }
+    await saveRuleState(projectRoot, state);
+}
+/**
+ * Mark a rule as reviewed or unreviewed.
+ * When marking as reviewed, also recomputes the content hash.
+ */
+export async function setReviewed(projectRoot, filePath, reviewed, rulesDir) {
+    const state = await loadRuleState(projectRoot);
+    if (reviewed) {
+        // Recompute hash to ensure it's current
+        const effectiveRulesDir = rulesDir || path.join(projectRoot, '.claude', 'rules');
+        const fullPath = path.join(effectiveRulesDir, filePath);
+        const content = await fs.readFile(fullPath, 'utf-8');
+        const contentHash = hashRuleContent(content);
+        if (state.rules[filePath]) {
+            state.rules[filePath].reviewed = true;
+            state.rules[filePath].contentHash = contentHash;
+        }
+        else {
+            state.rules[filePath] = {
+                contentHash,
+                reviewed: true,
+            };
+        }
+    }
+    else {
+        if (state.rules[filePath]) {
+            state.rules[filePath].reviewed = false;
+        }
+    }
+    await saveRuleState(projectRoot, state);
+}
+/**
+ * Get the timestamp for a rule from loaded state.
+ */
+export function getRuleTimestamp(state, filePath) {
+    return state.rules[filePath]?.timestamp ?? null;
+}
+/**
+ * Check if a rule is reviewed from loaded state.
+ */
+export function isRuleReviewed(state, filePath) {
+    return state.rules[filePath]?.reviewed ?? false;
+}
+//# sourceMappingURL=ruleState.js.map

package/codeyam-cli/src/utils/rules/ruleState.js.map

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