npm - @compozy/cli - Versions diffs - 0.1.10 → 0.1.12 - Mend

@compozy/cli 0.1.10 → 0.1.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (2) hide show

package/README.md +261 -89
package/package.json +16 -16

package/README.md CHANGED Viewed

@@ -28,14 +28,16 @@ One CLI to replace scattered prompts, manual task tracking, and copy-paste revie
 ## ✨ Highlights
-- **One command, 40+ agents.** Install bundled skills into Claude Code, Codex, Cursor, Droid, OpenCode, Pi, Gemini, and 40+ other agents and editors with `compozy setup`.
+- **One command, 40+ agents.** Install core workflow skills into Claude Code, Codex, Cursor, Droid, OpenCode, Pi, Gemini, and 40+ other agents and editors with `compozy setup`, plus any setup assets shipped by enabled extensions.
 - **Idea to code in a structured pipeline.** Optional Idea → PRD → TechSpec → Tasks → Execution → Review. Each phase produces plain markdown artifacts that feed into the next. Start from an idea for full research and debate, or jump straight to PRD if you already have a clear scope.
 - **Codebase-aware enrichment.** Tasks aren't generic prompts. Compozy spawns parallel agents to explore your codebase, discover patterns, and ground every task in real project context.
 - **Multi-agent execution.** Run tasks through ACP-capable runtimes like Claude Code, Codex, Cursor, Droid, OpenCode, Pi, or Gemini — just change `--ide`. Concurrent batch processing with configurable timeouts, retries, and exponential backoff, all with a live terminal UI.
+- **Reusable agents.** Package a prompt, runtime defaults, and optional agent-local MCP servers under `.compozy/agents/<name>/`, then run it from `compozy exec --agent <name>` or through nested `run_agent` calls.
 - **Workflow memory between runs.** Agents inherit context from every previous task — decisions, learnings, errors, and handoffs. Two-tier markdown memory with automatic compaction keeps context fresh without manual bookkeeping.
 - **Provider-agnostic reviews.** Fetch review comments from CodeRabbit, GitHub, or run AI-powered reviews internally. All normalize to the same format. Provider threads resolve automatically after fixes.
 - **Markdown everywhere.** PRDs, specs, tasks, reviews, and ADRs are human-readable markdown files. Version-controlled, diffable, editable between steps. No vendor lock-in.
 - **Frontmatter for machine-readable metadata.** Tasks and review issues keep parseable metadata in standard YAML frontmatter instead of custom XML tags.
+- **Executable extensions.** Intercept and modify any pipeline phase with subprocess hooks. Ship custom prompt decorators, lifecycle observers, review providers, and skill packs using the TypeScript or Go SDKs.
 - **Single binary, local-first.** Compiles to one Go binary with zero runtime dependencies. Your code and data stay on your machine.
 - **Embeddable.** Use as a standalone CLI or import as a Go package into your own tools.
@@ -67,25 +69,35 @@ git clone git@github.com:compozy/compozy.git
 cd compozy && make verify && go build ./cmd/compozy
 ```
-Then install bundled skills into your AI agents:
+Then install core skills into your AI agents:
 ```bash
 compozy setup          # interactive — pick agents and skills
 compozy setup --all    # install everything to every detected agent
 ```
+`compozy setup` installs Compozy's core workflow skills plus any setup assets shipped by enabled extensions.
+If you want the optional ideation workflow and council roster, install the first-party `cy-idea-factory` extension first:
+```bash
+compozy ext install --yes compozy/compozy --remote github --ref <tag> --subdir extensions/cy-idea-factory
+compozy ext enable cy-idea-factory
+compozy setup
+```
 Execution runtimes are separate from skill installation. To run `compozy exec`, `compozy start`, or `compozy fix-reviews`, install an ACP-capable runtime or adapter on `PATH` for the `--ide` you choose:
-| Runtime      | `--ide` flag   | Expected ACP command             |
-| ------------ | -------------- | -------------------------------- |
-| Claude Agent | `claude`       | `claude-agent-acp`               |
-| Codex CLI    | `codex`        | `codex-acp`                      |
-| GitHub Copilot CLI | `copilot` | `copilot --acp`                  |
-| Cursor       | `cursor-agent` | `cursor-agent acp`               |
-| Droid        | `droid`        | `droid exec --output-format acp` |
-| OpenCode     | `opencode`     | `opencode acp`                   |
-| pi ACP       | `pi`           | `pi-acp`                         |
-| Gemini CLI   | `gemini`       | `gemini --acp`                   |
+| Runtime            | `--ide` flag   | Expected ACP command             |
+| ------------------ | -------------- | -------------------------------- |
+| Claude Agent       | `claude`       | `claude-agent-acp`               |
+| Codex CLI          | `codex`        | `codex-acp`                      |
+| GitHub Copilot CLI | `copilot`      | `copilot --acp`                  |
+| Cursor             | `cursor-agent` | `cursor-agent acp`               |
+| Droid              | `droid`        | `droid exec --output-format acp` |
+| OpenCode           | `opencode`     | `opencode acp`                   |
+| pi ACP             | `pi`           | `pi-acp`                         |
+| Gemini CLI         | `gemini`       | `gemini --acp`                   |
 When the direct ACP command is not installed, Compozy can also fall back to supported launchers such as `npx @zed-industries/codex-acp` when the launcher is available locally.
@@ -164,6 +176,7 @@ include_resolved = false
 [fetch_reviews]
 provider = "coderabbit"
+nitpicks = false
 ```
 Supported sections:
