@compozy/cli 0.1.5 → 0.1.7

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
  1. package/README.md +33 -10
  2. package/package.json +21 -21
package/README.md CHANGED
@@ -96,7 +96,24 @@ When the direct ACP command is not installed, Compozy can also fall back to supp
96
96
 
97
97
  Every artifact is a plain markdown file in `.compozy/tasks/<name>/`. You can read, edit, or version-control any of them between steps.
98
98
 
99
- 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`.
99
+ 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`.
100
+
101
+ ### Task Schema v2
102
+
103
+ Task files now use the v2 frontmatter shape: `status`, `title`, `type`, `complexity`, and `dependencies`. Legacy v1 task-only keys are no longer part of the schema. `type` must come from the workspace task type registry: either `[tasks].types` in `.compozy/config.toml` or the built-in defaults `frontend`, `backend`, `docs`, `test`, `infra`, `refactor`, `chore`, `bugfix`.
104
+
105
+ ```md
106
+ ---
107
+ status: pending
108
+ title: Add validate-tasks preflight to start
109
+ type: backend
110
+ complexity: medium
111
+ dependencies:
112
+ - task_02
113
+ ---
114
+ ```
115
+
116
+ 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.
100
117
 
101
118
  ## ⚙️ Workspace Config
102
119
 
@@ -131,21 +148,24 @@ retry_backoff_multiplier = 1.5
131
148
  [start]
132
149
  include_completed = false
133
150
 
151
+ [tasks]
152
+ types = ["frontend", "backend", "docs", "test", "infra", "refactor", "chore", "bugfix"]
153
+
134
154
  [fix_reviews]
135
155
  concurrent = 2
136
156
  batch_size = 3
137
- grouped = true
138
157
  include_resolved = false
139
158
 
140
159
  [fetch_reviews]
141
160
  provider = "coderabbit"
