Skip to content

v3.0.0: the to-do opens on a board where you answer and approve - #95

Open
cskwork wants to merge 2 commits into
mainfrom
feat/todo-board
Open

cskwork wants to merge 2 commits into
mainfrom
feat/todo-board

Conversation

@cskwork

@cskwork cskwork commented Nov 19, 2026

Copy link
Copy Markdown
Owner

v3.0.0: The to-do opens on a board where you answer and approve, and the tray app opens it

Problem

The web page and the tray app showed one long list or one decision at a time. With 40 open items across tickets, phases and agents, the human could not see at a glance what waited on them, what an agent was doing, and where each piece of work stood, and a ticket with a decision item showed up twice. Factory or automation status (lanes busy, runs, failures) had no place on the page, so it lived in another tool.

This release is major because the default screen changed: the page opens on the board instead of the list, and the tray app no longer opens its own window. The payload and SSE frames also carry the new feed and feedError fields.

Changes

  • todo/page/board.js, todo/page/index.html, todo/page/app.css, todo/page/app.js: the page's default view is a kanban board. Columns are sdlc phases (General for items without sdlc work, then intent, plan, build, evidence, deliver, and a collapsed Done for the last 7 days; legacy items sit in a collapsed box). Rows are whose turn it is (your turn, waiting on others, blocked, agent's turn), and a pulsing dot marks a card an agent works on. A top strip shows counts, the feed status and alerts, the last update, the language menu and the views Board, List, Runs and Health (the last two only with a feed). Below about 900 px the page shows the list; the List view keeps every previous feature. A card opens a decision panel with the question, an AI pick badge on the suggested choice, the brief's Background and Why, the choice buttons (the same ordinary reply as before), a free reply box, Approve intent/plan through the same SHA-bound /api/approve, and Fix by agent on a block; "Your turn n/N" pages with ←/→ or j/k and Esc closes. A toast confirms a sent answer and a failure shows its reason in the panel. Open ticket opens the link in one popup window docked to the screen's right edge and re-targets it for the next card, because ticket sites such as Jira refuse frames. A newer board window asks older ones to close over BroadcastChannel.
  • todo/status.mjs: boardCards builds the cards: open items that share one ticket link merge into one card, done items of the last 7 days get one card each, and cards with no change for more than 14 days are marked stale unless they are your turn, blocked or pinned. targetOf picks the member an answer goes to (your turn first, preferring offered choices, then a gate, then an item outside sdlc). feedEntryOf matches a feed item by ticket label, else by sdlc slug.
  • todo/web.mjs: an optional feed is read from SDLC_TODO_FEED, else todo-feed.json beside the to-do file (~/.sdlc/todo-feed.json by default; at most 1 MB), watched for changes, served at token-protected GET /api/feed, and included as feed (and feedError when unreadable) in every payload and SSE frame. Schema v1, every field optional, every string shown as text: status, alerts, items keyed by ticket label or sdlc slug (column, chip, turn, waitingText, service, nextStep, updatedAt), runs (a day timeline) and health. column moves a card; turn changes its row only when the to-do says agent's or others' turn, so a feed never hides the human's turn or a block. The kit still calls no ticket API; a producer, such as a ticket factory, writes the file.
  • todo/app/src/main.rs, todo/app/src/i18n.rs, todo/app/Cargo.toml: the tray app starts with no window and keeps the badge with the your-turn count. Launching it or a left click opens the board in a Google Chrome app window (--app, no tabs) on macOS when Chrome is installed, otherwise in the default browser. The menu is Open board, Open list window (the previous window, kept as the fallback) and Quit. --background or SDLC_TODO_BACKGROUND=1 starts with the tray icon only, for login items. While the server is offline a click shows the list window with the reason. On macOS the badge updates through the main dispatch queue, because a hidden window gets no frames. install-macos.sh is unchanged.
  • todo/todo.mjs, todo/locales/en.mjs, todo/locales/ko.mjs: help text for the tray and SDLC_TODO_BACKGROUND; board, panel, feed, runs and health messages in both languages.
  • README.md, README.ko.md: the board, the feed and its schema, and the tray app's new behaviour; the security model is unchanged (127.0.0.1, per-run token, Host/Origin checks) and the feed is untrusted text.

Verification

  • node --test tests/*.test.mjs: 232 tests, 226 pass, 6 fail, all timing failures under machine load (HTTP request timed out, timed out waiting for TUI state, timed out waiting for lock). Rerun alone, 5 of the 6 pass. The sixth, "S14: twenty parallel CLI writers…", also fails on the previous release commit 518a1d6, and this release does not touch the lock code.
  • New tests cover board card grouping, lane and column with and without a feed, a feed that must not hide a card needing the human or move an open card to done, feed endpoint auth, a missing or invalid feed, the single-window rule, and test helpers that never read the real feed. tests/todo-board.test.mjs, tests/todo-page.test.mjs and tests/todo-web.test.mjs pass.
  • todo/app: cargo build --release passes, and cargo test --release --offline passes 8 tests.
  • Live QA used a copy of a real 40-item list, a real factory feed and Chromium at 1440×900 in light and dark, with zero console errors. Checked:
    • a ticket and its decision item show as one card in plan × your turn, and a choice click appended the reply to the decision item;
    • a feed change moved a card without a reload, and the selection stayed;
    • one ticket popup followed three selections;
    • the page falls back to the list below 900 px.
  • An independent review found two must-fix defects before release: a feed column could hide a card that needed the human, and the single-window rule closed list tabs. Both are fixed and tested.
  • todo/AGENT.md and the prompts are unchanged, so the tests/selftest.sh word budgets are unaffected. The full tests/selftest.sh was not run locally, because a local hook blocks its git reset --hard step.

… (v3.0.0)

- 보드: 열=sdlc 단계(일반·의도·계획·구현·검증·배포·완료), 줄=누구 차례(내 차례·다른 사람·막힘·에이전트). 같은 티켓 링크 항목은 한 카드로 묶고 답은 사람 차례 항목으로 보냄.
- 결정 패널: 질문·AI 권장·배경·이유, 선택지 버튼·답변·자가 조치·intent/plan 승인(같은 /api/approve, SHA 고정), 내 차례 n/N 넘기기.
- 티켓 열기: 화면 오른쪽 팝업 창 하나가 선택을 따라감(Jira는 iframe 거부).
- feed(선택): SDLC_TODO_FEED 또는 할 일 파일 옆 todo-feed.json, GET /api/feed, payload·SSE의 feed. 사람 차례·막힘 카드는 feed가 숨기거나 완료로 옮기지 못함.
- 트레이 앱: 창 없이 시작, 배지 유지, 클릭·실행 시 Chrome 앱 창으로 보드, 메뉴 보드 열기·목록 창 열기·끝내기, --background.
- 메이저 이유: 기본 화면 변경, payload에 feed 추가.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant