baro-ai 0.4.2 → 0.4.4

package/README.md

@@ -1,6 +1,6 @@
 # baro
 
-Autonomous parallel coding engine. Give it a goal, it breaks it into stories, builds a dependency DAG, and executes them in parallel using AI agents.
+Background agent runtime orchestrator. Breaks down a goal into stories, builds a dependency DAG, and runs them in parallel — each story gets its own Claude agent.
 
 ```
 npm install -g baro-ai
@@ -8,111 +8,47 @@ npm install -g baro-ai
 
 ## How it works
 
-1. **You describe a goal** - "Add authentication with JWT and role-based access control"
-2. **AI plans the work** - Claude (or OpenAI) explores your codebase and creates a dependency graph of user stories
-3. **You review the plan** - Scrollable plan review with accept/refine/quit
-4. **Stories execute in parallel** - Independent stories run simultaneously, each with its own Claude agent
-5. **Live TUI dashboard** - Watch progress, logs, DAG visualization, and stats in real-time
+1. You describe a goal
+2. Claude explores your codebase and plans the work as a dependency graph
+3. You review and accept the plan
+4. Stories execute in parallel with live TUI dashboard
+5. Each story auto-commits and pushes on completion
 
 ## Usage
 
-### Interactive mode
-
-```bash
-baro
-```
-
-Opens the welcome screen where you type your goal and choose a planner.
-
-### Direct mode
-
-```bash
-baro "Add a REST API for user management"
-```
-
-Skips the welcome screen and starts planning immediately.
-
-### Options
-
-```
-baro [goal] [options]
-
-Arguments:
-  goal                    Project goal (opens welcome screen if omitted)
-
-Options:
-  --planner <planner>     Planner to use: claude or openai (default: claude)
-  --cwd <path>            Working directory (default: current directory)
-  -h, --help              Print help
-```
-
-### Examples
-
 ```bash
 # Interactive - opens welcome screen
 baro
 
-# Plan and execute with Claude (default)
-baro "Refactor the database layer to use connection pooling"
+# Direct - skip to planning
+baro "Add authentication with JWT and role-based access control"
 
-# Use OpenAI for planning
+# Use OpenAI for planning instead of Claude
 baro --planner openai "Add WebSocket support"
 
-# Run in a specific directory
-baro --cwd ~/projects/myapp "Add unit tests for all API endpoints"
+# Specify working directory
+baro --cwd ~/projects/myapp "Add unit tests"
 ```
 
-## TUI Screens
-
-### Welcome
-
-ASCII art logo, goal text input, and planner toggle (Claude/OpenAI).
-
-### Planning
-
-Animated spinner showing planning progress with elapsed timer. The selected AI explores your codebase and generates a structured plan.
-
-### Review
-
-Scrollable list of all planned stories with descriptions and dependencies. Navigate with arrow keys, accept with Enter, or quit with q.
-
-### Execution Dashboard
-
-Three tabs while stories execute:
+## Features
 
-- **Dashboard** - Story list with status icons + live logs from the active agent
-- **DAG** - Dependency graph visualization showing levels and connections
-- **Stats** - Summary table with times, file counts, and completion stats
-
-Keybinds: `1/2/3` switch tabs, `Tab/Shift+Tab` switch log panels, `q` quit.
+- **Parallel execution** — independent stories run simultaneously, respecting dependency order
+- **DAG engine** — topological sort with level grouping, cycle detection
+- **Live TUI** — dashboard with story status, live agent logs, DAG view, stats
+- **Git coordination** — mutex-protected commits, auto-push with retry, pull --rebase before each story, conflict detection
+- **Retry logic** — failed stories retry automatically (configurable per story)
+- **Completion screen** — summary overlay with stats when all stories finish
+- **Claude + OpenAI** — Claude as default planner/executor, OpenAI as alternative planner
 
 ## Requirements
 
-- [Claude CLI](https://docs.anthropic.com/en/docs/claude-cli) installed and authenticated (for Claude planner/executor)
-- Node.js 18+ (only needed if using `--planner openai`)
+- [Claude CLI](https://docs.anthropic.com/en/docs/claude-cli) installed and authenticated
 - macOS (arm64/x64) or Linux (x64/arm64)
+- Node.js 18+ (only if using `--planner openai`)
 
 ## Architecture
 
-Baro is a Rust binary distributed via npm:
-
-- **TUI** - ratatui-based terminal UI with 4 screens
-- **Planner** - Spawns Claude CLI or OpenAI (via Node.js bridge) to generate a PRD
-- **DAG Engine** - Kahn's algorithm for topological sort with level grouping
-- **Executor** - Parallel story execution via tokio, one Claude agent per story
-- **npm package** - `postinstall` downloads the prebuilt binary for your platform
-
-## Development
-
-```bash
-# Build the Rust binary
-cargo build -p baro-tui --release
-
-# Run locally
-./target/release/baro "your goal"
-
-# The binary is in crates/baro-tui/
-```
+Rust binary distributed via npm. TUI built with ratatui, async execution with tokio, one Claude CLI process per story.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "baro-ai",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "Autonomous parallel coding - plan and execute with AI",
   "type": "module",
   "bin": {