@codeyam/codeyam-cli 0.1.0-staging.323686 → 0.1.0-staging.39719f5

package/codeyam-cli/src/utils/registerScenarioResult.js

@@ -0,0 +1,52 @@
+/**
+ * Classify the result of a scenario registration API response.
+ *
+ * Extracted from handleRegister() for testability — the same logic
+ * determines whether a registration has issues that must be fixed.
+ */
+/**
+ * Given an HTTP status and API response body, classify the registration result.
+ *
+ * Returns an array of issues (empty = clean success).
+ */
+export function classifyRegistrationResult(httpOk, httpStatus, data, requestName) {
+    const issues = [];
+    const name = data.scenario?.name || requestName;
+    if (!httpOk) {
+        issues.push({
+            scenarioName: name,
+            message: `HTTP ${httpStatus} — ${data.error || 'unknown error'}`,
+            type: 'http-error',
+        });
+        return issues;
+    }
+    // Client errors: JavaScript errors on the page during capture
+    if (data.clientErrors && data.clientErrors.length > 0) {
+        issues.push({
+            scenarioName: name,
+            message: `${data.clientErrors.length} client error(s) — page has JavaScript errors`,
+            type: 'client-error',
+        });
+    }
+    // Capture error: Playwright screenshot failed
+    if (data.captureError) {
+        issues.push({
+            scenarioName: name,
+            message: `screenshot capture failed — ${data.captureError}`,
+            type: 'capture-error',
+        });
+    }
+    // Seed failure: database seeding failed (ignore "No seed adapter found"
+    // since that's expected for non-seed scenarios)
+    if (data.seedResult &&
+        !data.seedResult.success &&
+        data.seedResult.error !== 'No seed adapter found') {
+        issues.push({
+            scenarioName: name,
+            message: `seed failed — ${data.seedResult.error}`,
+            type: 'seed-error',
+        });
+    }
+    return issues;
+}
+//# sourceMappingURL=registerScenarioResult.js.map

package/codeyam-cli/src/utils/registerScenarioResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerScenarioResult.js","sourceRoot":"","sources":["../../../../src/utils/registerScenarioResult.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgBH;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAe,EACf,UAAkB,EAClB,IAAyB,EACzB,WAAmB;IAEnB,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,WAAW,CAAC;IAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC;YACV,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,QAAQ,UAAU,MAAO,IAAgC,CAAC,KAAK,IAAI,eAAe,EAAE;YAC7F,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC;YACV,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,+CAA+C;YACnF,IAAI,EAAE,cAAc;SACrB,CAAC,CAAC;IACL,CAAC;IAED,8CAA8C;IAC9C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC;YACV,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,+BAA+B,IAAI,CAAC,YAAY,EAAE;YAC3D,IAAI,EAAE,eAAe;SACtB,CAAC,CAAC;IACL,CAAC;IAED,wEAAwE;IACxE,gDAAgD;IAChD,IACE,IAAI,CAAC,UAAU;QACf,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO;QACxB,IAAI,CAAC,UAAU,CAAC,KAAK,KAAK,uBAAuB,EACjD,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,YAAY,EAAE,IAAI;YAClB,OAAO,EAAE,iBAAiB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;YACjD,IAAI,EAAE,YAAY;SACnB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/codeyam-cli/src/utils/requireSimulations.js