142
161
  ```
143
162
 
144
- Supported sections in v1:
163
+ Supported sections:
145
164
 
146
165
  - `[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`
147
166
  - `[start]` for `include_completed`
148
- - `[fix_reviews]` for `concurrent`, `batch_size`, `grouped`, and `include_resolved`
167
+ - `[tasks]` for the allowed task `type` list used by `cy-create-tasks` and `compozy validate-tasks`
168
+ - `[fix_reviews]` for `concurrent`, `batch_size`, and `include_resolved`
149
169
  - `[fetch_reviews]` for `provider`
150
170
 
151
171
  Notes:
@@ -153,6 +173,8 @@ Notes:
153
173
  - `.compozy/config.toml` is optional. If it is absent, Compozy keeps the current built-in defaults.
154
174
  - `.compozy/tasks` remains the fixed workflow root in this version; the config file does not change the workflow root path.
155
175
  - Unknown keys and invalid value types are rejected during config loading.
176
+ - `max_retries` applies to execution-stage ACP failures and inactivity timeouts for both `compozy start` and `compozy fix-reviews`.
177
+ - `retry_backoff_multiplier` only increases the next attempt timeout; retries restart immediately and do not add a sleep delay.
156
178
 
157
179
  ## 🚀 Quick Start
158
180
 
@@ -200,6 +222,7 @@ Reads your PRD, explores the codebase architecture, asks technical clarification
200
222
  ```
201
223
 
202
224
  Analyzes both documents, explores your codebase for relevant files and patterns, produces individually executable task files with status tracking, context, and acceptance criteria.
225
+ Generated task files use task schema v2 (`status`, `title`, `type`, `complexity`, `dependencies`). Validate them any time with `compozy validate-tasks --name user-auth`.
203
226
 
204
227
  ### 6. Execute tasks
205
228
 
@@ -208,6 +231,7 @@ compozy start --name user-auth --ide claude
208
231
  ```
209
232
 
210
233
  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.
234
+ `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.
211
235
 
212
236
  ### 7. Review
213
237
 
@@ -387,8 +411,8 @@ When present, `.compozy/config.toml` can provide defaults for runtime flags such
387
411
  | `--reasoning-effort` | `medium` | `low`, `medium`, `high`, `xhigh` |
388
412
  | `--access-mode` | `full` | `default` or `full` runtime access policy |
389
413
  | `--timeout` | `10m` | Activity timeout per job |
390
- | `--max-retries` | `0` | Retry failed jobs N times |
391
- | `--retry-backoff-multiplier` | `1.5` | Timeout multiplier per retry |
414
+ | `--max-retries` | `0` | Retry execution-stage ACP failures or timeouts N times |
415
+ | `--retry-backoff-multiplier` | `1.5` | Multiplier applied to the next timeout after each retry |
392
416
  | `--tail-lines` | `30` | Log lines shown per job in UI |
393
417
  | `--add-dir` | | Additional directories to allow (repeatable) |
394
418
  | `--auto-commit` | `false` | Auto-commit after each task |
@@ -425,7 +449,7 @@ compozy fix-reviews [flags]
425
449
 
426
450
  Running `compozy fix-reviews` with no flags opens the interactive form automatically.
427
451
  When present, `.compozy/config.toml` can provide runtime defaults as well as review workflow
428
- defaults such as `--concurrent`, `--batch-size`, `--grouped`, and `--include-resolved`.
452
+ defaults such as `--concurrent`, `--batch-size`, and `--include-resolved`.
429
453
 
430
454
  | Flag | Default | Description |
431
455
  | ---------------------------- | ----------- | ------------------------------------------------------------- |
@@ -436,13 +460,12 @@ defaults such as `--concurrent`, `--batch-size`, `--grouped`, and `--include-res
436
460
  | `--model` | _(per IDE)_ | Model override |
437
461
  | `--batch-size` | `1` | Issues per batch |
438
462
  | `--concurrent` | `1` | Parallel batches |
439
- | `--grouped` | `false` | Generate grouped issue summaries |
440
463
  | `--include-resolved` | `false` | Re-process resolved issues |
441
464
  | `--reasoning-effort` | `medium` | `low`, `medium`, `high`, `xhigh` |
442
465
  | `--access-mode` | `full` | `default` or `full` runtime access policy |
443
466
  | `--timeout` | `10m` | Activity timeout per job |
444
- | `--max-retries` | `0` | Retry failed jobs N times |
445
- | `--retry-backoff-multiplier` | `1.5` | Timeout multiplier per retry |
467
+ | `--max-retries` | `0` | Retry execution-stage ACP failures or timeouts N times |
468
+ | `--retry-backoff-multiplier` | `1.5` | Multiplier applied to the next timeout after each retry |
446
469
  | `--tail-lines` | `30` | Log lines shown per job in UI |
447
470
  | `--add-dir` | | Additional directories to allow (repeatable) |
448
471
  | `--auto-commit` | `false` | Auto-commit after each batch |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@compozy/cli",
3
3
  "type": "module",
4
- "version": "0.1.5",
4
+ "version": "0.1.7",
5
5
  "description": "Compozy CLI",
6
6
  "scripts": {
7
7
  "postinstall": "node install.js",
@@ -27,69 +27,69 @@
27
27
  },
28
28
  "archives": {
29
29
  "darwin-arm64": {
30
- "name": "compozy_0.1.5_darwin_arm64.tar.gz",
31
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_darwin_arm64.tar.gz",
30
+ "name": "compozy_0.1.7_darwin_arm64.tar.gz",
31
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.7/compozy_0.1.7_darwin_arm64.tar.gz",
32
32
  "bins": [
33
33
  "compozy"
34
34
  ],
35
35
  "format": "tar.gz",
36
36
  "checksum": {
37
37
  "algorithm": "sha256",
38
- "digest": "3d2e072f0a9639e228d9abe6f86b78a1d57c6e7d4179d2f1dda79d315ab2541d"
38
+ "digest": "f896320cad71f167672187dfd39f90872b6440624e6371e6fa1075660c71100b"
39
39
  },
40
- "wrappedIn": "compozy_0.1.5_darwin_arm64"
40
+ "wrappedIn": "compozy_0.1.7_darwin_arm64"
41
41
  },
42
42
  "darwin-x64": {
43
- "name": "compozy_0.1.5_darwin_x86_64.tar.gz",
44
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_darwin_x86_64.tar.gz",
43
+ "name": "compozy_0.1.7_darwin_x86_64.tar.gz",
44
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.7/compozy_0.1.7_darwin_x86_64.tar.gz",
45
45
  "bins": [
46
46
  "compozy"
47
47
  ],
48
48
  "format": "tar.gz",
49
49
  "checksum": {
50
50
  "algorithm": "sha256",
51
- "digest": "b1ca614d96d02055b412d36581249e4776ae8013f69e1fcb796e1f3506bc3a2d"
51
+ "digest": "66e9607c4c59db2717532196f1a9b37957e6deb3cb79507651930da146046619"
52
52
  },
53
- "wrappedIn": "compozy_0.1.5_darwin_x86_64"
53
+ "wrappedIn": "compozy_0.1.7_darwin_x86_64"
54
54
  },
55
55
  "linux-arm64": {
56
- "name": "compozy_0.1.5_linux_arm64.tar.gz",
57
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_linux_arm64.tar.gz",
56
+ "name": "compozy_0.1.7_linux_arm64.tar.gz",
57
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.7/compozy_0.1.7_linux_arm64.tar.gz",
58
58
  "bins": [
59
59
  "compozy"
60
60
  ],
61
61
  "format": "tar.gz",
62
62
  "checksum": {
63
63
  "algorithm": "sha256",
64
- "digest": "0a03b9d752fcf16da9842e6937e572519bc5e3db89755610038daef16e9b633a"
64
+ "digest": "79567d81480a8873b1cad5f704a73cdcfddfe2577034723d8bf4a9ec8c0bdd7a"
65
65
  },
66
- "wrappedIn": "compozy_0.1.5_linux_arm64"
66
+ "wrappedIn": "compozy_0.1.7_linux_arm64"
67
67
  },
68
68
  "linux-x64": {
69
- "name": "compozy_0.1.5_linux_x86_64.tar.gz",
70
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_linux_x86_64.tar.gz",
69
+ "name": "compozy_0.1.7_linux_x86_64.tar.gz",
70
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.7/compozy_0.1.7_linux_x86_64.tar.gz",
71
71
  "bins": [
72
72
  "compozy"
73
73
  ],
74
74
  "format": "tar.gz",
75
75
  "checksum": {
76
76
  "algorithm": "sha256",
77
- "digest": "b6d10adcdfe7eb1fec4fe969d693ac0d43925e931d4f19eab82011bf9eeb86cc"
77
+ "digest": "48f65c1e483f55206ebdcd7bb497fbb964b570b53a99f15e824c6923a0ea88e7"
78
78
  },
79
- "wrappedIn": "compozy_0.1.5_linux_x86_64"
79
+ "wrappedIn": "compozy_0.1.7_linux_x86_64"
80
80
  },
81
81
  "win32-x64": {
82
- "name": "compozy_0.1.5_windows_x86_64.zip",
83
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.5/compozy_0.1.5_windows_x86_64.zip",
82
+ "name": "compozy_0.1.7_windows_x86_64.zip",
83
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.7/compozy_0.1.7_windows_x86_64.zip",
84
84
  "bins": [
85
85
  "compozy.exe"
86
86
  ],
87
87
  "format": "zip",
88
88
  "checksum": {
89
89
  "algorithm": "sha256",
90
- "digest": "cc86dd064a7adcc5dba88c37bad92a9c4f4e5cb05f9145a1c28290826e2c703d"
90
+ "digest": "62314b80642e2f8e417b4657f19a1871be2dd262cbc2b3e0959024be57699c5a"
91
91
  },
92
- "wrappedIn": "compozy_0.1.5_windows_x86_64"
92
+ "wrappedIn": "compozy_0.1.7_windows_x86_64"
93
93
  }
94
94
  }
95
95
  }