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

@compozy/cli 0.1.12 → 0.2.1

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 +148 -132
package/package.json +19 -19

package/README.md CHANGED Viewed

@@ -86,7 +86,7 @@ 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:
+Execution runtimes are separate from skill installation. To run `compozy exec`, `compozy tasks run`, or `compozy reviews fix`, install an ACP-capable runtime or adapter on `PATH` for the `--ide` you choose:
 | Runtime            | `--ide` flag   | Expected ACP command             |
 | ------------------ | -------------- | -------------------------------- |
@@ -99,19 +99,27 @@ Execution runtimes are separate from skill installation. To run `compozy exec`,
 | 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.
+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. Codex defaults to `gpt-5.5`; using that model with a local `codex-acp` binary requires `@zed-industries/codex-acp >= 0.12.0`. Update with `npm install -g @zed-industries/codex-acp@latest`, or explicitly choose a model supported by your installed adapter.
 ## 🔄 How It Works
 <div align="center">
-  <img src="imgs/how-it-works-flow.png" alt="Compozy workflow from setup to ship with markdown artifacts at each step" width="100%">
+  <img src="imgs/how-it-works-flow.png" alt="Compozy daemon-first workflow showing workspace artifacts, daemon runtime, and persisted run state" width="100%">
 </div>
 Workflow artifacts stay in `.compozy/tasks/<name>/`. These are the PRDs, TechSpecs, ADRs, tasks, reviews, and memory files that you read and edit between steps.
-`compozy start` and `compozy fix-reviews` write runtime artifacts under `.compozy/runs/<run-id>/`. `compozy exec` is ephemeral by default and only writes resumable artifacts when `--persist` is enabled.
+The daemon owns runtime state under `~/.compozy/`. Daemon-managed task runs, review-fix runs, and persisted exec sessions allocate `~/.compozy/runs/<run-id>/`, while attach and watch clients reconnect through daemon snapshots and streams instead of reading workspace-local run files directly.
-Task and review issue files use YAML frontmatter for parseable metadata such as `status`, `title`, `type`, `severity`, and `provider_ref`. Task workflow `_meta.md` files can be refreshed explicitly with `compozy sync`. Fully completed workflows can be moved out of the active task root with `compozy archive`. If you have an older project with XML-tagged artifacts, run `compozy migrate` once before using `start` or `fix-reviews`.
+Task and review issue files use YAML frontmatter for parseable metadata such as `status`, `title`, `type`, `severity`, and `provider_ref`. `compozy sync` now reconciles authored workflow artifacts into the daemon `global.db` catalog and performs one-time cleanup for legacy generated `_meta.md` / `_tasks.md` artifacts when they are encountered. `compozy archive` moves completed workflows only after synced daemon state says they are eligible. If you have an older project with XML-tagged artifacts, run `compozy migrate` once before using daemon-backed workflow commands.
+### Daemon Runtime Model
+- `compozy daemon start|status|stop` manages the home-scoped daemon lifecycle. `daemon start` is idempotent, and task/review/exec commands auto-start the daemon when needed.
+- `compozy workspaces list|show|register|unregister|resolve` exposes the daemon workspace registry. Workspaces are also lazily registered when you run daemon-backed commands inside them.
+- `compozy tasks run <slug>` is the canonical workflow runner. In interactive terminals it attaches to the TUI by default; in non-interactive environments it falls back to streaming. Use `--ui`, `--stream`, `--detach`, or `--attach` to override that behavior.
+- `compozy runs attach <run-id>` restores the interactive TUI for an existing daemon-managed run, while `compozy runs watch <run-id>` streams textual observation from the same snapshot-plus-stream transport.
+- `compozy reviews fetch|list|show|fix` is the canonical review command family.
 ### Task Schema v2
@@ -120,7 +128,7 @@ Task files now use the v2 frontmatter shape: `status`, `title`, `type`, `complex
 ```md
 ---
 status: pending
-title: Add validate-tasks preflight to start
+title: Add task validation preflight to tasks run
 type: backend
 complexity: medium
 dependencies:
