paperclip/ui/storybook/stories/dev-ops-surfaces.stories.tsx

74 lines
2.2 KiB
TypeScript
Raw Normal View History

[codex] UI and dev ops quality-of-life (#6384) ## Thinking Path > - Paperclip operators spend most of their time scanning the board, inbox, sidebar, and local dev status surfaces > - Small UI and dev-ops frictions make repeated operator workflows feel slower than they need to be > - The working branch contained several independent quality-of-life improvements mixed with larger cloud work > - Grouping these smaller UI/dev-ops changes together keeps review overhead reasonable without merging them into feature PRs > - This pull request collects the operator-facing QoL polish into one standalone branch > - The benefit is a cleaner board navigation and local dev recovery experience without depending on cloud upstream sync ## What Changed - Relaxed forced 44px touch targets for small inline widgets. - Fixed mobile mention menu scrolling and sidebar spacing on touch/mobile layouts. - Synced inbox hover state with j/k selection. - Moved plugin sidebar entries into the Work section. - Added manual dev-server restart action/banner behavior. - Logged plugin bridge 502 causes for better diagnosis. ## Verification - `pnpm install --frozen-lockfile --ignore-scripts` - `pnpm --filter @paperclipai/plugin-sdk build` - `pnpm exec vitest run ui/src/components/MarkdownEditor.test.tsx ui/src/components/Sidebar.test.tsx ui/src/components/SidebarProjects.test.tsx ui/src/pages/Inbox.test.tsx ui/src/components/DevRestartBanner.test.tsx server/src/__tests__/dev-server-status.test.ts server/src/__tests__/health-dev-server-token.test.ts server/src/__tests__/plugin-routes-authz.test.ts` initially failed only because plugin SDK `dist` was not built in the fresh worktree. - Rerun after build: `pnpm exec vitest run server/src/__tests__/plugin-routes-authz.test.ts` passed. - The remaining targeted UI/dev-server tests passed on the first post-install run. ## Visual Evidence - Sidebar layout and plugin Work section: ![Sidebar desktop](https://raw.githubusercontent.com/paperclipai/paperclip/pap-9861-ui-dev-qol/docs/pr-screenshots/pr-6384/sidebar-desktop.png) - Inbox/task row selection and hover-state surface: ![Inbox rows desktop](https://raw.githubusercontent.com/paperclipai/paperclip/pap-9861-ui-dev-qol/docs/pr-screenshots/pr-6384/inbox-rows-desktop.png) - Dev restart banner desktop: ![Dev restart banner desktop](https://raw.githubusercontent.com/paperclipai/paperclip/pap-9861-ui-dev-qol/docs/pr-screenshots/pr-6384/dev-restart-banner-desktop.png) - Dev restart banner mobile: ![Dev restart banner mobile](https://raw.githubusercontent.com/paperclipai/paperclip/pap-9861-ui-dev-qol/docs/pr-screenshots/pr-6384/dev-restart-banner-mobile.png) ## Risks - Mostly UI/dev ergonomics with low data risk. - Sidebar and inbox changes touch frequently used navigation surfaces, so visual review on desktop/mobile is still useful. > 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 with local shell/git/tool use. Exact hosted model ID and context-window size are not exposed by the local Paperclip adapter 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 - [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] I will address all Greptile and reviewer comments before requesting merge --------- Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-05-19 15:52:39 -05:00
import type { Meta, StoryObj } from "@storybook/react-vite";
import { DevRestartBanner } from "@/components/DevRestartBanner";
import type { DevServerHealthStatus } from "@/api/health";
const restartRequired: DevServerHealthStatus = {
enabled: true,
restartRequired: true,
reason: "backend_changes_and_pending_migrations",
lastChangedAt: new Date(Date.now() - 7 * 60_000).toISOString(),
changedPathCount: 4,
changedPathsSample: [
"server/src/routes/health.ts",
"server/src/dev-runner.ts",
"packages/shared/src/api.ts",
],
pendingMigrations: ["0042_dev_server_health.sql"],
autoRestartEnabled: false,
activeRunCount: 0,
waitingForIdle: false,
lastRestartAt: new Date(Date.now() - 45 * 60_000).toISOString(),
};
const restartWaitingForIdle: DevServerHealthStatus = {
...restartRequired,
reason: "backend_changes",
pendingMigrations: [],
autoRestartEnabled: true,
activeRunCount: 2,
waitingForIdle: true,
};
function DevOpsSurfacesStory() {
return (
<div className="space-y-6 p-6">
<section className="overflow-hidden border border-border bg-background">
<div className="border-b border-border px-5 py-4">
<div className="text-xs font-semibold uppercase tracking-wide text-muted-foreground">
Dev server restart banner
</div>
</div>
<DevRestartBanner devServer={restartRequired} />
</section>
<section className="max-w-[390px] overflow-hidden border border-border bg-background">
<div className="border-b border-border px-4 py-3">
<div className="text-xs font-semibold uppercase tracking-wide text-muted-foreground">
Mobile waiting state
</div>
</div>
<DevRestartBanner devServer={restartWaitingForIdle} />
</section>
</div>
);
}
const meta = {
title: "Product/Dev Ops Surfaces",
component: DevOpsSurfacesStory,
parameters: {
docs: {
description: {
component:
"Shows local development recovery surfaces, including the restart-required banner and its manual restart action.",
},
},
},
} satisfies Meta<typeof DevOpsSurfacesStory>;
export default meta;
type Story = StoryObj<typeof meta>;
export const DevOpsSurfaces: Story = {};