claude-plugin-viban 1.0.35 → 1.0.36

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "viban",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
   "author": {
     "name": "happy-nut"

package/README.md

@@ -50,6 +50,7 @@ This separation keeps your workflow clean and prevents context switching.
 ## Requirements
 
 - zsh
+- python3 (macOS/Linux built-in)
 - [gum](https://github.com/charmbracelet/gum)
 - [jq](https://jqlang.github.io/jq/)
 
@@ -289,7 +290,8 @@ claude-plugin-viban/
 ├── docs/
 │   └── CLAUDE.md            # Claude Code integration guide
 ├── scripts/
-│   └── check-deps.sh        # Dependency checker
+│   ├── check-deps.sh        # Dependency checker
+│   └── tui_coprocess.py     # Persistent Python coprocess for TUI rendering
 ├── skills/
 │   ├── assign/SKILL.md      # /viban:assign skill
 │   ├── setup/SKILL.md       # /viban:setup skill

package/commands/setup.md

@@ -35,9 +35,10 @@ Check which dependencies are already installed:
 
 ```bash
 command -v zsh &> /dev/null && echo "✓ zsh" || echo "✗ zsh"
+command -v python3 &> /dev/null && echo "✓ python3" || echo "✗ python3"
 command -v gum &> /dev/null && echo "✓ gum" || echo "✗ gum"
 command -v jq &> /dev/null && echo "✓ jq" || echo "✗ jq"
-command -v viban &> /dev/null && echo "✓ viban" || echo "✗ viban"
+command -v viban &> /dev/null && echo "✓ viban ($(viban --version 2>/dev/null || echo 'not installed'))" || echo "✗ viban"
 ```
 
 ### Step 3: Install Missing Dependencies
@@ -92,12 +93,14 @@ sudo dnf install -y gum
 sudo pacman -S --noconfirm zsh jq gum
 ```
 
-### Step 4: Install viban CLI
+### Step 4: Install or Update viban CLI
 
 ```bash
-npm install -g claude-plugin-viban
+npm install -g claude-plugin-viban@latest
 ```
 
+This installs viban if not present, or updates to the latest version if already installed.
+
 ### Step 5: Verify Installation
 
 ```bash
@@ -113,6 +116,7 @@ If successful, show:
 
 All dependencies installed:
   ✓ zsh
+  ✓ python3
   ✓ gum
   ✓ jq
   ✓ viban
@@ -121,8 +125,8 @@ You can now use:
   viban              Open TUI board
   viban add "task"   Add a task
   viban list         List all tasks
-  /assign            Auto-resolve next issue
-  /task              Create structured issue
+  /viban:assign      Auto-resolve next issue
+  /viban:add         Create structured issue
 ```
 
 ### Step 6: Workflow Setup Introduction

package/docs/CLAUDE.md

@@ -29,6 +29,16 @@ EOF
 - 스피너 있을 때/없을 때 둘 다 확인
 - 한글 포함 제목 truncation
 
+## Dependency Management
+
+**새 런타임 의존성 추가 시 4곳 모두 업데이트 필수:**
+- `README.md` (Requirements 섹션)
+- `scripts/check-deps.sh` (check_dep 호출)
+- `install.sh` (install_pkg 호출)
+- `skills/setup/SKILL.md` (체크 목록 + 완료 메시지)
+
+릴리스 전 누락 여부 확인할 것.
+
 ## Release Rules
 
 **릴리즈는 사용자가 명시적으로 요청할 때만 수행한다.**
@@ -106,6 +116,64 @@ local title=$(printf '%s' "$issue" | jq -r '.title')
 
 Violating this rule causes jq parse errors on issues with newlines/tabs in description.
 
+### Coprocess Pattern (FIFO-based)
+
+**zsh `coproc` 사용 금지** - `read -sk1` 키 입력과 충돌. 대신 FIFO + fd 사용.
+
+```bash
+# BAD: coproc interferes with read -sk1
+coproc python3 script.py
+echo "cmd" >&p
+read -r result <&p
+
+# GOOD: explicit FIFOs with file descriptors
+mkfifo "$_in_fifo" "$_out_fifo"
+python3 script.py < "$_in_fifo" > "$_out_fifo" &
+exec 7>"$_in_fifo" 8<"$_out_fifo"
+echo "cmd" >&7
+read -r result <&8
+```
+
+### Variable Declaration in Loops
+
+**`local` 을 루프 안에서 재선언하면 현재 값이 stdout으로 출력됨**
+
+```bash
+# BAD: 2회차부터 _bc의 값이 stdout에 찍힘
+while ...; do
+  local _cc=${#_title} _bc
+done
+
+# GOOD: 루프 밖에서 선언, 안에서 할당만
+local _cc _bc
+while ...; do
+  _cc=${#_title}
+done
+```
+
+### EXIT Trap in Subshells
+
+**`$(...)` 서브셸에서 EXIT trap 이 발동됨** - cleanup 함수에 가드 필요
+
+```bash
+cleanup() {
+    [[ ${ZSH_SUBSHELL:-0} -gt 0 ]] && return
+    # ... actual cleanup
+}
+```
+
+### Parameter Flag Syntax
+
+**`${(@f)var}` 에서 `$` 접두사 불필요**
+
+```bash
+# BAD: bad substitution error
+${(@f)$_COPROC_RESULT}
+
+# GOOD
+${(@f)_COPROC_RESULT}
+```
+
 ### Locale Handling (zsh-specific)
 
 **`LC_ALL=C var=val` persists in zsh (unlike bash)**

package/install.sh

@@ -124,6 +124,9 @@ echo ""
 # Install zsh (required for viban script)
 install_pkg "zsh"
 
+# Install python3 (required for TUI coprocess)
+install_pkg "python3"
+
 # Install jq
 install_pkg "jq"
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-plugin-viban",
-  "version": "1.0.35",
+  "version": "1.0.36",
   "description": "Terminal Kanban TUI for AI-human collaborative issue tracking",
   "main": "bin/viban",
   "bin": {

package/scripts/check-deps.sh

@@ -33,6 +33,7 @@ check_dep() {
     fi
 }
 
+check_dep "python3" "brew install python3" "apt install python3"
 check_dep "gum" "brew install gum" "See https://github.com/charmbracelet/gum#installation"
 check_dep "jq" "brew install jq" "apt install jq"
 

package/skills/setup/SKILL.md

@@ -36,9 +36,10 @@ Check which dependencies are already installed:
 
 ```bash
 command -v zsh &> /dev/null && echo "✓ zsh" || echo "✗ zsh"
+command -v python3 &> /dev/null && echo "✓ python3" || echo "✗ python3"
 command -v gum &> /dev/null && echo "✓ gum" || echo "✗ gum"
 command -v jq &> /dev/null && echo "✓ jq" || echo "✗ jq"
-command -v viban &> /dev/null && echo "✓ viban" || echo "✗ viban"
+command -v viban &> /dev/null && echo "✓ viban ($(viban --version 2>/dev/null || echo 'not installed'))" || echo "✗ viban"
 ```
 
 ### Step 3: Install Missing Dependencies
@@ -93,12 +94,14 @@ sudo dnf install -y gum
 sudo pacman -S --noconfirm zsh jq gum
 ```
 
-### Step 4: Install viban CLI
+### Step 4: Install or Update viban CLI
 
 ```bash
-npm install -g claude-plugin-viban
+npm install -g claude-plugin-viban@latest
 ```
 
+This installs viban if not present, or updates to the latest version if already installed.
+
 ### Step 5: Verify Installation
 
 ```bash
@@ -114,6 +117,7 @@ If successful, show:
 
 All dependencies installed:
   ✓ zsh
+  ✓ python3
   ✓ gum
   ✓ jq
   ✓ viban
@@ -122,8 +126,8 @@ You can now use:
   viban              Open TUI board
   viban add "task"   Add a task
   viban list         List all tasks
-  /assign            Auto-resolve next issue
-  /task              Create structured issue
+  /viban:assign      Auto-resolve next issue
+  /viban:add         Create structured issue
 ```
 
 ### Step 6: Workflow Setup Introduction

package/skills/release/SKILL.md

@@ -1,100 +0,0 @@
----
-name: release
-description: "Bump version, commit, tag, and push to trigger npm publish"
----
-
-# /release - Release a new version
-
-Bump the package version, commit, tag, and push to trigger the automated npm publish workflow.
-
-## Execution Steps
-
-### Step 1: Pre-flight checks
-
-```bash
-# Ensure on main branch
-git branch --show-current  # must be "main"
-
-# Ensure working tree is clean (no uncommitted changes)
-git status --porcelain
-
-# Ensure up to date with remote
-git fetch origin main
-git diff origin/main --stat
-```
-
-If not on main, working tree is dirty, or behind remote: **stop and inform user**.
-
-### Step 2: Determine version bump
-
-Read current version from `package.json`:
-
-```bash
-grep '"version"' package.json
-```
-
-Ask user with AskUserQuestion:
-- header: "Version"
-- question: "Current version is {current}. What kind of bump?"
-- options:
-  - "patch" (x.y.Z) - bug fixes, small changes
-  - "minor" (x.Y.0) - new features, backward compatible
-  - "major" (X.0.0) - breaking changes
-- multiSelect: false
-
-Calculate the new version based on selection.
-
-### Step 3: Show changelog preview
-
-Show commits since last tag:
-
-```bash
-git log $(git describe --tags --abbrev=0)..HEAD --oneline
-```
-
-Display to user for confirmation before proceeding.
-
-### Step 4: Run tests
-
-```bash
-zsh tests/run_all.zsh
-```
-
-If tests fail: **stop and inform user**. Do not release with failing tests.
-
-### Step 5: Bump version and release
-
-```bash
-# Update package.json version
-# (use jq or sed to update the version field)
-
-# Commit
-git add package.json
-git commit -m "{new_version}"
-
-# Tag
-git tag v{new_version}
-
-# Push with tags
-git push origin main --tags
-```
-
-### Step 6: Confirm
-
-```
-╭──────────────────────────────────────╮
-│  Released v{new_version}!            │
-╰──────────────────────────────────────╯
-
-- npm publish: triggered via GitHub Actions
-- GitHub Release: auto-generated with release notes
-
-Check: https://github.com/happy-nut/claude-plugin-viban/actions
-```
-
-## Error Handling
-
-- **Not on main**: "Switch to main branch first"
-- **Dirty working tree**: "Commit or stash changes first"
-- **Tests failing**: "Fix failing tests before release"
-- **Push failed**: "Check remote access and try again"