Merge branch 'dev' into local

# Conflicts:
#	packages/db/src/migrations/meta/_journal.json

ui/src/api/access.ts

@@ -384,6 +384,9 @@ export const accessApi = {
   claimBoard: (token: string, code: string) =>
     api.post<{ claimed: true; userId: string }>(`/board-claim/${token}/claim`, { code }),
 
+  claimBootstrapAdmin: () =>
+    api.post<{ claimed: true; userId: string }>("/bootstrap/claim", {}),
+
   getCliAuthChallenge: (id: string, token: string) =>
     api.get<CliAuthChallengeStatus>(`/cli-auth/challenges/${id}?token=${encodeURIComponent(token)}`),
 

ui/src/api/document-annotations.ts

@@ -0,0 +1,59 @@
+import type {
+  CreateDocumentAnnotationCommentRequest,
+  CreateDocumentAnnotationThreadRequest,
+  DocumentAnnotationComment,
+  DocumentAnnotationThread,
+  DocumentAnnotationThreadStatus,
+  DocumentAnnotationThreadWithComments,
+  UpdateDocumentAnnotationThreadRequest,
+} from "@paperclipai/shared";
+import { api } from "./client";
+
+export type DocumentAnnotationListFilter = "open" | "resolved" | "all";
+
+export const documentAnnotationsApi = {
+  list: (
+    issueId: string,
+    key: string,
+    options: { status?: DocumentAnnotationListFilter; includeComments?: boolean } = {},
+  ) => {
+    const params = new URLSearchParams();
+    if (options.status) params.set("status", options.status);
+    if (options.includeComments) params.set("includeComments", "true");
+    const qs = params.toString();
+    return api.get<DocumentAnnotationThreadWithComments[]>(
+      `/issues/${issueId}/documents/${encodeURIComponent(key)}/annotations${qs ? `?${qs}` : ""}`,
+    );
+  },
+  get: (issueId: string, key: string, threadId: string) =>
+    api.get<DocumentAnnotationThreadWithComments>(
+      `/issues/${issueId}/documents/${encodeURIComponent(key)}/annotations/${threadId}`,
+    ),
+  create: (issueId: string, key: string, data: CreateDocumentAnnotationThreadRequest) =>
+    api.post<DocumentAnnotationThreadWithComments>(
+      `/issues/${issueId}/documents/${encodeURIComponent(key)}/annotations`,
+      data,
+    ),
+  addComment: (
+    issueId: string,
+    key: string,
+    threadId: string,
+    data: CreateDocumentAnnotationCommentRequest,
+  ) =>
+    api.post<DocumentAnnotationComment>(
+      `/issues/${issueId}/documents/${encodeURIComponent(key)}/annotations/${threadId}/comments`,
+      data,
+    ),
+  updateStatus: (
+    issueId: string,
+    key: string,
+    threadId: string,
+    status: DocumentAnnotationThreadStatus,
+  ) => {
+    const payload: UpdateDocumentAnnotationThreadRequest = { status };
+    return api.patch<DocumentAnnotationThread>(
+      `/issues/${issueId}/documents/${encodeURIComponent(key)}/annotations/${threadId}`,
+      payload,
+    );
+  },
+};

ui/src/api/issues.ts

@@ -1,4 +1,5 @@
 import type {
+  AcceptedPlanDecompositionSummary,
   AskUserQuestionsAnswer,
   Approval,
   CreateIssueTreeHold,
@@ -201,6 +202,8 @@ export const issuesApi = {
   },
   listInteractions: (id: string) =>
     api.get<IssueThreadInteraction[]>(`/issues/${id}/interactions`),
+  listAcceptedPlanDecompositions: (id: string) =>
+    api.get<AcceptedPlanDecompositionSummary[]>(`/issues/${id}/accepted-plan-decompositions`),
   createInteraction: (id: string, data: Record<string, unknown>) =>
     api.post<IssueThreadInteraction>(`/issues/${id}/interactions`, data),
   acceptInteraction: (

ui/src/api/plugins.ts

@@ -132,13 +132,14 @@ export interface PluginDashboardData {
   checkedAt: string;
 }
 
-export interface AvailablePluginExample {
+export interface AvailableBundledPlugin {
   packageName: string;
   pluginKey: string;
   displayName: string;
   description: string;
   localPath: string;
   tag: "example" | "first-party";
+  experimental: boolean;
 }
 
 export interface PluginLocalFolderProblem {
@@ -215,10 +216,10 @@ export const pluginsApi = {
     api.get<PluginRecord[]>(`/plugins${status ? `?status=${status}` : ""}`),
 
   /**
-   * List bundled example plugins available from the current repo checkout.
+   * List bundled plugin packages available from the current repo checkout.
    */
-  listExamples: () =>
-    api.get<AvailablePluginExample[]>("/plugins/examples"),
+  listBundled: () =>
+    api.get<AvailableBundledPlugin[]>("/plugins/examples"),
 
   /**
    * Fetch a single plugin record by its UUID or plugin key.