ai-flow-dev 2.6.0 → 2.8.0

package/README.md

@@ -10,7 +10,7 @@ AI Flow is an interactive CLI that creates comprehensive professional documentat
 
 **Key Features:**
 
-- 🚀 Complete professional documentation (Backend: 14 files, Frontend: 15 files, Mobile: 13 files, Desktop: 14 files, Fullstack: 30+ files)
+- 🚀 Complete professional documentation (Backend: 17 files, Frontend: 15 files, Mobile: 13 files, Desktop: 16 files, Fullstack: 30+ files)
 - 🧠 **Smart Description Refinement:** Detects ambiguity and iteratively guides you to a professional project definition.
 - ⚡ **Two modes:** Interactive (90-120 min, full control) or Smart Auto-Suggest (15-25 min, 6 questions)
 - 🌍 Universal support - 12 languages, 60+ frameworks, 35+ ORMs (98% coverage)
@@ -108,7 +108,7 @@ The result is interconnected documentation that guides AI assistants and human d
 
 - 🌍 **Universal Support** - 12 languages, 60+ frameworks, 35+ ORMs (98% coverage)
 - 🤖 **AI-Agnostic** - Claude, Copilot, Cursor, Gemini, Antigravity, any AI tool
-- 📚 **Professional Documentation** - Backend: 17 files, Frontend: 15 files, Mobile: 13 files, Desktop: 13 files, Fullstack: 30+ files
+- 📚 **Professional Documentation** - Backend: 14 files, Frontend: 15 files, Mobile: 13 files, Desktop: 14 files, Fullstack: 30+ files
 - 🧠 **Smart Description Refinement** - AI detects vague inputs and helps you rich the context (WHO, WHAT, WHY).
 - ⚡ **Two Questionnaire Modes:**
   - **Interactive Mode:** Full control, all phases (90-120 min)
@@ -116,7 +116,7 @@ The result is interconnected documentation that guides AI assistants and human d
 - 🔍 **Smart 3-Layer Detection** - Analyzes existing projects in 15s-5min
 - 💾 **Intelligent Caching** - 0 seconds on re-runs with no changes
 - 🚀 **Agent Mode** - Immediate, proactive execution for all AI workflows
-- 💡 **Slash Commands** - Easy execution with `/flow-build`, `/flow-work`, `/flow-check`, `/flow-commit`
+- 💡 **Slash Commands** - Easy execution with `/flow-build`, `/flow-work`, `/flow-check`, `/flow-commit`, `/flow-finish`, `/flow-release`
 - ⏱️ **Time Efficient** - Save 10-20 hours per project
 
 ---
@@ -140,7 +140,7 @@ Or using uv (Python tool manager):
 uv tool install ai-flow-dev
 ```
 
-## **Current version:** 2.5.1
+## **Current version:** 2.7.0
 
 ## 🚀 Quick Start
 
@@ -190,7 +190,6 @@ $ ai-flow check
 --type <type>            # backend, frontend, mobile, desktop, fullstack (interactive if omitted)
 --name <name>            # Project name (interactive if omitted)
 --description <desc>     # Project description (interactive if omitted)
---verbose                # Detailed logging (init only)
 --dry-run                # Simulate without writing (init only)
 ```
 
@@ -218,11 +217,8 @@ ai-flow init . --ai claude --type mobile
 # Desktop project example (NetBeans/Eclipse)
 ai-flow init . --ai claude --type desktop
 
-# Enable verbose output (detailed logging) - only for init command
-ai-flow init . --verbose
-
 # Simulate initialization without writing files (dry-run)
-ai-flow init . --dry-run --verbose
+ai-flow init . --dry-run
 
 # Show detailed help with all commands and options
 ai-flow --help
@@ -269,9 +265,10 @@ After initialization, use these slash commands in your AI tool:
 
 > **Note:** Command prefix may vary by AI tool. Examples use `/flow-` (GitHub Copilot), but Claude may use `/` alone, Cursor may use `@`, etc. Check your tool's documentation.
 
-**Backend Projects:** 22 prompts (/flow-build with phases 0-10, /flow-work, /flow-check, /flow-commit, /flow-docs-sync)  
-**Frontend Projects:** 22 prompts (same structure tailored for frontend)  
-**Mobile Projects:** 22 prompts (same structure tailored for mobile apps)  
+**Backend Projects:** 24 prompts (/flow-build with phases 0-10, /flow-work, /flow-check, /flow-commit, /flow-finish, /flow-docs-sync, /flow-release)  
+**Frontend Projects:** 25 prompts (same structure tailored for frontend)  
+**Mobile Projects:** 25 prompts (same structure tailored for mobile apps)  
+**Desktop Projects:** 24 prompts (same structure tailored for desktop apps)  
 **Fullstack Projects:** Combined backend + frontend commands
 
 **Documentation & Build:**
@@ -281,7 +278,9 @@ After initialization, use these slash commands in your AI tool:
 - `/flow-work` - Development orchestrator (feature, refactor, fix, resume)
 - `/flow-check` - Combined code review & testing workflow
 - `/flow-commit` - Atomic commits (Conventional Commits)
