codexia 0.2.0

package/dist/cli/commands/hotpaths.js

@@ -0,0 +1,153 @@
+import { Command } from 'commander';
+import { CodexiaEngine } from '../engine.js';
+import { Formatter } from '../formatter.js';
+import chalk from 'chalk';
+export const hotpathsCommand = new Command('hotpaths')
+    .description('Detect and analyze critical code paths')
+    .option('-e, --entry <files>', 'Entry points (comma-separated)')
+    .option('--auto-detect', 'Auto-detect entry points', true)
+    .option('--top <n>', 'Show top N hot paths', '10')
+    .option('--min-score <score>', 'Minimum criticality score', '0.5')
+    .option('--trace <symbol>', 'Trace paths through specific symbol')
+    .option('--impact <file>', 'Show impact on hot paths for a file')
+    .addHelpText('after', `
+Examples:
+  $ codexia hotpaths                       Auto-detect and show hot paths
+  $ codexia hotpaths -e src/index.ts       Analyze from specific entry
+  $ codexia hotpaths --trace handleRequest Trace paths through symbol
+  $ codexia hotpaths --impact src/db.ts    Show how file affects hot paths
+`)
+    .action(async (options, command) => {
+    const globalOpts = command.parent?.opts() || {};
+    const formatter = new Formatter(globalOpts.json);
+    try {
+        const engine = new CodexiaEngine();
+        await engine.initialize();
+        const entryPoints = options.entry?.split(',');
+        const minScore = parseFloat(options.minScore);
+        const topN = parseInt(options.top);
+        const analysis = await engine.analyzeHotPaths({
+            entryPoints,
+            autoDetect: options.autoDetect && !entryPoints,
+            trace: options.trace,
+            impactFile: options.impact,
+        });
+        if (globalOpts.json) {
+            console.log(JSON.stringify(analysis, null, 2));
+            return;
+        }
+        console.log(chalk.bold.cyan('\n🔥 Hot Path Analysis\n'));
+        console.log(chalk.dim('─'.repeat(80)));
+        // Entry points - handle missing entryPoints gracefully
+        const detectedEntryPoints = analysis.entryPoints || [];
+        if (detectedEntryPoints.length > 0) {
+            console.log(chalk.bold('\\n📍 Entry Points Detected:\\n'));
+            for (const entry of detectedEntryPoints) {
+                console.log(`  ${chalk.green('●')} ${chalk.cyan(entry.file || entry)}`);
+                if (entry.type) {
+                    console.log(chalk.dim(`    Type: ${entry.type} | Exports: ${entry.exports?.join(', ') || 'default'}`));
+                }
+            }
+        }
+        else {
+            console.log(chalk.bold('\n📍 Entry Points:\n'));
+            console.log(chalk.dim('  No explicit entry points detected. Using dependency roots.\n'));
+        }
+        // Hot paths - engine returns 'paths' field
+        const hotPaths = analysis.paths || [];
+        // Hot paths
+        console.log(chalk.bold('\n🛤️  Critical Hot Paths:\n'));
+        const filteredPaths = hotPaths
+            .filter((p) => (p.criticalityScore || 0.5) >= minScore)
+            .slice(0, topN);
+        if (filteredPaths.length === 0) {
+            console.log(chalk.dim('  No hot paths detected above threshold.\n'));
+        }
+        else {
+            for (let i = 0; i < filteredPaths.length; i++) {
+                const path = filteredPaths[i];
+                const score = path.criticalityScore ?? 0.5;
+                const scoreBar = '█'.repeat(Math.round(score * 10));
+                const scoreColor = score >= 0.8 ? chalk.red :
+                    score >= 0.5 ? chalk.yellow :
+                        chalk.green;
+                console.log(`  ${chalk.bold(`#${i + 1}`)} ${chalk.cyan(path.name || path.id || 'Unnamed path')}`);
+                console.log(`    Score: ${scoreColor(scoreBar)} ${(score * 100).toFixed(0)}%`);
+                console.log(`    Criticality: ${path.criticality || 'medium'}`);
+                // Show path nodes if available
+                const nodes = path.nodes || [];
+                if (nodes.length > 0) {
+                    console.log(chalk.dim('    Path:'));
+                    for (let j = 0; j < Math.min(5, nodes.length); j++) {
+                        const node = nodes[j];
+                        const indent = '    ' + '  '.repeat(j);
+                        const arrow = j > 0 ? '↳ ' : '';
+                        const nodeName = node.symbol || node.path?.split('/').pop() || 'unknown';
+                        const fileName = node.file?.split('/').pop() || node.path?.split('/').pop() || '';
+                        console.log(chalk.dim(`${indent}${arrow}${nodeName}${fileName ? ` (${fileName})` : ''}`));
+                    }
+                    if (nodes.length > 5) {
+                        console.log(chalk.dim(`      ... +${nodes.length - 5} more nodes`));
+                    }
+                }
+                // Description if available
+                if (path.description) {
+                    console.log(chalk.dim(`    ${path.description}`));
+                }
+                // Risk factors
+                if (path.riskFactors?.length) {
+                    console.log(`    ${chalk.yellow('⚠')} Risks: ${path.riskFactors.join(', ')}`);
+                }
+                console.log();
+            }
+        }
+        // Trace results
+        if (options.trace && analysis.traceResults) {
+            console.log(chalk.bold(`\n🔍 Trace: ${options.trace}\n`));
+            if (analysis.traceResults.pathsThrough?.length) {
+                console.log(`  Found in ${chalk.yellow(analysis.traceResults.pathsThrough.length)} hot paths:`);
+                for (const path of analysis.traceResults.pathsThrough) {
+                    console.log(`    ${chalk.dim('•')} ${path.name} (score: ${(path.criticalityScore * 100).toFixed(0)}%)`);
+                }
+            }
+            else {
+                console.log(chalk.dim('  Symbol not found in any hot paths.\n'));
+            }
+        }
+        // Impact analysis
+        if (options.impact && analysis.impactAnalysis) {
+            console.log(chalk.bold(`\n💥 Impact of ${options.impact}:\n`));
+            const impact = analysis.impactAnalysis;
+            console.log(`  Hot paths affected: ${chalk.red(impact.hotPathsAffected)} of ${analysis.hotPaths.length}`);
+            console.log(`  Total impact score: ${chalk.yellow((impact.totalImpactScore * 100).toFixed(0))}%`);
+            if (impact.affectedPaths?.length) {
+                console.log(chalk.dim('\n  Affected paths:'));
+                for (const p of impact.affectedPaths.slice(0, 5)) {
+                    console.log(`    ${chalk.dim('•')} ${p.name}`);
+                }
+            }
+            if (impact.recommendations?.length) {
+                console.log(chalk.bold('\n  💡 Recommendations:'));
+                for (const rec of impact.recommendations) {
+                    console.log(`    ${chalk.yellow('•')} ${rec}`);
+                }
+            }
+        }
+        // Summary
+        console.log(chalk.dim('─'.repeat(80)));
+        console.log(chalk.bold('\n📊 Summary:\n'));
+        console.log(`  Total entry points:      ${chalk.yellow(detectedEntryPoints.length)}`);
+        console.log(`  Total hot paths:         ${chalk.yellow(hotPaths.length)}`);
+        console.log(`  Critical paths (>80%):   ${chalk.red(hotPaths.filter((p) => (p.criticalityScore || 0) >= 0.8).length)}`);
+        if (analysis.summary?.averageDepth !== undefined) {
+            console.log(`  Average path depth:      ${chalk.yellow(analysis.summary.averageDepth.toFixed(1))}`);
+            console.log(`  Max path depth:          ${chalk.yellow(analysis.summary.maxDepth)}`);
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(formatter.formatError(error));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=hotpaths.js.map

package/dist/cli/commands/hotpaths.js.map

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

package/dist/cli/commands/impact.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const impactCommand: Command;
+//# sourceMappingURL=impact.d.ts.map

package/dist/cli/commands/impact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,aAAa,SAmCtB,CAAC"}

package/dist/cli/commands/impact.js

@@ -0,0 +1,37 @@
+import { Command } from 'commander';
+import { CodexiaEngine } from '../engine.js';
+import { Formatter } from '../formatter.js';
+export const impactCommand = new Command('impact')
+    .description('Analyze impact of current git diff')
+    .option('-b, --base <ref>', 'Base ref for comparison', 'HEAD')
+    .option('--head <ref>', 'Head ref for comparison')
+    .option('--staged', 'Analyze only staged changes')
+    .addHelpText('after', `
+Examples:
+  $ codexia impact                        Analyze uncommitted changes
+  $ codexia impact --staged               Analyze staged changes only
+  $ codexia impact -b main                Compare current HEAD to main
+  $ codexia impact -b HEAD~3 --head HEAD  Compare last 3 commits
+  $ codexia impact --json                 Output as JSON
+`)
+    .action(async (options, command) => {
+    const globalOpts = command.parent?.opts() || {};
+    const formatter = new Formatter(globalOpts.json);
+    try {
+        const engine = new CodexiaEngine();
+        const impact = await engine.analyzeImpact({
+            base: options.base,
+            head: options.head,
+            staged: options.staged,
+        });
+        const diff = options.staged
+            ? await engine.getStagedDiff()
+            : await engine.getDiff(options.base, options.head);
+        console.log(formatter.formatImpact(impact, diff));
+    }
+    catch (error) {
+        console.error(formatter.formatError(error));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=impact.js.map

package/dist/cli/commands/impact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact.js","sourceRoot":"","sources":["../../../src/cli/commands/impact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC;KAC/C,WAAW,CAAC,oCAAoC,CAAC;KACjD,MAAM,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,CAAC;KAC7D,MAAM,CAAC,cAAc,EAAE,yBAAyB,CAAC;KACjD,MAAM,CAAC,UAAU,EAAE,6BAA6B,CAAC;KACjD,WAAW,CAAC,OAAO,EAAE;;;;;;;CAOvB,CAAC;KACC,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IACjC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAEnC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC;YACxC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM;YACzB,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,EAAE;YAC9B,CAAC,CAAC,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,CAAC,KAAc,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/cli/commands/init.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const initCommand: Command;
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsGpC,eAAO,MAAM,WAAW,SAwEpB,CAAC"}

package/dist/cli/commands/init.js

@@ -0,0 +1,167 @@
+import { Command } from 'commander';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import chalk from 'chalk';
+const TEMPLATES = {
+    architecture: `# Architecture
+
+## Layers
+
+- **CLI**: Command-line interface layer
+  - paths: \`src/cli/**\`
+  - depends on: Core, Modules
+
+- **Core**: Core domain logic and types
+  - paths: \`src/core/**\`
+  - depends on: (none)
+
+- **Modules**: Feature modules
+  - paths: \`src/modules/**\`
+  - depends on: Core
+
+## Boundaries
+
+- **Modules** cannot import **CLI**: Modules should be independent of CLI
+- **Core** cannot import **Modules**: Core should have no external dependencies
+- **Core** cannot import **CLI**: Core should have no external dependencies
+
+## Entry Points
+
+- \`src/cli/index.ts\`
+- \`src/core/index.ts\`
+
+## Critical Paths
+
+- User authentication flow
+- Data persistence layer
+`,
+    conventions: `# Conventions
+
+## Naming Conventions
+
+- Classes: \`PascalCase\`
+- Functions: \`camelCase\`
+- Constants: \`SCREAMING_SNAKE_CASE\`
+- Private fields: \`_prefixed\` or \`#private\`
+- Interfaces: \`IPrefixed\` or plain \`PascalCase\`
+- Type aliases: \`PascalCase\`
+
+## File Structure
+
+- One class/component per file
+- Test files adjacent to source: \`*.test.ts\` or \`*.spec.ts\`
+- Index files for public exports
+
+## Code Patterns
+
+- Use async/await over raw Promises
+- Prefer const over let
+- Use TypeScript strict mode
+- Export types from dedicated type files
+`,
+    invariants: `# Invariants
+
+These are rules that must NEVER be violated.
+
+### No direct database access from CLI
+
+The CLI layer must never directly access the database. All data access should go through the service layer.
+
+### All public APIs must be typed
+
+All exported functions and classes must have explicit TypeScript types. No \`any\` types in public APIs.
+
+### Tests required for critical paths
+
+All code in critical paths must have corresponding unit tests with >80% coverage.
+`,
+    adrTemplate: `# ADR-001: [Title]
+
+**Status:** Proposed
+**Date:** ${new Date().toISOString().split('T')[0]}
+
+## Context
+
+[Describe the context and problem statement]
+
+## Decision
+
+[Describe the decision that was made]
+
+## Consequences
+
+- [Positive consequence 1]
+- [Positive consequence 2]
+- [Negative consequence that was accepted]
+`,
+};
+export const initCommand = new Command('init')
+    .description('Initialize Codexia project memory (.codexia directory)')
+    .option('-f, --force', 'Overwrite existing files')
+    .addHelpText('after', `
+Examples:
+  $ codexia init          Create .codexia directory with templates
+  $ codexia init --force  Overwrite existing .codexia files
+`)
+    .action(async (options) => {
+    const cwd = process.cwd();
+    const codexiaDir = path.join(cwd, '.codexia');
+    const adrsDir = path.join(codexiaDir, 'adrs');
+    try {
+        // Check if directory exists
+        try {
+            await fs.access(codexiaDir);
+            if (!options.force) {
+                console.log(chalk.yellow('⚠') + ' .codexia directory already exists. Use --force to overwrite.');
+                return;
+            }
+        }
+        catch {
+            // Directory doesn't exist, continue
+        }
+        // Create directories
+        await fs.mkdir(codexiaDir, { recursive: true });
+        await fs.mkdir(adrsDir, { recursive: true });
+        // Write template files
+        const files = [
+            { path: path.join(codexiaDir, '.gitignore'), content: '# Auto-generated cache (contains local paths)\nindex-cache.json\n' },
+            { path: path.join(codexiaDir, 'architecture.md'), content: TEMPLATES.architecture },
+            { path: path.join(codexiaDir, 'conventions.md'), content: TEMPLATES.conventions },
+            { path: path.join(codexiaDir, 'invariants.md'), content: TEMPLATES.invariants },
+            { path: path.join(adrsDir, 'template.md'), content: TEMPLATES.adrTemplate },
+        ];
+        for (const file of files) {
+            let backupPath = null;
+            if (options.force) {
+                try {
+                    await fs.access(file.path);
+                    const ext = path.extname(file.path);
+                    const base = file.path.slice(0, file.path.length - ext.length);
+                    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+                    backupPath = `${base}.${timestamp}.bak${ext}`;
+                    await fs.rename(file.path, backupPath);
+                    console.log(chalk.yellow('⚠') +
+                        ` Existing ${path.relative(cwd, file.path)} backed up to ${path.relative(cwd, backupPath)}`);
+                }
+                catch {
+                    // File does not exist or cannot be accessed; no backup created
+                }
+            }
+            await fs.writeFile(file.path, file.content, 'utf-8');
+            console.log(chalk.green('✓') + ` Created ${path.relative(cwd, file.path)}`);
+        }
+        console.log('');
+        console.log(chalk.green('✓') + ' Codexia initialized successfully!');
+        console.log('');
+        console.log('Next steps:');
+        console.log('  1. Edit .codexia/architecture.md to define your project layers');
+        console.log('  2. Edit .codexia/conventions.md to set naming conventions');
+        console.log('  3. Run ' + chalk.cyan('codexia scan') + ' to index your repository');
+        console.log('');
+    }
+    catch (error) {
+        console.error(chalk.red('✗') + ` Failed to initialize: ${error.message}`);
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/commands/init.js.map

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

package/dist/cli/commands/invariants.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const invariantsCommand: Command;
+//# sourceMappingURL=invariants.d.ts.map

package/dist/cli/commands/invariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariants.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/invariants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,eAAO,MAAM,iBAAiB,SAiH1B,CAAC"}

package/dist/cli/commands/invariants.js

@@ -0,0 +1,176 @@
+import { Command } from 'commander';
+import { CodexiaEngine } from '../engine.js';
+import { Formatter } from '../formatter.js';
+import chalk from 'chalk';
+export const invariantsCommand = new Command('invariants')
+    .description('Check architectural invariants')
+    .option('-c, --config <file>', 'Invariants config file', 'codexia.invariants.yaml')
+    .option('--init', 'Generate example invariants config')
+    .option('--strict', 'Fail on any violation')
+    .option('--fix', 'Attempt to auto-fix violations where possible')
+    .option('--watch', 'Watch for changes and re-check')
+    .addHelpText('after', `
+Examples:
+  $ codexia invariants                     Check all invariants
+  $ codexia invariants --init              Generate example config
+  $ codexia invariants --strict            Fail on violations
+  $ codexia invariants -c rules.yaml       Use custom config file
+`)
+    .action(async (options, command) => {
+    const globalOpts = command.parent?.opts() || {};
+    const formatter = new Formatter(globalOpts.json);
+    try {
+        const engine = new CodexiaEngine();
+        // Generate example config
+        if (options.init) {
+            const exampleConfig = generateExampleConfig();
+            console.log(exampleConfig);
+            console.log(chalk.dim(`\n# Save this to ${options.config} and customize for your project`));
+            return;
+        }
+        await engine.initialize();
+        const results = await engine.checkInvariants({
+            configFile: options.config,
+            fix: options.fix,
+        });
+        if (globalOpts.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        console.log(chalk.bold.cyan('\n🛡️  Invariant Check Report\n'));
+        console.log(chalk.dim('─'.repeat(80)));
+        // Group by rule
+        const byRule = new Map();
+        for (const v of results.violations) {
+            const existing = byRule.get(v.rule) || [];
+            existing.push(v);
+            byRule.set(v.rule, existing);
+        }
+        if (results.violations.length === 0) {
+            console.log(chalk.green('\n✅ All invariants satisfied!\n'));
+            console.log(`  Rules checked: ${chalk.yellow(results.rulesChecked)}`);
+            console.log(`  Files scanned: ${chalk.yellow(results.filesScanned)}`);
+            console.log();
+            return;
+        }
+        // Show violations grouped by rule
+        for (const [rule, violations] of byRule) {
+            const ruleConfig = results.rules?.find((r) => r.name === rule);
+            const severityColor = ruleConfig?.severity === 'error' ? chalk.red :
+                ruleConfig?.severity === 'warning' ? chalk.yellow :
+                    chalk.dim;
+            console.log(`\n${severityColor('●')} ${chalk.bold(rule)}`);
+            if (ruleConfig?.description) {
+                console.log(chalk.dim(`  ${ruleConfig.description}`));
+            }
+            console.log();
+            for (const v of violations) {
+                const icon = v.severity === 'error' ? chalk.red('✗') :
+                    v.severity === 'warning' ? chalk.yellow('⚠') :
+                        chalk.dim('○');
+                console.log(`  ${icon} ${chalk.cyan(v.file)}${v.line ? `:${v.line}` : ''}`);
+                console.log(`    ${v.message}`);
+                if (v.suggestion) {
+                    console.log(chalk.dim(`    💡 ${v.suggestion}`));
+                }
+                if (v.fixed && options.fix) {
+                    console.log(chalk.green(`    ✓ Auto-fixed`));
+                }
+            }
+        }
+        // Summary
+        console.log(chalk.dim('\n─'.repeat(80)));
+        console.log(chalk.bold('\n📊 Summary:\n'));
+        const errors = results.violations.filter((v) => v.severity === 'error').length;
+        const warnings = results.violations.filter((v) => v.severity === 'warning').length;
+        const fixed = results.violations.filter((v) => v.fixed).length;
+        console.log(`  Rules checked:  ${chalk.yellow(results.rulesChecked)}`);
+        console.log(`  Files scanned:  ${chalk.yellow(results.filesScanned)}`);
+        console.log(`  Errors:         ${chalk.red(errors)}`);
+        console.log(`  Warnings:       ${chalk.yellow(warnings)}`);
+        if (options.fix) {
+            console.log(`  Auto-fixed:     ${chalk.green(fixed)}`);
+        }
+        console.log();
+        if (options.strict && errors > 0) {
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(formatter.formatError(error));
+        process.exit(1);
+    }
+});
+function generateExampleConfig() {
+    return `# Codexia Architectural Invariants
+# Define rules to enforce codebase conventions
+
+rules:
+  # Layer boundary rules
+  - name: no-ui-in-core
+    description: "Core modules should not import from UI layer"
+    type: no-import
+    from: "src/core/**"
+    target: "src/ui/**"
+    severity: error
+
+  - name: no-direct-db-access
+    description: "Only data layer can access database"
+    type: no-import
+    from: "src/!(data)/**"
+    target: "src/data/db/**"
+    severity: error
+
+  # Required dependencies
+  - name: controllers-use-services
+    description: "Controllers must use services, not repositories directly"
+    type: require-import
+    from: "src/controllers/**"
+    target: "src/services/**"
+    severity: warning
+
+  # Naming conventions
+  - name: test-file-naming
+    description: "Test files must end with .test.ts or .spec.ts"
+    type: naming-pattern
+    pattern: "src/**/*.test.ts|src/**/*.spec.ts"
+    exclude: "src/**/*.ts"
+    severity: warning
+
+  # Dependency limits
+  - name: max-dependencies
+    description: "No file should have more than 15 imports"
+    type: max-dependencies
+    max: 15
+    scope: "src/**"
+    severity: warning
+
+  # Annotation requirements
+  - name: public-api-docs
+    description: "Public API must have JSDoc comments"
+    type: annotation-required
+    scope: "src/api/**"
+    annotation: "@public"
+    exports: true
+    severity: error
+
+  # Custom layer boundaries
+  - name: clean-architecture
+    description: "Enforce clean architecture layers"
+    type: layer-boundary
+    layers:
+      - name: domain
+        pattern: "src/domain/**"
+      - name: application
+        pattern: "src/application/**"
+        canImport: [domain]
+      - name: infrastructure
+        pattern: "src/infrastructure/**"
+        canImport: [domain, application]
+      - name: presentation
+        pattern: "src/ui/**"
+        canImport: [application]
+    severity: error
+`;
+}
+//# sourceMappingURL=invariants.js.map

package/dist/cli/commands/invariants.js.map

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

package/dist/cli/commands/mcp-server.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const mcpServerCommand: Command;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/cli/commands/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,eAAO,MAAM,gBAAgB,SA+DzB,CAAC"}