@compozy/cli 0.2.4 → 0.2.6

package/README.md

@@ -46,8 +46,7 @@ One CLI to replace scattered prompts, manual task tracking, and copy-paste revie
 #### Homebrew
 
 ```bash
-brew tap compozy/compozy
-brew install --cask compozy
+brew install compozy/compozy/compozy
 ```
 
 #### NPM
@@ -98,6 +97,7 @@ Execution runtimes are separate from skill installation. To run `compozy exec`,
 | OpenCode           | `opencode`     | `opencode acp`                   |
 | pi ACP             | `pi`           | `pi-acp`                         |
 | Gemini CLI         | `gemini`       | `gemini --acp`                   |
+| Kiro CLI           | `kiro`         | `kiro-cli 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. 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.
 
@@ -117,7 +117,8 @@ Task and review issue files use YAML frontmatter for parseable metadata such as
 
 - `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 tasks run <slug>` is the canonical single-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 tasks run --multiple alpha,beta` starts one daemon-owned queue for several task workflows. Use `tasks run --multiple` when the same flags and runtime defaults should apply to an ordered batch; keep using `tasks run <slug>` for one workflow or scripts that expect one run ID per invocation.
 - `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.
 
@@ -173,6 +174,7 @@ types = ["frontend", "backend", "docs", "test", "infra", "refactor", "chore", "b
 
 [tasks.run]
 include_completed = false
+run_multiple_mode = "enqueued"
 
 [exec]
 output_format = "text"
@@ -192,7 +194,7 @@ 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`
 - `[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`
+- `[tasks.run]` for workflow-run defaults used by `compozy tasks run`, such as `include_completed` and `run_multiple_mode`
 - `[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
@@ -203,6 +205,8 @@ Notes:
 - `.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.
 - 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`.
+- `[tasks.run] run_multiple_mode` controls `tasks run --multiple` scheduling. When unset, the built-in default is `"enqueued"`.
+- `run_multiple_mode = "parallel"` is accepted in V1 for forward-compatible config, but Compozy prints a V2 worktree-isolation fallback message and runs the queue in enqueued order. Real parallel multi-run execution waits for git worktree isolation.
 - `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.
