moai-adk 0.15.1__py3-none-any.whl → 0.25.4__py3-none-any.whl

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

@@ -1,316 +0,0 @@
-# Python 3.13 CLI Reference — Tool Command Matrix
-
-**Framework**: Python 3.13.1 + pytest 8.4.2 + ruff 0.13.1 + mypy 1.8.0 + uv 0.9.3
-
----
-
-## Python Runtime Commands
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `python --version` | Check Python version | `python --version` → `Python 3.13.1` |
-| `python -m venv .venv` | Create virtual environment | `python -m venv .venv` |
-| `python -m pip list` | List installed packages | `python -m pip list` |
-| `python -c "code"` | Execute Python code inline | `python -c "import sys; print(sys.version)"` |
-| `python script.py` | Run Python script | `python script.py` |
-| `python -m module` | Run module as script | `python -m pytest` |
-| `python -i script.py` | Run script with interactive shell | `python -i script.py` |
-| `python --help` | Show Python help | `python --help` |
-
----
-
-## Virtual Environment Management (uv)
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `uv venv` | Create virtual environment | `uv venv` → creates `.venv/` |
-| `uv venv --python 3.13` | Create with specific Python | `uv venv --python 3.13` |
-| `source .venv/bin/activate` | Activate (macOS/Linux) | `source .venv/bin/activate` |
-| `.venv\Scripts\activate` | Activate (Windows) | `.venv\Scripts\activate` |
-| `deactivate` | Deactivate virtual environment | `deactivate` |
-| `which python` | Check active Python | `which python` → `.venv/bin/python` |
-
----
-
-## Package Management (uv 0.9.3)
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `uv add package` | Add package | `uv add pytest ruff mypy` |
-| `uv add --dev package` | Add dev dependency | `uv add --dev pytest pytest-cov` |
-| `uv sync` | Install from lock file | `uv sync` |
-| `uv pip list` | List packages | `uv pip list` |
-| `uv pip show package` | Show package details | `uv pip show pytest` |
-| `uv remove package` | Remove package | `uv remove pytest` |
-| `uv update` | Update all packages | `uv update` |
-| `uv publish` | Publish to PyPI | `uv publish` |
-| `uv build` | Build distribution | `uv build` |
-
----
-
-## Testing Framework (pytest 8.4.2)
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `pytest` | Run all tests | `pytest` |
-| `pytest tests/` | Run tests in directory | `pytest tests/` |
-| `pytest file.py` | Run tests in file | `pytest tests/test_calculator.py` |
-| `pytest -v` | Verbose output | `pytest -v` |
-| `pytest -vv` | Very verbose output | `pytest -vv` |
-| `pytest -s` | Show print statements | `pytest -s` |
-| `pytest -x` | Stop on first failure | `pytest -x` |
-| `pytest -k "pattern"` | Run matching tests | `pytest -k "test_add"` |
-| `pytest -m asyncio` | Run async tests only | `pytest -m asyncio` |
-| `pytest --cov=src` | Coverage report | `pytest --cov=src --cov-report=term` |
-| `pytest --cov-report=html` | HTML coverage report | `pytest --cov-report=html` |
-| `pytest --tb=short` | Short traceback format | `pytest --tb=short` |
-| `pytest --tb=long` | Long traceback format | `pytest --tb=long` |
-| `pytest --lf` | Run last failed tests | `pytest --lf` |
-| `pytest --ff` | Fail-first (last failures first) | `pytest --ff` |
-| `pytest --maxfail=3` | Stop after 3 failures | `pytest --maxfail=3` |
-| `pytest -n 4` | Run in parallel (4 workers) | `pytest -n 4` |
-| `pytest --junitxml=report.xml` | JUnit XML report | `pytest --junitxml=report.xml` |
-| `pytest --co` | Collect tests only (don't run) | `pytest --co` |
-| `pytest --setup-show` | Show fixture setup/teardown | `pytest --setup-show` |
-
-**Coverage Quality Gate**:
-```bash
-# Ensure ≥85% coverage
-pytest --cov=src --cov-report=term --cov-fail-under=85
-```
-
----
-
-## Code Quality Linter (ruff 0.13.1)
-
-### Check Commands
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `ruff check .` | Check all files | `ruff check .` |
-| `ruff check src/` | Check directory | `ruff check src/` |
-| `ruff check file.py` | Check file | `ruff check src/calculator.py` |
-| `ruff check . --fix` | Check and auto-fix | `ruff check . --fix` |
-| `ruff check --show-fixes` | Show what would be fixed | `ruff check --show-fixes` |
-| `ruff check --select E501` | Check specific rule | `ruff check --select E501` |
-| `ruff check --ignore E501` | Ignore specific rule | `ruff check --ignore E501` |
-| `ruff check --statistics` | Show violation statistics | `ruff check --statistics` |
-
-### Format Commands
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `ruff format .` | Format all files | `ruff format .` |
-| `ruff format src/` | Format directory | `ruff format src/` |
-| `ruff format file.py` | Format file | `ruff format src/calculator.py` |
-| `ruff format --check` | Check if formatting needed | `ruff format --check` |
-
-### Rule Categories
-
-| Category | Rules | Example |
-|----------|-------|---------|
-| **E** | Errors | `E501` (line too long) |
-| **F** | PyFlakes (logic errors) | `F401` (unused import) |
-| **W** | Warnings | `W291` (trailing whitespace) |
-| **I** | Import sorting | `I001` (import sort order) |
-| **C** | Complexity | `C901` (function too complex) |
-
-**pyproject.toml Configuration**:
-```toml
-[tool.ruff]
-line-length = 100
-target-version = "py313"
-
-[tool.ruff.lint]
-select = ["E", "F", "W", "I", "C901"]
-
-[tool.ruff.format]
-indent-width = 4
-```
-
----
-
-## Type Checking (mypy 1.8.0)
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `mypy .` | Type check all files | `mypy .` |
-| `mypy src/` | Type check directory | `mypy src/` |
-| `mypy file.py` | Type check file | `mypy src/models.py` |
-| `mypy --strict .` | Strict type checking | `mypy --strict .` |
-| `mypy --strict --show-error-codes` | Strict with error codes | `mypy --strict --show-error-codes` |
-| `mypy --show-column-numbers .` | Precise error locations | `mypy --show-column-numbers .` |
-| `mypy --html .` | Generate HTML report | `mypy --html .` |
-| `mypy --help` | Show mypy help | `mypy --help` |
-
-**Common Error Codes**:
-
-| Code | Meaning | Example |
-|------|---------|---------|
-| `error: Untyped definition` | Function missing type hints | `def func(x): ...` |
-| `error: Call to untyped function` | Calling function without types | Depends on context |
-| `error: Incompatible types` | Type mismatch | `x: int = "string"` |
-| `error: Missing return statement` | Function might not return | Missing `return` in all paths |
-
-**pyproject.toml Configuration**:
-```toml
-[tool.mypy]
-python_version = "3.13"
-strict = true
-warn_return_any = true
-warn_unused_configs = true
-disallow_untyped_defs = true
-```
-
----
-
-## Python 3.13 Features
-
-### New Syntax Examples
-
-| Feature | Syntax | Example |
-|---------|--------|---------|
-| **Type Parameters (PEP 695)** | `class Foo[T]:` | `class Stack[T]: def push(self, item: T): ...` |
-| **F-String Nesting (PEP 701)** | `f"{f'{x}'}"` | `f"Result: {f'{value:>10}'}"` |
-| **Override Decorator (PEP 698)** | `@override` | `@override def method(self): ...` |
-| **Match Statement** | `match value:` | Pattern matching expressions |
-
-### Introspection Commands
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `python -c "import sys; print(sys.version_info)"` | Check version info | `sys.version_info(major=3, minor=13, ...)` |
-| `python -m inspect module` | Inspect module | `python -m inspect src.models` |
-| `python -c "import typing; print(dir(typing))"` | List typing utilities | Shows all available type hints |
-
----
-
-## Performance Profiling
-
-| Command | Purpose | Example |
-|---------|---------|---------|
-| `python -m cProfile script.py` | Profile script | `python -m cProfile src/main.py` |
-| `python -m timeit "code"` | Time code execution | `python -m timeit "sum(range(100))"` |
-| `python -m pdb script.py` | Debug with pdb | `python -m pdb src/main.py` |
-| `python -m trace --trace script.py` | Trace execution | `python -m trace --trace src/main.py` |
-
----
-
-## Combined Workflow (Quality Gate)
-
-**Before Commit** (all must pass):
-
-```bash
-# 1. Run tests with coverage (≥85%)
-pytest --cov=src --cov-report=term --cov-fail-under=85
-
-# 2. Check linting
-ruff check .
-
-# 3. Format code
-ruff format .
-
-# 4. Type check (strict mode)
-mypy --strict .
-
-# 5. All pass → commit
-echo "✅ Quality gates passed!"
-git add .
-git commit -m "feat: implement feature with full coverage"
-```
-
----
-
-## Environment Setup Script
-
-**`setup-dev.sh`** (complete dev environment):
-
-```bash
-#!/bin/bash
-set -e
-
-echo "🔧 Setting up Python 3.13 development environment..."
-
-# Create and activate venv
-uv venv --python 3.13
-source .venv/bin/activate
-
-# Install dependencies
-echo "📦 Installing dependencies..."
-uv add pytest ruff mypy fastapi uvicorn pydantic sqlalchemy alembic
-
-# Install dev dependencies
-echo "🛠️ Installing dev dependencies..."
-uv add --dev pytest-asyncio pytest-cov pytest-mock coverage
-
-# Verify setup
-echo "✅ Verification:"
-python --version
-pytest --version
-ruff --version
-mypy --version
-
-echo "🎉 Dev environment ready!"
-```
-
-**Run**:
-```bash
-chmod +x setup-dev.sh
-./setup-dev.sh
-```
-
----
-
-## CI/CD Integration (GitHub Actions)
-
-**`.github/workflows/test.yml`**:
-
-```yaml
-name: Tests
-
-on: [push, pull_request]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        python-version: [3.12, 3.13]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install uv
-        run: pip install uv
-
-      - name: Create venv
-        run: uv venv
-
-      - name: Install dependencies
-        run: uv sync
-
-      - name: Run tests
-        run: pytest --cov=src --cov-report=xml --cov-fail-under=85
-
-      - name: Upload coverage
-        uses: codecov/codecov-action@v3
-        with:
-          files: ./coverage.xml
-
-      - name: Lint check
-        run: ruff check .
-
-      - name: Type check
-        run: mypy --strict .
-```
-
----
-
-**Version**: 0.1.0
-**Created**: 2025-10-22
-**Framework**: Python 3.13.1 CLI Tools Reference

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

@@ -1,123 +0,0 @@
----
-name: moai-lang-r
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: R 4.4+ best practices with testthat 3.2, lintr 3.2, and data analysis patterns.
-keywords: ['r', 'testthat', 'lintr', 'data-analysis']
-allowed-tools:
-  - Read
-  - Bash
----
-
-# Lang R Skill
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-lang-r |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Language |
-
----
-
-## What It Does
-
-R 4.4+ best practices with testthat 3.2, lintr 3.2, and data analysis patterns.
-
-**Key capabilities**:
-- ✅ Best practices enforcement for language 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 |
-|------|---------|---------|--------|
-| **R** | 4.4.2 | Primary | ✅ Current |
-| **testthat** | 3.2.2 | Primary | ✅ Current |
-| **lintr** | 3.2.0 | Primary | ✅ Current |
-
----
-
-## 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
-
-- 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
-
-- **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)
-
----
-
-## 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

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

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

