moai-adk 0.9.1__py3-none-any.whl → 0.10.1__py3-none-any.whl

moai_adk/templates/.github/workflows/tag-report.yml

@@ -1,261 +0,0 @@
-# @CODE:DOC-TAG-004 | Component 4: Automated TAG reporting workflow
-name: TAG Report Generation
-
-on:
-  # Scheduled: Daily at 09:00 UTC
-  schedule:
-    - cron: '0 9 * * *'
-
-  # Event: Push to main/develop
-  push:
-    branches:
-      - main
-      - develop
-
-  # Manual: Workflow dispatch
-  workflow_dispatch:
-    inputs:
-      output_format:
-        description: 'Report format (all|inventory|matrix|statistics)'
-        required: false
-        default: 'all'
-
-jobs:
-  generate-tag-reports:
-    name: Generate TAG Reports
-    runs-on: ubuntu-latest
-
-    permissions:
-      contents: write  # Required to commit reports back to repo
-      pull-requests: write  # Required to comment on PRs
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0  # Full history for accurate file modification times
-
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.11'
-          cache: 'pip'
-
-      - name: Install MoAI-ADK
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e .
-
-      - name: Create reports directory
-        run: |
-          mkdir -p docs/reports
-          echo "Reports will be generated in docs/reports/"
-
-      - name: Generate TAG Inventory
-        run: |
-          python -c "
-          from moai_adk.core.tags.reporter import ReportGenerator
-
-          generator = ReportGenerator()
-          inventory = generator.generate_inventory_report('.')
-
-          with open('docs/reports/tag-inventory.md', 'w') as f:
-              f.write(inventory)
-
-          print('✅ Generated tag-inventory.md')
-          "
-
-      - name: Generate TAG Coverage Matrix
-        run: |
-          python -c "
-          from moai_adk.core.tags.reporter import ReportGenerator
-
-          generator = ReportGenerator()
-          matrix = generator.generate_matrix_report('.')
-
-          with open('docs/reports/tag-matrix.md', 'w') as f:
-              f.write(matrix)
-
-          print('✅ Generated tag-matrix.md')
-          "
-
-      - name: Generate TAG Statistics
-        run: |
-          python -c "
-          from moai_adk.core.tags.reporter import ReportGenerator
-
-          generator = ReportGenerator()
-          stats = generator.generate_statistics_report('.')
-
-          with open('docs/reports/tag-statistics.json', 'w') as f:
-              f.write(stats)
-
-          print('✅ Generated tag-statistics.json')
-          "
-
-      - name: Generate combined report
-        run: |
-          python -c "
-          from moai_adk.core.tags.reporter import ReportGenerator
-          from pathlib import Path
-          import json
-
-          generator = ReportGenerator()
-          result = generator.generate_all_reports('.', 'docs/reports')
-
-          if result.success:
-              print(f'✅ All reports generated successfully')
-              print(f'   - Inventory: {result.inventory_path}')
-              print(f'   - Matrix: {result.matrix_path}')
-              print(f'   - Statistics: {result.statistics_path}')
-
-              # Read statistics for summary
-              stats = json.loads(result.statistics_path.read_text())
-              print(f'')
-              print(f'📊 Summary:')
-              print(f'   - Total TAGs: {stats[\"total_tags\"]}')
-              print(f'   - By Type: SPEC={stats[\"by_type\"].get(\"SPEC\", 0)}, CODE={stats[\"by_type\"].get(\"CODE\", 0)}, TEST={stats[\"by_type\"].get(\"TEST\", 0)}, DOC={stats[\"by_type\"].get(\"DOC\", 0)}')
-              print(f'   - Coverage: {stats[\"coverage\"].get(\"overall_percentage\", 0)}%')
-          else:
-              print(f'❌ Report generation failed: {result.error_message}')
-              exit(1)
-          "
-
-      - name: Check for changes
-        id: git_status
-        run: |
-          if [ -n "$(git status --porcelain docs/reports/)" ]; then
-            echo "changes=true" >> $GITHUB_OUTPUT
-            echo "📝 TAG reports have changed"
-          else
-            echo "changes=false" >> $GITHUB_OUTPUT
-            echo "✅ TAG reports unchanged (no commit needed)"
-          fi
-
-      - name: Commit reports
-        if: steps.git_status.outputs.changes == 'true'
-        run: |
-          git config --global user.name 'github-actions[bot]'
-          git config --global user.email 'github-actions[bot]@users.noreply.github.com'
-          git add docs/reports/
-          git commit -m "docs(tags): Update TAG reports [automated]
-
-          - Updated tag-inventory.md
-          - Updated tag-matrix.md
-          - Updated tag-statistics.json
-
-          Generated by: GitHub Actions workflow (tag-report.yml)
-          Triggered: ${{ github.event_name }}
-          Commit: ${{ github.sha }}
-
-          🤖 Generated with MoAI-ADK TAG Reporting System
-          "
-          git push
-
-      - name: Create GitHub Release Notes
-        if: github.ref == 'refs/heads/main' && steps.git_status.outputs.changes == 'true'
-        run: |
-          echo "📊 TAG System Health Report" > report_summary.md
-          echo "" >> report_summary.md
-          echo "Generated: $(date -u +'%Y-%m-%d %H:%M:%S UTC')" >> report_summary.md
-          echo "" >> report_summary.md
-
-          # Extract key metrics from statistics
-          python -c "
-          import json
-          from pathlib import Path
-
-          stats = json.loads(Path('docs/reports/tag-statistics.json').read_text())
-
-          print(f'## Summary')
-          print(f'')
-          print(f'- **Total TAGs**: {stats[\"total_tags\"]}')
-          print(f'- **By Type**:')
-          print(f'  - SPEC: {stats[\"by_type\"].get(\"SPEC\", 0)}')
-          print(f'  - CODE: {stats[\"by_type\"].get(\"CODE\", 0)}')
-          print(f'  - TEST: {stats[\"by_type\"].get(\"TEST\", 0)}')
-          print(f'  - DOC: {stats[\"by_type\"].get(\"DOC\", 0)}')
-          print(f'')
-          print(f'## Coverage')
-          print(f'')
-          print(f'- **Overall**: {stats[\"coverage\"].get(\"overall_percentage\", 0)}%')
-          print(f'- **SPEC → CODE**: {stats[\"coverage\"].get(\"spec_to_code\", 0)}%')
-          print(f'- **CODE → TEST**: {stats[\"coverage\"].get(\"code_to_test\", 0)}%')
-          print(f'')
-          print(f'## Issues')
-          print(f'')
-          print(f'- **Orphan TAGs**: {stats[\"issues\"].get(\"orphan_count\", 0)}')
-          print(f'- **Incomplete Chains**: {stats[\"issues\"].get(\"incomplete_chains\", 0)}')
-          print(f'')
-          print(f'## Reports')
-          print(f'')
-          print(f'- [TAG Inventory](./docs/reports/tag-inventory.md)')
-          print(f'- [Coverage Matrix](./docs/reports/tag-matrix.md)')
-          print(f'- [Statistics (JSON)](./docs/reports/tag-statistics.json)')
-          " >> report_summary.md
-
-          cat report_summary.md
-
-      - name: Upload reports as artifacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: tag-reports-${{ github.sha }}
-          path: docs/reports/
-          retention-days: 90
-
-      - name: Post summary to GitHub Actions UI
-        run: |
-          echo "## 📊 TAG Report Generation Complete" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-
-          python -c "
-          import json
-          from pathlib import Path
-
-          stats = json.loads(Path('docs/reports/tag-statistics.json').read_text())
-
-          print(f'### Summary')
-          print(f'')
-          print(f'| Metric | Value |')
-          print(f'|--------|-------|')
-          print(f'| Total TAGs | {stats[\"total_tags\"]} |')
-          print(f'| SPEC | {stats[\"by_type\"].get(\"SPEC\", 0)} |')
-          print(f'| CODE | {stats[\"by_type\"].get(\"CODE\", 0)} |')
-          print(f'| TEST | {stats[\"by_type\"].get(\"TEST\", 0)} |')
-          print(f'| DOC | {stats[\"by_type\"].get(\"DOC\", 0)} |')
-          print(f'| Overall Coverage | {stats[\"coverage\"].get(\"overall_percentage\", 0)}% |')
-          print(f'| Orphan TAGs | {stats[\"issues\"].get(\"orphan_count\", 0)} |')
-          print(f'| Incomplete Chains | {stats[\"issues\"].get(\"incomplete_chains\", 0)} |')
-          print(f'')
-          print(f'### Generated Files')
-          print(f'')
-          print(f'- ✅ tag-inventory.md')
-          print(f'- ✅ tag-matrix.md')
-          print(f'- ✅ tag-statistics.json')
-          " >> $GITHUB_STEP_SUMMARY
-
-      - name: Fail workflow if issues detected (optional)
-        if: always()
-        run: |
-          python -c "
-          import json
-          from pathlib import Path
-          import sys
-
-          stats = json.loads(Path('docs/reports/tag-statistics.json').read_text())
-
-          orphan_count = stats['issues'].get('orphan_count', 0)
-          incomplete_count = stats['issues'].get('incomplete_chains', 0)
-
-          # Optional: Fail workflow if too many issues
-          # Uncomment to enable strict validation
-          # if orphan_count > 10 or incomplete_count > 10:
-          #     print(f'❌ Too many TAG issues detected!')
-          #     print(f'   Orphans: {orphan_count}')
-          #     print(f'   Incomplete: {incomplete_count}')
-          #     sys.exit(1)
-
-          print(f'✅ TAG system health check passed')
-          print(f'   Orphans: {orphan_count}')
-          print(f'   Incomplete: {incomplete_count}')
-          "

