moai-adk 0.6.1__py3-none-any.whl → 0.7.0__py3-none-any.whl

moai_adk/templates/CLAUDE.md

@@ -6,7 +6,7 @@
 > **Project Owner**: {{PROJECT_OWNER}}
 > **Config**: `.moai/config.json`
 >
-> All interactions with Alfred can use `Skill("moai-alfred-interactive-questions")` for TUI-based responses.
+> **Note**: `Skill("moai-alfred-interactive-questions")` provides TUI-based responses when user interaction is needed. The skill loads on-demand.
 
 ---
 

{moai_adk-0.6.1.dist-info → moai_adk-0.7.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.6.1
+Version: 0.7.0
 Summary: MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0
 Project-URL: Homepage, https://github.com/modu-ai/moai-adk
 Project-URL: Repository, https://github.com/modu-ai/moai-adk
@@ -513,16 +513,90 @@ uv tool list  # Check current version of moai-adk
 
 ### Upgrading
 
-#### Method 1: MoAI-ADK Built-in Update Command (Simplest)
+#### Method 1: MoAI-ADK Built-in Update Command (Recommended - 3-Stage Workflow, v0.6.3+)
+<!-- @DOC:UPDATE-REFACTOR-002-003 -->
 
+MoAI-ADK's `update` command provides **automatic tool detection** and **intelligent 3-stage workflow** with **70-80% performance improvement** for templates already synchronized:
+
+**Basic 3-Stage Workflow** (automatic tool detection):
 ```bash
-# MoAI-ADK's own update command - also updates agent/Skills templates
+# Stage 1: Package version check
+# Shows version comparison, upgrades if needed
 moai-adk update
 
-# Apply new templates to project after update (optional)
-moai-adk init .
+# Stage 2: Config version comparison (NEW in v0.6.3)
+# Compares package template version with project config
+# If already synchronized, exits early (70-80% faster!)
+
+# Stage 3: Template sync (only if needed)
+# Creates backup → Syncs templates → Updates config
+# Message: "✓ Templates synced!" or "Templates are up to date!"
+```
+
+**Check for updates without applying them**:
+```bash
+# Preview available updates (shows package & config versions)
+moai-adk update --check
+```
+
+**Templates-only mode** (skip package upgrade, useful for manual upgrades):
+```bash
+# If you manually upgraded the package, sync templates only
+# Still performs Stage 2 config comparison for accuracy
+moai-adk update --templates-only
 ```
 
+**CI/CD mode** (auto-confirm all prompts):
+```bash
+# Auto-confirms all prompts - useful in automated pipelines
+# Runs all 3 stages automatically
+moai-adk update --yes
+```
+
+**Force mode** (skip backup creation):
+```bash
+# Update without creating backup (use with caution)
+# Still performs config version comparison
+moai-adk update --force
+```
+
+**How the 3-Stage Workflow Works** (v0.6.3):
+
+| Stage | Condition | Action | Performance |
+|-------|-----------|--------|-------------|
+| **Stage 1** | Package: current < latest | Detects installer → Upgrades package | ~20-30s |
+| **Stage 2** | Config: compare versions | Reads template_version from config.json | ~1s ⚡ **NEW!** |
+| **Stage 3** | Config: package > project | Creates backup → Syncs templates (if needed) | ~10-15s |
+
+**Performance Improvement** (v0.6.3):
+- **Same version case**: 12-18s → 3-4s (**70-80% faster!** ⚡)
+  - Stage 1: ~1s (version check)
+  - Stage 2: ~1s (config comparison)
+  - Stage 3: **skipped** (already synchronized)
+
+- **CI/CD repeated runs**: **-30% cost reduction**
+  - First run: Full sync
+  - Subsequent runs: Only version checks (~3-4s)
+
+**Why 3 stages?**
+Python processes cannot upgrade themselves while running. The 3-stage workflow is necessary for safety AND performance:
+1. **Stage 1**: Package upgrade detection (compares with PyPI)
+2. **Stage 2**: Template sync necessity detection (compares config versions) - NEW v0.6.3
+3. **Stage 3**: Templates and configuration sync (only if necessary)
+
+**Key Improvement in v0.6.3**:
+Previously, all updates would sync templates even if nothing changed. Now, config version comparison (Stage 2) detects when templates are already current, **skipping Stage 3 entirely** (saves 10-15 seconds!)
+
+**Config Version Tracking**:
+```json
+{
+  "project": {
+    "template_version": "0.6.3"  // Tracks last synchronized template version
+  }
+}
+```
+This field allows MoAI-ADK to accurately determine if templates need synchronization without re-syncing everything.
+
 #### Method 2: Upgrade with uv tool command
 
 **Upgrade specific tool (recommended)**
@@ -555,22 +629,20 @@ moai-adk --version
 # 2. Verify project works correctly
 moai-adk doctor
 
-# 3. Apply new templates to existing project (if needed)
-cd your-project
-moai-adk init .  # Keeps existing code, updates only .moai/ structure and templates
-
-# 4. Check updated features in Alfred
+# 3. Check updated features in Alfred
 cd your-project
 claude
 /alfred:0-project  # Verify new features like language selection
 ```
 
-> 💡 **Tip**:
+> 💡 **New 2-Stage Update Workflow**:
 >
-> - `moai-adk update`: Updates MoAI-ADK package version + syncs agent/Skills templates
-> - `moai-adk init .`: Applies new templates to existing project (keeps code safe)
-> - Running both commands completes a full update
-> - When major updates (minor/major) release, run these procedures to utilize new agents/Skills
+> - **Stage 1**: `moai-adk update` detects installer (uv tool, pipx, or pip) and upgrades package
+> - **Stage 2**: `moai-adk update` again to sync templates, config, and agent/Skills
+> - **Smart detection**: Auto-detects whether package upgrade is needed based on version comparison
+> - **CI/CD ready**: Use `moai-adk update --yes` for fully automated updates in pipelines
+> - **Manual upgrade path**: Use `moai-adk update --templates-only` after manually upgrading the package
+> - **Rollback safe**: Automatic backups in `.moai-backups/` before template sync
 
 ---
 
@@ -1642,3 +1714,9 @@ Start a new experience of **trustworthy AI development** with Alfred! 🤖
 - 🏷️ TAG Guard: Automatic @TAG validation in PreToolUse Hook
 
 ---
+
+## ⭐ Star History
+
+[![Star History Chart](https://api.star-history.com/svg?repos=modu-ai/moai-adk&type=date&legend=top-left)](https://www.star-history.com/#modu-ai/moai-adk&Date)
+
+---

{moai_adk-0.6.1.dist-info → moai_adk-0.7.0.dist-info}/RECORD

@@ -7,10 +7,12 @@ moai_adk/cli/commands/backup.py,sha256=jKdm9P55RIIdaBLhXYDQdbn2ThQDVDrc9_No48uHB
 moai_adk/cli/commands/doctor.py,sha256=keyU2PwwiUGuQViQVDlXKCqLmi6F1JDW3JEOOY64wgk,9831
 moai_adk/cli/commands/init.py,sha256=XidvHLZD-7_ZoHk-LcKmJaj78hhAjj7yB6LCBKHxx40,11459
 moai_adk/cli/commands/status.py,sha256=FQgzz7GYKk1W-w08xBg1A1bziSGsE0qvXhQJrPjow8o,3796
-moai_adk/cli/commands/update.py,sha256=RrwHIdjQRDBvLRGxWzHDqS05S-xD_9ALiig5655m8UE,14764
+moai_adk/cli/commands/update.py,sha256=iwDDD_ozCfkGUk1ci2CPfybzRtNFPMi-680NxmKhDc8,30177
 moai_adk/cli/prompts/__init__.py,sha256=a4_ctS4KEvGtmM9j7z8XIlMkpftohjVb9woUwZu38gE,136
 moai_adk/cli/prompts/init_prompts.py,sha256=OZ_T-b4XfkyXQsKXTwLcDYwmLbaf0k5oZfbi_asTH9M,5226
 moai_adk/core/__init__.py,sha256=1sJO-PHEKF1NmYjeOPPPzn_HRgYln3CKlCpUH4E2Jrs,129
+moai_adk/core/config/__init__.py,sha256=30Qx-GSN1LLI_9ngNqQ6A6d40J92xK10AQxhKw1-MzU,328
+moai_adk/core/config/migration.py,sha256=KzFGx3kPNoOaZCmAQvNpvlrQq48N3Gj6o2COVV7jciA,3541
 moai_adk/core/diagnostics/__init__.py,sha256=aF-qC2CW0wxZDpxnlh-TILYs3kqwOIj2EjXYEXY-2j8,387
 moai_adk/core/diagnostics/slash_commands.py,sha256=cEH96M5RLxa1JLyoeoRqziBMzAbnN30j04YjNjxM7Ro,4682
 moai_adk/core/git/__init__.py,sha256=Kpq2yU5X5bBBUV8ySYIB1_vMPvfdFS6hTYx2Ue-CoeQ,697
@@ -25,7 +27,7 @@ moai_adk/core/project/backup_utils.py,sha256=-zEXIhGsM-MdX1voUIpKxLlR57Y-lqLEZSi
 moai_adk/core/project/checker.py,sha256=B94mGLHDZkjQnFDgV8sknJDms5oIiHeyKcgxWI87-f8,9523
 moai_adk/core/project/detector.py,sha256=ADVg36yvyqJEPQVNc_x9iInF9dzi7YZqqXfDq2XL17Q,4230
 moai_adk/core/project/initializer.py,sha256=yqxePuCO2ednzCOpDZLczyCP079J6Io4pvtynTp4J6w,6724
-moai_adk/core/project/phase_executor.py,sha256=w3z8VRT9p9rcmMt2lWCHmH5rHSWmLMvbe1dHHMEu0KY,10666
+moai_adk/core/project/phase_executor.py,sha256=MZXqzYZA4OrZT0xViplyOUVRchiSaEWeTEmyzkSHEQY,10997
 moai_adk/core/project/validator.py,sha256=gH9ywTMQTwqtqBVrMWj5_bPYFrVzjHuFoU4QdeVa1O4,5756
 moai_adk/core/quality/__init__.py,sha256=_uNsbThBLmVLWZCPmEgfFyQqJx3tdef9jhkP9QoHuJY,222
 moai_adk/core/quality/trust_checker.py,sha256=CN067AiublAH46IBAKEV_I-8Wc0bNaR2dMnMf9n5oBg,15198
@@ -38,25 +40,25 @@ moai_adk/core/template/languages.py,sha256=V0wLcxCIOve9Q_0_NhrHGQevSIN_MB612GwrO
 moai_adk/core/template/merger.py,sha256=ZV8_U1HZJ3bfAtgyNmSxgj8KdTMt4eUnUG6kVVRT7bE,6909
 moai_adk/core/template/processor.py,sha256=_nYHiuN9PGzC3iE4X5SpRMFW-OTkI2u1dOAjD98axAk,19190
 moai_adk/templates/.gitignore,sha256=6VNKResdDpyaii3cmJA4pOLwK2PhYARIWkUODYtKyxg,310
-moai_adk/templates/CLAUDE.md,sha256=uf6n3RKG0YdtWO26ZDfkE39jIYvXuRekgRFz2YflLLQ,11281
+moai_adk/templates/CLAUDE.md,sha256=F1KjJb2HPT887aW9HBGezm2lh0wfNZcN5GLOF2aTo_k,11318
 moai_adk/templates/__init__.py,sha256=6MV1gCB7PLZMiL4gaD_dZSKxtcQyo45MMTuN8fVdchA,104
 moai_adk/templates/.claude/settings.json,sha256=SwjID_m0XWmHT12lqkhJXL1Sh30zAr9_tk4drQ9x9K8,3149
 moai_adk/templates/.claude/agents/alfred/cc-manager.md,sha256=63HRf8C7JNRApeOqGJi9Iwhcn5is9ImucsfRHhZ5zFU,8348
-moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=X6dOEtT93h8RHwRhx-EFXtKAoXZebI0B14KYhLttDho,7204
-moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=fFeUB81my-bTwJmLlBZIsANn1E6C8lEeq7swHI7g7vc,8619
-moai_adk/templates/.claude/agents/alfred/git-manager.md,sha256=jZUR-XrZ4McQCjGSt64Wb9pt5uNKwcV_n9xBxbR6iV4,14057
-moai_adk/templates/.claude/agents/alfred/implementation-planner.md,sha256=wx71G8_YAqro77ecej7tkSPKHcCBU7yCClxqOhbgzXA,11528
-moai_adk/templates/.claude/agents/alfred/project-manager.md,sha256=rXTou0zOjJmBJUnkU9_5VZKNOffjxIhK3bYcAj-HuW4,14891
-moai_adk/templates/.claude/agents/alfred/quality-gate.md,sha256=x7OZmqTGgeJqtZ6vAKmVOWKwpdrEYMmcydcU7LGn5Tg,10694
+moai_adk/templates/.claude/agents/alfred/debug-helper.md,sha256=vI0RaXhmEqpIHBHc3KYhCQsbOhF1Xy2yCJOyxfOQ9wQ,7221
+moai_adk/templates/.claude/agents/alfred/doc-syncer.md,sha256=QUzfYwUnGm46ZgN067iS6yKayE3AAYM9QIcjAO8jv5A,8636
+moai_adk/templates/.claude/agents/alfred/git-manager.md,sha256=yen1XeZJXEAE7e8JkE5lxNoLAlbm-1iPTyQMbY8yH9c,14074
+moai_adk/templates/.claude/agents/alfred/implementation-planner.md,sha256=ZSR-OWii-5pH3qLjAid89OaC4JW2QnwZgN-s5vp32lA,11545
+moai_adk/templates/.claude/agents/alfred/project-manager.md,sha256=xEU4OnEKiysH08ZWvK9KqJheoFYZXlZ9UmDDs2B80O0,14908
+moai_adk/templates/.claude/agents/alfred/quality-gate.md,sha256=iAx3O2wOWP-mpYFEumJpdLDavyqQ5Yk0ILbcvZtw98k,10711
 moai_adk/templates/.claude/agents/alfred/skill-factory.md,sha256=PGnrkeT5630ELQ2vBwVGaJr3vzU6I-4LObiZrCCjGjw,26229
-moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=yWtF_gALjHwirPvtkz9PQOfCbFZevH7WWFqjEaSiAEA,12490
-moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=ocDVfqk1q7f8SH7As3X_hokiRfostCnLaJf37-7dw8Q,9594
-moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=vCyJRZWdRXPk9qdra-QQtEf21ap28w8sx5VYPnWMHMA,10200
-moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=oTQ6BvGYU_luJDNwqjNPIU9G5dKUWRV4wJpmgyqr4dk,13578
-moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=-gyBdhT7dYIGMNYv91DF_1uepGW_B0lJMDV8nlrzuIE,45878
-moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=t_6ubTvlZsp8u1RIy5isJFlITH7tFp2UKiIg0NfJ4bU,22028
-moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=m2WLbrR0Njky5SPMLTuvQPJBeSUcmlUXivr4IbvKUYA,20415
-moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=yhxi-V7NOkhRYcrNKQ4zYJGxHrtQTfRm_ejcExf-SsE,22402
+moai_adk/templates/.claude/agents/alfred/spec-builder.md,sha256=xYzdnYbmozvSfHrkQKSfIgmlXYFGJ-tpPtubIyY0AM4,12507
+moai_adk/templates/.claude/agents/alfred/tag-agent.md,sha256=6n8n93kho3XTONZ4At7VwuZR4QjF1KmNoIN5u_CdNcE,9611
+moai_adk/templates/.claude/agents/alfred/tdd-implementer.md,sha256=p9e2PLSH5uUP3fXjaGGMzdm6-QZqDoMSUsCDzUtYQYk,10217
+moai_adk/templates/.claude/agents/alfred/trust-checker.md,sha256=TK3rVt0UqgoT8p6ubm3TesbhG6nokmV9FqR4DfC_VjU,13595
+moai_adk/templates/.claude/commands/alfred/0-project.md,sha256=sXEiAJX0L220K93drjttQGWLVDtYHS1pTzQDNToVIo0,46399
+moai_adk/templates/.claude/commands/alfred/1-plan.md,sha256=xjPSZFVZ5FeLcC5nGfkLDc1xEeTzx4RwL5zHS2H1DSo,25170
+moai_adk/templates/.claude/commands/alfred/2-run.md,sha256=xEteotB1u-j7HD0id1Sw4Uopdvv8XK51nnB4qjc3bM0,20820
+moai_adk/templates/.claude/commands/alfred/3-sync.md,sha256=EZtQpqPwzVaOvW21kx9VKi7RHMpe8PIA72iTU_sLfMQ,22992
 moai_adk/templates/.claude/hooks/alfred/HOOK_SCHEMA_VALIDATION.md,sha256=5dd6KRFQXzp0L8lAWKRN7Momgg_8XNV1QZ6VGs03_pc,9064
 moai_adk/templates/.claude/hooks/alfred/README.md,sha256=8JirNg3Jn2OUFmHySYBd8QxQgPkG7kcev86Zkf80asY,6852
 moai_adk/templates/.claude/hooks/alfred/alfred_hooks.py,sha256=PjdyJluyoQgaIpq3n9K9r-a3VeLMH1eWcXaAA6ohvrw,7723
@@ -255,7 +257,7 @@ moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md,sha256=q753rSPFZfylgwh6HkEP2
 moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml,sha256=c6WaTy7Vh6IsNsIJzSTGuGpaGhZAZ1prQXGIUM7P8PA,5212
 moai_adk/templates/.github/workflows/moai-gitflow.yml,sha256=D9ob1O7tzsUvk3WQPPaHFx1Oo6_RxnbCb5WHJ6DWyrI,8589
 moai_adk/templates/.github/workflows/spec-issue-sync.yml,sha256=VJ0IQcIEnlnZ-3jdvQNruhBxpygYRZAP2bkn35CCO-Q,6307
-moai_adk/templates/.moai/config.json,sha256=0DZ9zK3wUD2lRfeqX93tYJz5Pb_h7DV4k2wyB9RZ6HQ,2202
+moai_adk/templates/.moai/config.json,sha256=oAL0Gb4jy-dEvhnPvitkc95dckzAU5w95mekV514YX0,2348
 moai_adk/templates/.moai/memory/CLAUDE-AGENTS-GUIDE.md,sha256=37Qj5DYcyUniLM1g8IU7UWFI_16tutZrcAkJc4E5i20,15876
 moai_adk/templates/.moai/memory/CLAUDE-PRACTICES.md,sha256=Tf3q68X1DiA3MkIBYu7AMXoeparYrDRpyqVI5Nw92OY,12653
 moai_adk/templates/.moai/memory/CLAUDE-RULES.md,sha256=S9GODGRzwwleOmROVtBDa471Ok5NyQLWIkaO_4peHhU,19783
@@ -273,8 +275,8 @@ moai_adk/templates/.moai/project/tech.md,sha256=REecMv8wOvutt-pQZ5nlGk5YdReTan7A
 moai_adk/utils/__init__.py,sha256=VnVfQzzKHvKw4bNdEw5xdscnRQYFrnr-v_TOBr3naPs,225
 moai_adk/utils/banner.py,sha256=znppKd5yo-tTqgyhgPVJjstrTrfcy_v3X1_RFQxP4Fk,1878
 moai_adk/utils/logger.py,sha256=g-m07PGKjK2bKRIInfSn6m-024Bedai-pV_WjZKDeu8,5064
-moai_adk-0.6.1.dist-info/METADATA,sha256=IX0tIPlVvj4lXEA23-HJc6PwOfRaVlHuI9P81gkOPvo,68010
-moai_adk-0.6.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-moai_adk-0.6.1.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
-moai_adk-0.6.1.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
-moai_adk-0.6.1.dist-info/RECORD,,
+moai_adk-0.7.0.dist-info/METADATA,sha256=lhC1D05uXdGGdJ8PLMERCaBkxt7mfW8IyzInxMD0KCE,71251
+moai_adk-0.7.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+moai_adk-0.7.0.dist-info/entry_points.txt,sha256=P9no1794UipqH72LP-ltdyfVd_MeB1WKJY_6-JQgV3U,52
+moai_adk-0.7.0.dist-info/licenses/LICENSE,sha256=M1M2b07fWcSWRM6_P3wbZKndZvyfHyYk_Wu9bS8F7o8,1069
+moai_adk-0.7.0.dist-info/RECORD,,