@boa-framework/core

The core engine and CLI for BOA (Block Orchestrated Architecture) — a modular, AI-native framework for building applications from small, isolated, versioned blocks.

Homepage | Getting Started | Tutorials

Features

• Atomic blocks — Each block is a single-responsibility unit under 200 lines
• Isolation — Modifying one block cannot break another
• Explicit contracts — Inputs and outputs are declared, not guessed
• Versioning — Workflows pin exact block versions
• Polyglot — Supports JavaScript, TypeScript, Python, Go, C#, and Rust
• Declarative workflows — Chain blocks together using .boa manifests
• AI-native — Designed for AI-generated codebases with built-in intent, rules, and fixtures

Installation

npm install -g @boa-framework/core

Quick Start

# Initialize a new project
boa init

# Create a block
boa block create MyBlock --layer domain --runtime node

# Run fixtures
boa test [email protected]

# Validate the project
boa validate

# Execute a workflow
boa run workflow.boa --input-file input.json

CLI Commands

| Command | Description | |---------|-------------| | boa init | Initialize a new BOA project | | boa block create <name> | Scaffold a new block | | boa run <workflow> | Execute a workflow | | boa test <block@version> | Run fixture tests for a block | | boa validate | Validate all blocks, fixtures, and wiring | | boa impact <block@version> | Show block dependencies and usage | | boa registry-ls | List all registered blocks |

Requirements

• Node.js v18 or higher (v22 recommended)

License

ISC