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

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

@@ -1,124 +1,158 @@
 ---
-name: moai-lang-rust
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: Rust 1.84+ best practices with cargo test, clippy, rustfmt, and ownership/borrow checker mastery.
-keywords: ['rust', 'testing', 'cargo', 'clippy', 'rustfmt', 'ownership']
+name: "moai-lang-rust"
+description: "Rust 1.92+ development specialist covering Axum, Tokio, SQLx, and memory-safe systems programming. Use when building high-performance, memory-safe applications or WebAssembly."
+version: 1.2.0
+category: "language"
+modularized: false
+user-invocable: false
+tags: ["language", "rust", "axum", "tokio", "sqlx", "serde", "wasm", "cargo"]
+updated: 2026-01-11
+status: "active"
 allowed-tools:
   - Read
-  - Bash
+  - Grep
+  - Glob
+  - mcp__context7__resolve-library-id
+  - mcp__context7__get-library-docs
 ---
 
-# Lang Rust Skill
+## Quick Reference (30 seconds)
 
-## Skill Metadata
+Rust 1.92+ Development Specialist with deep patterns for high-performance, memory-safe applications.
 
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-lang-rust |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Language |
+Auto-Triggers: `.rs`, `Cargo.toml`, async/await, Tokio, Axum, SQLx, serde, lifetimes, traits
 
----
+Core Use Cases:
+
+- High-performance REST APIs and microservices
+- Memory-safe concurrent systems
+- CLI tools and system utilities
+- WebAssembly applications
+- Low-latency networking services
 
-## What It Does
+Quick Patterns:
 
-Rust 1.84+ best practices with cargo test, clippy, rustfmt, and ownership/borrow checker mastery.
+Axum REST API: Create Router with route macro chaining path and handler. Add with_state for shared state. Bind TcpListener with tokio::net and serve with axum::serve.
 
-**Key capabilities**:
-- ✅ Best practices enforcement for language domain
-- ✅ TRUST 5 principles integration
-- ✅ Latest tool versions (2025-10-22)
-- ✅ TDD workflow support
+Async Handler with SQLx: Define async handler function taking State extractor for AppState and Path extractor for id. Use sqlx::query_as! macro with SQL string and bind parameters. Call fetch_optional on pool, await, and use ok_or for error conversion. Return Json wrapped result.
 
 ---
 
-## When to Use
+## Implementation Guide (5 minutes)
 
-**Automatic triggers**:
-- Related code discussions and file patterns
-- SPEC implementation (`/alfred:2-run`)
-- Code review requests
+### Rust 1.92 Features
 
-**Manual invocation**:
-- Review code for TRUST 5 compliance
-- Design new features
-- Troubleshoot issues
+Modern Rust Features:
 
----
+- Rust 2024 Edition available (released with Rust 1.85)
+- Async traits in stable (no more async-trait crate needed)
+- Const generics for compile-time array sizing
+- let-else for pattern matching with early return
+- Improved borrow checker with polonius
 
-## Tool Version Matrix (2025-10-22)
+Async Traits (Stable): Define trait with async fn signatures. Implement trait for concrete types with async fn implementations. Call sqlx macros directly in trait methods.
 
-| Tool | Version | Purpose | Status |
-|------|---------|---------|--------|
-| **Rust** | 1.84.0 | Primary | ✅ Current |
-| **cargo** | 1.84.0 | Primary | ✅ Current |
-| **clippy** | 1.84.0 | Primary | ✅ Current |
-| **rustfmt** | 1.84.0 | Primary | ✅ Current |
+Let-Else Pattern: Use let Some(value) = option else with return for early exit. Chain multiple let-else statements for sequential validation. Return error types in else blocks.
 
----
+### Web Framework: Axum 0.8
+
+Installation: In Cargo.toml dependencies section, add axum version 0.8, tokio version 1.48 with full features, and tower-http version 0.6 with cors and trace features.
+
+Complete API Setup: Import extractors from axum::extract and routing macros. Define Clone-derive AppState struct holding PgPool. In tokio::main async main, create pool with PgPoolOptions setting max_connections and connecting with DATABASE_URL from env. Build Router with route chains for paths and handlers, add CorsLayer, and call with_state. Bind TcpListener and call axum::serve.
+
+Handler Patterns: Define async handlers taking State, Path, and Query extractors with appropriate types. Use sqlx::query_as! for type-safe queries with positional binds. Return Result with Json success and AppError failure.
 