@@ -1,30 +0,0 @@
-# moai-lang-r - 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)
-
-- **R**: 4.4.2
-- **testthat**: 3.2.2
-- **lintr**: 3.2.0
-
----
-
-_For detailed usage, see SKILL.md_

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

@@ -1,124 +0,0 @@
----
-name: moai-lang-ruby
-version: 2.0.0
-created: 2025-10-22
-updated: 2025-10-22
-status: active
-description: Ruby 3.4+ best practices with RSpec 4, RuboCop 2, Bundler, and Rails 8 patterns.
-keywords: ['ruby', 'rspec', 'rubocop', 'bundler', 'rails']
-allowed-tools:
-  - Read
-  - Bash
----
-
-# Lang Ruby Skill
-
-## Skill Metadata
-
-| Field | Value |
-| ----- | ----- |
-| **Skill Name** | moai-lang-ruby |
-| **Version** | 2.0.0 (2025-10-22) |
-| **Allowed tools** | Read (read_file), Bash (terminal) |
-| **Auto-load** | On demand when keywords detected |
-| **Tier** | Language |
-
----
-
-## What It Does
-
-Ruby 3.4+ best practices with RSpec 4, RuboCop 2, Bundler, and Rails 8 patterns.
-
-**Key capabilities**:
-- ✅ Best practices enforcement for language 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 |
-|------|---------|---------|--------|
-| **Ruby** | 3.4.0 | Primary | ✅ Current |
-| **RSpec** | 4.0.0 | Primary | ✅ Current |
-| **RuboCop** | 2.0.0 | Primary | ✅ Current |
-| **Rails** | 8.0.0 | Primary | ✅ Current |
-
----
-
-## 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
-
-- 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
-
-- **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)
-
----
-
-## 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

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

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

@@ -1,31 +0,0 @@
-# moai-lang-ruby - 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)
-
-- **Ruby**: 3.4.0
-- **RSpec**: 4.0.0
-- **RuboCop**: 2.0.0
-- **Rails**: 8.0.0
-
----
-
-_For detailed usage, see SKILL.md_