moai-adk 0.4.5__py3-none-any.whl → 0.20.1__py3-none-any.whl

moai_adk/templates/.claude/skills/moai-lang-swift/examples.md

@@ -0,0 +1,29 @@
+# moai-lang-swift - Working Examples
+
+_Last updated: 2025-10-22_
+
+## Example 1: Basic Setup
+
+```bash
+# Setup commands
+# ...
+```
+
+## Example 2: TDD Workflow
+
+```bash
+# RED: Write failing test
+# GREEN: Implement feature
+# REFACTOR: Improve code
+```
+
+## Example 3: Quality Gate
+
+```bash
+# Run quality checks
+# Verify coverage ≥85%
+```
+
+---
+
+_For more examples, see SKILL.md reference section_

moai_adk/templates/.claude/skills/moai-lang-swift/reference.md

@@ -0,0 +1,30 @@
+# moai-lang-swift - CLI Reference
+
+_Last updated: 2025-10-22_
+
+## Quick Reference
+
+### Installation
+
+```bash
+# Installation commands
+```
+
+### Common Commands
+
+```bash
+# Test
+# Lint
+# Format
+# Build
+```
+
+## Tool Versions (2025-10-22)
+
+- **Swift**: 6.0.0
+- **XCTest**: 6.0.0
+- **SwiftLint**: 0.57.0
+
+---
+
+_For detailed usage, see SKILL.md_

moai_adk/templates/.claude/skills/moai-lang-template/SKILL.md