-## Inputs
+### Async Runtime: Tokio 1.48
 
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
+Task Spawning and Channels: Create mpsc channel with capacity. Spawn worker tasks with tokio::spawn that receive from channel in loop. For timeouts, use tokio::select! macro with operation branch and sleep branch, returning error on timeout.
 
-## Outputs
+### Database: SQLx 0.8
 
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
+Type-Safe Queries: Derive sqlx::FromRow on structs for automatic mapping. Use query_as! macro for compile-time checked queries. Call fetch_one or fetch_optional on pool. For transactions, call pool.begin, execute queries on transaction reference, and call tx.commit.
 
-## Failure Modes
+### Serialization: Serde 1.0
 
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
+Derive Serialize and Deserialize on structs. Use serde attribute with rename_all for case conversion. Use rename attribute for field-specific naming. Use skip_serializing_if with Option::is_none. Use default attribute for default values.
 
-## Dependencies
+### Error Handling
 
-- Access to project files via Read/Bash tools
-- Integration with `moai-foundation-langs` for language detection
-- Integration with `moai-foundation-trust` for quality gates
+thiserror: Derive Error on enum with error attribute for display messages. Use from attribute for automatic conversion from source errors. Implement IntoResponse by matching on variants and returning status code with Json body containing error message.
+
+### CLI Development: clap
+
+Derive Parser on main Cli struct with command attributes for name, version, about. Use arg attribute for global flags. Derive Subcommand on enum for commands. Match on command in main to dispatch logic.
+
+### Testing Patterns
+
+Create test module with cfg(test) attribute. Define tokio::test async functions. Call setup helpers, invoke functions under test, and use assert! macros for verification.
 
 ---
 
-## References (Latest Documentation)
+## Advanced Patterns
+
+### Performance Optimization
+
+Release Build: In Cargo.toml profile.release section, enable lto, set codegen-units to 1, set panic to abort, and enable strip.
+
+### Deployment
 
-_Documentation links updated 2025-10-22_
+Minimal Container: Use multi-stage Dockerfile. First stage uses rust alpine image, copies Cargo files, creates dummy main for dependency caching, builds release, copies source, touches main.rs for rebuild, builds final release. Second stage uses alpine, copies binary from builder, exposes port, and sets CMD.
+
+### Concurrency
+
+Rate-Limited Operations: Create Arc-wrapped Semaphore with max permits. Map over items spawning tasks that acquire permit, process, and return result. Use futures::future::join_all to collect results.
 
 ---
 
-## Changelog
+## Context7 Integration
 
-- **v2.0.0** (2025-10-22): Major update with latest tool versions, comprehensive best practices, TRUST 5 integration
-- **v1.0.0** (2025-03-29): Initial Skill release
+Library Documentation Access:
+
+- `/rust-lang/rust` - Rust language and stdlib
+- `/tokio-rs/tokio` - Tokio async runtime
+- `/tokio-rs/axum` - Axum web framework
+- `/launchbadge/sqlx` - SQLx async SQL
+- `/serde-rs/serde` - Serialization framework
+- `/dtolnay/thiserror` - Error derive
+- `/clap-rs/clap` - CLI parser
 
 ---
 
 ## Works Well With
 
-- `moai-foundation-trust` (quality gates)
-- `moai-alfred-code-reviewer` (code review)
-- `moai-essentials-debug` (debugging support)
+- `moai-lang-go` - Go systems programming patterns
+- `moai-domain-backend` - REST API architecture and microservices patterns
+- `moai-foundation-quality` - Security hardening for Rust applications
+- `moai-workflow-testing` - Test-driven development workflows
 
 ---
 
-## Best Practices
+## Troubleshooting
+
+Common Issues:
+
+- Cargo errors: Run cargo clean followed by cargo build
+- Version check: Run rustc --version and cargo --version
+- Dependency issues: Run cargo update and cargo tree
+- Compile-time SQL check: Run cargo sqlx prepare
+
+Performance Characteristics:
+
+- Startup Time: 50-100ms
+- Memory Usage: 5-20MB base
+- Throughput: 100k-200k req/s
+- Latency: p99 less than 5ms
+- Container Size: 5-15MB (alpine)
 
-✅ **DO**:
-- Follow language best practices
-- Use latest stable tool versions
-- Maintain test coverage ≥85%
-- Document all public APIs
+---
+
+## Additional Resources
+
+See [reference.md](reference.md) for complete language reference and Context7 library mappings.
+
+See [examples.md](examples.md) for production-ready code examples.
+
+---
 
-❌ **DON'T**:
-- Skip quality gates
-- Use deprecated tools
-- Ignore security warnings
-- Mix testing frameworks
+Last Updated: 2026-01-11
+Version: 1.2.0