Miyabi Rust Crates

📦 Crates Overview

Crate	Description	Version	crates.io	Lines	Tests	Status
miyabi-types	Core type definitions	1.0.0		1,200	149	✅ 100%
miyabi-core	Configuration, retry, logger, docs	1.0.0		1,100	57	✅ 100%
miyabi-worktree	Git worktree parallel execution	1.0.0		485	3	✅ 100%
miyabi-github	GitHub API integration (octocrab)	1.0.0		950	15	✅ 100%
miyabi-agents	7 autonomous AI agents	1.0.0		5,477	110	✅ 100%
miyabi-cli	Command-line interface	1.0.0		1,700	13	✅ 100%

Total: ~10,912 lines, 347 tests (100% passing) ✅

Architecture

miyabi-cli (Binary)
    │
    ├── miyabi-agents (7 Agents)
    │   ├── CoordinatorAgent (1,014 lines, 20 tests)
    │   ├── CodeGenAgent (1,254 lines, 36 tests)
    │   ├── IssueAgent (558 lines, 12 tests)
    │   ├── PRAgent (496 lines, 12 tests)
    │   ├── ReviewAgent (840 lines, 12 tests)
    │   ├── DeploymentAgent (668 lines, 15 tests)
    │   └── RefresherAgent (625 lines, 10 tests)
    │
    ├── miyabi-github (GitHub API)
    │   ├── Issues API (list, create, update, labels)
    │   ├── Labels API (create, list, delete)
    │   └── Pull Requests API (create, merge, reviews)
    │
    ├── miyabi-worktree (Parallel Execution)
    │   ├── WorktreeManager (create, remove, merge)
    │   ├── Semaphore-based concurrency control
    │   └── Statistics tracking
    │
    ├── miyabi-core (Utilities)
    │   ├── Config (YAML/TOML/JSON + env vars)
    │   ├── Retry (exponential backoff)
    │   ├── Logger (tracing-based)
    │   └── Documentation (rustdoc + README generation)
    │
    └── miyabi-types (Type Definitions)
        ├── Agent types (AgentType, AgentResult, Metrics)
        ├── Task types (Task, DAG, TaskGroup)
        ├── Issue types (Issue, IssueState, PR)
        └── Workflow types (ExecutionReport, Progress)

Quick Start

Installation

# Clone repository
git clone https://github.com/ShunsukeHayashi/miyabi-private.git
cd miyabi-private

# Build all crates
cargo build --workspace

# Run tests (347 tests)
cargo test --workspace

# Build CLI binary
cargo build --release --bin miyabi

# Install CLI globally
cargo install --path crates/miyabi-cli

Basic Usage

# Initialize new project
miyabi init my-project

# Install to existing project
cd existing-project
miyabi install

# Check status
miyabi status

# Run agent (autonomous execution)
miyabi agent run coordinator --issue 270

Agents

7 Autonomous AI Agents

1. CoordinatorAgent (1,014 lines)

• Purpose: Issue分析・Task分解・DAG構築
• Features:
  • GitHub Issue fetching
  • Task decomposition with dependencies
  • DAG construction and cycle detection
  • Specialist agent assignment
• Tests: 20 unit + integration tests

2. CodeGenAgent (1,254 lines)

• Purpose: AI-driven code generation
• Features:
  • Worktree-based parallel execution
  • EXECUTION_CONTEXT.md generation
  • .agent-context.json for Claude Code
  • Documentation generation (Rustdoc + README)
  • Retry with exponential backoff
• Tests: 36 comprehensive tests

3. IssueAgent (558 lines)

• Purpose: Issue analysis and label inference
• Features:
  • AI-based type/priority/severity inference
  • Automatic label assignment
  • Escalation detection
  • GitHub API integration
• Tests: 12 unit tests

4. PRAgent (496 lines)

