mirror of
https://github.com/alkimake/paperclip.git
synced 2026-06-13 17:40:38 +09:00
## Thinking Path > - Paperclip orchestrates AI-agent companies through issues, documents, runs, and durable company-scoped state. > - Issue documents are where agents and operators capture plans, handoffs, and work products. > - Before this change, document collaboration could only happen through whole-document edits and detached issue comments. > - Inline document annotations need stable anchors, revision-aware persistence, and UI affordances that do not break existing document editing. > - This pull request adds company-scoped document annotation threads, comments, anchor snapshots, API routes, and board UI. > - The benefit is that operators and agents can discuss specific document passages without losing context as documents evolve. ## What Changed - Added document annotation tables, schema exports, shared types, validators, anchor hashing, and text-anchor helpers. - Added server-side document annotation services and issue routes for listing, creating, commenting, resolving, and reopening annotation threads. - Included annotation summaries in relevant issue document reads and backup/recovery document workspace behavior. - Added React UI for inline document highlights, comment panels, mobile sheet behavior, deep-link focus, and resolved/open filtering. - Added annotation design artifacts, Storybook coverage, screenshots, and a screenshot helper script. - Rebased the branch onto current `paperclipai/paperclip` `master` and renumbered the annotation migration from `0085_old_swarm` to `0091_old_swarm`; the SQL uses `IF NOT EXISTS` guards so environments that previously applied the old migration number can safely apply the new one. - Adjusted the new annotation UI tests to use a local async flush helper because this workspace's React 19.2.4 export does not expose `React.act`. ## Verification - `pnpm run preflight:workspace-links && pnpm exec vitest run packages/shared/src/document-anchors.test.ts server/src/__tests__/document-annotation-routes.test.ts server/src/__tests__/document-annotations-service.test.ts ui/src/components/DocumentAnnotationLayer.test.tsx ui/src/components/IssueDocumentAnnotations.test.tsx ui/src/lib/document-annotation-hash.test.ts ui/src/lib/document-annotation-selection.test.ts` - Confirmed `git diff --check` passes. - Confirmed no `pnpm-lock.yaml` or `.github/workflows/*` files are included in the PR diff. ## Risks - Medium risk: this adds new persisted annotation tables and routes across db/shared/server/ui. - Migration risk is reduced by moving the branch migration to `0091_old_swarm` after upstream `0090_resource_memberships` and keeping the SQL idempotent for old `0085_old_swarm` adopters. - UI risk is mostly around text range anchoring and panel positioning across long documents, folded content, and mobile layouts; the PR includes focused unit coverage and design screenshots. > 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 coding agent, tool-using software engineering mode. Context window size is not exposed in this Paperclip 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>
84 lines
5 KiB
TypeScript
84 lines
5 KiB
TypeScript
export { companies } from "./companies.js";
|
|
export { companyLogos } from "./company_logos.js";
|
|
export { authUsers, authSessions, authAccounts, authVerifications } from "./auth.js";
|
|
export { instanceSettings } from "./instance_settings.js";
|
|
export { cloudUpstreamConnections, cloudUpstreamRuns } from "./cloud_upstreams.js";
|
|
export { instanceUserRoles } from "./instance_user_roles.js";
|
|
export { userSidebarPreferences } from "./user_sidebar_preferences.js";
|
|
export { agents } from "./agents.js";
|
|
export { agentMemberships } from "./agent_memberships.js";
|
|
export { boardApiKeys } from "./board_api_keys.js";
|
|
export { cliAuthChallenges } from "./cli_auth_challenges.js";
|
|
export { companyMemberships } from "./company_memberships.js";
|
|
export { companyUserSidebarPreferences } from "./company_user_sidebar_preferences.js";
|
|
export { principalPermissionGrants } from "./principal_permission_grants.js";
|
|
export { invites } from "./invites.js";
|
|
export { joinRequests } from "./join_requests.js";
|
|
export { budgetPolicies } from "./budget_policies.js";
|
|
export { budgetIncidents } from "./budget_incidents.js";
|
|
export { agentConfigRevisions } from "./agent_config_revisions.js";
|
|
export { agentApiKeys } from "./agent_api_keys.js";
|
|
export { agentRuntimeState } from "./agent_runtime_state.js";
|
|
export { agentTaskSessions } from "./agent_task_sessions.js";
|
|
export { agentWakeupRequests } from "./agent_wakeup_requests.js";
|
|
export { projects } from "./projects.js";
|
|
export { projectMemberships } from "./project_memberships.js";
|
|
export { projectWorkspaces } from "./project_workspaces.js";
|
|
export { executionWorkspaces } from "./execution_workspaces.js";
|
|
export { environments } from "./environments.js";
|
|
export { environmentLeases } from "./environment_leases.js";
|
|
export { workspaceOperations } from "./workspace_operations.js";
|
|
export { workspaceRuntimeServices } from "./workspace_runtime_services.js";
|
|
export { projectGoals } from "./project_goals.js";
|
|
export { goals } from "./goals.js";
|
|
export { issues } from "./issues.js";
|
|
export { issueRecoveryActions } from "./issue_recovery_actions.js";
|
|
export { issueReferenceMentions } from "./issue_reference_mentions.js";
|
|
export { issueRelations } from "./issue_relations.js";
|
|
export { routines, routineRevisions, routineTriggers, routineRuns } from "./routines.js";
|
|
export { issueWorkProducts } from "./issue_work_products.js";
|
|
export { labels } from "./labels.js";
|
|
export { issueLabels } from "./issue_labels.js";
|
|
export { issueApprovals } from "./issue_approvals.js";
|
|
export { issueComments } from "./issue_comments.js";
|
|
export { issueThreadInteractions } from "./issue_thread_interactions.js";
|
|
export { issueTreeHolds } from "./issue_tree_holds.js";
|
|
export { issueTreeHoldMembers } from "./issue_tree_hold_members.js";
|
|
export { issueExecutionDecisions } from "./issue_execution_decisions.js";
|
|
export { issueInboxArchives } from "./issue_inbox_archives.js";
|
|
export { inboxDismissals } from "./inbox_dismissals.js";
|
|
export { feedbackVotes } from "./feedback_votes.js";
|
|
export { feedbackExports } from "./feedback_exports.js";
|
|
export { issueReadStates } from "./issue_read_states.js";
|
|
export { assets } from "./assets.js";
|
|
export { issueAttachments } from "./issue_attachments.js";
|
|
export { documents } from "./documents.js";
|
|
export { documentRevisions } from "./document_revisions.js";
|
|
export { issueDocuments } from "./issue_documents.js";
|
|
export { documentAnnotationThreads } from "./document_annotation_threads.js";
|
|
export { documentAnnotationComments } from "./document_annotation_comments.js";
|
|
export { documentAnnotationAnchorSnapshots } from "./document_annotation_anchor_snapshots.js";
|
|
export { heartbeatRuns } from "./heartbeat_runs.js";
|
|
export { heartbeatRunEvents } from "./heartbeat_run_events.js";
|
|
export { heartbeatRunWatchdogDecisions } from "./heartbeat_run_watchdog_decisions.js";
|
|
export { costEvents } from "./cost_events.js";
|
|
export { financeEvents } from "./finance_events.js";
|
|
export { approvals } from "./approvals.js";
|
|
export { approvalComments } from "./approval_comments.js";
|
|
export { activityLog } from "./activity_log.js";
|
|
export { companySecretProviderConfigs } from "./company_secret_provider_configs.js";
|
|
export { companySecrets } from "./company_secrets.js";
|
|
export { companySecretVersions } from "./company_secret_versions.js";
|
|
export { companySecretBindings } from "./company_secret_bindings.js";
|
|
export { secretAccessEvents } from "./secret_access_events.js";
|
|
export { companySkills } from "./company_skills.js";
|
|
export { plugins } from "./plugins.js";
|
|
export { pluginConfig } from "./plugin_config.js";
|
|
export { pluginCompanySettings } from "./plugin_company_settings.js";
|
|
export { pluginManagedResources } from "./plugin_managed_resources.js";
|
|
export { pluginState } from "./plugin_state.js";
|
|
export { pluginEntities } from "./plugin_entities.js";
|
|
export { pluginDatabaseNamespaces, pluginMigrations } from "./plugin_database.js";
|
|
export { pluginJobs, pluginJobRuns } from "./plugin_jobs.js";
|
|
export { pluginWebhookDeliveries } from "./plugin_webhooks.js";
|
|
export { pluginLogs } from "./plugin_logs.js";
|