@@ -394,10 +398,12 @@ Generated task files use task schema v2 (`status`, `title`, `type`, `complexity`
 
 ```bash
 compozy tasks run user-auth --ide claude
+compozy tasks run --multiple user-auth,cleanup --ide claude
 ```
 
 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.
+Use `compozy tasks run --multiple <slug-a>,<slug-b>` when you want one command to enqueue several workflows with the same runtime flags. The input is one comma-separated slug list; `compozy tasks run <slug>` remains the single-workflow command.
 
 ### 7. Review
 
@@ -607,7 +613,9 @@ The CLI resolves workspace defaults locally, validates the task metadata, auto-s
 | Flag                  | Default | Description                                                                         |
 | --------------------- | ------- | ----------------------------------------------------------------------------------- |
 | `--name`              |         | Workflow slug (defaults to the positional slug)                                     |
+| `--multiple`          |         | Comma-separated workflow slugs to run through one daemon-owned parent queue         |
 | `--include-completed` | `false` | Re-run completed tasks                                                              |
+| `--recursive`, `-r`   | `false` | Discover `task_NNN.md` files in nested subdirectories of the workflow root          |
 | `--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`                                    |
@@ -616,6 +624,31 @@ The CLI resolves workspace defaults locally, validates the task metadata, auto-s
 | `--detach`            | `false` | Start the run without attaching a client                                            |
 | `--task-runtime`      |         | Per-task runtime override rule (`type=...`, `id=...`, `ide=...`, `model=...`, etc.) |
 
+When `--recursive` is set, tasks are grouped by directory (root tasks first, then each subdirectory in alphabetical order, numerically within), and `_`/`.`-prefixed directories, `reviews-*` rounds, `adrs/`, and `memory/` are skipped. The same setting can be persisted as `[tasks.run] recursive = true` in workspace TOML or chosen from the interactive task-runtime form.
+
+Use `tasks run --multiple` when you want to start several task workflows from one invocation with the same runtime flags. Use `tasks run <slug>` when you only need one workflow run, when a script expects a single workflow slug, or when you want the existing single-run command path.
+
+The `--multiple` flag takes one comma-separated slug list:
+
+```bash
+compozy tasks run --multiple alpha,beta --ide codex --model gpt-5.5
+compozy tasks run --multiple alpha,beta --stream
+compozy tasks run --multiple alpha,beta --detach
+```
+
+Scheduling is controlled by `.compozy/config.toml` or `~/.compozy/config.toml`:
+
+```toml
+[tasks.run]
+run_multiple_mode = "enqueued"
+```
+
+`"enqueued"` is the default and runs one child workflow at a time in the requested order. `"parallel"` is also accepted in V1, but Compozy prints a fallback message and still runs the queue as `"enqueued"` until V2 adds git worktree-backed isolation for concurrent agents.
+
+In the TUI, every requested slug has a tab. Queued tabs appear before their child run exists, the running tab shows the familiar task-run surface, and completed, failed, or canceled tabs remain available for inspection. The quit dialog applies to the parent queue: `Close TUI` detaches and leaves the queue running in the daemon, `Stop Run` cancels the parent queue, cancels the active child, and marks queued workflows canceled, and `Cancel` returns to the TUI without changing execution.
+
+The multi-run path uses the same attach and runtime flags as single-run `tasks run`, except `--multiple` cannot be combined with a positional slug or `--name`.
+
 </details>
 
 <details>
@@ -813,6 +846,16 @@ make build     # Compile binary
 make deps      # Tidy and verify modules
 ```
 
+## Star History
+
+<a href="https://www.star-history.com/?repos=compozy%2Fcompozy&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=compozy/compozy&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=compozy/compozy&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=compozy/compozy&type=date&legend=top-left" />
+ </picture>
+</a>
+
 ## 🤝 Contributing
 
 Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@compozy/cli",
   "type": "module",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Compozy CLI",
   "scripts": {
     "postinstall": "node install.js",
@@ -23,67 +23,67 @@
   "dependencies": {
     "jszip": "3.10.1",
     "proxy-agent": "8.0.1",
-    "tar": "7.5.13"
+    "tar": "7.5.15"
   },
   "archives": {
     "darwin-arm64": {
-      "name": "compozy_0.2.4_darwin_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.2.4/compozy_0.2.4_darwin_arm64.tar.gz",
+      "name": "compozy_0.2.6_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.6/compozy_0.2.6_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "42ae57731a7a4823db200b251e76075b9703f5426779f24e7f2cbebdff7422fa"
+        "digest": "9cb53aa427e9fab1d32cb4dd02438e57467b6fc1674cd27aba0ca06447b148b0"
       }
     },
     "darwin-x64": {
-      "name": "compozy_0.2.4_darwin_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.2.4/compozy_0.2.4_darwin_x86_64.tar.gz",
+      "name": "compozy_0.2.6_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.6/compozy_0.2.6_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "6f9da59f625a2f6d270335982880d7fb3ae9c44b7f08bfb29c05d25d369e5b68"
+        "digest": "6e2e57e6bea16cf0b47a47c94b4396acb3ec06e90623ed522e635962a900eafc"
       }
     },
     "linux-arm64": {
-      "name": "compozy_0.2.4_linux_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.2.4/compozy_0.2.4_linux_arm64.tar.gz",
+      "name": "compozy_0.2.6_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.6/compozy_0.2.6_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "9761a47552892672c734b284d3f30c4cec07e1340c1fd06ee7161ab2091fcf06"
+        "digest": "0821a1ba666fb55d1799910ad84d8342838a2f6b3ebba3f6588e8ae3a64fcd7b"
       }
     },
     "linux-x64": {
-      "name": "compozy_0.2.4_linux_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.2.4/compozy_0.2.4_linux_x86_64.tar.gz",
+      "name": "compozy_0.2.6_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.6/compozy_0.2.6_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "01b3dc31a6bcdb17702e803d24cd5337a636871b7813abce73288b811834a4d9"
+        "digest": "ac70c779c404d1d07cb88068892799584f5ca58f7b7699af6d6a4e81d5b458de"
       }
     },
     "win32-x64": {
-      "name": "compozy_0.2.4_windows_x86_64.zip",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.2.4/compozy_0.2.4_windows_x86_64.zip",
+      "name": "compozy_0.2.6_windows_x86_64.zip",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.2.6/compozy_0.2.6_windows_x86_64.zip",
       "bins": [
         "compozy.exe"
       ],
       "format": "zip",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "4f7ff2ffcb816f6fb20b46f2034a1507966d5d91951ba978d8ea7b5a738c40cf"
+        "digest": "c9a954a61cebb4f947098f421c428a887ff2c01a1085e58a5b7a539adf40b4c3"
       }
     }
   }