ai-flow-dev 1.3.0 → 2.0.1

package/prompts/backend/flow-dev-fix.md

@@ -229,7 +229,7 @@ Time: 4 minutes
 
 ```
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📋 Fix Plan
+📋 Fix Plan (COMPLEX Bug)
 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 Issue: Memory leak in WebSocket connections
@@ -239,12 +239,85 @@ Root causes identified:
 2. Connection map not clearing disconnected sockets
 3. Redis subscriptions not being unsubscribed
 
-Fix plan:
-1. Add socket.removeAllListeners() on disconnect
-2. Delete from activeConnections Map on disconnect
-3. Call redisClient.unsubscribe() on disconnect
-4. Add heartbeat mechanism
-5. Add connection monitoring
+**Affected files:**
+- src/websocket/notificationSocket.ts (event listeners)
+- src/services/ConnectionManager.ts (connection map)
+- src/app.ts (Redis setup)
+
+**Estimated:** 5 SP (~8-10 hours) • 10 tasks
+
+**Fix plan:** (Test-First approach, execution order)
+
+- [ ] [T001] [P] Write test for event listener cleanup • 1 SP (~1-2h)
+      File: tests/unit/websocket/disconnect-cleanup.spec.ts
+      Tests: Verify listeners removed, memory not retained
+      Dependencies: None (can run parallel with T003)
+
+- [ ] [T002] Add socket.removeAllListeners() on disconnect • 1 SP (~1h)
+      File: src/websocket/notificationSocket.ts
+      Implements: Cleanup in disconnect event handler
+      Dependencies: None
+
+- [ ] [T003] [P] Write test for connection map cleanup • 1 SP (~1h)
+      File: tests/unit/services/ConnectionManager.spec.ts
+      Tests: Verify Map.delete() called, connection removed
+      Dependencies: None (can run parallel with T001)
+
+- [ ] [T004] Delete from activeConnections Map on disconnect • 1 SP (~30min)
+      File: src/services/ConnectionManager.ts
+      Implements: this.activeConnections.delete(socketId)
+      Dependencies: None
+
+- [ ] [T005] Write test for Redis unsubscribe • 1 SP (~1h)
+      File: tests/integration/redis/subscription-cleanup.spec.ts
+      Tests: Redis UNSUBSCRIBE called, channels cleaned up
+      Dependencies: None
+
+- [ ] [T006] Call redisClient.unsubscribe() on disconnect • 1 SP (~1h)
+      File: src/app.ts
+      Implements: Unsubscribe from all channels for this connection
+      Dependencies: None
+
+- [ ] [T007] Write test for heartbeat mechanism • 1 SP (~1-2h)
+      File: tests/unit/websocket/heartbeat.spec.ts
+      Tests: Ping/pong, timeout detection, stale cleanup
+      Dependencies: None
+
+- [ ] [T008] Implement heartbeat mechanism • 2 SP (~3-4h)
+      File: src/websocket/heartbeat.ts
+      Implements: Ping every 30s, timeout after 60s, auto-disconnect
+      Dependencies: None
+
+- [ ] [T009] Add connection monitoring and metrics • 1 SP (~1-2h)
+      File: src/services/ConnectionMonitor.ts
+      Implements: Track active count, memory usage, alert on leaks
+      Dependencies: T004 (needs ConnectionManager cleanup)
+
+- [ ] [T010] Integration test for complete cleanup flow • 1 SP (~1-2h)
+      File: tests/integration/websocket/full-cleanup.spec.ts
+      Tests: Connect 1000 clients, disconnect all, verify memory freed
+      Dependencies: T002, T004, T006, T008 (needs all fixes)
+
+**Parallelization Notes:**
+- T001, T003 can run in parallel (different test files)
+- T002, T004, T006, T008 can run in parallel (different files)
+- T010 (E2E test) depends on all fixes complete
+
+**Task Execution Graph:**
+
+```
+T001 [P] ──┐
+T003 [P] ──┼──> (Test tasks can run parallel)
+T005 [P] ──┤
+T007 [P] ──┘
+
+T002 (notificationSocket.ts) ──┐
+T004 (ConnectionManager.ts) ───┼──> T009 (Monitor) ──> T010 (E2E test)
+T006 (app.ts) ──────────────────┤
+T008 (heartbeat.ts) ────────────┘
+```
+
+**Estimated time:** 8-10 hours (with AI) | 2-3 days (manual)
 
 Proceed with fix? (Y/n)
 ```
@@ -900,4 +973,4 @@ Time: 14 minutes
 ---
 
 **BEGIN EXECUTION when user runs `/fix` or `/fix "description"`**
-
+

package/prompts/backend/flow-docs-sync.md

