@compozy/cli 0.1.4 → 0.1.6

package/README.md

@@ -98,6 +98,64 @@ Every artifact is a plain markdown file in `.compozy/tasks/<name>/`. You can rea
 
 Task and review issue files use YAML frontmatter for parseable metadata such as `status`, `domain`, `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`.
 
+## ⚙️ Workspace Config
+
+Compozy can load project defaults from `.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.
+- Explicit CLI flags always win over config values.
+
+Precedence is:
+
+```text
+explicit flags > command section > [defaults] > built-in defaults
+```
+
+Example:
+
+```toml
+[defaults]
+ide = "codex"
+model = "gpt-5.4"
+reasoning_effort = "medium"
+access_mode = "full"
+timeout = "10m"
+tail_lines = 0
+add_dirs = ["../shared"]
+auto_commit = false
+max_retries = 0
+retry_backoff_multiplier = 1.5
+
+[start]
+include_completed = false
+
+[fix_reviews]
+concurrent = 2
+batch_size = 3
+grouped = true
+include_resolved = false
+
+[fetch_reviews]
+provider = "coderabbit"
+```
+
+Supported sections in v1:
+
+- `[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`
+- `[start]` for `include_completed`
+- `[fix_reviews]` for `concurrent`, `batch_size`, `grouped`, and `include_resolved`
+- `[fetch_reviews]` for `provider`
+
+Notes:
+
+- `.compozy/config.toml` is optional. If it is 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 both `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.
+
 ## 🚀 Quick Start
 
 This walkthrough builds a feature called **user-auth** from idea to shipped code.
@@ -109,6 +167,7 @@ compozy setup
 ```
 
 Auto-detects installed agents and copies (or symlinks) skills into their configuration directories.
+`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
 
@@ -318,6 +377,8 @@ 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                                                   |
 | ---------------------------- | ----------- | ------------------------------------------------------------- |
@@ -326,9 +387,10 @@ Running `compozy start` with no flags opens the interactive form automatically.
 | `--ide`                      | `codex`     | Agent: `claude`, `codex`, `cursor`, `droid`, `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 failed jobs N times                                     |
-| `--retry-backoff-multiplier` | `1.5`       | Timeout multiplier per retry                                  |
+| `--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`               | `30`        | Log lines shown per job in UI                                 |
 | `--add-dir`                  |             | Additional directories to allow (repeatable)                  |
 | `--auto-commit`              | `false`     | Auto-commit after each task                                   |
@@ -345,6 +407,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`.
 
 | Flag         | Default | Description                               |
 | ------------ | ------- | ----------------------------------------- |
@@ -363,6 +426,8 @@ 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`, `--grouped`, and `--include-resolved`.
 
 | Flag                         | Default     | Description                                                   |
 | ---------------------------- | ----------- | ------------------------------------------------------------- |
@@ -376,9 +441,10 @@ Running `compozy fix-reviews` with no flags opens the interactive form automatic
 | `--grouped`                  | `false`     | Generate grouped issue summaries                              |
 | `--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 failed jobs N times                                     |
-| `--retry-backoff-multiplier` | `1.5`       | Timeout multiplier per retry                                  |
+| `--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`               | `30`        | Log lines shown per job in UI                                 |
 | `--add-dir`                  |             | Additional directories to allow (repeatable)                  |
 | `--auto-commit`              | `false`     | Auto-commit after each batch                                  |
@@ -441,6 +507,7 @@ internal/core/           Internal facade for preparation and execution
 internal/setup/          Bundled skill installer (agent detection, symlink/copy)
 internal/version/        Build metadata
 skills/                  Bundled installable skills
+.compozy/config.toml     Optional workspace defaults for CLI execution
 .compozy/tasks/          Default workflow artifact root (PRDs, TechSpecs, tasks, ADRs, reviews)
 ```
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@compozy/cli",
   "type": "module",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Compozy CLI",
   "scripts": {
     "postinstall": "node install.js",
@@ -27,69 +27,69 @@
   },
   "archives": {
     "darwin-arm64": {
-      "name": "compozy_0.1.4_darwin_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.4/compozy_0.1.4_darwin_arm64.tar.gz",
+      "name": "compozy_0.1.6_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "5e384a0463fbc65514a5990aa3b335ad6532e4691d38834d73cd7237f92d9b22"
+        "digest": "ae5a5962cb6f4eb8f7749092e00084d9432c9f53426a7ee2b437a81f7822520d"
       },
-      "wrappedIn": "compozy_0.1.4_darwin_arm64"
+      "wrappedIn": "compozy_0.1.6_darwin_arm64"
     },
     "darwin-x64": {
-      "name": "compozy_0.1.4_darwin_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.4/compozy_0.1.4_darwin_x86_64.tar.gz",
+      "name": "compozy_0.1.6_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "7d372733a379d47fb21bed556bce8cb73f45163d0133f0ff25af4c8bef4a1f5e"
+        "digest": "ca3dee3e51a800aea8b25843c46cb8e61ab65246e6037c6950249dd273a8e3b6"
       },
-      "wrappedIn": "compozy_0.1.4_darwin_x86_64"
+      "wrappedIn": "compozy_0.1.6_darwin_x86_64"
     },
     "linux-arm64": {
-      "name": "compozy_0.1.4_linux_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.4/compozy_0.1.4_linux_arm64.tar.gz",
+      "name": "compozy_0.1.6_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "9dded2212070d39ee62817589712e95da628f498bd4cb87aa9639af646ca6fbe"
+        "digest": "5e36dddb31320c70fded3bdff5ca4bfa2923c7291cc145a8f43fd12044dea7fe"
       },
-      "wrappedIn": "compozy_0.1.4_linux_arm64"
+      "wrappedIn": "compozy_0.1.6_linux_arm64"
     },
     "linux-x64": {
-      "name": "compozy_0.1.4_linux_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.4/compozy_0.1.4_linux_x86_64.tar.gz",
+      "name": "compozy_0.1.6_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "c7043253f9ecd58e771ee0610f04190906115c092565a57ee2965e4365455937"
+        "digest": "eaec0ad0fc33bb2821b90d9f96d483edc30b1f5e064f04ffbc6a72193aee69af"
       },
-      "wrappedIn": "compozy_0.1.4_linux_x86_64"
+      "wrappedIn": "compozy_0.1.6_linux_x86_64"
     },
     "win32-x64": {
-      "name": "compozy_0.1.4_windows_x86_64.zip",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.4/compozy_0.1.4_windows_x86_64.zip",
+      "name": "compozy_0.1.6_windows_x86_64.zip",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_windows_x86_64.zip",
       "bins": [
         "compozy.exe"
       ],
       "format": "zip",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "1d8caf3070b63b4f3dfe36428bd5b53992e78fb5a5e83785b2c9fd54a38c5bea"
+        "digest": "681d067e2ad7436d8a01a9a129f5f283065cf015cfb8af046430feaeb006ee09"
       },
-      "wrappedIn": "compozy_0.1.4_windows_x86_64"
+      "wrappedIn": "compozy_0.1.6_windows_x86_64"
     }
   }
 }