moai-adk 0.8.0__py3-none-any.whl → 0.8.2__py3-none-any.whl

moai_adk/templates/.moai/hooks/install.sh

@@ -0,0 +1,79 @@
+#!/bin/bash
+# @CODE:DOC-TAG-004 | Component 1: Pre-commit hook installer
+#
+# This script installs the TAG validation pre-commit hook into .git/hooks/
+#
+# Usage:
+#   ./install.sh              # Install hook
+#   ./install.sh --uninstall  # Remove hook
+
+set -e
+
+# Colors
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+RED='\033[0;31m'
+NC='\033[0m'
+
+# Get repository root
+REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || echo ".")
+HOOK_SOURCE="${REPO_ROOT}/.moai/hooks/pre-commit.sh"
+HOOK_TARGET="${REPO_ROOT}/.git/hooks/pre-commit"
+
+# Function to install hook
+install_hook() {
+    echo "🔧 Installing TAG validation pre-commit hook..."
+
+    # Check if source exists
+    if [ ! -f "$HOOK_SOURCE" ]; then
+        echo -e "${RED}Error: Hook source not found at $HOOK_SOURCE${NC}"
+        exit 1
+    fi
+
+    # Check if target already exists
+    if [ -f "$HOOK_TARGET" ]; then
+        echo -e "${YELLOW}Warning: Pre-commit hook already exists.${NC}"
+        echo "Backing up existing hook to ${HOOK_TARGET}.backup"
+        cp "$HOOK_TARGET" "${HOOK_TARGET}.backup"
+    fi
+
+    # Create .git/hooks directory if it doesn't exist
+    mkdir -p "$(dirname "$HOOK_TARGET")"
+
+    # Copy hook
+    cp "$HOOK_SOURCE" "$HOOK_TARGET"
+    chmod +x "$HOOK_TARGET"
+
+    echo -e "${GREEN}✓ Pre-commit hook installed successfully!${NC}"
+    echo ""
+    echo "The hook will now validate TAG annotations on every commit."
+    echo ""
+    echo "To uninstall: $0 --uninstall"
+}
+
+# Function to uninstall hook
+uninstall_hook() {
+    echo "🔧 Uninstalling TAG validation pre-commit hook..."
+
+    if [ ! -f "$HOOK_TARGET" ]; then
+        echo -e "${YELLOW}No pre-commit hook installed.${NC}"
+        exit 0
+    fi
+
+    # Check if backup exists
+    if [ -f "${HOOK_TARGET}.backup" ]; then
+        echo "Restoring backup..."
+        mv "${HOOK_TARGET}.backup" "$HOOK_TARGET"
+        echo -e "${GREEN}✓ Backup restored.${NC}"
+    else
+        rm "$HOOK_TARGET"
+        echo -e "${GREEN}✓ Pre-commit hook removed.${NC}"
+    fi
+}
+
+# Parse command line arguments
+if [ "$1" = "--uninstall" ]; then
+    uninstall_hook
+else
+    install_hook
+fi

moai_adk/templates/.moai/hooks/pre-commit.sh

@@ -0,0 +1,66 @@
+#!/bin/bash
+# @CODE:DOC-TAG-004 | Component 1: Pre-commit hook for TAG validation
+#
+# This hook validates TAG annotations in staged files before commit.
+# It checks:
+# - TAG format (@DOC:DOMAIN-TYPE-NNN)
+# - Duplicate TAG detection
+# - Orphan TAG detection (warnings only)
+#
+# Exit codes:
+#   0 - Validation passed
+#   1 - Validation failed (duplicates or format errors)
+
+set -e  # Exit on error
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# Get repository root
+REPO_ROOT=$(git rev-parse --show-toplevel)
+
+# Check if Python module is available
+if ! python3 -c "import moai_adk.core.tags.pre_commit_validator" 2>/dev/null; then
+    echo -e "${YELLOW}Warning: moai_adk TAG validator not found.${NC}"
+    echo "Skipping TAG validation. Install moai_adk to enable validation."
+    exit 0
+fi
+
+# Get staged files
+STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
+
+if [ -z "$STAGED_FILES" ]; then
+    echo -e "${GREEN}No staged files to validate.${NC}"
+    exit 0
+fi
+
+echo "🔍 Validating TAG annotations in staged files..."
+
+# Run TAG validation
+# Pass staged files as arguments to validator
+python3 -m moai_adk.core.tags.pre_commit_validator \
+    --files $STAGED_FILES
+
+VALIDATION_RESULT=$?
+
+# Check result
+if [ $VALIDATION_RESULT -eq 0 ]; then
+    echo -e "${GREEN}✓ TAG validation passed.${NC}"
+    exit 0
+else
+    echo -e "${RED}✗ TAG validation failed.${NC}"
+    echo ""
+    echo "Commit blocked due to TAG validation errors."
+    echo ""
+    echo "To fix:"
+    echo "  1. Fix duplicate TAGs or format errors shown above"
+    echo "  2. Stage your changes with 'git add'"
+    echo "  3. Try committing again"
+    echo ""
+    echo "To skip this validation (not recommended):"
+    echo "  git commit --no-verify"
+    exit 1
+fi

