@compozy/cli 0.1.6 → 0.1.8

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 +32 -11
  2. package/package.json +21 -21
package/README.md CHANGED
@@ -29,7 +29,7 @@ One CLI to replace scattered prompts, manual task tracking, and copy-paste revie
29
29
  ## ✨ Highlights
30
30
 
31
31
  - **One command, 40+ agents.** Install bundled skills into Claude Code, Codex, Cursor, Droid, OpenCode, Pi, Gemini, and 40+ other agents and editors with `compozy setup`.
32
- - **Idea to code in a structured pipeline.** Optional Issue → PRD → TechSpec → Tasks → Execution → Review. Each phase produces plain markdown artifacts that feed into the next. Start from an issue for full research and debate, or jump straight to PRD if you already have a clear scope.
32
+ - **Idea to code in a structured pipeline.** Optional Idea → PRD → TechSpec → Tasks → Execution → Review. Each phase produces plain markdown artifacts that feed into the next. Start from an idea for full research and debate, or jump straight to PRD if you already have a clear scope.
33
33
  - **Codebase-aware enrichment.** Tasks aren't generic prompts. Compozy spawns parallel agents to explore your codebase, discover patterns, and ground every task in real project context.
34
34
  - **Multi-agent execution.** Run tasks through ACP-capable runtimes like Claude Code, Codex, Cursor, Droid, OpenCode, Pi, or Gemini — just change `--ide`. Concurrent batch processing with configurable timeouts, retries, and exponential backoff, all with a live terminal UI.
35
35
  - **Workflow memory between runs.** Agents inherit context from every previous task — decisions, learnings, errors, and handoffs. Two-tier markdown memory with automatic compaction keeps context fresh without manual bookkeeping.
@@ -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:
@@ -177,7 +197,7 @@ Inside your AI agent (Claude Code, Codex, Cursor, OpenCode, Pi, etc.):
177
197
  /cy-idea-factory user-auth
178
198
  ```
179
199
 
180
- Transforms a raw idea into a structured issue spec — asks targeted questions, researches market and codebase in parallel, runs business analysis and council debate, suggests high-leverage alternatives, and produces a research-backed issue. Skip this step if you already have a clear feature scope.
200
+ Transforms a raw idea into a structured idea spec — asks targeted questions, researches market and codebase in parallel, runs business analysis and council debate, suggests high-leverage alternatives, and produces a research-backed idea. Skip this step if you already have a clear feature scope.
181
201
 
182
202
  ### 3. Create a PRD
183
203
 
@@ -185,7 +205,7 @@ Transforms a raw idea into a structured issue spec — asks targeted questions,
185
205
  /cy-create-prd user-auth
186
206
  ```
187
207
 
188
- Interactive brainstorming session — reads the issue if one exists, asks clarifying questions, spawns parallel agents to research your codebase and the web, produces a business-focused PRD with ADRs.
208
+ Interactive brainstorming session — reads the idea if one exists, asks clarifying questions, spawns parallel agents to research your codebase and the web, produces a business-focused PRD with ADRs.
189
209
 
190
210
  ### 4. Create a TechSpec
191
211
 
@@ -202,6 +222,7 @@ Reads your PRD, explores the codebase architecture, asks technical clarification
202
222
  ```
203
223
 
204
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`.
205
226
 
206
227
  ### 6. Execute tasks
207
228
 
@@ -210,6 +231,7 @@ compozy start --name user-auth --ide claude
210
231
  ```
211
232
 
212
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.
213
235
 
214
236
  ### 7. Review
215
237
 
@@ -245,8 +267,8 @@ Compozy bundles 9 skills that its workflows depend on. They run inside your AI a
245
267
 
246
268
  | Skill | Purpose |
247
269
  | -------------------- | -------------------------------------------------------------------------- |
248
- | `cy-idea-factory` | Raw idea → structured issue spec with market research, business analysis, and council debate |
249
- | `cy-create-prd` | Issue/idea → Product Requirements Document with ADRs |
270
+ | `cy-idea-factory` | Raw idea → structured idea spec with market research, business analysis, and council debate |
271
+ | `cy-create-prd` | Idea → Product Requirements Document with ADRs |
250
272
  | `cy-create-techspec` | PRD → Technical Specification with architecture exploration |
251
273
  | `cy-create-tasks` | PRD + TechSpec → Independently implementable task files |
252
274
  | `cy-execute-task` | Executes one task end-to-end: implement, validate, track, commit |
@@ -427,7 +449,7 @@ compozy fix-reviews [flags]
427
449
 
428
450
  Running `compozy fix-reviews` with no flags opens the interactive form automatically.
429
451
  When present, `.compozy/config.toml` can provide runtime defaults as well as review workflow
430
- defaults such as `--concurrent`, `--batch-size`, `--grouped`, and `--include-resolved`.
452
+ defaults such as `--concurrent`, `--batch-size`, and `--include-resolved`.
431
453
 
432
454
  | Flag | Default | Description |
433
455
  | ---------------------------- | ----------- | ------------------------------------------------------------- |
@@ -438,7 +460,6 @@ defaults such as `--concurrent`, `--batch-size`, `--grouped`, and `--include-res
438
460
  | `--model` | _(per IDE)_ | Model override |