@@ -173,7 +186,7 @@ Supported sections:
 - `[start]` for `include_completed`
 - `[tasks]` for the allowed task `type` list used by `cy-create-tasks` and `compozy validate-tasks`
 - `[fix_reviews]` for `concurrent`, `batch_size`, and `include_resolved`
-- `[fetch_reviews]` for `provider`
+- `[fetch_reviews]` for `provider` and `nitpicks` (controls CodeRabbit review-body comments; default is enabled when unset)
 Notes:
@@ -183,6 +196,90 @@ Notes:
 - `max_retries` applies to execution-stage ACP failures and inactivity timeouts for `compozy exec`, `compozy start`, and `compozy fix-reviews`.
 - `retry_backoff_multiplier` only increases the next attempt timeout; retries restart immediately and do not add a sleep delay.
+## Reusable Agents
+Reusable agents are flat filesystem bundles discovered from two scopes:
+- workspace: `.compozy/agents/<name>/`
+- global: `~/.compozy/agents/<name>/`
+When the same agent name exists in both places, the workspace directory wins as a whole. Compozy does not merge `AGENT.md` from one scope with `mcp.json` from the other.
+Each agent directory contains:
+- required `AGENT.md` with YAML frontmatter plus a markdown body
+- optional `mcp.json` using the standard top-level `mcpServers` shape
+Agent directory names are the canonical agent ids. They must match `^[a-z][a-z0-9-]{0,63}$`, and `compozy` is reserved.
+Quick start:
+```bash
+compozy agents list
+compozy agents inspect reviewer
+compozy exec --agent reviewer "Review the staged changes"
+```
+Runtime precedence for `compozy exec --agent ...` is:
+```text
+explicit CLI flags > AGENT.md runtime defaults > .compozy/config.toml > built-in defaults
+```
+`mcp.json` is only for agent-local MCP servers. The reserved Compozy MCP server is also named `compozy`, but it is injected by the host and must not appear in `mcp.json`. That reserved server exists only to expose host-owned tools such as `run_agent`. Child agent runs receive the reserved `compozy` server plus the child agent's own `mcp.json`; they do not inherit the parent agent's local MCP servers.
+Use these committed example fixtures as starting points:
+- [`docs/examples/agents/reviewer/AGENT.md`](docs/examples/agents/reviewer/AGENT.md) for a minimal reusable agent
+- [`docs/examples/agents/repo-copilot/AGENT.md`](docs/examples/agents/repo-copilot/AGENT.md) and [`docs/examples/agents/repo-copilot/mcp.json`](docs/examples/agents/repo-copilot/mcp.json) for an agent with external MCP dependencies
+The detailed guide lives in [`docs/reusable-agents.md`](docs/reusable-agents.md).
+## 🔌 Extensions
+Compozy extensions are executable subprocess plugins that intercept and modify pipeline behavior without rebuilding the binary. Extensions communicate with the host over JSON-RPC 2.0 on stdin/stdout and can observe lifecycle events, mutate prompts, inject plan sources, modify agent sessions, gate retries, ship skill packs, and register review providers.
+### SDK support
+| Language   | Package                                           | Install                                           |
+| ---------- | ------------------------------------------------- | ------------------------------------------------- |
+| TypeScript | [`@compozy/extension-sdk`](sdk/extension-sdk-ts/) | `npm install @compozy/extension-sdk`              |
+| Go         | [`sdk/extension`](sdk/extension/)                 | `go get github.com/compozy/compozy/sdk/extension` |
+Scaffold a new extension project with starter templates:
+```bash
+npx @compozy/create-extension my-ext
+npx @compozy/create-extension my-ext --template prompt-decorator
+npx @compozy/create-extension my-ext --runtime go
+```
+Available templates: `lifecycle-observer`, `prompt-decorator`, `review-provider`, `skill-pack`.
+### Extension CLI
+```bash
+compozy ext list                   # discover extensions across all scopes
+compozy ext inspect <name>         # show manifest, capabilities, enablement status
+compozy ext install <source>       # install from a local path or GitHub repo archive
+compozy ext uninstall <name>       # remove a user-scoped extension
+compozy ext enable <name>          # enable on this machine
+compozy ext disable <name>         # disable on this machine
+compozy ext doctor                 # validate manifests and report health warnings
+```
+Extensions are discovered from three scopes with workspace > user > bundled precedence. User and workspace extensions start disabled and must be explicitly enabled by the local operator.
+### Learn more
+- [Extension author guide](.compozy/docs/extensibility/index.md)
+- [Architecture overview](.compozy/docs/extensibility/architecture.md)
+- [Hook reference](.compozy/docs/extensibility/hook-reference.md) -- 28 hooks across 6 pipeline phases
+- [Host API reference](.compozy/docs/extensibility/host-api-reference.md) -- 11 typed host methods
+- [Capability reference](.compozy/docs/extensibility/capability-reference.md) -- 19 capability grants
+- [Trust and enablement](.compozy/docs/extensibility/trust-and-enablement.md)
+- [Testing guide](.compozy/docs/extensibility/testing.md)
 ## ⚡ Ad Hoc Exec
 Use `compozy exec` when you want one prompt through the same ACP-backed execution stack without creating a full workflow first.