moai_adk/templates/.moai/memory/ISSUE-LABEL-MAPPING.md

@@ -0,0 +1,150 @@
+# 📌 GitHub Issue Label Mapping Configuration
+
+> **MoAI-ADK Label Management** - Centralized configuration for issue type labels and priority indicators
+
+**Version**: 1.0.0
+**Related**: `/alfred:9-feedback`
+
+---
+
+## 🏷️ Issue Type Label Mapping
+
+### Bug Issues (`--bug`)
+
+**Primary Labels**: `bug`, `reported`
+
+**Optional Labels** (based on priority):
+- `priority-critical` - System down, data loss risk
+- `priority-high` - Major feature broken
+- `priority-medium` - Normal bug
+- `priority-low` - Minor issue
+
+---
+
+### Feature Request Issues (`--feature`)
+
+**Primary Labels**: `feature-request`, `enhancement`
+
+**Optional Labels** (based on priority):
+- `priority-critical` - Blocking, must implement immediately
+- `priority-high` - Important feature
+- `priority-medium` - Normal priority feature (default)
+- `priority-low` - Nice to have
+
+---
+
+### Improvement Issues (`--improvement`)
+
+**Primary Labels**: `improvement`, `enhancement`
+
+**Optional Labels** (based on priority):
+- `priority-critical` - Critical refactoring needed
+- `priority-high` - Important improvement
+- `priority-medium` - Normal priority (default)
+- `priority-low` - Technical debt, can wait
+
+---
+
+### Question/Discussion Issues (`--question`)
+
+**Primary Labels**: `question`, `help-wanted`
+
+**Optional Labels** (based on priority):
+- `priority-critical` - Urgent decision needed
+- `priority-high` - Important decision
+- `priority-medium` - Normal discussion (default)
+- `priority-low` - Optional discussion
+
+---
+
+## 🎯 Priority Emoji Mapping
+
+| Priority | Emoji | Use Case |
+|----------|-------|----------|
+| Critical | 🔴 | System outage, data loss, security breach |
+| High | 🟠 | Major feature broken, significant impact |
+| Medium | 🟡 | Normal bugs/features (default) |
+| Low | 🟢 | Minor issues, nice-to-have features |
+
+---
+
+## 🚀 Issue Type Emoji Mapping
+
+| Type | Emoji | Description |
+|------|-------|-------------|
+| Bug | 🐛 | Defect or unexpected behavior |
+| Feature | ✨ | New functionality or capability |
+| Improvement | ⚡ | Code quality, performance, or design improvement |
+| Question | ❓ | Question, discussion, or decision needed |
+
+---
+
+## 🛠️ GitHub Labels Setup
+
+To create labels in your GitHub repository, use GitHub CLI:
+
+```bash
+# Authenticate first
+gh auth login
+
+# Create bug labels
+gh label create "bug" \
+  --description "Something isn't working" \
+  --color "d73a49"
+
+gh label create "reported" \
+  --description "User-reported issue" \
+  --color "fc2929"
+
+# Create feature labels
+gh label create "feature-request" \
+  --description "New feature or request" \
+  --color "a2eeef"
+
+gh label create "enhancement" \
+  --description "Improvement or enhancement" \
+  --color "0075ca"
+
+# Create improvement label
+gh label create "improvement" \
+  --description "Performance or code quality improvement" \
+  --color "5ebcf6"
+
+# Create question labels
+gh label create "question" \
+  --description "Question for discussion" \
+  --color "fbca04"
+
+gh label create "help-wanted" \
+  --description "We need help with this" \
+  --color "fcfc03"
+
+# Create priority labels
+gh label create "priority-critical" \
+  --description "Critical priority - URGENT" \
+  --color "ff0000"
+
+gh label create "priority-high" \
+  --description "High priority" \
+  --color "ff6600"
+
+gh label create "priority-medium" \
+  --description "Medium priority" \
+  --color "ffcc00"
+
+gh label create "priority-low" \
+  --description "Low priority" \
+  --color "00cc00"
+```
+
+---
+
+## ✨ Summary
+
+This configuration enables:
+- ✅ **Standardized issue labels** across all issue types
+- ✅ **Priority indicators** with emoji for visual identification
+- ✅ **Type emoji** for quick issue categorization
+- ✅ **Automated label assignment** via `/alfred:9-feedback`
+
+For more information, see `.moai/docs/quick-issue-creation-guide.md`

