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

moai_adk/templates/.claude/commands/alfred/9-feedback.md

@@ -0,0 +1,149 @@
+---
+name: alfred:9-feedback
+description: "Interactive GitHub Issue creation - Step-by-step dialog to create issues without command arguments"
+allowed-tools:
+- Bash(gh:*)
+- Task
+- AskUserQuestion
+---
+
+# 🎯 MoAI-ADK Alfred 9-Feedback: Interactive GitHub Issue Creation
+
+> **Purpose**: Create GitHub Issues through an interactive multi-step dialog. Simple command → guided questions → automatic issue creation.
+
+## 📋 Command Purpose
+
+Enable developers to instantly report bugs, request features, suggest improvements, and ask questions through conversational dialogs. No command arguments needed—just run `/alfred:9-feedback` and answer questions.
+
+**Command Format**:
+```bash
+/alfred:9-feedback
+```
+
+That's it! Alfred guides you through the rest.
+
+---
+
+## 🚀 Interactive Execution Flow
+
+### Step 1: Start Command
+```bash
+/alfred:9-feedback
+```
+
+Alfred responds and proceeds to Step 2.
+
+---
+
+### Step 2: Select Issue Type (AskUserQuestion)
+
+**Question**: "What type of issue do you want to create?"
+
+**Options**:
+```
+[ ] 🐛 Bug Report - Something isn't working
+[ ] ✨ Feature Request - Suggest new functionality
+[ ] ⚡ Improvement - Enhance existing features
+[ ] ❓ Question/Discussion - Ask the team
+```
+
+**User Selection**: Selects one (e.g., 🐛 Bug Report)
+
+---
+
+### Step 3: Enter Issue Title (AskUserQuestion)
+
+**Question**: "What is the issue title? (Be concise)"
+
+**Example Input**:
+```
+Login button on homepage not responding to clicks
+```
+
+---
+
+### Step 4: Enter Description (AskUserQuestion)
+
+**Question**: "Provide a detailed description (optional—press Enter to skip)"
+
+**Example Input**:
+```
+When I click the login button on the homepage, nothing happens.
+Tested on Chrome 120.0 on macOS 14.2.
+Expected: Login modal should appear
+Actual: No response
+```
+
+Or just press Enter to skip.
+
+---
+
+### Step 5: Select Priority (AskUserQuestion)
+
+**Question**: "What's the priority level?"
+
+**Options**:
+```
+[ ] 🔴 Critical - System down, data loss, security breach
+[ ] 🟠 High - Major feature broken, significant impact
+[✓] 🟡 Medium - Normal priority (default)
+[ ] 🟢 Low - Minor issues, nice-to-have
+```
+
+**User Selection**: Selects priority (e.g., 🟠 High)
+
+---
+
+### Step 6: Create Issue (Automatic)
+
+Alfred automatically:
+1. Formats title with emoji: "🐛 [BUG] Login button not responding..."
+2. Prepares body with user description + metadata
+3. Assigns labels: bug, reported, priority-high
+4. Executes: `gh issue create --title ... --body ... --label ...`
+5. Parses issue number from response
+
+**Success Output**:
+```
+✅ GitHub Issue #234 created successfully!
+
+📋 Title: 🐛 [BUG] Login button not responding to clicks
+🔴 Priority: High
+🏷️  Labels: bug, reported, priority-high
+🔗 URL: https://github.com/owner/repo/issues/234
+
+💡 Next: Reference this issue in your commits or link to a SPEC document
+```
+
+---
+
+## ⚠️ Important Rules
+
+### ✅ What to Do
+
+- ✅ Ask all 4 questions in sequence (type → title → description → priority)
+- ✅ Preserve exact user wording in title and description
+- ✅ Use AskUserQuestion for all user inputs
+- ✅ Allow skipping description (optional field)
+- ✅ Show issue URL after creation
+
+### ❌ What NOT to Do
+
+- ❌ Accept command arguments (`/alfred:9-feedback --bug` is wrong—just use `/alfred:9-feedback`)
+- ❌ Skip questions or change order
+- ❌ Rephrase user's input
+- ❌ Create issues without labels
+
+---
+
+## 💡 Key Benefits
+
+1. **🚀 No Arguments Needed**: Just `/alfred:9-feedback`
+2. **💬 Conversational**: Intuitive step-by-step dialog
+3. **🏷️ Auto-labeled**: Labels applied automatically
+4. **🔗 Team Visible**: Issues immediately visible
+5. **⏱️ Fast**: Create issues in 30 seconds
+
+---
+
+**Supported since**: MoAI-ADK v0.7.0+