@@ -464,7 +464,7 @@ Actualización cancelada. Ejecuta `/flow-docs-sync` cuando estés listo para act
 2. **Follow Existing Patterns:**
 
    - Use same format as existing documentation
-   - Follow conventions established in original bootstrap
+   - Follow conventions established in original build
    - Maintain consistency with existing docs
 
 3. **Update Analysis File:**
@@ -524,3 +524,4 @@ Documentación sincronizada exitosamente.
 
 **BEGIN EXECUTION when user runs `/flow-docs-sync`**
 
+

package/prompts/frontend/{flow-bootstrap-phase-0.md → flow-build-phase-0.md}

@@ -2,7 +2,7 @@
 
 **⚡ AUTOMATED ANALYSIS - Minimal User Input Required**
 
-This phase automatically analyzes your existing frontend codebase to pre-populate answers for the bootstrap questionnaire.
+This phase automatically analyzes your existing frontend codebase to pre-populate answers for the build questionnaire.
 
 ---
 
@@ -483,7 +483,7 @@ After Phase 0 completes:
 
 Next: Proceed to Phase 1 (Discovery & UX)
 
-Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-1-discovery.md
+Read: .ai-flow/prompts/frontend/flow-build-phase-1-discovery.md
 ```
 
 ---
@@ -493,3 +493,4 @@ Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-1-discovery.md
 **Version:** 1.2.0
 
 
+

package/prompts/frontend/{flow-bootstrap-phase-1.md → flow-build-phase-1.md}

@@ -438,7 +438,7 @@ Documents Generated:
 
 Next: Phase 2 - Components & Framework
 
-Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-2-components.md
+Read: .ai-flow/prompts/frontend/flow-build-phase-2-components.md
 ```
 
 ---
@@ -448,3 +448,4 @@ Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-2-components.md
 **Version:** 1.2.0
 
 
+

package/prompts/frontend/{flow-bootstrap-phase-2.md → flow-build-phase-2.md}

@@ -7,7 +7,7 @@
 
 ## 📋 Context
 
-You are in **Phase 2 of 7** of the frontend bootstrap process.
+You are in **Phase 2 of 7** of the frontend build process.
 
 **What we're defining:**
 - UI Framework selection (React/Vue/Angular/Svelte/Solid)
@@ -981,3 +981,4 @@ After Phase 2 completion, you will:
 **Estimated time:** 15-20 minutes
 **Documents updated:** ai-instructions.md, docs/components.md, docs/architecture.md
 
+

package/prompts/frontend/{flow-bootstrap-phase-3.md → flow-build-phase-3.md}

@@ -674,7 +674,7 @@ Documents Generated:
 
 Next: Phase 4 - Styling & Design
 
-Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-4-styling.md
+Read: .ai-flow/prompts/frontend/flow-build-phase-4-styling.md
 ```
 
 ---
@@ -684,3 +684,4 @@ Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-4-styling.md
 **Version:** 1.2.0
 
 
+

package/prompts/frontend/{flow-bootstrap-phase-4.md → flow-build-phase-4.md}

@@ -264,7 +264,7 @@ A) ⭐ **Tailwind defaults** (Recommended)
    - xl: 1280px
    - 2xl: 1536px
 
-B) **Bootstrap-style**
+B) **build-style**
    - xs: 0px
    - sm: 576px
    - md: 768px
@@ -469,7 +469,7 @@ Documents Generated:
 
 Next: Phase 5 - Code Standards
 
-Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-5-standards.md
+Read: .ai-flow/prompts/frontend/flow-build-phase-5-standards.md
 ```
 
 ---
@@ -479,3 +479,5 @@ Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-5-standards.md
 **Version:** 1.2.0
 
 
+
+

package/prompts/frontend/{flow-bootstrap-phase-5.md → flow-build-phase-5.md}

@@ -472,7 +472,7 @@ Documents Generated:
 
 Next: Phase 6 - Testing Strategy
 
-Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-6-testing.md
+Read: .ai-flow/prompts/frontend/flow-build-phase-6-testing.md
 ```
 
 ---
@@ -482,3 +482,4 @@ Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-6-testing.md
 **Version:** 1.2.0
 
 
+

package/prompts/frontend/{flow-bootstrap-phase-6.md → flow-build-phase-6.md}

@@ -559,7 +559,7 @@ Documents Generated:
 
 Next: Phase 7 - Performance & Deployment
 
-Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-7-deployment.md
+Read: .ai-flow/prompts/frontend/flow-build-phase-7-deployment.md
 ```
 
 ---
@@ -569,3 +569,4 @@ Read: .ai-flow/prompts/frontend/flow-bootstrap-phase-7-deployment.md
 **Version:** 1.2.0
 
 
+

package/prompts/frontend/{flow-bootstrap-phase-8.md → flow-build-phase-8.md}

@@ -243,13 +243,14 @@ Proceeding to documentation generation...
 
 ✅ Context fully loaded and updated!
 
