paperclip/ui/src/lib
Dotta a957394420
[codex] Add structured issue-thread interactions (#4244)
## Thinking Path

> - Paperclip orchestrates AI agents for zero-human companies.
> - Operators supervise that work through issues, comments, approvals,
and the board UI.
> - Some agent proposals need structured board/user decisions, not
hidden markdown conventions or heavyweight governed approvals.
> - Issue-thread interactions already provide a natural thread-native
surface for proposed tasks and questions.
> - This pull request extends that surface with request confirmations,
richer interaction cards, and agent/plugin/MCP helpers.
> - The benefit is that plan approvals and yes/no decisions become
explicit, auditable, and resumable without losing the single-issue
workflow.

## What Changed

- Added persisted issue-thread interactions for suggested tasks,
structured questions, and request confirmations.
- Added board UI cards for interaction review, selection, question
answers, and accept/reject confirmation flows.
- Added MCP and plugin SDK helpers for creating interaction cards from
agents/plugins.
- Updated agent wake instructions, onboarding assets, Paperclip skill
docs, and public docs to prefer structured confirmations for
issue-scoped decisions.
- Rebased the branch onto `public-gh/master` and renumbered branch
migrations to `0063` and `0064`; the idempotency migration uses `ADD
COLUMN IF NOT EXISTS` for old branch users.

## Verification

- `git diff --check public-gh/master..HEAD`
- `pnpm exec vitest run packages/adapter-utils/src/server-utils.test.ts
packages/mcp-server/src/tools.test.ts
packages/shared/src/issue-thread-interactions.test.ts
ui/src/lib/issue-thread-interactions.test.ts
ui/src/lib/issue-chat-messages.test.ts
ui/src/components/IssueThreadInteractionCard.test.tsx
ui/src/components/IssueChatThread.test.tsx
server/src/__tests__/issue-thread-interaction-routes.test.ts
server/src/__tests__/issue-thread-interactions-service.test.ts
server/src/services/issue-thread-interactions.test.ts` -> 9 files / 79
tests passed
- `pnpm -r typecheck` -> passed, including `packages/db` migration
numbering check

## Risks

- Medium: this adds a new issue-thread interaction model across
db/shared/server/ui/plugin surfaces.
- Migration risk is reduced by placing this branch after current master
migrations (`0063`, `0064`) and making the idempotency column add
idempotent for users who applied the old branch numbering.
- UI interaction behavior is covered by component tests, but this PR
does not include browser screenshots.

> For core feature work, check [`ROADMAP.md`](ROADMAP.md) first and
discuss it in `#dev` before opening the PR. Feature PRs that overlap
with planned core work may need to be redirected — check the roadmap
first. See `CONTRIBUTING.md`.

## Model Used

- OpenAI Codex, GPT-5-class coding agent runtime. Exact model ID and
context window are not exposed in this Paperclip run; tool use and local
shell/code execution were enabled.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [ ] If this change affects the UI, I have included before/after
screenshots
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [x] I will address all Greptile and reviewer comments before
requesting merge

---------

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-04-21 20:15:11 -05:00
..
activity-format.test.ts Track blocker and review activity events 2026-04-09 06:16:41 -05:00
activity-format.ts feat: implement multi-user access and invite flows (#3784) 2026-04-17 09:44:19 -05:00
agent-config-patch.test.ts fix(ui): persist cleared agent env bindings on save 2026-04-09 17:50:14 +00:00
agent-config-patch.ts fix(ui): persist cleared agent env bindings on save 2026-04-09 17:50:14 +00:00
agent-icons.ts Fix markdown mention chips 2026-03-23 16:57:27 -05:00
agent-order.ts Preserve sidebar order in company portability 2026-03-23 16:57:59 -05:00
agent-skills-state.test.ts Add unmanaged skill provenance to agent skills 2026-03-18 14:21:50 -05:00
agent-skills-state.ts Add unmanaged skill provenance to agent skills 2026-03-18 14:21:50 -05:00
assignees.test.ts Polish issue chat actions and overflow 2026-04-08 06:02:34 -05:00
assignees.ts feat: implement multi-user access and invite flows (#3784) 2026-04-17 09:44:19 -05:00
color-contrast.ts fix: improve pill contrast by using WCAG contrast ratios on composited backgrounds 2026-03-23 16:57:27 -05:00
comment-submit-draft.test.ts Fix optimistic comment draft clearing 2026-03-30 14:14:36 -05:00
comment-submit-draft.ts Fix optimistic comment draft clearing 2026-03-30 14:14:36 -05:00
company-export-selection.test.ts Default recurring task exports to checked 2026-03-23 16:57:38 -05:00
company-export-selection.ts Default recurring task exports to checked 2026-03-23 16:57:38 -05:00
company-members.test.ts feat: implement multi-user access and invite flows (#3784) 2026-04-17 09:44:19 -05:00
company-members.ts feat: implement multi-user access and invite flows (#3784) 2026-04-17 09:44:19 -05:00
company-page-memory.ts Add browser-based board CLI auth flow 2026-03-23 08:46:05 -05:00
company-portability-sidebar.test.ts Add project-level environment variables 2026-04-06 21:23:30 -05:00
company-portability-sidebar.ts Preserve sidebar order in company portability 2026-03-23 16:57:59 -05:00
company-routes.test.ts feat: implement multi-user access and invite flows (#3784) 2026-04-17 09:44:19 -05:00
company-routes.ts [codex] Improve workspace navigation and runtime UI (#4089) 2026-04-20 06:14:32 -05:00
company-selection.test.ts Fix manual company switch route sync 2026-03-13 09:47:01 -05:00
company-selection.ts Fix manual company switch route sync 2026-03-13 09:47:01 -05:00
document-revisions.test.ts fix(ui): keep latest issue document revision current (#3342) 2026-04-10 17:14:06 -07:00
document-revisions.ts fix(ui): keep latest issue document revision current (#3342) 2026-04-10 17:14:06 -07:00
groupBy.ts Add shared UI primitives, contexts, and reusable components 2026-02-17 09:57:00 -06:00
inbox.test.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
inbox.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
instance-settings.test.ts Add username log censor setting 2026-03-20 08:50:00 -05:00
instance-settings.ts Add username log censor setting 2026-03-20 08:50:00 -05:00
invite-memory.ts feat: implement multi-user access and invite flows (#3784) 2026-04-17 09:44:19 -05:00
issue-chat-messages.test.ts [codex] Add structured issue-thread interactions (#4244) 2026-04-21 20:15:11 -05:00
issue-chat-messages.ts [codex] Add structured issue-thread interactions (#4244) 2026-04-21 20:15:11 -05:00
issue-chat-scroll.test.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
issue-chat-scroll.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
issue-detail-subissues.test.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
issue-detail-subissues.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
issue-execution-policy.ts fix execution policy decision persistence 2026-04-07 17:43:10 -05:00
issue-filters.test.ts Sync/master post pap1497 followups 2026 04 15 (#3779) 2026-04-15 21:13:56 -05:00
issue-filters.ts Sync/master post pap1497 followups 2026 04 15 (#3779) 2026-04-15 21:13:56 -05:00
issue-properties-panel-key.test.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
issue-properties-panel-key.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
issue-reference.test.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
issue-reference.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
issue-thread-interactions.test.ts [codex] Add structured issue-thread interactions (#4244) 2026-04-21 20:15:11 -05:00
issue-thread-interactions.ts [codex] Add structured issue-thread interactions (#4244) 2026-04-21 20:15:11 -05:00
issue-timeline-events.test.ts fix(ui): polish issue detail timelines and attachments 2026-04-02 11:51:40 -05:00
issue-timeline-events.ts fix(ui): polish issue detail timelines and attachments 2026-04-02 11:51:40 -05:00
issue-tree.test.ts fix: count all descendants in collapsed badge and prune stale localStorage IDs 2026-04-05 12:02:49 +01:00
issue-tree.ts fix: count all descendants in collapsed badge and prune stale localStorage IDs 2026-04-05 12:02:49 +01:00
issueActiveRun.test.ts Fix stale issue live-run state 2026-04-12 20:41:31 -05:00
issueActiveRun.ts Fix stale issue live-run state 2026-04-12 20:41:31 -05:00
issueChatTranscriptRuns.test.ts Refine issue workflow surfaces and live updates 2026-04-09 10:26:17 -05:00
issueChatTranscriptRuns.ts Refine issue workflow surfaces and live updates 2026-04-09 10:26:17 -05:00
issueDetailBreadcrumb.test.ts Refine issue workflow surfaces and live updates 2026-04-09 10:26:17 -05:00
issueDetailBreadcrumb.ts Refine issue workflow surfaces and live updates 2026-04-09 10:26:17 -05:00
issueDetailCache.test.ts Fix rebased issue detail prefetch typing 2026-04-12 21:18:57 -05:00
issueDetailCache.ts [codex] harden authenticated routes and issue editor reliability (#3741) 2026-04-15 08:41:15 -05:00
issueDetailQuery.test.tsx [codex] harden authenticated routes and issue editor reliability (#3741) 2026-04-15 08:41:15 -05:00
keyboardShortcuts.test.ts [codex] Improve workspace runtime and navigation ergonomics (#3680) 2026-04-14 12:57:11 -05:00
keyboardShortcuts.ts [codex] Improve workspace runtime and navigation ergonomics (#3680) 2026-04-14 12:57:11 -05:00
legacy-agent-config.test.ts Hide deprecated agent working directory by default 2026-03-20 07:04:41 -05:00
legacy-agent-config.ts Hide deprecated agent working directory by default 2026-03-20 07:04:41 -05:00
liveIssueIds.test.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
liveIssueIds.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
main-content-focus.test.ts Fix issue detail main-pane focus on navigation 2026-04-09 06:18:27 -05:00
main-content-focus.ts Fix issue detail main-pane focus on navigation 2026-04-09 06:18:27 -05:00
markdownPaste.test.ts Fix markdown paste handling in document editor (#2572) 2026-04-03 08:50:48 -07:00
markdownPaste.ts Fix markdown paste handling in document editor (#2572) 2026-04-03 08:50:48 -07:00
mention-aware-link-node.test.ts Extract mention-aware link node helper and add tests 2026-03-23 20:46:19 -05:00
mention-aware-link-node.ts Refine issue workflow surfaces and live updates 2026-04-09 10:26:17 -05:00
mention-chips.ts Add first-class issue references (#4214) 2026-04-21 10:02:52 -05:00
mention-deletion.test.ts Fix atomic markdown mention deletion 2026-03-23 16:57:27 -05:00
mention-deletion.ts Fix atomic markdown mention deletion 2026-03-23 16:57:27 -05:00
model-utils.ts Fix remaining OpenCode review comments 2026-03-05 16:07:12 +01:00
navigation-scroll.test.ts Reset scroll on issue detail navigation 2026-04-12 21:14:12 -05:00
navigation-scroll.ts Reset scroll on issue detail navigation 2026-04-12 21:14:12 -05:00
new-agent-runtime-config.test.ts [codex] Improve agent runtime recovery and governance (#4086) 2026-04-20 06:19:48 -05:00
new-agent-runtime-config.ts [codex] Improve agent runtime recovery and governance (#4086) 2026-04-20 06:19:48 -05:00
normalize-markdown.test.ts fix: autoformat pasted markdown in inline editor (#2673) 2026-04-04 11:21:27 -07:00
normalize-markdown.ts fix: autoformat pasted markdown in inline editor (#2673) 2026-04-04 11:21:27 -07:00
onboarding-goal.test.ts Improve onboarding defaults and issue goal fallback 2026-03-12 08:50:31 -05:00
onboarding-goal.ts Improve onboarding defaults and issue goal fallback 2026-03-12 08:50:31 -05:00
onboarding-launch.test.ts Seed onboarding project and issue goal context 2026-03-24 11:48:59 -05:00
onboarding-launch.ts Seed onboarding project and issue goal context 2026-03-24 11:48:59 -05:00
onboarding-route.test.ts test: harden onboarding route coverage 2026-03-18 08:00:02 -05:00
onboarding-route.ts test: harden onboarding route coverage 2026-03-18 08:00:02 -05:00
optimistic-issue-comments.test.ts [codex] Clear stale queued comment targets (#4234) 2026-04-21 16:50:26 -05:00
optimistic-issue-comments.ts [codex] Clear stale queued comment targets (#4234) 2026-04-21 16:50:26 -05:00
optimistic-issue-runs.test.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
optimistic-issue-runs.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
paste-normalization.ts fix: autoformat pasted markdown in inline editor (#2673) 2026-04-04 11:21:27 -07:00
portable-files.ts Add company logo portability support 2026-03-19 07:24:04 -05:00
project-order.ts refactor: rename packages to @paperclipai and CLI binary to paperclipai 2026-03-03 08:45:26 -06:00
project-workspaces-tab.test.ts [codex] Improve workspace navigation and runtime UI (#4089) 2026-04-20 06:14:32 -05:00
project-workspaces-tab.ts [codex] Improve workspace navigation and runtime UI (#4089) 2026-04-20 06:14:32 -05:00
query-placeholder-data.test.tsx [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
query-placeholder-data.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
queryKeys.ts [codex] Add structured issue-thread interactions (#4244) 2026-04-21 20:15:11 -05:00
recent-assignees.ts [codex] Polish issue and operator workflow UI (#4090) 2026-04-20 06:16:41 -05:00
recent-projects.ts [codex] Polish issue and operator workflow UI (#4090) 2026-04-20 06:16:41 -05:00
recent-selections.test.ts [codex] Polish issue and operator workflow UI (#4090) 2026-04-20 06:16:41 -05:00
recent-selections.ts [codex] Polish issue and operator workflow UI (#4090) 2026-04-20 06:16:41 -05:00
remark-soft-breaks.ts feat: polish issue thread markdown and references 2026-04-10 22:26:21 -05:00
router.tsx Sync/master post pap1497 followups 2026 04 15 (#3779) 2026-04-15 21:13:56 -05:00
routine-trigger-patch.test.ts fix: address greptile routine review 2026-03-20 16:26:29 -05:00
routine-trigger-patch.ts fix: address greptile routine review 2026-03-20 16:26:29 -05:00
runRetryState.test.ts [codex] Harden heartbeat scheduling and runtime controls (#4223) 2026-04-21 12:24:11 -05:00
runRetryState.ts [codex] Harden heartbeat scheduling and runtime controls (#4223) 2026-04-21 12:24:11 -05:00
status-colors.ts [codex] Harden heartbeat scheduling and runtime controls (#4223) 2026-04-21 12:24:11 -05:00
subIssueDefaults.test.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
subIssueDefaults.ts [codex] Improve issue detail and issue-list UX (#3678) 2026-04-14 12:50:48 -05:00
timeAgo.ts Add shared UI primitives, contexts, and reusable components 2026-02-17 09:57:00 -06:00
transcriptPresentation.test.ts Polish issue chat chain-of-thought rendering 2026-04-08 06:02:34 -05:00
transcriptPresentation.ts Polish issue chat chain-of-thought rendering 2026-04-08 06:02:34 -05:00
utils.ts [codex] Polish issue board workflows (#4224) 2026-04-21 12:25:34 -05:00
vite-watch.test.ts [codex] fix worktree dev dependency ergonomics (#3743) 2026-04-15 09:47:29 -05:00
vite-watch.ts [codex] fix worktree dev dependency ergonomics (#3743) 2026-04-15 09:47:29 -05:00
worktree-branding.ts Add worktree UI branding 2026-03-13 11:12:43 -05:00
zip.test.ts Handle directory entries in imported zip archives 2026-03-20 14:09:21 -05:00
zip.ts Handle directory entries in imported zip archives 2026-03-20 14:09:21 -05:00