439
461
  | `--batch-size` | `1` | Issues per batch |
440
462
  | `--concurrent` | `1` | Parallel batches |
441
- | `--grouped` | `false` | Generate grouped issue summaries |
442
463
  | `--include-resolved` | `false` | Re-process resolved issues |
443
464
  | `--reasoning-effort` | `medium` | `low`, `medium`, `high`, `xhigh` |
444
465
  | `--access-mode` | `full` | `default` or `full` runtime access policy |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@compozy/cli",
3
3
  "type": "module",
4
- "version": "0.1.6",
4
+ "version": "0.1.8",
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.6_darwin_arm64.tar.gz",
31
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_darwin_arm64.tar.gz",
30
+ "name": "compozy_0.1.8_darwin_arm64.tar.gz",
31
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.8/compozy_0.1.8_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": "ae5a5962cb6f4eb8f7749092e00084d9432c9f53426a7ee2b437a81f7822520d"
38
+ "digest": "cb3e627c1cbfec6480071ffbf1bcb964916a7c7a53f859a737b3ac6acea963be"
39
39
  },
40
- "wrappedIn": "compozy_0.1.6_darwin_arm64"
40
+ "wrappedIn": "compozy_0.1.8_darwin_arm64"
41
41
  },
42
42
  "darwin-x64": {
43
- "name": "compozy_0.1.6_darwin_x86_64.tar.gz",
44
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_darwin_x86_64.tar.gz",
43
+ "name": "compozy_0.1.8_darwin_x86_64.tar.gz",
44
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.8/compozy_0.1.8_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": "ca3dee3e51a800aea8b25843c46cb8e61ab65246e6037c6950249dd273a8e3b6"
51
+ "digest": "e84f18fe1747696908bbbce0c1269b6f13a985bc52339ef9dc65767aa3925c8f"
52
52
  },
53
- "wrappedIn": "compozy_0.1.6_darwin_x86_64"
53
+ "wrappedIn": "compozy_0.1.8_darwin_x86_64"
54
54
  },
55
55
  "linux-arm64": {
56
- "name": "compozy_0.1.6_linux_arm64.tar.gz",
57
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_linux_arm64.tar.gz",
56
+ "name": "compozy_0.1.8_linux_arm64.tar.gz",
57
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.8/compozy_0.1.8_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": "5e36dddb31320c70fded3bdff5ca4bfa2923c7291cc145a8f43fd12044dea7fe"
64
+ "digest": "fde00e9c42ab684503599c1d7d5775d46bb703b075601aba458f0846ab2b96fe"
65
65
  },
66
- "wrappedIn": "compozy_0.1.6_linux_arm64"
66
+ "wrappedIn": "compozy_0.1.8_linux_arm64"
67
67
  },
68
68
  "linux-x64": {
69
- "name": "compozy_0.1.6_linux_x86_64.tar.gz",
70
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_linux_x86_64.tar.gz",
69
+ "name": "compozy_0.1.8_linux_x86_64.tar.gz",
70
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.8/compozy_0.1.8_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": "eaec0ad0fc33bb2821b90d9f96d483edc30b1f5e064f04ffbc6a72193aee69af"
77
+ "digest": "4149037d08b67c8f6018c61a57bc1397b82ee474d1b42c2904e13bedfcae80be"
78
78
  },
79
- "wrappedIn": "compozy_0.1.6_linux_x86_64"
79
+ "wrappedIn": "compozy_0.1.8_linux_x86_64"
80
80
  },
81
81
  "win32-x64": {
82
- "name": "compozy_0.1.6_windows_x86_64.zip",
83
- "url": "https://github.com/compozy/compozy/releases/download/v0.1.6/compozy_0.1.6_windows_x86_64.zip",
82
+ "name": "compozy_0.1.8_windows_x86_64.zip",
83
+ "url": "https://github.com/compozy/compozy/releases/download/v0.1.8/compozy_0.1.8_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": "681d067e2ad7436d8a01a9a129f5f283065cf015cfb8af046430feaeb006ee09"
90
+ "digest": "4f7bd78520c4191de62969a0d91281597e8effa4bc09a8ac534d99d9447de088"
91
91
  },
92
- "wrappedIn": "compozy_0.1.6_windows_x86_64"
92
+ "wrappedIn": "compozy_0.1.8_windows_x86_64"
93
93
  }
94
94
  }
95
95
  }