@iservu-inc/adf-cli 0.1.6 → 0.3.0

package/tests/agents-md-generator.test.js

@@ -0,0 +1,245 @@
+const fs = require('fs-extra');
+const path = require('path');
+const AgentsMdGenerator = require('../lib/generators/agents-md-generator');
+
+const TEST_PROJECT_PATH = path.join(__dirname, 'test-project-generator');
+const TEST_SESSION_PATH = path.join(TEST_PROJECT_PATH, '.adf', 'sessions', 'test-session');
+
+describe('AgentsMdGenerator', () => {
+  beforeEach(async () => {
+    // Clean up test directories
+    await fs.remove(TEST_PROJECT_PATH);
+    await fs.ensureDir(TEST_PROJECT_PATH);
+    await fs.ensureDir(TEST_SESSION_PATH);
+    await fs.ensureDir(path.join(TEST_SESSION_PATH, 'outputs'));
+  });
+
+  afterEach(async () => {
+    // Clean up after tests
+    await fs.remove(TEST_PROJECT_PATH);
+  });
+
+  describe('PRP Framework', () => {
+    it('should generate AGENTS.md from PRP output', async () => {
+      // Create mock PRP output
+      const prpContent = `# Product Requirement Prompt (PRP)
+
+## 1. Goal Definition
+Build a React dashboard that displays real-time analytics from PostgreSQL database.
+
+## 2. Business Justification
+This will help users make data-driven decisions and improve productivity.
+
+## 3. Contextual Intelligence
+### Technology Stack
+- Frontend: React 18, TypeScript
+- Backend: Node.js, Express
+- Database: PostgreSQL
+
+## 4. Implementation Blueprint
+### File Structure
+- src/components/Dashboard/
+- src/api/analytics/
+
+### Core Logic
+1. Fetch data from analytics API
+2. Process and aggregate
+3. Render charts
+
+## 5. Validation
+### Success Criteria
+- Dashboard loads in <2s
+- All charts render correctly
+`;
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'prp.md'),
+        prpContent,
+        'utf-8'
+      );
+
+      // Create metadata
+      await fs.writeJson(path.join(TEST_SESSION_PATH, '_metadata.json'), {
+        framework: 'rapid',
+        projectName: 'Test Analytics Dashboard'
+      });
+
+      // Generate AGENTS.md
+      const generator = new AgentsMdGenerator(TEST_SESSION_PATH, TEST_PROJECT_PATH, 'rapid');
+      const generatedPath = await generator.generate();
+
+      // Verify file was created
+      expect(await fs.pathExists(generatedPath)).toBe(true);
+
+      // Verify content
+      const content = await fs.readFile(generatedPath, 'utf-8');
+
+      expect(content).toContain('# Test Analytics Dashboard');
+      expect(content).toContain('## Overview');
+      expect(content).toContain('React dashboard');
+      expect(content).toContain('## Tech Stack');
+      expect(content).toContain('## Build Commands');
+      expect(content).toContain('npm install');
+      expect(content).toContain('## AI Agent Instructions');
+      expect(content).toContain('.adf/sessions/test-session/outputs/prp.md');
+      expect(content).toContain('Generated by');
+      expect(content).toContain('ADF CLI');
+    });
+  });
+
+  describe('Balanced Framework', () => {
+    it('should generate AGENTS.md from Balanced outputs', async () => {
+      // Create mock outputs
+      const constitutionContent = `# Constitution
+
+## Core Principles
+1. User privacy is paramount
+2. Performance over features
+
+## Constraints
+- No third-party analytics
+- WCAG 2.1 AA compliance
+`;
+
+      const specificationContent = `# Specification
+
+## Overview
+A comprehensive user management system.
+
+## Architecture
+Microservices architecture with API gateway.
+`;
+
+      const planContent = `# Technical Plan
+
+## Technology Stack
+- React 18
+- Node.js 20
+- PostgreSQL 15
+`;
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'constitution.md'),
+        constitutionContent,
+        'utf-8'
+      );
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'specification.md'),
+        specificationContent,
+        'utf-8'
+      );
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'plan.md'),
+        planContent,
+        'utf-8'
+      );
+
+      // Generate AGENTS.md
+      const generator = new AgentsMdGenerator(TEST_SESSION_PATH, TEST_PROJECT_PATH, 'balanced');
+      const generatedPath = await generator.generate();
+
+      // Verify content
+      const content = await fs.readFile(generatedPath, 'utf-8');
+
+      expect(content).toContain('## Constitution');
+      expect(content).toContain('User privacy is paramount');
+      expect(content).toContain('## Tech Stack');
+      expect(content).toContain('React 18');
+      expect(content).toContain('constitution.md');
+      expect(content).toContain('specification.md');
+      expect(content).toContain('plan.md');
+    });
+  });
+
+  describe('BMAD Framework', () => {
+    it('should generate AGENTS.md from BMAD outputs', async () => {
+      // Create mock outputs
+      const prdContent = `# Product Requirements Document
+
+## Executive Summary
+A complete e-commerce platform for small businesses.
+
+## Goals and Objectives
+- Enable online sales
+- Provide analytics
+
+## Technical Requirements
+- RESTful API
+- Payment gateway integration
+`;
+
+      const architectureContent = `# System Architecture
+
+## System Overview
+Modular monolith architecture with separate domains.
+`;
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'prd.md'),
+        prdContent,
+        'utf-8'
+      );
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'architecture.md'),
+        architectureContent,
+        'utf-8'
+      );
+
+      // Generate AGENTS.md
+      const generator = new AgentsMdGenerator(TEST_SESSION_PATH, TEST_PROJECT_PATH, 'comprehensive');
+      const generatedPath = await generator.generate();
+
+      // Verify content
+      const content = await fs.readFile(generatedPath, 'utf-8');
+
+      expect(content).toContain('## Product Overview');
+      expect(content).toContain('e-commerce platform');
+      expect(content).toContain('## Goals and Objectives');
+      expect(content).toContain('Enable online sales');
+      expect(content).toContain('## Security Notes');
+      expect(content).toContain('prd.md');
+      expect(content).toContain('architecture.md');
+    });
+  });
+
+  describe('Template Variables', () => {
+    it('should replace session ID in paths', async () => {
+      const prpContent = '# PRP\n\n## 1. Goal Definition\nTest project';
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'prp.md'),
+        prpContent,
+        'utf-8'
+      );
+
+      const generator = new AgentsMdGenerator(TEST_SESSION_PATH, TEST_PROJECT_PATH, 'rapid');
+      const generatedPath = await generator.generate();
+
+      const content = await fs.readFile(generatedPath, 'utf-8');
+
+      // Should contain the actual session ID, not a template variable
+      expect(content).toContain('test-session');
+      expect(content).not.toContain('{SESSION_ID}');
+    });
+
+    it('should include ADF CLI version', async () => {
+      const prpContent = '# PRP\n\n## 1. Goal Definition\nTest';
+
+      await fs.writeFile(
+        path.join(TEST_SESSION_PATH, 'outputs', 'prp.md'),
+        prpContent,
+        'utf-8'
+      );
+
+      const generator = new AgentsMdGenerator(TEST_SESSION_PATH, TEST_PROJECT_PATH, 'rapid');
+      const generatedPath = await generator.generate();
+
+      const content = await fs.readFile(generatedPath, 'utf-8');
+
+      expect(content).toMatch(/Generated by.*ADF CLI.*v\d+\.\d+\.\d+/);
+    });
+  });
+});

