openplanr 0.8.0 → 1.0.0

package/dist/ai/codebase/context-builder.js

@@ -1,14 +1,161 @@
 /**
  * Orchestrates codebase awareness into a single context string.
  *
- * Combines tech stack detection, folder tree, and related file snippets
- * into a formatted block for inclusion in AI prompts. Respects a token
- * budget (~8K tokens ≈ 32K chars) to avoid prompt overflow.
+ * Combines tech stack detection, folder tree, architecture files,
+ * and keyword-matched file snippets into a formatted block for
+ * inclusion in AI prompts. Respects a token budget to avoid overflow.
+ *
+ * Architecture files are always included — they define the patterns
+ * the AI must follow when generating implementation tasks.
  */
-import { findRelatedFiles, readFileSnippets } from './file-reader.js';
+import { readdir } from 'node:fs/promises';
+import path from 'node:path';
+import { logger } from '../../utils/logger.js';
+import { findRelatedFiles, readFileSnippets, readProjectFile } from './file-reader.js';
+import { detectPatternRules } from './pattern-rules.js';
+import { readProjectRules } from './rules-reader.js';
 import { detectTechStack, formatTechStack } from './stack-detector.js';
 import { generateFolderTree } from './tree-generator.js';
-const MAX_CONTEXT_CHARS = 32_000; // ~8K tokens
+const MAX_CONTEXT_CHARS = 48_000; // ~12K tokens (increased for architecture context)
+// ---------------------------------------------------------------------------
+// Architecture file discovery
+// ---------------------------------------------------------------------------
+/**
+ * Well-known file patterns that define a project's architecture.
+ * Ordered by priority — higher entries are included first when budget is tight.
+ */
+const ARCHITECTURE_PATTERNS = [
+    {
+        candidates: ['src/models/types.ts', 'src/types/index.ts', 'src/types.ts'],
+        label: 'Core type definitions — ALL interfaces, enums, and type aliases used across the project',
+        budget: 4_000,
+    },
+    {
+        candidates: [
+            'src/services/artifact-service.ts',
+            'src/services/crud-service.ts',
+            'src/services/data-service.ts',
+        ],
+        label: 'Main CRUD service — how entities are created, read, listed, and updated',
+        budget: 3_000,
+    },
+    {
+        candidates: ['src/services/id-service.ts', 'src/utils/id.ts'],
+        label: 'ID generation — how unique IDs are assigned to new entities',
+        budget: 2_000,
+    },
+    {
+        candidates: ['src/cli/index.ts', 'src/index.ts', 'src/main.ts', 'src/app.ts'],
+        label: 'Entry point — how commands/routes are registered and wired together',
+        budget: 2_000,
+    },
+    {
+        candidates: [
+            'src/cli/commands/quick.ts',
+            'src/cli/commands/task.ts',
+            'src/cli/commands/epic.ts',
+        ],
+        label: 'Example command — the pattern every new command should follow',
+        budget: 3_000,
+    },
+    {
+        candidates: ['src/services/config-service.ts', 'src/config.ts'],
+        label: 'Configuration — how project config is loaded and validated',
+        budget: 2_000,
+    },
+];
+/**
+ * Discover architecture files that exist in the project.
+ * Tries each candidate path per pattern — first match wins.
+ * Returns a map of relative paths → labeled, truncated content.
+ */
+export async function findArchitectureFiles(projectDir) {
+    const result = new Map();
+    for (const pattern of ARCHITECTURE_PATTERNS) {
+        for (const candidate of pattern.candidates) {
+            const content = await readProjectFile(projectDir, candidate);
+            if (content) {
+                const truncated = content.slice(0, pattern.budget);
+                result.set(candidate, `// ${pattern.label}\n${truncated}`);
+                break; // First match wins for this pattern
+            }
+        }
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Source file inventory
+// ---------------------------------------------------------------------------
+/**
+ * List all source files in key directories (services, commands, models, etc).
+ * Returns a compact string the AI can use to verify file paths exist.
+ * Unlike the folder tree, this is NEVER truncated — it's the source of truth.
+ */
+async function buildSourceInventory(projectDir) {
+    // Discover all src/ subdirectories dynamically instead of a hardcoded list
+    const srcDir = path.join(projectDir, 'src');
+    let topLevelDirs = [];
+    try {
+        const entries = await readdir(srcDir, { withFileTypes: true });
+        topLevelDirs = entries
+            .filter((e) => e.isDirectory() && !e.name.startsWith('.'))
+            .map((e) => `src/${e.name}`);
+    }
+    catch (err) {
+        logger.debug('Failed to read src directory for inventory', err);
+        return '';
+    }
+    // Expand into leaf directories (one level deep for nested dirs like src/ai/prompts)
+    const keyDirs = [];
+    for (const dir of topLevelDirs) {
+        const fullDir = path.join(projectDir, dir);
+        try {
+            const entries = await readdir(fullDir, { withFileTypes: true });
+            const hasSubDirs = entries.some((e) => e.isDirectory() && !e.name.startsWith('.'));
+            if (hasSubDirs) {
+                // Add subdirectories (e.g., src/ai/prompts, src/ai/schemas)
+                for (const e of entries) {
+                    if (e.isDirectory() && !e.name.startsWith('.')) {
+                        keyDirs.push(`${dir}/${e.name}`);
+                    }
+                }
+                // Also add files directly in this dir (e.g., src/ai/types.ts)
+                const hasFiles = entries.some((e) => e.isFile() && !e.name.startsWith('.'));
+                if (hasFiles)
+                    keyDirs.push(dir);
+            }
+            else {
+                keyDirs.push(dir);
+            }
+        }
+        catch (err) {
+            logger.debug('Failed to expand subdirectories for inventory', err);
+            keyDirs.push(dir);
+        }
+    }
+    const lines = [];
+    for (const dir of keyDirs.sort()) {
+        const fullDir = path.join(projectDir, dir);
+        try {
+            const entries = await readdir(fullDir, { withFileTypes: true });
+            const files = entries
+                .filter((e) => e.isFile() && !e.name.startsWith('.'))
+                .map((e) => e.name)
+                .sort();
+            if (files.length > 0) {
+                lines.push(`${dir}/: ${files.join(', ')}`);
+            }
+        }
+        catch (err) {
+            logger.debug('Failed to list directory files for inventory', err);
+            // Directory doesn't exist, skip
+        }
+    }
+    return lines.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
 /**
  * Build a complete codebase context for AI prompt enrichment.
  *
@@ -16,13 +163,29 @@ const MAX_CONTEXT_CHARS = 32_000; // ~8K tokens
  * @param keywords - Keywords to find related files (extracted from task/story)
  */
 export async function buildCodebaseContext(projectDir, keywords = []) {
-    const [techStack, folderTree, relatedPaths] = await Promise.all([
+    const [techStack, folderTree, sourceInventory, relatedPaths, architectureFiles, projectRules] = await Promise.all([
         detectTechStack(projectDir),
         generateFolderTree(projectDir, 3),
+        buildSourceInventory(projectDir),
         findRelatedFiles(projectDir, keywords, 8),
+        findArchitectureFiles(projectDir),
+        readProjectRules(projectDir),
     ]);
-    const relatedFiles = await readFileSnippets(projectDir, relatedPaths, 12_000);
-    return { techStack, folderTree, relatedFiles };
+    // Detect patterns from architecture files (sync, fast)
+    const patternRules = detectPatternRules(architectureFiles, sourceInventory);
+    // Remove architecture files from keyword results to avoid duplicates
+    const archPaths = new Set(architectureFiles.keys());
+    const filteredRelated = relatedPaths.filter((p) => !archPaths.has(p));
+    const relatedFiles = await readFileSnippets(projectDir, filteredRelated, 12_000);
+    return {
+        techStack,
+        folderTree,
+        sourceInventory,
+        architectureFiles,
+        relatedFiles,
+        projectRules,
+        patternRules,
+    };
 }
 /**
  * Format the codebase context into a prompt-friendly string.
@@ -30,11 +193,32 @@ export async function buildCodebaseContext(projectDir, keywords = []) {
  */
 export function formatCodebaseContext(ctx) {
     const sections = [];
+    // Priority 0: User-defined project rules (always included, never dropped)
+    if (ctx.projectRules) {
+        sections.push(`## Project Rules (MANDATORY — follow these exactly)\n${ctx.projectRules}`);
+    }
     // Priority 1: Tech stack (always included, small)
     if (ctx.techStack) {
         sections.push(`## Tech Stack\n${formatTechStack(ctx.techStack)}`);
     }
-    // Priority 2: Folder tree (truncated if needed)
+    // Priority 2: Architecture files (always included — defines project patterns)
+    if (ctx.architectureFiles.size > 0) {
+        const archBlocks = [];
+        for (const [filePath, content] of ctx.architectureFiles) {
+            archBlocks.push(`### ${filePath}\n\`\`\`\n${content}\n\`\`\``);
+        }
+        sections.push(`## Architecture (IMPORTANT: follow these patterns)\n${archBlocks.join('\n\n')}`);
+    }
+    // Priority 2.5: Auto-detected pattern rules
+    if (ctx.patternRules.length > 0) {
+        const ruleBlocks = ctx.patternRules.map((r) => `### ${r.name}\n**Rule:** ${r.rule}\n**Anti-pattern:** ${r.antiPattern}\n**Evidence:** ${r.evidence.join(', ')}`);
+        sections.push(`## Detected Project Patterns (MUST follow)\n${ruleBlocks.join('\n\n')}`);
+    }
+    // Priority 3: Source file inventory (compact, may be truncated by final budget cap)
+    if (ctx.sourceInventory) {
+        sections.push(`## Existing Source Files (ONLY reference files listed here or follow their naming pattern)\n${ctx.sourceInventory}`);
+    }
+    // Priority 4: Folder tree (truncated if needed)
     if (ctx.folderTree) {
         const treeLines = ctx.folderTree.split('\n');
         const maxLines = 60;
@@ -43,7 +227,7 @@ export function formatCodebaseContext(ctx) {
             : ctx.folderTree;
         sections.push(`## Project Structure\n\`\`\`\n${truncatedTree}\n\`\`\``);
     }
-    // Priority 3: Related file snippets (dropped if over budget)
+    // Priority 5: Keyword-matched file snippets (dropped first if over budget)
     if (ctx.relatedFiles.size > 0) {
         const fileBlocks = [];
         for (const [filePath, content] of ctx.relatedFiles) {
@@ -51,14 +235,18 @@ export function formatCodebaseContext(ctx) {
         }
         sections.push(`## Related Files\n${fileBlocks.join('\n\n')}`);
     }
-    // Apply budget
+    // Apply budget — drop from the end (lowest priority first)
+    // Possible sections (some may be absent): rules, tech stack, architecture, inventory, tree, related files
     let result = sections.join('\n\n');
     if (result.length > MAX_CONTEXT_CHARS) {
-        // Drop file snippets first, keep stack + tree
-        result = sections.slice(0, 2).join('\n\n');
+        // Drop related files first (last section)
+        result = sections.slice(0, -1).join('\n\n');
+    }
+    if (result.length > MAX_CONTEXT_CHARS) {
+        // Drop tree too (second-to-last remaining)
+        result = sections.slice(0, -2).join('\n\n');
     }
     if (result.length > MAX_CONTEXT_CHARS) {
-        // Even tree is too large, truncate aggressively
         result = `${result.slice(0, MAX_CONTEXT_CHARS)}\n... (context truncated)`;
     }
     return result;

package/dist/ai/codebase/context-builder.js.map

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

package/dist/ai/codebase/file-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/file-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoDH;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUxB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAmDD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,GAAE,MAAe,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgB9B"}
+{"version":3,"file":"file-reader.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/file-reader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAqDH;;;GAGG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWxB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,UAAU,GAAE,MAAW,GACtB,OAAO,CAAC,MAAM,EAAE,CAAC,CAQnB;AAqDD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,GAAE,MAAe,GAC3B,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgB9B"}

package/dist/ai/codebase/file-reader.js

@@ -6,6 +6,7 @@
  */
 import { readdir, readFile, stat } from 'node:fs/promises';
 import path from 'node:path';
+import { logger } from '../../utils/logger.js';
 const MAX_FILE_SIZE = 50_000; // 50KB per file
 const MAX_SNIPPET_CHARS = 3_000; // Truncate snippets to this length
 const SOURCE_EXTENSIONS = new Set([
@@ -62,7 +63,8 @@ export async function readProjectFile(projectDir, relativePath) {
             return null;
         return await readFile(fullPath, 'utf-8');
     }
-    catch {
+    catch (err) {
+        logger.debug('Failed to read project file', err);
         return null;
     }
 }
@@ -85,7 +87,8 @@ async function searchDir(rootDir, currentDir, keywords, matches, maxResults, dep
     try {
         entries = await readdir(currentDir);
     }
-    catch {
+    catch (err) {
+        logger.debug('Failed to read directory during file search', err);
         return;
     }
     for (const entry of entries) {
@@ -109,7 +112,8 @@ async function searchDir(rootDir, currentDir, keywords, matches, maxResults, dep
                 }
             }
         }
-        catch {
+        catch (err) {
+            logger.debug('Failed to stat file entry', err);
             // Skip inaccessible entries
         }
     }

package/dist/ai/codebase/file-reader.js.map

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

package/dist/ai/codebase/index.d.ts

@@ -1,5 +1,7 @@
-export { buildCodebaseContext, type CodebaseContext, extractKeywords, formatCodebaseContext, } from './context-builder.js';
+export { buildCodebaseContext, type CodebaseContext, extractKeywords, findArchitectureFiles, formatCodebaseContext, } from './context-builder.js';
 export { findRelatedFiles, readFileSnippets, readProjectFile } from './file-reader.js';
+export { detectPatternRules, type PatternRule } from './pattern-rules.js';
+export { readProjectRules } from './rules-reader.js';
 export { detectTechStack, formatTechStack, type TechStack } from './stack-detector.js';
 export { generateFolderTree } from './tree-generator.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/ai/codebase/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,KAAK,eAAe,EACpB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ai/codebase/index.js

@@ -1,5 +1,7 @@
-export { buildCodebaseContext, extractKeywords, formatCodebaseContext, } from './context-builder.js';
+export { buildCodebaseContext, extractKeywords, findArchitectureFiles, formatCodebaseContext, } from './context-builder.js';
 export { findRelatedFiles, readFileSnippets, readProjectFile } from './file-reader.js';
+export { detectPatternRules } from './pattern-rules.js';
+export { readProjectRules } from './rules-reader.js';
 export { detectTechStack, formatTechStack } from './stack-detector.js';
 export { generateFolderTree } from './tree-generator.js';
 //# sourceMappingURL=index.js.map

package/dist/ai/codebase/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/codebase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAEpB,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/ai/codebase/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EAEpB,eAAe,EACf,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAoB,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAkB,MAAM,qBAAqB,CAAC;AACvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/ai/codebase/pattern-rules.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Heuristic-based pattern detection from architecture files.
+ *
+ * Produces human-readable rules that are injected into AI prompts
+ * to prevent common mistakes like creating parallel CRUD services,
+ * forgetting to register commands, or scattering type definitions.
+ *
+ * Every detector is a pure function — fast, deterministic, no AI.
+ */
+export interface PatternRule {
+    /** Short identifier (e.g., "generic-crud"). */
+    name: string;
+    /** Rule text injected into the prompt. */
+    rule: string;
+    /** Which file(s) this was detected from. */
+    evidence: string[];
+    /** What NOT to do — helps the AI avoid common mistakes. */
+    antiPattern: string;
+}
+/**
+ * Detect architectural patterns from architecture file contents.
+ * Returns rules the AI should follow when generating tasks.
+ *
+ * @param architectureFiles - Map of relative path → labeled content (from findArchitectureFiles)
+ * @param sourceInventory - Compact source listing (from buildSourceInventory)
+ */
+export declare function detectPatternRules(architectureFiles: Map<string, string>, sourceInventory: string): PatternRule[];
+//# sourceMappingURL=pattern-rules.d.ts.map

package/dist/ai/codebase/pattern-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-rules.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/pattern-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,WAAW,EAAE,MAAM,CAAC;CACrB;AAkKD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACtC,eAAe,EAAE,MAAM,GACtB,WAAW,EAAE,CA0Bf"}

package/dist/ai/codebase/pattern-rules.js

@@ -0,0 +1,186 @@
+/**
+ * Heuristic-based pattern detection from architecture files.
+ *
+ * Produces human-readable rules that are injected into AI prompts
+ * to prevent common mistakes like creating parallel CRUD services,
+ * forgetting to register commands, or scattering type definitions.
+ *
+ * Every detector is a pure function — fast, deterministic, no AI.
+ */
+// ---------------------------------------------------------------------------
+// Utility helpers
+// ---------------------------------------------------------------------------
+/** Extract exported function names from TypeScript/JavaScript source. */
+function extractExportedFunctions(content) {
+    return [...content.matchAll(/export\s+(?:async\s+)?function\s+(\w+)/g)].map((m) => m[1]);
+}
+/** Extract exported type/interface names from TypeScript source. */
+function extractExportedTypes(content) {
+    return [...content.matchAll(/export\s+(?:type|interface)\s+(\w+)/g)].map((m) => m[1]);
+}
+/** Count individual files matching a pattern in the source inventory. */
+function countInventoryMatches(inventory, pattern) {
+    let count = 0;
+    for (const line of inventory.split('\n')) {
+        const colonIdx = line.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const fileList = line.slice(colonIdx + 1);
+        for (const file of fileList.split(',')) {
+            if (pattern.test(file.trim()))
+                count++;
+        }
+    }
+    return count;
+}
+// ---------------------------------------------------------------------------
+// Pattern detectors
+// ---------------------------------------------------------------------------
+/**
+ * Detect a generic CRUD service pattern.
+ *
+ * If the service exports only generic functions (create, read, list, update,
+ * delete) that take a `type` parameter and no entity-specific variants like
+ * `createUser()`, emit a rule forbidding entity-specific services.
+ */
+function detectGenericCRUD(filePath, content) {
+    const fns = extractExportedFunctions(content);
+    if (fns.length === 0)
+        return null;
+    const crudNames = /^(create|read|list|update|delete|get|find|remove)/i;
+    const crudFns = fns.filter((f) => crudNames.test(f));
+    if (crudFns.length < 2)
+        return null;
+    // Check if functions are entity-specific (createUser, deleteOrder) vs generic
+    // Generic names use abstract nouns: Artifact, Entry, Item, Record, Entity, Resource, Document, Object
+    const genericSuffixes = /^(create|read|list|update|delete|get|find|remove)(Artifact|Entry|Item|Record|Entity|Resource|Document|Object|Many|All|By)/i;
+    const entitySpecific = /^(create|read|list|update|delete|get|find|remove)[A-Z][a-z]{3,}/;
+    const hasEntitySpecific = crudFns.some((f) => entitySpecific.test(f) && !genericSuffixes.test(f));
+    if (hasEntitySpecific)
+        return null;
+    return {
+        name: 'generic-crud',
+        rule: `This project uses a generic CRUD service (${filePath}). All entity operations go through the generic functions: ${crudFns.join(', ')}. Business logic lives in command files or dedicated orchestration modules, NOT in this service.`,
+        evidence: [filePath],
+        antiPattern: `Do NOT create entity-specific CRUD functions (e.g., createBacklogItem, deleteUser) in ${filePath}. Use the existing generic functions with the appropriate type parameter.`,
+    };
+}
+/**
+ * Detect a command registration pattern.
+ *
+ * If the entry point file has `register*Command()` calls, emit a rule
+ * requiring new commands to follow the same pattern.
+ */
+function detectCommandRegistration(filePath, content) {
+    const registerCalls = content.match(/register\w+Command\s*\(/g);
+    if (!registerCalls || registerCalls.length < 2)
+        return null;
+    const names = registerCalls.map((c) => c.replace(/\s*\($/, ''));
+    return {
+        name: 'command-registration',
+        rule: `New commands MUST be registered in ${filePath} using the register<Name>Command() pattern. Existing registrations: ${names.join(', ')}.`,
+        evidence: [filePath],
+        antiPattern: `Do NOT create command files without also adding a register*Command() call in ${filePath}. A command file that isn't registered will never be reachable.`,
+    };
+}
+/**
+ * Detect a central types file pattern.
+ *
+ * If one types file contains 5+ exported types/interfaces and no other
+ * type files exist in the source inventory, emit a rule requiring all
+ * types to live in that file.
+ */
+function detectCentralTypes(filePath, content, sourceInventory) {
+    const types = extractExportedTypes(content);
+    if (types.length < 5)
+        return null;
+    // Check if there are other type files in the inventory
+    const otherTypeFiles = countInventoryMatches(sourceInventory, /types\.\w+|interfaces\.\w+/i);
+    // The central types file itself counts as 1 match
+    if (otherTypeFiles > 1)
+        return null;
+    return {
+        name: 'central-types',
+        rule: `All type definitions go in ${filePath} (currently has ${types.length} exports). Do NOT create new type files — add interfaces, enums, and type aliases to this file.`,
+        evidence: [filePath],
+        antiPattern: `Do NOT create files like types/<entity>.ts or interfaces/<entity>.ts. All types belong in ${filePath}.`,
+    };
+}
+/**
+ * Detect an ID generation pattern.
+ *
+ * If an id-service exports a function with "id" in its name that accepts
+ * a prefix parameter, emit a rule about configuring new prefixes.
+ */
+function detectIDGeneration(filePath, content) {
+    const fns = extractExportedFunctions(content);
+    const idFn = fns.find((f) => /id/i.test(f) && /next|generate|create/i.test(f));
+    if (!idFn)
+        return null;
+    // Look for prefix-related parameters or constants
+    const hasPrefix = /prefix/i.test(content);
+    if (!hasPrefix)
+        return null;
+    return {
+        name: 'id-generation',
+        rule: `IDs are generated via ${idFn}() in ${filePath} using configurable prefixes. New entity types MUST have their prefix registered in the project config (idPrefix map) and use ${idFn}() for ID assignment.`,
+        evidence: [filePath],
+        antiPattern: `Do NOT hardcode IDs or create separate ID generation logic. Always use ${idFn}() with the correct prefix.`,
+    };
+}
+/**
+ * Detect a template rendering pattern.
+ *
+ * If a templates directory contains Handlebars or similar template files,
+ * emit a rule requiring new artifact types to have corresponding templates.
+ */
+function detectTemplateRendering(sourceInventory) {
+    const templateLines = sourceInventory.split('\n').filter((line) => /templates/i.test(line));
+    if (templateLines.length === 0)
+        return null;
+    const hasHandlebars = templateLines.some((line) => /\.hbs/.test(line));
+    if (!hasHandlebars)
+        return null;
+    return {
+        name: 'template-rendering',
+        rule: 'This project uses Handlebars templates for artifact generation. New artifact types MUST have a corresponding .md.hbs template in the templates directory.',
+        evidence: templateLines.map((l) => l.split(':')[0].trim()),
+        antiPattern: 'Do NOT generate markdown directly in code. Create a .md.hbs template and use the template rendering service.',
+    };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Detect architectural patterns from architecture file contents.
+ * Returns rules the AI should follow when generating tasks.
+ *
+ * @param architectureFiles - Map of relative path → labeled content (from findArchitectureFiles)
+ * @param sourceInventory - Compact source listing (from buildSourceInventory)
+ */
+export function detectPatternRules(architectureFiles, sourceInventory) {
+    const rules = [];
+    for (const [filePath, labeledContent] of architectureFiles) {
+        // Strip the label comment line added by findArchitectureFiles
+        const content = labeledContent.replace(/^\/\/[^\n]*\n/, '');
+        // Try each detector against each architecture file
+        const crudRule = detectGenericCRUD(filePath, content);
+        if (crudRule)
+            rules.push(crudRule);
+        const cmdRule = detectCommandRegistration(filePath, content);
+        if (cmdRule)
+            rules.push(cmdRule);
+        const typesRule = detectCentralTypes(filePath, content, sourceInventory);
+        if (typesRule)
+            rules.push(typesRule);
+        const idRule = detectIDGeneration(filePath, content);
+        if (idRule)
+            rules.push(idRule);
+    }
+    // Template detection uses inventory only (not a specific architecture file)
+    const templateRule = detectTemplateRendering(sourceInventory);
+    if (templateRule)
+        rules.push(templateRule);
+    return rules;
+}
+//# sourceMappingURL=pattern-rules.js.map

package/dist/ai/codebase/pattern-rules.js.map

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

package/dist/ai/codebase/rules-reader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Reads project-specific rules from `.planr/rules.md`.
+ *
+ * These rules are injected directly into AI prompts so project
+ * owners can control how the AI generates tasks, names files,
+ * and follows architectural conventions — without modifying code.
+ */
+/**
+ * Read `.planr/rules.md` from the project directory.
+ *
+ * @returns The trimmed rules content, or `null` if the file doesn't exist or is empty.
+ */
+export declare function readProjectRules(projectDir: string): Promise<string | null>;
+//# sourceMappingURL=rules-reader.d.ts.map

package/dist/ai/codebase/rules-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules-reader.d.ts","sourceRoot":"","sources":["../../../src/ai/codebase/rules-reader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMjF"}