@@ -235,13 +332,21 @@ This walkthrough builds a feature called **user-auth** from idea to shipped code
 compozy setup
 ```
-Auto-detects installed agents and copies (or symlinks) skills into their configuration directories.
+Auto-detects installed agents, copies (or symlinks) core skills into their configuration directories, and installs setup assets shipped by enabled extensions.
 `compozy start` and `compozy fix-reviews` now verify that bundled Compozy skills are installed for the selected agent before running. Missing installs block the run, and outdated installs prompt for refresh in interactive terminals.
 ### 2. (Optional) Create an Issue
 Inside your AI agent (Claude Code, Codex, Cursor, OpenCode, Pi, etc.):
+```bash
+compozy ext install --yes compozy/compozy --remote github --ref <tag> --subdir extensions/cy-idea-factory
+compozy ext enable cy-idea-factory
+compozy setup
+```
+Then:
 ```
 /cy-idea-factory user-auth
 ```
@@ -312,11 +417,10 @@ Repeat steps 7–8. Each cycle creates a new review round (`reviews-002/`, `revi
 ## 🧩 Skills
-Compozy bundles 9 skills that its workflows depend on. They run inside your AI agent — no context switching to external tools.
+Compozy bundles 9 core skills that its workflows depend on. They run inside your AI agent — no context switching to external tools.
 | Skill                | Purpose                                                                    |
 | -------------------- | -------------------------------------------------------------------------- |
-| `cy-idea-factory`    | Raw idea → structured idea spec with market research, business analysis, and council debate |
 | `cy-create-prd`      | Idea → Product Requirements Document with ADRs                             |
 | `cy-create-techspec` | PRD → Technical Specification with architecture exploration                |
 | `cy-create-tasks`    | PRD + TechSpec → Independently implementable task files                    |
@@ -326,6 +430,20 @@ Compozy bundles 9 skills that its workflows depend on. They run inside your AI a
 | `cy-fix-reviews`     | Triage, fix, verify, and resolve review issues                             |
 | `cy-final-verify`    | Enforces verification evidence before any completion claim                 |
