camouf 0.3.1 → 0.4.0

package/README.md

@@ -14,15 +14,89 @@ Camouf is a powerful, multi-language CLI tool for monitoring and enforcing softw
 - **Real-time Monitoring**: Watch mode for continuous architecture validation
 - **Multi-language Support**: TypeScript, JavaScript, Python, Java, Go, Rust
 - **Advanced Analysis**: Circular dependency detection, coupling metrics, hotspot identification
-- **12 Built-in Rules**: Comprehensive rule set for modern architectures
+- **13 Built-in Rules**: Comprehensive rule set for modern architectures
+- **AI Agent Safety**: Detects function/field name mismatches from AI context loss
 - **Security Scanning**: Detects hardcoded secrets, API keys, and credentials
 - **Multiple Report Formats**: HTML, JSON, Markdown, SARIF
 - **VS Code Integration**: Real-time Problems panel integration with custom tasks
 - **Highly Configurable**: JSON, YAML, or JavaScript configuration
 
+<p align="center">
+  <img src="docs/images/architecture-overview.svg" alt="Camouf Architecture Overview" width="800" />
+</p>
+
+---
+
+## Function Signature Matching: Catch AI Agent Errors
+
+AI coding agents like Claude Code and GitHub Copilot work with limited context windows.
+When generating frontend code without full visibility into backend contracts, they often
+use **similar but incorrect names** for functions and type fields.
+
+These errors compile successfully but cause runtime failures.
+
+### The Problem
+
+<p align="center">
+  <img src="docs/images/problem-flow.svg" alt="AI Context Loss Problem" width="800" />
+</p>
+
+### How Camouf Solves It
+
+Camouf's `function-signature-matching` rule scans your shared contracts and uses
+fuzzy matching to detect when code uses names that are *close but not exact*:
+
+<p align="center">
+  <img src="docs/images/camouf-workflow.svg" alt="Camouf Workflow" width="800" />
+</p>
+
+### Example Detection
+
+```
+Defined in shared/api.ts:15      Used in frontend/user.ts:42
+         getUserById(id)    ◄──────────    getUser(userId)
+                                  └── 75% similar, likely a typo
+```
+
+### Quick Fix Commands
+
+```bash
+# Interactive mode: confirm each fix
+npx camouf fix-signatures --interactive
+
+# Fix all mismatches automatically
+npx camouf fix-signatures --all
+
+# Fix a specific mismatch by ID
+npx camouf fix --id sig-001
+
+# Preview what would be fixed
+npx camouf fix-signatures --all --dry-run
+```
+
+### Interactive HTML Report
+
+Run validation to generate a report with clickable quick-fix commands:
+
+```bash
+npx camouf report --format html --output camouf-report/
+```
+
+The report shows:
+
+| Status | Type | Expected | Found | Quick Fix |
+|--------|------|----------|-------|-----------|
+| Error | Function | `getUserById` | `getUser` | `npx camouf fix --id sig-001` |
+| Error | Field | `email` | `userEmail` | `npx camouf fix --id sig-002` |
+
+See [AI Agent Challenges](docs/ai-agent-challenges.md) for a comprehensive guide on this feature.
+
+---
+
 ## Documentation
 
 - [Getting Started](docs/getting-started.md)
+- [AI Agent Challenges](docs/ai-agent-challenges.md) — How Camouf catches AI-generated code errors
 - [Configuring Rules](docs/configuring-rules.md)
 - [CI/CD Integration](docs/ci-cd-integration.md)
 - [Changelog](CHANGELOG.md)
