mirror of
https://github.com/alkimake/paperclip.git
synced 2026-06-16 10:50:38 +09:00
## Thinking Path > - Paperclip is a control plane for autonomous AI companies, where adapters are the boundary between the board, agents, and execution runtimes. > - Local adapters currently expose a primary runtime configuration, but operators often need a cheaper model lane for routine or low-risk work. > - That cheap lane has to stay adapter-owned: runtime profile settings should not mutate the primary adapter config or bypass existing auth/secret mediation. > - Issue creation also needs an ergonomic way to request primary, cheap, or custom model behavior for a selected assignee. > - This pull request adds a first-class `cheap` model profile contract across adapter capabilities, heartbeat config resolution, agent configuration, and issue creation. > - The benefit is cheaper task execution can be configured and requested explicitly while preserving adapter boundaries, secret handling, and audit visibility. ## What Changed - Added adapter model-profile capability metadata and a `cheap` profile contract for supported local adapters. - Applied `runtimeConfig.modelProfiles.cheap.adapterConfig` during heartbeat config resolution, including requested/applied/fallback run metadata. - Added agent configuration UI for cheap model profile settings without writing those settings into primary `adapterConfig`. - Added New Issue assignee model lane controls for Primary / Cheap / Custom and request payload handling. - Added run ledger profile badges and Storybook stories for the new cheap-lane UI states. - Added tests for validators, heartbeat model profile application, permission/secret mediation, UI payload helpers, and run ledger rendering. - Added committed UI verification screenshots under `docs/pr-screenshots/pap-2837/`. - Addressed Greptile review feedback around cheap-profile defaults, shared profile types, and fallback test data. ## Verification Local: - `pnpm exec vitest run packages/shared/src/validators/issue.test.ts server/src/__tests__/adapter-registry.test.ts server/src/__tests__/agent-permissions-routes.test.ts server/src/__tests__/heartbeat-model-profile.test.ts ui/src/components/IssueRunLedger.test.tsx ui/src/lib/agent-config-patch.test.ts ui/src/lib/issue-assignee-overrides.test.ts ui/src/lib/new-agent-runtime-config.test.ts` — passed, 8 files / 103 tests. - `pnpm exec vitest run ui/src/lib/new-agent-runtime-config.test.ts ui/src/components/IssueRunLedger.test.tsx` — passed after Greptile/rebase follow-up, 2 files / 17 tests. - `pnpm --filter @paperclipai/ui typecheck` — passed after Greptile/rebase follow-up. - `pnpm -r typecheck` — passed. - `pnpm build` — passed. - `pnpm test:run` — did not complete successfully in this local worktree: it stopped in pre-existing `@paperclipai/adapter-utils` sandbox/SSH fixture suites outside this PR diff. Failures were 5s local timeouts plus `git init -b` unsupported by this machine's Git 2.21.0. The branch-specific targeted suites above passed. - Branch was fetched/rebased onto `public-gh/master`; `git rev-list --left-right --count public-gh/master...HEAD` reports `0 9`. Remote PR checks on latest head `e30bf399146451c86cee98ed528d51d33fa5af5a`: - `policy` — passed. - `verify` — passed. - `e2e` — passed. - `Greptile Review` — passed, confidence score 5/5; Greptile review threads resolved. - `security/snyk (cryppadotta)` — passed. Screenshots: - [New issue cheap lane desktop](https://github.com/paperclipai/paperclip/blob/PAP-2837-plan-cheap-model-for-adapters-that-can-support-it/docs/pr-screenshots/pap-2837/newissue-cheap-desktop.png) - [New issue custom lane desktop](https://github.com/paperclipai/paperclip/blob/PAP-2837-plan-cheap-model-for-adapters-that-can-support-it/docs/pr-screenshots/pap-2837/newissue-custom-desktop.png) - [New issue unsupported adapter desktop](https://github.com/paperclipai/paperclip/blob/PAP-2837-plan-cheap-model-for-adapters-that-can-support-it/docs/pr-screenshots/pap-2837/newissue-unsupported-desktop.png) - [Run ledger model profile badges desktop](https://github.com/paperclipai/paperclip/blob/PAP-2837-plan-cheap-model-for-adapters-that-can-support-it/docs/pr-screenshots/pap-2837/runledger-profile-badges-desktop.png) - Mobile variants are also in `docs/pr-screenshots/pap-2837/`. ## Risks - Medium: heartbeat config mediation now merges runtime model profiles into adapter configs, so adapter secret normalization and host-command restrictions must keep covering nested config paths. - Medium: the UI adds another issue creation choice; unsupported adapters must keep hiding the cheap lane and preserve primary behavior. - Low migration risk: no database migration is included. > 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 coding agent using GPT-5-class reasoning with repo tool use and command execution. Exact served model/context window was not exposed by the runtime. ## 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 - [ ] 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] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing> Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
753 lines
31 KiB
TypeScript
753 lines
31 KiB
TypeScript
import { useEffect, useMemo, useRef, useState } from "react";
|
|
import type { Meta, StoryObj } from "@storybook/react-vite";
|
|
import type { Issue } from "@paperclipai/shared";
|
|
import type { RunForIssue } from "@/api/activity";
|
|
import { useQueryClient } from "@tanstack/react-query";
|
|
import {
|
|
ArrowDownAZ,
|
|
ArrowUpDown,
|
|
Check,
|
|
Columns3,
|
|
Filter,
|
|
GitBranch,
|
|
LayoutList,
|
|
Link2,
|
|
PanelRight,
|
|
Rows3,
|
|
} from "lucide-react";
|
|
import { IssueColumnPicker, InboxIssueMetaLeading, InboxIssueTrailingColumns } from "@/components/IssueColumns";
|
|
import { IssueContinuationHandoff } from "@/components/IssueContinuationHandoff";
|
|
import { IssueDocumentsSection } from "@/components/IssueDocumentsSection";
|
|
import { IssueFiltersPopover } from "@/components/IssueFiltersPopover";
|
|
import { IssueGroupHeader } from "@/components/IssueGroupHeader";
|
|
import { IssueLinkQuicklook, IssueQuicklookCard } from "@/components/IssueLinkQuicklook";
|
|
import { IssueProperties } from "@/components/IssueProperties";
|
|
import { IssueRunLedgerContent } from "@/components/IssueRunLedger";
|
|
import { IssuesList } from "@/components/IssuesList";
|
|
import { IssuesQuicklook } from "@/components/IssuesQuicklook";
|
|
import { IssueWorkspaceCard } from "@/components/IssueWorkspaceCard";
|
|
import { Identity } from "@/components/Identity";
|
|
import { PriorityIcon } from "@/components/PriorityIcon";
|
|
import { StatusBadge } from "@/components/StatusBadge";
|
|
import { Badge } from "@/components/ui/badge";
|
|
import { Button } from "@/components/ui/button";
|
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
|
|
import { countActiveIssueFilters, defaultIssueFilterState, type IssueFilterState } from "@/lib/issue-filters";
|
|
import { DEFAULT_INBOX_ISSUE_COLUMNS, type InboxIssueColumn } from "@/lib/inbox";
|
|
import { queryKeys } from "@/lib/queryKeys";
|
|
import {
|
|
storybookAgentMap,
|
|
storybookAgents,
|
|
storybookAuthSession,
|
|
storybookCompanies,
|
|
storybookContinuationHandoff,
|
|
storybookExecutionWorkspaces,
|
|
storybookIssueDocuments,
|
|
storybookIssueLabels,
|
|
storybookIssueRuns,
|
|
storybookIssues,
|
|
storybookProjects,
|
|
} from "../fixtures/paperclipData";
|
|
|
|
const companyId = "company-storybook";
|
|
const issueListViewKey = "storybook:issue-management:list";
|
|
const scopedIssueListViewKey = `${issueListViewKey}:${companyId}`;
|
|
const visibleColumns: InboxIssueColumn[] = ["status", "id", "assignee", "project", "workspace", "labels", "updated"];
|
|
|
|
const issueDocumentSummaries = storybookIssueDocuments.map(({ body: _body, ...summary }) => summary);
|
|
const primaryIssue: Issue = {
|
|
...storybookIssues[0]!,
|
|
planDocument: storybookIssueDocuments.find((document) => document.key === "plan") ?? null,
|
|
documentSummaries: issueDocumentSummaries,
|
|
currentExecutionWorkspace: storybookExecutionWorkspaces[0]!,
|
|
};
|
|
const childIssues = storybookIssues.filter((issue) => issue.parentId === primaryIssue.id);
|
|
|
|
function Section({
|
|
eyebrow,
|
|
title,
|
|
children,
|
|
}: {
|
|
eyebrow: string;
|
|
title: string;
|
|
children: React.ReactNode;
|
|
}) {
|
|
return (
|
|
<section className="paperclip-story__frame overflow-hidden">
|
|
<div className="border-b border-border px-5 py-4">
|
|
<div className="paperclip-story__label">{eyebrow}</div>
|
|
<h2 className="mt-1 text-xl font-semibold">{title}</h2>
|
|
</div>
|
|
<div className="p-5">{children}</div>
|
|
</section>
|
|
);
|
|
}
|
|
|
|
function hydrateStorybookQueries(queryClient: ReturnType<typeof useQueryClient>) {
|
|
queryClient.setQueryData(queryKeys.companies.all, { companies: storybookCompanies, unauthorized: false });
|
|
queryClient.setQueryData(queryKeys.auth.session, storybookAuthSession);
|
|
queryClient.setQueryData(queryKeys.agents.list(companyId), storybookAgents);
|
|
queryClient.setQueryData(queryKeys.projects.list(companyId), storybookProjects);
|
|
queryClient.setQueryData(queryKeys.issues.list(companyId), storybookIssues);
|
|
queryClient.setQueryData(queryKeys.issues.labels(companyId), storybookIssueLabels);
|
|
queryClient.setQueryData(queryKeys.issues.documents(primaryIssue.id), storybookIssueDocuments);
|
|
queryClient.setQueryData(queryKeys.issues.runs(primaryIssue.id), storybookIssueRuns);
|
|
queryClient.setQueryData(queryKeys.issues.liveRuns(primaryIssue.id), []);
|
|
queryClient.setQueryData(queryKeys.issues.activeRun(primaryIssue.id), null);
|
|
queryClient.setQueryData(queryKeys.instance.experimentalSettings, {
|
|
enableIsolatedWorkspaces: true,
|
|
enableRoutineTriggers: true,
|
|
});
|
|
queryClient.setQueryData(queryKeys.access.companyUserDirectory(companyId), {
|
|
users: [
|
|
{
|
|
principalId: "user-board",
|
|
status: "active",
|
|
user: {
|
|
id: "user-board",
|
|
email: "riley@paperclip.local",
|
|
name: "Riley Board",
|
|
image: null,
|
|
},
|
|
},
|
|
],
|
|
});
|
|
queryClient.setQueryData(
|
|
queryKeys.sidebarPreferences.projectOrder(companyId, storybookAuthSession.user.id),
|
|
{ orderedIds: storybookProjects.map((project) => project.id), updatedAt: null },
|
|
);
|
|
queryClient.setQueryData(
|
|
queryKeys.executionWorkspaces.summaryList(companyId),
|
|
storybookExecutionWorkspaces.map((workspace) => ({
|
|
id: workspace.id,
|
|
name: workspace.name,
|
|
mode: workspace.mode,
|
|
projectWorkspaceId: workspace.projectWorkspaceId,
|
|
})),
|
|
);
|
|
queryClient.setQueryData(
|
|
queryKeys.executionWorkspaces.list(companyId, {
|
|
projectId: primaryIssue.projectId ?? undefined,
|
|
projectWorkspaceId: primaryIssue.projectWorkspaceId ?? undefined,
|
|
reuseEligible: true,
|
|
}),
|
|
storybookExecutionWorkspaces,
|
|
);
|
|
}
|
|
|
|
function seedIssueListLocalStorage() {
|
|
if (typeof window === "undefined") return;
|
|
window.localStorage.setItem(
|
|
scopedIssueListViewKey,
|
|
JSON.stringify({
|
|
...defaultIssueFilterState,
|
|
sortField: "priority",
|
|
sortDir: "desc",
|
|
groupBy: "status",
|
|
viewMode: "list",
|
|
nestingEnabled: true,
|
|
collapsedGroups: [],
|
|
collapsedParents: [],
|
|
}),
|
|
);
|
|
window.localStorage.setItem(`${scopedIssueListViewKey}:issue-columns`, JSON.stringify(visibleColumns));
|
|
}
|
|
|
|
function StorybookData({ children }: { children: React.ReactNode }) {
|
|
const queryClient = useQueryClient();
|
|
const [ready] = useState(() => {
|
|
hydrateStorybookQueries(queryClient);
|
|
seedIssueListLocalStorage();
|
|
return true;
|
|
});
|
|
|
|
return ready ? children : null;
|
|
}
|
|
|
|
function ColumnConfigurationMatrix() {
|
|
const [columns, setColumns] = useState<InboxIssueColumn[]>(visibleColumns);
|
|
const visibleColumnSet = useMemo(() => new Set(columns), [columns]);
|
|
const triggerRef = useRef<HTMLDivElement | null>(null);
|
|
|
|
useEffect(() => {
|
|
const timer = window.setTimeout(() => {
|
|
triggerRef.current?.querySelector("button")?.click();
|
|
}, 150);
|
|
return () => window.clearTimeout(timer);
|
|
}, []);
|
|
|
|
return (
|
|
<div className="grid gap-5 lg:grid-cols-[minmax(0,1fr)_340px]">
|
|
<div className="overflow-hidden rounded-lg border border-border bg-background/70">
|
|
<div className="grid grid-cols-[minmax(0,1fr)_minmax(420px,0.9fr)] items-center border-b border-border px-4 py-2 text-[11px] font-semibold uppercase text-muted-foreground">
|
|
<span>Issue</span>
|
|
<span className="grid grid-cols-[6rem_7rem_9rem_6rem_4.5rem] gap-2">
|
|
<span>Assignee</span>
|
|
<span>Project</span>
|
|
<span>Workspace</span>
|
|
<span>Tags</span>
|
|
<span className="text-right">Updated</span>
|
|
</span>
|
|
</div>
|
|
{storybookIssues.slice(0, 3).map((issue) => (
|
|
<div key={issue.id} className="grid grid-cols-[minmax(0,1fr)_minmax(420px,0.9fr)] items-center border-b border-border/60 px-4 py-3 last:border-b-0">
|
|
<div className="flex min-w-0 items-center gap-2">
|
|
<InboxIssueMetaLeading
|
|
issue={issue}
|
|
isLive={issue.id === primaryIssue.id}
|
|
showStatus={visibleColumnSet.has("status")}
|
|
showIdentifier={visibleColumnSet.has("id")}
|
|
/>
|
|
<span className="truncate text-sm font-medium">{issue.title}</span>
|
|
</div>
|
|
<InboxIssueTrailingColumns
|
|
issue={issue}
|
|
columns={columns.filter((column) => !["status", "id"].includes(column))}
|
|
projectName={storybookProjects.find((project) => project.id === issue.projectId)?.name ?? null}
|
|
projectColor={storybookProjects.find((project) => project.id === issue.projectId)?.color ?? null}
|
|
workspaceId={issue.projectWorkspaceId ?? issue.executionWorkspaceId}
|
|
workspaceName={issue.currentExecutionWorkspace?.name ?? "Board UI"}
|
|
assigneeName={issue.assigneeAgentId ? storybookAgentMap.get(issue.assigneeAgentId)?.name ?? null : null}
|
|
assigneeUserName={issue.assigneeUserId ? "Riley Board" : null}
|
|
currentUserId="user-board"
|
|
parentIdentifier={storybookIssues.find((candidate) => candidate.id === issue.parentId)?.identifier ?? null}
|
|
parentTitle={storybookIssues.find((candidate) => candidate.id === issue.parentId)?.title ?? null}
|
|
/>
|
|
</div>
|
|
))}
|
|
</div>
|
|
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle className="flex items-center gap-2">
|
|
<Columns3 className="h-4 w-4" />
|
|
Column configuration
|
|
</CardTitle>
|
|
<CardDescription>Open picker plus sort state tokens used beside issue rows.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="space-y-4">
|
|
<div ref={triggerRef}>
|
|
<IssueColumnPicker
|
|
availableColumns={["status", "id", "assignee", "project", "workspace", "parent", "labels", "updated"]}
|
|
visibleColumnSet={visibleColumnSet}
|
|
onToggleColumn={(column, enabled) => {
|
|
setColumns((current) => {
|
|
const next = enabled ? [...current, column] : current.filter((value) => value !== column);
|
|
return DEFAULT_INBOX_ISSUE_COLUMNS.filter((candidate) => next.includes(candidate)).concat(
|
|
next.filter((candidate) => !DEFAULT_INBOX_ISSUE_COLUMNS.includes(candidate)),
|
|
);
|
|
});
|
|
}}
|
|
onResetColumns={() => setColumns(DEFAULT_INBOX_ISSUE_COLUMNS)}
|
|
title="Choose which issue columns stay visible"
|
|
/>
|
|
</div>
|
|
<div className="space-y-2">
|
|
{[
|
|
{ label: "Priority", icon: ArrowUpDown, state: "descending" },
|
|
{ label: "Title", icon: ArrowDownAZ, state: "ascending" },
|
|
{ label: "Updated", icon: Check, state: "active default" },
|
|
].map((item) => {
|
|
const Icon = item.icon;
|
|
return (
|
|
<div key={item.label} className="flex items-center justify-between rounded-md border border-border bg-background/70 px-3 py-2 text-sm">
|
|
<span className="flex items-center gap-2">
|
|
<Icon className="h-3.5 w-3.5 text-muted-foreground" />
|
|
{item.label}
|
|
</span>
|
|
<span className="text-xs text-muted-foreground">{item.state}</span>
|
|
</div>
|
|
);
|
|
})}
|
|
</div>
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function GroupHeaderMatrix() {
|
|
const rows = [
|
|
{ label: "In progress", trailing: "1 issue", badge: <StatusBadge status="in_progress" /> },
|
|
{ label: "High priority", trailing: "3 issues", badge: <PriorityIcon priority="high" showLabel /> },
|
|
{ label: "CodexCoder", trailing: "3 assigned", badge: <Identity name="CodexCoder" size="sm" /> },
|
|
];
|
|
|
|
return (
|
|
<div className="grid gap-4 md:grid-cols-3">
|
|
{rows.map((row, index) => (
|
|
<div key={row.label} className="rounded-lg border border-border bg-background/70 p-2">
|
|
<IssueGroupHeader
|
|
label={row.label}
|
|
collapsible
|
|
collapsed={index === 1}
|
|
trailing={<span className="text-xs text-muted-foreground">{row.trailing}</span>}
|
|
/>
|
|
<div className="border-t border-border px-3 py-4">{row.badge}</div>
|
|
</div>
|
|
))}
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function OpenFiltersPopover() {
|
|
const [state, setState] = useState<IssueFilterState>({
|
|
...defaultIssueFilterState,
|
|
statuses: ["in_progress", "blocked", "in_review"],
|
|
priorities: ["critical", "high"],
|
|
assignees: ["agent-codex", "agent-qa", "__unassigned"],
|
|
});
|
|
const triggerRef = useRef<HTMLDivElement | null>(null);
|
|
|
|
useEffect(() => {
|
|
const timer = window.setTimeout(() => {
|
|
triggerRef.current?.querySelector("button")?.click();
|
|
}, 150);
|
|
return () => window.clearTimeout(timer);
|
|
}, []);
|
|
|
|
return (
|
|
<div className="flex min-h-[500px] items-start justify-end rounded-lg border border-dashed border-border bg-background/60 p-4">
|
|
<div ref={triggerRef}>
|
|
<IssueFiltersPopover
|
|
state={state}
|
|
onChange={(patch) => setState((current) => ({ ...current, ...patch }))}
|
|
activeFilterCount={countActiveIssueFilters(state, true)}
|
|
agents={storybookAgents.map((agent) => ({ id: agent.id, name: agent.name }))}
|
|
projects={storybookProjects.map((project) => ({ id: project.id, name: project.name }))}
|
|
labels={storybookIssueLabels.map((label) => ({ id: label.id, name: label.name, color: label.color }))}
|
|
currentUserId="user-board"
|
|
enableRoutineVisibilityFilter
|
|
buttonVariant="outline"
|
|
workspaces={storybookExecutionWorkspaces.map((workspace) => ({ id: workspace.id, name: workspace.name }))}
|
|
creators={[
|
|
{ id: "user:user-board", label: "Riley Board", kind: "user", searchText: "board user human" },
|
|
...storybookAgents.map((agent) => ({
|
|
id: `agent:${agent.id}`,
|
|
label: agent.name,
|
|
kind: "agent" as const,
|
|
searchText: `${agent.name} ${agent.role}`,
|
|
})),
|
|
]}
|
|
/>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
const modelProfileLedgerRuns: RunForIssue[] = [
|
|
{
|
|
runId: "run-cheap-applied",
|
|
status: "succeeded",
|
|
agentId: "agent-codex",
|
|
adapterType: "codex_local",
|
|
startedAt: "2026-04-29T09:30:00.000Z",
|
|
finishedAt: "2026-04-29T09:32:14.000Z",
|
|
createdAt: "2026-04-29T09:29:55.000Z",
|
|
invocationSource: "manual",
|
|
usageJson: { costCents: 17, inputTokens: 6400, outputTokens: 480 },
|
|
resultJson: {
|
|
stopReason: "completed",
|
|
modelProfile: {
|
|
requested: "cheap",
|
|
applied: "cheap",
|
|
configSource: "agent_runtime_config",
|
|
},
|
|
},
|
|
livenessState: "advanced",
|
|
livenessReason: "Cheap-lane summary completed inside the planned scope.",
|
|
continuationAttempt: 0,
|
|
lastUsefulActionAt: "2026-04-29T09:32:10.000Z",
|
|
nextAction: "Hand the routine output back to the operator inbox.",
|
|
},
|
|
{
|
|
runId: "run-cheap-fallback",
|
|
status: "succeeded",
|
|
agentId: "agent-codex",
|
|
adapterType: "codex_local",
|
|
startedAt: "2026-04-29T08:10:00.000Z",
|
|
finishedAt: "2026-04-29T08:14:42.000Z",
|
|
createdAt: "2026-04-29T08:09:50.000Z",
|
|
invocationSource: "manual",
|
|
usageJson: { costCents: 91, inputTokens: 21800, outputTokens: 3200 },
|
|
resultJson: {
|
|
stopReason: "completed",
|
|
modelProfile: {
|
|
requested: "cheap",
|
|
applied: "primary",
|
|
configSource: "adapter_default",
|
|
fallbackReason: "Cheap profile not configured for this agent",
|
|
},
|
|
},
|
|
livenessState: "advanced",
|
|
livenessReason: "Routine fell back to the primary model after the cheap lookup missed.",
|
|
continuationAttempt: 0,
|
|
lastUsefulActionAt: "2026-04-29T08:14:36.000Z",
|
|
nextAction: "Configure agent-codex with a cheap profile to avoid the fallback.",
|
|
},
|
|
{
|
|
runId: "run-baseline",
|
|
status: "succeeded",
|
|
agentId: "agent-codex",
|
|
adapterType: "codex_local",
|
|
startedAt: "2026-04-28T18:05:00.000Z",
|
|
finishedAt: "2026-04-28T18:14:11.000Z",
|
|
createdAt: "2026-04-28T18:04:50.000Z",
|
|
invocationSource: "scheduler",
|
|
usageJson: { costCents: 142, inputTokens: 38400, outputTokens: 7200 },
|
|
resultJson: { stopReason: "completed" },
|
|
livenessState: "advanced",
|
|
livenessReason: "Standard primary-lane run with no profile metadata recorded.",
|
|
continuationAttempt: 0,
|
|
lastUsefulActionAt: "2026-04-28T18:13:58.000Z",
|
|
nextAction: "Continue with the next planned subtask.",
|
|
},
|
|
];
|
|
|
|
function ModelProfileBadgeLedger() {
|
|
return (
|
|
<div className="grid gap-5 xl:grid-cols-[minmax(0,1fr)_360px]">
|
|
<IssueRunLedgerContent
|
|
runs={modelProfileLedgerRuns}
|
|
activeRun={null}
|
|
liveRuns={[]}
|
|
issueStatus="in_progress"
|
|
childIssues={[]}
|
|
agentMap={storybookAgentMap}
|
|
/>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle className="flex items-center gap-2">
|
|
<GitBranch className="h-4 w-4" />
|
|
Model profile metadata
|
|
</CardTitle>
|
|
<CardDescription>
|
|
Profile badges read <code>resultJson.modelProfile</code> on each run. Applied matching the request renders
|
|
emerald; an applied fallback renders amber and surfaces the inline reason.
|
|
</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="space-y-3 text-xs text-muted-foreground">
|
|
<div className="rounded-md border border-border bg-background/70 p-3">
|
|
<div className="font-mono text-emerald-600 dark:text-emerald-400">Profile: cheap</div>
|
|
<p className="mt-1">requested + applied both equal cheap → emerald badge.</p>
|
|
</div>
|
|
<div className="rounded-md border border-border bg-background/70 p-3">
|
|
<div className="font-mono text-amber-600 dark:text-amber-400">Profile: cheap → primary</div>
|
|
<p className="mt-1">cheap requested but primary applied → amber badge plus inline fallback reason.</p>
|
|
</div>
|
|
<div className="rounded-md border border-border bg-background/70 p-3">
|
|
<div className="font-mono text-muted-foreground">No profile badge</div>
|
|
<p className="mt-1">Run with no <code>modelProfile</code> metadata renders without a badge for visual contrast.</p>
|
|
</div>
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function RunLedgerWithCostColumns() {
|
|
return (
|
|
<div className="grid gap-5 xl:grid-cols-[minmax(0,1fr)_380px]">
|
|
<IssueRunLedgerContent
|
|
runs={storybookIssueRuns}
|
|
activeRun={null}
|
|
liveRuns={[]}
|
|
issueStatus={primaryIssue.status}
|
|
childIssues={childIssues}
|
|
agentMap={storybookAgentMap}
|
|
/>
|
|
<div className="overflow-hidden rounded-lg border border-border bg-background/70">
|
|
<div className="grid grid-cols-[1fr_90px_80px_70px] gap-2 border-b border-border px-3 py-2 text-[11px] font-semibold uppercase text-muted-foreground">
|
|
<span>Run</span>
|
|
<span>Status</span>
|
|
<span>Duration</span>
|
|
<span className="text-right">Cost</span>
|
|
</div>
|
|
{storybookIssueRuns.map((run) => {
|
|
const start = run.startedAt ? new Date(run.startedAt).getTime() : null;
|
|
const end = run.finishedAt ? new Date(run.finishedAt).getTime() : Date.now();
|
|
const minutes = start ? Math.max(1, Math.round((end - start) / 60_000)) : null;
|
|
const costCents = typeof run.usageJson?.costCents === "number" ? run.usageJson.costCents : 0;
|
|
return (
|
|
<div key={run.runId} className="grid grid-cols-[1fr_90px_80px_70px] gap-2 border-b border-border/60 px-3 py-2 text-xs last:border-b-0">
|
|
<span className="min-w-0 truncate font-mono">{run.runId}</span>
|
|
<span className="capitalize text-muted-foreground">{run.status}</span>
|
|
<span className="text-muted-foreground">{minutes ? `${minutes}m` : "unknown"}</span>
|
|
<span className="text-right font-mono">${(costCents / 100).toFixed(2)}</span>
|
|
</div>
|
|
);
|
|
})}
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function WorkspaceCardWithRuntime() {
|
|
const service = primaryIssue.currentExecutionWorkspace?.runtimeServices?.[0] ?? null;
|
|
|
|
return (
|
|
<div className="grid gap-5 lg:grid-cols-[minmax(0,1fr)_360px]">
|
|
<IssueWorkspaceCard
|
|
issue={primaryIssue}
|
|
project={storybookProjects[0]!}
|
|
onUpdate={() => undefined}
|
|
/>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle className="flex items-center gap-2">
|
|
<GitBranch className="h-4 w-4" />
|
|
Runtime status
|
|
</CardTitle>
|
|
<CardDescription>Branch, path, and running service context paired with the workspace card.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="space-y-3 text-sm">
|
|
<div className="flex items-center justify-between gap-3">
|
|
<span className="text-muted-foreground">Branch</span>
|
|
<span className="truncate font-mono text-xs">{primaryIssue.currentExecutionWorkspace?.branchName}</span>
|
|
</div>
|
|
<div className="space-y-1">
|
|
<span className="text-muted-foreground">Path</span>
|
|
<div className="break-all rounded-md border border-border bg-background/70 p-2 font-mono text-xs">
|
|
{primaryIssue.currentExecutionWorkspace?.cwd}
|
|
</div>
|
|
</div>
|
|
{service ? (
|
|
<div className="flex items-center justify-between gap-3 rounded-md border border-border bg-background/70 px-3 py-2">
|
|
<span>{service.serviceName}</span>
|
|
<Badge variant="outline">{service.status}</Badge>
|
|
</div>
|
|
) : null}
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function QuicklookSurfaces() {
|
|
return (
|
|
<div className="grid gap-5 lg:grid-cols-2">
|
|
<div className="rounded-lg border border-border bg-background/70 p-4">
|
|
<div className="mb-3 flex items-center gap-2 text-sm font-medium">
|
|
<Link2 className="h-4 w-4 text-muted-foreground" />
|
|
IssueLinkQuicklook
|
|
</div>
|
|
<IssueLinkQuicklook
|
|
issuePathId={primaryIssue.identifier ?? primaryIssue.id}
|
|
issuePrefetch={primaryIssue}
|
|
to={`/PAP/issues/${primaryIssue.identifier}`}
|
|
className="font-mono text-sm text-primary hover:underline"
|
|
>
|
|
{primaryIssue.identifier}
|
|
</IssueLinkQuicklook>
|
|
<div className="mt-4 rounded-md border border-border bg-popover p-3 shadow-xl">
|
|
<IssueQuicklookCard
|
|
issue={primaryIssue}
|
|
linkTo={`/PAP/issues/${primaryIssue.identifier}`}
|
|
compact
|
|
/>
|
|
</div>
|
|
</div>
|
|
|
|
<div className="rounded-lg border border-border bg-background/70 p-4">
|
|
<div className="mb-3 flex items-center gap-2 text-sm font-medium">
|
|
<PanelRight className="h-4 w-4 text-muted-foreground" />
|
|
IssuesQuicklook
|
|
</div>
|
|
<IssuesQuicklook issue={storybookIssues[2]!}>
|
|
<Button variant="outline" size="sm">Hover preview trigger</Button>
|
|
</IssuesQuicklook>
|
|
<div className="mt-4 rounded-md border border-border bg-card p-3">
|
|
<IssueQuicklookCard
|
|
issue={storybookIssues[2]!}
|
|
linkTo={`/PAP/issues/${storybookIssues[2]!.identifier}`}
|
|
/>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
function IssueManagementStories() {
|
|
return (
|
|
<StorybookData>
|
|
<div className="paperclip-story">
|
|
<main className="paperclip-story__inner space-y-6">
|
|
<section className="paperclip-story__frame p-6">
|
|
<div className="flex flex-wrap items-start justify-between gap-5">
|
|
<div>
|
|
<div className="paperclip-story__label">Issue management</div>
|
|
<h1 className="mt-2 text-3xl font-semibold tracking-tight">List, detail, filters, runs, and workspace states</h1>
|
|
<p className="mt-3 max-w-3xl text-sm leading-6 text-muted-foreground">
|
|
Fixture-backed issue management stories cover the operational states used by the board when reviewing,
|
|
filtering, handing off, and continuing agent work.
|
|
</p>
|
|
</div>
|
|
<div className="flex flex-wrap gap-2">
|
|
<Badge variant="outline">7 issues</Badge>
|
|
<Badge variant="outline">3 agents</Badge>
|
|
<Badge variant="outline">workspace aware</Badge>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
|
|
<Section eyebrow="IssuesList" title="Full list view with grouped issue rows and column headers">
|
|
<div className="mb-3 grid grid-cols-[minmax(0,1fr)_120px_120px_110px] gap-3 rounded-lg border border-border bg-background/70 px-4 py-2 text-[11px] font-semibold uppercase text-muted-foreground">
|
|
<span>Issue</span>
|
|
<span>Assignee</span>
|
|
<span>Workspace</span>
|
|
<span className="text-right">Updated</span>
|
|
</div>
|
|
<IssuesList
|
|
issues={storybookIssues}
|
|
agents={storybookAgents}
|
|
projects={storybookProjects}
|
|
liveIssueIds={new Set([primaryIssue.id])}
|
|
viewStateKey={issueListViewKey}
|
|
onUpdateIssue={() => undefined}
|
|
createIssueLabel="issue"
|
|
enableRoutineVisibilityFilter
|
|
/>
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueColumns" title="Column configuration and sorting states">
|
|
<ColumnConfigurationMatrix />
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueGroupHeader" title="Grouped by status, priority, and assignee">
|
|
<GroupHeaderMatrix />
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueProperties" title="Full issue detail sidebar with all property fields">
|
|
<div className="grid gap-5 lg:grid-cols-[minmax(0,1fr)_380px]">
|
|
<div className="space-y-4 rounded-lg border border-border bg-background/70 p-5">
|
|
<div className="flex flex-wrap items-center gap-2">
|
|
<StatusBadge status={primaryIssue.status} />
|
|
<PriorityIcon priority={primaryIssue.priority} showLabel />
|
|
<Badge variant="secondary">{primaryIssue.identifier}</Badge>
|
|
</div>
|
|
<h3 className="text-2xl font-semibold tracking-tight">{primaryIssue.title}</h3>
|
|
<p className="max-w-2xl text-sm leading-6 text-muted-foreground">{primaryIssue.description}</p>
|
|
</div>
|
|
<div className="rounded-lg border border-border bg-background/70 p-4">
|
|
<IssueProperties
|
|
issue={primaryIssue}
|
|
childIssues={childIssues}
|
|
onAddSubIssue={() => undefined}
|
|
onUpdate={() => undefined}
|
|
inline
|
|
/>
|
|
</div>
|
|
</div>
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueDocumentsSection" title="Documents list with plan and notes documents">
|
|
<IssueDocumentsSection
|
|
issue={primaryIssue}
|
|
canDeleteDocuments
|
|
feedbackDataSharingPreference="allowed"
|
|
/>
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueFiltersPopover" title="Open filter popover with status, priority, and assignee filters">
|
|
<OpenFiltersPopover />
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueContinuationHandoff" title="Expanded handoff for continuing work across runs">
|
|
<IssueContinuationHandoff document={storybookContinuationHandoff} focusSignal={1} />
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueRunLedger" title="Run history table with status, duration, and cost columns">
|
|
<RunLedgerWithCostColumns />
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueRunLedger" title="Model profile badges for cheap, fallback, and baseline runs">
|
|
<ModelProfileBadgeLedger />
|
|
</Section>
|
|
|
|
<Section eyebrow="IssueWorkspaceCard" title="Workspace info card with branch, path, and runtime status">
|
|
<WorkspaceCardWithRuntime />
|
|
</Section>
|
|
|
|
<Section eyebrow="Quicklook" title="Linked issue popup and side-panel quick look">
|
|
<QuicklookSurfaces />
|
|
</Section>
|
|
|
|
<section className="grid gap-4 md:grid-cols-3">
|
|
{[
|
|
{ icon: LayoutList, label: "List density", detail: "Grouped rows keep status and ownership visible." },
|
|
{ icon: Filter, label: "Filtering", detail: "Selected filters are explicit and clearable." },
|
|
{ icon: Rows3, label: "Detail panels", detail: "Properties, documents, runs, and workspaces stay close to the task." },
|
|
].map((item) => {
|
|
const Icon = item.icon;
|
|
return (
|
|
<Card key={item.label} className="paperclip-story__frame shadow-none">
|
|
<CardHeader>
|
|
<Icon className="h-4 w-4 text-muted-foreground" />
|
|
<CardTitle>{item.label}</CardTitle>
|
|
<CardDescription>{item.detail}</CardDescription>
|
|
</CardHeader>
|
|
</Card>
|
|
);
|
|
})}
|
|
</section>
|
|
</main>
|
|
</div>
|
|
</StorybookData>
|
|
);
|
|
}
|
|
|
|
const meta = {
|
|
title: "Product/Issue Management",
|
|
component: IssueManagementStories,
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
component:
|
|
"Issue-management stories exercise the full list, column, grouping, property, document, filter, continuation, run, workspace, and quicklook surfaces.",
|
|
},
|
|
},
|
|
},
|
|
} satisfies Meta<typeof IssueManagementStories>;
|
|
|
|
export default meta;
|
|
|
|
type Story = StoryObj<typeof meta>;
|
|
|
|
export const FullSurfaceMatrix: Story = {};
|
|
|
|
function ModelProfileLedgerStandalone() {
|
|
return (
|
|
<StorybookData>
|
|
<div className="paperclip-story">
|
|
<main className="paperclip-story__inner space-y-6">
|
|
<section className="paperclip-story__frame p-6">
|
|
<div className="flex flex-wrap items-start justify-between gap-5">
|
|
<div>
|
|
<div className="paperclip-story__label">IssueRunLedger</div>
|
|
<h1 className="mt-2 text-3xl font-semibold tracking-tight">Model profile badges</h1>
|
|
<p className="mt-3 max-w-3xl text-sm leading-6 text-muted-foreground">
|
|
Run ledger isolated to the cheap-lane visual states: an emerald applied=cheap badge, an amber
|
|
cheap-fell-back-to-primary badge with the inline fallback reason, and a baseline run without a
|
|
modelProfile so the visual diff stays obvious.
|
|
</p>
|
|
</div>
|
|
<div className="flex flex-wrap gap-2">
|
|
<Badge variant="outline">cheap applied</Badge>
|
|
<Badge variant="outline">cheap → primary</Badge>
|
|
<Badge variant="outline">no profile</Badge>
|
|
</div>
|
|
</div>
|
|
</section>
|
|
<Section eyebrow="IssueRunLedger" title="Cheap, fallback, and baseline runs">
|
|
<ModelProfileBadgeLedger />
|
|
</Section>
|
|
</main>
|
|
</div>
|
|
</StorybookData>
|
|
);
|
|
}
|
|
|
|
export const RunLedgerModelProfileBadges: Story = {
|
|
name: "Run ledger - Model profile badges",
|
|
render: () => <ModelProfileLedgerStandalone />,
|
|
};
|