moai_adk/templates/.claude/hooks/alfred/core/project.py

@@ -354,9 +354,9 @@ def get_package_version_info() -> dict[str, Any]:
         - Returns graceful fallback if PyPI check fails
         - Handles version parsing gracefully
     """
-    from importlib.metadata import version, PackageNotFoundError
-    import urllib.request
     import urllib.error
+    import urllib.request
+    from importlib.metadata import PackageNotFoundError, version
 
     result = {
         "current": "unknown",

moai_adk/templates/.github/ISSUE_TEMPLATE/spec.yml

@@ -170,7 +170,9 @@ body:
       value: |
         ## 📚 Reference
 
-        - **SPEC Metadata Guide**: See `.moai/memory/spec-metadata.md`
-        - **EARS Syntax Guide**: See `.moai/memory/development-guide.md`
+        - **SPEC Metadata Guide**: See `{{DOCS_DIR}}/spec-metadata.md`
+        - **EARS Syntax Guide**: See `{{DOCS_DIR}}/development-guide.md`
         - **Acceptance Criteria**: Use Given-When-Then (Gherkin) format
-        - **@TAG System**: @SPEC, @TEST, @CODE, @DOC traceability
+        {% if ENABLE_TAG_SYSTEM -%}
+        - **Traceability System**: @SPEC, @TEST, @CODE, @DOC traceability
+        {% endif -%}

moai_adk/templates/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,20 +1,25 @@
-# MoAI-ADK GitFlow PR
+# {{PROJECT_NAME}} GitFlow PR
 
-> 🗿 Full GitFlow Transparency — the agent auto-fills information
+> Full GitFlow Transparency — the agent auto-fills information
 
 ## 📝 SPEC Info
 
 - Related SPEC: `SPEC-AUTH-001` (e.g., JWT authentication system)
-- Directory: `.moai/specs/SPEC-AUTH-001/`
+- Directory: `{{SPEC_DIR}}/SPEC-AUTH-001/`
+{% if ENABLE_TAG_SYSTEM -%}
 - @TAG Links: @SPEC:AUTH-001 @CODE:AUTH-001 (auto-tagging)
+{% endif -%}
 
 ## ✅ SPEC Quality Checks
 
 - [ ] YAML Front Matter: 7 required fields (id, version, status, created, updated, author, priority)
 - [ ] HISTORY Section: Record versioned change log (include v0.0.1 INITIAL)
 - [ ] EARS Requirements: Ubiquitous, Event-driven, State-driven, Optional, Constraints
+{% if ENABLE_TAG_SYSTEM -%}
 - [ ] @SPEC:ID TAG: Include TAG in doc and check duplicates (`rg "@SPEC:<ID>" -n`)
+{% endif -%}
 
+{% if ENABLE_ALFRED_COMMANDS -%}
 ## 🤖 Automated Validation Status
 
 <!-- The checklist below is auto-updated by the agent -->
@@ -25,24 +30,29 @@
 - [ ] spec-builder: Complete EARS spec and create feature branch
 - [ ] code-builder: Finish TDD RED-GREEN-REFACTOR
 - [ ] doc-syncer: Sync Living Documents and mark PR Ready
+{% endif -%}
 
+{% if ENABLE_TRUST_5 -%}
 ## 📊 Quality Metrics (auto-calculated)
 
 - TRUST 5 Principles: ✅ Compliant
 - Test Coverage: XX% (target ≥ 85%)
+{% if ENABLE_TAG_SYSTEM -%}
 - @TAG Traceability: 100%
+{% endif -%}
+{% endif -%}
 
 ## 🌍 Locale Settings
 
-- Project Language: <!-- ko/en/ja/zh -->
+- Project Language: {{CONVERSATION_LANGUAGE}}
 - Commit Messages: <!-- generated automatically according to locale -->
 
 ## 🎯 Changes
 
-<!-- code-builder auto-fills TDD results -->
+<!-- auto-fills TDD results -->
 
 ### 🔴 RED (Test Authoring)
-- Test File: `tests/auth/service.test.ts`
+- Test File: `{{TEST_DIR}}/auth/service.test.ts`
 - Test Description: [describe the failing test]
 
 ### 🟢 GREEN (Implementation)
@@ -58,12 +68,14 @@
 
 - [ ] Update README
 - [ ] Sync API docs
+{% if ENABLE_TAG_SYSTEM -%}
 - [ ] Update TAG index
+{% endif -%}
 - [ ] Update HISTORY section (SPEC docs)
 
 ---
 
-🚀 MoAI-ADK: Professional development without Git commands via a 3-stage pipeline!
+🚀 {{PROJECT_NAME}}: Professional development via a 3-stage pipeline!
 
-Reviewers: Check TRUST 5 compliance and SPEC metadata completeness only.
+Reviewers: Check quality compliance and SPEC metadata completeness only.
 

moai_adk/templates/.github/workflows/moai-gitflow.yml

@@ -1,6 +1,6 @@
-name: MoAI-ADK GitFlow Automation
+name: "{{PROJECT_NAME}} GitFlow Automation"
 
-# MoAI-ADK 3-stage pipeline: spec → build → sync
+# {{PROJECT_NAME}} 3-stage pipeline: spec → build → sync
 # Full GitFlow transparency — no Git expertise needed
 
 on:
@@ -11,7 +11,7 @@ on:
 
 jobs:
   moai-pipeline:
-    name: 🗿 MoAI-ADK Pipeline
+    name: "{{PROJECT_NAME}} Pipeline"
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -86,13 +86,13 @@ jobs:
           distribution: "temurin"
           java-version: "21"
 
-      # TRUST 5 Principles — automated validation
-      # Note: Validation is handled by TypeScript-based tools
-      - name: 🧭 TRUST 5 Principles Check
+      # TRUST 5 Principles — automated validation (if enabled)
+      {% if ENABLE_TRUST_5 -%}
+      - name: 🧭 Quality Principles Check
         run: |
-          echo "✅ TRUST validation is performed by TypeScript-based tools"
-          echo "   - Uses @agent-trust-checker"
-          echo "   - Leverages TypeScript hook system"
+          echo "✅ Quality validation is performed"
+          echo "   - Automated quality checks enabled"
+      {% endif -%}
 
       # Ignore test failures on Draft PRs; fail CI on Ready PRs
       - name: Run language-aware tests
@@ -221,11 +221,14 @@ jobs:
             fi
           fi
 
-      # TAG system validation (code files only)
-      - name: 🏷️ TAG System Validation
+      # TAG system validation (if enabled)
+      {% if ENABLE_TAG_SYSTEM -%}
+      - name: 🏷️ Traceability Validation
         run: |
-          echo "✅ TAG validation is handled automatically in the tag_validator.py hook"
+          echo "✅ Traceability validation is handled automatically"
+      {% endif -%}
 
+      {% if ENABLE_ALFRED_COMMANDS -%}
       # Run per-branch stages
       - name: 📝 SPEC Stage (feature branch)
         if: startsWith(github.ref, 'refs/heads/feature/')
@@ -239,7 +242,9 @@ jobs:
         run: |
           echo "📝 Draft PR: TDD implementation stage"
           echo "- code-builder agent runs RED-GREEN-REFACTOR"
-          echo "- Validate TRUST 5 Principles compliance"
+          {% if ENABLE_TRUST_5 -%}
+          echo "- Validate Quality Principles compliance"
+          {% endif -%}
 
       - name: 📚 SYNC Stage (Ready PR)
         if: github.event.pull_request.draft == false && github.event.action == 'ready_for_review'
@@ -247,10 +252,11 @@ jobs:
           echo "✅ Ready PR: documentation sync stage"
           echo "- doc-syncer agent synchronizes Living Documents"
           echo "- PR is ready for review"
+      {% endif -%}
 
       # Final result report
-      - name: 📊 MoAI Pipeline Complete
+      - name: "🎯 {{PROJECT_NAME}} Pipeline Complete"
         run: |
-          echo "🗿 MoAI-ADK GitFlow automation complete"
-          echo "✨ Professional workflow without needing to know Git"
+          echo "{{PROJECT_NAME}} GitFlow automation complete"
+          echo "✨ Professional workflow enabled"
 

moai_adk/templates/.github/workflows/spec-issue-sync.yml

@@ -3,7 +3,7 @@ name: 📋 SPEC Issue Sync
 on:
   pull_request:
     paths:
-      - '.moai/specs/SPEC-*/spec.md'
+      - '{{SPEC_DIR}}/SPEC-*/spec.md'
     types: [opened, synchronize]
 
 permissions:
@@ -33,18 +33,18 @@ jobs:
           pwd
           ls -la
 
-          echo "=== Debug: Looking for .moai/specs ==="
-          ls -la .moai/ 2>&1 || echo ".moai/ directory not found"
+          echo "=== Debug: Looking for {{SPEC_DIR}} ==="
+          ls -la {{SPEC_DIR}}/ 2>&1 || echo "{{SPEC_DIR}}/ directory not found"
 
           # Find SPEC files in the PR
           echo "=== Debug: Searching for SPEC files ==="
           find . -name "spec.md" -type f 2>&1 || echo "find command failed"
 
-          spec_file=$(find .moai/specs -name "spec.md" -type f 2>&1 | head -1)
+          spec_file=$(find {{SPEC_DIR}} -name "spec.md" -type f 2>&1 | head -1)
           echo "Found spec_file: [$spec_file]"
 
           if [ -z "$spec_file" ]; then
-            echo "⚠️  No SPEC file found in .moai/specs"
+            echo "⚠️  No SPEC file found in {{SPEC_DIR}}"
             echo "Exiting gracefully (this is expected if no SPEC files changed)"
             exit 0
           fi
@@ -59,7 +59,11 @@ jobs:
           spec_priority=$(grep "^priority:" "$spec_file" | sed 's/^priority: *//' | tr -d ' "')
 
           # Extract title from H1 heading
+          {% if ENABLE_TAG_SYSTEM -%}
           spec_title=$(grep "^# @SPEC:" "$spec_file" | sed 's/^# @SPEC:[^:]*: //')
+          {% else -%}
+          spec_title=$(grep "^# " "$spec_file" | head -1 | sed 's/^# //')
+          {% endif -%}
 
           echo "✅ Extracted SPEC metadata:"
           echo "  ID: $spec_id"
@@ -158,7 +162,7 @@ jobs:
             echo "This SPEC has been synchronized to GitHub Issue."
             echo ""
             echo "📋 **Issue**: [#$issue_num - SPEC-$spec_id: $spec_title](../issues/$issue_num)"
-            echo "🔗 **SPEC File**: \`.moai/specs/SPEC-$spec_id/spec.md\`"
+            echo "🔗 **SPEC File**: \`{{SPEC_DIR}}/SPEC-$spec_id/spec.md\`"
             echo ""
             echo "The issue will be automatically updated as you modify the SPEC document."
           } > /tmp/pr_comment.txt

moai_adk/templates/.moai/config.json

@@ -92,5 +92,17 @@
       "scan_command": "rg '@TAG' -n",
       "philosophy": "The source of truth for TAGs lives in the code itself"
     }
+  },
+  "github": {
+    "@CODE:GITHUB-CONFIG-001": "@DOC:GITHUB-TEMPLATES-001",
+    "templates": {
+      "enable_trust_5": true,
+      "enable_tag_system": true,
+      "enable_alfred_commands": true,
+      "spec_directory": ".moai/specs",
+      "docs_directory": ".moai/docs",
+      "test_directory": "tests",
+      "notes": "Configure GitHub templates for project customization. When enable_* flags are false, corresponding MoAI-specific sections are omitted from templates."
+    }
   }
 }

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

@@ -0,0 +1,219 @@
+# 🎯 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! 🎉