@@ -0,0 +1,348 @@
+---
+name: moai-lang-{{LANGUAGE_SLUG}}
+version: 2.0.0
+created: 2025-11-06
+updated: 2025-11-06
+status: active
+description: "{{LANGUAGE_NAME}} best practices with modern frameworks, {{PRIMARY_DOMAIN}}, and performance optimization for 2025"
+keywords: [{{LANGUAGE_SLUG}}, programming, {{PRIMARY_PARADIGMS}}, {{ECOSYSTEM_KEYWORDS}}]
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - WebFetch
+  - WebSearch
+---
+
+# {{LANGUAGE_NAME}} Development Mastery
+
+**Modern {{LANGUAGE_NAME}} Development with 2025 Best Practices**
+
+> Comprehensive {{LANGUAGE_NAME}} development guidance covering {{PRIMARY_DOMAIN}} applications, {{LANGUAGE_PARADIGMS}} patterns, and production-ready development using the latest tools and frameworks.
+
+## What It Does
+
+{{#if BACKEND_FOCUS}}
+- **Backend API Development**: {{WEB_FRAMEWORKS}} applications with modern patterns
+- **Database Integration**: {{DATABASE_FRAMEWORKS}} with query optimization
+- **API Development**: REST and GraphQL services with authentication
+- **Testing & Quality**: {{TEST_FRAMEWORK}} with mocking and integration tests
+- **Performance Optimization**: Caching, async patterns, memory management
+- **Production Deployment**: Docker, CI/CD, monitoring, scaling
+- **Security Best Practices**: Input validation, authentication, dependency scanning
+- **Code Quality**: Static analysis, formatting, pre-commit hooks
+{{/if}}
+
+{{#if MOBILE_FOCUS}}
+- **Mobile App Development**: {{MOBILE_FRAMEWORKS}} applications with platform-specific patterns
+- **UI/UX Integration**: Modern UI frameworks and design systems
+- **Platform Services**: Native APIs, push notifications, app store integration
+- **Testing & Quality**: Unit tests, UI tests, device testing
+- **Performance Optimization**: Memory management, battery optimization
+- **Production Deployment**: App store releases, CI/CD, analytics
+- **Security Best Practices**: Data encryption, authentication, secure storage
+- **Code Quality**: Linting, formatting, modular architecture
+{{/if}}
+
+{{#if SYSTEMS_FOCUS}}
+- **Systems Programming**: Low-level development with performance optimization
+- **Memory Management**: Smart pointers, RAII, resource management
+- **Performance Engineering**: Profiling, optimization, benchmarks
+- **Cross-Platform Development**: Multi-platform builds and toolchains
+- **Testing & Quality**: Unit tests, integration tests, property-based testing
+- **Library Development**: API design, ABI compatibility, versioning
+- **Security Best Practices**: Memory safety, input validation, secure coding
+- **Code Quality**: Static analysis, formatting, code review
+{{/if}}
+
+{{#if DATA_FOCUS}}
+- **Data Processing**: {{DATA_FRAMEWORKS}} for analytics and manipulation
+- **Statistical Computing**: {{STATISTICS_FRAMEWORKS}} with modern methods
+- **Data Visualization**: {{VISUALIZATION_FRAMEWORKS}} for insights and reporting
+- **Database Integration**: SQL and NoSQL database connectivity
+- **Testing & Quality**: Unit tests, data validation, reproducible research
+- **Performance Optimization**: Vectorized operations, parallel processing
+- **Production Deployment**: Scheduled jobs, monitoring, data pipelines
+- **Code Quality**: Documentation, reproducible workflows, version control
+{{/if}}
+
+## When to Use
+
+### Perfect Scenarios
+{{#if BACKEND_FOCUS}}
+- **Building REST APIs and microservices**
+- **Developing web applications and services**
+- **Creating database-driven applications**
+- **Integrating with third-party services**
+- **Automating backend workflows**
+- **Deploying scalable server applications**
+- **Enterprise application development**
+{{/if}}
+
+{{#if MOBILE_FOCUS}}
+- **Building mobile applications**
+- **Creating platform-specific user interfaces**
+- **Integrating with device hardware and sensors**
+- **Developing cross-platform mobile apps**
+- **Implementing push notifications and background tasks**
+- **Publishing to app stores**
+- **Mobile-first application development**
+{{/if}}
+
+{{#if SYSTEMS_FOCUS}}
+- **Performance-critical applications**
+- **Systems programming and embedded development**
+- **Game development and graphics programming**
+- **Library and framework development**
+- **Cross-platform application development**
+- **Memory-sensitive applications**
+- **High-performance computing**
+{{/if}}
+
+{{#if DATA_FOCUS}}
+- **Data analysis and statistical computing**
+- **Machine learning and data science workflows**
+- **Business intelligence and reporting**
+- **Data visualization and dashboarding**
+- **Research and academic computing**
+- **Big data processing and analytics**
+- **Statistical modeling and forecasting**
+{{/if}}
+
+### Common Triggers
+- "Create {{LANGUAGE_NAME}} {{PRIMARY_DOMAIN}}"
+- "Set up {{LANGUAGE_NAME}} project"
+- "Optimize {{LANGUAGE_NAME}} performance"
+- "Test {{LANGUAGE_NAME}} code"
+- "Deploy {{LANGUAGE_NAME}} application"
+- "{{LANGUAGE_NAME}} best practices"
+- "{{LANGUAGE_NAME}} {{WEB_FRAMEWORKS}} application"
+
+## Tool Version Matrix (2025-11-06)
+
+### Core {{LANGUAGE_NAME}}
+- **{{LANGUAGE_NAME}}**: {{LATEST_VERSION}} (current) / {{LTS_VERSION}} (LTS)
+- **Package Manager**: {{PACKAGE_MANAGER}} {{PACKAGE_MANAGER_VERSION}}
+- **Runtime/Compiler**: {{RUNTIME_COMPILER}} {{RUNTIME_VERSION}}
+
+{{#if WEB_FRAMEWORKS_AVAILABLE}}
+### Web Frameworks
+{{#each WEB_FRAMEWORKS_AVAILABLE}}
+- **{{name}}**: {{version}} - {{description}}
+{{/each}}
+{{/if}}
+
+{{#if TESTING_TOOLS}}
+### Testing Tools
+{{#each TESTING_TOOLS}}
+- **{{name}}**: {{version}} - {{description}}
+{{/each}}
+{{/if}}
+
+{{#if CODE_QUALITY_TOOLS}}
+### Code Quality
+{{#each CODE_QUALITY_TOOLS}}
+- **{{name}}**: {{version}} - {{description}}
+{{/each}}
+{{/if}}
+
+{{#if SPECIALIZED_TOOLS}}
+### Specialized Tools
+{{#each SPECIALIZED_TOOLS}}
+- **{{name}}**: {{version}} - {{description}}
+{{/each}}
+{{/if}}
+
+## Ecosystem Overview
+
+### Package Management
+
+{{#if PACKAGE_MANAGEMENT_COMMANDS}}
+```bash
+{{#each PACKAGE_MANAGEMENT_COMMANDS}}
+{{this}}
+{{/each}}
+```
+{{/if}}
+
+### Project Structure (2025 Best Practice)
+
+```
+{{PROJECT_STRUCTURE}}
+```
+
+## Modern Development Patterns
+
+### {{LANGUAGE_TYPE_SYSTEM}} Best Practices
+
+{{#if TYPE_EXAMPLES}}
+{{#each TYPE_EXAMPLES}}
+```{{../LANGUAGE_EXTENSION}}
+{{this}}
+```
+{{/each}}
+{{/if}}
+
+### {{PRIMARY_PARADIGMS}} Patterns
+
+{{#if PARADIGM_EXAMPLES}}
+{{#each PARADIGM_EXAMPLES}}
+```{{../LANGUAGE_EXTENSION}}
+{{this}}
+```
+{{/each}}
+{{/if}}
+
+{{#if ASYNC_PATTERNS_AVAILABLE}}
+### Asynchronous Programming Patterns
+
+```{{LANGUAGE_EXTENSION}}
+{{ASYNC_PATTERN_EXAMPLE}}
+```
+{{/if}}
+
+### Data Structures and Patterns
+
+{{#if DATA_STRUCTURE_EXAMPLES}}
+{{#each DATA_STRUCTURE_EXAMPLES}}
+```{{../LANGUAGE_EXTENSION}}
+{{this}}
+```
+{{/each}}
+{{/if}}
+
+## Performance Considerations
+
+{{#if PERFORMANCE_EXAMPLES}}
+{{#each PERFORMANCE_EXAMPLES}}
+### {{title}}
+
+```{{../LANGUAGE_EXTENSION}}
+{{code}}
+```
+{{/each}}
+{{/if}}
+
+### Profiling and Monitoring
+
+{{#if PROFILING_COMMANDS}}
+```bash
+{{#each PROFILING_COMMANDS}}
+{{this}}
+{{/each}}
+```
+{{/if}}
+
+## Testing Strategy
+
+{{#if TESTING_CONFIGURATION}}
+### {{TEST_FRAMEWORK}} Configuration
+
+{{TESTING_CONFIGURATION}}
+{{/if}}
+
+### Modern Testing Patterns
+
+{{#if TESTING_EXAMPLES}}
+{{#each TESTING_EXAMPLES}}
+```{{../LANGUAGE_EXTENSION}}
+{{this}}
+```
+{{/each}}
+{{/if}}
+
+{{#if INTEGRATION_TESTING_AVAILABLE}}
+### Integration Testing
+
+```{{LANGUAGE_EXTENSION}}
+{{INTEGRATION_TESTING_EXAMPLE}}
+```
+{{/if}}
+
+## Security Best Practices
+
+### Input Validation and Sanitization
+
+{{#if SECURITY_EXAMPLES}}
+{{#each SECURITY_EXAMPLES}}
+```{{../LANGUAGE_EXTENSION}}
+{{this}}
+```
+{{/each}}
+{{/if}}
+
+{{#if AUTHENTICATION_PATTERNS}}
+### Authentication and Authorization
+
+```{{LANGUAGE_EXTENSION}}
+{{AUTHENTICATION_PATTERNS}}
+```
+{{/if}}
+
+{{#if SECURITY_TOOLS}}
+### Dependency Security Scanning
+
+```bash
+{{#each SECURITY_TOOLS}}
+{{this}}
+{{/each}}
+```
+{{/if}}
+
+## Integration Patterns
+
+{{#if INTEGRATION_EXAMPLES}}
+{{#each INTEGRATION_EXAMPLES}}
+### {{title}}
+
+```{{../LANGUAGE_EXTENSION}}
+{{code}}
+```
+{{/each}}
+{{/if}}
+
+## Modern Development Workflow
+
+{{#if PROJECT_CONFIGURATION}}
+### Project Configuration
+
+{{PROJECT_CONFIGURATION}}
+{{/if}}
+
+{{#if PRECOMMIT_CONFIG}}
+### Pre-commit Configuration
+
+```yaml
+{{PRECOMMIT_CONFIG}}
+```
+{{/if}}
+
+{{#if DOCKER_EXAMPLE}}
+### Docker Best Practices
+
+```dockerfile
+{{DOCKER_EXAMPLE}}
+```
+{{/if}}
+
+{{#if DOMAIN_SPECIFIC_PATTERNS}}
+## {{PRIMARY_DOMAIN}} Development
+
+{{#each DOMAIN_SPECIFIC_PATTERNS}}
+### {{title}}
+
+```{{../LANGUAGE_EXTENSION}}
+{{code}}
+```
+{{/each}}
+{{/if}}
+
+---
+
+**Created by**: MoAI Language Skill Factory  
+**Last Updated**: 2025-11-06  
+**Version**: 2.0.0  
+**{{LANGUAGE_NAME}} Target**: {{LATEST_VERSION}} with modern {{PRIMARY_PARADIGMS}} features  
+
+This skill provides comprehensive {{LANGUAGE_NAME}} development guidance with 2025 best practices, covering everything from basic project setup to advanced {{PRIMARY_DOMAIN}} integration and production deployment patterns.

moai_adk/templates/.claude/skills/moai-lang-template/VARIABLES.md

@@ -0,0 +1,98 @@
+# Language Skill Template Variables
+
+This document defines the template variables used for generating language-specific skills from the moai-lang-template.
+
+## Core Variables
+
+### Required Variables
+- `{{LANGUAGE_NAME}}`: Full language name (e.g., "Java", "Kotlin", "Swift")
+- `{{LANGUAGE_SLUG}}`: Language identifier for filenames (e.g., "java", "kotlin", "swift")
+- `{{LANGUAGE_EXTENSION}}`: File extension (e.g., ".java", ".kt", ".swift")
+- `{{LATEST_VERSION}}`: Current stable version (e.g., "21", "1.9.24", "5.9")
+- `{{LTS_VERSION}}`: Long-term support version if available
+- `{{PACKAGE_MANAGER}}`: Package manager name and commands
+- `{{PACKAGE_MANAGER_VERSION}}`: Current version of package manager
+- `{{RUNTIME_COMPILER}}`: Compiler or runtime name
+- `{{RUNTIME_VERSION}}`: Runtime/compiler version
+
+### Type System Variables
+- `{{LANGUAGE_TYPE_SYSTEM}}`: Static/Dynamic/Gradual typing
+- `{{PRIMARY_PARADIGMS}}`: Main programming paradigms (e.g., "OOP, Functional")
+
+### Domain Variables
+- `{{PRIMARY_DOMAIN}}`: Main application domain (e.g., "backend", "mobile", "systems", "data")
+- `{{ECOSYSTEM_KEYWORDS}}`: Comma-separated keywords for skill discovery
+
+## Conditional Sections
+
+### Backend Focus (BACKEND_FOCUS=true)
+- `{{WEB_FRAMEWORKS}}`: Main web frameworks
+- `{{DATABASE_FRAMEWORKS}}`: Database integration frameworks
+- `{{WEB_FRAMEWORKS_AVAILABLE}}`: Array of web framework objects
+- `{{INTEGRATION_TESTING_AVAILABLE}}`: true if integration testing supported
+
+### Mobile Focus (MOBILE_FOCUS=true)
+- `{{MOBILE_FRAMEWORKS}}`: Mobile development frameworks
+- `{{PLATFORM_SERVICES}}`: Platform-specific APIs and services
+
+### Systems Focus (SYSTEMS_FOCUS=true)
+- `{{PERFORMANCE_TOOLS}}`: Performance optimization tools
+- `{{CROSS_PLATFORM_TOOLS}}`: Multi-platform build tools
+
+### Data Focus (DATA_FOCUS=true)
+- `{{DATA_FRAMEWORKS}}`: Data processing frameworks
+- `{{STATISTICS_FRAMEWORKS}}`: Statistical computing frameworks
+- `{{VISUALIZATION_FRAMEWORKS}}`: Data visualization libraries
+
+## Tool Categories
+
+### Testing Tools
+- `{{TESTING_TOOLS}}`: Array of testing tool objects
+- `{{TEST_FRAMEWORK}}`: Primary testing framework
+- `{{TESTING_CONFIGURATION}}`: Configuration file content
+- `{{TESTING_EXAMPLES}}`: Array of code examples
+- `{{INTEGRATION_TESTING_EXAMPLE}}`: Integration testing code
+
+### Code Quality
+- `{{CODE_QUALITY_TOOLS}}`: Array of linting/formatting tools
+- `{{PRECOMMIT_CONFIG}}`: Pre-commit configuration content
+
+### Security
+- `{{SECURITY_EXAMPLES}}`: Array of security code examples
+- `{{AUTHENTICATION_PATTERNS}}`: Authentication code patterns
+- `{{SECURITY_TOOLS}}`: Array of security scanning commands
+
+## Code Examples
+
+### Development Patterns
+- `{{TYPE_EXAMPLES}}`: Array of type system examples
+- `{{PARADIGM_EXAMPLES}}`: Array of programming paradigm examples
+- `{{ASYNC_PATTERNS_AVAILABLE}}`: true if async patterns supported
+- `{{ASYNC_PATTERN_EXAMPLE}}`: Async programming code example
+- `{{DATA_STRUCTURE_EXAMPLES}}`: Array of data structure examples
+
+### Performance
+- `{{PERFORMANCE_EXAMPLES}}`: Array of performance optimization examples
+- `{{PROFILING_COMMANDS}}`: Array of profiling commands
+
+### Integration
+- `{{INTEGRATION_EXAMPLES}}`: Array of integration pattern examples
+
+### Domain-Specific
+- `{{DOMAIN_SPECIFIC_PATTERNS}}`: Array of domain-specific patterns
+
+## Project Configuration
+
+- `{{PROJECT_STRUCTURE}}`: Directory structure template
+- `{{PACKAGE_MANAGEMENT_COMMANDS}}`: Array of package management commands
+- `{{PROJECT_CONFIGURATION}}`: Build configuration content
+- `{{DOCKER_EXAMPLE}}`: Dockerfile example
+
+## Template Processing Notes
+
+The template uses Handlebars-style conditional logic:
+- `{{#if CONDITION}}...{{/if}}` for conditional sections
+- `{{#each ARRAY}}...{{/each}}` for array iteration
+- `{{variable}}` for simple variable substitution
+
+Each language skill should define all required variables and optionally include conditional sections based on the language's primary domain and capabilities.