feat(sync): implement kanban-project-sync script with concurrency control and background execution

2026-02-19 11:08:15 +00:00
parent 7937266262
commit 5016d4c39c
9 changed files with 319 additions and 268 deletions
@@ -0,0 +1,32 @@
+## 1. Script Skeleton and Concurrency
+
+- [x] 1.1 Create `kanban-project-sync` script with argument parsing (`--project`, `--board`, `--background`), usage help, and exit code constants
+- [x] 1.2 Implement `flock`-based locking with pending flag file and re-run loop
+- [x] 1.3 Implement `--background` mode (re-exec self detached with output to log file)
+- [x] 1.4 Add connectivity check (`pcli status`) with exit code 2 on failure
+
+## 2. Bootstrap Phase
+
+- [x] 2.1 Implement find-or-create project by name
+- [x] 2.2 Implement find-or-create board by name within project
+- [x] 2.3 Implement find-or-create lists (Backlog, To Do, Planning, In Progress, Review, Done) with correct positions
+- [x] 2.4 Implement find-or-create `agent` label on the board
+
+## 3. Reconciliation Phases
+
+- [x] 3.1 Gather OpenSpec state — list active changes, parse artifact completion and task checkbox state
+- [x] 3.2 Determine target list for each change based on OpenSpec state (Planning / In Progress / Review)
+- [x] 3.3 Gather existing Planka agent-labelled cards and build name→card map
+- [x] 3.4 Create missing cards (new OpenSpec changes without a Planka card) with agent label
+- [x] 3.5 Move cards to correct list when current list doesn't match target
+- [x] 3.6 Sync task checklists — create/update task lists and tasks on cards from `tasks.md`
+- [x] 3.7 Move orphaned agent cards (no matching active change) to Done
+
+## 4. Reporting and Summary
+
+- [x] 4.1 Add summary output — infrastructure created, cards created/moved, tasks synced, errors
+
+## 5. Skill and Documentation Updates
+
+- [x] 5.1 Simplify `.claude/commands/kanban-sync.md` to invoke `kanban-project-sync --background`
+- [x] 5.2 Update `CLAUDE.md` Planka Sync section to reference the script