@@ -128,21 +136,21 @@ dependencies:
 ---
 ```
-Validate task files at any time with `compozy validate-tasks --name <feature>`. `compozy start` runs the same preflight automatically; use `--skip-validation` only when tasks were validated elsewhere, or `--force` to continue after validation failures in non-interactive runs.
+Validate task files at any time with `compozy tasks validate --name <feature>`. `compozy tasks run <feature>` runs the same preflight automatically; use `--skip-validation` only when tasks were validated elsewhere, or `--force` to continue after validation failures in non-interactive runs.
-## ⚙️ Workspace Config
+## ⚙️ Config Files
-Compozy can load project defaults from `.compozy/config.toml`.
+Compozy can load global defaults from `~/.compozy/config.toml` and override them per workspace with `.compozy/config.toml`.
 - The CLI discovers the nearest `.compozy/` directory by walking upward from the current working directory.
-- If `.compozy/config.toml` exists, Compozy loads it once at command startup.
-- Interactive forms for `compozy start`, `compozy fix-reviews`, and `compozy fetch-reviews` are prefilled from the resolved config.
+- If `~/.compozy/config.toml` exists, Compozy loads it once at command startup.
+- If `.compozy/config.toml` exists in the resolved workspace, it overrides the global config field by field.
 - Explicit CLI flags always win over config values.
 Precedence is:
 ```text
-explicit flags > command section > [defaults] > built-in defaults
+explicit flags > workspace command section > workspace [defaults] > global command section > global [defaults] > built-in defaults
 ```
 Example:
@@ -150,25 +158,25 @@ Example:
 ```toml
 [defaults]
 ide = "codex"
-model = "gpt-5.4"
+model = "gpt-5.5"
 reasoning_effort = "medium"
 access_mode = "full"
 timeout = "10m"
 tail_lines = 0
 add_dirs = ["../shared"]
 auto_commit = false
-max_retries = 0
+max_retries = 2
 retry_backoff_multiplier = 1.5
-[start]
+[tasks]
+types = ["frontend", "backend", "docs", "test", "infra", "refactor", "chore", "bugfix"]
+[tasks.run]
 include_completed = false
 [exec]
 output_format = "text"
-[tasks]
-types = ["frontend", "backend", "docs", "test", "infra", "refactor", "chore", "bugfix"]
 [fix_reviews]
 concurrent = 2
 batch_size = 3
@@ -183,17 +191,20 @@ Supported sections:
 - `[defaults]` for shared execution defaults such as `ide`, `model`, `reasoning_effort`, `access_mode`, `timeout`, `tail_lines`, `add_dirs`, `auto_commit`, `max_retries`, and `retry_backoff_multiplier`
 - `[exec]` for `output_format` plus exec-specific runtime overrides such as `ide`, `model`, `reasoning_effort`, `access_mode`, `timeout`, `tail_lines`, `add_dirs`, `max_retries`, and `retry_backoff_multiplier`
-- `[start]` for `include_completed`
-- `[tasks]` for the allowed task `type` list used by `cy-create-tasks` and `compozy validate-tasks`
+- `[tasks]` for the allowed task `type` list used by `cy-create-tasks` and `compozy tasks validate`
+- `[tasks.run]` for workflow-run defaults used by `compozy tasks run`, such as `include_completed`
 - `[fix_reviews]` for `concurrent`, `batch_size`, and `include_resolved`
 - `[fetch_reviews]` for `provider` and `nitpicks` (controls CodeRabbit review-body comments; default is enabled when unset)
+- `[sound]` for optional run-completion audio presets or absolute file paths
 Notes:
-- `.compozy/config.toml` is optional. If it is absent, Compozy keeps the current built-in defaults.
+- Both `~/.compozy/config.toml` and `.compozy/config.toml` are optional. If both are absent, Compozy keeps the current built-in defaults.
 - `.compozy/tasks` remains the fixed workflow root in this version; the config file does not change the workflow root path.
 - Unknown keys and invalid value types are rejected during config loading.
-- `max_retries` applies to execution-stage ACP failures and inactivity timeouts for `compozy exec`, `compozy start`, and `compozy fix-reviews`.
+- Relative `add_dirs` are resolved against the owning config scope: the user home directory for `~/.compozy/config.toml` and the workspace root for `.compozy/config.toml`.
+- `max_retries` applies to execution-stage ACP failures and inactivity timeouts for `compozy exec`, `compozy tasks run`, and `compozy reviews fix`.
+- Built-in CLI defaults retry timed-out or transient ACP failures twice; set `max_retries = 0` or pass `--max-retries 0` to opt out.
 - `retry_backoff_multiplier` only increases the next attempt timeout; retries restart immediately and do not add a sleep delay.
 ## Reusable Agents
@@ -223,7 +234,7 @@ 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
+explicit CLI flags > AGENT.md runtime defaults > workspace/global config > 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.
@@ -274,7 +285,7 @@ Extensions are discovered from three scopes with workspace > user > bundled prec
 - [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
+- [Hook reference](.compozy/docs/extensibility/hook-reference.md) -- 32 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)
@@ -304,23 +315,24 @@ Output modes:
 - `--format text` is headless by default and writes only the final assistant response to stdout
 - `--format json` streams the lean JSONL contract to stdout and filters ACP metadata that is mostly useful for debugging
 - `--format raw-json` streams the full raw JSONL event trace to stdout
