d9f91576a0
## Thinking Path > - Paperclip orchestrates AI agents for zero-human companies, so planning approvals and child-issue fan-out are part of the core control-plane loop. > - Accepted plans are supposed to be a safe bridge from planning into execution, especially when agents wake from review decisions and reuse isolated workspaces. > - The duplicate-subtask incident showed that an accepted plan revision could be interpreted more than once across overlapping runs, which broke the single-source-of-truth model for issue decomposition. > - Fixing that required tightening the backend contract first: accepted-plan decomposition needs an exact-once fingerprint, durable claim state, and retry-safe child creation. > - Once that backend behavior existed, the board still needed visibility into what happened, so the issue detail view needed a dedicated decomposition section instead of forcing operators to reconstruct child creation from raw activity. > - This pull request adds the exact-once decomposition primitive, hardens wake routing and regressions around the incident, and surfaces decomposition state in the UI so future incidents are both prevented and easier to inspect. ## What Changed - Added accepted-plan decomposition semantics to `doc/execution-semantics.md`, including the exact-once fingerprint, durable claim/result expectations, and retry/resume behavior. - Added persistent accepted-plan decomposition claims in the backend, including schema, shared types/validators, service logic, and issue routes for creating and listing decomposition state. - Hardened heartbeat routing so an accepted-plan continuation stays scoped to the relevant planning issue instead of opportunistically re-decomposing another accepted issue on the same assignee. - Added regression coverage for the original failure modes: concurrent same-parent retries, cross-issue accepted-plan isolation, and partial child recreation under the same fingerprint. - Added the `Plan decomposition` issue-detail section plus supporting API/query-key/activity formatting updates so operators can see revision status, owner, child counts, and the linked child issues directly in the UI. - Included the small follow-up UI fix so the decomposition section still renders when the issue work mode is no longer `planning`. ## Verification - `pnpm --filter @paperclipai/server typecheck` - `pnpm --filter @paperclipai/ui typecheck` - `pnpm --filter @paperclipai/db typecheck` - `pnpm exec vitest run server/src/__tests__/issues-service.test.ts` - `pnpm exec vitest run server/src/__tests__/issues-service.test.ts -t "lists persisted decompositions with child issue summaries"` - `pnpm exec vitest run server/src/__tests__/issues-service.test.ts -t "accepted plan decomposition" server/src/__tests__/heartbeat-accepted-plan-workspace-refresh.test.ts server/src/__tests__/heartbeat-context-summary.test.ts` - Manual UI path: create a planning issue without an isolated execution workspace, add a `plan` document, accept the `request_confirmation`, let Paperclip create child issues, then reopen the parent issue detail page and confirm the `Plan decomposition` section shows the accepted revision, status, idempotent-claim badge, and child links. - Separate follow-up bug noted during manual UI validation: accepting a plan on an issue whose run never records `workspace_finalize` is tracked in `PAPA-445` and is not part of this PR’s fix scope. ## Risks - This adds a new migration and a large Drizzle snapshot update; reviewers should confirm the schema shape and generated metadata match the intended decomposition table. - The exact-once claim changes sit on the accepted-plan fan-out path, so regressions there could block legitimate child creation or mis-handle retries if the claim state machine is wrong. - The new UI only appears when decomposition records exist; reviewers should use the manual verification path above rather than expecting existing issues on a stale local instance to show the section automatically. - `PAPA-445` remains an open follow-up for the `workspace_finalize` accept gate when a planning handoff never records finalize; that bug can interfere with reproducing the UI flow on isolated workspaces but does not change the correctness of the exact-once decomposition feature itself. > Checked `ROADMAP.md`: this PR is a bug fix / control-plane hardening change for accepted-plan decomposition, not a new uncoordinated roadmap feature. ## Model Used - OpenAI Codex via Paperclip `codex_local` (GPT-5-based coding agent; exact backend model ID/context window not exposed in the run context), with repository tool use, shell execution, and code-editing capabilities. <img width="806" height="1069" alt="Screenshot 2026-05-27 at 11 05 48 PM" src="https://github.com/user-attachments/assets/5b00b670-96cd-4470-b0a3-581743bcae28" /> ## 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>
86 lines
5.0 KiB
TypeScript
86 lines
5.0 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 { issuePlanDecompositions } from "./issue_plan_decompositions.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";
|