claude-plugin-viban 1.3.2 → 1.3.3

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.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "viban",
3
- "version": "1.3.2",
3
+ "version": "1.3.3",
4
4
  "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
5
5
  "author": {
6
6
  "name": "happy-nut"
@@ -16,8 +16,8 @@ Examples:
16
16
 
17
17
  How it works:
18
18
  1. Assigns N backlog issues and creates isolated git worktrees (`.viban/worktrees/{id}`)
19
- 2. Spawns one opus agent per issue — each agent works exclusively in its own worktree
20
- 3. Agents analyze, implement, commit, push, and create PRs independently
21
- 4. Coordinator collects results, runs tests, and cleans up worktrees
19
+ 2. Spawns one opus agent per issue — each agent only analyzes, implements, and commits
20
+ 3. Coordinator removes worktrees, verifies local branches, pushes, and creates PRs
21
+ 4. Coordinator runs tests, moves issues to review, and reports results
22
22
 
23
23
  **IMPORTANT:** Never read or write `viban.json` directly — always use `viban` CLI commands. Direct JSON access causes race conditions.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-plugin-viban",
3
- "version": "1.3.2",
3
+ "version": "1.3.3",
4
4
  "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
5
5
  "main": "bin/viban",
6
6
  "bin": {
@@ -139,21 +139,14 @@ You are one of {N} parallel agents working in isolated git worktrees.
139
139
  Resolves: #{ID}"
140
140
  ```
141
141
 
142
- 4. Push and create PR:
143
- ```bash
144
- git push -u origin {BRANCH}
145
- gh pr create --title "type: title" --body "..." --base main
146
- ```
147
-
148
- 5. Move issue to review:
149
- ```bash
150
- cd {REPO_ROOT}
151
- viban review {ID}
152
- ```
153
-
154
- ABSOLUTE RULES (violating any of these corrupts the board):
155
- - Run `viban review {ID}` as your LAST command before finishing. Always. Even on errors.
156
- - **FORBIDDEN: `viban done`** — this DELETES the card permanently. NEVER run it. Only the human runs `viban done` after reviewing the PR.
142
+ 4. That's it. Stop after committing.
143
+
144
+ ABSOLUTE RULES:
145
+ - **Your job ends after committing.** The coordinator handles push, PR creation, and issue status.
146
+ - **FORBIDDEN: `git push`** — the coordinator pushes from the main repo after verifying.
147
+ - **FORBIDDEN: `gh pr create`** — the coordinator creates PRs after transplanting branches.
148
+ - **FORBIDDEN: `viban done`** — this DELETES the card permanently.
149
+ - **FORBIDDEN: `viban review`** — the coordinator handles issue status.
157
150
  - **FORBIDDEN: reading or writing `viban.json`** — use CLI commands only.
158
151
  - Do NOT run the full test suite — the coordinator handles that.
159
152
  - Do NOT remove the worktree — the coordinator handles cleanup.
@@ -178,44 +171,66 @@ for each (ID, BRANCH) in ISSUES:
178
171
 
179
172
  1. Wait for all background agents to complete (poll via `TaskOutput`)
180
173
  2. Collect results — note successes and failures
181
- 3. For any issue where `viban review` was not called, run it now as safety net:
182
- ```bash
183
- viban review $ID
184
- ```
185
174
 
186
175
  ---
187
176
 
188
177
  ## Phase 3: TRANSPLANT & CLEANUP
189
178
 
190
- After all agents finish, for each issue:
191
-
192
- ### 3.1 Verify Local Branches
193
-
194
- The local branch already exists (created by `git worktree add -b`). After worktree removal, the branch and its commits remain in the local repo.
179
+ After all agents finish, the coordinator handles everything from the main repo root.
195
180
 
196
181
  ```bash
197
182
  REPO_ROOT=$(git rev-parse --show-toplevel)
198
183
  cd "$REPO_ROOT"
184
+ ```
185
+
186
+ ### 3.1 Remove Worktrees (branches survive)
199
187
 
188
+ Worktree removal does NOT delete the branch or its commits — they remain in the local repo.
189
+
190
+ ```bash
191
+ for entry in "${ISSUES[@]}"; do
192
+ ID="${entry%%|*}"
193
+ WT_DIR="$REPO_ROOT/.viban/worktrees/$ID"
194
+ git worktree remove "$WT_DIR" --force
195
+ done
196
+ ```
197
+
198
+ ### 3.2 Verify Local Branches
199
+
200
+ Confirm each branch has commits from the agent:
201
+
202
+ ```bash
200
203
  for entry in "${ISSUES[@]}"; do
201
204
  BRANCH="${entry##*|}"
202
205
  git log --oneline -3 "$BRANCH"
203
206
  done
204
207
  ```
205
208
 
206
- ### 3.2 Remove Worktrees
209
+ If a branch has no new commits (agent failed), skip it and report.
207
210
 
208
- PRs have been created worktrees are no longer needed:
211
+ ### 3.3 Push Branches & Create PRs
212
+
213
+ For each branch with commits, push from the main repo and create a PR:
209
214
 
210
215
  ```bash
211
216
  for entry in "${ISSUES[@]}"; do
212
217
  ID="${entry%%|*}"
213
- WT_DIR="$REPO_ROOT/.viban/worktrees/$ID"
214
- git worktree remove "$WT_DIR" --force
218
+ BRANCH="${entry##*|}"
219
+
220
+ # Push the local branch to remote
221
+ git push -u origin "$BRANCH"
222
+
223
+ # Create PR
224
+ gh pr create --head "$BRANCH" --base main \
225
+ --title "type: title" \
226
+ --body "Resolves: #${ID}"
227
+
228
+ # Move issue to review
229
+ viban review "$ID"
215
230
  done
216
231
  ```
217
232
 
218
- ### 3.3 Verify PRs Exist
233
+ ### 3.4 Verify PRs Exist
219
234
 
220
235
  ```bash
221
236
  for entry in "${ISSUES[@]}"; do
@@ -269,9 +284,10 @@ Worktrees cleaned up. All PRs ready for human review.
269
284
 
270
285
  ## Error Handling
271
286
 
272
- - **Agent fails mid-work**: coordinator calls `viban review {ID}` as safety net
287
+ - **Agent fails mid-work**: coordinator still attempts push + PR for any commits on the branch. If no commits, skip and call `viban review {ID}` to unblock the card.
273
288
  - **Worktree creation fails**: skip that issue, log error, continue with others
274
- - **PR creation fails in agent**: coordinator reports it; local branch still available for manual PR
289
+ - **Push fails**: report it; local branch still available for manual push
290
+ - **PR creation fails**: report it; branch is already pushed, user can create PR manually
275
291
  - **Test failures**: report which branch likely caused the failure
276
292
 
277
293
  ---