moai_adk/templates/.moai/docs/quick-issue-creation-guide.md

@@ -1,219 +0,0 @@
-# 🎯 Quick Issue Creation Guide
-
-> **MoAI-ADK v0.7.0+** - Create GitHub Issues instantly with `/alfred:9-feedback` interactive dialog
-
-## Overview
-
-The Quick Issue Creation system allows developers to report bugs, request features, suggest improvements, and ask questions directly to GitHub Issues without leaving their development context.
-
-**Key Benefit**: Convert problems into tracked GitHub Issues in seconds, maintaining development flow.
-
----
-
-## 🚀 Quick Start
-
-### Basic Usage
-
-```bash
-# Report a bug
-/alfred:9-help --bug 'Login button not responding on homepage'
-
-# Request a feature
-/alfred:9-help --feature 'Add dark mode theme support'
-
-# Suggest an improvement
-/alfred:9-help --improvement 'Optimize database query in UserService'
-
-# Ask a question
-/alfred:9-help --question 'What is the recommended approach for API versioning?'
-```
-
-### What Happens Next
-
-1. **Parsing**: Alfred extracts issue type and content
-2. **Priority Selection**: You select issue priority (critical/high/medium/low)
-3. **Issue Creation**: GitHub Issue is created with:
-   - Formatted title (with emoji and type indicator)
-   - Your description
-   - Automatic labels based on type and priority
-   - Metadata footer
-4. **Confirmation**: You receive the issue URL for immediate sharing
-
-**Example Output**:
-```
-✅ GitHub Issue #456 created successfully
-📋 Title: 🐛 [BUG] Login button not responding on homepage
-🔴 Priority: High
-🏷️  Labels: bug, reported, priority-high
-🔗 URL: https://github.com/owner/repo/issues/456
-```
-
----
-
-## 📋 Issue Types & Labels
-
-### 🐛 Bug Reports (`--bug`)
-
-Use this when you discover a problem or unexpected behavior.
-
-**Automatic Labels**: `bug`, `reported`
-
-**Example**:
-```bash
-/alfred:9-help --bug 'Payment form crashes when credit card has < 4 digits'
-```
-
----
-
-### ✨ Feature Requests (`--feature`)
-
-Use this to propose new functionality.
-
-**Automatic Labels**: `feature-request`, `enhancement`
-
-**Example**:
-```bash
-/alfred:9-help --feature 'Add webhook support for payment notifications'
-```
-
----
-
-### ⚡ Improvement Suggestions (`--improvement`)
-
-Use this to suggest enhancements to existing features.
-
-**Automatic Labels**: `improvement`, `enhancement`
-
-**Example**:
-```bash
-/alfred:9-help --improvement 'Reduce database queries in checkout process by 50%'
-```
-
----
-
-### ❓ Questions & Discussions (`--question`)
-
-Use this to ask questions or start discussions.
-
-**Automatic Labels**: `question`, `help-wanted`
-
-**Example**:
-```bash
-/alfred:9-help --question 'Should we migrate from Sequelize to Prisma ORM?'
-```
-
----
-
-## 🎯 Priority Levels
-
-When you create an issue, you'll be prompted to select a priority:
-
-| Level | Emoji | Label | When to Use |
-|-------|-------|-------|------------|
-| 🔴 Critical | 🔴 | `priority-critical` | System down, data loss risk, security breach |
-| 🟠 High | 🟠 | `priority-high` | Major feature broken, significant impact |
-| 🟡 Medium | 🟡 | `priority-medium` | Normal bugs, typical features, default |
-| 🟢 Low | 🟢 | `priority-low` | Minor issues, nice-to-have features |
-
----
-
-## 💡 Real-World Examples
-
-### Example 1: Emergency Bug Report
-
-**Scenario**: During production support, you find that users cannot reset their passwords.
-
-```bash
-/alfred:9-help --bug 'Password reset email not being sent after clicking "Forgot Password"'
-```
-
-**Result**: Issue #234 created and visible to team immediately with critical priority.
-
-### Example 2: Feature Request from Code Review
-
-**Scenario**: During code review, you think of a feature that would improve the codebase.
-
-```bash
-/alfred:9-help --feature 'Add request rate limiting middleware to prevent abuse'
-```
-
-**Result**: Issue #235 created for backlog planning.
-
-### Example 3: Performance Improvement Suggestion
-
-**Scenario**: You notice slow database queries in the user service.
-
-```bash
-/alfred:9-help --improvement 'Add database index on users.email for faster lookups'
-```
-
-**Result**: Issue #236 created for technical debt backlog.
-
-### Example 4: Architecture Question
-
-**Scenario**: You're uncertain about the best approach for API design.
-
-```bash
-/alfred:9-help --question 'Should we use REST or GraphQL for the new mobile API?'
-```
-
-**Result**: Issue #237 created for team discussion.
-
----
-
-## 🔧 Prerequisites
-
-### Required
-
-1. **GitHub CLI installed**
-   ```bash
-   # macOS
-   brew install gh
-
-   # Ubuntu/Debian
-   sudo apt install gh
-
-   # Or visit: https://cli.github.com
-   ```
-
-2. **Authenticated with GitHub**
-   ```bash
-   gh auth login
-   ```
-
-3. **Git repository initialized**
-   ```bash
-   git init
-   git remote add origin https://github.com/owner/repo.git
-   ```
-
----
-
-## 🔄 Related Commands
-
-| Command | Purpose |
-|---------|---------|
-| `/alfred:0-project` | Initialize project |
-| `/alfred:1-plan` | Create SPEC documents |
-| `/alfred:2-run` | Implement features |
-| `/alfred:3-sync` | Sync documentation |
-| `/alfred:9-help` | **Create issues (this command)** |
-
----
-
-## ✨ Summary
-
-The `/alfred:9-help` command enables:
-
-- ✅ **Fast issue creation** - Seconds, not minutes
-- ✅ **Standardized format** - Consistent labels and metadata
-- ✅ **Priority management** - Clear issue prioritization
-- ✅ **Team visibility** - Issues immediately visible and discussable
-- ✅ **Workflow integration** - Works with MoAI-ADK specs and planning
-
-**Start using it now**:
-```bash
-/alfred:9-help --bug 'Describe the issue you just found'
-```
-
-Happy issue reporting! 🎉

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

@@ -1,79 +0,0 @@
-#!/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

@@ -1,66 +0,0 @@
-#!/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