+Optional first-party extension skills:
+| Skill             | Purpose                                                                                     |
+| ----------------- | ------------------------------------------------------------------------------------------- |
+| `cy-idea-factory` | Raw idea → structured idea spec with market research, business analysis, and council debate |
+Install the optional ideation extension with:
+```bash
+compozy ext install --yes compozy/compozy --remote github --ref <tag> --subdir extensions/cy-idea-factory
+compozy ext enable cy-idea-factory
+compozy setup
+```
 ### 🧠 Workflow Memory
 When agents execute tasks, context gets lost between runs — decisions made, errors hit, patterns discovered. Compozy solves this with a two-tier memory system that gives each agent a running history of the workflow.
@@ -355,18 +473,18 @@ The `cy-workflow-memory` skill handles all of this automatically when referenced
 **Execution** (`compozy exec`, `compozy start`, `compozy fix-reviews`) — ACP-capable runtimes that can run ad hoc prompts and task workflows:
-| Agent       | `--ide` flag   |
-| ----------- | -------------- |
-| Claude Code | `claude`       |
-| Codex       | `codex`        |
-| GitHub Copilot | `copilot`    |
-| Cursor      | `cursor-agent` |
-| Droid       | `droid`        |
-| OpenCode    | `opencode`     |
-| Pi          | `pi`           |
-| Gemini      | `gemini`       |
+| Agent          | `--ide` flag   |
+| -------------- | -------------- |
+| Claude Code    | `claude`       |
+| Codex          | `codex`        |
+| GitHub Copilot | `copilot`      |
+| Cursor         | `cursor-agent` |
+| Droid          | `droid`        |
+| OpenCode       | `opencode`     |
+| Pi             | `pi`           |
+| Gemini         | `gemini`       |
-**Skill installation** (`compozy setup`) — 40+ agents and editors, including Claude Code, Codex, Cursor, Droid, OpenCode, Pi, Gemini CLI, GitHub Copilot, Windsurf, Amp, Continue, Goose, Roo Code, Augment, Kiro CLI, Cline, and many more. Run `compozy setup` to see all detected agents on your system.
+**Skill installation** (`compozy setup`) — 40+ agents and editors, including Claude Code, Codex, Cursor, Droid, OpenCode, Pi, Gemini CLI, GitHub Copilot, Windsurf, Amp, Continue, Goose, Roo Code, Augment, Kiro CLI, Cline, and many more. `compozy setup` installs core workflow skills plus any setup assets shipped by enabled extensions. Run `compozy setup` to see all detected agents on your system.
 When installing to multiple agents, Compozy offers two modes:
@@ -376,21 +494,21 @@ When installing to multiple agents, Compozy offers two modes:
 ## 📖 CLI Reference
 <details>
-<summary><code>compozy setup</code> — Install bundled skills for supported agents</summary>
+<summary><code>compozy setup</code> — Install core skills and enabled extension assets</summary>
 ```bash
 compozy setup [flags]
 ```
-| Flag             | Default | Description                                  |
-| ---------------- | ------- | -------------------------------------------- |
-| `--agent`, `-a`  |         | Target agent name (repeatable)               |
-| `--skill`, `-s`  |         | Skill name to install (repeatable)           |
-| `--global`, `-g` | `false` | Install to user directory instead of project |
-| `--copy`         | `false` | Copy files instead of symlinking             |
-| `--list`, `-l`   | `false` | List bundled skills without installing       |
-| `--yes`, `-y`    | `false` | Skip confirmation prompts                    |
-| `--all`          | `false` | Install all skills to all agents             |
+| Flag             | Default | Description                                                      |
+| ---------------- | ------- | ---------------------------------------------------------------- |
+| `--agent`, `-a`  |         | Target agent name (repeatable)                                   |
+| `--skill`, `-s`  |         | Skill name to install (repeatable)                               |
+| `--global`, `-g` | `false` | Install to user directory instead of project                     |
+| `--copy`         | `false` | Copy files instead of symlinking                                 |
+| `--list`, `-l`   | `false` | List core skills and enabled extension assets without installing |
+| `--yes`, `-y`    | `false` | Skip confirmation prompts                                        |
+| `--all`          | `false` | Install all skills to all agents                                 |
 </details>
@@ -450,23 +568,67 @@ compozy exec [prompt] [flags]
 Provide exactly one prompt source: a positional prompt, `--prompt-file`, or `stdin`. When present, `.compozy/config.toml` can provide exec defaults through `[exec]` and shared runtime defaults through `[defaults]`.
