2e74d32871
## Thinking Path > - Paperclip is the open source app people use to manage AI agents for work. > - The board UI is the operator surface where users create, assign, monitor, and review work items. > - The product language is moving toward "tasks" for user-facing work items while the internal API and database still use "issues". > - PR #7543 bundled this copy migration with broader information-architecture work, which made the branch too large for Greptile review. > - This pull request peels the Issue-to-Task copy migration into a smaller, independently reviewable change. > - The benefit is clearer user-facing terminology, less agent confusion via the Paperclip skill note, and a smaller PR that Greptile can review. ## Linked Issues or Issue Description Refs #7645 Refs #7543 Refs PAP-10430 This PR was split out of #7543 so the Issue-to-Task copy migration can be reviewed separately and the remaining IA PR can fall under Greptile's file limit. ## What Changed - Preserves Scott Tong's original `PAP-57` copy-only commit, with author and co-author credit intact, to rename user-facing "Issues" copy to "Tasks" across the UI while keeping routes/API/internal symbols as `issue`. - Updates onboarding and release-smoke browser selectors from `Create & Open Issue` to `Create & Open Task`. - Adds a terminology note to `skills/paperclip/SKILL.md` clarifying that task and issue refer to the same Paperclip work item. - Resolves the only cherry-pick conflict by keeping current search artifacts support and changing visible search copy to "tasks". ## Verification - `pnpm --filter @paperclipai/ui build` passed. - `NODE_ENV=test pnpm exec vitest run ui/src/components/IssuesList.test.tsx ui/src/components/Sidebar.test.tsx ui/src/components/NewIssueDialog.test.tsx ui/src/pages/IssueDetail.test.tsx` passed: 4 files, 66 tests. - `git diff --check origin/master...HEAD` passed. - Diff is 80 files, below Greptile's 100-file limit. - Before/after UI copy examples: "Issues" -> "Tasks", "New Issue" -> "New Task", "Create & Open Issue" -> "Create & Open Task". ## Risks - Medium copy-risk: this intentionally changes user-facing terminology broadly while keeping internal issue identifiers and routes unchanged. - Some docs and APIs still say `issue`; the skill note clarifies this so agents do not treat task and issue as separate entities. - Browser-level visual validation is expected from CI because this local container is missing usable browser dependencies. > 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 Scott Tong authored the original `PAP-57` copy migration, assisted by Claude Opus 4.8 and Paperclip agents per the preserved commit metadata. Codex / GPT-5-class coding agent with shell, GitHub CLI, and repository access performed the PR split, conflict resolution, skill note, and verification. ## 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 searched GitHub for duplicate or related PRs and linked them above - [x] I have either (a) linked existing issues with `Fixes: #` / `Closes #` / `Refs #` OR (b) described the issue in-PR following the relevant issue template - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [x] 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] All Paperclip CI gates are green - [x] Greptile is 5/5 with no open P2s, recommendations, or follow-ups - [x] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: scotttong <scott.tong@gmail.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com> Co-authored-by: Paperclip <noreply@paperclip.ing>
111 lines
3.5 KiB
TypeScript
111 lines
3.5 KiB
TypeScript
import type { IssueRelatedWorkItem, IssueRelatedWorkSummary } from "@paperclipai/shared";
|
||
import { IssueReferencePill } from "./IssueReferencePill";
|
||
|
||
type GroupedSource = {
|
||
label: string;
|
||
count: number;
|
||
sampleMatchedText: string | null;
|
||
};
|
||
|
||
function groupSourcesByLabel(sources: IssueRelatedWorkItem["sources"]): GroupedSource[] {
|
||
const groups = new Map<string, GroupedSource>();
|
||
for (const source of sources) {
|
||
const existing = groups.get(source.label);
|
||
if (existing) {
|
||
existing.count += 1;
|
||
} else {
|
||
groups.set(source.label, {
|
||
label: source.label,
|
||
count: 1,
|
||
sampleMatchedText: source.matchedText ?? null,
|
||
});
|
||
}
|
||
}
|
||
return Array.from(groups.values());
|
||
}
|
||
|
||
function Section({
|
||
title,
|
||
description,
|
||
items,
|
||
emptyLabel,
|
||
}: {
|
||
title: string;
|
||
description: string;
|
||
items: IssueRelatedWorkItem[];
|
||
emptyLabel: string;
|
||
}) {
|
||
return (
|
||
<section className="space-y-3 rounded-lg border border-border p-3">
|
||
<div className="space-y-1">
|
||
<h3 className="text-sm font-semibold">{title}</h3>
|
||
<p className="text-xs text-muted-foreground">{description}</p>
|
||
</div>
|
||
|
||
{items.length === 0 ? (
|
||
<p className="text-xs text-muted-foreground">{emptyLabel}</p>
|
||
) : (
|
||
<ul className="-mx-1 flex flex-col">
|
||
{items.map((item) => {
|
||
const groupedSources = groupSourcesByLabel(item.sources);
|
||
const showTitle = item.issue.identifier !== item.issue.title;
|
||
return (
|
||
<li
|
||
key={item.issue.id}
|
||
className="flex flex-wrap items-center gap-x-2 gap-y-1.5 rounded-md px-1 py-1.5 hover:bg-accent/40"
|
||
>
|
||
<IssueReferencePill issue={item.issue} />
|
||
{showTitle ? (
|
||
<span className="min-w-0 flex-1 truncate text-sm text-muted-foreground">
|
||
{item.issue.title}
|
||
</span>
|
||
) : null}
|
||
<div className="flex flex-wrap items-center gap-1.5">
|
||
{groupedSources.map((group) => (
|
||
<span
|
||
key={`${item.issue.id}:${group.label}`}
|
||
className="inline-flex items-center gap-1 rounded-full border border-border bg-muted/40 px-2 py-0.5 text-xs text-muted-foreground"
|
||
title={group.sampleMatchedText ?? undefined}
|
||
>
|
||
<span>{group.label}</span>
|
||
{group.count > 1 ? (
|
||
<span className="tabular-nums text-[10px] font-medium opacity-80">×{group.count}</span>
|
||
) : null}
|
||
</span>
|
||
))}
|
||
</div>
|
||
</li>
|
||
);
|
||
})}
|
||
</ul>
|
||
)}
|
||
</section>
|
||
);
|
||
}
|
||
|
||
export function IssueRelatedWorkPanel({
|
||
relatedWork,
|
||
}: {
|
||
relatedWork?: IssueRelatedWorkSummary | null;
|
||
}) {
|
||
const outbound = relatedWork?.outbound ?? [];
|
||
const inbound = relatedWork?.inbound ?? [];
|
||
|
||
return (
|
||
<div className="space-y-3">
|
||
<Section
|
||
title="References"
|
||
description="Other tasks this task currently points at in its title, description, comments, or documents."
|
||
items={outbound}
|
||
emptyLabel="This task does not reference any other tasks yet."
|
||
/>
|
||
<Section
|
||
title="Referenced by"
|
||
description="Other tasks that currently point at this task."
|
||
items={inbound}
|
||
emptyLabel="No other tasks reference this task yet."
|
||
/>
|
||
</div>
|
||
);
|
||
}
|