Screens 1 and 4 running as TUIOS panes: reply screen, adopt-or-create launcher, layout script

docs/PAPERCLIP-API-NOTES.md

@@ -274,3 +274,28 @@ Read from `GET /api/companies/{companyId}/agents`:
 
 The company's `budgetMonthlyCents` is 0. There is no currency field anywhere in the payload:
 Paperclip counts cents and does not name a currency, so "5000" is a number, not "$50 AUD".
+
+---
+
+# Milestone 2 passed from the terminal, 2026-11-10
+
+The reply screen sent one call that both comments and changes status:
+
+```
+PATCH /api/issues/AUD-162   {"status":"todo","comment":"Unblocked: AUD-161 is done, …"}
+→ 200, status todo
+```
+
+Read back afterwards:
+
+```
+GET /api/issues/AUD-162/comments → 1 comment, authorType: user, authorUserId: 2204TMD0…
+GET /api/issues/AUD-162/activity → actorType: user, issue.comment_added, then
+                                   issue.updated status {from blocked, to todo}
+```
+
+Before the move, `AUD-161` was set to `done` and `diagnostics/blockers` for `AUD-162`
+returned `allBlockersDone: true, unresolvedBlockerCount: 0` while the task itself stayed
+`blocked`. So Paperclip does not walk a task forward on its own when its blocker clears; it
+makes the task ready and leaves the decision to a person or a program. That is the job the
+reply screen does, and the reason this milestone exists.