mcp-adr-analysis-server 2.0.1 → 2.0.3

package/README.md

@@ -23,6 +23,8 @@ The Model Context Protocol enables seamless integration between AI assistants an
 📋 **ADR Management** - Generate, suggest, and maintain Architectural Decision Records
 🛡️ **Security & Compliance** - Detect and mask sensitive content automatically
 📊 **Workflow Automation** - Todo generation, deployment tracking, and rule validation
+🧪 **TDD Integration** - Two-phase Test-Driven Development with ADR linking and validation
+🔍 **Mock Detection** - Sophisticated analysis to distinguish mock from production code
 
 
 
@@ -37,12 +39,6 @@ npm install -g mcp-adr-analysis-server
 npm install mcp-adr-analysis-server
 ```
 
-### Using with uvx (Python-style)
-```bash
-# Run directly with uvx
-uvx mcp-adr-analysis-server@latest
-```
-
 ### From Source
 ```bash
 git clone https://github.com/tosin2013/mcp-adr-analysis-server.git
@@ -175,25 +171,6 @@ Add to `~/.codeium/windsurf/mcp_config.json`:
 }
 ```
 
-### Amazon Q CLI
-Add to `~/.aws/amazonq/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "adr-analysis": {
-      "command": "uvx",
-      "args": ["mcp-adr-analysis-server@latest"],
-      "env": {
-        "PROJECT_PATH": "/path/to/your/project",
-        "ADR_DIRECTORY": "docs/adrs",
-        "LOG_LEVEL": "ERROR"
-      }
-    }
-  }
-}
-```
-
 ## 🚀 Usage Examples
 
 ### Basic Project Analysis
@@ -220,10 +197,44 @@ const adrs = await generateAdrsFromPrd({
   template: "nygard"
 });
 
-// Generate actionable todos from ADRs
+// Generate actionable todos from ADRs with enhanced TDD approach
 const todos = await generateAdrTodo({
   adrDirectory: "docs/adrs",
-  outputPath: "todo.md"
+  outputPath: "todo.md",
+  phase: "both",           // Two-phase TDD: test + production
+  linkAdrs: true,          // Link all ADRs for system-wide coverage
+  includeRules: true       // Include architectural rules validation
+});
+```
+
+### Enhanced TDD Workflow
+```typescript
+// Phase 1: Generate comprehensive test specifications
+const testPhase = await generateAdrTodo({
+  adrDirectory: "docs/adrs",
+  outputPath: "todo-tests.md",
+  phase: "test",           // Generate mock test specifications
+  linkAdrs: true,          // Connect all ADRs for complete test coverage
+  includeRules: true       // Validate against architectural rules
+});
+
+// Phase 2: Generate production implementation tasks
+const prodPhase = await generateAdrTodo({
+  adrDirectory: "docs/adrs", 
+  outputPath: "todo-implementation.md",
+  phase: "production",     // Generate production-ready implementation tasks
+  linkAdrs: true,          // Ensure system-wide consistency
+  includeRules: true       // Enforce architectural compliance
+});
+
+// Validate progress and detect mock vs production code
+const validation = await compareAdrProgress({
+  todoPath: "todo.md",
+  adrDirectory: "docs/adrs",
+  projectPath: "/path/to/project",
+  deepCodeAnalysis: true,     // Distinguish mock from production code
+  functionalValidation: true, // Validate code actually works
+  strictMode: true           // Reality-check against LLM overconfidence
 });
 ```
 
