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

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

@@ -1,124 +1,372 @@
 ---
 name: moai-lang-rust
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
+description: Rust 1.91+ development specialist covering Axum, Tokio, SQLx, and memory-safe systems programming. Use when building high-performance, memory-safe applications or WebAssembly.
+version: 1.0.0
+category: language
+tags: rust, axum, tokio, async, memory-safe, wasm
+context7-libraries: /tokio-rs/axum, /tokio-rs/tokio, /launchbadge/sqlx
+related-skills: moai-lang-go, moai-domain-backend
+updated: 2025-12-07
 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']
-allowed-tools:
-  - Read
-  - Bash
 ---
 
-# Lang Rust Skill
-
-## Skill Metadata
-
-| 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 |
+## Quick Reference (30 seconds)
+
+Rust 1.91+ Development Specialist with deep patterns for high-performance, memory-safe applications.
+
+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
+
+Quick Patterns:
+
+Axum REST API:
+```rust
+let app = Router::new()
+    .route("/api/users/:id", get(get_user))
+    .with_state(app_state);
+let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await?;
+axum::serve(listener, app).await?;
+```
+
+Async Handler with SQLx:
+```rust
+async fn get_user(
+    State(state): State<AppState>,
+    Path(id): Path<i64>,
+) -> Result<Json<User>, AppError> {
+    let user = sqlx::query_as!(User, "SELECT * FROM users WHERE id = $1", id)
+        .fetch_optional(&state.db).await?
+        .ok_or(AppError::NotFound)?;
+    Ok(Json(user))
+}
+```
 
 ---
 
