moai-adk 0.35.1__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-workflow-project/examples/config-migration-example.json

@@ -0,0 +1,190 @@
+{
+  "title": "Configuration Migration Example",
+  "description": "Example showing migration from legacy configuration files to unified format",
+  "legacy_configs": {
+    "batch_questions": {
+      "file": ".moai/batch_questions_config.json",
+      "content": {
+        "version": "1.0",
+        "max_batch_size": 25,
+        "timeout": 180,
+        "retry_count": 2,
+        "output_type": "yaml",
+        "cache_enabled": true,
+        "cache_ttl": 12
+      }
+    },
+    "documentation": {
+      "file": ".claude/docs_config.json", 
+      "content": {
+        "version": "1.0",
+        "auto_docs": true,
+        "doc_format": "html",
+        "include_schemas": true,
+        "template_type": "handlebars",
+        "output_path": "generated-docs"
+      }
+    },
+    "language_config": {
+      "file": ".moai/i18n_config.json",
+      "content": {
+        "version": "1.0", 
+        "default_lang": "ko",
+        "supported_langs": ["ko", "en", "ja"],
+        "auto_translate": true,
+        "fallback_lang": "en"
+      }
+    }
+  },
+  "migration_result": {
+    "unified_config": {
+      "version": "1.0.0",
+      "metadata": {
+        "created_at": "2025-01-25T10:30:00Z",
+        "updated_at": "2025-01-25T10:30:00Z",
+        "migration_history": [
+          {
+            "from_version": "1.0",
+            "to_version": "1.0.0",
+            "timestamp": "2025-01-25T10:30:00Z",
+            "description": "Migrated from legacy configurations to unified format"
+          }
+        ]
+      },
+      "project_settings": {
+        "name": "MoAI Menu Project",
+        "type": "web",
+        "description": "Menu project management system",
+        "author": "MoAI Team",
+        "license": "MIT"
+      },
+      "batch_questions": {
+        "enabled": true,
+        "max_questions": 25,
+        "timeout_seconds": 180,
+        "retry_attempts": 2,
+        "output_format": "yaml",
+        "caching": {
+          "enabled": true,
+          "ttl_hours": 12,
+          "max_cache_size_mb": 100
+        }
+      },
+      "documentation": {
+        "auto_generate": true,
+        "format": "html",
+        "include_api_docs": true,
+        "include_examples": true,
+        "template_engine": "handlebars",
+        "output_directory": "generated-docs"
+      },
+      "language_config": {
+        "default_language": "ko",
+        "supported_languages": ["ko", "en", "ja"],
+        "auto_detect": true,
+        "fallback_language": "en",
+        "translation_service": {
+          "provider": "local",
+          "cache_enabled": true
+        }
+      },
+      "template_optimizer": {
+        "enabled": true,
+        "optimization_level": "basic",
+        "minification": false,
+        "caching": {
+          "enabled": true,
+          "strategy": "memory",
+          "ttl_minutes": 60
+        },
+        "validation": {
+          "strict_mode": false,
+          "check_syntax": true,
+          "check_security": true
+        }
+      },
+      "project_initializer": {
+        "auto_dependencies": true,
+        "git_init": true,
+        "create_virtual_env": true,
+        "package_managers": {
+          "python": {
+            "enabled": true,
+            "tool": "pip"
+          }
+        }
+      }
+    }
+  },
+  "migration_steps": [
+    {
+      "step": 1,
+      "action": "Detect legacy configurations",
+      "files_found": 3,
+      "modules": ["batch_questions", "documentation", "language_config"]
+    },
+    {
+      "step": 2,
+      "action": "Create backup",
+      "backup_file": "backups/config_backup_20250125_103000.json"
+    },
+    {
+      "step": 3,
+      "action": "Transform legacy data",
+      "transformations": [
+        {
+          "module": "batch_questions",
+          "changes": [
+            "max_batch_size → max_questions",
+            "timeout → timeout_seconds", 
+            "retry_count → retry_attempts",
+            "output_type → output_format",
+            "cache_ttl → caching.ttl_hours"
+          ]
+        },
+        {
+          "module": "documentation",
+          "changes": [
+            "auto_docs → auto_generate",
+            "doc_format → format",
+            "template_type → template_engine",
+            "output_path → output_directory"
+          ]
+        },
+        {
+          "module": "language_config",
+          "changes": [
+            "default_lang → default_language",
+            "supported_langs → supported_languages",
+            "auto_translate → auto_detect (inferred)",
+            "fallback_lang → fallback_language"
+          ]
+        }
+      ]
+    },
+    {
+      "step": 4,
+      "action": "Merge into unified configuration",
+      "result": "All legacy configurations successfully merged"
+    },
+    {
+      "step": 5,
+      "action": "Validate against schema",
+      "validation": "Passed"
+    }
+  ],
+  "post_migration": {
+    "actions": [
+      "Legacy configuration files archived",
+      "Unified configuration saved",
+      "Migration history recorded",
+      "Configuration validated"
+    ],
+    "next_steps": [
+      "Review unified configuration",
+      "Test application functionality",
+      "Remove legacy files (optional)",
+      "Update documentation"
+    ]
+  }
+}

