moai-adk 0.15.1__py3-none-any.whl → 0.32.8__py3-none-any.whl

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

@@ -0,0 +1,152 @@
+# Tab 5: System & GitHub Integration
+# Priority: OPTIONAL
+# Questions: 7
+
+metadata:
+  id: tab_5_system_github
+  label: "Tab 5: System & GitHub Integration"
+  description: "Configure MoAI system settings, GitHub automation"
+  priority: OPTIONAL
+  order: 5
+  setting_count: 7
+
+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"
+
+  # Batch 5.2: GitHub Automation Settings
+  - batch_id: "5.2"
+    label: "GitHub Automation Settings"
+    conditional: false
+    questions:
+      - id: enable_trust_5
+        question: "Enable TRUST 5 in GitHub templates?"
+        header: "TRUST 5"
+        field: "github.enable_trust_5"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Enabled"
+            description: "Include TRUST 5 sections in PR templates (recommended)"
+            value: true
+          - label: "Disabled"
+            description: "Omit TRUST 5 sections"
+            value: false
+        target:
+          file: "sections/system.yaml"
+          path: "github.enable_trust_5"
+
+      - id: auto_delete_branches
+        question: "Auto-delete merged branches?"
+        header: "Auto Delete"
+        field: "github.auto_delete_branches"
+        type: select_single
+        multi_select: false
+        required: false
+        options:
+          - label: "Enabled"
+            description: "Delete branches after merge (recommended)"
+            value: true
+          - label: "Disabled"
+            description: "Keep branches after merge"
+            value: false
+          - label: "Not Set"
+            description: "Use GitHub default"
+            value: null
+        target:
+          file: "sections/system.yaml"
+          path: "github.auto_delete_branches"
+
+      - id: spec_git_workflow
+        question: "SPEC Git workflow?"
+        header: "SPEC Workflow"
+        field: "github.spec_git_workflow"
+        type: select_single
+        multi_select: false
+        required: true
+        options:
+          - label: "Develop Direct"
+            description: "Direct commits to develop (recommended for personal)"
+            value: "develop_direct"
+          - label: "Feature Branch"
+            description: "Always create feature branches"
+            value: "feature_branch"
+          - label: "Per SPEC"
+            description: "Ask user for each SPEC"
+            value: "per_spec"
+        target:
+          file: "sections/system.yaml"
+          path: "github.spec_git_workflow"
+
+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,40 @@
+# Git Strategy Settings
+# Workflow configuration for Manual/Personal/Team 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
+
+  # Personal Mode Settings (GitHub Individual)
+  personal:
+    workflow: github-flow
+    environment: github
+    github_integration: true
+    auto_branch: true
+    auto_commit: true
+    auto_pr: false
+    auto_push: true
+    branch_prefix: "feature/SPEC-"
+    main_branch: main
+
+  # Team Mode Settings (GitHub Team)
+  team:
+    workflow: github-flow
+    environment: github
+    github_integration: true
+    auto_branch: true
+    auto_commit: true
+    auto_pr: true
+    auto_push: true
+    draft_pr: true
+    required_reviews: 1
+    branch_protection: true
+    feature_prefix: "feature/SPEC-"
+    main_branch: main

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
+  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
+  mode: development           # development, production, maintenance
+  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,15 @@
+# Quality & Constitution Settings
+# TDD enforcement and report generation
+
+constitution:
+  enforce_tdd: true           # Require tests before implementation
+  test_coverage_target: 90    # Minimum test coverage percentage
+  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,86 @@
+# 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
+  display:
+    model: true                  # 🤖 Model name (glm-4.6, claude-3.5-sonnet, etc.)
+    version: true                # 🗿 MoAI-ADK version (0.23.0, etc.)
+    output_style: true           # ✍️ Output style (Explanatory, Concise, etc.)
+    memory_usage: true           # 💾 Session memory usage
+    todo_count: true             # 📋 Active TODO items count
+    branch: true                 # 🔀 Git branch
+    git_status: true             # ✅2 M1 ?10 Git changes status
+    duration: true               # ⏱️ Session elapsed time
+    directory: true              # 📁 Project name/directory
+    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
+    icons:
+      git: "🔀"                 # Git branch icon (more intuitive than 📊)
+      staged: "✅"              # Staged files
+      modified: "📝"            # Modified files
+      untracked: "❓"           # Untracked files
+      added: "➕"               # Added files
+      deleted: "➖"             # Deleted files
+      renamed: "🔄"             # Renamed files
+      conflict: "⚠️"           # Conflict files
+      model: "🤖"               # AI model
+      output_style: "💬"        # Writing style
+      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()