@compozy/cli 0.1.3 → 0.1.5

package/README.md

@@ -29,7 +29,7 @@ One CLI to replace scattered prompts, manual task tracking, and copy-paste revie
 ## ✨ Highlights
 
 - **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`.
-- **Idea to code in 5 steps.** Structured pipeline: PRD → TechSpec → Tasks → Execution → Review. Each phase produces plain markdown artifacts that feed into the next.
+- **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.
 - **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.
 - **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.
 - **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.
@@ -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,18 +165,27 @@ 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. Create a PRD
+### 2. (Optional) Create an Issue
 
 Inside your AI agent (Claude Code, Codex, Cursor, OpenCode, Pi, etc.):
 
 ```
-/cy-create-prd <prompt>
+/cy-idea-factory user-auth
+```
+
+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.
+
+### 3. Create a PRD
+
+```
+/cy-create-prd user-auth
 ```
 
-Interactive brainstorming session — asks clarifying questions, spawns parallel agents to research your codebase and the web, produces a business-focused PRD with ADRs.
+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.
 
-### 3. Create a TechSpec
+### 4. Create a TechSpec
 
 ```
 /cy-create-techspec user-auth
@@ -128,7 +193,7 @@ Interactive brainstorming session — asks clarifying questions, spawns parallel
 
 Reads your PRD, explores the codebase architecture, asks technical clarification questions. Produces architecture specs, API designs, and data models.
 
-### 4. Break down into tasks
+### 5. Break down into tasks
 
 ```
 /cy-create-tasks user-auth
@@ -136,7 +201,7 @@ Reads your PRD, explores the codebase architecture, asks technical clarification
 
 Analyzes both documents, explores your codebase for relevant files and patterns, produces individually executable task files with status tracking, context, and acceptance criteria.
 
-### 5. Execute tasks
+### 6. Execute tasks
 
 ```bash
 compozy start --name user-auth --ide claude
@@ -144,7 +209,7 @@ compozy start --name user-auth --ide claude
 
 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.
 
-### 6. Review
+### 7. Review
 
 **Option A** — AI-powered review inside your agent:
 
@@ -160,7 +225,7 @@ compozy fetch-reviews --provider coderabbit --pr 42 --name user-auth
 
 Both produce the same output: `.compozy/tasks/user-auth/reviews-001/issue_*.md`
 
-### 7. Fix review issues
+### 8. Fix review issues
 
 ```bash
 compozy fix-reviews --name user-auth --ide claude --concurrent 2 --batch-size 3
@@ -168,17 +233,18 @@ compozy fix-reviews --name user-auth --ide claude --concurrent 2 --batch-size 3
 
 Agents triage each issue as valid or invalid, implement fixes for valid issues, and update statuses. Provider threads are resolved automatically.
 
-### 8. Iterate and ship
+### 9. Iterate and ship
 
-Repeat steps 6–7. Each cycle creates a new review round (`reviews-002/`, `reviews-003/`), preserving full history. When clean — merge and ship.
+Repeat steps 7–8. Each cycle creates a new review round (`reviews-002/`, `reviews-003/`), preserving full history. When clean — merge and ship.
 
 ## 🧩 Skills
 
-Compozy bundles 8 skills that its workflows depend on. They run inside your AI agent — no context switching to external tools.
+Compozy bundles 9 skills that its workflows depend on. They run inside your AI agent — no context switching to external tools.
 
 | Skill                | Purpose                                                                    |
 | -------------------- | -------------------------------------------------------------------------- |
-| `cy-create-prd`      | Interactive brainstorming → Product Requirements Document with ADRs        |
+| `cy-idea-factory`    | Raw idea → structured issue spec with market research, business analysis, and council debate |
+| `cy-create-prd`      | Issue/idea → Product Requirements Document with ADRs                       |
 | `cy-create-techspec` | PRD → Technical Specification with architecture exploration                |
 | `cy-create-tasks`    | PRD + TechSpec → Independently implementable task files                    |
 | `cy-execute-task`    | Executes one task end-to-end: implement, validate, track, commit           |
@@ -309,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                                                   |
 | ---------------------------- | ----------- | ------------------------------------------------------------- |
@@ -317,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                                  |
@@ -336,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                               |
 | ------------ | ------- | ----------------------------------------- |
@@ -354,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                                                   |
 | ---------------------------- | ----------- | ------------------------------------------------------------- |
@@ -367,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                                  |
@@ -432,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.3",
+  "version": "0.1.5",
   "description": "Compozy CLI",
   "scripts": {
     "postinstall": "node install.js",
@@ -27,69 +27,69 @@
   },
   "archives": {
     "darwin-arm64": {
-      "name": "compozy_0.1.3_darwin_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.3/compozy_0.1.3_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": "57c78066e4db73ffa0c5b53eedda98098cc34bcdd0d615869d83f3735485e839"
+        "digest": "3d2e072f0a9639e228d9abe6f86b78a1d57c6e7d4179d2f1dda79d315ab2541d"
       },
-      "wrappedIn": "compozy_0.1.3_darwin_arm64"
+      "wrappedIn": "compozy_0.1.5_darwin_arm64"
     },
     "darwin-x64": {
-      "name": "compozy_0.1.3_darwin_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.3/compozy_0.1.3_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": "cae8eb365d082c665c071f6538b94b71fef63596f40c399245ccc6027a0569fc"
+        "digest": "b1ca614d96d02055b412d36581249e4776ae8013f69e1fcb796e1f3506bc3a2d"
       },
-      "wrappedIn": "compozy_0.1.3_darwin_x86_64"
+      "wrappedIn": "compozy_0.1.5_darwin_x86_64"
     },
     "linux-arm64": {
-      "name": "compozy_0.1.3_linux_arm64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.3/compozy_0.1.3_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": "c8c50c37bb5e7c4f9656340274a0d9a27ff9345fe71eee33869a32071e4f9bf0"
+        "digest": "0a03b9d752fcf16da9842e6937e572519bc5e3db89755610038daef16e9b633a"
       },
-      "wrappedIn": "compozy_0.1.3_linux_arm64"
+      "wrappedIn": "compozy_0.1.5_linux_arm64"
     },
     "linux-x64": {
-      "name": "compozy_0.1.3_linux_x86_64.tar.gz",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.3/compozy_0.1.3_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": "3cdf82b58e3826ca5516f86f0cf3330a494888f59f9ac7ca7a6b182860893741"
+        "digest": "b6d10adcdfe7eb1fec4fe969d693ac0d43925e931d4f19eab82011bf9eeb86cc"
       },
-      "wrappedIn": "compozy_0.1.3_linux_x86_64"
+      "wrappedIn": "compozy_0.1.5_linux_x86_64"
     },
     "win32-x64": {
-      "name": "compozy_0.1.3_windows_x86_64.zip",
-      "url": "https://github.com/compozy/compozy/releases/download/v0.1.3/compozy_0.1.3_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": "18e411599601609604c361f3fe6977b9a74a7cc2176ad9fd67093d873b6a92fe"
+        "digest": "cc86dd064a7adcc5dba88c37bad92a9c4f4e5cb05f9145a1c28290826e2c703d"
       },
-      "wrappedIn": "compozy_0.1.3_windows_x86_64"
+      "wrappedIn": "compozy_0.1.5_windows_x86_64"
     }
   }
 }