-`compozy exec` is headless and ephemeral by default. Use `--persist` to create `.compozy/runs/<run-id>/` for resumable sessions, `--run-id` to continue a persisted session, `--format json` for JSONL, and `--tui` to opt back into the interactive UI.
+`compozy exec` is headless and ephemeral by default. Use `--agent <name>` to execute a reusable agent from `.compozy/agents/` or `~/.compozy/agents/`, `--persist` to create `.compozy/runs/<run-id>/` for resumable sessions, `--run-id` to continue a persisted session, `--format json` for lean JSONL, `--format raw-json` for the full raw event stream, and `--tui` to opt back into the interactive UI.
-| Flag                         | Default     | Description                                                                 |
-| ---------------------------- | ----------- | --------------------------------------------------------------------------- |
+| Flag                         | Default     | Description                                                                                |
+| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------ |
 | `--ide`                      | `codex`     | Runtime: `claude`, `codex`, `copilot`, `cursor-agent`, `droid`, `gemini`, `opencode`, `pi` |
-| `--model`                    | _(per IDE)_ | Model override                                                              |
-| `--prompt-file`              |             | Read prompt text from a file                                                |
-| `--format`                   | `text`      | Output contract: `text` or `json`                                           |
-| `--reasoning-effort`         | `medium`    | `low`, `medium`, `high`, `xhigh`                                            |
-| `--access-mode`              | `full`      | `default` or `full` runtime access policy                                   |
-| `--timeout`                  | `10m`       | Activity timeout per job                                                    |
-| `--max-retries`              | `0`         | Retry execution-stage ACP failures or timeouts N times                      |
-| `--retry-backoff-multiplier` | `1.5`       | Multiplier applied to the next timeout after each retry                     |
-| `--tail-lines`               | `0`         | Maximum log lines retained per job in UI (`0` = full history)               |
-| `--add-dir`                  |             | Additional directories to allow (repeatable; currently `claude` and `codex` only) |
-| `--auto-commit`              | `false`     | Include automatic commit instructions when the prompt asks for code changes |
-| `--dry-run`                  | `false`     | Preview prompts without executing                                           |
+| `--model`                    | _(per IDE)_ | Model override                                                                             |
+| `--agent`                    |             | Reusable agent to execute from `.compozy/agents/` or `~/.compozy/agents/`                  |
+| `--prompt-file`              |             | Read prompt text from a file                                                               |
+| `--format`                   | `text`      | Output contract: `text`, `json`, or `raw-json`                                             |
+| `--reasoning-effort`         | `medium`    | `low`, `medium`, `high`, `xhigh`                                                           |
+| `--access-mode`              | `full`      | `default` or `full` runtime access policy                                                  |
+| `--timeout`                  | `10m`       | Activity timeout per job                                                                   |
+| `--max-retries`              | `0`         | Retry execution-stage ACP failures or timeouts N times                                     |
+| `--retry-backoff-multiplier` | `1.5`       | Multiplier applied to the next timeout after each retry                                    |
+| `--tail-lines`               | `0`         | Maximum log lines retained per job in UI (`0` = full history)                              |
+| `--add-dir`                  |             | Additional directories to allow (repeatable; currently `claude` and `codex` only)          |
+| `--auto-commit`              | `false`     | Include automatic commit instructions when the prompt asks for code changes                |
+| `--verbose`                  | `false`     | Emit operational runtime logs to stderr during exec                                        |
+| `--tui`                      | `false`     | Open the interactive TUI instead of headless stdout output                                 |
+| `--persist`                  | `false`     | Persist exec artifacts under `.compozy/runs/<run-id>/`                                     |
+| `--run-id`                   |             | Resume a previously persisted exec session by run id                                       |
+| `--dry-run`                  | `false`     | Preview prompts without executing                                                          |
+</details>
+<details>
+<summary><code>compozy agents</code> — Discover and inspect reusable agents</summary>
+```bash
+compozy agents list
+compozy agents inspect <name>
+```
+`compozy agents list` prints resolved agents from workspace and global scope, then reports any invalid definitions without hiding the valid ones. `compozy agents inspect <name>` prints the resolved source, runtime defaults, MCP summary, and validation status for one agent. Invalid inspections print the validation report first and then exit non-zero.
+Examples:
+```bash
+compozy agents list
+compozy agents inspect reviewer
+compozy agents inspect repo-copilot
+```
+</details>
+<details>
+<summary><code>compozy ext</code> — Manage executable extensions</summary>
+```bash
+compozy ext <subcommand> [flags]
+```
+| Subcommand             | Description                                        |
+| ---------------------- | -------------------------------------------------- |
+| `ext list`             | List discovered extensions across all scopes       |
+| `ext inspect <name>`   | Show manifest, capabilities, and enablement status |
+| `ext install <path>`   | Install an extension into the user scope           |
+| `ext uninstall <name>` | Remove a user-scoped extension                     |
+| `ext enable <name>`    | Enable an extension on this machine                |
+| `ext disable <name>`   | Disable an extension on this machine               |
+| `ext doctor`           | Validate manifests and report health warnings      |
 </details>
