@penclipai/db 2026.704.0 → 2026.714.0

package/dist/table-size-estimates.d.ts

@@ -0,0 +1,372 @@
+export type TableSizeBucket = "large" | "medium" | "small";
+export type LocalTableRowCount = {
+    readonly table: string;
+    readonly localRows: number;
+};
+export type TableSizeEstimate = LocalTableRowCount & {
+    readonly estimateFactor: number;
+    readonly estimatedRows: number;
+    readonly bucket: TableSizeBucket;
+};
+export declare const TABLE_SIZE_ESTIMATE_SOURCE: {
+    readonly collectedAt: "2026-07-06";
+    readonly database: "default local dev embedded Postgres";
+    readonly method: "SELECT count(*) in a read-only transaction";
+};
+export declare const TABLE_SIZE_ESTIMATE_FACTOR = 250;
+export declare const TABLE_SIZE_BUCKET_THRESHOLDS: {
+    readonly largeRows: 1000000;
+    readonly mediumRows: 100000;
+};
+export declare const LOCAL_TABLE_ROW_COUNTS: readonly [{
+    readonly table: "agent_wakeup_requests";
+    readonly localRows: 52791;
+}, {
+    readonly table: "activity_log";
+    readonly localRows: 22930;
+}, {
+    readonly table: "issue_reference_mentions";
+    readonly localRows: 13218;
+}, {
+    readonly table: "heartbeat_run_events";
+    readonly localRows: 10833;
+}, {
+    readonly table: "issue_comments";
+    readonly localRows: 5034;
+}, {
+    readonly table: "document_revisions";
+    readonly localRows: 3906;
+}, {
+    readonly table: "heartbeat_runs";
+    readonly localRows: 3620;
+}, {
+    readonly table: "workspace_operations";
+    readonly localRows: 3600;
+}, {
+    readonly table: "environment_leases";
+    readonly localRows: 3492;
+}, {
+    readonly table: "cost_events";
+    readonly localRows: 3330;
+}, {
+    readonly table: "agent_task_sessions";
+    readonly localRows: 1743;
+}, {
+    readonly table: "documents";
+    readonly localRows: 1692;
+}, {
+    readonly table: "issue_documents";
+    readonly localRows: 1678;
+}, {
+    readonly table: "issues";
+    readonly localRows: 1609;
+}, {
+    readonly table: "secret_access_events";
+    readonly localRows: 933;
+}, {
+    readonly table: "issue_read_states";
+    readonly localRows: 608;
+}, {
+    readonly table: "issue_thread_interactions";
+    readonly localRows: 455;
+}, {
+    readonly table: "issue_relations";
+    readonly localRows: 445;
+}, {
+    readonly table: "execution_workspaces";
+    readonly localRows: 414;
+}, {
+    readonly table: "agent_config_revisions";
+    readonly localRows: 145;
+}, {
+    readonly table: "document_annotation_anchor_snapshots";
+    readonly localRows: 132;
+}, {
+    readonly table: "document_annotation_comments";
+    readonly localRows: 122;
+}, {
+    readonly table: "document_annotation_threads";
+    readonly localRows: 80;
+}, {
+    readonly table: "routine_revisions";
+    readonly localRows: 64;
+}, {
+    readonly table: "issue_tree_hold_members";
+    readonly localRows: 62;
+}, {
+    readonly table: "routine_runs";
+    readonly localRows: 52;
+}, {
+    readonly table: "issue_recovery_actions";
+    readonly localRows: 50;
+}, {
+    readonly table: "assets";
+    readonly localRows: 46;
+}, {
+    readonly table: "issue_attachments";
+    readonly localRows: 44;
+}, {
+    readonly table: "principal_permission_grants";
+    readonly localRows: 25;
+}, {
+    readonly table: "company_memberships";
+    readonly localRows: 19;
+}, {
+    readonly table: "agent_runtime_state";
+    readonly localRows: 18;
+}, {
+    readonly table: "agents";
+    readonly localRows: 18;
+}, {
+    readonly table: "routine_triggers";
+    readonly localRows: 16;
+}, {
+    readonly table: "company_skills";
+    readonly localRows: 15;
+}, {
+    readonly table: "routine_documents";
+    readonly localRows: 14;
+}, {
+    readonly table: "routines";
+    readonly localRows: 14;
+}, {
+    readonly table: "issue_inbox_archives";
+    readonly localRows: 13;
+}, {
+    readonly table: "issue_approvals";
+    readonly localRows: 12;
+}, {
+    readonly table: "company_secret_bindings";
+    readonly localRows: 11;
+}, {
+    readonly table: "issue_tree_holds";
+    readonly localRows: 10;
+}, {
+    readonly table: "approvals";
+    readonly localRows: 9;
+}, {
+    readonly table: "session";
+    readonly localRows: 9;
+}, {
+    readonly table: "issue_work_products";
+    readonly localRows: 7;
+}, {
+    readonly table: "company_skill_versions";
+    readonly localRows: 6;
+}, {
+    readonly table: "feedback_exports";
+    readonly localRows: 6;
+}, {
+    readonly table: "feedback_votes";
+    readonly localRows: 6;
+}, {
+    readonly table: "issue_execution_decisions";
+    readonly localRows: 6;
+}, {
+    readonly table: "company_secret_versions";
+    readonly localRows: 3;
+}, {
+    readonly table: "company_secrets";
+    readonly localRows: 3;
+}, {
+    readonly table: "projects";
+    readonly localRows: 3;
+}, {
+    readonly table: "approval_comments";
+    readonly localRows: 2;
+}, {
+    readonly table: "goals";
+    readonly localRows: 2;
+}, {
+    readonly table: "project_goals";
+    readonly localRows: 2;
+}, {
+    readonly table: "project_workspaces";
+    readonly localRows: 2;
+}, {
+    readonly table: "account";
+    readonly localRows: 1;
+}, {
+    readonly table: "companies";
+    readonly localRows: 1;
+}, {
+    readonly table: "environments";
+    readonly localRows: 1;
+}, {
+    readonly table: "instance_settings";
+    readonly localRows: 1;
+}, {
+    readonly table: "instance_user_roles";
+    readonly localRows: 1;
+}, {
+    readonly table: "user";
+    readonly localRows: 1;
+}, {
+    readonly table: "agent_api_keys";
+    readonly localRows: 0;
+}, {
+    readonly table: "agent_memberships";
+    readonly localRows: 0;
+}, {
+    readonly table: "board_api_keys";
+    readonly localRows: 0;
+}, {
+    readonly table: "budget_incidents";
+    readonly localRows: 0;
+}, {
+    readonly table: "budget_policies";
+    readonly localRows: 0;
+}, {
+    readonly table: "cli_auth_challenges";
+    readonly localRows: 0;
+}, {
+    readonly table: "cloud_upstream_connections";
+    readonly localRows: 0;
+}, {
+    readonly table: "cloud_upstream_runs";
+    readonly localRows: 0;
+}, {
+    readonly table: "company_logos";
+    readonly localRows: 0;
+}, {
+    readonly table: "company_secret_provider_configs";
+    readonly localRows: 0;
+}, {
+    readonly table: "company_skill_comments";
+    readonly localRows: 0;
+}, {
+    readonly table: "company_skill_stars";
+    readonly localRows: 0;
+}, {
+    readonly table: "company_user_sidebar_preferences";
+    readonly localRows: 0;
+}, {
+    readonly table: "environment_custom_image_setup_sessions";
+    readonly localRows: 0;
+}, {
+    readonly table: "environment_custom_image_templates";
+    readonly localRows: 0;
+}, {
+    readonly table: "external_object_mentions";
+    readonly localRows: 0;
+}, {
+    readonly table: "external_objects";
+    readonly localRows: 0;
+}, {
+    readonly table: "finance_events";
+    readonly localRows: 0;
+}, {
+    readonly table: "heartbeat_run_watchdog_decisions";
+    readonly localRows: 0;
+}, {
+    readonly table: "inbox_dismissals";
+    readonly localRows: 0;
+}, {
+    readonly table: "invites";
+    readonly localRows: 0;
+}, {
+    readonly table: "issue_labels";
+    readonly localRows: 0;
+}, {
+    readonly table: "issue_plan_decompositions";
+    readonly localRows: 0;
+}, {
+    readonly table: "issue_watchdogs";
+    readonly localRows: 0;
+}, {
+    readonly table: "join_requests";
+    readonly localRows: 0;
+}, {
+    readonly table: "labels";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_automation_executions";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_case_blockers";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_case_documents";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_case_events";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_case_issue_links";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_cases";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_documents";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_stages";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipeline_transitions";
+    readonly localRows: 0;
+}, {
+    readonly table: "pipelines";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_company_settings";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_config";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_database_namespaces";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_entities";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_job_runs";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_jobs";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_logs";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_managed_resources";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_migrations";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_state";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugin_webhook_deliveries";
+    readonly localRows: 0;
+}, {
+    readonly table: "plugins";
+    readonly localRows: 0;
+}, {
+    readonly table: "project_memberships";
+    readonly localRows: 0;
+}, {
+    readonly table: "user_secret_declarations";
+    readonly localRows: 0;
+}, {
+    readonly table: "user_secret_definitions";
+    readonly localRows: 0;
+}, {
+    readonly table: "user_sidebar_preferences";
+    readonly localRows: 0;
+}, {
+    readonly table: "verification";
+    readonly localRows: 0;
+}, {
+    readonly table: "workspace_runtime_services";
+    readonly localRows: 0;
+}];
+export declare const TABLE_SIZE_ESTIMATES: readonly TableSizeEstimate[];
+export declare const TABLE_SIZE_ESTIMATES_BY_TABLE: ReadonlyMap<string, TableSizeEstimate>;
+export declare function getTableSizeEstimate(table: string): TableSizeEstimate | undefined;
+export declare function getTableSizeBucket(table: string): TableSizeBucket;
+export declare function isKnownLargeTable(table: string): boolean;
+//# sourceMappingURL=table-size-estimates.d.ts.map