• Purpose: Pull Request automation
• Features:
  • Automatic PR creation
  • Conventional Commits compliance
  • Reviewer assignment
  • Draft PR support
• Tests: 12 unit tests

5. ReviewAgent (840 lines)

• Purpose: Code quality review
• Features:
  • 100-point scoring system
  • Clippy + cargo check integration
  • Security scanning
  • Escalation on low scores
• Tests: 12 unit tests

6. DeploymentAgent (668 lines)

• Purpose: CI/CD automation
• Features:
  • Build → Test → Deploy → Health Check → Rollback
  • Firebase/Vercel/AWS support
  • Retry (Staging: 5, Production: 10)
  • Escalation to CTO on production failures
• Tests: 15 comprehensive tests

7. RefresherAgent (625 lines)

• Purpose: Issue status monitoring
• Features:
  • Implementation status checking (cargo build/test)
  • Automatic state label updates
  • Phase 3-5 tracking
  • Escalation on >100 updates
• Tests: 10 unit tests

Development

Prerequisites

• Rust: 1.75.0+ (2021 Edition)
• Git: 2.30+
• GitHub Token: For API access

Environment Variables

export GITHUB_TOKEN=ghp_xxx        # Required for GitHub API
export DEVICE_IDENTIFIER=MacBook   # Optional device ID
export ANTHROPIC_API_KEY=sk-xxx    # Optional for AI features

Build Profiles

# Development (optimized dependencies)
cargo build

# Release (full optimizations)
cargo build --release

# CLI binary
cargo build --release --bin miyabi

# All binaries
cargo build --release --workspace

Testing

# All tests (347 tests)
cargo test --workspace

# Unit tests only (327 tests)
cargo test --workspace --lib

# Integration tests only (20 tests)
cargo test --workspace --test '*'

# Specific crate
cargo test -p miyabi-agents

# With output
cargo test -- --nocapture

# Coverage (requires tarpaulin)
cargo tarpaulin --workspace --out Html

Code Quality

# Linting (strict mode)
cargo clippy --workspace -- -D warnings

# Format check
cargo fmt --check

# Documentation
cargo doc --workspace --no-deps --open

Performance

Rust vs TypeScript:

• ✅ Execution time: 50%+ faster
• ✅ Memory usage: 30%+ reduction
• ✅ Binary size: 30MB (release)
• ✅ Compilation: 3 minutes (full workspace)

Project Status

Completed Phases (9/9) ✅

• ✅ Phase 1-2: Planning & Design (100%)
• ✅ Phase 3: Type Definitions (100% - 170 tests)
• ✅ Phase 4: CLI Implementation (100% - 29 tests)
• ✅ Phase 5: Agent Implementation (100% - 109 tests)
• ✅ Phase 6: Worktree Management (100% - 3 tests)
• ✅ Phase 7: GitHub Integration (100% - 15 tests)
• ✅ Phase 8: Test Implementation (100% - 347 tests)
• ✅ Phase 9: Documentation (100% - v1.0.0 Released)

Quality Metrics

Documentation

• Rustdoc: cargo doc --workspace --open
• Examples: See crates/*/examples/
• Integration Guide: docs/RUST_MIGRATION_REQUIREMENTS.md
• API Reference: Generated by cargo doc

Contributing

# 1. Create feature branch
git checkout -b feature/my-feature

# 2. Make changes with tests
cargo test --workspace

# 3. Check code quality
cargo clippy -- -D warnings
cargo fmt

# 4. Commit (Conventional Commits)
git commit -m "feat(agents): add new feature"

# 5. Push and create PR
git push origin feature/my-feature

License

Apache-2.0

Links

• Repository: https://github.com/ShunsukeHayashi/miyabi-private
• Issue Tracker: https://github.com/ShunsukeHayashi/miyabi-private/issues
• Documentation: cargo doc --workspace --open
• Changelog: See CHANGELOG.md

Miyabi Rust Edition - Production Ready 🚀