Contributing

ninja/
├── core/          # Runtime and manager logic
├── CLI/           # shurikenctl command-line tool
├── HTTP/          # REST API server
├── GUI/           # Tauri desktop application
├── MCP/           # Model Context Protocol tools
├── FFI/           # Foreign function interface
└── tests/         # Integration tests

git clone https://github.com/tunafysh/ninja.git
cd ninja

# Rust toolchain (required)
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# Node.js and pnpm (for GUI)
curl -fsSL https://get.pnpm.io/install.sh | sh

# GUI dependencies
cd GUI
pnpm install

# Build all crates
cargo build --workspace

# Build release
cargo build --release

# Build GUI
cd GUI
pnpm tauri build

git checkout -b feature/your-feature-name

# Run unit tests
cargo test --workspace

# Run specific tests
cargo test -p core

# Build and test CLI
cargo build -p CLI --release
./target/release/shurikenctl --version

# Test GUI
cd GUI
pnpm tauri dev

# Format code
cargo fmt --all

# Run clippy
cargo clippy --workspace -- -D warnings

/// Starts a shuriken service by name.
///
/// # Arguments
/// * `name` - The shuriken identifier
///
/// # Returns
/// * `Ok(())` on success
/// * `Err(NinjaError)` on failure
pub async fn start(&self, name: &str) -> Result<(), NinjaError> {
    // Implementation
}

feat: add support for platform-specific configuration
fix: resolve race condition in process spawning
docs: update installation guide
test: add integration tests for shuriken manager
refactor: simplify configuration templating

#[tokio::test]
async fn test_new_feature() {
    // Test implementation
}

#[tokio::test]
async fn test_new_feature_error_case() {
    // Test error handling
}