package/dist/table-size-estimates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-size-estimates.d.ts","sourceRoot":"","sources":["../src/table-size-estimates.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,kBAAkB,GAAG;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,0BAA0B;;;;CAI7B,CAAC;AAEX,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC;AAEX,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoHe,CAAC;AAQnD,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAW5D,CAAC;AAEF,eAAO,MAAM,6BAA6B,EAAE,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAEhF,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAEjF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/table-size-estimates.js

@@ -0,0 +1,155 @@
+export const TABLE_SIZE_ESTIMATE_SOURCE = {
+    collectedAt: "2026-07-06",
+    database: "default local dev embedded Postgres",
+    method: "SELECT count(*) in a read-only transaction",
+};
+export const TABLE_SIZE_ESTIMATE_FACTOR = 250;
+export const TABLE_SIZE_BUCKET_THRESHOLDS = {
+    largeRows: 1_000_000,
+    mediumRows: 100_000,
+};
+export const LOCAL_TABLE_ROW_COUNTS = [
+    { table: "agent_wakeup_requests", localRows: 52_791 },
+    { table: "activity_log", localRows: 22_930 },
+    { table: "issue_reference_mentions", localRows: 13_218 },
+    { table: "heartbeat_run_events", localRows: 10_833 },
+    { table: "issue_comments", localRows: 5_034 },
+    { table: "document_revisions", localRows: 3_906 },
+    { table: "heartbeat_runs", localRows: 3_620 },
+    { table: "workspace_operations", localRows: 3_600 },
+    { table: "environment_leases", localRows: 3_492 },
+    { table: "cost_events", localRows: 3_330 },
+    { table: "agent_task_sessions", localRows: 1_743 },
+    { table: "documents", localRows: 1_692 },
+    { table: "issue_documents", localRows: 1_678 },
+    { table: "issues", localRows: 1_609 },
+    { table: "secret_access_events", localRows: 933 },
+    { table: "issue_read_states", localRows: 608 },
+    { table: "issue_thread_interactions", localRows: 455 },
+    { table: "issue_relations", localRows: 445 },
+    { table: "execution_workspaces", localRows: 414 },
+    { table: "agent_config_revisions", localRows: 145 },
+    { table: "document_annotation_anchor_snapshots", localRows: 132 },
+    { table: "document_annotation_comments", localRows: 122 },
+    { table: "document_annotation_threads", localRows: 80 },
+    { table: "routine_revisions", localRows: 64 },
+    { table: "issue_tree_hold_members", localRows: 62 },
+    { table: "routine_runs", localRows: 52 },
+    { table: "issue_recovery_actions", localRows: 50 },
+    { table: "assets", localRows: 46 },
+    { table: "issue_attachments", localRows: 44 },
+    { table: "principal_permission_grants", localRows: 25 },
+    { table: "company_memberships", localRows: 19 },
+    { table: "agent_runtime_state", localRows: 18 },
+    { table: "agents", localRows: 18 },
+    { table: "routine_triggers", localRows: 16 },
+    { table: "company_skills", localRows: 15 },
+    { table: "routine_documents", localRows: 14 },
+    { table: "routines", localRows: 14 },
+    { table: "issue_inbox_archives", localRows: 13 },
+    { table: "issue_approvals", localRows: 12 },
+    { table: "company_secret_bindings", localRows: 11 },
+    { table: "issue_tree_holds", localRows: 10 },
+    { table: "approvals", localRows: 9 },
+    { table: "session", localRows: 9 },
+    { table: "issue_work_products", localRows: 7 },
+    { table: "company_skill_versions", localRows: 6 },
+    { table: "feedback_exports", localRows: 6 },
+    { table: "feedback_votes", localRows: 6 },
+    { table: "issue_execution_decisions", localRows: 6 },
+    { table: "company_secret_versions", localRows: 3 },
+    { table: "company_secrets", localRows: 3 },
+    { table: "projects", localRows: 3 },
+    { table: "approval_comments", localRows: 2 },
+    { table: "goals", localRows: 2 },
+    { table: "project_goals", localRows: 2 },
+    { table: "project_workspaces", localRows: 2 },
+    { table: "account", localRows: 1 },
+    { table: "companies", localRows: 1 },
+    { table: "environments", localRows: 1 },
+    { table: "instance_settings", localRows: 1 },
+    { table: "instance_user_roles", localRows: 1 },
+    { table: "user", localRows: 1 },
+    { table: "agent_api_keys", localRows: 0 },
+    { table: "agent_memberships", localRows: 0 },
+    { table: "board_api_keys", localRows: 0 },
+    { table: "budget_incidents", localRows: 0 },
+    { table: "budget_policies", localRows: 0 },
+    { table: "cli_auth_challenges", localRows: 0 },
+    { table: "cloud_upstream_connections", localRows: 0 },
+    { table: "cloud_upstream_runs", localRows: 0 },
+    { table: "company_logos", localRows: 0 },
+    { table: "company_secret_provider_configs", localRows: 0 },
+    { table: "company_skill_comments", localRows: 0 },
+    { table: "company_skill_stars", localRows: 0 },
+    { table: "company_user_sidebar_preferences", localRows: 0 },
+    { table: "environment_custom_image_setup_sessions", localRows: 0 },
+    { table: "environment_custom_image_templates", localRows: 0 },
+    { table: "external_object_mentions", localRows: 0 },
+    { table: "external_objects", localRows: 0 },
+    { table: "finance_events", localRows: 0 },
+    { table: "heartbeat_run_watchdog_decisions", localRows: 0 },
+    { table: "inbox_dismissals", localRows: 0 },
+    { table: "invites", localRows: 0 },
+    { table: "issue_labels", localRows: 0 },
+    { table: "issue_plan_decompositions", localRows: 0 },
+    { table: "issue_watchdogs", localRows: 0 },
+    { table: "join_requests", localRows: 0 },
+    { table: "labels", localRows: 0 },
+    { table: "pipeline_automation_executions", localRows: 0 },
+    { table: "pipeline_case_blockers", localRows: 0 },
+    { table: "pipeline_case_documents", localRows: 0 },
+    { table: "pipeline_case_events", localRows: 0 },
+    { table: "pipeline_case_issue_links", localRows: 0 },
+    { table: "pipeline_cases", localRows: 0 },
+    { table: "pipeline_documents", localRows: 0 },
+    { table: "pipeline_stages", localRows: 0 },
+    { table: "pipeline_transitions", localRows: 0 },
+    { table: "pipelines", localRows: 0 },
+    { table: "plugin_company_settings", localRows: 0 },
+    { table: "plugin_config", localRows: 0 },
+    { table: "plugin_database_namespaces", localRows: 0 },
+    { table: "plugin_entities", localRows: 0 },
+    { table: "plugin_job_runs", localRows: 0 },
+    { table: "plugin_jobs", localRows: 0 },
+    { table: "plugin_logs", localRows: 0 },
+    { table: "plugin_managed_resources", localRows: 0 },
+    { table: "plugin_migrations", localRows: 0 },
+    { table: "plugin_state", localRows: 0 },
+    { table: "plugin_webhook_deliveries", localRows: 0 },
+    { table: "plugins", localRows: 0 },
+    { table: "project_memberships", localRows: 0 },
+    { table: "user_secret_declarations", localRows: 0 },
+    { table: "user_secret_definitions", localRows: 0 },
+    { table: "user_sidebar_preferences", localRows: 0 },
+    { table: "verification", localRows: 0 },
+    { table: "workspace_runtime_services", localRows: 0 },
+];
+function bucketForEstimatedRows(estimatedRows) {
+    if (estimatedRows >= TABLE_SIZE_BUCKET_THRESHOLDS.largeRows)
+        return "large";
+    if (estimatedRows >= TABLE_SIZE_BUCKET_THRESHOLDS.mediumRows)
+        return "medium";
+    return "small";
+}
+export const TABLE_SIZE_ESTIMATES = LOCAL_TABLE_ROW_COUNTS.map(({ table, localRows }) => {
+    const estimatedRows = localRows * TABLE_SIZE_ESTIMATE_FACTOR;
+    return {
+        table,
+        localRows,
+        estimateFactor: TABLE_SIZE_ESTIMATE_FACTOR,
+        estimatedRows,
+        bucket: bucketForEstimatedRows(estimatedRows),
+    };
+});
+export const TABLE_SIZE_ESTIMATES_BY_TABLE = new Map(TABLE_SIZE_ESTIMATES.map((estimate) => [estimate.table, estimate]));
+export function getTableSizeEstimate(table) {
+    return TABLE_SIZE_ESTIMATES_BY_TABLE.get(table);
+}
+export function getTableSizeBucket(table) {
+    return getTableSizeEstimate(table)?.bucket ?? "small";
+}
+export function isKnownLargeTable(table) {
+    return getTableSizeBucket(table) === "large";
+}
+//# sourceMappingURL=table-size-estimates.js.map

