aiwf 0.3.7 → 0.3.12

package/claude-code/aiwf/ko/.aiwf/06_FEATURE_LEDGERS/schemas/feature_validator.cjs

@@ -1,406 +0,0 @@
-/**
- * AIWF Feature Ledger 스키마 검증 함수
- * Feature 데이터의 유효성을 검증하고 오류를 반환합니다.
- */
-
-const Ajv = require('ajv');
-const addFormats = require('ajv-formats');
-const fs = require('fs');
-const path = require('path');
-
-class FeatureValidator {
-  constructor() {
-    this.ajv = new Ajv({ allErrors: true, strict: false });
-    addFormats(this.ajv);
-    
-    // Feature 스키마 로드
-    const schemaPath = path.join(__dirname, 'feature_schema.json');
-    this.schema = JSON.parse(fs.readFileSync(schemaPath, 'utf8'));
-    this.validate = this.ajv.compile(this.schema);
-  }
-
-  /**
-   * Feature 데이터 검증
-   * @param {Object} featureData - 검증할 Feature 데이터
-   * @returns {Object} 검증 결과 { valid: boolean, errors: Array }
-   */
-  validateFeature(featureData) {
-    const isValid = this.validate(featureData);
-    
-    return {
-      valid: isValid,
-      errors: isValid ? [] : this.formatErrors(this.validate.errors),
-      data: featureData
-    };
-  }
-
-  /**
-   * Feature ID 형식 검증
-   * @param {string} featureId - 검증할 Feature ID
-   * @returns {boolean} 유효성 여부
-   */
-  validateFeatureId(featureId) {
-    const pattern = /^FL[0-9]{3}$/;
-    return pattern.test(featureId);
-  }
-
-  /**
-   * 마일스톤 ID 형식 검증
-   * @param {string} milestoneId - 검증할 마일스톤 ID
-   * @returns {boolean} 유효성 여부
-   */
-  validateMilestoneId(milestoneId) {
-    const pattern = /^M[0-9]{2}$/;
-    return pattern.test(milestoneId);
-  }
-
-  /**
-   * Feature 상태 검증
-   * @param {string} status - 검증할 상태
-   * @returns {boolean} 유효성 여부
-   */
-  validateStatus(status) {
-    const validStatuses = ['draft', 'active', 'on-hold', 'completed', 'archived'];
-    return validStatuses.includes(status);
-  }
-
-  /**
-   * 우선순위 검증
-   * @param {string} priority - 검증할 우선순위
-   * @returns {boolean} 유효성 여부
-   */
-  validatePriority(priority) {
-    const validPriorities = ['low', 'medium', 'high', 'critical'];
-    return validPriorities.includes(priority);
-  }
-
-  /**
-   * 의존성 검증 (순환 참조 확인)
-   * @param {string} featureId - 현재 Feature ID
-   * @param {Array} dependencies - 의존성 목록
-   * @param {Array} allFeatures - 전체 Feature 목록
-   * @returns {Object} 검증 결과
-   */
-  validateDependencies(featureId, dependencies, allFeatures = []) {
-    const result = {
-      valid: true,
-      errors: [],
-      circularDependencies: []
-    };
-
-    // 의존성 Feature ID 형식 검증
-    for (const depId of dependencies) {
-      if (!this.validateFeatureId(depId)) {
-        result.valid = false;
-        result.errors.push(`Invalid dependency feature ID format: ${depId}`);
-      }
-    }
-
-    // 순환 참조 검증
-    const visited = new Set();
-    const recursionStack = new Set();
-    
-    const hasCycle = (currentId, deps) => {
-      if (recursionStack.has(currentId)) {
-        result.circularDependencies.push(currentId);
-        return true;
-      }
-      
-      if (visited.has(currentId)) {
-        return false;
-      }
-      
-      visited.add(currentId);
-      recursionStack.add(currentId);
-      
-      const currentFeature = allFeatures.find(f => f.feature_id === currentId);
-      const currentDeps = currentFeature ? currentFeature.dependencies : [];
-      
-      for (const depId of currentDeps) {
-        if (hasCycle(depId, allFeatures)) {
-          return true;
-        }
-      }
-      
-      recursionStack.delete(currentId);
-      return false;
-    };
-
-    if (hasCycle(featureId, allFeatures)) {
-      result.valid = false;
-      result.errors.push(`Circular dependency detected for feature ${featureId}`);
-    }
-
-    return result;
-  }
-
-  /**
-   * Git 브랜치명 검증
-   * @param {Array} branches - 브랜치명 배열
-   * @returns {Object} 검증 결과
-   */
-  validateGitBranches(branches) {
-    const result = {
-      valid: true,
-      errors: []
-    };
-
-    const branchPattern = /^[a-zA-Z0-9/_-]+$/;
-    
-    for (const branch of branches) {
-      if (!branchPattern.test(branch)) {
-        result.valid = false;
-        result.errors.push(`Invalid git branch name: ${branch}`);
-      }
-      
-      // Git 브랜치명 길이 제한 (일반적으로 255자)
-      if (branch.length > 255) {
-        result.valid = false;
-        result.errors.push(`Branch name too long: ${branch}`);
-      }
-    }
-
-    return result;
-  }
-
-  /**
-   * 날짜 형식 검증
-   * @param {string} dateString - 검증할 날짜 문자열
-   * @returns {boolean} 유효성 여부
-   */
-  validateDateTime(dateString) {
-    try {
-      const date = new Date(dateString);
-      return date instanceof Date && !isNaN(date) && dateString === date.toISOString();
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * 작업 시간 검증
-   * @param {number} estimated - 예상 시간
-   * @param {number} actual - 실제 시간
-   * @returns {Object} 검증 결과
-   */
-  validateWorkHours(estimated, actual) {
-    const result = {
-      valid: true,
-      errors: [],
-      warnings: []
-    };
-
-    // 기본 범위 검증
-    if (estimated < 0 || estimated > 1000) {
-      result.valid = false;
-      result.errors.push(`Estimated hours out of range: ${estimated}`);
-    }
-
-    if (actual < 0 || actual > 1000) {
-      result.valid = false;
-      result.errors.push(`Actual hours out of range: ${actual}`);
-    }
-
-    // 비즈니스 로직 검증
-    if (actual > estimated * 2) {
-      result.warnings.push(`Actual hours significantly exceed estimated: ${actual} vs ${estimated}`);
-    }
-
-    if (estimated > 0 && actual === 0) {
-      result.warnings.push('Work has been estimated but no actual hours recorded');
-    }
-
-    return result;
-  }
-
-  /**
-   * 태그 검증
-   * @param {Array} tags - 태그 배열
-   * @returns {Object} 검증 결과
-   */
-  validateTags(tags) {
-    const result = {
-      valid: true,
-      errors: [],
-      warnings: []
-    };
-
-    const validCategories = [
-      'frontend', 'backend', 'api', 'database', 'ui', 'ux',
-      'feature', 'enhancement', 'bugfix', 'refactor', 'docs',
-      'simple', 'complex', 'critical', 'auth', 'payment',
-      'notification', 'search', 'admin', 'security', 'core'
-    ];
-
-    for (const tag of tags) {
-      // 길이 검증
-      if (tag.length < 1 || tag.length > 30) {
-        result.valid = false;
-        result.errors.push(`Tag length out of range: ${tag}`);
-      }
-
-      // 형식 검증 (알파벳, 숫자, 하이픈만 허용)
-      if (!/^[a-zA-Z0-9-_]+$/.test(tag)) {
-        result.valid = false;
-        result.errors.push(`Invalid tag format: ${tag}`);
-      }
-
-      // 권장 태그 체크 (경고)
-      if (!validCategories.includes(tag.toLowerCase())) {
-        result.warnings.push(`Non-standard tag used: ${tag}`);
-      }
-    }
-
-    // 중복 태그 체크
-    const uniqueTags = new Set(tags);
-    if (uniqueTags.size !== tags.length) {
-      result.warnings.push('Duplicate tags found');
-    }
-
-    return result;
-  }
-
-  /**
-   * 종합 Feature 검증
-   * @param {Object} featureData - Feature 데이터
-   * @param {Array} allFeatures - 전체 Feature 목록 (의존성 검증용)
-   * @returns {Object} 종합 검증 결과
-   */
-  validateFeatureComprehensive(featureData, allFeatures = []) {
-    const result = {
-      valid: true,
-      errors: [],
-      warnings: [],
-      details: {}
-    };
-
-    // 기본 스키마 검증
-    const schemaResult = this.validateFeature(featureData);
-    result.valid = result.valid && schemaResult.valid;
-    result.errors.push(...schemaResult.errors);
-
-    // 의존성 검증
-    if (featureData.dependencies && featureData.dependencies.length > 0) {
-      const depResult = this.validateDependencies(
-        featureData.feature_id,
-        featureData.dependencies,
-        allFeatures
-      );
-      result.valid = result.valid && depResult.valid;
-      result.errors.push(...depResult.errors);
-      result.details.dependencies = depResult;
-    }
-
-    // Git 브랜치 검증
-    if (featureData.git_branches) {
-      const branchResult = this.validateGitBranches(featureData.git_branches);
-      result.valid = result.valid && branchResult.valid;
-      result.errors.push(...branchResult.errors);
-      result.details.git_branches = branchResult;
-    }
-
-    // 작업 시간 검증
-    const hoursResult = this.validateWorkHours(
-      featureData.estimated_hours,
-      featureData.actual_hours
-    );
-    result.valid = result.valid && hoursResult.valid;
-    result.errors.push(...hoursResult.errors);
-    result.warnings.push(...hoursResult.warnings);
-    result.details.work_hours = hoursResult;
-
-    // 태그 검증
-    if (featureData.tags) {
-      const tagResult = this.validateTags(featureData.tags);
-      result.valid = result.valid && tagResult.valid;
-      result.errors.push(...tagResult.errors);
-      result.warnings.push(...tagResult.warnings);
-      result.details.tags = tagResult;
-    }
-
-    return result;
-  }
-
-  /**
-   * 오류 메시지 포맷팅
-   * @param {Array} errors - AJV 오류 배열
-   * @returns {Array} 포맷된 오류 메시지
-   */
-  formatErrors(errors) {
-    return errors.map(error => {
-      const { instancePath, message, params } = error;
-      const field = instancePath.replace('/', '') || 'root';
-      
-      return {
-        field,
-        message,
-        value: params?.missingProperty || 'unknown',
-        path: instancePath
-      };
-    });
-  }
-
-  /**
-   * 검증 리포트 생성
-   * @param {Object} validationResult - 검증 결과
-   * @returns {string} 포맷된 리포트
-   */
-  generateReport(validationResult) {
-    const { valid, errors, warnings, details } = validationResult;
-    
-    let report = `\n=== Feature Validation Report ===\n`;
-    report += `Status: ${valid ? '✅ VALID' : '❌ INVALID'}\n`;
-    
-    if (errors.length > 0) {
-      report += `\nErrors (${errors.length}):\n`;
-      errors.forEach((error, index) => {
-        report += `  ${index + 1}. ${error.field}: ${error.message}\n`;
-      });
-    }
-    
-    if (warnings.length > 0) {
-      report += `\nWarnings (${warnings.length}):\n`;
-      warnings.forEach((warning, index) => {
-        report += `  ${index + 1}. ${warning}\n`;
-      });
-    }
-    
-    if (details) {
-      report += `\nValidation Details:\n`;
-      Object.keys(details).forEach(key => {
-        const detail = details[key];
-        report += `  ${key}: ${detail.valid ? '✅' : '❌'}\n`;
-      });
-    }
-    
-    return report;
-  }
-}
-
-// 사용 예시 및 테스트
-if (require.main === module) {
-  const validator = new FeatureValidator();
-  
-  // 샘플 데이터 검증
-  const sampleFeature = {
-    feature_id: "FL001",
-    title: "사용자 인증 시스템",
-    description: "JWT 기반 사용자 인증 시스템 구현",
-    status: "active",
-    priority: "high",
-    milestone_id: "M02",
-    assignee: "moonklabs",
-    created_date: "2025-07-08T20:55:00+0900",
-    updated_date: "2025-07-08T20:55:00+0900",
-    estimated_hours: 24,
-    actual_hours: 8,
-    tags: ["authentication", "security", "core"],
-    dependencies: [],
-    git_branches: ["feature/FL001-user-auth"]
-  };
-  
-  const result = validator.validateFeatureComprehensive(sampleFeature);
-  console.log(validator.generateReport(result));
-}
-
-module.exports = FeatureValidator;

package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-needs-focus.md

@@ -1,139 +0,0 @@
-# Project Review - 2025-06-12 12:00
-
-## 🎭 Review Sentiment
-
-🚨⚠️🔧
-
-## Executive Summary
-
-- **Result:** NEEDS_WORK
-- **Scope:** Full project review including test infrastructure, documentation, architecture, and code quality
-- **Overall Judgment:** needs-focus
-
-## Test Infrastructure Assessment
-
-- **Test Suite Status**: FAILING (Backend: 25/26 failed suites, Frontend: 6/28 failed tests)
-- **Test Pass Rate**: Backend: 98.3% (400 passed, 7 failed), Frontend: 78.6% (22 passed, 6 failed)
-- **Test Health Score**: 3/10
-- **Infrastructure Health**: BROKEN
-  - Import errors: 3 (missing test config files, path resolution issues)
-  - Configuration errors: 2 (dependency injection failures)
-  - Fixture issues: 1 (floating-point precision)
-- **Test Categories**:
-  - Unit Tests: 400/407 passing (mostly meaningless smoke tests)
-  - Integration Tests: 0/7 passing (external dependency failures)
-  - API Tests: 0 functional tests (only smoke tests)
-- **Critical Issues**:
-  - Missing `test-connect-info.json` configuration file
-  - API signature changes not reflected in tests (`dashboardService.create()` parameter mismatch)
-  - External database dependencies causing unstable tests
-  - Repository mocking setup missing across all services
-- **Sprint Coverage**: <5% of actual functionality has meaningful tests
-- **Blocking Status**: BLOCKED - Critical test infrastructure failures prevent reliable development
-- **Recommendations**:
-  - Immediate: Fix missing test configuration files and dependency injection
-  - Short-term: Replace smoke tests with behavior-focused unit tests
-  - Long-term: Establish comprehensive test strategy with coverage targets
-
-## Development Context
-
-- **Current Milestone:** MVP 안정화 및 핵심 기능 강화 (active)
-- **Current Sprint:** No active sprint structure in place
-- **Expected Completeness:** Milestone requirements document exists but lacks sprint planning
-
-## Progress Assessment
-
-- **Milestone Progress:** 40% (documentation and architecture in place, but stability/performance work needed)
-- **Sprint Status:** No formal sprint structure implemented
-- **Deliverable Tracking:** Milestone requirements defined but not broken into actionable sprints
-
-## Architecture & Technical Assessment
-
-- **Architecture Score:** 7/10 - Well-structured modular design with clear separation of concerns
-- **Technical Debt Level:** MEDIUM - Several architectural decisions need refinement but foundation is solid
-- **Code Quality:** Mixed - Good patterns in core modules, but inconsistencies in error handling and type safety
-
-Specific examples:
-- ✅ Excellent: Modular NestJS structure with proper dependency injection
-- ✅ Good: Multi-database support with Knex abstraction layer  
-- ⚠️ Needs work: Connection Service handling too many responsibilities
-- ❌ Poor: TypeScript type safety with excessive `any` usage in API services
-
-## File Organization Audit
-
-- **Workflow Compliance:** NEEDS_ATTENTION
-- **File Organization Issues:** 
-  - Root directory pollution: `identifier.sqlite`, `package-lock.json` should be removed
-  - Directory name typos: `entites/` should be `entities/`, `tabel-query/` should be `table-query/`
-  - IntelliJ project files (*.iml) committed to repository
-  - Experimental code in production paths: `testLineChart.ts`
-- **Cleanup Tasks Needed:** 
-  - Remove 6+ unnecessary files from root and subdirectories
-  - Fix directory naming inconsistencies
-  - Consolidate duplicate dummy data files between backend and frontend
-
-## Critical Findings
-
-### Critical Issues (Severity 8-10)
-
-#### Test Infrastructure Collapse
-- 96% of test suites failing due to infrastructure issues, not logic problems
-- No meaningful test coverage for authentication, data processing, or UI components
-- External database dependencies making tests unstable and environment-dependent
-- Missing test configuration files blocking integration test execution
-
-#### Type Safety Violations
-- Frontend API services using `Promise<any>` extensively, eliminating TypeScript benefits
-- Backend missing proper error type definitions
-- Inconsistent parameter types causing test failures (dashboard service API changes)
-
-#### File System Pollution
-- Repository contains IDE-specific files and temporary artifacts
-- Directory naming errors preventing proper module imports
-- Root-level files that should be in subdirectories or gitignored
-
-### Improvement Opportunities (Severity 4-7)
-
-#### Architecture Refinements
-- Connection Service mixing multiple database engine logic (violates SRP)
-- Dashboard Module depending on too many entities (tight coupling)
-- Missing Factory pattern for database engine selection
-
-#### Performance Concerns  
-- No caching strategy for frequently accessed data
-- Large bundle sizes in frontend without optimization
-- Lambda cold start issues not addressed
-
-#### Documentation Gaps
-- No ADRs (Architecture Decision Records) documenting technical choices
-- Missing API documentation despite Swagger setup
-- Test strategy and coverage guidelines not defined
-
-## John Carmack Critique 🔥
-
-1. **Test Infrastructure is Fundamentally Broken**: You have a 98.3% pass rate but essentially 0% meaningful coverage. This is worse than having no tests - it gives false confidence. The authentication system processes JWT tokens and passwords with zero validation tests. In a production BI system handling enterprise data, this is unacceptable. Fix the test infrastructure immediately or accept that you're shipping blind.
-
-2. **Type Safety Theater**: TypeScript with `Promise<any>` everywhere defeats the entire purpose. You're getting all the compilation overhead with none of the safety benefits. Either commit to proper typing or drop TypeScript - this middle ground helps nobody and slows down development while providing zero protection.
-
-3. **Connection Service is a God Object**: One service handling 10+ database engines with massive switch-case logic. This violates every SOLID principle simultaneously. When MySQL behavior differs from BigQuery, you'll have cascade failures across unrelated database types. Factor this into per-engine strategies before it becomes unmaintainable.
-
-## Recommendations
-
-Based on the findings, here are prioritized action items:
-
-- **Important fixes:** 
-  - Fix test infrastructure immediately - add missing config files, proper mocking setup
-  - Remove file system pollution (*.iml files, root directory cleanup)
-  - Fix directory naming typos that break imports
-  - Establish proper TypeScript typing in API layer
-  
-- **Optional fixes/changes:** 
-  - Refactor Connection Service using Strategy/Factory patterns
-  - Add comprehensive error handling patterns
-  - Implement caching layer for database metadata
-  - Create ADR documentation for major technical decisions
-
-- **Next Sprint Focus:** 
-  - Cannot proceed to next sprint until test infrastructure is stabilized
-  - Recommend creating "Test Infrastructure Recovery" sprint before continuing MVP stabilization
-  - Focus on establishing baseline test coverage for authentication and data processing modules

package/claude-code/aiwf/ko/.aiwf/10_STATE_OF_PROJECT/2025-06-12-12-00-test-alignment.md

@@ -1,155 +0,0 @@
-# Test-Strategy Alignment Review - 2025-06-12 12:00
-
-## Alignment Summary
-
-Overall alignment with testing strategy: **POOR**
-
-Key findings:
-- Test suite has extremely low practical coverage (<5%) despite 98.3% pass rate for basic smoke tests
-- Critical functionality (authentication, data processing, UI components) has no meaningful test coverage
-- Tests focus on implementation details rather than user behavior and business value
-- Frontend has essentially zero test coverage for core BI functionality
-
-## Tests Requiring Modification
-
-### Remove (Over-engineered/Out of scope)
-- `backend-api/test/QTT-*/` - Integration tests with hardcoded external database dependencies
-  - **Reason**: These tests depend on actual database connections and fail in isolation
-  - **Action**: Replace with mocked integration tests
-
-### Simplify (Too complex for purpose)
-- All `*.service.spec.ts` files currently only test `should be defined`
-  - **File**: `src/auth/auth.service.spec.ts`
-  - **Issue**: Pointless smoke test that provides no value
-  - **Action**: Replace with behavior-focused authentication flow tests
-  
-- All `*.controller.spec.ts` files with minimal coverage
-  - **File**: `src/dashboard/dashboard.controller.spec.ts`
-  - **Issue**: Missing dependency mocking, tests implementation details
-  - **Action**: Focus on HTTP contract testing and error handling
-
-### Add (Critical gaps)
-- **Authentication Security Tests**
-  - JWT token generation/validation
-  - Password validation and hashing
-  - Token refresh mechanism
-  - Session timeout handling
-
-- **Database Connection Tests** 
-  - Connection pool management
-  - SQL injection prevention
-  - Query timeout handling
-  - Multi-database engine support
-
-- **Frontend User Journey Tests**
-  - Login/logout flow
-  - Widget creation 3-step process
-  - Dashboard layout drag-and-drop
-  - Data visualization rendering
-
-- **API Integration Tests**
-  - Error response format consistency
-  - CORS handling
-  - Rate limiting behavior
-  - File upload security
-
-## Recommended Actions
-
-### Immediate (Blocking issues)
-- [ ] Fix dependency injection in all service tests (`backend-api/src/**/*.service.spec.ts`)
-- [ ] Remove hardcoded database connections from QTT tests
-- [ ] Add basic authentication flow tests for security validation
-- [ ] Fix floating-point precision issues in `frontend-web/src/widget/utils/chartUtil.test.ts`
-
-### Short-term (Quality improvements)
-- [ ] Implement test data factories for consistent mock objects
-- [ ] Add comprehensive API contract tests for all controllers
-- [ ] Create E2E test suite for critical user workflows
-- [ ] Establish test coverage baseline and improvement targets
-
-### Long-term (Technical debt)
-- [ ] Implement visual regression testing for 50+ chart components
-- [ ] Add performance testing for large dataset processing
-- [ ] Create automated security testing pipeline
-- [ ] Establish test strategy documentation with coverage guidelines
-
-## Test Health Indicators
-
-- Tests align with code purpose: **NO** - Most tests are meaningless smoke tests
-- Critical paths covered: **NO** - Authentication, data processing, UI flows lack coverage  
-- Maintenance burden reasonable: **PARTIALLY** - Current tests are minimal but don't provide value
-- Tests support development velocity: **NO** - Tests don't catch regressions or guide refactoring
-
-## Implementation Examples
-
-### Before (Current - Meaningless)
-```typescript
-// auth.service.spec.ts
-describe('AuthService', () => {
-  it('should be defined', () => {
-    expect(service).toBeDefined();
-  });
-});
-```
-
-### After (Behavior-focused)
-```typescript
-// auth.service.spec.ts
-describe('AuthService', () => {
-  describe('validateUser', () => {
-    it('should return user data for valid credentials', async () => {
-      const mockUser = { id: 1, email: 'test@test.com' };
-      mockUserRepository.findOne.mockResolvedValue(mockUser);
-      
-      const result = await service.validateUser('test@test.com', 'validPassword');
-      
-      expect(result).toEqual(mockUser);
-      expect(mockUserRepository.findOne).toHaveBeenCalledWith({
-        where: { email: 'test@test.com' }
-      });
-    });
-
-    it('should throw UnauthorizedException for invalid credentials', async () => {
-      mockUserRepository.findOne.mockResolvedValue(null);
-      
-      await expect(service.validateUser('test@test.com', 'wrongPassword'))
-        .rejects.toThrow(UnauthorizedException);
-    });
-  });
-});
-```
-
-### Frontend Test Example
-```typescript
-// Widget creation flow test
-describe('Widget Creation Flow', () => {
-  it('should complete 3-step widget creation successfully', async () => {
-    // Step 1: Dataset selection
-    fireEvent.click(screen.getByText('Sample Dataset'));
-    fireEvent.click(screen.getByText('다음'));
-    
-    // Step 2: Chart type selection  
-    fireEvent.click(screen.getByText('Line Chart'));
-    fireEvent.click(screen.getByText('다음'));
-    
-    // Step 3: Configuration
-    fireEvent.change(screen.getByLabelText('위젯명'), { 
-      target: { value: 'Test Widget' } 
-    });
-    fireEvent.click(screen.getByText('저장'));
-    
-    await waitFor(() => {
-      expect(screen.getByText('위젯이 생성되었습니다')).toBeInTheDocument();
-    });
-  });
-});
-```
-
-## Next Review
-
-Recommended review in: **2 weeks**
-Focus areas for next review: 
-- Authentication test implementation progress
-- Frontend test coverage establishment  
-- Integration test stability improvements
-- Test infrastructure setup completion