-## What It Does
-
-Rust 1.84+ best practices with cargo test, clippy, rustfmt, and ownership/borrow checker mastery.
-
-**Key capabilities**:
-- ✅ Best practices enforcement for language domain
-- ✅ TRUST 5 principles integration
-- ✅ Latest tool versions (2025-10-22)
-- ✅ TDD workflow support
+## Implementation Guide (5 minutes)
+
+### Rust 1.91 Features
+
+Modern Rust Features:
+- 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
+
+Async Traits (Stable):
+```rust
+trait AsyncRepository {
+    async fn get(&self, id: i64) -> Result<User, Error>;
+    async fn create(&self, user: CreateUser) -> Result<User, Error>;
+}
+
+impl AsyncRepository for PostgresRepository {
+    async fn get(&self, id: i64) -> Result<User, Error> {
+        sqlx::query_as!(User, "SELECT * FROM users WHERE id = $1", id)
+            .fetch_one(&self.pool).await
+    }
+}
+```
+
+Let-Else Pattern:
+```rust
+fn get_user(id: Option<i64>) -> Result<User, Error> {
+    let Some(id) = id else { return Err(Error::MissingId); };
+    let Ok(user) = repository.find(id) else { return Err(Error::NotFound); };
+    Ok(user)
+}
+```
+
+### Web Framework: Axum 0.8
+
+Installation:
+```toml
+[dependencies]
+axum = "0.8"
+tokio = { version = "1.48", features = ["full"] }
+tower-http = { version = "0.6", features = ["cors", "trace"] }
+```
+
+Complete API Setup:
+```rust
+use axum::{extract::{Path, State, Query}, routing::{get, post}, Router, Json};
+use tower_http::cors::CorsLayer;
+
+#[derive(Clone)]
+struct AppState { db: PgPool }
+
+#[tokio::main]
+async fn main() -> Result<(), Box<dyn std::error::Error>> {
+    let pool = PgPoolOptions::new()
+        .max_connections(25)
+        .connect(&std::env::var("DATABASE_URL")?).await?;
+
+    let app = Router::new()
+        .route("/api/v1/users", get(list_users).post(create_user))
+        .route("/api/v1/users/:id", get(get_user))
+        .layer(CorsLayer::permissive())
+        .with_state(AppState { db: pool });
+
+    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await?;
+    axum::serve(listener, app).await?;
+    Ok(())
+}
+```
+
+Handler Patterns:
+```rust
+async fn list_users(
+    State(state): State<AppState>,
+    Query(params): Query<ListParams>,
+) -> Result<Json<Vec<User>>, AppError> {
+    let users = sqlx::query_as!(User,
+        "SELECT * FROM users ORDER BY created_at DESC LIMIT $1 OFFSET $2",
+        params.limit.unwrap_or(10), params.offset.unwrap_or(0))
+        .fetch_all(&state.db).await?;
+    Ok(Json(users))
+}
+```
+
+### Async Runtime: Tokio 1.48
+
+Task Spawning and Channels:
+```rust
+use tokio::sync::mpsc;
+
+async fn worker_pool() {
+    let (tx, mut rx) = mpsc::channel::<Job>(100);
+    for _ in 0..4 {
+        tokio::spawn(async move {
+            while let Some(job) = rx.recv().await { process_job(job).await; }
+        });
+    }
+}
+
+async fn timeout_operation() -> Result<Data, Error> {
+    tokio::select! {
+        result = fetch_data() => result,
+        _ = tokio::time::sleep(Duration::from_secs(5)) => Err(Error::Timeout),
+    }
+}
+```
+
+### Database: SQLx 0.8
+
+Type-Safe Queries:
+```rust
+#[derive(Debug, sqlx::FromRow)]
+struct User { id: i64, name: String, email: String }
+
+async fn user_operations(pool: &PgPool) -> Result<(), sqlx::Error> {
+    let user = sqlx::query_as!(User,
+        "SELECT id, name, email FROM users WHERE id = $1", 1i64)
+        .fetch_one(pool).await?;
+
+    let mut tx = pool.begin().await?;
+    sqlx::query!("INSERT INTO users (name, email) VALUES ($1, $2)", "John", "john@example.com")
+        .execute(&mut *tx).await?;
+    tx.commit().await?;
+    Ok(())
+}
+```
+
+### Serialization: Serde 1.0
+
+```rust
+use serde::{Deserialize, Serialize};
+
+#[derive(Debug, Serialize, Deserialize)]
+#[serde(rename_all = "camelCase")]
+struct User {
+    id: i64,
+    #[serde(rename = "userName")]
+    name: String,
+    #[serde(skip_serializing_if = "Option::is_none")]
+    profile_url: Option<String>,
+    #[serde(default)]
+    is_active: bool,
+}
+```
+
+### Error Handling
+
+thiserror:
+```rust
+use thiserror::Error;
+
+#[derive(Error, Debug)]
+pub enum AppError {
+    #[error("database error: {0}")]
+    Database(#[from] sqlx::Error),
+    #[error("not found: {0}")]
+    NotFound(String),
+    #[error("unauthorized")]
+    Unauthorized,
+}
+
+impl IntoResponse for AppError {
+    fn into_response(self) -> Response {
+        let (status, message) = match &self {
+            AppError::NotFound(_) => (StatusCode::NOT_FOUND, self.to_string()),
+            AppError::Unauthorized => (StatusCode::UNAUTHORIZED, self.to_string()),
+            AppError::Database(_) => (StatusCode::INTERNAL_SERVER_ERROR, "Internal error".into()),
+        };
+        (status, Json(json!({"error": message}))).into_response()
+    }
+}
+```
+
+### CLI Development: clap
+
+```rust
+use clap::{Parser, Subcommand};
+
+#[derive(Parser)]
+#[command(name = "myapp", version, about)]
+struct Cli {
+    #[arg(short, long, global = true)]
+    config: Option<PathBuf>,
+    #[command(subcommand)]
+    command: Commands,
+}
+
+#[derive(Subcommand)]
+enum Commands {
+    Serve { #[arg(short, long, default_value = "3000")] port: u16 },
+    Migrate,
+}
+
+fn main() {
+    let cli = Cli::parse();
+    match cli.command {
+        Commands::Serve { port } => serve(port),
+        Commands::Migrate => migrate(),
+    }
+}
+```
+
+### Testing Patterns
+
+```rust
+#[cfg(test)]
+mod tests {
+    use super::*;
+
+    #[tokio::test]
+    async fn test_create_user() {
+        let pool = setup_test_db().await;
+        let result = create_user(&pool, "John", "john@example.com").await;
+        assert!(result.is_ok());
+        assert_eq!(result.unwrap().name, "John");
+    }
+}
+```
 
 ---
 
