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

moai_adk/templates/.moai/config/questions/tab4-quality.yaml

@@ -0,0 +1,170 @@
+# Tab 4: Quality Principles & Reports
+# Priority: OPTIONAL
+# Questions: 7
+
+metadata:
+  id: tab_4_quality_reports
+  label: "Tab 4: Quality Principles & Reports"
+  description: "Configure TRUST 5, test coverage, max projects, report generation"
+  priority: OPTIONAL
+  order: 4
+  setting_count: 7
+
+target_sections:
+  - sections/quality.yaml
+
+batches:
+  # Batch 4.1: Constitution Settings
+  - batch_id: "4.1"
+    label: "Constitution Settings"
+    conditional: false
+    questions:
+      - id: enforce_tdd
+        question: "Enforce TDD (Test-Driven Development)?"
+        header: "Enforce TDD"
+        field: "constitution.enforce_tdd"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Enabled"
+            description: "Require tests before implementation (recommended)"
+            value: true
+          - label: "Disabled"
+            description: "Allow implementation without tests"
+            value: false
+        target:
+          file: "sections/quality.yaml"
+          path: "constitution.enforce_tdd"
+
+      - id: test_coverage_target
+        question: "Test coverage target percentage?"
+        header: "Coverage"
+        field: "constitution.test_coverage_target"
+        type: number_input
+        multi_select: false
+        required: true
+        options:
+          - label: "85%"
+            description: "Standard coverage (recommended)"
+            value: 85
+          - label: "90%"
+            description: "High quality coverage"
+            value: 90
+          - label: "Other"
+            description: "Enter custom percentage (0-100)"
+            value: "{{prompt_user}}"
+        target:
+          file: "sections/quality.yaml"
+          path: "constitution.test_coverage_target"
+
+      - id: max_projects
+        question: "Maximum concurrent projects?"
+        header: "Max Projects"
+        field: "constitution.principles.simplicity.max_projects"
+        type: number_input
+        multi_select: false
+        required: true
+        options:
+          - label: "5 projects"
+            description: "Default recommendation"
+            value: 5
+          - label: "10 projects"
+            description: "For larger teams"
+            value: 10
+          - label: "Other"
+            description: "Enter custom number"
+            value: "{{prompt_user}}"
+        target:
+          file: "sections/quality.yaml"
+          path: "constitution.principles.simplicity.max_projects"
+
+  # Batch 4.2: Report Generation Policy
+  - batch_id: "4.2"
+    label: "Report Generation Policy"
+    conditional: false
+    questions:
+      - id: report_enabled
+        question: "Enable report generation?"
+        header: "Reports"
+        field: "report_generation.enabled"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Enabled"
+            description: "Generate reports (recommended)"
+            value: true
+          - label: "Disabled"
+            description: "No report generation"
+            value: false
+        target:
+          file: "sections/quality.yaml"
+          path: "report_generation.enabled"
+
+      - id: report_auto_create
+        question: "Auto-create full reports?"
+        header: "Auto Create"
+        field: "report_generation.auto_create"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Enabled"
+            description: "Automatically generate full reports"
+            value: true
+          - label: "Disabled"
+            description: "Generate minimal reports (recommended, saves tokens)"
+            value: false
+        target:
+          file: "sections/quality.yaml"
+          path: "report_generation.auto_create"
+
+      - id: report_warn_user
+        question: "Warn user before report creation?"
+        header: "Warn User"
+        field: "report_generation.warn_user"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Enabled"
+            description: "Ask user before generating reports (recommended)"
+            value: true
+          - label: "Disabled"
+            description: "Generate reports without asking"
+            value: false
+        target:
+          file: "sections/quality.yaml"
+          path: "report_generation.warn_user"
+
+      - id: report_user_choice
+        question: "Default user choice for reports?"
+        header: "Default"
+        field: "report_generation.user_choice"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Minimal"
+            description: "Generate minimal reports (recommended)"
+            value: "Minimal"
+          - label: "Full"
+            description: "Generate full reports"
+            value: "Full"
+          - label: "None"
+            description: "Skip report generation"
+            value: "None"
+        target:
+          file: "sections/quality.yaml"
+          path: "report_generation.user_choice"
+
+validation:
+  checkpoint: "after_tab_4"
+  rules:
+    - name: "validate_coverage_range"
+      description: "Coverage target must be 0-100"
+      field: "constitution.test_coverage_target"
+      validation: "range"
+      min: 0
+      max: 100

