@idea1/cli 1.8.3 → 1.9.1

package/README.md

@@ -16,16 +16,16 @@ Run commands directly from the command line:
 
 ```bash
 # Put a project item under workflow management (branch recorded on idea1.ai, no code changes)
-idea1 start --url https://app.idea1.ai/project/items/590
+idea1 start --target https://app.idea1.ai/project/items/590
 
 # Ship the uncommitted changes of your working/release checkout: new item, its branch, PR, checks, merge
 idea1 ship --title "Release prep" --project "Omega"
 
 # Advance the item to its next workflow state (runs that state's automation)
-idea1 next --url https://app.idea1.ai/project/items/590   # or just `idea1 next` on the item's branch
+idea1 next --target https://app.idea1.ai/project/items/590   # or just `idea1 next` on the item's branch
 
 # Jump straight to Agent Implementation (worktree + Claude) — the "send for implementation" path
-idea1 start-agent-implementation --url https://app.idea1.ai/project/items/590   # alias: start-project-item
+idea1 start-agent-implementation --target https://app.idea1.ai/project/items/590   # alias: start-project-item
 
 # Dedicated transitions (each is one `next` step)
 idea1 start-dev-implementation  # or: idea1 dev
@@ -35,11 +35,15 @@ idea1 approve-pr                # or: idea1 approve
 # The same two commands on a branch with no project item, e.g. an integration branch:
 # open its PR into working/release and name the approver, then (as the approver) merge it
 idea1 ready-for-approval --assignee octocat
-idea1 approve-pr --branch working/integration/<name>-main
+idea1 approve-pr --target working/integration/<name>-main
+
+# From working/release: approve several items, branches or PRs at once, each in its own unattended run, in parallel
+idea1 approve-pr --target https://app.idea1.ai/project/items/590,working/agent/fix-config,https://github.com/org/repo/pull/912
 
 # Release the release branch to production (bumps changed packages' versions, opens the release PR into main assigned to you, and merges it once the checks pass)
 idea1 release                   # or: idea1 r
 idea1 release --approve         # approve and merge the release PR that is already open
+idea1 release --target <item url>,<branch>   # approve these into working/release first, then release once all have merged
 
 # Show help
 idea1 --help
@@ -47,7 +51,40 @@ idea1 --help
 
 ### Interactive Mode
 
-Run `idea1` without arguments to enter interactive mode with a searchable command interface.
+Run `idea1` without arguments to enter interactive mode with a searchable command interface. A command run on several targets runs there as a background job: the prompt comes back at once, a notice is printed when the job finishes, and `/jobs` lists the session's jobs and opens a live view of one (Esc returns to the prompt). Leaving with `/exit` while a job runs asks whether to stop it. Whatever a command does, the session stays in the directory it started in.
+
+## Targets and parallel runs
+
+Every command that works on a project item or a branch names it with `--target`, which takes any of:
+
+- a project item URL (`https://app.idea1.ai/project/items/590`)
+- a branch name (`working/agent/fix-config`)
+- a GitHub PR URL (`https://github.com/org/repo/pull/912`), which stands for its head branch
+
+A branch, or a PR's branch, resolves to the project item it implements. A command that needs a project item (`next`, `start-dev-implementation`, `start`, `start-agent-implementation`, `attach-project-item`, `ship-local-changes`, `join-project-item` for an item) refuses a branch that is no item's. `ready-for-approval` and `approve-pr` also operate on a branch with no project item.
+
+With no `--target`, a command works on the current branch when it can be the target: an item's branch, or for `ready-for-approval` and `approve-pr` any branch other than the base branch. Otherwise, as on `working/release`, the targets are the first thing it asks for. It shows a picker of the open PRs into the base branch and the branches your clone knows as project items' (worktrees included). Pick any number with space, and pick **Other** to type item URLs, branch names or PR URLs as well. `release` asks the same way; picking nothing releases the branch as it is.
+
+**One target** runs exactly as the command always has, in your terminal. Its work happens in the branch's local checkout when it has one. A branch with no checkout is worked on through origin and GitHub, and is checked out only when a step needs its files: entering Agent Implementation creates it, per the isolation mode. Approving or readying an item's PR from `working/release` therefore checks nothing out at all, and the merge brings your `working/release` checkout up to date.
+
+**Several targets** (comma-separated) run as a job, one unattended CLI process per target, in parallel:
+
+- Before anything starts, every target is resolved. Anything that would stop one (an item with no live branch here, a branch that is no item's for a command that needs one, two targets on one branch) stops the whole command.
+- Everything the runs will need is asked once, up front: the options of every workflow state the items will enter, then one confirmation of the set (`--yes` skips it).
+- Runs work in worktrees, never in your checkout, and launch no Claude session.
+- Each run fails fast on its own: a PR that conflicts with its base fails before its checks are waited for, and a failed check ends the wait. The other runs carry on.
+- Every run's output is logged in your main clone under `.idea1/jobs/`, one folder per job. Git ignores the folder through `.idea1/.gitignore`. On every run, the CLI creates that file if it is missing and adds any entry it lacks; commit the change when it does. Logs older than 14 days, and beyond the 50 most recent jobs, are deleted as new jobs start.
+- Outside interactive mode the job runs in the foreground: each run's steps are reported as they happen, then a summary. The exit code is non-zero when any run failed.
+
+```bash
+idea1 approve-pr --target <item url>,<branch>,<PR url> --yes
+idea1 ready-for-approval --target <item url>,<item url> --assignee octocat
+idea1 next --to "Dev Implementation" --target <item url>,<item url>
+```
+
+An unattended run asks nothing. A text question with a default (a PR title, say) takes the default. Every other question, such as a confirmation or a choice, fails the run at once with the question it needed answered.
+
+Several CLIs can also run side by side in one clone, from separate terminals. Their git commands wait for each other's locks rather than failing.
 
 ## Commands
 
@@ -64,7 +101,7 @@ The state names and their order are defined once, in `shared-config/workflow-sta
 
 ### How the workflow engine works
 
-An item **under workflow management** has a *workflow context* on idea1.ai: its workflow status together with the one branch on origin that carries its work — the repository and branch name, the PR target (base) branch, the dev workflow type and any stack or integration branch. An item with no context is outside workflow management and has no status. The CLI reads and records the context through the platform's MCP tools (`get_item_summary_for_branch`, `get_item_summary`, `upsert_item_workflow_context`) and, having run a transition's automation itself, records the state it reached directly with `update_item`'s `workflowStatus`; the web client works on the same context, so the two always agree, and any clone resolves a branch to its item from the platform. Locally, each clone remembers the item URL a branch was last resolved to in its git config, so ordinary branches are recognized as unmanaged instantly.
+An item **under workflow management** has a *workflow context* on idea1.ai: its workflow status together with the one branch on origin that carries its work — the repository and branch name, the PR target (base) branch, the dev workflow type and any stack or integration branch. An item with no context is outside workflow management and has no status. The CLI reads and records the context through the platform's MCP tools (`get_item_summary_for_branch`, `get_item_summary`, `upsert_item_workflow_context`) and, having run a transition's automation itself, records the state it reached directly with `update_item`'s `workflowStatus`; the web client works on the same context, so the two always agree, and any clone resolves a branch to its item from the platform. The branching decisions the context records (dev workflow type, stack and integration branch, branch name) are made once, when the item's branch is created, and are never asked again for an item that has one. Locally, each clone remembers the item URL a branch was last resolved to in its git config, so ordinary branches are recognized as unmanaged instantly.
 
 The branch itself carries the work. A branch's PR is therefore gated on a CI/CD run of exactly what merges, and `approve-pr` merges that run's head. When a branch is deleted on GitHub the context keeps its name and records whether the work merged; a context whose branch is gone without merging gets a new branch the next time the item enters a pre-merge state, while merged work stays merged. Branches put under workflow before the platform kept contexts carry a legacy `.idea1/<branch>.json` file, which the CLI removes from the branch before the approval gate.
 
@@ -73,10 +110,10 @@ A transition is "enter state X". Entering a state runs that state's automation (
 | Entering | Automation |
 |----------|-----------|
 | Build Spec in Progress … Ready for Agent Implementation | none — status only |
-| **Agent Implementation** | ensures the branch is checked out locally (worktree or main repo), then **launches Claude** to implement the item. This is the only transition that starts code-writing automation |
-| **Dev Implementation** | commits and pushes the agent's work, creates the PR, removes the worktree if `removeWorktreeAtState` says so |
+| **Agent Implementation** | ensures the branch is checked out locally (worktree or main repo) — the one step that creates a checkout when the branch has none — then **launches Claude** to implement the item. This is the only transition that starts code-writing automation |
+| **Dev Implementation** | commits and pushes the agent's work from the branch's checkout (a branch with no checkout here has its work on origin), creates the PR, removes the worktree if `removeWorktreeAtState` says so |
 | **Needs Approval for Release** | requires the PR, sets its assignee (required — the approver of record) and any requested reviewers, removes a legacy workflow context file if the branch still carries one (its final commit), and removes the worktree if configured. From here on the branch stays as it is |
-| **Approved and Merged** | verifies you are the assignee, waits for the CI/CD suite, merges the PR as it stands — the merge is the approval — then deletes the branch and worktree |
+| **Approved and Merged** | verifies you are the assignee, refuses a PR that conflicts with its base, waits for the CI/CD suite, merges the PR as it stands — the merge is the approval — then deletes the branch and worktree and fast-forwards your base branch checkout |
 | Released | none — normally set by GitHub automation when the work merges to `main` |
 
 `start` begins state management, `next` advances one state, `start-agent-implementation` jumps to Agent Implementation, and `ship-local-changes` takes uncommitted base-branch work all the way to Approved and Merged — all three reduce to the same engine, so branches and items always end up consistent with the state they are in. The engine and its layers are described in `src/workflow/README.md`.
@@ -98,19 +135,19 @@ This is the change-management control DataFabrIQ is audited on; see `infrastruct
 Put a project item under workflow management. An item yet to be started enters **Build Spec in Progress**; an item that already has a state keeps it. The branch is created on origin at the base branch's tip and recorded in the item's workflow context on idea1.ai; the working tree and the code stay as they are, and Claude stays closed. Idempotent: running it again for a managed item just reports the branch and state.
 
 ```bash
-idea1 start --url <url> [options]
-idea1 start                       # prompts for the URL (blank to create a new item)
-idea1 s --url <url>
+idea1 start --target <url> [options]
+idea1 start                       # prompts for the target (blank to create a new item)
+idea1 s --target <url>
 ```
 
 **Options:**
-- `-u, --url <url>` - The Idea1.ai project item URL. Leave blank to create a new item (you'll be prompted for a `--title` and a `--project`).
-- `-t, --title <title>` - Title for the new project item (only when no URL is given).
-- `-P, --project <name>` - The Project to create the new item in, chosen from the team's live Projects (only when no URL is given; always asked, never defaulted).
+- `--target <url | branch | PR url>` - The project item, or its branch or that branch's PR. Leave blank to create a new item (you'll be prompted for a `--title` and a `--project`). One target only.
+- `-t, --title <title>` - Title for the new project item (only when no target is given).
+- `-P, --project <name>` - The Project to create the new item in, chosen from the team's live Projects (only when no target is given; always asked, never defaulted).
 - `-p, --source-path <path>` - Path to source directory.
-- `-n, --branch-name <name>` - Branch name (auto-generated from the item description if not provided).
+- `-n, --branch-name <name>` - Branch name (auto-generated from the item description if not provided). Asked, blank to generate one, only when the item has no branch yet.
 - `-b, --base-branch <branch>` - Base branch / PR target (default: `working/release`).
-- `-w, --workflow-type <type>` - `independent` or `integration`; you also choose any stack branch and (for integration) the integration branch. Not asked when carrying local changes, which go onto an independent branch.
+- `-w, --workflow-type <type>` - `independent` or `integration`; you also choose any stack branch and (for integration) the integration branch. These are asked only when the command gives the item its branch, never for an item whose workflow context already holds one, and an option given on the command line is not asked. Carried local changes go onto an independent branch.
 - `-c, --carry-local-changes` - Make the uncommitted changes of your base branch checkout the item's work. See [Carrying local changes](#carrying-local-changes).
 - `--approve-and-merge` - Advance the item through every state up to **Approved and Merged** without prompting. See [Carrying local changes](#carrying-local-changes).
 - `-M, --commit-message <message>` - Commit message for carried changes (default: the new item's title).
@@ -125,7 +162,7 @@ Work sometimes starts before its project item does: you make changes in your `wo
 2. Every uncommitted change — staged or not, plus untracked files that are not ignored — is committed on top of the checkout's commit without touching the checkout, and that commit becomes the tip of the item's branch on origin. For an item with no branch, the branch is created at that commit and recorded as the item's; an item whose branch exists takes the changes only while that branch has no commits of its own and no local checkout. The base branch itself is never committed to or pushed.
 3. The branch is checked out per the isolation mode: with `main-repo`, the checkout that held the changes switches to the branch with its working tree untouched (it is the branch's tip, so the checkout is clean); with `worktree`, the branch gets a worktree and the carried changes are removed from the base branch checkout.
 
-With `--approve-and-merge`, the item is then advanced through every workflow state up to **Approved and Merged** with nothing asked on the way: no Claude session is launched at Agent Implementation, the PR is created and assigned to **you** (the person who merges is the approver of record), the CLI waits for the required CI/CD checks — the same no-override gate as `approve-pr` — and merges, then brings your local base branch up to date with the merge. On a new item it needs changes to carry. A run that stops (failing checks, say) leaves the item at the last state it reached; fix the branch and run `idea1 approve-pr`, or run the command again with `--url`, to continue.
+With `--approve-and-merge`, the item is then advanced through every workflow state up to **Approved and Merged** with nothing asked on the way: no Claude session is launched at Agent Implementation, the PR is created and assigned to **you** (the person who merges is the approver of record), the CLI waits for the required CI/CD checks — the same no-override gate as `approve-pr` — and merges, then brings your local base branch up to date with the merge. On a new item it needs changes to carry. A run that stops (failing checks, say) leaves the item at the last state it reached; fix the branch and run `idea1 approve-pr`, or run the command again with `--target`, to continue.
 
 ### ship-local-changes
 
@@ -135,12 +172,12 @@ With `--approve-and-merge`, the item is then advanced through every workflow sta
 idea1 ship-local-changes --title "Release prep" --project "Omega"
 idea1 ship --title "Release prep" --project "Omega" --branch-name release-prep
 idea1 ship --title "Release prep" --project "Omega" --isolation main-repo
-idea1 ship --url <url>             # an existing item whose branch has no commits yet
+idea1 ship --target <url>          # an existing item whose branch has no commits yet
 ```
 
 **Options:**
-- `-u, --url <url>` - An existing project item (default: create a new one).
-- `-t, --title <title>`, `-P, --project <name>` - The new item's title and Project (asked when missing and no URL is given).
+- `--target <url | branch | PR url>` - An existing project item (default: create a new one).
+- `-t, --title <title>`, `-P, --project <name>` - The new item's title and Project (asked when missing and no target is given).
 - `-n, --branch-name <name>` - Branch name under the branch prefix (default: derived from the item).
 - `-b, --base-branch <branch>` - The branch your checkout is on, which the item's branch is cut from and merges into (default: `baseBranch`).
 - `-M, --commit-message <message>` - Commit message (default: the item's title).
@@ -149,19 +186,20 @@ idea1 ship --url <url>             # an existing item whose branch has no commit
 
 ### next-workflow-step
 
-Advance a project item to its next workflow state and run that state's automation. On the item's branch no arguments are needed; from anywhere else pass the item URL — the CLI finds the branch on origin (moving into its local checkout when one exists) or, for an item without a branch yet, reads the current state from idea1.ai and creates the branch first.
+Advance a project item to its next workflow state and run that state's automation. On the item's branch no arguments are needed; from anywhere else pass the item (its URL, branch or PR URL) as `--target` — the CLI finds the branch on origin (moving into its local checkout when one exists) or, for an item without a branch yet, reads the current state from idea1.ai and creates the branch first. Several targets advance in parallel (see [Targets and parallel runs](#targets-and-parallel-runs)), each to its own next state or all to `--to`.
 
 With `--to <state>` the item advances through every state up to that one in a single run — the same as running `next` once per state: each state's automation runs and the state is recorded on idea1.ai before the next state is entered. A run that stops part way leaves the item at the last state it entered, and running it again continues from there. The CLI only moves forward; an item already at or past the requested state is left as it is.
 
 ```bash
 idea1 next                        # on the item's branch
-idea1 next --url <url>            # from anywhere in the repository
+idea1 next --target <url>         # from anywhere in the repository
 idea1 next --to "Dev Implementation"   # several states at once
+idea1 next --to "Needs Approval for Release" --target <url>,<url> --assignee octocat   # several items in parallel
 idea1 n
 ```
 
 **Options:**
-- `-u, --url <url>` - Project item URL (required when not on the item's branch).
+- `--target <url | branch | PR url>[,...]` - The project item(s) (default: the current branch, when it is an item's).
 - `--to <state>` - Workflow state to advance to (default: the next state).
 - `-p, --source-path <path>` - Path to source directory.
 - Any option of the state being entered (for example `--model`/`--effort` for Agent Implementation, `--assignee`/`--reviewers` for Needs Approval for Release). Options that were not supplied are prompted for when that state is reached.
@@ -179,10 +217,10 @@ The automation is idempotent, so re-running a transition after the item was move
 Start implementing a project item: put it under workflow management if needed, move it to **Agent Implementation** (through any intermediate states, which have no automation), set up the working environment and launch Claude Code with the implementation prompt — the repository's `prompts.agentImplementation` setting (see [Prompts](#prompts)), the built-in default, or a prompt you supply with `--entry-point-prompt`. This is the command behind "Send for Implementation" in the web client; `start-project-item` remains an alias so existing team command templates keep working.
 
 ```bash
-idea1 start-agent-implementation --url <url> [options]
-idea1 implement --url <url>
-idea1 start-project-item --url <url>     # alias
-idea1 implement --url <url> --entry-point-prompt "Read the spec in docs/spec.md and implement step 3"
+idea1 start-agent-implementation --target <url> [options]
+idea1 implement --target <url>
+idea1 start-project-item --target <url>     # alias
+idea1 implement --target <url> --entry-point-prompt "Read the spec in docs/spec.md and implement step 3"
 ```
 
 **Options:** all `start` options, plus the Agent Implementation options:
@@ -210,16 +248,14 @@ Supply `-iso worktree` or `-iso main-repo` on the command line to skip the promp
 Join an **in-progress** project item by setting up a working environment on its existing branch — for picking up work started elsewhere (e.g. on another machine, by another developer, or from the web client). It does not change the workflow state and never launches a Claude implementation session.
 
 ```bash
-idea1 join-project-item --project-item-url <url>
-idea1 join-project-item --branch-name <branch>
-idea1 join-project-item --pull-request-url <pr url>
-idea1 j --branch-name <branch>
+idea1 join-project-item --target <url>
+idea1 join-project-item --target <branch>
+idea1 join-project-item --target <pr url>
+idea1 j --target <branch>
 ```
 
-**Options (exactly one of the first three must be supplied — they are mutually exclusive):**
-- `--project-item-url <url>` - The Idea1.ai project item URL; its branch is discovered automatically.
-- `-n, --branch-name <branch>` - The branch to join; its associated project item is discovered automatically.
-- `--pull-request-url <url>` - A GitHub PR URL; its head branch is joined.
+**Options:**
+- `--target <url | branch | PR url>` - **Required.** The project item (its branch is discovered automatically), the branch to join (its project item is discovered automatically), or a GitHub PR (its head branch is joined). One target only.
 - `-p, --source-path <path>` - Path to source directory.
 - `-iso, --isolation <mode>` - Where to work on the branch (default: `worktree`). See [Isolation mode](#isolation-mode).
 
@@ -238,62 +274,66 @@ Attach the **current branch** to a project item, putting it under workflow manag
 On the base branch, `--carry-local-changes` gives the item a branch of its own instead and carries your uncommitted changes onto it, exactly as `start --carry-local-changes` does (see [Carrying local changes](#carrying-local-changes)); `--branch-name`, `--commit-message` and `--isolation` then apply. With `--approve-and-merge`, the attached (or new) branch is advanced through every state up to Approved and Merged without prompting.
 
 ```bash
-idea1 attach-project-item --url <url>
-idea1 attach-project-item                 # prompts for the URL (blank to create a new item)
-idea1 a --url <url>
+idea1 attach-project-item --target <url>
+idea1 attach-project-item                 # prompts for the target (blank to create a new item)
+idea1 a --target <url>
 ```
 
 **Options:**
-- `-u, --url <url>` - The Idea1.ai project item URL. Leave blank to create a new item (you'll be prompted for a `--title`).
-- `-t, --title <title>` - Title for the new project item (only when no URL is given).
+- `--target <url | branch | PR url>` - The project item, or its branch or that branch's PR. Leave blank to create a new item (you'll be prompted for a `--title`).
+- `-t, --title <title>` - Title for the new project item (only when no target is given).
 - `-p, --source-path <path>` - Path to source directory.
 - `-b, --base-branch <branch>` - Base branch / PR target for an independent feature (default: `working/release`).
-- `-w, --workflow-type <type>` - Development workflow type: `independent` or `integration`. You also choose any stack branch and (for integration) the integration branch.
+- `-w, --workflow-type <type>` - Development workflow type: `independent` or `integration`. You also choose any stack branch and (for integration) the integration branch. Asked here because attaching records a new branch on the item; an option given on the command line is not asked.
 - `-c, --carry-local-changes`, `--approve-and-merge`, `-n, --branch-name`, `-M, --commit-message`, `-iso, --isolation`, `-r, --reviewers` - As for `start`.
 
 **What it does:**
 1. Verifies the current branch is free to implement the item (a branch that already implements one is resumed with `join-project-item`).
-2. Creates the project item if no URL was supplied.
+2. Creates the project item if no target was supplied.
 3. Records the branch in the item's workflow context on idea1.ai (base branch, dev workflow type, stack/integration branch) in a single call, which puts an item outside workflow management under it at `Build Spec in Progress` and leaves an item that already has a state at that state. The branch is pushed to origin beforehand and stays as it is.
 4. If the item is already at `Dev Implementation` or later, makes sure a PR into the base branch exists.
 
 ### start-dev-implementation
 
-Advance the item to **Dev Implementation** — the same as `next --to "Dev Implementation"`. From Agent Implementation that is one step; from an earlier state every state in between is entered first, each with its own automation. An item already at or past Dev Implementation is left as it is.
+Advance the item to **Dev Implementation** — the same as `next --to "Dev Implementation"`. From Agent Implementation that is one step; from an earlier state every state in between is entered first, each with its own automation. An item already at or past Dev Implementation is left as it is. Several targets advance in parallel.
 
 ```bash
 idea1 start-dev-implementation [options]
 idea1 dev [options]
+idea1 dev --target <url>,<url>
 ```
 
 **Options:**
+- `--target <url | branch | PR url>[,...]` - The project item(s) (default: the current branch, when it is an item's)
 - `-p, --source-path <path>` - Path to worktree directory
 
 **What it does:**
 1. Enters every state before Dev Implementation the item has yet to reach (after syncing from origin)
-2. Commits and pushes all changes in the branch
+2. Commits and pushes all changes in the branch's local checkout; a branch with no checkout here carries its work on origin already
 3. Creates a PR of the branch into its base branch
 4. Records "Dev Implementation" on Idea1.ai
 5. If in a worktree and `removeWorktreeAtState` is `Dev Implementation`, removes the worktree. The main repo stays on its current branch; use `join-project-item` to work on the item in the main repo or a new worktree.
 
 ### ready-for-approval
 
-On a project item's branch, advance the item to **Needs Approval for Release** — the same as `next --to "Needs Approval for Release"`: from an earlier state, every state in between is entered first, each with its own automation (PR creation on the way into Dev Implementation, for one), and an item already at or past it is left as it is. On any other branch (an integration branch, a branch with no project item), open the branch's PR into the base branch when it has none. Either way its job is to name the **assignee**, who will approve the change by merging it.
+For a project item, advance the item to **Needs Approval for Release** — the same as `next --to "Needs Approval for Release"`: from an earlier state, every state in between is entered first, each with its own automation (PR creation on the way into Dev Implementation, for one), and an item already at or past it is left as it is. For any other branch (an integration branch, a branch with no project item), open the branch's PR into the base branch when it has none. Either way its job is to name the **assignee**, who will approve the change by merging it. Several targets run in parallel.
 
 ```bash
 idea1 ready-for-approval [options]
 idea1 rfa --assignee octocat
 idea1 rfa --assignee octocat                       # on working/integration/<name>-main: opens the PR into working/release
 idea1 rfa --assignee octocat -b working/release    # a branch with no project item, naming the PR target
+idea1 rfa --assignee octocat --target <url>,<branch>   # from working/release, in parallel
 ```
 
 **Options:**
+- `--target <url | branch | PR url>[,...]` - The project item(s) or branch(es) (default: the current branch; asked for on the base branch)
 - `-a, --assignee <username>` - **Required.** Who approves the PR by merging it (prompted from the repository's assignable users when omitted)
 - `-r, --reviewers <user1,user2>` - Who to request a review from (multi-select when omitted). Optional, and separate from approval — the assignee is the approver
 - `-b, --base-branch <branch>` - Branches with no project item only: the branch the PR targets (default: the open PR's base, else `baseBranch`, then `working/release`)
 - `--title <title>` - Branches with no project item only: PR title when the PR has to be created (default: `Integration <name> <YYYY-MM-DD>` for an integration branch, else the branch name; prompted when omitted)
 
-**What it does on a project item's branch:**
+**What it does for a project item:**
 1. Enters every state before Needs Approval for Release the item has yet to reach (after syncing from origin)
 2. Ensures no uncommitted or unpushed changes in the local checkout
 3. Requires the PR to exist, then sets the assignee (the transition refuses to proceed without one) and requests any reviewers
@@ -301,38 +341,39 @@ idea1 rfa --assignee octocat -b working/release    # a branch with no project it
 5. Records "Needs Approval for Release" on Idea1.ai. From here on the branch stays as it is
 6. If in a worktree and `removeWorktreeAtState` is `Needs Approval for Release` (the default) or earlier, removes the worktree
 
-**What it does on a branch with no project item:**
-1. Requires you to be on the branch with nothing uncommitted, unpushed or behind origin; refuses on the base branch itself and refuses a PR straight into `main` (that is `idea1 release`)
+**What it does for a branch with no project item:**
+1. Requires the branch on origin and, when it is checked out here, nothing uncommitted, unpushed or behind origin in that checkout; refuses the base branch itself and refuses a PR straight into `main` (that is `idea1 release`)
 2. Reuses the branch's open PR (and its base) when one exists; otherwise creates the PR into the base branch with the approval chain of what the branch carries as its body — every PR merged into the branch with its author and approver, and commits pushed straight to the branch listed as the change under review (they are not an exception: this PR is their stage-1 approval)
 3. Sets the assignee and requests any reviewers
 4. Records no workflow status — there is no project item
 
 ### approve-pr
 
-On a project item's branch, advance the item to **Approved and Merged** — the same as `next --to "Approved and Merged"`: from an earlier state, every state in between is entered first, each with its own automation, and an item already at or past it is left as it is. On any other branch, merge the branch's PR. Run by the PR's **assignee**: it waits for the CI/CD suite and merges the PR, and that merge is the approval of record. There is no admin override at this stage for any branch.
+For a project item, advance the item to **Approved and Merged** — the same as `next --to "Approved and Merged"`: from an earlier state, every state in between is entered first, each with its own automation, and an item already at or past it is left as it is. For any other branch, merge the branch's PR. Run by the PR's **assignee**: it waits for the CI/CD suite and merges the PR, and that merge is the approval of record. There is no admin override at this stage for any branch. Several targets are approved in parallel, from `working/release`: each merges as soon as its PR can, and your checkout ends on `working/release`, up to date with every merge, with no worktree left behind.
 
 ```bash
 idea1 approve-pr
 idea1 approve
-idea1 approve-pr --branch working/integration/<name>-main   # from anywhere: the branch need not be checked out
+idea1 approve-pr --target working/integration/<name>-main   # from anywhere: the branch need not be checked out
+idea1 approve-pr --target <url>,<branch>,<pr url> --yes      # several, in parallel
 ```
 
 **Options:**
-- `-b, --branch <branch>` - Branch whose PR to approve (default: the current branch). A project item's branch is approved through the workflow; any other branch through its PR alone
+- `--target <url | branch | PR url>[,...]` - The project item(s) or branch(es) whose PR to approve (default: the current branch; asked for on the base branch). A project item is approved through the workflow; any other branch through its PR alone
 - `-y, --yes` - Merge without asking for confirmation. The approver check and the wait for the required checks still apply
 
-**What it does on a project item's branch:**
+**What it does for a project item:**
 1. Enters every state before Approved and Merged the item has yet to reach (after syncing from origin)
 2. Verifies the approver: refuses when the PR has no assignee, and when you are not the assignee warns that the merge record will name you instead and requires an explicit confirmation (the evidence report lists such a merge as an exception)
-3. Waits for the required CI/CD checks on the PR — the checks of the branch's tip on origin, which the PR must have picked up first — then merges the PR. A red or unfinished suite stops the merge — there is no admin override at this stage. The branch is merged as it stands. A legacy branch that still carries its workflow context file has the file removed and pushed instead, and the approval is left for a second run once the re-run suite passes
+3. Refuses a PR that conflicts with its base straight away, before any wait, and again after the checks (another merge may have made it conflict meanwhile). Waits for the required CI/CD checks on the PR — the checks of the branch's tip on origin, which the PR must have picked up first — then merges the PR. A red or unfinished suite stops the merge — there is no admin override at this stage. The branch is merged as it stands. A legacy branch that still carries its workflow context file has the file removed and pushed instead, and the approval is left for a second run once the re-run suite passes
 4. Records "Approved and Merged" on Idea1.ai
-5. Switches to the base branch and deletes the feature branch. If still running inside a worktree, removes the worktree instead of switching branches — this always happens, since the base branch can't be checked out in place there
+5. Deletes the feature branch: when it is checked out in the main repo, switches to the base branch first; inside a worktree, removes the worktree instead — this always happens, since the base branch can't be checked out in place there. Then fast-forwards the base branch's local checkout to the merge
 
-**What it does on a branch with no project item:**
+**What it does for a branch with no project item:**
 1. Finds the branch's PR (run `ready-for-approval` first if there is none) and takes the target branch from it
 2. Refuses while any open PR still targets the branch — merging would retire the branch and orphan them
-3. Verifies the approver exactly as above, waits for the required CI/CD checks and merges. A red or unfinished suite stops the merge — no override
-4. Deletes the branch on origin and locally (removing its worktree, or switching to the base branch first when it is checked out in the main repo). Records no workflow status
+3. Verifies the approver exactly as above, refuses a conflicting PR, waits for the required CI/CD checks and merges. A red or unfinished suite stops the merge — no override
+4. Deletes the branch on origin and locally (removing its worktree, or switching to the base branch first when it is checked out in the main repo), and fast-forwards the base branch's local checkout. Records no workflow status
 
 ### release
 
@@ -343,16 +384,19 @@ idea1 release                                  # prompts for any version bumps,
 idea1 release --bumps filekit=minor,cli=patch  # bump types given up front
 idea1 release --pr-mode merge                  # enable auto-merge (or wait for the checks and merge here)
 idea1 release --approve                        # approve and merge the open release PR
+idea1 release --target <url>,<branch>          # approve these into the release branch first, then release
 idea1 r
 ```
 
 **Options:**
 - `-b, --branch <branch>` - Source branch to release from (default: `baseBranch`, then `working/release`)
-- `-t, --target <branch>` - Target branch to release into (default: `releaseTargetBranch`, then `main`)
+- `-t, --target-branch <branch>` - Target branch to release into (default: `releaseTargetBranch`, then `main`)
 - `--approve` - Approve and merge the release PR that is already open, instead of opening one. See [Approving an open release](#approving-an-open-release)
+- `--target <url | branch | PR url>[,...]` - Project items, branches or PRs to approve into the release branch before releasing it. Asked for, blank by default, which releases the branch as it is. See [Releasing with approvals](#releasing-with-approvals)
 - `--bumps <package=type,...>` - Version bump per changed package, as `patch`, `minor` or `major` (e.g. `filekit=minor,cli=patch`). A changed package it doesn't name is prompted for, with `patch` preselected; a package that needs no bump is ignored
 - `-pr, --pr-mode <mode>` - `create` (default) creates the PR and opens it in the browser so you merge it there once the required checks pass; `merge` turns on GitHub's auto-merge, so GitHub merges once the required checks pass, and falls back to waiting for every check with `gh` and merging here when GitHub can't auto-merge (the PR is already mergeable, or the repository doesn't allow auto-merge). You are the recorded merger, and the merge is the recorded approval, in every case
 - `--title <title>` - PR title (default: `Release <YYYY-MM-DD>`)
+- `-y, --yes` - In `merge` mode, merge without asking for confirmation; with `--target`, also start the approvals without asking. The required checks still gate every merge
 
 **What it does:**
 1. Requires you to be on the release branch with nothing uncommitted, unpushed or behind origin
@@ -362,6 +406,24 @@ idea1 r
 5. In `merge` mode, enables auto-merge, or waits for the required CI/CD checks and merges normally. Checks that fail, never start or never finish stop the release; an admin override is available but takes an explicit confirmation and a required reason, and the exception is recorded as a comment on the PR before anything is merged
 6. Opens GitHub Actions once it has merged the PR itself, where the merge to `main` has triggered the production deploy
 
+#### Releasing with approvals
+
+`idea1 release --target <items, branches or PRs>` releases the release branch once the given targets are approved into it, as one unattended sequence:
+
+1. **Checks:** your checkout must be on the release branch, clean and level with origin. Then every target is resolved exactly as `approve-pr` resolves several targets.
+2. **Questions, all asked up front:**
+   - the options the targets' workflow states need, then one confirmation of the approvals;
+   - the version bump of every versioned package changed on the release branch or on any target's branch;
+   - the title (`--pr-mode` is asked as usual).
+3. **Approvals:** every target's PR is approved in parallel, each in its own unattended run, exactly as `approve-pr` does.
+4. **Fast fail:** the first target that fails (a red check, or a PR that cannot merge) stops the others, and nothing is released. Fix it and run the command again: the approvals that merged stay merged.
+5. **Release:** once every target has merged, the release runs as it does on its own, in your up-to-date checkout:
+   - it bumps the versions;
+   - it opens the release PR into `main`, assigned to you;
+   - it carries on in the chosen PR mode.
+
+In interactive mode the whole sequence runs as a background job (see `/jobs`); otherwise it runs in the foreground, reporting each run's steps.
+
 #### Approving an open release
 
 `idea1 release --approve` finds the open release PR from the release branch into the target and merges it as its approver, after the same assignee check as `approve-pr`:

package/dist/cli/resolver.d.ts

@@ -12,6 +12,7 @@ import type { Command } from '../types/index.js';
  *    applicable, so it is neither prompted nor required and left unset.
  * 1. Skip if isFlag — flags are never prompted
  * 2. Skip if already in parsed — value was provided on CLI
+ * 2a. If resolveValue exists: let it resolve the value (it may ask), and use that
  * 3. If has default and promptWhenDefaultExists is not true: silently use default
  * 4. If no default: prompt (required — re-prompt until valid value given)
  * 5. If has default and promptWhenDefaultExists is true: prompt showing default as hint

package/dist/cli/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/cli/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,mBAAmB,CAAC;AAKhE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAwGjC"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/cli/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,mBAAmB,CAAC;AAKhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CA6GjC"}

package/dist/cli/resolver.js

@@ -14,6 +14,7 @@ import { resolveNamedList } from './named-lists.js';
  *    applicable, so it is neither prompted nor required and left unset.
  * 1. Skip if isFlag — flags are never prompted
  * 2. Skip if already in parsed — value was provided on CLI
+ * 2a. If resolveValue exists: let it resolve the value (it may ask), and use that
  * 3. If has default and promptWhenDefaultExists is not true: silently use default
  * 4. If no default: prompt (required — re-prompt until valid value given)
  * 5. If has default and promptWhenDefaultExists is true: prompt showing default as hint
@@ -56,6 +57,10 @@ export async function resolveOptions(command, parsed) {
             }
             continue;
         }
+        if (option.resolveValue) {
+            resolved[option.longName] = await option.resolveValue(resolved);
+            continue;
+        }
         const defaultVal = resolveDefault(option);
         const hasDefault = defaultVal !== undefined;
         const promptWhenDefault = option.promptWhenDefaultExists !== false; // default true

package/dist/cli/resolver.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/cli/resolver.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/cli/resolver.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyE1D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AASA;;GAEG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0E1D"}

package/dist/cli.js

@@ -21,7 +21,8 @@ export async function runCli(argv) {
     if (!isSimpleFlag) {
         try {
             repoRoot = await git.getRepoRoot();
-            await ensureSetup(repoRoot);
+            // The main clone is set up, never a worktree, whose branch a setup change would make dirty.
+            await ensureSetup((await git.getMainRepoRoot()).trim());
         }
         catch {
             // Not in a git repository - skip setup

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/approve-pr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"approve-pr.d.ts","sourceRoot":"","sources":["../../src/commands/approve-pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAuFjD,eAAO,MAAM,gBAAgB,EAAE,OAuC9B,CAAC"}
+{"version":3,"file":"approve-pr.d.ts","sourceRoot":"","sources":["../../src/commands/approve-pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAyEjD,eAAO,MAAM,gBAAgB,EAAE,OAyB9B,CAAC"}

package/dist/commands/approve-pr.js

@@ -6,7 +6,8 @@ import * as worktree from '../services/worktree.js';
 import { WorkflowStates } from '../workflow/data/workflow-states.js';
 import { cleanUpMergedBranch, mergeAsApprover, mergeConfirmationOption } from '../workflow/engine/approval-flow.js';
 import { confirmApproverIdentity } from '../workflow/engine/release-engine.js';
-import { advanceAsNeededTo, getProjectItemSummaryForBranch, resolveTransition, resolveTransitionIfManaged } from '../workflow/engine/workflow-engine.js';
+import { advanceAsNeededTo, resolveTarget } from '../workflow/engine/workflow-engine.js';
+import { runForTargets, targetOption } from '../jobs/targets.js';
 import { deferredHandlerOptions } from '../workflow/engine/handlers/index.js';
 /**
  * Stage 1 approval for a branch with no project item: the assignee merges the branch's PR once
@@ -17,10 +18,9 @@ async function approvePrOnBranchWithNoItem(branchName, confirmed) {
     await github.ensureGitHubCli();
     // Captured before anything moves: cleanup may switch branches or remove a worktree.
     const workingPath = await git.getCheckoutPathForBranch(branchName);
-    const isCurrentBranch = (await git.getCurrentBranch()) === branchName;
     const prInfo = await github.getPrInfo(branchName);
     if (!prInfo) {
-        throw new Error('No PR found for this branch. Run idea1 ready-for-approval first to open it and name its approver.');
+        throw new Error(`No PR found for ${branchName}. Run idea1 ready-for-approval --target ${branchName} first to open it and name its approver.`);
     }
     logger.info(`PR #${prInfo.number} found`);
     const state = prInfo.state.toUpperCase();
@@ -40,7 +40,7 @@ async function approvePrOnBranchWithNoItem(branchName, confirmed) {
         logger.dim(`PR #${prInfo.number} is already merged; cleaning up the branch.`);
     }
     else {
-        if (isCurrentBranch) {
+        if (workingPath) {
             await git.ensureBranchUpToDate();
         }
         // Merging retires the branch, which would orphan any PR still targeting it.
@@ -56,46 +56,29 @@ async function approvePrOnBranchWithNoItem(branchName, confirmed) {
     logger.newline();
     logger.success(`PR merged into ${baseBranch} - the merge is the recorded approval`);
 }
-/**
- * The transition for a named branch when it is a project item's branch, else null.
- */
-async function resolveTransitionForNamedBranch(branchName, resolved) {
-    const projectItemUrl = (await getProjectItemSummaryForBranch(branchName))?.url ?? null;
-    return projectItemUrl ? resolveTransition({ projectItemUrl, options: resolved }) : null;
-}
 export const approvePrCommand = {
     name: 'approve-pr',
     aliases: ['approve'],
-    description: 'Approve the PR by merging it (the assignee runs this) - on a project item\'s branch (advancing the item through every state before it) or any other branch',
+    description: 'Approve PRs by merging them once their checks pass (the assignee runs this) - project items (advancing each through every state before it) or branches with no item; several run in parallel',
     options: [
-        {
-            longName: 'branch',
-            shortName: 'b',
-            description: 'Branch whose PR to approve (default: the current branch)',
-            defaultValue: '',
-            promptWhenDefaultExists: false
-        },
-        // On a project item's branch the item may be further back; the states it passes through on the
-        // way (the assignee of Needs Approval for Release, for one) ask for their own options.
+        targetOption(true),
+        // A project item may be further back; the states it passes through on the way (the assignee
+        // of Needs Approval for Release, for one) ask for their own options.
         ...deferredHandlerOptions([])
     ],
     async execute(resolved) {
-        const requestedBranch = resolved['branch'] || null;
-        // A named branch the platform records as an item's is approved through
-        // the workflow engine, from wherever the command is run. With no branch named, the current
-        // branch is the target, managed or not.
-        const transition = requestedBranch
-            ? await resolveTransitionForNamedBranch(requestedBranch, resolved)
-            : await resolveTransitionIfManaged({ options: resolved });
-        if (transition) {
-            await advanceAsNeededTo(transition, WorkflowStates.ApprovedAndMerged);
-            return;
-        }
-        const branchName = requestedBranch ?? await git.getCurrentBranch();
-        if (branchName === 'HEAD') {
-            throw new Error('You are not on a branch (detached HEAD). Check out the branch to approve, or pass --branch <name>.');
-        }
-        await approvePrOnBranchWithNoItem(branchName, resolved[mergeConfirmationOption.longName] === 'true');
+        await runForTargets(approvePrCommand, resolved, {
+            advancesTo: () => WorkflowStates.ApprovedAndMerged,
+            itemlessBranches: true,
+            run: async (target) => {
+                const resolvedTarget = await resolveTarget({ target, options: resolved });
+                if (resolvedTarget.kind === 'item') {
+                    await advanceAsNeededTo(resolvedTarget.transition, WorkflowStates.ApprovedAndMerged);
+                    return;
+                }
+                await approvePrOnBranchWithNoItem(resolvedTarget.branchName, resolved[mergeConfirmationOption.longName] === 'true');
+            }
+        });
     }
 };
 //# sourceMappingURL=approve-pr.js.map