opencode-dockerized: Skill for OpenCode

Kanban poller

Code: docker/plugins/kanban/poller/. Tests: docker/plugins/kanban/tests/. Commands it runs: docker/plugins/kanban/kanban.commands/.

Who writes what

1. The poller makes every Linear write (state, labels, comments, reactions), all through the --dry-run guard. Agents (ticket-worker|reviewer|investigator) have linear_* denied. Agents write only code and the PR (worker), the GitHub review (reviewer), and the report file (investigator).
2. Before each work/fix/review/investigate run, and before the ticket is claimed or moved, the poller writes <path>/.slim/worktrees/.tickets/<ID>.json (atomic; passed as ctx.ticketFile; deleted when the job ends, also on failure; dry-run logs only). The snapshot state is the state at write time, so a work run sees the pre-move state. Content: title, description, state, labels, project name, url, attachments, all comments oldest to newest (id, parentId, author, isPoller, createdAt, body), state history. Cleanup works per ticket worktree and never touches .tickets.
3. Every run ends with one last line KANBAN-RESULT: <json>. The poller takes the LAST such line (tolerating surrounding backticks, bold, or quote markers) and rejects unknown fields or values:
   1. Worker: {"outcome":"review","pr":<n>} or {"outcome":"needs-human","step","reason"}. review is accepted only if gh finds an OPEN PR on the branch with that number; then Agent review. Else Needs human.
   2. Reviewer: {"outcome":"approve"} → Ready for merge; {"outcome":"changes","summary"} → comment Agent review: changes requested (round n/2) — <PR> + one-line summary (prefixed Review: if it starts with CI failed or merge conflicts), label, In Progress, or Needs human ("review limit reached") at round ≥ 2; needs-human → Needs human with Agent review: needs human — <step>: <reason>.
   3. Investigator: {"outcome":"done"} plus the report in <path>/.slim/worktrees/.tickets/<ID>.investigation.md; the poller posts Agent investigation:\n\n<report> (cut at 60k characters with a note) as a reply to the request and reacts ✅. needs-human, a missing report, or a bad marker = ❌ + Agent investigation: failed — <reason>.
   4. Failed run (agent/server error, timeout, missing or invalid marker): one automatic retry, then Needs human ("agent result: marker missing|marker is not JSON|marker invalid", or the run failure).
   5. Work/fix: retry any failure IF nothing was pushed (remote branch head before the run = after a fetch; unknown counts as pushed). Review: retry only an agent/server error, not a timeout or missing marker.
   6. Retry = put the ticket back to its start lane (work: Ready for agent; fix: stays In Progress + agent:changes-requested; review: stays Agent review), THEN comment Agent: retrying (<lane>) — <reason>. That comment is the persisted budget (max 1 per lane entry), counted only from comments authored by the poller (user.id = API user) at or after the entry (work: last Ready for agent; review: last Agent review; fix: newest poller changes requested comment). The comparison is inclusive, so equal timestamps cannot grant another retry; a hard cap of 3 retry comments per lane per ticket ends loops whatever the timestamps. Log run.retry.
   7. A claim 👀 ends with its job (job finally, every outcome, released even if removing the ticket files fails; a reaction that is already gone is ignored); staleClaims ignores tickets labelled agent:changes-requested. Claims are written first (claimIssue: add the new reaction, then delete older ones), then the move/relabel.
   8. Session that could not be aborted (abort failed AND status still busy after 2 min): Needs human ("session could not be aborted"), never a retry or requeue.
   9. Poller stop (aborted run): same put-back, no comment, no budget used, log run.requeued; so a restart resumes the work. Investigations are not requeued (❌ poller stopped).
4. Marker extraction (parseResult in select.ts) is separate from the transport (runner.ts gives the stdout tail). opencode run prints the final reply text to stdout; if the format ever wraps or decorates the line, fix only the line pattern.