+- `/flow-finish` - Finalize work: archive, generate PR/Jira descriptions with AI, push
 - `/flow-docs-sync` - Update documentation when code changes
+- `/flow-release` - Semantic versioning automation with Git tags and Swagger UI updates
 
 **Fases disponibles (Backend):**
 
@@ -313,12 +312,14 @@ After initialization, use these slash commands in your AI tool:
 
 **Workflows (All project types):**
 
-- `/flow-work` - **Unified orchestrator** for Features/Refactors/Fixes with smart detection, automatic completion tracking, and consolidated planning
+- `/flow-work` - **Development orchestrator** for Features/Refactors/Fixes with smart detection, automatic completion tracking, and consolidated planning. Updates source documentation (roadmap/user stories), then guides you to run `/flow-finish`.
 - `/flow-check` - **Combined validation**: Tests + Code Review in one command
 - `/flow-commit` - Automate commits with Conventional Commits (3-5 min)
+- `/flow-finish` - **Finalization workflow**: Smart validation (reuses /flow-check results), work archiving, AI-powered PR/Jira descriptions (~1200 tokens), optional push. Separate from `/flow-work` for better modularity.
 - `/flow-docs-sync` - **Sync documentation** when code changes occur
+- `/flow-release` - **Version release automation**: Semantic versioning, Git tags, Swagger UI updates, CHANGELOG generation
 
-> **Note:** `/flow-work` automatically marks tasks as complete in `planning/roadmap.md` and user story DoD checklists when implementation finishes. It generates a consolidated `work.md` file for efficient planning and context management.
+> **Architecture:** `/flow-work` focuses on development (planning → implementation → source docs update), while `/flow-finish` handles finalization (validation → archiving → summaries → push). This separation follows Unix philosophy: one tool, one responsibility. At the end of `/flow-work`, you get an interactive prompt to run `/flow-finish` immediately or handle finalization manually.
 
 ## **📚 See [GETTING-STARTED.md](GETTING-STARTED.md) for complete command reference**
 
@@ -392,21 +393,23 @@ AI Flow organizes your project with clear separation of concerns:
 
 ## 🎯 Generated Documentation
 
-**Backend** (17 files): AGENT.md, ai-instructions.md, copilot-instructions.md, project-brief.md, README.md, plus 8 docs (in docs/) and 4 specs/configs.
+**Backend** (14 files): AGENT.md, ai-instructions.md, copilot-instructions.md, project-brief.md, README.md, plus 9 technical docs/specs.
 
 **Frontend** (15 files): AGENT.md, ai-instructions.md, project-brief.md, plus 12 technical docs/specs.
 
 **Mobile** (13 files): AGENT.md, ai-instructions.md, project-brief.md, plus 10 technical docs/specs.
 
+**Desktop** (14 files): AGENT.md, ai-instructions.md, copilot-instructions.md, project-brief.md, README.md, plus 9 technical docs/specs.
+
 **Fullstack** (30+ files): Combined Backend + Frontend documentation structures.
 
-**Slash Commands/Prompts** (72 total):
+**Slash Commands/Prompts** (98 total):
 
-- Backend: 22 prompts (/flow-build with phases 0-10, /flow-work variants, /flow-check, /flow-commit, /flow-docs-sync)
-- Frontend: 22 prompts (same structure tailored for frontend)
-- Mobile: 22 prompts (same structure tailored for mobile apps)
-- Shared: 6 prompts (task-format.md, story-points.md, task-summary-template.md, etc.)
-- **Total: 72 prompts** across all project types
+- Backend: 24 prompts (/flow-build with phases 0-10, /flow-work variants, /flow-check, /flow-commit, /flow-finish, /flow-docs-sync, /flow-release)
+- Frontend: 25 prompts (same structure tailored for frontend + /flow-work-api + /flow-finish + /flow-release)
+- Mobile: 25 prompts (same structure tailored for mobile apps + /flow-work-api + /flow-finish + /flow-release)
+- Desktop: 24 prompts (same structure tailored for desktop apps + /flow-finish + /flow-release)
+- **Total: 98 prompts** across all project types
 
 Each project type gets workflow commands optimized for its technology stack.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-flow-dev",
-  "version": "2.6.0",
+  "version": "2.8.0",
   "description": "AI-powered development workflow from idea to production. Generate specs, plan features, and build with AI assistance throughout your project lifecycle.",
   "type": "module",
   "main": "dist/cli.js",
@@ -45,7 +45,7 @@
     "@inquirer/prompts": "^8.1.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
-    "ejs": "^3.1.10",
+    "ejs": "^5.0.1",
     "fs-extra": "^11.2.0",
     "ora": "^9.0.0"
   },
@@ -54,9 +54,9 @@
     "@types/fs-extra": "^11.0.4",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.49.0",
-    "@typescript-eslint/parser": "^8.49.0",
-    "eslint": "^9.39.1",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
+    "eslint": "^10.0.3",
     "eslint-config-prettier": "^10.1.8",
     "jest": "^30.2.0",
     "prettier": "^3.4.2",
@@ -71,4 +71,4 @@
     "README.md",
     "LICENSE"
   ]
-}
+}