package/tests/answer-quality-analyzer.test.js

@@ -0,0 +1,173 @@
+const AnswerQualityAnalyzer = require('../lib/frameworks/answer-quality-analyzer');
+
+describe('AnswerQualityAnalyzer', () => {
+  describe('analyze', () => {
+    it('should score high-quality comprehensive answer highly', () => {
+      const question = {
+        keywords: ['react', 'typescript', 'web'],
+        requiredElements: ['platform', 'technology']
+      };
+
+      const answer = 'I am building a React 18 web dashboard using TypeScript and Node.js. ' +
+        'The platform is web-based, responsive design for desktop and mobile. ' +
+        'It will display real-time analytics data fetched from a PostgreSQL database. ' +
+        'Users can filter data by date range, export to CSV, and create custom views. ' +
+        'The tech stack includes Next.js 14 for the frontend, Express.js for the API, ' +
+        'and we will use Chart.js for data visualization. File structure will be ' +
+        'src/components/, src/api/, src/utils/. The main components are Dashboard, ' +
+        'DataTable, ChartView, and FilterPanel.';
+
+      const metrics = AnswerQualityAnalyzer.analyze(answer, question);
+
+      expect(metrics.qualityScore).toBeGreaterThan(80);
+      expect(metrics.isComprehensive).toBe(true);
+      expect(metrics.wordCount).toBeGreaterThan(50);
+      expect(metrics.hasKeywords.matched).toContain('react');
+      expect(metrics.hasKeywords.matched).toContain('typescript');
+      expect(metrics.hasRequiredElements.detected).toContain('platform');
+      expect(metrics.hasRequiredElements.detected).toContain('technology');
+    });
+
+    it('should score low-quality vague answer poorly', () => {
+      const question = {
+        keywords: ['react', 'typescript', 'nextjs'],
+        requiredElements: ['platform', 'technology']
+      };
+
+      const answer = 'An app';
+
+      const metrics = AnswerQualityAnalyzer.analyze(answer, question);
+
+      expect(metrics.qualityScore).toBeLessThan(30);
+      expect(metrics.isComprehensive).toBe(false);
+      expect(metrics.wordCount).toBeLessThan(5);
+      expect(metrics.hasKeywords.matched.length).toBe(0);
+    });
+
+    it('should detect bullet points and examples', () => {
+      const question = { keywords: [], requiredElements: [] };
+
+      const answer = 'The features include user authentication, dashboard, and export. ' +
+        'This allows for better security. ' +
+        'For example, users can click the export button to download CSV files.';
+
+      const metrics = AnswerQualityAnalyzer.analyze(answer, question);
+
+      expect(metrics.isDetailed.hasMultipleSentences).toBe(true);
+      expect(metrics.isDetailed.hasExamples).toBe(true);
+    });
+
+    it('should detect technical depth', () => {
+      const question = { keywords: [], requiredElements: [] };
+
+      const answer = 'Using React 18.2.0 with TypeScript. Will deploy to AWS using Docker containers. ' +
+        'Database is PostgreSQL 15. API endpoints follow REST conventions.';
+
+      const metrics = AnswerQualityAnalyzer.analyze(answer, question);
+
+      expect(metrics.hasTechnicalDepth.hasTechStack).toBe(true);
+      expect(metrics.hasTechnicalDepth.hasVersions).toBe(true);
+      expect(metrics.hasTechnicalDepth.hasSpecificTools).toBe(true);
+    });
+
+    it('should allow skipping follow-ups for excellent answers', () => {
+      const question = {
+        keywords: ['react', 'web', 'api'],
+        requiredElements: ['platform', 'technology', 'user-interaction']
+      };
+
+      const answer = 'Building a React web application with TypeScript and Next.js 14. ' +
+        'The platform is web-based, responsive design. Users can click buttons to submit forms, ' +
+        'search and filter data, and view real-time updates. Technology stack includes React 18, ' +
+        'TypeScript 5, Node.js 20, PostgreSQL 15, and Docker for deployment. ' +
+        'API endpoints: GET /api/users, POST /api/users, PUT /api/users/:id. ' +
+        'File structure: src/components/, src/pages/, src/api/, src/utils/. ' +
+        'Main components: UserList, UserForm, SearchBar, FilterPanel.';
+
+      const metrics = AnswerQualityAnalyzer.analyze(answer, question);
+
+      expect(metrics.canSkipFollowUps).toBe(true);
+      expect(metrics.qualityScore).toBeGreaterThanOrEqual(85);
+    });
+  });
+
+  describe('getFeedback', () => {
+    it('should return excellent feedback for score >= 90', () => {
+      const metrics = { qualityScore: 95 };
+      const feedback = AnswerQualityAnalyzer.getFeedback(metrics);
+      expect(feedback).toContain('Excellent');
+    });
+
+    it('should return good feedback for score >= 70', () => {
+      const metrics = { qualityScore: 75 };
+      const feedback = AnswerQualityAnalyzer.getFeedback(metrics);
+      expect(feedback).toContain('Great');
+    });
+
+    it('should return null for low scores', () => {
+      const metrics = { qualityScore: 45 };
+      const feedback = AnswerQualityAnalyzer.getFeedback(metrics);
+      expect(feedback).toBeNull();
+    });
+  });
+
+  describe('getWordCount', () => {
+    it('should count words correctly', () => {
+      expect(AnswerQualityAnalyzer.getWordCount('Hello world')).toBe(2);
+      expect(AnswerQualityAnalyzer.getWordCount('This is a test sentence.')).toBe(5);
+      expect(AnswerQualityAnalyzer.getWordCount('  Multiple   spaces   here  ')).toBe(3);
+    });
+  });
+
+  describe('checkKeywords', () => {
+    it('should match keywords case-insensitively', () => {
+      const result = AnswerQualityAnalyzer.checkKeywords(
+        'Using React and TypeScript',
+        ['react', 'typescript', 'node']
+      );
+
+      expect(result.matched).toContain('react');
+      expect(result.matched).toContain('typescript');
+      expect(result.count).toBe(2);
+      expect(result.total).toBe(3);
+    });
+  });
+
+  describe('checkRequiredElements', () => {
+    it('should detect platform element', () => {
+      const result = AnswerQualityAnalyzer.checkRequiredElements(
+        'This is a web application for mobile users',
+        ['platform']
+      );
+
+      expect(result.detected).toContain('platform');
+    });
+
+    it('should detect technology element', () => {
+      const result = AnswerQualityAnalyzer.checkRequiredElements(
+        'Built with React and Node.js',
+        ['technology']
+      );
+
+      expect(result.detected).toContain('technology');
+    });
+
+    it('should detect API endpoints', () => {
+      const result = AnswerQualityAnalyzer.checkRequiredElements(
+        'API has GET /api/users and POST /api/users endpoints',
+        ['api-endpoints']
+      );
+
+      expect(result.detected).toContain('api-endpoints');
+    });
+
+    it('should detect file paths', () => {
+      const result = AnswerQualityAnalyzer.checkRequiredElements(
+        'Files are in src/components/ and app/utils/helper.ts',
+        ['file-paths']
+      );
+
+      expect(result.detected).toContain('file-paths');
+    });
+  });
+});