moai_adk/templates/.claude/skills/moai-workflow-project/examples/question-examples.json

@@ -0,0 +1,175 @@
+{
+  "examples": {
+    "basic_usage": {
+      "description": "Basic question asking example",
+      "code": "from modules.batch_questions import BatchQuestionsManager\n\nmanager = BatchQuestionsManager()\ntemplate = manager.load_template('project-initialization')\nresponses = manager.execute_batch(template)",
+      "expected_output": "Dictionary of user responses keyed by question ID"
+    },
+    "skill_specific": {
+      "description": "Using skill-specific question templates",
+      "code": "from modules.batch_questions import ask_skill_questions\n\n# Ask questions for config manager skill\nresponses = ask_skill_questions('moai-project-config-manager')\nprint(responses)",
+      "expected_output": "Config manager specific user responses"
+    },
+    "conditional_questions": {
+      "description": "Example of conditional question logic",
+      "config": {
+        "questions": [
+          {
+            "id": "use_git",
+            "text": "Use Git for version control?",
+            "type": "boolean",
+            "required": true
+          },
+          {
+            "id": "git_provider",
+            "text": "Which Git provider?",
+            "type": "single_choice",
+            "required": true,
+            "options": [
+              {
+                "label": "GitHub",
+                "value": "github"
+              },
+              {
+                "label": "GitLab",
+                "value": "gitlab"
+              },
+              {
+                "label": "Bitbucket",
+                "value": "bitbucket"
+              }
+            ],
+            "conditional_on": {
+              "use_git": true
+            }
+          }
+        ]
+      }
+    },
+    "multi_select_example": {
+      "description": "Multi-select question example",
+      "config": {
+        "questions": [
+          {
+            "id": "features",
+            "text": "Select features to enable:",
+            "type": "multi_choice",
+            "required": true,
+            "options": [
+              {
+                "label": "Authentication",
+                "value": "auth"
+              },
+              {
+                "label": "Database",
+                "value": "database"
+              },
+              {
+                "label": "API",
+                "value": "api"
+              },
+              {
+                "label": "Web UI",
+                "value": "web_ui"
+              }
+            ]
+          }
+        ]
+      }
+    },
+    "validation_example": {
+      "description": "Question with validation rules",
+      "config": {
+        "questions": [
+          {
+            "id": "project_name",
+            "text": "Enter project name:",
+            "type": "text_input",
+            "required": true,
+            "validation": {
+              "rules": [
+                "required",
+                "min_length",
+                "regex"
+              ],
+              "parameters": {
+                "min_length": 3,
+                "regex": "^[a-zA-Z][a-zA-Z0-9-_]*$"
+              },
+              "error_message": "Project name must start with letter and contain only letters, numbers, hyphens, underscores"
+            }
+          }
+        ]
+      }
+    }
+  },
+  "integration_patterns": {
+    "with_config_manager": {
+      "description": "Integrating with configuration management",
+      "code": "# Process responses into config\nconfig = manager.process_responses_for_config(\n    responses, \n    config_path='.moai/config/config.yaml'\n)\n# Save updated config\nwith open('.moai/config/config.yaml', 'w') as f:\n    json.dump(config, f, indent=2)"
+    },
+    "with_menu_system": {
+      "description": "Using with menu system integration",
+      "code": "# Get questions for menu setup\ntemplate = manager.get_skill_specific_template('moai-menu-project')\nresponses = manager.execute_batch(template)\n# Apply to menu configuration\nmenu_config = manager.process_responses_for_config(responses)"
+    },
+    "conditional_workflows": {
+      "description": "Conditional workflow based on responses",
+      "code": "# Get language configuration\nlang_responses = ask_skill_questions('moai-project-language-initializer')\n\n# Conditionally ask framework questions based on language\nif lang_responses.get('language.primary') == 'python':\n    framework_responses = ask_skill_questions('python-frameworks', lang_responses)"
+    }
+  },
+  "template_customization": {
+    "custom_question_types": {
+      "description": "Creating custom question types",
+      "example": {
+        "id": "custom_type",
+        "text": "Select from custom options:",
+        "type": "single_choice",
+        "options": [
+          {
+            "label": "Custom Option 1",
+            "value": "custom1",
+            "description": "Description for custom option"
+          },
+          {
+            "label": "Custom Option 2",
+            "value": "custom2",
+            "description": "Another custom option"
+          }
+        ],
+        "metadata": {
+          "category": "custom",
+          "priority": "high"
+        }
+      }
+    },
+    "dynamic_options": {
+      "description": "Questions with dynamically generated options",
+      "example": "manager = BatchQuestionsManager()\noptions = manager._generate_dynamic_options('git_providers')\nquestion = Question('git_provider', 'Select Git provider:', QuestionType.SINGLE_CHOICE, options)"
+    },
+    "nested_configuration": {
+      "description": "Handling nested configuration paths",
+      "example": {
+        "id": "git_strategy.branch_creation.prompt_always",
+        "text": "Always prompt for branch creation?",
+        "type": "boolean",
+        "metadata": {
+          "config_path": "git_strategy.branch_creation.prompt_always"
+        }
+      }
+    }
+  },
+  "error_handling": {
+    "validation_errors": {
+      "description": "Handling validation failures",
+      "pattern": "try:\n    responses = manager.execute_batch(template)\nexcept ValueError as e:\n    print(f'Validation error: {e}')\n    # Handle error - maybe retry with default values"
+    },
+    "missing_templates": {
+      "description": "Handling missing question templates",
+      "pattern": "template = manager.load_template('custom-template')\nif template is None:\n    # Fallback to default template\n    template = manager.load_template('project-initialization')"
+    },
+    "user_cancellation": {
+      "description": "Handling user cancellation of questions",
+      "pattern": "# Check if user cancelled responses\nfor response in responses.values():\n    if response.metadata.get('cancelled'):\n        print('User cancelled question flow')\n        break"
+    }
+  }
+}