@@ -0,0 +1,10 @@
+import { isAnalyzerFinalized } from "./analyzer.js";
+import { error, info } from "./progress.js";
+export function requireSimulations() {
+    if (!isAnalyzerFinalized()) {
+        error('Simulations are not set up yet.');
+        info('Enable simulations from the CodeYam dashboard.');
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=requireSimulations.js.map

package/codeyam-cli/src/utils/requireSimulations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requireSimulations.js","sourceRoot":"","sources":["../../../../src/utils/requireSimulations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,UAAU,kBAAkB;IAChC,IAAI,CAAC,mBAAmB,EAAE,EAAE,CAAC;QAC3B,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACzC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/codeyam-cli/src/utils/routePatternMatching.js

@@ -0,0 +1,129 @@
+/**
+ * Route pattern matching utilities for mapping URLs to page files.
+ *
+ * These are pure functions with no Node.js dependencies — safe to import
+ * from browser-bundled code.
+ */
+/**
+ * Convert a page file path to its URL route pattern.
+ *
+ * Examples:
+ *   'app/page.tsx'                    → '/'
+ *   'app/feedback/[id]/page.tsx'      → '/feedback/[id]'
+ *   'app/(tabs)/settings/page.tsx'    → '/settings'
+ *   'app/tea/[id].tsx'                → '/tea/[id]'   (Expo Router)
+ */
+export function buildRoutePattern(pageFilePath) {
+    // Non-route files (e.g., src/App.tsx, src/popup/App.tsx) are app entry
+    // points used as pageFilePath for non-Next.js apps. They represent the
+    // root route since they're not file-based routing pages.
+    if (!pageFilePath.startsWith('app/') && !pageFilePath.startsWith('(')) {
+        return '/';
+    }
+    // Remove 'app/' prefix
+    const rest = pageFilePath.replace(/^app\//, '');
+    // Determine the file name and extract the route prefix
+    const parts = rest.split('/');
+    const fileName = parts.pop();
+    // For page.tsx/page.js — the route is the directory path
+    // For index.tsx — the route is the directory path (Expo Router root)
+    // For named files like add-tea.tsx — the file base name is a segment
+    const ext = fileName.match(/\.(tsx?|jsx?|js)$/)?.[0] || '';
+    const baseName = fileName.slice(0, -ext.length);
+    let segments;
+    if (baseName === 'page') {
+        segments = parts;
+    }
+    else if (baseName === 'index') {
+        segments = parts;
+    }
+    else {
+        // Named route file (Expo Router): settings.tsx → /settings
+        segments = [...parts, baseName];
+    }
+    // Strip route groups like (tabs), (auth)
+    segments = segments.filter((seg) => !seg.startsWith('('));
+    if (segments.length === 0)
+        return '/';
+    return '/' + segments.join('/');
+}
+/**
+ * Generate a human-readable display name from a route pattern.
+ *
+ * Examples:
+ *   '/'                  → 'Home'
+ *   '/about'             → 'About'
+ *   '/feedback/[id]'     → 'Feedback / [id]'
+ *   '/feedback/[id]/edit' → 'Feedback / [id] / Edit'
+ */
+export function routeDisplayName(routePattern) {
+    if (routePattern === '/')
+        return 'Home';
+    const segments = routePattern.replace(/^\//, '').split('/');
+    return segments
+        .map((seg) => {
+        // Don't capitalize dynamic segments like [id]
+        if (seg.startsWith('['))
+            return seg;
+        return seg.charAt(0).toUpperCase() + seg.slice(1);
+    })
+        .join(' / ');
+}
+/**
+ * Match a concrete URL to the page file that handles it.
+ *
+ * Uses Next.js-style routing rules:
+ * - Static segments must match exactly
+ * - Dynamic segments ([id], [slug]) match any single segment
+ * - Static matches are preferred over dynamic matches
+ * - Query parameters are stripped before matching
+ *
+ * Returns the matched file path, or null if no match.
+ */
+export function matchUrlToPageFile(url, pageFiles) {
+    if (!url)
+        return null;
+    // Strip query params and trailing slash
+    const cleanUrl = url.split('?')[0].replace(/\/+$/, '') || '/';
+    // Build route patterns for all page files
+    const routes = pageFiles.map((filePath) => ({
+        filePath,
+        pattern: buildRoutePattern(filePath),
+    }));
+    // Parse the URL into segments
+    const urlSegments = cleanUrl === '/' ? [] : cleanUrl.replace(/^\//, '').split('/');
+    let bestMatch = null;
+    let bestScore = -1;
+    for (const route of routes) {
+        const patternSegments = route.pattern === '/' ? [] : route.pattern.replace(/^\//, '').split('/');
+        // Must have same number of segments
+        if (patternSegments.length !== urlSegments.length)
+            continue;
+        // Score the match: count static (exact) segment matches
+        let matched = true;
+        let staticMatches = 0;
+        for (let i = 0; i < patternSegments.length; i++) {
+            const pat = patternSegments[i];
+            const seg = urlSegments[i];
+            if (pat.startsWith('[') && pat.endsWith(']')) {
+                // Dynamic segment — matches anything
+                continue;
+            }
+            else if (pat === seg) {
+                // Static exact match
+                staticMatches++;
+            }
+            else {
+                // No match
+                matched = false;
+                break;
+            }
+        }
+        if (matched && staticMatches > bestScore) {
+            bestScore = staticMatches;
+            bestMatch = route.filePath;
+        }
+    }
+    return bestMatch;
+}
+//# sourceMappingURL=routePatternMatching.js.map

package/codeyam-cli/src/utils/routePatternMatching.js.map

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,67 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { parseFrontmatter, findMarkdownFiles } from "../../../../rules/parser.js";
+/**
+ * Snapshot all rule files in a directory.
+ */
+export async function snapshotRules(rulesDir) {
+    const files = new Map();
+    const markdownFiles = await findMarkdownFiles(rulesDir);
+    for (const relPath of markdownFiles) {
+        const absPath = path.join(rulesDir, relPath);
+        try {
+            files.set(relPath, fs.readFileSync(absPath, 'utf-8'));
+        }
+        catch {
+            // Skip unreadable files
+        }
+    }
+    return { files };
+}
+/**
+ * Diff two rule snapshots to find created, modified, deleted, and unchanged files.
+ */
+export function getRulesChanges(before, after) {
+    const created = [];
+    const modified = [];
+    const deleted = [];
+    const unchanged = [];
+    // Check for new and modified files
+    for (const [filePath, content] of after.files) {
+        const beforeContent = before.files.get(filePath);
+        if (beforeContent === undefined) {
+            created.push(filePath);
+        }
+        else if (beforeContent !== content) {
+            modified.push(filePath);
+        }
+        else {
+            unchanged.push(filePath);
+        }
+    }
+    // Check for deleted files
+    for (const filePath of before.files.keys()) {
+        if (!after.files.has(filePath)) {
+            deleted.push(filePath);
+        }
+    }
+    return { created, modified, deleted, unchanged };
+}
+/**
+ * Assert that a rule file has valid frontmatter with required fields.
+ */
+export function assertValidFrontmatter(content) {
+    const { frontmatter } = parseFrontmatter(content);
+    // Audit dates (lastAuditedAt) are 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,gGAAgG;IAChG,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"}