cadr-cli 2.0.0 → 2.0.1

package/dist/llm/response-parser.d.ts

@@ -0,0 +1,9 @@
+export interface ParsedAnalysisResponse {
+    is_significant: boolean;
+    reason: string;
+    confidence?: number;
+}
+export declare function parseAnalysisResponse(responseContent: string): ParsedAnalysisResponse;
+export declare function extractTitleFromMarkdown(content: string): string;
+export declare function parseLLMResponse<T>(responseContent: string, validator: (parsed: unknown) => T): T;
+//# sourceMappingURL=response-parser.d.ts.map

package/dist/llm/response-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-parser.d.ts","sourceRoot":"","sources":["../../src/llm/response-parser.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,eAAe,EAAE,MAAM,GAAG,sBAAsB,CA0CrF;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUhE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAyBjG"}

package/dist/llm/response-parser.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAnalysisResponse = parseAnalysisResponse;
+exports.extractTitleFromMarkdown = extractTitleFromMarkdown;
+exports.parseLLMResponse = parseLLMResponse;
+const logger_1 = require("../logger");
+function parseAnalysisResponse(responseContent) {
+    let jsonContent = responseContent.trim();
+    const codeBlockMatch = jsonContent.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+    if (codeBlockMatch) {
+        jsonContent = codeBlockMatch[1].trim();
+    }
+    const jsonMatch = jsonContent.match(/\{[\s\S]*\}/);
+    if (jsonMatch) {
+        jsonContent = jsonMatch[0];
+    }
+    const parsedResponse = JSON.parse(jsonContent);
+    if (typeof parsedResponse.is_significant !== 'boolean' ||
+        typeof parsedResponse.reason !== 'string') {
+        throw new Error(`Invalid response format. Expected {is_significant: boolean, reason: string}, got: ${JSON.stringify(parsedResponse).substring(0, 150)}...`);
+    }
+    if (parsedResponse.is_significant && !parsedResponse.reason) {
+        throw new Error('LLM indicated significant change but provided no reason');
+    }
+    const result = {
+        is_significant: parsedResponse.is_significant,
+        reason: parsedResponse.reason,
+    };
+    if (typeof parsedResponse.confidence === 'number' &&
+        parsedResponse.confidence >= 0 &&
+        parsedResponse.confidence <= 1) {
+        result.confidence = parsedResponse.confidence;
+    }
+    return result;
+}
+function extractTitleFromMarkdown(content) {
+    let cleanedContent = content.trim();
+    const codeBlockMatch = cleanedContent.match(/```(?:markdown|md)?\s*\n?([\s\S]*?)\n?```/);
+    if (codeBlockMatch) {
+        cleanedContent = codeBlockMatch[1].trim();
+    }
+    const titleMatch = cleanedContent.match(/^#\s+(.+)$/m);
+    return titleMatch ? titleMatch[1].trim() : 'Untitled Decision';
+}
+function parseLLMResponse(responseContent, validator) {
+    try {
+        let jsonContent = responseContent.trim();
+        const codeBlockMatch = jsonContent.match(/```(?:json)?\s*\n?([\s\S]*?)\n?```/);
+        if (codeBlockMatch) {
+            jsonContent = codeBlockMatch[1].trim();
+        }
+        const jsonMatch = jsonContent.match(/\{[\s\S]*\}/);
+        if (jsonMatch) {
+            jsonContent = jsonMatch[0];
+        }
+        const parsed = JSON.parse(jsonContent);
+        return validator(parsed);
+    }
+    catch (parseError) {
+        logger_1.loggerInstance.warn('Failed to parse LLM response as JSON', {
+            error: parseError,
+            response: responseContent,
+        });
+        throw new Error(`Failed to parse LLM response as JSON. Response was:\n${responseContent.substring(0, 200)}...`);
+    }
+}
+//# sourceMappingURL=response-parser.js.map

package/dist/llm/response-parser.js.map

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

package/dist/presenters/console-presenter.d.ts

@@ -0,0 +1,35 @@
+export interface AnalysisSummary {
+    fileCount: number;
+    mode: string;
+    isSignificant: boolean;
+    reason: string;
+    confidence?: number;
+    filePath?: string;
+    title?: string;
+}
+export interface DiffOptions {
+    mode: 'staged' | 'all' | 'branch-diff';
+    base?: string;
+    head?: string;
+}
+export declare class ConsolePresenter {
+    showConfigError(): void;
+    showGitError(message: string): void;
+    showReadFilesError(): void;
+    showNoChanges(options: DiffOptions): void;
+    showAnalyzingFiles(files: string[], options: DiffOptions): void;
+    showNoDiffContent(): void;
+    showSendingToLLM(options: DiffOptions, provider: string, model: string): void;
+    showAnalysisFailed(error?: string): void;
+    showAnalysisComplete(): void;
+    showSignificantResult(summary: AnalysisSummary): void;
+    showNotSignificantResult(summary: AnalysisSummary): void;
+    showGeneratingADR(): void;
+    showGenerationFailed(error?: string): void;
+    showADRSuccess(filePath: string): void;
+    showADRSaveError(error?: string): void;
+    showSkippingGeneration(): void;
+    showUnexpectedError(): void;
+}
+export declare const presenter: ConsolePresenter;
+//# sourceMappingURL=console-presenter.d.ts.map

package/dist/presenters/console-presenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-presenter.d.ts","sourceRoot":"","sources":["../../src/presenters/console-presenter.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,aAAa,CAAC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,gBAAgB;IAC3B,eAAe,IAAI,IAAI;IAMvB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAInC,kBAAkB,IAAI,IAAI;IAI1B,aAAa,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAwBzC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI;IAoB/D,iBAAiB,IAAI,IAAI;IAIzB,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAY7E,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAKxC,oBAAoB,IAAI,IAAI;IAI5B,qBAAqB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAQrD,wBAAwB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IASxD,iBAAiB,IAAI,IAAI;IAIzB,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAK1C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQtC,gBAAgB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAKtC,sBAAsB,IAAI,IAAI;IAK9B,mBAAmB,IAAI,IAAI;CAI5B;AAED,eAAO,MAAM,SAAS,kBAAyB,CAAC"}

package/dist/presenters/console-presenter.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.presenter = exports.ConsolePresenter = void 0;
+class ConsolePresenter {
+    showConfigError() {
+        console.error('\n❌ Configuration Error');
+        console.error('Configuration file not found or invalid.');
+        console.error('\n💡 Run `cadr init` to create a configuration file.\n');
+    }
+    showGitError(message) {
+        console.error(`\n❌ Git Error: ${message}\n`);
+    }
+    showReadFilesError() {
+        console.error('\n❌ Failed to read changed files\n');
+    }
+    showNoChanges(options) {
+        const modeText = options.mode === 'staged'
+            ? 'staged'
+            : options.mode === 'branch-diff'
+                ? `between ${options.base || 'origin/main'} and ${options.head || 'HEAD'}`
+                : 'uncommitted';
+        console.log(`\nℹ️  No changes to analyze ${options.mode === 'branch-diff' ? modeText : `(${modeText})`}`);
+        if (options.mode === 'staged') {
+            console.log('💡 Stage some files first:');
+            console.log('   git add <files>');
+            console.log('   cadr analyze --staged\n');
+        }
+        else if (options.mode === 'branch-diff') {
+            console.log('💡 No changes found between specified git references.\n');
+        }
+        else {
+            console.log('💡 Make some changes first, then run:');
+            console.log('   cadr analyze\n');
+        }
+    }
+    showAnalyzingFiles(files, options) {
+        const modeText = options.mode === 'staged'
+            ? 'staged'
+            : options.mode === 'branch-diff'
+                ? `between ${options.base || 'origin/main'} and ${options.head || 'HEAD'}`
+                : 'uncommitted';
+        const fileCountText = options.mode === 'branch-diff'
+            ? `${files.length} file${files.length === 1 ? '' : 's'} changed ${modeText}`
+            : `${files.length} ${modeText} file${files.length === 1 ? '' : 's'}`;
+        console.log(`\n📝 Analyzing ${fileCountText}:`);
+        files.forEach((file) => {
+            console.log(`  • ${file}`);
+        });
+        console.log('');
+    }
+    showNoDiffContent() {
+        console.log('\nℹ️  No diff content found\n');
+    }
+    showSendingToLLM(options, provider, model) {
+        const analysisText = options.mode === 'staged'
+            ? 'staged changes'
+            : options.mode === 'branch-diff'
+                ? 'changes'
+                : 'uncommitted changes';
+        console.log(`🔍 Analyzing ${analysisText} for architectural significance...\n`);
+        console.log(`🤖 Sending to ${provider} ${model}...\n`);
+    }
+    showAnalysisFailed(error) {
+        console.error('\n❌ Analysis failed');
+        console.error(`\n${error || 'Unknown error occurred'}\n`);
+    }
+    showAnalysisComplete() {
+        console.log('✅ Analysis Complete\n');
+    }
+    showSignificantResult(summary) {
+        console.log('📊 Result: ✨ ARCHITECTURALLY SIGNIFICANT');
+        console.log(`💭 Reasoning: ${summary.reason}\n`);
+        if (summary.confidence) {
+            console.log(`🎯 Confidence: ${(summary.confidence * 100).toFixed(0)}%\n`);
+        }
+    }
+    showNotSignificantResult(summary) {
+        console.log('📊 Result: ℹ️  NOT ARCHITECTURALLY SIGNIFICANT');
+        console.log(`💭 Reasoning: ${summary.reason}\n`);
+        if (summary.confidence) {
+            console.log(`🎯 Confidence: ${(summary.confidence * 100).toFixed(0)}%\n`);
+        }
+        console.log('✅ No ADR needed for these changes.\n');
+    }
+    showGeneratingADR() {
+        console.log('\n🧠 Generating ADR draft...\n');
+    }
+    showGenerationFailed(error) {
+        console.error('\n❌ ADR generation failed');
+        console.error(`\n${error || 'Unknown error occurred'}\n`);
+    }
+    showADRSuccess(filePath) {
+        console.log('✅ Success! Draft ADR created\n');
+        console.log(`📄 File: ${filePath}\n`);
+        console.log('💡 Next steps:');
+        console.log('   1. Review and refine the generated ADR');
+        console.log('   2. Commit it alongside your code changes\n');
+    }
+    showADRSaveError(error) {
+        console.error('\n❌ Failed to save ADR');
+        console.error(`\n${error || 'Unknown error occurred'}\n`);
+    }
+    showSkippingGeneration() {
+        console.log('\n📋 Skipping ADR generation');
+        console.log('🎯 Recommendation: Consider documenting this decision manually.\n');
+    }
+    showUnexpectedError() {
+        console.error('\n❌ An unexpected error occurred');
+        console.error('Please check the logs for more details.\n');
+    }
+}
+exports.ConsolePresenter = ConsolePresenter;
+exports.presenter = new ConsolePresenter();
+//# sourceMappingURL=console-presenter.js.map

package/dist/presenters/console-presenter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cadr-cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Continuous Architectural Decision Records - Automatically capture ADRs as you code",
   "main": "dist/index.js",
   "bin": {

package/src/{adr.test.ts → adr/adr.test.ts}

@@ -1,8 +1,5 @@
 /**
  * ADR File Management Module Tests
- * 
- * Tests for ADR file creation, numbering, and management.
- * Following TDD: These tests are written BEFORE implementation.
  */
 
 import * as fs from 'fs';
@@ -20,14 +17,12 @@ describe('ADR Module', () => {
   const testDir = path.join(__dirname, '../test-adrs');
 
   beforeEach(() => {
-    // Clean up test directory before each test
     if (fs.existsSync(testDir)) {
       fs.rmSync(testDir, { recursive: true, force: true });
     }
   });
 
   afterEach(() => {
-    // Clean up test directory after each test
     if (fs.existsSync(testDir)) {
       fs.rmSync(testDir, { recursive: true, force: true });
     }
@@ -187,14 +182,15 @@ describe('ADR Module', () => {
       expect(result1.filePath).toContain('0001-first.md');
       expect(result2.filePath).toContain('0002-second.md');
       expect(result3.filePath).toContain('0003-third.md');
-      
+
       expect(fs.existsSync(result1.filePath!)).toBe(true);
       expect(fs.existsSync(result2.filePath!)).toBe(true);
       expect(fs.existsSync(result3.filePath!)).toBe(true);
     });
 
     it('saves correct content to file', () => {
-      const content = '# My Decision\n\n* Status: accepted\n* Date: 2025-10-21\n\n## Context\n\nSome context here.';
+      const content =
+        '# My Decision\n\n* Status: accepted\n* Date: 2025-10-21\n\n## Context\n\nSome context here.';
       const result = saveADR(content, 'My Decision', testDir);
 
       const savedContent = fs.readFileSync(result.filePath!, 'utf-8');
@@ -202,7 +198,6 @@ describe('ADR Module', () => {
     });
 
     it('uses default directory when not specified', () => {
-      // Clean up default directory
       const defaultPath = path.join(process.cwd(), DEFAULT_ADR_DIR);
       if (fs.existsSync(defaultPath)) {
         fs.rmSync(defaultPath, { recursive: true, force: true });
@@ -213,44 +208,38 @@ describe('ADR Module', () => {
 
       expect(result.success).toBe(true);
       expect(result.filePath).toContain(DEFAULT_ADR_DIR);
-      
-      // Cleanup
+
       if (fs.existsSync(defaultPath)) {
         fs.rmSync(defaultPath, { recursive: true, force: true });
       }
     });
 
     it('handles file write errors gracefully', () => {
-      // Create a read-only directory to trigger write error
       fs.mkdirSync(testDir, { recursive: true });
-      
-      // Make directory read-only (if not Windows)
+
       if (process.platform !== 'win32') {
         fs.chmodSync(testDir, 0o444);
-        
+
         const content = '# Test\n\nContent';
         const result = saveADR(content, 'Test', testDir);
 
         expect(result.success).toBe(false);
         expect(result.error).toBeDefined();
         expect(result.filePath).toBeUndefined();
-        
-        // Restore permissions for cleanup
+
         fs.chmodSync(testDir, 0o755);
       } else {
-        // On Windows, just verify error handling structure exists
-        // Skip actual permission test as Windows permissions work differently
         const content = '# Test\n\nContent';
         const result = saveADR(content, 'Test', testDir);
-        
-        // Should succeed on Windows since we can't easily simulate permission errors
+
         expect(result).toHaveProperty('success');
         expect(typeof result.success).toBe('boolean');
       }
     });
 
     it('handles long titles correctly', () => {
-      const longTitle = 'This is a very long title that should still work correctly when converted to a filename slug';
+      const longTitle =
+        'This is a very long title that should still work correctly when converted to a filename slug';
       const content = `# ${longTitle}\n\nContent`;
       const result = saveADR(content, longTitle, testDir);
 
@@ -263,7 +252,6 @@ describe('ADR Module', () => {
       const result = saveADR(content, 'Decision with émojis 🚀', testDir);
 
       expect(result.success).toBe(true);
-      // Should strip unicode to safe characters
       expect(result.filePath).toMatch(/0001-.+\.md$/);
     });
   });
@@ -275,4 +263,3 @@ describe('ADR Module', () => {
     });
   });
 });
-

package/src/{adr.ts → adr/adr.ts}

@@ -1,46 +1,32 @@
 /**
  * ADR File Management Module
- * 
+ *
  * Handles creation and management of Architectural Decision Record files.
  * Follows MADR (Markdown Architectural Decision Records) format.
  */
 
 import * as fs from 'fs';
 import * as path from 'path';
-import { loggerInstance as logger } from './logger';
+import { loggerInstance as logger } from '../logger';
 
-/**
- * Default ADR directory relative to project root
- */
 export const DEFAULT_ADR_DIR = 'docs/adr';
 
-/**
- * Convert a title to a filename-safe slug
- * Example: "Use PostgreSQL for Storage" -> "use-postgresql-for-storage"
- */
 export function titleToSlug(title: string): string {
   return title
     .toLowerCase()
-    .replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with hyphens
-    .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
 }
 
-/**
- * Get the next ADR number by scanning existing ADR files
- * 
- * @param adrDir - Directory containing ADR files
- * @returns Next available ADR number (e.g., 1, 2, 3...)
- */
 export function getNextADRNumber(adrDir: string): number {
   try {
     if (!fs.existsSync(adrDir)) {
-      return 1; // First ADR
+      return 1;
     }
 
     const files = fs.readdirSync(adrDir);
     const adrNumbers: number[] = [];
 
-    // Extract numbers from existing ADR files (format: 0001-title.md)
     for (const file of files) {
       const match = file.match(/^(\d{4})-/);
       if (match) {
@@ -52,7 +38,6 @@ export function getNextADRNumber(adrDir: string): number {
       return 1;
     }
 
-    // Return next number after the highest existing number
     return Math.max(...adrNumbers) + 1;
   } catch (error) {
     logger.warn('Failed to scan existing ADRs, defaulting to 1', { error, adrDir });
@@ -60,11 +45,6 @@ export function getNextADRNumber(adrDir: string): number {
   }
 }
 
-/**
- * Ensure ADR directory exists, create if it doesn't
- * 
- * @param adrDir - Directory path to ensure exists
- */
 export function ensureADRDirectory(adrDir: string): void {
   if (!fs.existsSync(adrDir)) {
     logger.info('Creating ADR directory', { adrDir });
@@ -72,56 +52,36 @@ export function ensureADRDirectory(adrDir: string): void {
   }
 }
 
-/**
- * Generate ADR filename from number and title
- * 
- * @param number - ADR number (will be zero-padded to 4 digits)
- * @param title - ADR title (will be converted to slug)
- * @returns Filename like "0001-use-postgresql-for-storage.md"
- */
 export function generateADRFilename(number: number, title: string): string {
   const paddedNumber = String(number).padStart(4, '0');
   const slug = titleToSlug(title);
   return `${paddedNumber}-${slug}.md`;
 }
 
-/**
- * Save ADR content to file
- * 
- * @param content - Full markdown content of the ADR
- * @param title - Title extracted from ADR content
- * @param adrDir - Directory to save ADR in (defaults to docs/adr)
- * @returns Object with success status, file path, and any error
- */
 export function saveADR(
   content: string,
   title: string,
   adrDir: string = DEFAULT_ADR_DIR
 ): { success: boolean; filePath?: string; error?: string } {
   try {
-    // Ensure directory exists
     ensureADRDirectory(adrDir);
 
-    // Get next ADR number
     const adrNumber = getNextADRNumber(adrDir);
 
-    // Generate filename
     const filename = generateADRFilename(adrNumber, title);
     const filePath = path.join(adrDir, filename);
 
-    // Check if file already exists (shouldn't happen, but safety check)
     if (fs.existsSync(filePath)) {
       logger.warn('ADR file already exists, using alternative name', { filePath });
       const alternativeFilename = generateADRFilename(adrNumber + 1, title);
       const alternativeFilePath = path.join(adrDir, alternativeFilename);
-      
+
       fs.writeFileSync(alternativeFilePath, content, 'utf-8');
       logger.info('ADR saved successfully', { filePath: alternativeFilePath });
-      
+
       return { success: true, filePath: alternativeFilePath };
     }
 
-    // Write ADR content to file
     fs.writeFileSync(filePath, content, 'utf-8');
 
     logger.info('ADR saved successfully', { filePath, adrNumber });
@@ -133,4 +93,3 @@ export function saveADR(
     return { success: false, error: errorMessage };
   }
 }
-

package/src/adr/index.ts

@@ -0,0 +1 @@
+export * from './adr';