-🎉 Now generating final 4 documents:
+🎉 Now generating final 5 documents:
 
 1. docs/components-guide.md - Component architecture and patterns
 2. docs/state-management.md - State management strategy
 3. docs/contributing.md - Contribution guidelines
-4. AGENT.md - Universal AI configuration (master index)
-5. README.md - Project overview (consolidates all phases)
+4. .gitignore - Ignore patterns for your tech stack
+5. AGENT.md - Universal AI configuration (master index)
+6. README.md - Project overview (consolidates all phases)
 
 Generating...
 ```
@@ -265,6 +266,12 @@ Generating...
   - Add styling approach
   - Link to component library (if using one)
 
+**📝 Action:** Write the complete file to `docs/components-guide.md`
+
+```
+✅ Generated: docs/components-guide.md
+```
+
 ### 8.3.2: Generate docs/state-management.md
 
 - **Template:** `.ai-flow/templates/docs/state-management.template.md`
@@ -276,6 +283,12 @@ Generating...
   - Document async state handling
   - Add caching strategy
 
+**📝 Action:** Write the complete file to `docs/state-management.md`
+
+```
+✅ Generated: docs/state-management.md
+```
+
 ### 8.3.3: Generate docs/contributing.md
 
 - **Template:** `.ai-flow/templates/docs/contributing.template.md`
@@ -287,6 +300,161 @@ Generating...
   - Setup instructions from Phase 7
   - Testing requirements from Phase 6
 
+**📝 Action:** Write the complete file to `docs/contributing.md`
+
+```
+✅ Generated: docs/contributing.md
+```
+
+---
+
+## 8.3.4: Generate .gitignore
+
+**IMPORTANT:** Generate a comprehensive `.gitignore` file based on the framework, bundler, and tools selected in previous phases.
+
+```
+📝 Generating .gitignore for your frontend stack...
+```
+
+**Strategy:**
+
+1. **Detect framework from Phase 3** (React, Vue, Angular, etc.)
+2. **Detect bundler/meta-framework** (Vite, Next.js, Create React App, etc.)
+3. **Detect package manager** (npm, yarn, pnpm)
+4. **Combine relevant patterns**
+
+**Base patterns for JavaScript/TypeScript projects:**
+
+```gitignore
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Production builds
+dist/
+build/
+.next/
+out/
+.nuxt/
+.output/
+.vite/
+*.local
+
+# Environment variables
+.env
+.env*.local
+.env.production
+
+# IDE
+.vscode/
+!.vscode/extensions.json
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+coverage/
+.nyc_output/
+*.lcov
+
+# TypeScript
+*.tsbuildinfo
+.tsbuildinfo
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+
+# Cache
+.cache/
+.parcel-cache/
+.turbo/
+.eslintcache
+.stylelintcache
+
+# Storybook
+storybook-static/
+```
+
+**Framework-specific additions:**
+
+**Next.js:**
+
+```gitignore
+# Next.js
+.next/
+out/
+next-env.d.ts
+```
+
+**Vite:**
+
+```gitignore
+# Vite
+dist/
+.vite/
+```
+
+**Angular:**
+
+```gitignore
+# Angular
+/dist/
+/tmp/
+/out-tsc/
+/bazel-out/
+.angular/
+```
+
+**Vue (with Vite):**
+
+```gitignore
+# Vue
+dist/
+.vite/
+```
+
+**Nuxt:**
+
+```gitignore
+# Nuxt
+.nuxt/
+.output/
+.nitro/
+.cache/
+```
+
+**📝 Action:** Generate and write `.gitignore` to project root.
+
+**Selection logic:**
+
+- If React + Vite → Base + Vite patterns
+- If Next.js → Base + Next.js patterns
+- If Angular → Base + Angular patterns
+- If Vue + Vite → Base + Vite patterns
+- If Nuxt → Base + Nuxt patterns
+
+```
+✅ Generated: .gitignore
+   Patterns included: [Framework] + [Bundler] + Base JavaScript patterns
+```
+
 ---
 
 ## 8.4: Generate AGENT.md (Master Index)
@@ -347,6 +515,33 @@ Generating...
 [From operations.md and contributing.md]
 ```
 
+**📝 Action:**
+
+```
+🔄 Re-reading all generated documents for AGENT.md generation...
+
+✅ Reading .ai-flow/project-brief.md
+✅ Reading .ai-flow/ai-instructions.md
+✅ Reading docs/ui-structure.md
+✅ Reading docs/architecture.md
+✅ Reading docs/components-guide.md
+✅ Reading docs/state-management.md
+✅ Reading docs/code-standards.md
+✅ Reading docs/testing.md
+✅ Reading docs/performance.md
+✅ Reading docs/operations.md
+✅ Reading specs/configuration.md
+✅ Reading docs/contributing.md
+
+✅ All context loaded!
+```
+
+**📝 Action:** Write the complete file to `.ai-flow/AGENT.md`
+
+```
+✅ Generated: .ai-flow/AGENT.md (Master Index)
+```
+
 ---
 
 ## 8.5: Generate README.md (Intelligent Merge)
