2de893f624
## Thinking Path > - Paperclip orchestrates AI agents for zero-human companies. > - The board UI is the main operator surface, so its component and workflow coverage needs to stay reviewable as the product grows. > - This branch adds Storybook as a dedicated UI reference surface for core Paperclip screens and interaction patterns. > - That work spans Storybook infrastructure, app-level provider wiring, and a large fixture set that can render real control-plane states without a live backend. > - The branch also expands coverage across agents, budgets, issues, chat, dialogs, navigation, projects, and data visualization so future UI changes have a concrete visual baseline. > - This pull request packages that Storybook work on top of the latest `master`, excludes the lockfile from the final diff per repo policy, and fixes one fixture contract drift caught during verification. > - The benefit is a single reviewable PR that adds broad UI documentation and regression-surfacing coverage without losing the existing branch work. ## What Changed - Added Storybook 10 wiring for the UI package, including root scripts, UI package scripts, Storybook config, preview wrappers, Tailwind entrypoints, and setup docs. - Added a large fixture-backed data source for Storybook so complex board states can render without a live server. - Added story suites covering foundations, status language, control-plane surfaces, overview, UX labs, agent management, budget and finance, forms and editors, issue management, navigation and layout, chat and comments, data visualization, dialogs and modals, and projects/goals/workspaces. - Adjusted several UI components for Storybook parity so dialogs, menus, keyboard shortcuts, budget markers, markdown editing, and related surfaces render correctly in isolation. - Rebasing work for PR assembly: replayed the branch onto current `master`, removed `pnpm-lock.yaml` from the final PR diff, and aligned the dashboard fixture with the current `DashboardSummary.runActivity` API contract. ## Verification - `pnpm --filter @paperclipai/ui typecheck` - `pnpm --filter @paperclipai/ui build-storybook` - Manual diff audit after rebase: verified the PR no longer includes `pnpm-lock.yaml` and now cleanly targets current `master`. - Before/after UI note: before this branch there was no dedicated Storybook surface for these Paperclip views; after this branch the local Storybook build includes the new overview and domain story suites in `ui/storybook-static`. ## Risks - Large static fixture files can drift from shared types as dashboard and UI contracts evolve; this PR already needed one fixture correction for `runActivity`. - Storybook bundle output includes some large chunks, so future growth may need chunking work if build performance becomes an issue. - Several component tweaks were made for isolated rendering parity, so reviewers should spot-check key board surfaces against the live app behavior. ## Model Used - OpenAI Codex, GPT-5-based coding agent in the Paperclip harness; exact serving model ID is not exposed in-runtime to the agent. - Tool-assisted workflow with terminal execution, git operations, local typecheck/build verification, and GitHub CLI PR creation. - Context window/reasoning mode not surfaced by the harness. ## 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>
212 lines
8.9 KiB
TypeScript
212 lines
8.9 KiB
TypeScript
import { useState } from "react";
|
|
import type { Meta, StoryObj } from "@storybook/react-vite";
|
|
import { AGENT_STATUSES, ISSUE_PRIORITIES, ISSUE_STATUSES } from "@paperclipai/shared";
|
|
import { Bot, CheckCircle2, Clock3, DollarSign, FolderKanban, Inbox, MessageSquare, Users } from "lucide-react";
|
|
import { CopyText } from "@/components/CopyText";
|
|
import { EmptyState } from "@/components/EmptyState";
|
|
import { Identity } from "@/components/Identity";
|
|
import { MetricCard } from "@/components/MetricCard";
|
|
import { PriorityIcon } from "@/components/PriorityIcon";
|
|
import { QuotaBar } from "@/components/QuotaBar";
|
|
import { StatusBadge } from "@/components/StatusBadge";
|
|
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card";
|
|
|
|
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 StatusLanguage() {
|
|
const [priority, setPriority] = useState("high");
|
|
|
|
return (
|
|
<div className="paperclip-story">
|
|
<main className="paperclip-story__inner space-y-6">
|
|
<section className="paperclip-story__frame p-6">
|
|
<div className="paperclip-story__label">Language</div>
|
|
<h1 className="mt-2 text-3xl font-semibold tracking-tight">Status, priority, identity, and metrics</h1>
|
|
<p className="mt-3 max-w-3xl text-sm leading-6 text-muted-foreground">
|
|
These components carry the operational vocabulary of the board: who is acting, what state work is in,
|
|
how urgent it is, and whether capacity or spend needs attention.
|
|
</p>
|
|
</section>
|
|
|
|
<Section eyebrow="Lifecycle" title="Issue and agent statuses">
|
|
<div className="grid gap-4 md:grid-cols-2">
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Issue statuses</CardTitle>
|
|
<CardDescription>Every task transition state in the V1 issue lifecycle.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="flex flex-wrap gap-2">
|
|
{ISSUE_STATUSES.map((status) => (
|
|
<StatusBadge key={status} status={status} />
|
|
))}
|
|
</CardContent>
|
|
</Card>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Agent statuses</CardTitle>
|
|
<CardDescription>Runtime and governance states shown in org, sidebar, and detail surfaces.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="flex flex-wrap gap-2">
|
|
{AGENT_STATUSES.map((status) => (
|
|
<StatusBadge key={status} status={status} />
|
|
))}
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
</Section>
|
|
|
|
<Section eyebrow="Priority" title="Static labels and editable popover trigger">
|
|
<div className="grid gap-4 lg:grid-cols-[1fr_320px]">
|
|
<div className="grid gap-3 sm:grid-cols-2">
|
|
{ISSUE_PRIORITIES.map((item) => (
|
|
<div key={item} className="flex items-center justify-between rounded-lg border border-border bg-background/70 p-4">
|
|
<PriorityIcon priority={item} showLabel />
|
|
<span className="font-mono text-xs text-muted-foreground">{item}</span>
|
|
</div>
|
|
))}
|
|
</div>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Editable priority</CardTitle>
|
|
<CardDescription>Click the control to inspect the same popover used in issue rows.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent>
|
|
<PriorityIcon priority={priority} onChange={setPriority} showLabel />
|
|
<div className="mt-3 text-xs text-muted-foreground">Current value: {priority}</div>
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
</Section>
|
|
|
|
<Section eyebrow="Identity" title="Agent and user chips">
|
|
<div className="grid gap-4 md:grid-cols-2 xl:grid-cols-4">
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>XS</CardTitle>
|
|
</CardHeader>
|
|
<CardContent>
|
|
<Identity name="CodexCoder" size="xs" />
|
|
</CardContent>
|
|
</Card>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Small</CardTitle>
|
|
</CardHeader>
|
|
<CardContent>
|
|
<Identity name="Board User" size="sm" initials="BU" />
|
|
</CardContent>
|
|
</Card>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Default</CardTitle>
|
|
</CardHeader>
|
|
<CardContent>
|
|
<Identity name="DesignSystemCoder" />
|
|
</CardContent>
|
|
</Card>
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Long label</CardTitle>
|
|
</CardHeader>
|
|
<CardContent className="max-w-[220px]">
|
|
<Identity name="Senior Product Engineering Reviewer" size="lg" />
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
</Section>
|
|
|
|
<Section eyebrow="Dashboard" title="Metrics, quota bars, empty states, and copy affordances">
|
|
<div className="grid gap-5 xl:grid-cols-[minmax(0,1fr)_360px]">
|
|
<div className="grid gap-3 sm:grid-cols-2 xl:grid-cols-4">
|
|
<MetricCard icon={Users} value={8} label="Active agents" description="3 running right now" to="/agents/active" />
|
|
<MetricCard icon={FolderKanban} value={27} label="Open issues" description="5 in review" to="/issues" />
|
|
<MetricCard icon={DollarSign} value="$675" label="MTD spend" description="27% of budget" to="/costs" />
|
|
<MetricCard icon={Clock3} value="14m" label="P95 run age" description="last 24 hours" />
|
|
</div>
|
|
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Copyable identifiers</CardTitle>
|
|
<CardDescription>Click values to exercise the status tooltip.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="space-y-2 text-sm">
|
|
<div className="flex items-center justify-between gap-3">
|
|
<span className="text-muted-foreground">Issue</span>
|
|
<CopyText text="PAP-1641" className="font-mono">PAP-1641</CopyText>
|
|
</div>
|
|
<div className="flex items-center justify-between gap-3">
|
|
<span className="text-muted-foreground">Run</span>
|
|
<CopyText text="49442f05-f1c1-45c5-88d3-1e5b871dbb8b" className="font-mono">
|
|
49442f05
|
|
</CopyText>
|
|
</div>
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
|
|
<div className="mt-5 grid gap-5 lg:grid-cols-[minmax(0,1fr)_360px]">
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Quota thresholds</CardTitle>
|
|
<CardDescription>Green, warning, and hard-stop-adjacent progress treatments.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent className="space-y-5">
|
|
<QuotaBar label="Company budget" percentUsed={27} leftLabel="$675 used" rightLabel="$2,500 cap" />
|
|
<QuotaBar label="Project budget" percentUsed={86} leftLabel="$1,031 used" rightLabel="$1,200 cap" />
|
|
<QuotaBar label="Agent budget" percentUsed={108} leftLabel="$432 used" rightLabel="$400 cap" showDeficitNotch />
|
|
</CardContent>
|
|
</Card>
|
|
|
|
<Card className="shadow-none">
|
|
<CardHeader>
|
|
<CardTitle>Empty state</CardTitle>
|
|
<CardDescription>Used when a list has no meaningful rows yet.</CardDescription>
|
|
</CardHeader>
|
|
<CardContent>
|
|
<EmptyState icon={Inbox} message="No assigned work is waiting in this queue." action="Create issue" onAction={() => undefined} />
|
|
</CardContent>
|
|
</Card>
|
|
</div>
|
|
</Section>
|
|
</main>
|
|
</div>
|
|
);
|
|
}
|
|
|
|
const meta = {
|
|
title: "Foundations/Status Language",
|
|
component: StatusLanguage,
|
|
parameters: {
|
|
docs: {
|
|
description: {
|
|
component:
|
|
"Status-language stories show the reusable operational labels, identity chips, metrics, and capacity indicators used throughout the board.",
|
|
},
|
|
},
|
|
},
|
|
} satisfies Meta<typeof StatusLanguage>;
|
|
|
|
export default meta;
|
|
|
|
type Story = StoryObj<typeof meta>;
|
|
|
|
export const FullMatrix: Story = {};
|