mirror of
https://github.com/paperclipai/paperclip.git
synced 2026-10-08 11:13:44 +02:00
## Thinking Path > - Paperclip is the open source control plane people use to organize, govern, and understand AI-agent work > - Operators need concise, current status views across projects and execution workspaces without manually reading every issue and run > - Paperclip already has auditable issues, documents, built-in agents, routines, and live run events, but no first-class summary-slot workflow connecting those systems > - A built-in Summarizer can generate status prose through ordinary governed tasks while summary slots provide stable, revisioned destinations for that output > - The UI needs to show current summaries, generation progress, failures, revisions, and streaming draft status in the places operators already work > - This pull request adds the end-to-end summary-slot data, API, agent, orchestration, and UI surfaces behind an experimental setting > - The benefit is decision-oriented status context that remains company-scoped, auditable, retryable, and inexpensive by default ## Linked Issues or Issue Description No public GitHub issue exists for this feature. **Problem** Operators currently have to reconstruct project and workspace status by reading many issues, runs, and comments. This makes it hard to identify decisions, review queues, recent work, and the next event worth watching. **Proposed capability** Add an experimental summary system with revisioned summary slots for projects and workspaces, a paused-by-default built-in Summarizer agent, governed generation tasks, live draft status, and reusable UI cards. **Expected behavior** - Summary data remains company-scoped and revisions remain auditable. - Generation runs through normal issue/agent orchestration and deduplicates active requests. - Only the linked built-in Summarizer generation task can author a slot revision. - Operators can generate, retry, inspect revisions, and follow draft progress from project and workspace views. - The feature remains opt-in and background generation remains paused by default. ## What Changed - Added summary-slot schema, idempotent migrations, shared contracts, validators, API paths, and service tests. - Added company-scoped summary-slot routes for reading revisions, requesting generation, and guarded Summarizer writes with activity logging. - Added terminal generation finalization, failure reasons, assignment wakeups, and orchestration integration. - Added the paused-by-default built-in Summarizer bundle, low-cost runtime defaults, status-summarization skill, and stale-summary routine. - Added summary cards, revision selection, retry/configuration states, live draft streaming, transcript chunk handling, and project/workspace integrations. - Updated Claude local parsing for streamed status output and expanded server, adapter, shared, database, catalog, and UI coverage. ## Verification - `pnpm -r typecheck` - `pnpm exec vitest run packages/db/src/summary-slots-schema.test.ts packages/shared/src/summary-slot.test.ts server/src/__tests__/summary-slot-routes.test.ts server/src/__tests__/summary-slots.test.ts server/src/__tests__/built-in-agents.test.ts ui/src/components/SummarySlotCard.test.tsx ui/src/components/SummarySlotCard.status.test.tsx ui/src/components/useSummaryDraftStream.test.tsx ui/src/lib/summary-draft-stream.test.ts ui/src/lib/run-log-chunks.test.ts ui/src/context/LiveUpdatesProvider.hook.test.tsx` — 113 tests passed - `pnpm test:run` — server and UI suites passed; one CLI AWS doctor test was affected by inherited `AWS_ACCESS_KEY_ID`/`AWS_SECRET_ACCESS_KEY`, and passed when those host credentials were removed - `pnpm exec vitest run cli/src/__tests__/secrets.test.ts` with inherited AWS credential variables removed — 8 tests passed - `pnpm build` - `pnpm check:token-gates` currently reports nine `#9627` comment references introduced by current `master`; none are in this PR diff ## Risks - Database risk is limited by incrementally ordered, idempotent migrations and migration safety checks. - Summary generation creates normal issues/runs, so misconfiguration can produce failed slots; the UI exposes retryable failure reasons and agent configuration entry points. - Streaming draft parsing depends on the documented `STATUS:` protocol; final persisted revisions remain the source of truth. - The feature is experimental, opt-in, and its built-in routine is paused with no background token spend by default. > 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 GPT-5.3 Codex with reasoning, repository tool use, code execution, GitHub CLI, and Paperclip control-plane integration. Earlier branch commits also record Claude model co-authorship where applicable. ## 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 not referenced internal/instance-local Paperclip issues or links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip` URLs) - [x] My branch name describes the change (e.g. `docs/...`, `fix/...`) and contains no internal Paperclip ticket id or instance-derived details - [x] I have run tests locally and they pass - [x] I have added or updated tests where applicable - [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: Paperclip <noreply@paperclip.ing> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
179 lines
7.0 KiB
TypeScript
179 lines
7.0 KiB
TypeScript
import { useEffect, useMemo } from "react";
|
|
import { Link, Navigate } from "@/lib/router";
|
|
import { useInfiniteQuery, useQuery } from "@tanstack/react-query";
|
|
import type { WorkspaceOverviewItem } from "@paperclipai/shared";
|
|
import { Button } from "@/components/ui/button";
|
|
import { executionWorkspacesApi } from "../api/execution-workspaces";
|
|
import { instanceSettingsApi } from "../api/instanceSettings";
|
|
import { ProjectWorkspacesContent } from "../components/ProjectWorkspacesContent";
|
|
import { SummarySlotCard } from "../components/SummarySlotCard";
|
|
import { PageSkeleton } from "../components/PageSkeleton";
|
|
import { useBreadcrumbs } from "../context/BreadcrumbContext";
|
|
import { useCompany } from "../context/CompanyContext";
|
|
import type { ProjectWorkspaceSummary } from "../lib/project-workspaces-tab";
|
|
import { queryKeys } from "../lib/queryKeys";
|
|
import { projectRouteRef } from "../lib/utils";
|
|
|
|
type ProjectWorkspaceGroup = {
|
|
projectId: string;
|
|
projectName: string;
|
|
projectRef: string;
|
|
summaries: ProjectWorkspaceSummary[];
|
|
lastUpdatedAt: Date;
|
|
runningServiceCount: number;
|
|
};
|
|
|
|
function overviewItemToSummary(item: WorkspaceOverviewItem): ProjectWorkspaceSummary {
|
|
return {
|
|
key: item.key,
|
|
kind: item.kind,
|
|
workspaceId: item.workspaceId,
|
|
workspaceName: item.workspaceName,
|
|
cwd: item.cwd,
|
|
branchName: item.branchName,
|
|
lastUpdatedAt: item.lastUpdatedAt,
|
|
projectWorkspaceId: item.projectWorkspaceId,
|
|
executionWorkspaceId: item.executionWorkspaceId,
|
|
executionWorkspaceStatus: item.executionWorkspaceStatus,
|
|
serviceCount: item.serviceCount,
|
|
runningServiceCount: item.runningServiceCount,
|
|
primaryServiceUrl: item.primaryServiceUrl,
|
|
primaryServiceUrlRunning: item.primaryServiceUrlRunning,
|
|
hasRuntimeConfig: item.hasRuntimeConfig,
|
|
linkedIssueCount: item.linkedIssueCount,
|
|
issues: item.linkedIssues,
|
|
};
|
|
}
|
|
|
|
function buildProjectWorkspaceGroups(items: WorkspaceOverviewItem[]): ProjectWorkspaceGroup[] {
|
|
const groups = new Map<string, ProjectWorkspaceGroup>();
|
|
for (const item of items) {
|
|
const existing = groups.get(item.projectId);
|
|
const summary = overviewItemToSummary(item);
|
|
if (existing) {
|
|
existing.summaries.push(summary);
|
|
if (summary.lastUpdatedAt.getTime() > existing.lastUpdatedAt.getTime()) {
|
|
existing.lastUpdatedAt = summary.lastUpdatedAt;
|
|
}
|
|
existing.runningServiceCount += summary.runningServiceCount;
|
|
continue;
|
|
}
|
|
groups.set(item.projectId, {
|
|
projectId: item.projectId,
|
|
projectName: item.projectName,
|
|
projectRef: projectRouteRef({ id: item.projectId, name: item.projectName, urlKey: item.projectUrlKey }),
|
|
summaries: [summary],
|
|
lastUpdatedAt: summary.lastUpdatedAt,
|
|
runningServiceCount: summary.runningServiceCount,
|
|
});
|
|
}
|
|
|
|
return [...groups.values()].sort((a, b) => {
|
|
const runningDiff = b.runningServiceCount - a.runningServiceCount;
|
|
if (runningDiff !== 0) return runningDiff;
|
|
const updatedDiff = b.lastUpdatedAt.getTime() - a.lastUpdatedAt.getTime();
|
|
return updatedDiff !== 0 ? updatedDiff : a.projectName.localeCompare(b.projectName);
|
|
});
|
|
}
|
|
|
|
export function Workspaces() {
|
|
const { selectedCompanyId } = useCompany();
|
|
const { setBreadcrumbs } = useBreadcrumbs();
|
|
const experimentalSettingsQuery = useQuery({
|
|
queryKey: queryKeys.instance.experimentalSettings,
|
|
queryFn: () => instanceSettingsApi.getExperimental(),
|
|
});
|
|
const isolatedWorkspacesEnabled = experimentalSettingsQuery.data?.enableIsolatedWorkspaces === true;
|
|
|
|
const overviewQuery = useInfiniteQuery({
|
|
queryKey: selectedCompanyId
|
|
? queryKeys.executionWorkspaces.overview(selectedCompanyId)
|
|
: ["execution-workspaces", "__workspaces-overview__", "disabled"],
|
|
queryFn: ({ pageParam }) => executionWorkspacesApi.listOverview(selectedCompanyId!, { offset: pageParam as number }),
|
|
initialPageParam: 0,
|
|
getNextPageParam: (lastPage) => lastPage.nextOffset ?? undefined,
|
|
enabled: Boolean(selectedCompanyId && isolatedWorkspacesEnabled),
|
|
});
|
|
|
|
useEffect(() => {
|
|
setBreadcrumbs([{ label: "Workspaces" }]);
|
|
}, [setBreadcrumbs]);
|
|
|
|
const overviewPages = overviewQuery.data?.pages ?? [];
|
|
const overviewItems = useMemo(
|
|
() => overviewPages.flatMap((page) => page.items),
|
|
[overviewPages],
|
|
);
|
|
const groups = useMemo(() => buildProjectWorkspaceGroups(overviewItems), [overviewItems]);
|
|
const firstPage = overviewPages[0] ?? null;
|
|
const totalWorkspaceCount = firstPage?.total ?? overviewItems.length;
|
|
const dataLoading = overviewQuery.isLoading;
|
|
const error = overviewQuery.error as Error | null;
|
|
|
|
if (experimentalSettingsQuery.isLoading) return <PageSkeleton variant="detail" />;
|
|
if (!isolatedWorkspacesEnabled) return <Navigate to="/issues" replace />;
|
|
if (dataLoading) return <PageSkeleton variant="list" />;
|
|
if (error) return <p className="text-sm text-destructive">{error.message}</p>;
|
|
|
|
return (
|
|
<div className="space-y-6">
|
|
<div>
|
|
<h2 className="text-xl font-bold">Workspaces</h2>
|
|
</div>
|
|
|
|
<SummarySlotCard
|
|
companyId={selectedCompanyId}
|
|
scopeKind="workspaces_overview"
|
|
title="Workspace summary"
|
|
description="Summarizer tracks workspace activity, live services, and follow-up needs across projects."
|
|
/>
|
|
|
|
{groups.length === 0 ? (
|
|
<p className="text-sm text-muted-foreground">No workspace activity yet.</p>
|
|
) : (
|
|
<div className="space-y-8">
|
|
{groups.map((group) => (
|
|
<section key={group.projectId} className="space-y-3">
|
|
<div className="flex flex-wrap items-end justify-between gap-2">
|
|
<div className="min-w-0">
|
|
<Link
|
|
to={`/projects/${group.projectRef}/workspaces`}
|
|
className="text-base font-semibold hover:underline"
|
|
>
|
|
{group.projectName}
|
|
</Link>
|
|
</div>
|
|
<span className="text-xs text-muted-foreground">
|
|
{group.summaries.length} workspace{group.summaries.length === 1 ? "" : "s"}
|
|
</span>
|
|
</div>
|
|
<ProjectWorkspacesContent
|
|
companyId={selectedCompanyId!}
|
|
projectId={group.projectId}
|
|
projectRef={group.projectRef}
|
|
summaries={group.summaries}
|
|
/>
|
|
</section>
|
|
))}
|
|
{overviewQuery.hasNextPage ? (
|
|
<div className="flex flex-wrap items-center justify-between gap-3 border-t border-border pt-4">
|
|
<p className="text-sm text-muted-foreground">
|
|
Showing {overviewItems.length} of {totalWorkspaceCount} workspaces.
|
|
</p>
|
|
<Button
|
|
type="button"
|
|
variant="outline"
|
|
size="sm"
|
|
onClick={() => void overviewQuery.fetchNextPage()}
|
|
disabled={overviewQuery.isFetchingNextPage}
|
|
>
|
|
{overviewQuery.isFetchingNextPage ? "Loading..." : "Load more"}
|
|
</Button>
|
|
</div>
|
|
) : null}
|
|
</div>
|
|
)}
|
|
</div>
|
|
);
|
|
}
|