[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
|
|
|
import type { Issue } from "@paperclipai/shared";
|
2026-04-08 16:50:39 -05:00
|
|
|
import type { RunForIssue } from "../api/activity";
|
|
|
|
|
import type { ActiveRunForIssue, LiveRunForIssue } from "../api/heartbeats";
|
|
|
|
|
|
|
|
|
|
export interface InterruptRunSource {
|
|
|
|
|
id: string;
|
|
|
|
|
agentId: string;
|
2026-04-09 10:26:17 -05:00
|
|
|
adapterType: string;
|
2026-04-08 16:50:39 -05:00
|
|
|
startedAt: Date | string | null;
|
|
|
|
|
createdAt: Date | string;
|
|
|
|
|
invocationSource: string;
|
|
|
|
|
usageJson?: Record<string, unknown> | null;
|
|
|
|
|
resultJson?: Record<string, unknown> | null;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function toTimestamp(value: Date | string | null | undefined) {
|
|
|
|
|
if (!value) return 0;
|
|
|
|
|
return new Date(value).getTime();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
function toIsoString(value: Date | string | null | undefined) {
|
|
|
|
|
if (!value) return null;
|
|
|
|
|
return value instanceof Date ? value.toISOString() : value;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export function upsertInterruptedRun(
|
|
|
|
|
runs: RunForIssue[] | undefined,
|
|
|
|
|
run: InterruptRunSource,
|
|
|
|
|
finishedAt: string,
|
|
|
|
|
): RunForIssue[] {
|
|
|
|
|
const nextRun: RunForIssue = {
|
|
|
|
|
runId: run.id,
|
|
|
|
|
status: "cancelled",
|
|
|
|
|
agentId: run.agentId,
|
2026-04-09 10:26:17 -05:00
|
|
|
adapterType: run.adapterType,
|
2026-04-08 16:50:39 -05:00
|
|
|
startedAt: toIsoString(run.startedAt),
|
|
|
|
|
finishedAt,
|
|
|
|
|
createdAt: toIsoString(run.createdAt) ?? finishedAt,
|
|
|
|
|
invocationSource: run.invocationSource,
|
|
|
|
|
usageJson: run.usageJson ?? null,
|
|
|
|
|
resultJson: run.resultJson ?? null,
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
const current = runs ?? [];
|
|
|
|
|
const existingIndex = current.findIndex((entry) => entry.runId === run.id);
|
|
|
|
|
if (existingIndex === -1) {
|
|
|
|
|
return [...current, nextRun].sort((a, b) => {
|
|
|
|
|
const diff = toTimestamp(a.startedAt ?? a.createdAt) - toTimestamp(b.startedAt ?? b.createdAt);
|
|
|
|
|
if (diff !== 0) return diff;
|
|
|
|
|
return a.runId.localeCompare(b.runId);
|
|
|
|
|
});
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
const updated = [...current];
|
|
|
|
|
updated[existingIndex] = {
|
|
|
|
|
...updated[existingIndex],
|
|
|
|
|
...nextRun,
|
|
|
|
|
usageJson: updated[existingIndex]?.usageJson ?? nextRun.usageJson,
|
|
|
|
|
resultJson: updated[existingIndex]?.resultJson ?? nextRun.resultJson,
|
|
|
|
|
};
|
|
|
|
|
return updated;
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
export function removeLiveRunById(
|
|
|
|
|
runs: LiveRunForIssue[] | undefined,
|
|
|
|
|
runId: string,
|
|
|
|
|
) {
|
|
|
|
|
if (!runs) return runs;
|
|
|
|
|
const nextRuns = runs.filter((run) => run.id !== runId);
|
|
|
|
|
return nextRuns.length === runs.length ? runs : nextRuns;
|
|
|
|
|
}
|
[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
|
|
|
|
|
|
|
|
export function clearIssueExecutionRun(
|
|
|
|
|
issue: Issue | undefined,
|
|
|
|
|
runId: string,
|
|
|
|
|
) {
|
|
|
|
|
if (!issue || issue.executionRunId !== runId) return issue;
|
|
|
|
|
return {
|
|
|
|
|
...issue,
|
|
|
|
|
executionRunId: null,
|
|
|
|
|
executionAgentNameKey: null,
|
|
|
|
|
executionLockedAt: null,
|
|
|
|
|
updatedAt: new Date(),
|
|
|
|
|
};
|
|
|
|
|
}
|