moai_adk/templates/.moai/config/questions/tab5-system.yaml

@@ -0,0 +1,87 @@
+# Tab 5: System Settings
+# Priority: OPTIONAL
+# Questions: 3 (GitHub Automation moved to Tab 3)
+
+metadata:
+  id: tab_5_system
+  label: "Tab 5: System Settings"
+  description: "Configure MoAI system settings (version check, cache)"
+  priority: OPTIONAL
+  order: 5
+  setting_count: 3
+
+target_sections:
+  - sections/system.yaml
+
+batches:
+  # Batch 5.1: MoAI System Settings
+  - batch_id: "5.1"
+    label: "MoAI System Settings"
+    conditional: false
+    questions:
+      - id: update_check_frequency
+        question: "MoAI version check frequency?"
+        header: "Update Check"
+        field: "moai.update_check_frequency"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Daily"
+            description: "Check for updates daily (recommended)"
+            value: "daily"
+          - label: "Weekly"
+            description: "Check for updates weekly"
+            value: "weekly"
+          - label: "Never"
+            description: "Disable update checks"
+            value: "never"
+        target:
+          file: "sections/system.yaml"
+          path: "moai.update_check_frequency"
+
+      - id: version_check_enabled
+        question: "Enable version checking?"
+        header: "Version Check"
+        field: "moai.version_check.enabled"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Enabled"
+            description: "Enable version checking (recommended)"
+            value: true
+          - label: "Disabled"
+            description: "Disable version checking"
+            value: false
+        target:
+          file: "sections/system.yaml"
+          path: "moai.version_check.enabled"
+
+      - id: cache_ttl_hours
+        question: "Version check cache TTL hours?"
+        header: "Cache TTL"
+        field: "moai.version_check.cache_ttl_hours"
+        type: number_input
+        multi_select: false
+        required: true
+        options:
+          - label: "24 hours"
+            description: "Cache version info for 24 hours (recommended)"
+            value: 24
+          - label: "Other"
+            description: "Enter custom hours"
+            value: "{{prompt_user}}"
+        target:
+          file: "sections/system.yaml"
+          path: "moai.version_check.cache_ttl_hours"
+
+validation:
+  checkpoint: "after_tab_5"
+  rules:
+    - name: "validate_cache_ttl"
+      description: "Cache TTL must be positive"
+      field: "moai.version_check.cache_ttl_hours"
+      validation: "range"
+      min: 1
+      max: 168

moai_adk/templates/.moai/config/sections/git-strategy.yaml

@@ -0,0 +1,116 @@
+# Git Strategy Settings
+# Workflow configuration for Manual/Personal/Team modes
+# Complete field coverage for all Git workflow modes
+
+git_strategy:
+  mode: manual                # manual, personal, team
+
+  # Manual Mode Settings (Local Git)
+  manual:
+    workflow: github-flow
+    environment: local
+    github_integration: false
+    auto_checkpoint: disabled
+    push_to_remote: false
+
+    # Branch creation policy
+    branch_creation:
+      prompt_always: true       # Always ask before creating branch
+      auto_enabled: false       # Do not auto-create branches
+
+    # Automation settings
+    automation:
+      auto_branch: false
+      auto_commit: true
+      auto_pr: false
+      auto_push: false
+
+    # Git hooks policy
+    hooks:
+      pre_commit: enforce       # enforce, warn, skip
+      pre_push: warn
+      commit_msg: warn
+
+    # Commit message style
+    commit_style:
+      format: conventional      # conventional, simple
+      scope_required: false
+
+  # Personal Mode Settings (GitHub Individual)
+  personal:
+    workflow: github-flow
+    environment: github
+    github_integration: true
+    push_to_remote: true
+    branch_prefix: "feature/SPEC-"
+    main_branch: main
+
+    # Branch creation policy
+    branch_creation:
+      prompt_always: false
+      auto_enabled: true
+
+    # Automation settings (duplicated for clarity, matches top-level auto_*)
+    automation:
+      auto_branch: true
+      auto_commit: true
+      auto_pr: false            # Manual PR for review
+      auto_push: true
+
+    # Convenience aliases (backward compatibility)
+    auto_branch: true
+    auto_commit: true
+    auto_pr: false
+    auto_push: true
+
+    # Git hooks policy
+    hooks:
+      pre_commit: enforce
+      pre_push: warn
+      commit_msg: warn
+
+    # Commit message style
+    commit_style:
+      format: conventional
+      scope_required: false
+
+  # Team Mode Settings (GitHub Team)
+  team:
+    workflow: github-flow
+    environment: github
+    github_integration: true
+    push_to_remote: true
+    branch_prefix: "feature/SPEC-"  # Unified field name (was: feature_prefix)
+    main_branch: main
+    draft_pr: true
+    required_reviews: 1
+    branch_protection: true
+
+    # Branch creation policy
+    branch_creation:
+      prompt_always: false
+      auto_enabled: true
+
+    # Automation settings
+    automation:
+      auto_branch: true
+      auto_commit: true
+      auto_pr: true
+      auto_push: true
+
+    # Convenience aliases (backward compatibility)
+    auto_branch: true
+    auto_commit: true
+    auto_pr: true
+    auto_push: true
+
+    # Git hooks policy
+    hooks:
+      pre_commit: enforce
+      pre_push: warn
+      commit_msg: warn
+
+    # Commit message style
+    commit_style:
+      format: conventional
+      scope_required: true      # Required for team projects