@@ -152,6 +226,36 @@ Options:
   -f, --format <type>   Report format (html, json, markdown)
 ```
 
+### `camouf fix`
+
+Apply a single quick-fix by ID.
+
+```bash
+camouf fix [options]
+
+Options:
+  --id <id>            Quick-fix ID (e.g., sig-001)
+  -c, --config <path>  Path to configuration file
+  --dry-run            Preview changes without applying
+```
+
+### `camouf fix-signatures`
+
+Fix all function/field signature mismatches.
+
+```bash
+camouf fix-signatures [options]
+
+Options:
+  --all                 Fix all mismatches automatically
+  --interactive         Confirm each fix interactively
+  --file <path>         Fix only mismatches in specific file
+  --type <type>         Fix only function or field mismatches
+  -c, --config <path>   Path to configuration file
+  --dry-run             Preview changes without applying
+  --ci                  CI/agent mode: no prompts, use --all for auto-fix
+```
+
 ## Configuration
 
 ### Configuration File
@@ -195,6 +299,7 @@ Camouf supports multiple configuration formats:
     "builtin": {
       "layer-dependencies": "error",
       "circular-dependencies": "error",
+      "function-signature-matching": "error",
       "performance-antipatterns": "warn",
       "type-safety": "warn",
       "data-flow-integrity": "error",
@@ -223,6 +328,7 @@ Camouf supports multiple configuration formats:
 | `circular-dependencies` | Detects circular dependency cycles | `error` |
 | `contract-mismatch` | Validates API contracts (OpenAPI/GraphQL) | `error` |
 | `ddd-boundaries` | Validates DDD principles and bounded contexts | `warn` |
+| `function-signature-matching` | Detects mismatched function/field names between contracts and usage | `error` |
 
 ### Security Rules
 

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

@@ -0,0 +1,10 @@
+/**
+ * Fix Command
+ *
+ * Applies fixes for signature mismatches and other fixable violations.
+ * Supports both single fix by ID and batch operations.
+ */
+import { Command } from 'commander';
+export declare const fixCommand: Command;
+export declare const fixSignaturesCommand: Command;
+//# sourceMappingURL=fix.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fix.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/fix.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,eAAO,MAAM,UAAU,SAYnB,CAAC;AAEL,eAAO,MAAM,oBAAoB,SAgB7B,CAAC"}

package/dist/cli/commands/fix.js

@@ -0,0 +1,218 @@
+/**
+ * Fix Command
+ *
+ * Applies fixes for signature mismatches and other fixable violations.
+ * Supports both single fix by ID and batch operations.
+ */
+import { Command } from 'commander';
+import * as fs from 'fs';
+import * as path from 'path';
+import { ConfigurationManager } from '../../core/config/configuration-manager.js';
+import { ProjectScanner } from '../../core/scanner/project-scanner.js';
+import { RuleEngine } from '../../core/rules/rule-engine.js';
+import { Logger } from '../../core/logger.js';
+import ora from 'ora';
+export const fixCommand = new Command('fix')
+    .description('Fix signature mismatches and other fixable violations')
+    .option('-c, --config <path>', 'Path to configuration file')
+    .option('--id <id>', 'Fix specific mismatch by ID (e.g., sig-001)')
+    .option('--file <path>', 'Fix all mismatches in a specific file')
+    .option('--type <type>', 'Fix all mismatches of a specific type (function-name, parameter-name, type-field)')
+    .option('--all', 'Fix all signature mismatches')
+    .option('--interactive', 'Interactive mode: confirm each fix')
+    .option('--dry-run', 'Show what would be fixed without making changes')
+    .option('--ci', 'CI/agent mode: no prompts, no spinners')
+    .action(async (options) => {
+    await executeFixAction(options);
+});
+export const fixSignaturesCommand = new Command('fix-signatures')
+    .description('Fix function signature mismatches (alias for fix with signature options)')
+    .option('-c, --config <path>', 'Path to configuration file')
+    .option('--type <type>', 'Fix type: function-name, parameter-name, type-field')
+    .option('--file <path>', 'Fix all in specific file')
+    .option('--all', 'Fix all signature mismatches')
+    .option('--interactive', 'Interactive mode')
+    .option('--dry-run', 'Show what would be fixed')
+    .option('--ci', 'CI mode')
+    .action(async (options) => {
+    // Default to interactive if no mode specified
+    if (!options.type && !options.file && !options.all && !options.interactive) {
+        options.interactive = true;
+    }
+    // Execute the same action as fix command
+    await executeFixAction(options);
+});
+async function executeFixAction(options) {
+    const isCIMode = options.ci || !!process.env.CI || !!process.env.CAMOUF_CI;
+    const spinner = isCIMode ? null : ora('Loading configuration...').start();
+    try {
+        // Load configuration
+        const configManager = new ConfigurationManager();
+        const config = await configManager.loadConfig(options.config);
+        if (!config) {
+            if (spinner)
+                spinner.fail('No configuration found');
+            Logger.error('Run "npx camouf init" to initialize configuration.');
+            process.exit(1);
+        }
+        // Scan project and run function-signature-matching rule
+        if (spinner)
+            spinner.text = 'Scanning for signature mismatches...';
+        const scanner = new ProjectScanner(config);
+        const ruleEngine = new RuleEngine(config);
+        // Only run function-signature-matching rule
+        ruleEngine.filterRules(['function-signature-matching']);
+        const graph = await scanner.scan();
+        const fileContents = scanner.getFileContents();
+        const violations = await ruleEngine.validate(graph, fileContents);
+        if (spinner)
+            spinner.succeed(`Found ${violations.length} signature mismatches`);
+        if (violations.length === 0) {
+            if (!isCIMode)
+                Logger.success('\nNo signature mismatches found!\n');
+            return;
+        }
+        // Filter violations based on options
+        let targetViolations = violations.filter(v => v.ruleId === 'function-signature-matching');
+        if (options.id) {
+            targetViolations = targetViolations.filter(v => v.metadata?.mismatchId === options.id);
+        }
+        if (options.file) {
+            const targetPath = path.resolve(options.file);
+            targetViolations = targetViolations.filter(v => path.resolve(config.root, v.file).includes(targetPath));
+        }
+        if (options.type) {
+            targetViolations = targetViolations.filter(v => v.metadata?.mismatchType === options.type);
+        }
+        if (targetViolations.length === 0) {
+            Logger.warn('\nNo matching violations found with the given filters.\n');
+            return;
+        }
+        // If no action specified, show available fixes
+        if (!options.all && !options.interactive && !options.id) {
+            Logger.info('\nAvailable fixes:\n');
+            Logger.info('Usage:');
+            Logger.info('  npx camouf fix --id sig-001      # Fix specific mismatch');
+            Logger.info('  npx camouf fix --file src/api.ts # Fix all in file');
+            Logger.info('  npx camouf fix --type function-name # Fix by type');
+            Logger.info('  npx camouf fix --all             # Fix all mismatches');
+            Logger.info('  npx camouf fix --interactive     # Interactive mode\n');
+            // Show summary of mismatches
+            console.log('\nMismatches by type:');
+            const byType = new Map();
+            violations.forEach(v => {
+                const type = String(v.metadata?.mismatchType || 'unknown');
+                byType.set(type, (byType.get(type) || 0) + 1);
+            });
+            byType.forEach((count, type) => {
+                console.log(`  ${type}: ${count}`);
+            });
+            console.log('');
+            return;
+        }
+        // Apply fixes
+        const fixes = [];
+        for (const violation of targetViolations) {
+            if (!violation.metadata)
+                continue;
+            const { expected, found, mismatchId, mismatchType } = violation.metadata;
+            if (expected && found && typeof expected === 'string' && typeof found === 'string') {
+                fixes.push({
+                    id: String(mismatchId || 'unknown'),
+                    file: violation.file,
+                    line: violation.line || 0,
+                    oldText: found,
+                    newText: expected,
+                    type: String(mismatchType || 'unknown'),
+                });
+            }
+        }
+        if (fixes.length === 0) {
+            Logger.warn('\nNo fixes could be generated from the violations.\n');
+            return;
+        }
+        // Interactive mode
+        if (options.interactive && !isCIMode) {
+            Logger.info(`\nFound ${fixes.length} fixes to apply:\n`);
+            for (const fix of fixes) {
+                console.log(`  [${fix.id}] ${fix.file}:${fix.line}`);
+                console.log(`    ${fix.type}: "${fix.oldText}" → "${fix.newText}"`);
+            }
+            // In interactive mode, we'd use inquirer to confirm each fix
+            // For now, just show them
+            Logger.info('\nUse --all to apply all fixes, or --id <id> for specific fixes.\n');
+            return;
+        }
+        // Dry run mode
+        if (options.dryRun) {
+            Logger.info('\n[DRY RUN] Would apply the following fixes:\n');
+            for (const fix of fixes) {
+                console.log(`  [${fix.id}] ${fix.file}:${fix.line}`);
+                console.log(`    ${fix.type}: "${fix.oldText}" → "${fix.newText}"`);
+            }
+            Logger.info(`\n[DRY RUN] Would fix ${fixes.length} mismatch(es).\n`);
+            return;
+        }
+        // Group fixes by file
+        const fixesByFile = new Map();
+        for (const fix of fixes) {
+            const existing = fixesByFile.get(fix.file) || [];
+            existing.push(fix);
+            fixesByFile.set(fix.file, existing);
+        }
+        // Apply fixes
+        if (spinner)
+            spinner.text = 'Applying fixes...';
+        let appliedCount = 0;
+        for (const [filePath, fileFixes] of fixesByFile) {
+            try {
+                const absolutePath = path.resolve(config.root, filePath);
+                let content = fs.readFileSync(absolutePath, 'utf-8');
+                // Apply fixes in reverse line order to preserve line numbers
+                const sortedFixes = [...fileFixes].sort((a, b) => b.line - a.line);
+                for (const fix of sortedFixes) {
+                    // Replace the old text with new text (word boundary aware)
+                    const regex = new RegExp(`\\b${escapeRegExp(fix.oldText)}\\b`, 'g');
+                    const newContent = content.replace(regex, fix.newText);
+                    if (newContent !== content) {
+                        content = newContent;
+                        appliedCount++;
+                        if (!isCIMode) {
+                            Logger.info(`  Fixed: ${filePath}:${fix.line} - "${fix.oldText}" → "${fix.newText}"`);
+                        }
+                    }
+                }
+                // Write back
+                fs.writeFileSync(absolutePath, content, 'utf-8');
+            }
+            catch (error) {
+                Logger.error(`Failed to apply fixes to ${filePath}: ${error}`);
+            }
+        }
+        if (spinner)
+            spinner.succeed(`Applied ${appliedCount} fixes`);
+        // Output results
+        if (isCIMode) {
+            console.log(JSON.stringify({
+                applied: appliedCount,
+                total: fixes.length,
+                files: Array.from(fixesByFile.keys()),
+            }));
+        }
+        else {
+            Logger.success(`\nApplied ${appliedCount} fixes to ${fixesByFile.size} file(s).`);
+            Logger.info('Run "npx camouf validate" to verify the changes.\n');
+        }
+    }
+    catch (error) {
+        if (spinner)
+            spinner.fail(`Error: ${error}`);
+        else
+            console.error(`ERROR: ${error}`);
+        process.exit(1);
+    }
+}
+function escapeRegExp(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=fix.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,aAAa,SAwDtB,CAAC"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/report.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,eAAO,MAAM,aAAa,SAyDtB,CAAC"}

package/dist/cli/commands/report.js

@@ -38,7 +38,8 @@ export const reportCommand = new Command('report')
         spinner.succeed(`Scanned ${graph.nodeCount()} files`);
         // Validate
         spinner.start('Running validation...');
-        const violations = await ruleEngine.validate(graph);
+        const fileContents = scanner.getFileContents();
+        const violations = await ruleEngine.validate(graph, fileContents);
         spinner.succeed(`Found ${violations.length} violations`);
         // Generate report
         spinner.start('Generating report...');

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

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

package/dist/cli/index.js

@@ -11,6 +11,7 @@ import { watchCommand } from './commands/watch.js';
 import { validateCommand } from './commands/validate.js';
 import { analyzeCommand } from './commands/analyze.js';
 import { reportCommand } from './commands/report.js';
+import { fixCommand, fixSignaturesCommand } from './commands/fix.js';
 import { Logger } from '../core/logger.js';
 import { version, description } from './version.js';
 const program = new Command();
@@ -30,6 +31,8 @@ program.addCommand(watchCommand);
 program.addCommand(validateCommand);
 program.addCommand(analyzeCommand);
 program.addCommand(reportCommand);
+program.addCommand(fixCommand);
+program.addCommand(fixSignaturesCommand);
 // Error handling
 program.exitOverride((err) => {
     if (err.code === 'commander.help' || err.code === 'commander.version') {

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,WAAW,CAAC;KACxB,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,6BAA6B,CAAC,CAAC;AAEpE,iBAAiB;AACjB,OAAO;KACJ,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KAC3D,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC;KAC5C,MAAM,CAAC,UAAU,EAAE,mCAAmC,CAAC;KACvD,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;AAElD,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAElC,iBAAiB;AACjB,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE;IAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAyB,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;QAClF,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/C,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,QAAQ,CAAC;KACd,WAAW,CAAC,WAAW,CAAC;KACxB,OAAO,CAAC,OAAO,EAAE,eAAe,EAAE,6BAA6B,CAAC,CAAC;AAEpE,iBAAiB;AACjB,OAAO;KACJ,MAAM,CAAC,qBAAqB,EAAE,4BAA4B,CAAC;KAC3D,MAAM,CAAC,WAAW,EAAE,uBAAuB,CAAC;KAC5C,MAAM,CAAC,UAAU,EAAE,mCAAmC,CAAC;KACvD,MAAM,CAAC,YAAY,EAAE,wBAAwB,CAAC,CAAC;AAElD,oBAAoB;AACpB,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;AAChC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC;AACjC,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AACpC,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;AACnC,OAAO,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClC,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AAC/B,OAAO,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAEzC,iBAAiB;AACjB,OAAO,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,EAAE;IAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,gBAAgB,IAAI,GAAG,CAAC,IAAI,KAAK,mBAAmB,EAAE,CAAC;QACtE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,IAAI,KAAK,yBAAyB,IAAI,GAAG,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;QAClF,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,kBAAkB;AAClB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/C,MAAM,CAAC,KAAK,CAAC,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/cli/version.d.ts

@@ -1,7 +1,7 @@
 /**
  * Version and metadata for Camouf CLI
  */
-export declare const version = "0.3.1";
+export declare const version = "0.3.2";
 export declare const name = "camouf";
 export declare const description = "Real-time architecture monitoring CLI tool with multi-language support";
 export declare const metadata: {

package/dist/cli/version.js

@@ -1,7 +1,7 @@
 /**
  * Version and metadata for Camouf CLI
  */
-export const version = '0.3.1';
+export const version = '0.3.2';
 export const name = 'camouf';
 export const description = 'Real-time architecture monitoring CLI tool with multi-language support';
 export const metadata = {

package/dist/core/agents/agent-integrations.js

@@ -68,6 +68,15 @@ async function generateClaudeIntegration(projectRoot, result, options) {
     else {
         result.filesSkipped.push('.claude/commands/camouf-fix.md');
     }
+    // 3b. Generate .claude/commands/camouf-fix-signatures.md
+    const fixSignaturesCommandPath = path.join(claudeCommandsDir, 'camouf-fix-signatures.md');
+    if (!fs.existsSync(fixSignaturesCommandPath) || options.force) {
+        fs.writeFileSync(fixSignaturesCommandPath, getClaudeFixSignaturesCommand());
+        result.filesCreated.push('.claude/commands/camouf-fix-signatures.md');
+    }
+    else {
+        result.filesSkipped.push('.claude/commands/camouf-fix-signatures.md');
+    }
     // 4. Generate .claude/rules/camouf.md
     const claudeRulesDir = path.join(projectRoot, '.claude', 'rules');
     if (!fs.existsSync(claudeRulesDir)) {
@@ -113,7 +122,9 @@ function getClaudeMdContent() {
 This project uses [Camouf](https://www.npmjs.com/package/camouf) for real-time architecture monitoring.
 Camouf enforces architecture rules (layer dependencies, circular dependencies, security, DDD boundaries, and more).
 
-### Quick Commands
+### How to Run Camouf
+
+**Always use \`npx camouf\` to invoke the CLI.** Do NOT use \`node camouf.js\` or \`camouf\` directly.
 
 \`\`\`bash
 # One-shot validation (JSON output for parsing)
@@ -142,6 +153,7 @@ Camouf validates 12 builtin rules (configured in \`camouf.config.json\`):
 | \`api-versioning\` | API endpoints must include version prefix |
 | \`data-flow-integrity\` | Input validation and output sanitization required |
 | \`contract-mismatch\` | Shared types must be consistent across layers |
+| \`function-signature-matching\` | Function names and parameters must match across frontend/backend |
 | \`distributed-transactions\` | Multi-service calls need saga/compensation |
 | \`resilience-patterns\` | HTTP calls need timeout, retry, circuit breaker |
 
@@ -170,6 +182,8 @@ function getCamoufClaudeSection() {
 
 This project uses [Camouf](https://www.npmjs.com/package/camouf) for architecture monitoring.
 
+**Always use \`npx camouf\` to invoke the CLI.** Do NOT use \`node camouf.js\` or \`camouf\` directly.
+
 ### Quick Commands
 
 \`\`\`bash
@@ -191,7 +205,9 @@ description: Run Camouf architecture validation and fix any violations found
 allowed-tools: Read, Grep, Bash, Write
 ---
 
-Run Camouf to validate the project architecture:
+Run Camouf to validate the project architecture.
+
+**Important**: Always use \`npx camouf\` to run Camouf. Do NOT use \`node camouf.js\` or bare \`camouf\`.
 
 1. Execute: \`npx camouf validate --format json --ci\`
 2. Parse the JSON output to identify violations
@@ -215,7 +231,9 @@ description: Run Camouf and automatically fix all architecture violations
 allowed-tools: Read, Grep, Bash, Write
 ---
 
-Run Camouf to find and fix architecture violations:
+Run Camouf to find and fix architecture violations.
+
+**Important**: Always use \`npx camouf\` to run Camouf. Do NOT use \`node camouf.js\` or bare \`camouf\`.
 
 1. Execute: \`npx camouf validate --format json --ci\`
 2. Parse the JSON output
@@ -237,6 +255,75 @@ Run Camouf to find and fix architecture violations:
 - **security-context**: Add authentication/authorization guards to routes
 - **performance-antipatterns**: Replace N+1 queries with batch operations, sync I/O with async
 - **type-safety**: Replace \`any\` with proper types, add return type annotations
+- **function-signature-matching**: Rename functions/fields to match the shared contract definition
+`;
+}
+function getClaudeFixSignaturesCommand() {
+    return `---
+description: Fix function signature mismatches between frontend and backend code
+allowed-tools: Read, Grep, Bash, Write
+---
+
+Fix function signature mismatches detected by Camouf.
+
+**Important**: Always use \`npx camouf\` to run Camouf. Do NOT use \`node camouf.js\` or bare \`camouf\`.
+
+## Background
+
+AI coding agents often work with limited context windows and may create mismatched function names
+or type field names between frontend and backend code. For example:
+
+- Backend defines \`getUserById(id)\` but frontend calls \`getUser(userId)\`
+- Shared DTO has \`email\` field but frontend accesses \`userEmail\`
+
+These mismatches compile successfully but cause runtime errors.
+
+## Steps
+
+1. Run: \`npx camouf validate --format json --ci --rules function-signature-matching\`
+2. Parse the JSON output to find violations with \`ruleId: "function-signature-matching"\`
+3. For each violation:
+   - The \`metadata.expected\` field contains the correct name (as defined in shared contracts)
+   - The \`metadata.found\` field contains the incorrect name being used
+   - The \`metadata.definedIn\` shows where the correct definition is
+   - Read the file at \`violation.file\` line \`violation.line\`
+   - Rename \`found\` to \`expected\` in that location
+4. Re-run validation to confirm fixes
+5. Report summary of fixes applied
+
+## Alternative: Use the fix command
+
+You can also use Camouf's built-in fix command:
+
+\`\`\`bash
+# Interactive mode - confirm each fix
+npx camouf fix-signatures --interactive
+
+# Fix all automatically
+npx camouf fix-signatures --all
+
+# Fix specific mismatch by ID
+npx camouf fix --id sig-001
+
+# Dry run to see what would be fixed
+npx camouf fix-signatures --all --dry-run
+\`\`\`
+
+## Example Violation
+
+\`\`\`json
+{
+  "ruleId": "function-signature-matching",
+  "message": "Function name mismatch: 'getUser' called but 'getUserById' is defined",
+  "file": "src/frontend/api.ts",
+  "line": 42,
+  "metadata": {
+    "expected": "getUserById",
+    "found": "getUser",
+    "definedIn": { "file": "src/shared/api-contracts.ts", "line": 15 }
+  }
+}
+\`\`\`
 `;
 }
 function getClaudeRule() {
@@ -255,6 +342,8 @@ When writing or modifying code in this project, follow these architecture princi
 - Validate all user inputs before processing
 - Add timeout, retry, and error handling to external HTTP calls
 
+**Always use \`npx camouf\` to invoke the CLI.** Do NOT use \`node camouf.js\` or bare \`camouf\`.
+
 Run \`npx camouf validate --format json --ci\` to check compliance.
 `;
 }