moai_adk/templates/CLAUDE.md

@@ -61,47 +61,43 @@ You are the SuperAgent **🎩 Alfred** of **🗿 MoAI-ADK**. Follow these core p
 
 ## 🌍 Alfred's Language Boundary Rule
 
-Alfred operates with a **crystal-clear three-layer language architecture** to support global users while keeping all Skills in English only:
+Alfred operates with a **clear two-layer language architecture** to support global users while keeping the infrastructure in English:
 
-### Layer 1: User Conversation
+### Layer 1: User Conversation & Dynamic Content
 **ALWAYS use user's `conversation_language` for ALL user-facing content:**
 - 🗣️ **Responses to user**: User's configured language (Korean, Japanese, Spanish, etc.)
 - 📝 **Explanations**: User's language
 - ❓ **Questions to user**: User's language
 - 💬 **All dialogue**: User's language
-
-### Layer 2: Internal Operations
-**EVERYTHING internal MUST be in English:**
-- `Task(prompt="...")` invocations → **English**
-- `Skill("skill-name")` calls → **English**
-- Sub-agent communication → **English**
-- Error messages (internal) → **English**
+- 📄 **Generated documents**: User's language (SPEC, reports, analysis)
+- 🔧 **Task prompts**: User's language (passed directly to Sub-agents)
+- 📨 **Sub-agent communication**: User's language
+
+### Layer 2: Static Infrastructure (English Only)
+**MoAI-ADK package and templates stay in English:**
+- `Skill("skill-name")` → **Skill names always English** (explicit invocation)
+- `.claude/skills/` → **Skill content in English** (technical documentation standard)
+- `.claude/agents/` → **Agent templates in English**
+- `.claude/commands/` → **Command templates in English**
+- Code comments → **English**
 - Git commit messages → **English**
-- All technical instructions → **English**
-
-### Layer 3: Skills & Code
-**Skills maintain English-only for infinite scalability:**
-- Skill descriptions → **English only**
-- Skill examples → **English only**
-- Skill guides → **English only**
-- Code comments → **English only**
-- No multilingual versions needed! ✅
+- @TAG identifiers → **English**
+- Technical function/variable names → **English**
 
 ### Execution Flow Example
 
 ```
-User Input (any language):  "Check code quality" / "コード品質をチェック" / "Verificar calidad del código"
+User Input (any language):  "코드 품질 검사해줘" / "Check code quality" / "コード品質をチェック"
                               ↓
-Alfred (internal translation): "Check code quality" (→ English)
+Alfred (passes directly):  Task(prompt="코드 품질 검사...", subagent_type="trust-checker")
                               ↓
-Invoke Sub-agent:          Task(prompt="Validate TRUST 5 principles",
-                                subagent_type="trust-checker")
+Sub-agent (receives Korean): Recognizes quality check task
                               ↓
-Sub-agent (receives English): Skill("moai-foundation-trust") ← 100% match!
+Sub-agent (explicit call):  Skill("moai-foundation-trust") ✅
                               ↓
-Alfred (receives results):  English TRUST report
+Skill loads (English content): Sub-agent reads English Skill guidance
                               ↓
-Alfred (translates back):    User's language response
+Sub-agent generates output:  Korean report based on user's language
                               ↓
 User Receives:             Response in their configured language
 ```
@@ -109,23 +105,25 @@ User Receives:             Response in their configured language
 ### Why This Pattern Works
 
 1. **Scalability**: Support any language without modifying 55 Skills
-2. **Maintainability**: Skills stay in English (single source of truth)
-3. **Reliability**: English keywords always match English Skill descriptions = 100% success rate
-4. **Best Practice**: Follows standard i18n architecture (localized frontend, English backend lingua franca)
-5. **Future-proof**: Add new languages instantly (Korean → Japanese → Spanish → Russian, etc.)
+2. **Maintainability**: Skills stay in English (single source of truth, industry standard for technical docs)
+3. **Reliability**: **Explicit Skill() invocation** = 100% success rate (no keyword matching needed)
+4. **Simplicity**: No translation layer overhead, direct language pass-through
+5. **Future-proof**: Add new languages instantly without code changes
 
 ### Key Rules for Sub-agents
 
-**All 12 Sub-agents MUST receive English prompts**, regardless of user's conversation language:
+**All 12 Sub-agents work in user's configured language:**
 
 | Sub-agent | Input Language | Output Language | Notes |
 |-----------|---|---|---|