-- when `--persist` is enabled, `.compozy/runs/<run-id>/events.jsonl` always stores the full raw event stream regardless of the selected stdout format
+- when `--persist` is enabled, `~/.compozy/runs/<run-id>/events.jsonl` always stores the full raw event stream regardless of the selected stdout format
 - operational ACP/runtime logs stay silent by default; use `--verbose` when you want lifecycle logs on stderr
 - `--tui` opts back into the Bubble Tea interface for interactive inspection
-- `--persist` stores a resumable conversation under `.compozy/runs/<run-id>/`
+- `--persist` stores a resumable conversation under `~/.compozy/runs/<run-id>/`
 - `--run-id` loads a previously persisted ACP session and appends a new turn
 Persisted `exec` runs use this layout:
 ```text
-.compozy/runs/<run-id>/run.json
-.compozy/runs/<run-id>/events.jsonl
-.compozy/runs/<run-id>/turns/0001/prompt.md
-.compozy/runs/<run-id>/turns/0001/response.txt
-.compozy/runs/<run-id>/turns/0001/result.json
+~/.compozy/runs/<run-id>/run.db
+~/.compozy/runs/<run-id>/run.json
+~/.compozy/runs/<run-id>/events.jsonl
+~/.compozy/runs/<run-id>/turns/0001/prompt.md
+~/.compozy/runs/<run-id>/turns/0001/response.txt
+~/.compozy/runs/<run-id>/turns/0001/result.json
 ```
-`compozy exec` uses the same config merge rule as the rest of the CLI: `flags > [exec] > [defaults] > built-in defaults`.
+`compozy exec` uses the same config merge rule as the rest of the CLI: `flags > workspace [exec] > workspace [defaults] > global [exec] > global [defaults] > built-in defaults`.
 ## 🚀 Quick Start
@@ -333,7 +345,7 @@ compozy setup
 ```
 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.
+`compozy tasks run` and `compozy reviews fix` 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
@@ -376,16 +388,16 @@ Reads your PRD, explores the codebase architecture, asks technical clarification
 ```
 Analyzes both documents, explores your codebase for relevant files and patterns, produces individually executable task files with status tracking, context, and acceptance criteria.
-Generated task files use task schema v2 (`status`, `title`, `type`, `complexity`, `dependencies`). Validate them any time with `compozy validate-tasks --name user-auth`.
+Generated task files use task schema v2 (`status`, `title`, `type`, `complexity`, `dependencies`). Validate them any time with `compozy tasks validate --name user-auth`.
 ### 6. Execute tasks
 ```bash
-compozy start --name user-auth --ide claude
+compozy tasks run user-auth --ide claude
 ```
-Each pending task is processed sequentially — the agent reads the spec, implements the code, validates it, and updates the task status. Use `--dry-run` to preview prompts without executing.
-`compozy start` validates task metadata before execution. Use `--skip-validation` when validation already ran elsewhere, or `--force` to continue after validation failures in non-interactive environments.
+Each pending task is processed sequentially through the shared daemon — the agent reads the spec, implements the code, validates it, and updates the task status. Use `--dry-run` to preview prompts without executing.
+`compozy tasks run` validates task metadata before execution. Use `--skip-validation` when validation already ran elsewhere, or `--force` to continue after validation failures in non-interactive environments.
 ### 7. Review
@@ -398,7 +410,7 @@ Each pending task is processed sequentially — the agent reads the spec, implem
 **Option B** — Fetch from an external provider:
 ```bash
-compozy fetch-reviews --provider coderabbit --pr 42 --name user-auth
+compozy reviews fetch user-auth --provider coderabbit --pr 42
 ```
 Both produce the same output: `.compozy/tasks/user-auth/reviews-001/issue_*.md`
@@ -406,7 +418,7 @@ Both produce the same output: `.compozy/tasks/user-auth/reviews-001/issue_*.md`
 ### 8. Fix review issues
 ```bash
-compozy fix-reviews --name user-auth --ide claude --concurrent 2 --batch-size 3
+compozy reviews fix user-auth --ide claude --concurrent 2 --batch-size 3
 ```
 Agents triage each issue as valid or invalid, implement fixes for valid issues, and update statuses. Provider threads are resolved automatically.