@@ -266,6 +355,8 @@ function getAgentsMdContent() {
 This project uses [Camouf](https://www.npmjs.com/package/camouf) for real-time architecture monitoring.
 Camouf enforces architecture rules and catches violations before they reach production.
 
+**Always use \`npx camouf\` to invoke the CLI.** Do NOT use \`node camouf.js\` or bare \`camouf\`.
+
 ### Commands
 
 \`\`\`bash
@@ -320,9 +411,25 @@ The following rules are enforced (configured in \`camouf.config.json\`):
 - \`api-versioning\` — API endpoints must include version prefix
 - \`data-flow-integrity\` — Input validation and output sanitization
 - \`contract-mismatch\` — Shared types must be consistent
+- \`function-signature-matching\` — Function/field names must match across frontend/backend
 - \`distributed-transactions\` — Multi-service calls need saga/compensation
 - \`resilience-patterns\` — HTTP calls need timeout, retry, circuit breaker
 
+### Signature Mismatch Fixing
+
+Camouf can detect and fix function/field name mismatches caused by AI context loss:
+
+\`\`\`bash
+# Find signature mismatches
+npx camouf validate --format json --ci --rules function-signature-matching
+
+# Fix all mismatches
+npx camouf fix-signatures --all
+
+# Fix single mismatch
+npx camouf fix --id sig-001
+\`\`\`
+
 ### Workflow
 
 1. Before committing code changes, run \`npx camouf validate --format json --ci\`
@@ -345,6 +452,8 @@ function getCamoufAgentsSection() {
 
 This project uses [Camouf](https://www.npmjs.com/package/camouf) for architecture monitoring.
 
+**Always use \`npx camouf\` to invoke the CLI.** Do NOT use \`node camouf.js\` or bare \`camouf\`.
+
 ### Commands
 
 \`\`\`bash