@compozy/cli 0.1.4 → 0.1.5

package/README.md

@@ -98,6 +98,62 @@ 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.
+
 ## 🚀 Quick Start
 
 This walkthrough builds a feature called **user-auth** from idea to shipped code.
@@ -109,6 +165,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 +375,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,6 +385,7 @@ 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                                  |
@@ -345,6 +405,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 +424,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,6 +439,7 @@ 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                                  |
@@ -441,6 +505,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.5",
   "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.5_darwin_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_darwin_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "5e384a0463fbc65514a5990aa3b335ad6532e4691d38834d73cd7237f92d9b22"
+        "digest": "3d2e072f0a9639e228d9abe6f86b78a1d57c6e7d4179d2f1dda79d315ab2541d"
       },
-      "wrappedIn": "compozy_0.1.4_darwin_arm64"
+      "wrappedIn": "compozy_0.1.5_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.5_darwin_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_darwin_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "7d372733a379d47fb21bed556bce8cb73f45163d0133f0ff25af4c8bef4a1f5e"
+        "digest": "b1ca614d96d02055b412d36581249e4776ae8013f69e1fcb796e1f3506bc3a2d"
       },
-      "wrappedIn": "compozy_0.1.4_darwin_x86_64"
+      "wrappedIn": "compozy_0.1.5_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.5_linux_arm64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_linux_arm64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "9dded2212070d39ee62817589712e95da628f498bd4cb87aa9639af646ca6fbe"
+        "digest": "0a03b9d752fcf16da9842e6937e572519bc5e3db89755610038daef16e9b633a"
       },
-      "wrappedIn": "compozy_0.1.4_linux_arm64"
+      "wrappedIn": "compozy_0.1.5_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.5_linux_x86_64.tar.gz",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_linux_x86_64.tar.gz",
       "bins": [
         "compozy"
       ],
       "format": "tar.gz",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "c7043253f9ecd58e771ee0610f04190906115c092565a57ee2965e4365455937"
+        "digest": "b6d10adcdfe7eb1fec4fe969d693ac0d43925e931d4f19eab82011bf9eeb86cc"
       },
-      "wrappedIn": "compozy_0.1.4_linux_x86_64"
+      "wrappedIn": "compozy_0.1.5_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.5_windows_x86_64.zip",
+      "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_windows_x86_64.zip",
       "bins": [
         "compozy.exe"
       ],
       "format": "zip",
       "checksum": {
         "algorithm": "sha256",
-        "digest": "1d8caf3070b63b4f3dfe36428bd5b53992e78fb5a5e83785b2c9fd54a38c5bea"
+        "digest": "cc86dd064a7adcc5dba88c37bad92a9c4f4e5cb05f9145a1c28290826e2c703d"
       },
-      "wrappedIn": "compozy_0.1.4_windows_x86_64"
+      "wrappedIn": "compozy_0.1.5_windows_x86_64"
     }
   }
 }