@@ -467,11 +479,11 @@ Every task execution automatically bootstraps two markdown files inside `.compoz
 **No duplication.** Memory files don't copy what's already in the repo, git history, PRD, or task specs. They capture only what would otherwise be lost between runs: the _why_ behind decisions, surprising findings, and context that makes the next agent immediately productive.
-The `cy-workflow-memory` skill handles all of this automatically when referenced in task prompts. No manual setup required — just run `compozy start` and agents inherit context from every previous run.
+The `cy-workflow-memory` skill handles all of this automatically when referenced in task prompts. No manual setup required — run `compozy tasks run <workflow>` and agents inherit context from every previous run.
 ### 🤖 Supported Agents
-**Execution** (`compozy exec`, `compozy start`, `compozy fix-reviews`) — ACP-capable runtimes that can run ad hoc prompts and task workflows:
+**Execution** (`compozy exec`, `compozy tasks run`, `compozy reviews fix`) — ACP-capable runtimes that can run ad hoc prompts and daemon-backed workflow tasks:
 | Agent          | `--ide` flag   |
 | -------------- | -------------- |
@@ -530,7 +542,7 @@ compozy migrate [flags]
 </details>
 <details>
-<summary><code>compozy sync</code> — Refresh task workflow metadata files</summary>
+<summary><code>compozy sync</code> — Reconcile workflow artifacts into daemon state</summary>
 ```bash
 compozy sync [flags]
@@ -544,6 +556,95 @@ compozy sync [flags]
 </details>
+<details>
+<summary><code>compozy daemon</code> — Manage the shared home-scoped daemon</summary>
+```bash
+compozy daemon start
+compozy daemon status
+compozy daemon stop [--force]
+```
+Use `daemon start` for an explicit bootstrap, `daemon status` for health and transport info, and `daemon stop` for graceful shutdown. Most workflow commands auto-start the daemon for you.
+</details>
+<details>
+<summary><code>compozy workspaces</code> — Manage daemon workspace registrations</summary>
+```bash
+compozy workspaces list [--format text|json]
+compozy workspaces show <id-or-path> [--format text|json]
+compozy workspaces register <path> [--name display-name] [--format text|json]
+compozy workspaces unregister <id-or-path> [--format text|json]
+compozy workspaces resolve <path> [--format text|json]
+```
+The daemon lazily registers workspaces on first use, but the `workspaces` family gives operators explicit control over the registry.
+</details>
+<details>
+<summary><code>compozy tasks validate</code> — Validate task metadata before execution</summary>
+```bash
+compozy tasks validate [--name my-feature | --tasks-dir .compozy/tasks/my-feature] [--format text|json]
+```
+Use `tasks validate` to check every `task_*.md` file in a workflow directory against the v2 task metadata schema before you run `tasks run`.
+</details>
+<details>
+<summary><code>compozy tasks run</code> — Start one daemon-backed workflow run</summary>
+```bash
+compozy tasks run <slug> [flags]
+```
+The CLI resolves workspace defaults locally, validates the task metadata, auto-starts the daemon when needed, and then starts the workflow through the daemon transport.
+| Flag                  | Default | Description                                                                         |
+| --------------------- | ------- | ----------------------------------------------------------------------------------- |
+| `--name`              |         | Workflow slug (defaults to the positional slug)                                     |
+| `--include-completed` | `false` | Re-run completed tasks                                                              |
+| `--skip-validation`   | `false` | Skip task metadata preflight; use only when validation already ran elsewhere        |
+| `--force`             | `false` | Continue after task metadata validation fails in non-interactive mode               |
+| `--attach`            | `auto`  | Attach mode: `auto`, `ui`, `stream`, or `detach`                                    |
+| `--ui`                | `false` | Force interactive TUI attach mode                                                   |
+| `--stream`            | `false` | Force textual stream attach mode                                                    |
+| `--detach`            | `false` | Start the run without attaching a client                                            |
+| `--task-runtime`      |         | Per-task runtime override rule (`type=...`, `id=...`, `ide=...`, `model=...`, etc.) |
+</details>
+<details>
+<summary><code>compozy reviews</code> — Inspect and remediate review workflows</summary>
+```bash
+compozy reviews fetch <slug> [--provider coderabbit --pr 42 --round N]
+compozy reviews list <slug>
+compozy reviews show <slug> [round]
+compozy reviews fix <slug> [flags]
+```
+`reviews fetch` imports provider feedback into `.compozy/tasks/<slug>/reviews-NNN/`. `reviews fix` uses the same daemon-backed runtime model as `tasks run`, including `--attach`, `--ui`, `--stream`, and `--detach`.
+</details>
+<details>
+<summary><code>compozy runs</code> — Reattach, observe, and clean daemon-managed runs</summary>
+```bash
+compozy runs attach <run-id>
+compozy runs watch <run-id>
+compozy runs purge
+```
+Use `runs attach` to restore the interactive TUI for an existing run, `runs watch` for textual streaming observation, and `runs purge` to delete terminal run artifacts according to the configured retention policy.
+</details>
 <details>
 <summary><code>compozy archive</code> — Move fully completed workflows into the archive root</summary>