@@ -382,6 +577,13 @@ Generating...
 5. **Ensure no duplication**
 6. **Validate all links** work correctly
 
+**📝 Action:** Write the complete file to `.ai-flow/README.md`
+
+```
+✅ Generated: .ai-flow/README.md
+   [If merged] Merged with framework's setup instructions
+```
+
 ---
 
 ## 8.6: Create Tool-Specific Configs
@@ -405,20 +607,20 @@ Read `.ai-flow/AGENT.md` first for complete documentation index.
 
 - Project overview: `.ai-flow/project-brief.md`
 - AI instructions: `.ai-flow/ai-instructions.md`
-- Architecture: `.ai-flow/docs/architecture.md`
-- UI Structure: `.ai-flow/docs/ui-structure.md`
-- Components: `.ai-flow/docs/components-guide.md`
-- State: `.ai-flow/docs/state-management.md`
-- Code standards: `.ai-flow/docs/code-standards.md`
+- Architecture: `docs/architecture.md`
+- UI Structure: `docs/ui-structure.md`
+- Components: `docs/components-guide.md`
+- State: `docs/state-management.md`
+- Code standards: `docs/code-standards.md`
 
 ## Working Instructions
 
 When writing code:
 
-1. Follow patterns in `.ai-flow/docs/code-standards.md`
-2. Reference component structure in `.ai-flow/docs/ui-structure.md`
-3. Follow state management patterns from `.ai-flow/docs/state-management.md`
-4. Write tests per `.ai-flow/docs/testing.md`
+1. Follow patterns in `docs/code-standards.md`
+2. Reference component structure in `docs/ui-structure.md`
+3. Follow state management patterns from `docs/state-management.md`
+4. Write tests per `docs/testing.md`
 
 ## Critical Rules
 
@@ -441,9 +643,9 @@ See `.ai-flow/AGENT.md` for complete document list.
 ## Quick Reference
 
 - Tech Stack: [from Phase 3]
-- Architecture: `.ai-flow/docs/architecture.md`
-- Components: `.ai-flow/docs/components-guide.md`
-- Code Standards: `.ai-flow/docs/code-standards.md`
+- Architecture: `docs/architecture.md`
+- Components: `docs/components-guide.md`
+- Code Standards: `docs/code-standards.md`
 
 ## Code Generation Rules
 
@@ -469,12 +671,12 @@ Master index: `.ai-flow/AGENT.md`
 
 ## Key References
 
-- Architecture: `.ai-flow/docs/architecture.md`
-- UI Structure: `.ai-flow/docs/ui-structure.md`
-- Components: `.ai-flow/docs/components-guide.md`
-- State: `.ai-flow/docs/state-management.md`
-- Code Standards: `.ai-flow/docs/code-standards.md`
-- Testing: `.ai-flow/docs/testing.md`
+- Architecture: `docs/architecture.md`
+- UI Structure: `docs/ui-structure.md`
+- Components: `docs/components-guide.md`
+- State: `docs/state-management.md`
+- Code Standards: `docs/code-standards.md`
+- Testing: `docs/testing.md`
 
 ## Code Generation Guidelines
 
@@ -485,6 +687,18 @@ Master index: `.ai-flow/AGENT.md`
 [From Phase 3]
 ```
 
+**📝 Action:** Generate the tool-specific config files based on selection:
+
+- If Claude → Write `.clauderules`
+- If Cursor → Write `.cursorrules`
+- If Copilot → Write `.github/copilot-instructions.md`
+- If "All" → Write all three files
+
+```
+✅ Generated tool-specific configs:
+   [List generated files based on selection]
+```
+
 ---
 
 ## 8.7: Final Validation & Success Message
@@ -505,7 +719,7 @@ All validations passed!
 ```
 🎉 AI Flow Complete!
 
-Generated 14 documents successfully:
+Generated 15 documents successfully:
 
 Phase 1:
 ✅ project-brief.md
@@ -533,6 +747,7 @@ Phase 8:
 ✅ docs/components-guide.md
 ✅ docs/state-management.md
 ✅ docs/contributing.md
+✅ .gitignore
 ✅ README.md
 ✅ AGENT.md
 
@@ -570,6 +785,7 @@ your-project/
 ├── [framework files]            # If initialized
 ├── README.md
 ├── .env.example
+├── .gitignore
 └── [tool configs]               # .clauderules, .cursorrules, etc.
 
 ---