moai-adk 0.5.2__tar.gz → 0.5.4__tar.gz

{moai_adk-0.5.2 → moai_adk-0.5.4}/.gitignore

@@ -69,3 +69,6 @@ logs/
 *.temp
 
 .claudeignore
+
+# Project Plans (internal tracking, not versioned)
+CURSOR_INTEGRATION_PLAN.md

{moai_adk-0.5.2 → moai_adk-0.5.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: moai-adk
-Version: 0.5.2
+Version: 0.5.4
 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
@@ -1247,7 +1247,7 @@ If you need to temporarily disable hooks, edit `.claude/settings.json`:
 | **v0.4.7** | 📖 Korean language optimization + SPEC-First principle documentation                 | 2025-10-22 |
 | **v0.4.6** | 🎉 Complete Skills v2.0 (100% Production-Ready) + 85,000 lines official docs + 300+ TDD examples | 2025-10-22 |
 
-> 📦 **Install Now**: `pip install moai-adk==0.4.11` or `uv tool install moai-adk==0.4.11`
+> 📦 **Install Now**: `uv tool install moai-adk==0.4.11` or `pip install moai-adk==0.4.11`
 
 ---
 

{moai_adk-0.5.2 → moai_adk-0.5.4}/README.md

@@ -1208,7 +1208,7 @@ If you need to temporarily disable hooks, edit `.claude/settings.json`:
 | **v0.4.7** | 📖 Korean language optimization + SPEC-First principle documentation                 | 2025-10-22 |
 | **v0.4.6** | 🎉 Complete Skills v2.0 (100% Production-Ready) + 85,000 lines official docs + 300+ TDD examples | 2025-10-22 |
 
-> 📦 **Install Now**: `pip install moai-adk==0.4.11` or `uv tool install moai-adk==0.4.11`
+> 📦 **Install Now**: `uv tool install moai-adk==0.4.11` or `pip install moai-adk==0.4.11`
 
 ---
 

{moai_adk-0.5.2 → moai_adk-0.5.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "moai-adk"
-version = "0.5.2"
+version = "0.5.4"
 description = "MoAI Agentic Development Kit - SPEC-First TDD with Alfred SuperAgent & Complete Skills v2.0"
 readme = "README.md"
 requires-python = ">=3.13"

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/cli/commands/backup.py

@@ -1,4 +1,28 @@
-"""Backup command"""
+"""Backup command
+
+Create a backup of the current project including:
+- .claude/ (entire directory)
+- .moai/ (excluding specs and reports)
+- CLAUDE.md
+
+Backup location: .moai-backups/YYYYMMDD-HHMMSS/
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-git**: For Git workflow and backup management
+  - Trigger: Before creating critical backups, review Git state
+  - Invocation: `Skill("moai-foundation-git")` for backup naming conventions
+
+### When to Invoke Skills in Related Workflows
+1. **Before backup creation**:
+   - Run `Skill("moai-foundation-git")` to document current Git branch state
+   - Tag backup with feature branch name for easier recovery
+
+2. **After restoration from backup**:
+   - Verify with `Skill("moai-foundation-tags")` that TAGs are intact
+   - Run `Skill("moai-foundation-trust")` to validate toolchain
+"""
 from pathlib import Path
 
 import click

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/cli/commands/doctor.py

@@ -8,6 +8,30 @@ System diagnostics command:
 - Validate project structure
 - Inspect language-specific tool chains
 - Diagnose slash command loading issues (--check-commands)
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-langs**: For language toolchain verification and detection
+  - Trigger: Use `--verbose` or `--fix` flag to inspect language-specific tools
+  - Invocation: `Skill("moai-foundation-langs")` for detailed language stack analysis
+
+- **moai-foundation-trust**: For TRUST 5-principles verification after fixing tools
+  - Trigger: After running doctor with `--fix` to validate improvements
+  - Invocation: `Skill("moai-foundation-trust")` to verify code quality toolchain
+
+### When to Invoke Skills in Related Workflows
+1. **After doctor diagnosis**:
+   - Run `Skill("moai-foundation-trust")` to validate that all TRUST tools are properly configured
+   - Run `Skill("moai-foundation-langs")` to confirm language-specific toolchains
+
+2. **When tools are missing** (`--fix` flag):
+   - Use suggested fixes from doctor command
+   - Follow up with `Skill("moai-foundation-langs")` to validate corrections
+
+3. **Debugging slash command issues** (`--check-commands`):
+   - Run `Skill("moai-cc-commands")` if commands fail to load
+   - Check `.claude/commands/` directory structure and permissions
 """
 
 import json
@@ -168,11 +192,13 @@ def _suggest_fixes(tools: dict[str, bool], language: str | None) -> None:
 
 def _get_install_command(tool: str, language: str | None) -> str:
     """Return the install command for a given tool (helper)"""
-    # Common tools
+    # Common tools with preferred package managers
     install_commands = {
-        "pytest": "pip install pytest",
-        "mypy": "pip install mypy",
-        "ruff": "pip install ruff",
+        # Python tools (prefer uv)
+        "pytest": "uv pip install pytest",
+        "mypy": "uv pip install mypy",
+        "ruff": "uv pip install ruff",
+        # JavaScript tools
         "vitest": "npm install -D vitest",
         "biome": "npm install -D @biomejs/biome",
         "eslint": "npm install -D eslint",

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/cli/commands/init.py

@@ -6,6 +6,25 @@
 Project initialization command (interactive/non-interactive):
 - Interactive Mode: Ask user for project settings
 - Non-Interactive Mode: Use defaults or CLI options
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-langs**: For language detection and stack configuration
+  - Trigger: When language parameter is not specified (auto-detection)
+  - Invocation: Called implicitly during project initialization for language matrix detection
+
+### When to Invoke Skills in Related Workflows
+1. **After project initialization**:
+   - Run `Skill("moai-foundation-trust")` to verify project structure and toolchain
+   - Run `Skill("moai-foundation-langs")` to validate detected language stack
+
+2. **Before first SPEC creation**:
+   - Use `Skill("moai-alfred-language-detection")` to confirm language selection
+
+3. **Project reinitialization** (`--force`):
+   - Skills automatically adapt to new project structure
+   - No manual intervention required
 """
 
 import json

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/cli/commands/status.py

@@ -5,6 +5,34 @@ Project status display:
 - Read project information from config.json
 - Show the number of SPEC documents
 - Summarize the Git status
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-tags**: For detailed TAG inventory and orphan detection
+  - Trigger: When you need to verify TAG chain integrity beyond what status shows
+  - Invocation: `Skill("moai-foundation-tags")` to scan full project for orphan TAGs
+
+- **moai-foundation-trust**: For comprehensive TRUST 5-principles verification
+  - Trigger: After status shows SPECs exist, to validate code quality
+  - Invocation: `Skill("moai-foundation-trust")` to verify all quality gates
+
+- **moai-foundation-git**: For detailed Git workflow information
+  - Trigger: When Git status shows "Modified" and you need workflow guidance
+  - Invocation: `Skill("moai-foundation-git")` for GitFlow automation details
+
+### When to Invoke Skills in Related Workflows
+1. **Before starting new SPEC creation**:
+   - Run `Skill("moai-foundation-tags")` to verify no orphan TAGs exist from previous work
+   - Check the SPEC count from status command
+
+2. **After modifications to code/docs**:
+   - If status shows "Modified", run `Skill("moai-foundation-git")` for commit strategy
+   - Follow up with `Skill("moai-foundation-trust")` to validate code quality
+
+3. **Periodic health checks**:
+   - Run status command regularly
+   - When SPEC count grows, verify with `Skill("moai-foundation-tags")` and `Skill("moai-foundation-trust")`
 """
 
 import json

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/cli/commands/update.py

@@ -1,4 +1,36 @@
-"""Update command"""
+"""Update command
+
+Update MoAI-ADK to the latest version available on PyPI.
+Includes:
+- Version checking from PyPI
+- Template and configuration updates
+- Backward compatibility validation
+
+## Skill Invocation Guide (English-Only)
+
+### Related Skills
+- **moai-foundation-trust**: For post-update validation
+  - Trigger: After updating MoAI-ADK version
+  - Invocation: `Skill("moai-foundation-trust")` to verify all toolchains still work
+
+- **moai-foundation-langs**: For language detection after update
+  - Trigger: After updating, confirm language stack is intact
+  - Invocation: `Skill("moai-foundation-langs")` to re-detect and validate language configuration
+
+### When to Invoke Skills in Related Workflows
+1. **After successful update**:
+   - Run `Skill("moai-foundation-trust")` to validate all TRUST 5 gates
+   - Run `Skill("moai-foundation-langs")` to confirm language toolchain still works
+   - Run project doctor command for full system validation
+
+2. **Before updating**:
+   - Create backup with `python -m moai_adk backup`
+   - Run `Skill("moai-foundation-tags")` to document current TAG state
+
+3. **If update fails**:
+   - Use backup to restore previous state
+   - Debug with `python -m moai_adk doctor --verbose`
+"""
 from __future__ import annotations
 
 import json
@@ -344,8 +376,16 @@ def update(path: str, force: bool, check: bool) -> None:
         console.print("\n[green]✓ Update complete![/green]")
         if latest_version and version.parse(current_version) < version.parse(latest_version):
             console.print(
-                "[yellow]⚠ Python package still on older version. "
-                "Run 'pip install --upgrade moai-adk' to upgrade the CLI package.[/yellow]"
+                "[yellow]⚠ Python package still on older version.[/yellow]"
+            )
+            console.print(
+                "[cyan]Upgrade options:[/cyan]"
+            )
+            console.print(
+                "  1. uv tool (recommended): uv tool upgrade moai-adk"
+            )
+            console.print(
+                "  2. pip (legacy):          pip install --upgrade moai-adk"
             )
         console.print("\n[cyan]ℹ️  Next step: Run /alfred:0-project update to optimize template changes[/cyan]")
 

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/core/project/phase_executor.py

@@ -15,6 +15,7 @@ import subprocess
 from collections.abc import Callable
 from datetime import datetime
 from pathlib import Path
+from typing import Any
 
 from rich.console import Console
 
@@ -166,7 +167,7 @@ class PhaseExecutor:
     def execute_configuration_phase(
         self,
         project_path: Path,
-        config: dict[str, str | bool],
+        config: dict[str, str | bool | dict[Any, Any]],
         progress_callback: ProgressCallback | None = None,
     ) -> list[str]:
         """Phase 4: generate configuration.

{moai_adk-0.5.2 → moai_adk-0.5.4}/src/moai_adk/templates/.claude/commands/alfred/3-sync.md

@@ -99,7 +99,9 @@ Users can run the command as follows:
 
 Analyze project status to determine synchronization scope, develop a systematic synchronization plan, and receive user confirmation.
 
-**The doc-syncer agent automatically scans the TAG chain and identifies and analyzes Git changes.**
+**The tag-agent performs comprehensive TAG verification (full project scope), and doc-syncer analyzes Git changes and establishes synchronization plan.**
+
+⚠️ **Important**: Tag-agent must verify the ENTIRE PROJECT for TAG orphans, not just changed files. Full-project scope is MANDATORY.
 
 ### 🔍 TAG chain navigation (optional)
 
@@ -129,12 +131,27 @@ Invoking the Task tool (Explore agent):
 **In STEP 1, call doc-syncer and tag-agent using the Task tool**:
 
 ```
-1. Tag-agent call (TAG verification):
+1. Tag-agent call (TAG verification - FULL PROJECT SCOPE):
    - subagent_type: "tag-agent"
-- description: "Verify TAG system"
- - prompt: "Please verify the integrity of the entire TAG chain.
- Please verify the integrity of @SPEC, @TEST, @CODE, @DOC TAGs
- and orphan TAGs.
+- description: "Verify TAG system across entire project"
+ - prompt: "Please perform a COMPREHENSIVE TAG system verification across the ENTIRE PROJECT.
+
+ **Required scope**: Scan all source files, not just changed files.
+
+ **Verification items**:
+ 1. @SPEC TAGs in .moai/specs/ directory
+ 2. @TEST TAGs in tests/ directory
+ 3. @CODE TAGs in src/ directory
+ 4. @DOC TAGs in docs/ directory
+
+ **Orphan detection** (MANDATORY):
+ - Detect @CODE TAGs without matching @SPEC
+ - Detect @SPEC TAGs without matching @CODE
+ - Detect @TEST TAGs without matching @SPEC
+ - Detect @DOC TAGs without matching @SPEC/@CODE
+
+ **Output format**: Provide complete list of orphan TAGs with locations.
+
  (Optional) Explore results: $EXPLORE_RESULTS"
 
 2. doc-syncer call (synchronization plan):