@@ -566,9 +667,9 @@ compozy archive [flags]
 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]`.
+Provide exactly one prompt source: a positional prompt, `--prompt-file`, or `stdin`. When present, `~/.compozy/config.toml` and `.compozy/config.toml` can provide exec defaults through `[exec]` and shared runtime defaults through `[defaults]`.
-`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.
+`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                                                                                |
 | ---------------------------- | ----------- | ------------------------------------------------------------------------------------------ |
@@ -580,14 +681,14 @@ Provide exactly one prompt source: a positional prompt, `--prompt-file`, or `std
 | `--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                                     |
+| `--max-retries`              | `2`         | 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>/`                                     |
+| `--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                                                          |
@@ -632,91 +733,6 @@ compozy ext <subcommand> [flags]
 </details>
-<details>
-<summary><code>compozy start</code> — Execute PRD task files</summary>
-```bash
-compozy start [flags]
-```
-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                                                                    |
-| `--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                                                          |
-</details>
-<details>
-<summary><code>compozy fetch-reviews</code> — Fetch review comments into a review round</summary>
-```bash
-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` and `nitpicks`.
-| Flag         | Default | Description                               |
-| ------------ | ------- | ----------------------------------------- |
-| `--provider` |         | Review provider (`coderabbit`, etc.)      |
-| `--pr`       |         | Pull request number                       |
-| `--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>
-<summary><code>compozy fix-reviews</code> — Dispatch AI agents to remediate review issues</summary>
-```bash
-compozy fix-reviews [flags]
-```
-Running `compozy fix-reviews` with no flags opens the interactive form automatically.
-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                                                             |
-| `--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                                                          |
-</details>
 <details>
 <summary><strong>Go Package Usage</strong> — Use Compozy as a library in your own tools</summary>
@@ -780,7 +796,7 @@ 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/runs/         Home-scoped runtime artifacts for daemon-managed and persisted exec runs
 .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.12",
+  "version": "0.2.1",
   "description": "Compozy CLI",
   "scripts": {
     "postinstall": "node install.js",
@@ -21,69 +21,69 @@
     "compozy": "run-compozy.js"
   },
   "dependencies": {
-    "jszip": "^3.10.1",
-    "proxy-agent": "^7.0.0",
-    "tar": "^7.4.3"
+    "jszip": "3.10.1",
+    "proxy-agent": "8.0.1",
+    "tar": "7.5.13"
   },
   "archives": {
     "darwin-arm64": {
-      "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",
+      "name": "compozy_0.2.1_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.1/compozy_0.2.1_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "e5d39be82563b5265e83a2605216d0e865652b22f72be5f7d7094d5bca956094"
+        "digest": "04e6cad9b5fcaf0c815b81ac89049ba35dce604759d6234d72bc6399a8a39af0"
       }
     },
     "darwin-x64": {
-      "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",
+      "name": "compozy_0.2.1_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.1/compozy_0.2.1_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "ec54dcecad2f7cf3ae9a17505e23b289fca60999670518d7680d95d89255f844"
+        "digest": "7e9eff3703720af238c037148bed84d96d7ae7995b162e09e247e4a9d7386f51"
       }
     },
     "linux-arm64": {
-      "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",
+      "name": "compozy_0.2.1_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.1/compozy_0.2.1_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "996c83d0c0aac3b15c12cb031fb5db892db6d0a78c625544d993287287824b86"
+        "digest": "872c0211c217e61a397bc3435a2a46b7b3822511e5031b8d8cbc511551426563"
       }
     },
     "linux-x64": {
-      "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",
+      "name": "compozy_0.2.1_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.1/compozy_0.2.1_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "2f52d658cfe8926d35c60df757f02afd5fac79e9aa39c6535c7af593c61d9d7b"
+        "digest": "dadef343ec8e1445c833874c7986d5f09641fcf7081931299698ecc0655f791d"
       }
     },
     "win32-x64": {
-      "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",
+      "name": "compozy_0.2.1_windows_x86_64.zip",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.1/compozy_0.2.1_windows_x86_64.zip",
       "bins": [
         "compozy.exe"
       ],
       "format": "zip",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "2688812133944d61987332c46a98cf504ebc5c84896008762fdc2ff6615197be"
+        "digest": "f16cd0affc428a2e38422518af3aaa7e3d14d005a225cc00292b5766343b30af"
       }
     }
   }