moai_adk/templates/.moai/config/sections/language.yaml

@@ -0,0 +1,11 @@
+# Language Settings (CLAUDE.md Reference)
+# This file is auto-loaded by CLAUDE.md for language configuration
+
+language:
+  conversation_language: en            # User-facing responses (ko, en, ja, es, zh, fr, de)
+  conversation_language_name: English  # Display name (auto-updated)
+  agent_prompt_language: en            # Internal agent instructions
+  git_commit_messages: en              # Git commit message language
+  code_comments: en                    # Source code comment language
+  documentation: en                    # Documentation files language (standardized as single source)
+  error_messages: en                   # Error message language

moai_adk/templates/.moai/config/sections/project.yaml

@@ -0,0 +1,13 @@
+# Project Settings
+# Basic project metadata
+
+project:
+  name: ""                    # Project name
+  description: ""             # Project description
+  type: ""                    # Project type: web_browser_app, mobile_app, cli_tool, backend_api
+  locale: en_US               # Auto-derived from conversation_language
+  created_at: ""              # Auto-set during init
+  initialized: false          # Auto-set during init
+
+github:
+  profile_name: ""            # GitHub username (e.g., @GoosLab)

moai_adk/templates/.moai/config/sections/quality.yaml

@@ -0,0 +1,17 @@
+# Quality & Constitution Settings
+# TDD enforcement and report generation
+
+constitution:
+  enforce_tdd: true           # Require tests before implementation
+  test_coverage_target: 85    # Minimum test coverage percentage (recommended: 85%)
+
+  # Quality principles (TRUST 5 framework)
+  principles:
+    simplicity:
+      max_projects: 5         # Maximum concurrent projects
+
+report_generation:
+  enabled: true               # Enable report generation
+  auto_create: false          # Auto-create full reports (false = minimal)
+  warn_user: true             # Ask before generating reports
+  user_choice: Minimal        # Default: Minimal, Full, None

moai_adk/templates/.moai/config/sections/system.yaml

@@ -0,0 +1,14 @@
+# System & GitHub Integration Settings
+# MoAI system configuration and GitHub automation
+
+moai:
+  version: "{{MOAI_VERSION}}"
+  update_check_frequency: daily
+  version_check:
+    enabled: true
+    cache_ttl_hours: 24
+
+github:
+  enable_trust_5: true        # Include TRUST 5 in PR templates
+  auto_delete_branches: true  # Delete branches after merge
+  spec_git_workflow: develop_direct  # develop_direct, feature_branch, per_spec

moai_adk/templates/.moai/config/sections/user.yaml

@@ -0,0 +1,5 @@
+# User Settings (CLAUDE.md Reference)
+# This file is auto-loaded by CLAUDE.md for personalization
+
+user:
+  name: ""                    # User name for greetings (empty = default greeting)

moai_adk/templates/.moai/config/statusline-config.yaml