-## When to Use
-
-**Automatic triggers**:
-- Related code discussions and file patterns
-- SPEC implementation (`/alfred:2-run`)
-- Code review requests
-
-**Manual invocation**:
-- Review code for TRUST 5 compliance
-- Design new features
-- Troubleshoot issues
+## Advanced Patterns
+
+### Performance Optimization
+
+Release Build:
+```toml
+[profile.release]
+lto = true
+codegen-units = 1
+panic = "abort"
+strip = true
+```
+
+### Deployment
+
+Minimal Container (5-15MB):
+```dockerfile
+FROM rust:1.91-alpine AS builder
+WORKDIR /app
+COPY Cargo.toml Cargo.lock ./
+RUN mkdir src && echo "fn main(){}" > src/main.rs && cargo build --release
+COPY src ./src
+RUN touch src/main.rs && cargo build --release
+
+FROM alpine:latest
+COPY --from=builder /app/target/release/app /app
+EXPOSE 3000
+CMD ["/app"]
+```
+
+### Concurrency
+
+Rate-Limited Operations:
+```rust
+use tokio::sync::Semaphore;
+
+async fn rate_limited(items: Vec<String>, max: usize) -> Vec<String> {
+    let sem = std::sync::Arc::new(Semaphore::new(max));
+    let handles: Vec<_> = items.into_iter().map(|item| {
+        let sem = sem.clone();
+        tokio::spawn(async move {
+            let _permit = sem.acquire().await.unwrap();
+            process_item(item).await
+        })
+    }).collect();
+    futures::future::join_all(handles).await.into_iter().filter_map(|r| r.ok()).collect()
+}
+```
 
 ---
 
-## Tool Version Matrix (2025-10-22)
+## Context7 Integration
 
-| 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 |
+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
 
 ---
 
-## Inputs
-
-- Language-specific source directories
-- Configuration files
-- Test suites and sample data
-
-## Outputs
-
-- Test/lint execution plan
-- TRUST 5 review checkpoints
-- Migration guidance
-
-## Failure Modes
-
-- When required tools are not installed
-- When dependencies are missing
-- When test coverage falls below 85%
-
-## Dependencies
+## Works Well With
 
-- Access to project files via Read/Bash tools
-- Integration with `moai-foundation-langs` for language detection
-- Integration with `moai-foundation-trust` for quality gates
+- `moai-lang-go` - Go systems programming patterns
+- `moai-domain-backend` - REST API architecture and microservices patterns
+- `moai-quality-security` - Security hardening for Rust applications
+- `moai-workflow-tdd` - Test-driven development workflows
 
 ---
 
-## References (Latest Documentation)
-
-_Documentation links updated 2025-10-22_
-
----
+## Troubleshooting
 
-## Changelog
+Common Issues:
+- Cargo errors: `cargo clean && cargo build`
+- Version check: `rustc --version && cargo --version`
+- Dependency issues: `cargo update && cargo tree`
+- Compile-time SQL check: `cargo sqlx prepare`
 
-- **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
+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)
 
 ---
 
-## Works Well With
+## Additional Resources
 
-- `moai-foundation-trust` (quality gates)
-- `moai-alfred-code-reviewer` (code review)
-- `moai-essentials-debug` (debugging support)
+See [reference.md](reference.md) for complete language reference and Context7 library mappings.
 
----
+See [examples.md](examples.md) for production-ready code examples.
 
-## Best Practices
-
-✅ **DO**:
-- Follow language best practices
-- Use latest stable tool versions
-- Maintain test coverage ≥85%
-- Document all public APIs
+---
 
-❌ **DON'T**:
-- Skip quality gates
-- Use deprecated tools
-- Ignore security warnings
-- Mix testing frameworks
+Last Updated: 2025-12-07
+Version: 1.0.0