package/dist/table-size-estimates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-size-estimates.js","sourceRoot":"","sources":["../src/table-size-estimates.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@penclipai/db",
-  "version": "2026.704.0",
+  "version": "2026.714.0",
   "license": "MIT",
   "homepage": "https://github.com/penclipai/paperclip-cn",
   "bugs": {
@@ -29,7 +29,7 @@
     "dist"
   ],
   "dependencies": {
-    "@penclipai/shared": "2026.704.0",
+    "@penclipai/shared": "2026.714.0",
     "drizzle-orm": "^0.45.2",
     "embedded-postgres": "^18.3.0-beta.17",
     "postgres": "^3.4.9"
@@ -42,7 +42,7 @@
     "vitest": "^4.1.8"
   },
   "scripts": {
-    "check:migrations": "tsx src/check-migration-numbering.ts",
+    "check:migrations": "tsx src/check-migration-numbering.ts && tsx src/check-migration-safety.ts",
     "build": "pnpm run check:migrations && tsc && node ../../scripts/fs-ops.mjs cp src/migrations dist/migrations",
     "clean": "node ../../scripts/fs-ops.mjs rm dist",
     "typecheck": "pnpm run check:migrations && tsc --noEmit",

package/dist/migrations/0126_issue_comment_derived_attribution.sql

@@ -1,69 +0,0 @@
-ALTER TABLE "issue_comments" ADD COLUMN IF NOT EXISTS "derived_author_agent_id" uuid;--> statement-breakpoint
-ALTER TABLE "issue_comments" ADD COLUMN IF NOT EXISTS "derived_created_by_run_id" uuid;--> statement-breakpoint
-ALTER TABLE "issue_comments" ADD COLUMN IF NOT EXISTS "derived_author_source" text;--> statement-breakpoint
-DO $$ BEGIN
-	IF NOT EXISTS (
-		SELECT 1 FROM "pg_constraint" WHERE "conname" = 'issue_comments_derived_author_agent_id_agents_id_fk'
-	) THEN
-		ALTER TABLE "issue_comments" ADD CONSTRAINT "issue_comments_derived_author_agent_id_agents_id_fk" FOREIGN KEY ("derived_author_agent_id") REFERENCES "public"."agents"("id") ON DELETE set null ON UPDATE no action;
-	END IF;
-END $$;--> statement-breakpoint
-DO $$ BEGIN
-	IF NOT EXISTS (
-		SELECT 1 FROM "pg_constraint" WHERE "conname" = 'issue_comments_derived_created_by_run_id_heartbeat_runs_id_fk'
-	) THEN
-		ALTER TABLE "issue_comments" ADD CONSTRAINT "issue_comments_derived_created_by_run_id_heartbeat_runs_id_fk" FOREIGN KEY ("derived_created_by_run_id") REFERENCES "public"."heartbeat_runs"("id") ON DELETE set null ON UPDATE no action;
-	END IF;
-END $$;--> statement-breakpoint
--- Backfill agent attribution for historical non-human ("Board") comments so old
--- threads stop rendering as blue board bubbles and the read path stops
--- re-scanning run logs. Two SQL-computable tiers, both guarded to NEVER touch a
--- comment whose author maps to a genuine user profile. The log-marker tier is
--- handled lazily on read (it needs object-storage log bodies).
---
--- Tier `run_id`: the comment's own authoring run resolves to an agent (lossless).
--- Batched to keep lock/WAL footprint bounded on large histories.
-DO $$
-DECLARE
-	affected integer;
-BEGIN
-	LOOP
-		WITH batch AS (
-			SELECT c.id AS comment_id, hr.agent_id, hr.id AS run_id
-			FROM issue_comments c
-			JOIN heartbeat_runs hr ON hr.id = c.created_by_run_id
-			WHERE c.author_agent_id IS NULL
-				AND c.derived_author_agent_id IS NULL
-				AND c.author_user_id IS NOT NULL
-				-- Only the non-human board sentinel or non-`user` authors are
-				-- eligible. `local-board` IS a row in "user" (the implicit board
-				-- admin), so it must be allowed explicitly; genuine signups are not.
-				AND (c.author_user_id = 'local-board'
-					OR NOT EXISTS (SELECT 1 FROM "user" u WHERE u.id = c.author_user_id))
-			LIMIT 5000
-		)
-		UPDATE issue_comments c
-		SET derived_author_agent_id = b.agent_id,
-			derived_created_by_run_id = b.run_id,
-			derived_author_source = 'run_id'
-		FROM batch b
-		WHERE c.id = b.comment_id;
-		GET DIAGNOSTICS affected = ROW_COUNT;
-		EXIT WHEN affected = 0;
-	END LOOP;
-END $$;--> statement-breakpoint
--- Option A: the pure run-window TIMING tiers are intentionally NOT applied.
--- Because agents post through the `local-board` subprocess, an agent comment and
--- a genuine human board comment are indistinguishable rows, so any timing-overlap
--- guess mis-attributes human board comments that merely coincided with an agent
--- run (e.g. a human board reply typed while an agent run was in flight).
--- Only the lossless `run_id` backfill above (and the read-path `run_log_comment_post`
--- tier) attribute history; everything else stays "Board".
---
--- This statement also reverts any attribution a PRIOR revision of this migration
--- persisted via the timing tiers, so re-applying / upgrading is idempotent.
-UPDATE issue_comments
-SET derived_author_agent_id = NULL,
-	derived_created_by_run_id = NULL,
-	derived_author_source = NULL
-WHERE derived_author_source IN ('run_window_unique', 'run_window_agent_unique');