Files
paperclip/ui/src/lib/issue-properties-panel-key.ts
T
Dotta a26e1288b6 [codex] Polish issue board workflows (#4224)
## Thinking Path

> - Paperclip orchestrates AI agents for zero-human companies
> - Human operators supervise that work through issue lists, issue
detail, comments, inbox groups, markdown references, and
profile/activity surfaces
> - The branch had many small UI fixes that improve the operator loop
but do not need to ship with backend runtime migrations
> - These changes belong together as board workflow polish because they
affect scanning, navigation, issue context, comment state, and markdown
clarity
> - This pull request groups the UI-only slice so it can merge
independently from runtime/backend changes
> - The benefit is a clearer board experience with better issue context,
steadier optimistic updates, and more predictable keyboard navigation

## What Changed

- Improves issue properties, sub-issue actions, blocker chips, and issue
list/detail refresh behavior.
- Adds blocker context above the issue composer and stabilizes
queued/interrupted comment UI state.
- Improves markdown issue/GitHub link rendering and opens external
markdown links in a new tab.
- Adds inbox group keyboard navigation and fold/unfold support.
- Polishes activity/avatar/profile/settings/workspace presentation
details.

## Verification

- `pnpm exec vitest run ui/src/components/IssueProperties.test.tsx
ui/src/components/IssueChatThread.test.tsx
ui/src/components/MarkdownBody.test.tsx ui/src/lib/inbox.test.ts
ui/src/lib/optimistic-issue-comments.test.ts`

## Risks

- Low to medium risk: changes are UI-focused but cover high-traffic
issue and inbox surfaces.
- This branch intentionally does not include the backend runtime changes
from the companion PR; where UI calls newer API filters, unsupported
servers should continue to fail visibly through existing API error
handling.
- Visual screenshots were not captured in this heartbeat; targeted
component/helper tests cover the changed behavior.

> 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-based coding agent runtime, shell/git tool use
enabled. Exact hosted model build and context window are not exposed in
this Paperclip heartbeat environment.

## 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
2026-04-21 12:25:34 -05:00

101 lines
3.2 KiB
TypeScript

import type { Issue } from "@paperclipai/shared";
type IssuePropertiesPanelKeyIssue = Pick<
Issue,
| "id"
| "status"
| "priority"
| "assigneeAgentId"
| "assigneeUserId"
| "projectId"
| "projectWorkspaceId"
| "parentId"
| "createdByUserId"
| "hiddenAt"
| "labelIds"
| "executionPolicy"
| "executionState"
| "executionWorkspaceId"
| "executionWorkspacePreference"
| "executionWorkspaceSettings"
| "currentExecutionWorkspace"
| "blocks"
| "blockedBy"
| "ancestors"
>;
type IssuePropertiesPanelKeyChild = Pick<Issue, "id" | "updatedAt" | "identifier" | "title">;
export function buildIssuePropertiesPanelKey(
issue: IssuePropertiesPanelKeyIssue | null | undefined,
childIssues: readonly IssuePropertiesPanelKeyChild[],
) {
if (!issue) return "";
return JSON.stringify({
id: issue.id,
status: issue.status,
priority: issue.priority,
assigneeAgentId: issue.assigneeAgentId,
assigneeUserId: issue.assigneeUserId,
projectId: issue.projectId,
projectWorkspaceId: issue.projectWorkspaceId,
parentId: issue.parentId,
createdByUserId: issue.createdByUserId,
hiddenAt: issue.hiddenAt,
labelIds: issue.labelIds ?? [],
executionWorkspaceId: issue.executionWorkspaceId,
executionWorkspacePreference: issue.executionWorkspacePreference,
executionWorkspaceSettings: issue.executionWorkspaceSettings ?? null,
currentExecutionWorkspace: issue.currentExecutionWorkspace
? {
id: issue.currentExecutionWorkspace.id,
mode: issue.currentExecutionWorkspace.mode,
status: issue.currentExecutionWorkspace.status,
projectWorkspaceId: issue.currentExecutionWorkspace.projectWorkspaceId,
branchName: issue.currentExecutionWorkspace.branchName,
cwd: issue.currentExecutionWorkspace.cwd,
runtimeServices: (issue.currentExecutionWorkspace.runtimeServices ?? []).map((service) => ({
id: service.id,
status: service.status,
url: service.url,
})),
}
: null,
executionPolicy: issue.executionPolicy ?? null,
executionState: issue.executionState
? {
status: issue.executionState.status,
currentStageType: issue.executionState.currentStageType,
currentParticipant: issue.executionState.currentParticipant,
returnAssignee: issue.executionState.returnAssignee,
}
: null,
blocks: (issue.blocks ?? []).map((relation) => ({
id: relation.id,
identifier: relation.identifier ?? null,
title: relation.title,
status: relation.status,
})),
blockedBy: (issue.blockedBy ?? []).map((relation) => ({
id: relation.id,
identifier: relation.identifier ?? null,
title: relation.title,
status: relation.status,
})),
parentSummary: issue.ancestors?.[0]
? {
id: issue.ancestors[0].id,
identifier: issue.ancestors[0].identifier ?? null,
title: issue.ancestors[0].title,
}
: null,
childIssues: childIssues.map((child) => ({
id: child.id,
updatedAt: String(child.updatedAt),
identifier: child.identifier ?? null,
title: child.title,
})),
});
}