@haposoft/cafekit 0.3.1 → 0.3.5

package/src/claude/migration-manifest.json

@@ -19,7 +19,8 @@
   },
   "skills": {
     "required": [
-      "specs"
+      "specs",
+      "impact-analysis"
     ]
   },
   "agents": {

package/src/common/skills/impact-analysis/SKILL.md

@@ -0,0 +1,271 @@
+---
+name: impact-analysis
+description: "Phân tích tác động code changes và tạo test scenarios. Sử dụng sau khi sửa code, trước commit, hoặc khi cần kiểm tra regression. Tự động phát hiện affected files, dependencies, edge cases."
+argument-hint: "[files] OR auto"
+version: 1.0.0
+---
+
+# Impact Analysis - Phân Tích Tác Động & Test Guidance
+
+Phân tích tác động của code changes và đưa ra hướng dẫn test chi tiết để tránh regression bugs.
+
+## Arguments
+
+- **Default (no args)**: Phân tích git diff gần nhất
+- **`auto`**: Tự động phát hiện changes và phân tích
+- **`{files}`**: Phân tích files cụ thể (comma-separated)
+
+## Khi Nào Sử Dụng
+
+✅ **Nên dùng:**
+- Sau khi sửa code, trước khi commit
+- Trước khi tạo Pull Request
+- Sau khi fix bug (đảm bảo không tạo bug mới)
+- Khi refactor code (verify không phá functionality)
+- Khi thêm feature mới (tìm integration points)
+
+❌ **Không cần:**
+- Chỉ sửa documentation
+- Chỉ sửa comments
+- Thay đổi config không ảnh hưởng logic
+
+## Quick Start
+
+```bash
+# Phân tích changes gần nhất
+/impact-analysis
+
+# Tự động detect và phân tích
+/impact-analysis auto
+
+# Phân tích files cụ thể
+/impact-analysis src/api/auth.ts,src/components/Login.tsx
+```
+
+## Workflow
+
+### 0. Auto-Detect Project Type (NEW)
+
+Load `references/project-detection.md` để:
+- Tự động detect project type (React Native, Next.js, Node.js API, etc.)
+- Load appropriate profile với patterns và edge cases
+- Check for custom config file (`impact-analysis.config.js`)
+- Merge custom config với default profile
+
+### 1. Detect Changes
+
+Load `references/change-detection.md` để:
+- Phát hiện files đã thay đổi (git diff)
+- Phân loại thay đổi (backend/frontend/database)
+- Đánh giá mức độ risk
+
+### 2. Scout Dependencies
+
+Load `references/dependency-scouting.md` để:
+- Tìm files import/sử dụng code đã sửa
+- Phát hiện reverse dependencies
+- Xác định integration points
+
+**Advanced**: Load `references/industry-techniques.md` để:
+- Sử dụng Call Graph Analysis (Technique #2)
+- Sử dụng Dependency Graph tools
+- Áp dụng AST-based analysis (Technique #3) cho semantic changes
+
+### 3. Identify Edge Cases
+
+Load `references/edge-case-identification.md` để:
+- Phân tích data flow
+- Tìm boundary conditions
+- Xác định error scenarios
+- Phát hiện race conditions
+
+**Advanced**: Load `references/industry-techniques.md` để:
+- Sử dụng Static Analysis (Technique #4) cho data/control flow
+- Sử dụng Type Analysis cho type compatibility
+- Áp dụng Test-Based Analysis (Technique #6) cho coverage mapping
+
+### 4. Generate Test Scenarios
+
+Load `references/test-scenario-generation.md` để:
+- Tạo happy path scenarios
+- Tạo error handling scenarios
+- Tạo integration test scenarios
+- Tạo regression test checklist
+
+### 5. Create Report
+
+Load `references/report-template.md` để:
+- Tổng hợp findings
+- Đánh giá risk
+- Đưa ra recommendations
+- Tạo actionable checklist
+
+## Output
+
+```markdown
+# Impact Analysis Report
+
+## 📋 Summary
+- Changed: 3 files
+- Affected: 12 components
+- Risk: Medium
+- Test Time: ~30 mins
+
+## 🔍 Changes
+{detailed analysis}
+
+## 🔗 Dependencies
+{affected files}
+
+## ⚠️ Edge Cases
+{identified issues}
+
+## 🧪 Test Scenarios
+{detailed scenarios}
+
+## ✅ Checklist
+{actionable items}
+```
+
+## Integration
+
+### With Code Review
+
+```
+1. Make changes
+2. /impact-analysis
+3. Review findings
+4. /review (includes impact report)
+```
+
+### With Testing
+
+```
+1. /impact-analysis
+2. Get test scenarios
+3. /test (execute scenarios)
+4. Verify all pass
+```
+
+## References
+
+### Core References
+- `references/project-detection.md` - Auto-detect project type & load profile
+- `references/change-detection.md` - Git diff analysis
+- `references/dependency-scouting.md` - Finding affected files
+- `references/edge-case-identification.md` - Edge case patterns
+- `references/test-scenario-generation.md` - Test templates
+- `references/report-template.md` - Output format
+
+### Advanced References
+- `references/industry-techniques.md` - 9 techniques từ industry & research
+- `references/practical-techniques-guide.md` - Detailed implementation guide
+- `references/react-native-customization.md` - React Native specific guide
+
+### Scripts
+- `scripts/README.md` - Helper scripts documentation
+- `scripts/ast-analyze.js` - AST-based analysis
+- `scripts/find-dependencies.sh` - Dependency analysis
+- `scripts/calculate-risk.js` - Risk scoring
+- `scripts/run-analysis.sh` - Master script
+
+## Advanced Techniques
+
+Skill này hỗ trợ advanced analysis techniques từ industry:
+
+### Available Scripts
+
+Located in `scripts/` directory:
+
+1. **ast-analyze.js** - AST-based semantic analysis
+   - Detect function signature changes
+   - Identify breaking changes
+   - Compare before/after versions
+
+2. **find-dependencies.sh** - Comprehensive dependency analysis
+   - Find all affected files
+   - Map API consumers
+   - Identify integration points
+
+3. **calculate-risk.js** - Automated risk scoring
+   - Multi-factor risk assessment
+   - Actionable recommendations
+   - JSON output for CI/CD
+
+4. **run-analysis.sh** - Master script
+   - Run all techniques
+   - Generate comprehensive report
+   - Markdown output
+
+### Usage
+
+```bash
+# Quick risk check
+node scripts/calculate-risk.js
+
+# Full analysis
+./scripts/run-analysis.sh
+
+# Specific files
+./scripts/run-analysis.sh --files "file1.ts,file2.ts"
+```
+
+See `scripts/README.md` for detailed documentation.
+
+## Best Practices
+
+1. **Run early** - Phân tích ngay sau khi code, không đợi đến commit
+2. **Focus on risk** - Ưu tiên high-risk changes
+3. **Automate** - Integrate vào workflow tự động (pre-commit, CI/CD)
+4. **Document** - Lưu findings để reference sau
+5. **Verify** - Luôn chạy tests sau khi có scenarios
+6. **Use scripts** - Leverage advanced techniques cho deep analysis
+
+## Examples
+
+### Example 1: API Change
+
+```bash
+# Changed: src/api/users.ts (added new field)
+/impact-analysis
+
+# Output:
+# - Affected: 5 frontend components using user data
+# - Edge cases: Null handling, backward compatibility
+# - Test: Verify old clients still work
+```
+
+### Example 2: Database Migration
+
+```bash
+# Changed: prisma/schema.prisma (renamed column)
+/impact-analysis
+
+# Output:
+# - Affected: 15 queries using old column name
+# - Edge cases: Migration rollback, data integrity
+# - Test: Verify all queries updated
+```
+
+### Example 3: Component Refactor
+
+```bash
+# Changed: components/Button.tsx (props interface)
+/impact-analysis
+
+# Output:
+# - Affected: 23 components using Button
+# - Edge cases: TypeScript errors, missing props
+# - Test: Visual regression, interaction tests
+```
+
+## Troubleshooting
+
+**Q: Không detect được changes?**
+A: Check git status, đảm bảo có staged/committed changes
+
+**Q: Quá nhiều affected files?**
+A: Sử dụng `--scope` để giới hạn phạm vi
+
+**Q: Test scenarios không đủ?**
+A: Load `edge-case-identification.md` và review manual

package/src/common/skills/impact-analysis/references/change-detection.md

@@ -0,0 +1,270 @@
+# Change Detection - Phát Hiện Thay Đổi
+
+Phương pháp phát hiện và phân loại code changes để phân tích tác động.
+
+## Git Commands
+
+### 1. Detect Recent Changes
+
+```bash
+# Changes chưa commit
+git diff --name-only
+
+# Changes đã staged
+git diff --cached --name-only
+
+# Changes trong commit gần nhất
+git diff --name-only HEAD~1
+
+# Changes so với branch khác
+git diff --name-only main...HEAD
+
+# Xem chi tiết thay đổi
+git diff HEAD~1
+
+# Xem thống kê
+git diff --stat HEAD~1
+```
+
+### 2. Get Change Details
+
+```bash
+# Số dòng thay đổi
+git diff --numstat HEAD~1
+
+# Files và số lượng changes
+git diff --shortstat HEAD~1
+
+# Chỉ xem added/deleted files
+git diff --diff-filter=AD --name-only HEAD~1
+```
+
+### 3. Historical Analysis
+
+```bash
+# Xem lịch sử file
+git log --oneline -10 {file}
+
+# Xem ai sửa dòng nào
+git blame {file}
+
+# Xem changes của commit cụ thể
+git show {commit-hash}
+```
+
+## Change Classification
+
+### Backend Changes
+
+**Indicators:**
+- Files: `*.ts`, `*.js`, `*.py`, `*.go` trong `src/api/`, `src/services/`, `src/controllers/`
+- Patterns: API routes, database queries, business logic
+
+**Risk Level:**
+- **High**: Authentication, authorization, payment, data validation
+- **Medium**: CRUD operations, utility functions
+- **Low**: Logging, comments, formatting
+
+**Check:**
+```bash
+# API endpoints changed
+grep -r "router\." {changed-files}
+grep -r "app\.(get|post|put|delete)" {changed-files}
+
+# Database queries
+grep -r "prisma\." {changed-files}
+grep -r "SELECT\|INSERT\|UPDATE\|DELETE" {changed-files}
+```
+
+### Frontend Changes
+
+**Indicators:**
+- Files: `*.tsx`, `*.jsx`, `*.vue`, `*.svelte` trong `src/components/`, `src/pages/`
+- Patterns: Components, hooks, state management
+
+**Risk Level:**
+- **High**: Authentication UI, payment forms, data entry
+- **Medium**: Display components, navigation
+- **Low**: Styling, text changes
+
+**Check:**
+```bash
+# Component props changed
+grep -r "interface.*Props" {changed-files}
+
+# State management
+grep -r "useState\|useEffect\|useContext" {changed-files}
+
+# API calls
+grep -r "fetch\|axios\|api\." {changed-files}
+```
+
+### Database Changes
+
+**Indicators:**
+- Files: `*.prisma`, `*.sql`, `migrations/*.sql`
+- Patterns: Schema changes, migrations
+
+**Risk Level:**
+- **Critical**: Column deletion, type changes, constraint changes
+- **High**: New required columns, index changes
+- **Medium**: New optional columns, new tables
+- **Low**: Comments, formatting
+
+**Check:**
+```bash
+# Schema changes
+git diff schema.prisma
+
+# Migration files
+ls -la migrations/ | tail -5
+
+# Find affected queries
+grep -r "{table_name}" src/
+```
+
+### Configuration Changes
+
+**Indicators:**
+- Files: `.env`, `config/*.ts`, `package.json`, `tsconfig.json`
+- Patterns: Environment variables, dependencies, build config
+
+**Risk Level:**
+- **Critical**: Database URL, API keys, auth secrets
+- **High**: Dependencies version, build settings
+- **Medium**: Feature flags, timeouts
+- **Low**: Comments, formatting
+
+**Check:**
+```bash
+# Env changes
+git diff .env.example
+
+# Dependency changes
+git diff package.json | grep -A5 -B5 "dependencies"
+
+# Config changes
+git diff config/
+```
+
+## Change Metrics
+
+### Lines of Code (LOC)
+
+```bash
+# Total LOC changed
+git diff --stat HEAD~1 | tail -1
+
+# Per file
+git diff --numstat HEAD~1
+```
+
+**Risk Assessment:**
+- **< 50 LOC**: Low risk
+- **50-200 LOC**: Medium risk
+- **> 200 LOC**: High risk (consider splitting)
+
+### File Count
+
+```bash
+# Count changed files
+git diff --name-only HEAD~1 | wc -l
+```
+
+**Risk Assessment:**
+- **1-3 files**: Low risk
+- **4-10 files**: Medium risk
+- **> 10 files**: High risk (wide impact)
+
+### Change Type
+
+```bash
+# Added lines
+git diff HEAD~1 | grep "^+" | wc -l
+
+# Deleted lines
+git diff HEAD~1 | grep "^-" | wc -l
+```
+
+**Risk Assessment:**
+- **More additions**: New feature (test new paths)
+- **More deletions**: Refactor (test existing paths)
+- **Balanced**: Modification (test both)
+
+## Automated Detection Script
+
+```bash
+#!/bin/bash
+# detect-changes.sh
+
+echo "=== Change Detection ==="
+
+# Get changed files
+CHANGED_FILES=$(git diff --name-only HEAD~1)
+FILE_COUNT=$(echo "$CHANGED_FILES" | wc -l)
+
+echo "Files changed: $FILE_COUNT"
+echo ""
+
+# Classify by type
+BACKEND=$(echo "$CHANGED_FILES" | grep -E "src/(api|services|controllers)" | wc -l)
+FRONTEND=$(echo "$CHANGED_FILES" | grep -E "src/(components|pages)" | wc -l)
+DATABASE=$(echo "$CHANGED_FILES" | grep -E "prisma|migrations" | wc -l)
+CONFIG=$(echo "$CHANGED_FILES" | grep -E "\.env|config|package\.json" | wc -l)
+
+echo "Backend: $BACKEND files"
+echo "Frontend: $FRONTEND files"
+echo "Database: $DATABASE files"
+echo "Config: $CONFIG files"
+echo ""
+
+# Get LOC stats
+git diff --stat HEAD~1 | tail -1
+
+# Risk assessment
+if [ $FILE_COUNT -gt 10 ] || [ $DATABASE -gt 0 ]; then
+    echo "Risk: HIGH"
+elif [ $FILE_COUNT -gt 3 ]; then
+    echo "Risk: MEDIUM"
+else
+    echo "Risk: LOW"
+fi
+```
+
+## Output Format
+
+```json
+{
+  "summary": {
+    "totalFiles": 5,
+    "linesAdded": 120,
+    "linesDeleted": 45,
+    "riskLevel": "medium"
+  },
+  "changes": [
+    {
+      "file": "src/api/auth.ts",
+      "type": "backend",
+      "category": "authentication",
+      "linesChanged": 67,
+      "risk": "high",
+      "reason": "Authentication logic modified"
+    },
+    {
+      "file": "src/components/Login.tsx",
+      "type": "frontend",
+      "category": "ui",
+      "linesChanged": 34,
+      "risk": "medium",
+      "reason": "Login form updated"
+    }
+  ]
+}
+```
+
+## Integration Points
+
+After detection, pass to:
+1. **Dependency Scouting** - Find affected files
+2. **Edge Case Identification** - Analyze risks
+3. **Test Scenario Generation** - Create tests