@@ -481,22 +643,22 @@ Running `compozy start` with no flags opens the interactive form automatically.
 When present, `.compozy/config.toml` can provide defaults for runtime flags such as
 `--ide`, `--model`, `--reasoning-effort`, `--access-mode`, `--timeout`, `--add-dir`, and `--auto-commit`.
-| Flag                         | Default     | Description                                                   |
-| ---------------------------- | ----------- | ------------------------------------------------------------- |
-| `--name`                     |             | Workflow name (`.compozy/tasks/<name>`)                       |
-| `--tasks-dir`                |             | Path to tasks directory                                       |
+| Flag                         | Default     | Description                                                                                |
+| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------ |
+| `--name`                     |             | Workflow name (`.compozy/tasks/<name>`)                                                    |
+| `--tasks-dir`                |             | Path to tasks directory                                                                    |
 | `--ide`                      | `codex`     | Runtime: `claude`, `codex`, `copilot`, `cursor-agent`, `droid`, `gemini`, `opencode`, `pi` |
-| `--model`                    | _(per IDE)_ | Model override                                                |
-| `--reasoning-effort`         | `medium`    | `low`, `medium`, `high`, `xhigh`                              |
-| `--access-mode`              | `full`      | `default` or `full` runtime access policy                     |
-| `--timeout`                  | `10m`       | Activity timeout per job                                      |
-| `--max-retries`              | `0`         | Retry execution-stage ACP failures or timeouts N times        |
-| `--retry-backoff-multiplier` | `1.5`       | Multiplier applied to the next timeout after each retry       |
-| `--tail-lines`               | `0`         | Maximum log lines retained per job in UI (`0` = full history) |
-| `--add-dir`                  |             | Additional directories to allow (repeatable; currently `claude` and `codex` only) |
-| `--auto-commit`              | `false`     | Auto-commit after each task                                   |
-| `--include-completed`        | `false`     | Re-run completed tasks                                        |
-| `--dry-run`                  | `false`     | Preview prompts without executing                             |
+| `--model`                    | _(per IDE)_ | Model override                                                                             |
+| `--reasoning-effort`         | `medium`    | `low`, `medium`, `high`, `xhigh`                                                           |
+| `--access-mode`              | `full`      | `default` or `full` runtime access policy                                                  |
+| `--timeout`                  | `10m`       | Activity timeout per job                                                                   |
+| `--max-retries`              | `0`         | Retry execution-stage ACP failures or timeouts N times                                     |
+| `--retry-backoff-multiplier` | `1.5`       | Multiplier applied to the next timeout after each retry                                    |
+| `--tail-lines`               | `0`         | Maximum log lines retained per job in UI (`0` = full history)                              |
+| `--add-dir`                  |             | Additional directories to allow (repeatable; currently `claude` and `codex` only)          |
+| `--auto-commit`              | `false`     | Auto-commit after each task                                                                |
+| `--include-completed`        | `false`     | Re-run completed tasks                                                                     |
+| `--dry-run`                  | `false`     | Preview prompts without executing                                                          |
 </details>
