@corbat-tech/coco 1.2.2 → 1.3.0

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/v1.2.0-stable-blueviolet?style=for-the-badge" alt="Version">
+  <img src="https://img.shields.io/badge/v1.2.3-stable-blueviolet?style=for-the-badge" alt="Version">
   <img src="https://img.shields.io/badge/TypeScript-5.7-3178c6?style=for-the-badge&logo=typescript&logoColor=white" alt="TypeScript">
   <img src="https://img.shields.io/badge/Node.js-22+-339933?style=for-the-badge&logo=nodedotjs&logoColor=white" alt="Node.js">
   <img src="https://img.shields.io/badge/License-MIT-f5c542?style=for-the-badge" alt="MIT License">
@@ -53,6 +53,56 @@ coco "Add a REST API endpoint for user authentication with tests"
 
 ---
 
+## What You Can Do
+
+Coco works from the interactive REPL (`coco`). You can use **slash commands** or just **talk naturally** — Coco understands both.
+
+### Slash Commands
+
+| Command | What it does | Example |
+|---------|-------------|---------|
+| `/help` | Show available commands and usage | `/help review` |
+| `/status` | Project status, git info, session stats | `/status` |
+| `/review` | Code review with severity-rated findings | `/review --base main` |
+| `/diff` | Visual diff with syntax highlighting | `/diff --staged` |
+| `/ship` | Full release pipeline: review → test → lint → branch → version → commit → PR → CI → merge | `/ship --minor` |
+| `/compact` | Reduce context when conversation gets long | `/compact` |
+| `/clear` | Clear conversation history | `/clear` |
+
+### Natural Language
+
+You don't need to memorize commands. Just describe what you want:
+
+| What you say | What happens |
+|-------------|-------------|
+| "review the code" / "revisa el código" | Runs `/review` |
+| "let's ship it" / "publica los cambios" | Runs `/ship` |
+| "how are we doing?" / "cómo va?" | Runs `/status` |
+| "create a PR" / "crea un pull request" | Runs `/ship` |
+| "show me the diff" / "muéstrame los cambios" | Runs `/diff` |
+| "help" / "ayuda" | Runs `/help` |
+
+### `/ship` — Release Pipeline
+
+The most powerful command. Orchestrates the entire release flow in one step:
+
+```
+/ship                          # Full pipeline (10 steps)
+/ship --skip-tests             # Skip test step
+/ship --draft                  # Create draft PR
+/ship --patch                  # Force patch version bump
+/ship --minor                  # Force minor version bump
+/ship --major                  # Force major version bump
+/ship --no-version             # Skip version bumping
+/ship -m "feat: add auth"     # Pre-set commit message
+```
+
+Pipeline: **Preflight → Review → Tests → Lint → Branch → Version → Commit → PR → CI → Merge & Release**
+
+Each step is interactive — Coco asks before proceeding when decisions are needed. Press `Ctrl+C` at any point to cancel safely.
+
+---
+
 ## What Coco Does Well
 
 ### Quality Convergence Loop
@@ -66,7 +116,14 @@ Coco doesn't just generate code — it iterates until quality converges:
 | 3 | 84 | Security patched, coverage improved to 82% |
 | 4 | 91 | All green — quality converged ✅ |
 
-The loop is configurable: target score, max iterations, convergence threshold, security requirements. You control the bar.
+The quality bar is yours to set:
+
+```bash
+coco build --min-quality 90          # Per-run override
+coco config set quality.minScore 90  # Persist in project config
+```
+
+Default is **85** (senior-level). You can also configure max iterations, convergence threshold, coverage targets, and security requirements — see `coco config init`.
 
 ### 12-Dimension Quality Scoring
 
@@ -96,10 +153,10 @@ Bring your own API keys. Coco works with:
 | Provider | Auth | Models |
 |----------|------|--------|
 | **Anthropic** | API key / OAuth PKCE | Claude Opus, Sonnet, Haiku |
-| **OpenAI** | API key | GPT-4o, o1, o3 |
-| **Google** | API key / gcloud ADC | Gemini Pro, Flash |
-| **Ollama** | Local | Any local model |
-| **LM Studio** | Local | Any GGUF model |
+| **OpenAI** | API key | GPT-5.3 Codex, GPT-4.1, o4-mini |
+| **Google** | API key / gcloud ADC | Gemini 3, 2.5 Pro/Flash |
+| **Ollama** | Local | Any local model (8-24GB RAM) |
+| **LM Studio** | Local | Any GGUF model (8-32GB RAM) |
 | **Moonshot** | API key | Kimi models |
 
 ### Multi-Agent Architecture
@@ -120,7 +177,7 @@ Coco picks the right agent for each task automatically. When confidence is low,
 A terminal-first experience with:
 
 - **Ghost-text completion** — Tab to accept inline suggestions
-- **Slash commands** — `/coco`, `/plan`, `/build`, `/diff`, `/commit`, `/help`
+- **Slash commands** — `/ship`, `/review`, `/diff`, `/status`, `/help`, `/compact`, `/clear`
 - **Image paste** — `Ctrl+V` to paste screenshots for visual context
 - **Intent recognition** — Natural language mapped to commands
 - **Context management** — Automatic compaction when context grows large
@@ -194,7 +251,7 @@ src/
 ├── orchestrator/     # Phase coordinator + state recovery
 ├── phases/           # COCO phases (converge/orchestrate/complete/output)
 ├── quality/          # 12 quality analyzers + convergence engine
-├── providers/        # 6 LLM providers + OAuth flows
+├── providers/        # 7 LLM providers + OAuth flows
 ├── tools/            # 20+ tool implementations
 ├── hooks/            # Lifecycle hooks (safety, lint, format, audit)
 ├── mcp/              # MCP server for external integration