@@ -0,0 +1,92 @@
+# MoAI-ADK Statusline Configuration for Claude Code
+# Optimized for Windows, macOS, and Linux environments
+# Updated: 2025-11-16 (Performance optimization for Issue #229)
+
+statusline:
+  enabled: true
+
+  # Display mode: compact (80 chars) | extended (120 chars) | minimal (40 chars)
+  mode: "extended"
+
+  # Refresh interval in milliseconds (Claude Code API limitation: 300ms)
+  refresh_interval_ms: 300
+
+  # Color configuration
+  colors:
+    enabled: true
+    theme: "auto"  # auto | light | dark | high-contrast
+    palette:
+      model: "38;5;33"        # Blue
+      output_style: "38;5;219"   # Pink/Magenta
+      feature_branch: "38;5;226"   # Yellow
+      develop_branch: "38;5;51"    # Cyan
+      main_branch: "38;5;46"       # Green
+      staged: "38;5;46"            # Green
+      modified: "38;5;208"         # Orange
+      untracked: "38;5;196"        # Red
+      update_available: "38;5;208" # Orange
+      memory_usage: "38;5;172"     # Brown/Orange
+      duration: "38;5;240"         # Gray
+      todo_count: "38;5;123"       # Purple
+      separator: "38;5;250"        # Light Gray
+
+  # Caching configuration (Windows optimization)
+  # Performance improvements: git 5→10s, alfred 1→5s, update 300→600s
+  cache:
+    git_ttl_seconds: 10          # Git command results (5→10: process creation reduced)
+    metrics_ttl_seconds: 10      # Session metrics (unchanged)
+    alfred_ttl_seconds: 5        # Alfred task state (1→5: file I/O reduced 80%)
+    todo_ttl_seconds: 5          # TODO items count (3→5)
+    memory_ttl_seconds: 10       # Memory usage information (5→10)
+    output_style_ttl_seconds: 120 # Output style configuration (60→120)
+    version_ttl_seconds: 120     # Version information (60→120)
+    update_ttl_seconds: 600      # Update check (300→600: network I/O reduced 83%)
+
+  # Information display settings - Custom ordered status bar
+  # Format: 🤖 Model | 🔅 Version | 💰 Context | 💬 Style | 📊 Changes | 🔀 Branch
+  display:
+    model: true                  # 🤖 Model name (Opus 4.5, Sonnet, etc.)
+    version: false               # 🗿 MoAI-ADK version (disabled - context window replaces it)
+    context_window: true         # 💰 Context window usage (15K/200K)
+    output_style: true           # 💬 Output style (R2-D2, Yoda, etc.)
+    memory_usage: false          # 💾 Session memory usage (disabled)
+    todo_count: false            # 📋 Active TODO items count (disabled)
+    branch: true                 # 🔀 Git branch
+    git_status: true             # 📊 +0 M25 ?3 Git changes status
+    duration: false              # ⏱️ Session elapsed time (disabled)
+    directory: false             # 📁 Project name/directory (disabled)
+    active_task: true            # 🎯 Alfred active task
+    update_indicator: true       # 🔄 Update notification
+
+  # Error handling (Windows: reduced logging I/O)
+  error_handling:
+    graceful_degradation: true   # Return default values on error
+    log_level: "error"           # warning | error (Windows: error for minimal I/O)
+    fallback_text: ""            # Text to display on error (blank recommended)
+
+  # Format configuration
+  format:
+    max_branch_length: 30        # Truncate long branch names
+    truncate_with: "..."         # Truncation indicator
+    separator: " | "             # Section separator
+
+    # Icon configuration for better visual recognition
+    # Format: 🤖 Model | 🔅 Version | 💰 Context | 💬 Style | 📊 Changes | 🔀 Branch
+    icons:
+      git: "🔀"                 # Git branch icon
+      git_status: "📊"          # Git changes status (+0 M25 ?3)
+      staged: "+"               # Staged files count prefix
+      modified: "M"             # Modified files count prefix
+      untracked: "?"            # Untracked files count prefix
+      added: "➕"               # Added files
+      deleted: "➖"             # Deleted files
+      renamed: "🔄"             # Renamed files
+      conflict: "⚠️"           # Conflict files
+      model: "🤖"               # AI model
+      claude_version: "🔅"      # Claude Code version
+      context_window: "💰"      # Context window usage
+      output_style: "💬"        # Output style (R2-D2, etc.)
+      duration: "⏱️"            # Time duration
+      todo: "📋"                # TODO items
+      update: "🔄"              # Update available
+      project: "📁"             # Project directory

moai_adk/templates/.moai/scripts/setup-glm.py