-| spec-builder | **English** | English (reports to Alfred) | User requests translated to English before Task() call |
-| tdd-implementer | **English** | English | Receives English SPEC references |
-| doc-syncer | **English** | English | Processes English file descriptions |
-| implementation-planner | **English** | English | Architecture analysis in English |
-| debug-helper | **English** | English | Error analysis in English |
-| All others | **English** | English | Consistency across entire team |
+| spec-builder | **User's language** | User's language | Invokes Skills explicitly: Skill("moai-foundation-ears") |
+| tdd-implementer | **User's language** | User's language | Code comments in English, narratives in user's language |
+| doc-syncer | **User's language** | User's language | Generated docs in user's language |
+| implementation-planner | **User's language** | User's language | Architecture analysis in user's language |
+| debug-helper | **User's language** | User's language | Error analysis in user's language |
+| All others | **User's language** | User's language | Explicit Skill() invocation regardless of prompt language |
+
+**CRITICAL**: Skills are invoked **explicitly** using `Skill("skill-name")` syntax, NOT auto-triggered by keywords.
 
 ---
 
@@ -305,10 +303,11 @@ Your project is ready. You can now run `/alfred:1-plan` to start planning specs.
 - `.moai/memory/`
 - `CLAUDE.md` (this file)
 
-**Rationale**: These files define system behavior, tool invocations, and internal communication. English ensures:
-1. Skill trigger keywords always match English prompts (100% auto-invocation reliability)
-2. Global maintainability without translation burden
-3. Infinite language scalability (support any user language without code changes)
+**Rationale**: These files define system behavior, tool invocations, and internal infrastructure. English ensures:
+1. **Industry standard**: Technical documentation in English (single source of truth)
+2. **Global maintainability**: No translation burden for 55 Skills, 12 agents, 4 commands
+3. **Infinite scalability**: Support any user language without modifying infrastructure
+4. **Reliable invocation**: Explicit Skill("name") calls work regardless of prompt language
 
 ---
 

moai_adk/templates/src/moai_adk/core/__init__.py

@@ -0,0 +1,5 @@
+"""MoAI-ADK core modules
+
+This package contains core functionality for MoAI-ADK including:
+- TAG validation and management
+"""

moai_adk/templates/src/moai_adk/core/tags/__init__.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+# @CODE:DOC-TAG-004 | TAG validation core module (Components 1, 2, 3 & 4)
+"""TAG validation and management for MoAI-ADK
+
+This module provides TAG validation functionality for:
+- Pre-commit hook validation (Component 1)
+- CI/CD pipeline validation (Component 2)
+- Central validation system (Component 3)
+- Documentation & Reporting (Component 4)
+- TAG format checking
+- Duplicate detection
+- Orphan detection
+- Chain integrity validation
+"""
+
+# Component 1: Pre-commit validator
+from .pre_commit_validator import (
+    PreCommitValidator,
+    ValidationResult,
+    ValidationError,
+    ValidationWarning,
+)
+
+# Component 2: CI/CD validator
+from .ci_validator import CIValidator
+
+# Component 3: Central validation system
+from .validator import (
+    ValidationConfig,
+    TagValidator,
+    DuplicateValidator,
+    OrphanValidator,
+    ChainValidator,
+    FormatValidator,
+    CentralValidator,
+    CentralValidationResult,
+    ValidationIssue,
+    ValidationStatistics,
+)
+
+# Component 4: Documentation & Reporting
+from .reporter import (
+    TagInventory,
+    TagMatrix,
+    InventoryGenerator,
+    MatrixGenerator,
+    CoverageAnalyzer,
+    StatisticsGenerator,
+    ReportFormatter,
+    ReportGenerator,
+    CoverageMetrics,
+    StatisticsReport,
+    ReportResult,
+)
+
+__all__ = [
+    # Component 1
+    "PreCommitValidator",
+    "ValidationResult",
+    "ValidationError",
+    "ValidationWarning",
+    # Component 2
+    "CIValidator",
+    # Component 3
+    "ValidationConfig",
+    "TagValidator",
+    "DuplicateValidator",
+    "OrphanValidator",
+    "ChainValidator",
+    "FormatValidator",
+    "CentralValidator",
+    "CentralValidationResult",
+    "ValidationIssue",
+    "ValidationStatistics",
+    # Component 4
+    "TagInventory",
+    "TagMatrix",
+    "InventoryGenerator",
+    "MatrixGenerator",
+    "CoverageAnalyzer",
+    "StatisticsGenerator",
+    "ReportFormatter",
+    "ReportGenerator",
+    "CoverageMetrics",
+    "StatisticsReport",
+    "ReportResult",
+]