@@ -508,7 +670,7 @@ compozy fetch-reviews [flags]
 ```
 Running `compozy fetch-reviews` with no flags opens the interactive form automatically.
-When present, `.compozy/config.toml` can provide defaults such as `--provider`.
+When present, `.compozy/config.toml` can provide defaults such as `provider` and `nitpicks`.
 | Flag         | Default | Description                               |
 | ------------ | ------- | ----------------------------------------- |
@@ -517,6 +679,9 @@ When present, `.compozy/config.toml` can provide defaults such as `--provider`.
 | `--name`     |         | Workflow name                             |
 | `--round`    | `0`     | Round number (auto-increments if omitted) |
+By default, `fetch-reviews` imports CodeRabbit review-body comments for `nitpick`, `minor`, and `major`.
+Use `[fetch_reviews].nitpicks = false` in `.compozy/config.toml` to disable that import.
 </details>
 <details>
@@ -530,25 +695,25 @@ Running `compozy fix-reviews` with no flags opens the interactive form automatic
 When present, `.compozy/config.toml` can provide runtime defaults as well as review workflow
 defaults such as `--concurrent`, `--batch-size`, and `--include-resolved`.
-| Flag                         | Default     | Description                                                   |
-| ---------------------------- | ----------- | ------------------------------------------------------------- |
-| `--name`                     |             | Workflow name                                                 |
-| `--round`                    | `0`         | Round number (latest if omitted)                              |
-| `--reviews-dir`              |             | Override review directory path                                |
+| Flag                         | Default     | Description                                                                                |
+| ---------------------------- | ----------- | ------------------------------------------------------------------------------------------ |
+| `--name`                     |             | Workflow name                                                                              |
+| `--round`                    | `0`         | Round number (latest if omitted)                                                           |
+| `--reviews-dir`              |             | Override review directory path                                                             |
 | `--ide`                      | `codex`     | Runtime: `claude`, `codex`, `copilot`, `cursor-agent`, `droid`, `gemini`, `opencode`, `pi` |
-| `--model`                    | _(per IDE)_ | Model override                                                |
-| `--batch-size`               | `1`         | Issues per batch                                              |
-| `--concurrent`               | `1`         | Parallel batches                                              |
-| `--include-resolved`         | `false`     | Re-process resolved issues                                    |
-| `--reasoning-effort`         | `medium`    | `low`, `medium`, `high`, `xhigh`                              |
-| `--access-mode`              | `full`      | `default` or `full` runtime access policy                     |
-| `--timeout`                  | `10m`       | Activity timeout per job                                      |
-| `--max-retries`              | `0`         | Retry execution-stage ACP failures or timeouts N times        |
-| `--retry-backoff-multiplier` | `1.5`       | Multiplier applied to the next timeout after each retry       |
-| `--tail-lines`               | `0`         | Maximum log lines retained per job in UI (`0` = full history) |
-| `--add-dir`                  |             | Additional directories to allow (repeatable; currently `claude` and `codex` only) |
-| `--auto-commit`              | `false`     | Auto-commit after each batch                                  |
-| `--dry-run`                  | `false`     | Preview prompts without executing                             |
+| `--model`                    | _(per IDE)_ | Model override                                                                             |
+| `--batch-size`               | `1`         | Issues per batch                                                                           |
+| `--concurrent`               | `1`         | Parallel batches                                                                           |
+| `--include-resolved`         | `false`     | Re-process resolved issues                                                                 |
+| `--reasoning-effort`         | `medium`    | `low`, `medium`, `high`, `xhigh`                                                           |
+| `--access-mode`              | `full`      | `default` or `full` runtime access policy                                                  |
+| `--timeout`                  | `10m`       | Activity timeout per job                                                                   |
+| `--max-retries`              | `0`         | Retry execution-stage ACP failures or timeouts N times                                     |
+| `--retry-backoff-multiplier` | `1.5`       | Multiplier applied to the next timeout after each retry                                    |
+| `--tail-lines`               | `0`         | Maximum log lines retained per job in UI (`0` = full history)                              |
+| `--add-dir`                  |             | Additional directories to allow (repeatable; currently `claude` and `codex` only)          |
+| `--auto-commit`              | `false`     | Auto-commit after each batch                                                               |
+| `--dry-run`                  | `false`     | Preview prompts without executing                                                          |
 </details>
@@ -584,7 +749,7 @@ _ = compozy.Run(context.Background(), compozy.Config{
 })
 // Embed the Cobra command in another CLI
-root := command.New()
+root := compozy.NewCommand()
 _ = root.Execute()
 ```
