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

moai_adk/templates/.claude/skills/moai-domain-web-api/SKILL.md

@@ -1,97 +1,123 @@
 ---
-
 name: moai-domain-web-api
-description: REST API and GraphQL design patterns with authentication, versioning, and OpenAPI documentation. Use when working on web API contracts scenarios.
+version: 2.0.0
+created: 2025-10-22
+updated: 2025-10-22
+status: active
+description: REST API and GraphQL design with OpenAPI 3.1, authentication, versioning, and rate limiting.
+keywords: ['rest', 'graphql', 'openapi', 'api-design', 'authentication']
 allowed-tools:
   - Read
   - Bash
 ---
 
-# Web API Expert
+# Domain Web Api Skill
 
 ## Skill Metadata
+
 | Field | Value |
 | ----- | ----- |
-| Allowed tools | Read (read_file), Bash (terminal) |
-| Auto-load | On demand for API delivery |
-| Trigger cues | REST/GraphQL design, contract testing, versioning, integration hardening. |
-| Tier | 4 |
-
-## What it does
-
-Provides expertise in designing and implementing RESTful APIs and GraphQL services, including authentication mechanisms (JWT, OAuth2), API versioning strategies, and OpenAPI documentation.
-
-## When to use
-
-- Engages when designing or validating web APIs and their lifecycle controls.
-- “API design”, “REST API pattern”, “GraphQL schema”, “JWT authentication”
-- Automatically invoked when working with API projects
-- Web API SPEC implementation (`/alfred:2-run`)
-
-## How it works
-
-**REST API Design**:
-- **RESTful principles**: Resource-based URLs, HTTP verbs (GET, POST, PUT, DELETE)
-- **Status codes**: Proper use of 2xx, 4xx, 5xx codes
-- **HATEOAS**: Hypermedia links in responses
-- **Pagination**: Cursor-based or offset-based
-
-**GraphQL Design**:
-- **Schema definition**: Types, queries, mutations, subscriptions
-- **Resolver implementation**: Data fetching logic
-- **N+1 problem**: DataLoader for batching
-- **Schema stitching**: Federated GraphQL
-
-**Authentication & Authorization**:
-- **JWT (JSON Web Token)**: Stateless authentication
-- **OAuth2**: Authorization framework (flows: authorization code, client credentials)
-- **API keys**: Simple authentication
-- **RBAC/ABAC**: Role/Attribute-based access control
-
-**API Versioning**:
-- **URL versioning**: /v1/users, /v2/users
-- **Header versioning**: Accept: application/vnd.api.v2+json
-- **Deprecation strategy**: Sunset header
-
-**Documentation**:
-- **OpenAPI (Swagger)**: API specification
-- **API documentation**: Auto-generated docs
-- **Postman collections**: Request examples
-
-## Examples
-```bash
-$ uvicorn app.main:app --reload
-$ newman run postman_collection.json
-```
+| **Skill Name** | moai-domain-web-api |
+| **Version** | 2.0.0 (2025-10-22) |
+| **Allowed tools** | Read (read_file), Bash (terminal) |
+| **Auto-load** | On demand when keywords detected |
+| **Tier** | Domain |
+
+---
+
+## What It Does
+
+REST API and GraphQL design with OpenAPI 3.1, authentication, versioning, and rate limiting.
+
+**Key capabilities**:
+- ✅ Best practices enforcement for domain domain
+- ✅ TRUST 5 principles integration
+- ✅ Latest tool versions (2025-10-22)
+- ✅ TDD workflow support
+
+---
+
+## 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
+
+---
+
+## Tool Version Matrix (2025-10-22)
+
+| Tool | Version | Purpose | Status |
+|------|---------|---------|--------|
+| **OpenAPI** | 3.1.0 | Primary | ✅ Current |
+| **Postman** | 11.21.0 | Primary | ✅ Current |
+| **Swagger UI** | 5.18.2 | Primary | ✅ Current |
+
+---
 
 ## Inputs
-- Domain-related design documents and user requirements.
-- Project technology stack and operational constraints.
+
+- Language-specific source directories
+- Configuration files
+- Test suites and sample data
 
 ## Outputs
-- Domain-specific architecture or implementation guidelines.
-- Recommended list of associated sub-agents/skills.
+
+- Test/lint execution plan
+- TRUST 5 review checkpoints
+- Migration guidance
 
 ## Failure Modes
-- When the domain document does not exist or is ambiguous.
-- When the project strategy is unconfirmed and cannot be specified.
+
+- When required tools are not installed
+- When dependencies are missing
+- When test coverage falls below 85%
 
 ## Dependencies
-- `.moai/project/` document and latest technical briefing are required.
 
-## References
-- Microsoft. "REST API Design Guidelines." https://learn.microsoft.com/azure/architecture/best-practices/api-design (accessed 2025-03-29).
-- OpenAPI Initiative. "OpenAPI Specification." https://spec.openapis.org/oas/latest.html (accessed 2025-03-29).
+- Access to project files via Read/Bash tools
+- Integration with `moai-foundation-langs` for language detection
+- Integration with `moai-foundation-trust` for quality gates
+
+---
+
+## References (Latest Documentation)
+
+_Documentation links updated 2025-10-22_
+
+---
 
 ## Changelog
-- 2025-03-29: Codified input/output and failure responses for domain skills.
 
-## Works well with
+- **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
+
+---
+
+## Works Well With
+
+- `moai-foundation-trust` (quality gates)
+- `moai-alfred-code-reviewer` (code review)
+- `moai-essentials-debug` (debugging support)
 
-- alfred-trust-validation (API security validation)
-- backend-expert (server implementation)
-- security-expert (authentication patterns)
+---
 
 ## Best Practices
-- Record supporting documentation (version/link) for each domain decision.
-- Review performance, security, and operational requirements simultaneously at an early stage.
+
+✅ **DO**:
+- Follow domain 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

moai_adk/templates/.claude/skills/moai-domain-web-api/examples.md

@@ -0,0 +1,29 @@
+# moai-domain-web-api - 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-domain-web-api/reference.md

@@ -0,0 +1,30 @@
+# moai-domain-web-api - 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)
+
+- **OpenAPI**: 3.1.0
+- **Postman**: 11.21.0
+- **Swagger UI**: 5.18.2
+
+---
+
+_For detailed usage, see SKILL.md_