@codeyam/codeyam-cli 0.1.0-staging.d0ad4ae → 0.1.0-staging.d52b24f

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.last_audited) {
+            parts.push(`  Last audited: ${rule.last_audited}`);
+        }
+        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. Run `codeyam memory touch <rule-path1> <rule-path2> ...` with the SPECIFIC rule paths you reviewed to mark them as audited\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__/parser.test.js

@@ -0,0 +1,83 @@
+import { parseFrontmatter } from "../parser.js";
+describe('parseFrontmatter', () => {
+    it('parses multi-line paths array', () => {
+        const content = `---
+paths:
+  - 'apps/web/modules/ee/license-check/**'
+  - 'apps/web/modules/ee/license-check/**/*.ts'
+---
+
+## License System
+`;
+        const { frontmatter, body } = parseFrontmatter(content);
+        expect(frontmatter.paths).toEqual([
+            'apps/web/modules/ee/license-check/**',
+            'apps/web/modules/ee/license-check/**/*.ts',
+        ]);
+        expect(body.trim()).toBe('## License System');
+    });
+    it('parses inline YAML array with single-quoted strings', () => {
+        const content = `---
+paths: ['apps/web/modules/ee/license-check/**']
+---
+
+## License System
+`;
+        const { frontmatter } = parseFrontmatter(content);
+        expect(frontmatter.paths).toEqual(['apps/web/modules/ee/license-check/**']);
+    });
+    it('parses inline YAML array with double-quoted strings', () => {
+        const content = `---
+paths: ["apps/web/modules/ee/license-check/**", "apps/web/lib/**"]
+---
+
+## Content
+`;
+        const { frontmatter } = parseFrontmatter(content);
+        expect(frontmatter.paths).toEqual([
+            'apps/web/modules/ee/license-check/**',
+            'apps/web/lib/**',
+        ]);
+    });
+    it('parses inline YAML array without quotes', () => {
+        const content = `---
+paths: [apps/web/modules/ee/license-check/**]
+---
+
+## Content
+`;
+        const { frontmatter } = parseFrontmatter(content);
+        expect(frontmatter.paths).toEqual(['apps/web/modules/ee/license-check/**']);
+    });
+    it('parses paths without quotes in multi-line format', () => {
+        const content = `---
+paths:
+  - apps/web/modules/ee/license-check/**
+---
+
+## Content
+`;
+        const { frontmatter } = parseFrontmatter(content);
+        expect(frontmatter.paths).toEqual(['apps/web/modules/ee/license-check/**']);
+    });
+    it('returns empty frontmatter when no frontmatter present', () => {
+        const content = '## Just Content\n\nNo frontmatter here.';
+        const { frontmatter, body } = parseFrontmatter(content);
+        expect(frontmatter).toEqual({});
+        expect(body).toBe(content);
+    });
+    it('parses category field', () => {
+        const content = `---
+paths:
+  - 'src/**'
+category: architecture
+---
+
+## Architecture
+`;
+        const { frontmatter } = parseFrontmatter(content);
+        expect(frontmatter.paths).toEqual(['src/**']);
+        expect(frontmatter.category).toBe('architecture');
+    });
+});
+//# sourceMappingURL=parser.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.test.js","sourceRoot":"","sources":["../../../../../../src/utils/rules/__tests__/parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,OAAO,GAAG;;;;;;;CAOnB,CAAC;QACE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAChC,sCAAsC;YACtC,2CAA2C;SAC5C,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,OAAO,GAAG;;;;;CAKnB,CAAC;QACE,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,MAAM,OAAO,GAAG;;;;;CAKnB,CAAC;QACE,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YAChC,sCAAsC;YACtC,iBAAiB;SAClB,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,OAAO,GAAG;;;;;CAKnB,CAAC;QACE,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,OAAO,GAAG;;;;;;CAMnB,CAAC;QACE,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,OAAO,GAAG,yCAAyC,CAAC;QAC1D,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,OAAO,GAAG;;;;;;;CAOnB,CAAC;QACE,MAAM,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,118 @@
+import { doesPathMatchRule, getRulesForPath, getSourceFilesForRule, } from "../pathMatcher.js";
+function makeRule(filePath, paths) {
+    return {
+        filePath,
+        absolutePath: `/project/.claude/rules/${filePath}`,
+        frontmatter: { paths },
+        body: 'rule content',
+    };
+}
+describe('doesPathMatchRule', () => {
+    it('returns false when rule has no paths', () => {
+        const rule = makeRule('general.md');
+        expect(doesPathMatchRule('src/index.ts', rule)).toBe(false);
+    });
+    it('returns false when rule has empty paths array', () => {
+        const rule = makeRule('general.md', []);
+        expect(doesPathMatchRule('src/index.ts', rule)).toBe(false);
+    });
+    it('matches glob patterns', () => {
+        const rule = makeRule('ts-rules.md', ['**/*.ts']);
+        expect(doesPathMatchRule('src/index.ts', rule)).toBe(true);
+        expect(doesPathMatchRule('src/App.tsx', rule)).toBe(false);
+    });
+    it('matches with matchBase option', () => {
+        const rule = makeRule('component-rules.md', ['*.tsx']);
+        expect(doesPathMatchRule('src/components/Button.tsx', rule)).toBe(true);
+    });
+});
+describe('getRulesForPath', () => {
+    it('returns all matching rules for a path', () => {
+        const rules = [
+            makeRule('ts.md', ['**/*.ts']),
+            makeRule('tsx.md', ['**/*.tsx']),
+            makeRule('all-src.md', ['src/**']),
+        ];
+        const matches = getRulesForPath('src/index.ts', rules);
+        expect(matches.map((r) => r.filePath)).toEqual(['ts.md', 'all-src.md']);
+    });
+});
+describe('getSourceFilesForRule', () => {
+    const sourceFiles = [
+        'src/index.ts',
+        'src/App.tsx',
+        'src/utils/helpers.ts',
+        'lib/parser.js',
+        'test/setup.ts',
+    ];
+    it('returns empty array for rule with no paths', () => {
+        const rule = makeRule('general.md');
+        expect(getSourceFilesForRule(rule, sourceFiles)).toEqual([]);
+    });
+    it('returns empty array for rule with empty paths array', () => {
+        const rule = makeRule('general.md', []);
+        expect(getSourceFilesForRule(rule, sourceFiles)).toEqual([]);
+    });
+    it('returns matching files for glob pattern', () => {
+        const rule = makeRule('ts-only.md', ['**/*.ts']);
+        const result = getSourceFilesForRule(rule, sourceFiles);
+        expect(result.sort()).toEqual([
+            'src/index.ts',
+            'src/utils/helpers.ts',
+            'test/setup.ts',
+        ]);
+    });
+    it('returns matching files for directory pattern', () => {
+        const rule = makeRule('src-rules.md', ['src/**']);
+        const result = getSourceFilesForRule(rule, sourceFiles);
+        expect(result.sort()).toEqual([
+            'src/App.tsx',
+            'src/index.ts',
+            'src/utils/helpers.ts',
+        ]);
+    });
+    it('returns empty array when no files match', () => {
+        const rule = makeRule('python.md', ['**/*.py']);
+        expect(getSourceFilesForRule(rule, sourceFiles)).toEqual([]);
+    });
+    it('handles multiple patterns', () => {
+        const rule = makeRule('multi.md', ['**/*.tsx', 'lib/**']);
+        const result = getSourceFilesForRule(rule, sourceFiles);
+        expect(result.sort()).toEqual(['lib/parser.js', 'src/App.tsx']);
+    });
+    it('uses directory-based matching when rule has no paths and is in a subdirectory', () => {
+        const rule = makeRule('src/utils/naming-conventions.md');
+        const result = getSourceFilesForRule(rule, sourceFiles);
+        expect(result).toEqual(['src/utils/helpers.ts']);
+    });
+    it('does not use directory-based matching for root-level rules with no paths', () => {
+        const rule = makeRule('general.md');
+        expect(getSourceFilesForRule(rule, sourceFiles)).toEqual([]);
+    });
+});
+describe('doesPathMatchRule - directory-based matching', () => {
+    it('matches files in the same directory as the rule when no paths specified', () => {
+        const rule = makeRule('apps/web/modules/survey/editor/survey-editor-gotchas.md');
+        expect(doesPathMatchRule('apps/web/modules/survey/editor/SurveyEditor.tsx', rule)).toBe(true);
+    });
+    it('matches files in subdirectories of the rule directory', () => {
+        const rule = makeRule('apps/web/modules/survey/editor/survey-editor-gotchas.md');
+        expect(doesPathMatchRule('apps/web/modules/survey/editor/components/QuestionList.tsx', rule)).toBe(true);
+    });
+    it('does not match files outside the rule directory', () => {
+        const rule = makeRule('apps/web/modules/survey/editor/survey-editor-gotchas.md');
+        expect(doesPathMatchRule('apps/web/modules/survey/SurveyList.tsx', rule)).toBe(false);
+    });
+    it('does not use directory-based matching for root-level rules', () => {
+        const rule = makeRule('general-guidelines.md');
+        expect(doesPathMatchRule('src/index.ts', rule)).toBe(false);
+    });
+    it('explicit paths take precedence over directory-based matching', () => {
+        const rule = makeRule('src/utils/naming.md', ['**/*.tsx']);
+        // Should match based on explicit paths, not directory
+        expect(doesPathMatchRule('lib/Component.tsx', rule)).toBe(true);
+        // Should NOT match .ts files even though they are in src/utils/
+        expect(doesPathMatchRule('src/utils/helpers.ts', rule)).toBe(false);
+    });
+});
+//# sourceMappingURL=pathMatcher.test.js.map

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

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