moai_adk/templates/.claude/skills/moai-workflow-project/examples/quick_start.py

@@ -0,0 +1,196 @@
+#!/usr/bin/env python3
+"""
+MoAI Menu Project - Quick Start Example
+
+Quick start guide for using the integrated MoAI Menu Project system.
+"""
+
+import sys
+from pathlib import Path
+
+# Add the moai-menu-project to Python path
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+# Import modules directly  # noqa: E402 - imports after path setup
+from datetime import datetime  # noqa: E402
+from typing import Any, Dict  # noqa: E402
+
+from modules.documentation_manager import DocumentationManager  # noqa: E402
+from modules.language_initializer import LanguageInitializer  # noqa: E402
+from modules.template_optimizer import TemplateOptimizer  # noqa: E402
+
+
+class MoaiMenuProject:
+    """Simplified version for testing."""
+
+    def __init__(self, project_root: str, config: Dict[str, Any] = None):
+        self.project_root = Path(project_root)
+
+        if config is None:
+            config = {
+                "project": {"name": "Test Project", "type": "web_application"},
+                "language": {"conversation_language": "en"},
+                "user": {"name": "Test User"},
+            }
+
+        self.config = config
+        self.version = "1.0.0"
+
+        # Initialize modules
+        self.documentation_manager = DocumentationManager(str(project_root), config)
+        self.language_initializer = LanguageInitializer(str(project_root), config)
+        self.template_optimizer = TemplateOptimizer(str(project_root), config)
+
+    def initialize_complete_project(self, **kwargs) -> Dict[str, Any]:
+        """Initialize complete project with all modules."""
+
+        result = {
+            "success": True,
+            "modules_initialized": [
+                "documentation_manager",
+                "language_initializer",
+                "template_optimizer",
+            ],
+            "created_files": [],
+            "configuration_updates": {},
+            "timestamp": datetime.now().isoformat(),
+        }
+
+        # Update configuration with provided parameters
+        for key, value in kwargs.items():
+            if hasattr(self, key):
+                setattr(self, key, value)
+
+        return result
+
+    def get_project_status(self) -> Dict[str, Any]:
+        """Get project status."""
+        return {
+            "configuration": {
+                "project_name": self.config.get("project", {}).get("name", "Unknown"),
+                "project_type": self.config.get("project", {}).get("type", "unknown"),
+                "menu_system_version": self.version,
+            },
+            "fully_initialized": True,
+        }
+
+    def generate_documentation_from_spec(self, spec_data: Dict[str, Any]) -> Dict[str, Any]:
+        """Generate documentation from SPEC data."""
+        return {
+            "spec_id": spec_data.get("id", "SPEC-001"),
+            "success": True,
+            "updated_files": ["docs/product.md", "docs/structure.md", "docs/tech.md"],
+        }
+
+    def export_project_documentation(self, format_type: str = "markdown") -> Dict[str, Any]:
+        """Export project documentation."""
+        return {
+            "success": True,
+            "format": format_type,
+            "files": ["docs/product.md", "docs/structure.md", "docs/tech.md"],
+            "output_directory": str(self.project_root / "docs-export"),
+        }
+
+    def optimize_project_templates(self, **options) -> Dict[str, Any]:
+        """Optimize project templates."""
+        return {
+            "success": True,
+            "optimized_files": [],
+            "size_reduction": 15.5,
+            "optimizations_applied": ["size_optimization", "performance_optimization"],
+        }
+
+
+def quick_start():
+    """Quick start example with minimal configuration."""
+
+    print("🚀 MoAI Menu Project - Quick Start")
+    print("=" * 40)
+
+    # Step 1: Initialize project
+    print("\n1. Initializing project...")
+    project = MoaiMenuProject("./my-awesome-project")
+
+    # Step 2: Complete setup with default settings
+    print("2. Setting up project modules...")
+    result = project.initialize_complete_project(
+        language="en",  # Change to "ko", "ja", or "zh" for other languages
+        user_name="Your Name",
+        domains=["backend", "frontend"],
+        project_type="web_application",
+    )
+
+    if result["success"]:
+        print("✅ Project successfully initialized!")
+        print(f"   📁 Project root: {project.project_root}")
+        print("   🌐 Language: en")
+        print(f"   📄 Modules initialized: {', '.join(result['modules_initialized'])}")
+
+    else:
+        print("❌ Project initialization failed")
+        return
+
+    # Step 3: Get project status
+    print("\n3. Checking project status...")
+    status = project.get_project_status()
+
+    print(f"   📊 Project name: {status['configuration']['project_name']}")
+    print(f"   🏗️  Project type: {status['configuration']['project_type']}")
+    print(f"   ✨ Fully initialized: {status['fully_initialized']}")
+
+    # Step 4: Create sample documentation
+    print("\n4. Creating sample documentation...")
+
+    sample_spec = {
+        "id": "SPEC-001",
+        "title": "User Management System",
+        "description": "Implement user registration, login, and profile management",
+        "requirements": [
+            "User registration with email verification",
+            "Secure login system",
+            "User profile management",
+            "Password reset functionality",
+        ],
+        "status": "Planned",
+        "priority": "High",
+    }
+
+    docs_result = project.generate_documentation_from_spec(sample_spec)
+
+    if docs_result:
+        print("✅ Sample documentation created!")
+        print(f"   📝 SPEC ID: {docs_result['spec_id']}")
+        print(f"   📁 Updated files: {', '.join(docs_result['updated_files'])}")
+
+    # Step 5: Export documentation
+    print("\n5. Exporting documentation...")
+
+    export_result = project.export_project_documentation("markdown")
+
+    if export_result.get("success"):
+        print("✅ Documentation exported successfully!")
+        print(f"   📁 Output directory: {export_result['output_directory']}")
+        print(f"   📄 Files exported: {len(export_result['files'])}")
+
+    print("\n🎉 Quick start completed!")
+    print("\nNext steps:")
+    print("   1. Explore the generated documentation in ./my-awesome-project/docs/")
+    print("   2. Check the configuration in ./my-awesome-project/.moai/config/config.yaml")
+    print("   3. Customize templates in ./my-awesome-project/.claude/skills/moai-menu-project/templates/")
+    print("   4. Run additional optimizations with: project.optimize_project_templates()")
+
+    return result
+
+
+if __name__ == "__main__":
+    try:
+        result = quick_start()
+        print(f"\n{'=' * 40}")
+        print("Quick start completed successfully! 🚀")
+    except Exception as e:
+        print(f"\n❌ Error during quick start: {e}")
+        import traceback
+
+        traceback.print_exc()
+        sys.exit(1)