@@ -595,19 +760,26 @@ _ = root.Execute()
 ```
 cmd/compozy/             CLI entry point
-command/                 Public Cobra wrapper for embedding
+compozy.go               Public Go API + reusable Cobra command helpers
 internal/cli/            Cobra flags, interactive form, CLI glue
 internal/core/           Internal facade for preparation and execution
   agent/                 IDE command validation and process construction
+  agents/                Reusable agent discovery, validation, MCP merge, nested execution
+  extension/             Extension manifest, discovery, hooks, Host API, lifecycle
   memory/                Workflow memory bootstrapping, inspection, and compaction detection
   model/                 Shared runtime data structures
   plan/                  Input discovery, filtering, grouping, batch prep
   prompt/                Prompt builders emitting runtime context + skill names
   run/                   Execution pipeline, logging, shutdown, Bubble Tea UI
-internal/setup/          Bundled skill installer (agent detection, symlink/copy)
+internal/setup/          Bundled skill and council-agent installer (agent detection, symlink/copy)
 internal/version/        Build metadata
+sdk/extension/           Public Go SDK for extension authors
+sdk/extension-sdk-ts/    Public TypeScript SDK for extension authors
+sdk/create-extension/    CLI scaffolder for new extension projects
 skills/                  Bundled installable skills
 .compozy/config.toml     Optional workspace defaults for CLI execution
+.compozy/agents/         Optional reusable agents (`AGENT.md` + optional `mcp.json`)
+.compozy/extensions/     Workspace-scoped extensions (starts disabled)
 .compozy/runs/           Runtime artifacts for persisted executions and resumable exec sessions
 .compozy/tasks/          Default workflow artifact root (PRDs, TechSpecs, tasks, ADRs, reviews)
 ```

package/package.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "@compozy/cli",
   "type": "module",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Compozy CLI",
   "scripts": {
     "postinstall": "node install.js",
@@ -27,63 +27,63 @@
   },
   "archives": {
     "darwin-arm64": {
-      "name": "compozy_0.1.10_darwin_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.10/compozy_0.1.10_darwin_arm64.tar.gz",
+      "name": "compozy_0.1.12_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.12/compozy_0.1.12_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "11775673564a54314065ea8307d5ce1f1b187f2322d7428b4bd5f5a97228f196"
+        "digest": "e5d39be82563b5265e83a2605216d0e865652b22f72be5f7d7094d5bca956094"
       }
     },
     "darwin-x64": {
-      "name": "compozy_0.1.10_darwin_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.10/compozy_0.1.10_darwin_x86_64.tar.gz",
+      "name": "compozy_0.1.12_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.12/compozy_0.1.12_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "cacb8818efccc7f03e53d584747056ce1e682c6f78221a05ba67769d6a603204"
+        "digest": "ec54dcecad2f7cf3ae9a17505e23b289fca60999670518d7680d95d89255f844"
       }
     },
     "linux-arm64": {
-      "name": "compozy_0.1.10_linux_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.10/compozy_0.1.10_linux_arm64.tar.gz",
+      "name": "compozy_0.1.12_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.12/compozy_0.1.12_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "a89a221bb2385456d6de1a7830c7023d6d9c94cb0be9dc4c02d3fe801f198e4f"
+        "digest": "996c83d0c0aac3b15c12cb031fb5db892db6d0a78c625544d993287287824b86"
       }
     },
     "linux-x64": {
-      "name": "compozy_0.1.10_linux_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.10/compozy_0.1.10_linux_x86_64.tar.gz",
+      "name": "compozy_0.1.12_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.12/compozy_0.1.12_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "3915ad13f8ebd5d0176927130878f77fe87302989dcbbcfdf3e560b86dd75c19"
+        "digest": "2f52d658cfe8926d35c60df757f02afd5fac79e9aa39c6535c7af593c61d9d7b"
       }
     },
     "win32-x64": {
-      "name": "compozy_0.1.10_windows_x86_64.zip",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.10/compozy_0.1.10_windows_x86_64.zip",
+      "name": "compozy_0.1.12_windows_x86_64.zip",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.12/compozy_0.1.12_windows_x86_64.zip",
       "bins": [
         "compozy.exe"
       ],
       "format": "zip",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "72f4d3ce6caa32aca4fb09f5a5803968de6a514553266cfe0948ca370d51dd00"
+        "digest": "2688812133944d61987332c46a98cf504ebc5c84896008762fdc2ff6615197be"
       }
     }
   }