@@ -257,15 +268,46 @@ const updatedAdrs = await incorporateResearch({
 });
 ```
 
+### Advanced Validation & Quality Assurance
+```typescript
+// Comprehensive validation with mock detection
+const qualityCheck = await compareAdrProgress({
+  todoPath: "todo.md",
+  adrDirectory: "docs/adrs",
+  projectPath: "/path/to/project",
+  
+  // Prevent LLM deception about code completeness
+  deepCodeAnalysis: true,        // Detects mock patterns vs real implementation
+  functionalValidation: true,    // Tests if code actually works
+  strictMode: true,             // Reality-check mechanisms
+  
+  // Advanced analysis options
+  includeTestCoverage: true,     // Validate test coverage meets ADR goals
+  validateDependencies: true,    // Check cross-ADR dependencies
+  environmentValidation: true    // Test in realistic environments
+});
+
+// Generate architectural rules from ADRs and patterns
+const rules = await generateRules({
+  source: "both",               // Extract from ADRs and code patterns
+  adrDirectory: "docs/adrs",
+  projectPath: "/path/to/project",
+  outputFormat: "json"          // Machine-readable format
+});
+```
+
 ## 🎯 Use Cases
 
 ### 👨‍💻 **AI Coding Assistants**
 *Enhance AI coding assistants like Cline, Cursor, and Claude Code*
 
+- **Test-Driven Development**: Two-phase TDD workflow with comprehensive ADR integration
 - **Intelligent Code Generation**: Generate code that follows architectural patterns and best practices
+- **Mock vs Production Detection**: Prevent AI assistants from claiming mock code is production-ready
 - **Architecture-Aware Refactoring**: Refactor code while maintaining architectural integrity
 - **Decision Documentation**: Automatically document architectural decisions as you code
 - **Pattern Recognition**: Identify and suggest architectural patterns for new features
+- **Quality Validation**: Reality-check mechanisms against overconfident AI assessments
 
 ### 💬 **Conversational AI Assistants**
 *Enhance chatbots and business agents with architectural intelligence*

package/dist/src/index.d.ts

@@ -37,6 +37,7 @@ export declare class McpAdrAnalysisServer {
     private getArchitecturalContext;
     private generateAdrsFromPrd;
     private generateAdrTodo;
+    private compareAdrProgress;
     /**
      * Content masking tool implementations
      */

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AA0BH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkC;;IAwBhD;;OAEG;YACW,qBAAqB;IAUnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqrCrB;;OAEG;YACW,sBAAsB;YAgGtB,mBAAmB;YAqMnB,sBAAsB;YAoPtB,uBAAuB;YAqUvB,uBAAuB;YA0PvB,mBAAmB;YA6RnB,eAAe;IAgK7B;;OAEG;YACW,sBAAsB;YAKtB,sBAAsB;YAKtB,uBAAuB;YAKvB,wBAAwB;YAKxB,sBAAsB;YAKtB,WAAW;YAkJX,sBAAsB;IAuHpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyF3B;;OAEG;YACW,WAAW;YAKX,uBAAuB;YAKvB,oBAAoB;IAKlC;;OAEG;YACW,mBAAmB;YAKnB,sBAAsB;YAKtB,yBAAyB;IAKvC;;OAEG;YACW,aAAa;YAKb,aAAa;YAKb,aAAa;IAK3B;;OAEG;YACW,kBAAkB;IAKhC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;YACW,YAAY;IAmF1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AAuCH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkC;;IAwBhD;;OAEG;YACW,qBAAqB;IAUnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAqwCrB;;OAEG;YACW,sBAAsB;YAgGtB,mBAAmB;YAqMnB,sBAAsB;YAoPtB,uBAAuB;YAqUvB,uBAAuB;YA0PvB,mBAAmB;YA6RnB,eAAe;YAkUf,kBAAkB;IAwZhC;;OAEG;YACW,sBAAsB;YAKtB,sBAAsB;YAKtB,uBAAuB;YAKvB,wBAAwB;YAKxB,sBAAsB;YAKtB,WAAW;YAkJX,sBAAsB;IAuHpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyF3B;;OAEG;YACW,WAAW;YAKX,uBAAuB;YAKvB,oBAAoB;IAKlC;;OAEG;YACW,mBAAmB;YAKnB,sBAAsB;YAKtB,yBAAyB;IAKvC;;OAEG;YACW,aAAa;YAKb,aAAa;YAKb,aAAa;IAK3B;;OAEG;YACW,kBAAkB;IAKhC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;YACW,YAAY;IAmF1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}