forked from farhoodlabs/paperclip
13551b2bac
## Thinking Path > - Paperclip orchestrates AI agents for zero-human companies. > - Every heartbeat run needs a concrete place where the agent's adapter process executes. > - Today that execution location is implicitly the local machine, which makes it hard to track, audit, and manage as a first-class runtime concern. > - The first step is to represent the current local execution path explicitly without changing how users experience agent runs. > - This pull request adds core Environment and Environment Lease records, then routes existing local heartbeat execution through a default `Local` environment. > - The benefit is that local runs remain behavior-preserving while the system now has durable environment identity, lease lifecycle tracking, and activity records for execution placement. ## What Changed - Added `environments` and `environment_leases` database tables, schema exports, and migration `0065_environments.sql`. - Added shared environment constants, TypeScript types, and validators for environment drivers, statuses, lease policies, lease statuses, and cleanup states. - Added `environmentService` for listing, reading, creating, updating, and ensuring company-scoped environments. - Added environment lease lifecycle operations for acquire, metadata update, single-lease release, and run-wide release. - Updated heartbeat execution to lazily ensure a company-scoped default `Local` environment before adapter execution. - Updated heartbeat execution to acquire an ephemeral local environment lease, write `paperclipEnvironment` into the run context snapshot, and release active leases during run finalization. - Added activity log events for environment lease acquisition and release. - Added tests for environment service behavior and the local heartbeat environment lifecycle. - Added a CI-follow-up heartbeat guard so deferred issue comment wakes are promoted before automatic missing-comment retries, with focused batching test coverage. ## Verification Local verification run for this branch: - `pnpm -r typecheck` - `pnpm build` - `pnpm exec vitest run server/src/__tests__/environment-service.test.ts server/src/__tests__/heartbeat-local-environment.test.ts --pool=forks` Additional reviewer/CI verification: - Confirm `pnpm-lock.yaml` is not modified. - Confirm `pnpm test:run` passes in CI. - Confirm `PAPERCLIP_E2E_SKIP_LLM=true pnpm run test:e2e` passes in CI. - Confirm a local heartbeat run creates one active `Local` environment when needed, records one lease for the run, releases the lease when the run finishes, and includes `paperclipEnvironment` in the run context snapshot. Screenshots: not applicable; this PR has no UI changes. ## Risks - Migration risk: introduces two new tables and a new migration journal entry. Review should verify company scoping, indexes, foreign keys, and enum defaults are correct. - Lifecycle risk: heartbeat finalization now releases environment leases in addition to existing runtime cleanup. A finalization bug could leave stale active leases or mark a failed run's lease incorrectly. - Behavior-preservation risk: local adapter execution should remain unchanged apart from environment bookkeeping. Review should pay attention to the heartbeat path around context snapshot updates and final cleanup ordering. - Activity volume risk: each heartbeat run now logs lease acquisition and release events, increasing activity log volume by two records per run. ## Model Used OpenAI GPT-5.4 via Codex CLI. Capabilities used: repository inspection, TypeScript implementation review, local test/build execution, and PR-description drafting. ## Checklist - [x] I have included a thinking path that traces from project context to this change - [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 (N/A: no UI changes) - [x] I have updated relevant documentation to reflect my changes (N/A: no user-facing docs or commands changed) - [x] I have considered and documented any risks above - [x] I will address all Greptile and reviewer comments before requesting merge
71 lines
3.9 KiB
TypeScript
71 lines
3.9 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 { instanceUserRoles } from "./instance_user_roles.js";
|
|
export { userSidebarPreferences } from "./user_sidebar_preferences.js";
|
|
export { agents } from "./agents.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 { 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 { issueReferenceMentions } from "./issue_reference_mentions.js";
|
|
export { issueRelations } from "./issue_relations.js";
|
|
export { routines, 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 { 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 { heartbeatRuns } from "./heartbeat_runs.js";
|
|
export { heartbeatRunEvents } from "./heartbeat_run_events.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 { companySecrets } from "./company_secrets.js";
|
|
export { companySecretVersions } from "./company_secret_versions.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 { 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";
|