@@ -0,0 +1,136 @@
+#!/usr/bin/env python3
+"""GLM Configuration Setup Script for MoAI-ADK
+
+Configures GLM (OpenAI-compatible API endpoint) for Claude models integration.
+
+Usage:
+    uv run {{PROJECT_DIR}}/.moai/scripts/setup-glm.py <api-token>
+
+Behavior:
+    1. Saves API token to .env.glm (keeps token secure, .gitignore protected)
+    2. Updates .claude/settings.local.json with GLM model environment variables
+    3. Token persists across sessions (no re-entry needed)
+    4. Next Claude Code restart loads configuration automatically
+
+Example:
+    $ /moai:0-project --glm-on abc123xyz...
+    API token saved to ./.env.glm
+    GLM model configuration updated in ./.claude/settings.local.json
+    GLM configuration complete!
+"""
+
+import json
+import sys
+from pathlib import Path
+
+
+def setup_glm(api_token: str, project_root: Path | None = None) -> bool:
+    """Configure GLM integration in the project
+
+    Args:
+        api_token: GLM API authentication token
+        project_root: Project root directory (default: current directory)
+
+    Returns:
+        True if successful, False otherwise
+    """
+    if project_root is None:
+        project_root = Path.cwd()
+    else:
+        project_root = Path(project_root).resolve()
+
+    try:
+        # 1. Create .env.glm with API token
+        env_glm_path = project_root / ".env.glm"
+        env_glm_path.write_text(f"ANTHROPIC_AUTH_TOKEN={api_token}\n")
+
+        # Set secure permissions (user read/write only)
+        env_glm_path.chmod(0o600)
+
+        print(f"✓ API token saved to: {env_glm_path.relative_to(project_root)}")
+
+        # 2. Add .env.glm to .gitignore if needed
+        gitignore_path = project_root / ".gitignore"
+        glm_entry = ".env.glm"
+
+        if gitignore_path.exists():
+            gitignore_content = gitignore_path.read_text()
+            if glm_entry not in gitignore_content:
+                gitignore_path.write_text(gitignore_content.rstrip() + f"\n{glm_entry}\n")
+        else:
+            gitignore_path.write_text(f"{glm_entry}\n")
+
+        # 3. Update .claude/settings.local.json with GLM model configuration
+        settings_path = project_root / ".claude" / "settings.local.json"
+
+        if not settings_path.exists():
+            print(f"❌ Error: {settings_path} not found")
+            print("   Run 'moai-adk init' first to initialize the project")
+            return False
+
+        # Load existing settings
+        with open(settings_path, "r", encoding="utf-8") as f:
+            settings = json.load(f)
+
+        # Add GLM environment variables with authentication token
+        settings["env"] = {
+            "ANTHROPIC_AUTH_TOKEN": api_token,
+            "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
+            "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
+            "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.6",
+            "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.6",
+        }
+
+        # Write back to file
+        with open(settings_path, "w", encoding="utf-8") as f:
+            json.dump(settings, f, indent=2, ensure_ascii=False)
+
+        print(f"✓ GLM model configuration updated in: {settings_path.relative_to(project_root)}")
+        print()
+        print("Configured environment variables:")
+        print(f"   • ANTHROPIC_AUTH_TOKEN: {api_token[:20]}... (loaded from .env.glm)")
+        print("   • ANTHROPIC_BASE_URL: https://api.z.ai/api/anthropic")
+        print("   • ANTHROPIC_DEFAULT_HAIKU_MODEL: glm-4.5-air")
+        print("   • ANTHROPIC_DEFAULT_SONNET_MODEL: glm-4.6")
+        print("   • ANTHROPIC_DEFAULT_OPUS_MODEL: glm-4.6")
+        print()
+        print("✓ GLM configuration complete!")
+        print("Note: Restart Claude Code to load the new configuration automatically.")
+
+        return True
+
+    except json.JSONDecodeError as e:
+        print(f"❌ Error: Invalid JSON in {settings_path}")
+        print(f"   Details: {e}")
+        return False
+
+    except Exception as e:
+        print(f"❌ Error during GLM configuration: {e}")
+        return False
+
+
+def main() -> None:
+    """Main entry point"""
+    if len(sys.argv) < 2:
+        print("Usage: uv run {{PROJECT_DIR}}/.moai/scripts/setup-glm.py <api-token>")
+        print()
+        print("Arguments:")
+        print("  api-token   GLM API authentication token")
+        print()
+        print("Example:")
+        print("  uv run {{PROJECT_DIR}}/.moai/scripts/setup-glm.py abc123xyz...")
+        sys.exit(1)
+
+    api_token = sys.argv[1]
+
+    # Validate token (basic check)
+    if not api_token or len(api_token) < 10:
+        print("❌ Error: API token appears to be invalid (too short)")
+        sys.exit(1)
+
+    success = setup_glm(api_token)
+    sys.exit(0 if success else 1)
+
+
+if __name__ == "__main__":
+    main()