open-agents-ai 0.3.0 → 0.4.0

package/README.md

@@ -16,10 +16,24 @@ Agent: [Turn 1] file_read(src/auth.ts)
        [Turn 5] task_complete(summary="Fixed null check — all tests pass")
 ```
 
-The agent has **11 tools** and uses them autonomously in a loop, reading errors, fixing code, and re-running validation until the task succeeds or the turn limit is reached.
+The agent has **18 tools** (including 3 AIWG SDLC tools and 4 advanced analysis tools) and uses them autonomously in a loop, reading errors, fixing code, and re-running validation until the task succeeds or the turn limit is reached.
 
 ## Quick Start
 
+### Install from npm (recommended)
+
+```bash
+# Install globally — provides `open-agents` and `oa` commands
+npm i -g open-agents-ai
+
+# Run it — first launch auto-detects your system and pulls the best model
+oa "fix the null check in auth.ts"
+```
+
+On first run, the setup wizard detects your RAM/VRAM and recommends the optimal qwen3.5 variant.
+
+### Install from source
+
 ```bash
 # 1. Install Ollama (https://ollama.com)
 curl -fsSL https://ollama.com/install.sh | sh
@@ -77,7 +91,7 @@ pnpm -r test   # 911 tests across 77 files
 
 ## Tools
 
-The agent has access to 11 tools that it calls autonomously:
+The agent has access to 18 tools that it calls autonomously:
 
 | Tool | Description |
 |------|-------------|
@@ -92,6 +106,13 @@ The agent has access to 11 tools that it calls autonomously:
 | `web_fetch` | Fetch and extract text from web pages (docs, MDN, w3schools) |
 | `memory_read` | Read from persistent memory store |
 | `memory_write` | Store patterns and solutions for future tasks |
+| `aiwg_setup` | Deploy AIWG SDLC framework in the project |
+| `aiwg_health` | Analyze project SDLC health and readiness |
+| `aiwg_workflow` | Execute AIWG commands and workflows |
+| `batch_edit` | Multiple precise edits across files in one call |
+| `codebase_map` | High-level project structure overview |
+| `diagnostic` | Run lint/typecheck/test/build validation pipeline |
+| `git_info` | Structured git status, log, diff, and branch info |
 
 ### Self-Learning
 
@@ -183,6 +204,39 @@ oa --backend vllm --backend-url http://localhost:8000/v1 "add tests"
 oa --backend-url http://10.0.0.5:11434 "refactor auth"
 ```
 
+## AIWG Integration
+
+Open Agents integrates with [AIWG](https://www.npmjs.com/package/aiwg) (AI Writing Guide) — a cognitive architecture for AI-augmented software development. When AIWG is installed, the agent gains SDLC superpowers:
+
+```bash
+# Install AIWG globally
+npm i -g aiwg
+
+# The agent can now use AIWG tools automatically:
+oa "analyze this project's SDLC health and set up proper documentation"
+oa "create requirements and architecture docs for this codebase"
+```
+
+### What AIWG Adds
+
+| Capability | Description |
+|-----------|-------------|
+| **Structured Memory** | `.aiwg/` directory persists project knowledge across sessions |
+| **SDLC Artifacts** | Requirements, architecture, test strategy, deployment docs |
+| **Health Analysis** | Score your project's SDLC maturity (testing, CI/CD, docs, etc.) |
+| **85+ Agents** | Specialized AI personas (Test Engineer, Security Auditor, API Designer) |
+| **Traceability** | @-mention system links requirements → code → tests |
+
+### AIWG Tools
+
+The 3 AIWG tools are available when `aiwg` is installed globally:
+
+- **`aiwg_setup`** — Deploy an AIWG framework (`sdlc`, `marketing`, `forensics`, `research`)
+- **`aiwg_health`** — Analyze project SDLC readiness (works even without AIWG installed)
+- **`aiwg_workflow`** — Run any AIWG CLI command (`runtime-info`, `list`, `mcp info`)
+
+If AIWG is not installed, the tools return helpful install instructions. The `aiwg_health` tool provides native analysis without requiring AIWG.
+
 ## Architecture
 
 ### Agentic Loop
@@ -230,7 +284,7 @@ scripts/          - install.sh, setup-model.sh, bootstrap.sh
 
 ## Evaluation
 
-The framework includes 8 evaluation tasks that test the agent's ability to autonomously resolve coding problems:
+The framework includes 17 evaluation tasks that test the agent's ability to autonomously resolve coding problems:
 
 ```bash
 # Run all 8 tasks with agentic tool-calling loop
@@ -272,6 +326,15 @@ Total: 39 turns, 55 tool calls, ~10 minutes
 | 06 | Fix TypeScript type errors | Medium |
 | 07 | Add REST API endpoint | Medium |
 | 08 | Add pagination across multiple files | Hard |
+| 09 | CSS named color lookup (148 colors, web search) | Medium |
+| 10 | HTTP status code lookup (32+ codes, web search) | Medium |
+| 11 | MIME type lookup (30+ types, web search) | Medium |
+| 12 | SDLC health analyzer (AIWG-style scoring) | Medium |
+| 13 | SDLC artifact generator (requirements, arch, tests) | Hard |
+| 14 | Batch refactor variable names across files | Medium |
+| 15 | Codebase overview generator from structure analysis | Medium |
+| 16 | Diagnostic fix loop (find and fix buggy code) | Medium |
+| 17 | Git repository analyzer | Medium |
 
 ## Test Suite