@tickernelz/wardmote-db 0.0.0 → 2026.1108.1

package/dist/connections-v3-schema-core-migration.test.js

@@ -0,0 +1,114 @@
+import { createHash, randomUUID } from "node:crypto";
+import fs from "node:fs";
+import { afterEach, describe, expect, it } from "vitest";
+import postgres from "postgres";
+import { applyPendingMigrations } from "./client.js";
+import { getEmbeddedPostgresTestSupport, startEmbeddedPostgresTestDatabase } from "./test-embedded-postgres.js";
+const MIGRATION_FILE = "0182_connections_v3_schema_core.sql";
+const cleanups = [];
+const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
+const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
+async function migrationHash() {
+    const content = await fs.promises.readFile(new URL(`./migrations/${MIGRATION_FILE}`, import.meta.url), "utf8");
+    return createHash("sha256").update(content).digest("hex");
+}
+describeEmbeddedPostgres("connections v3 schema core migration", () => {
+    afterEach(async () => Promise.all(cleanups.splice(0).map((cleanup) => cleanup())));
+    it("backfills a workspace grant and rolls back without losing the connection", async () => {
+        const database = await startEmbeddedPostgresTestDatabase("paperclip-connections-v3-migration-");
+        cleanups.push(database.cleanup);
+        const sql = postgres(database.connectionString, { max: 1 });
+        cleanups.push(async () => sql.end());
+        // The fixture starts at the latest schema. Rewind the later chat FK before
+        // exercising migration 0182's composite connection key; never CASCADE away
+        // unknown dependencies or change the production constraint for this test.
+        const [chatForeignKey] = await sql `
+      SELECT pg_get_constraintdef(oid) AS definition FROM pg_constraint
+      WHERE conrelid = 'chat_endpoints'::regclass
+        AND conname = 'chat_endpoints_company_connection_fk'
+    `;
+        expect(chatForeignKey?.definition).toBeTruthy();
+        await sql `ALTER TABLE "chat_endpoints" DROP CONSTRAINT "chat_endpoints_company_connection_fk"`;
+        await sql `DELETE FROM "drizzle"."__drizzle_migrations" WHERE "hash" = ${await migrationHash()}`;
+        // AI defaults arrive in 0273/0277 and depend on the composite grant key
+        // from 0232. Rewind those tables before recreating the 0182 grant schema.
+        // Router pins/cursors depend on pools, whose composite connection FK also
+        // arrives after 0182. Rewind these empty fixture tables in dependency order.
+        await sql `DROP TABLE IF EXISTS "ai_connection_task_pins"`;
+        await sql `DROP TABLE IF EXISTS "ai_connection_router_cursors"`;
+        await sql `DROP TABLE IF EXISTS "ai_connection_pools"`;
+        await sql `DROP TABLE IF EXISTS "ai_provider_defaults"`;
+        await sql `DROP TABLE IF EXISTS "ai_connection_defaults"`;
+        await sql `DROP TABLE IF EXISTS "connection_grant_delegations"`;
+        await sql `DROP TABLE IF EXISTS "connection_grant_members"`;
+        // Browser Use is a later grant consumer; rewind its empty fixture tables too.
+        await sql `DROP TABLE IF EXISTS "browser_use_browsers"`;
+        await sql `DROP TABLE IF EXISTS "browser_use_runs"`;
+        await sql `DROP TABLE IF EXISTS "browser_use_sessions"`;
+        await sql `DROP TABLE IF EXISTS "browser_use_settings"`;
+        // Managed-account observations are later consumers of the same connection key.
+        await sql `DROP TABLE IF EXISTS "tool_connection_app_syncs"`;
+        await sql `DROP TABLE IF EXISTS "tool_connection_app_snapshots"`;
+        // Subscription reporting adds a later grant binding; rewind the empty
+        // fixture table before recreating grants, preserving production FK checks.
+        await sql `DROP TABLE IF EXISTS "ai_subscription_connections"`;
+        await sql `DROP TABLE IF EXISTS "connection_grants"`;
+        await sql `DROP INDEX IF EXISTS "tool_connections_company_uid_uq"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT IF EXISTS "tool_connections_company_id_uq"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT IF EXISTS "tool_connections_ownership_check"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT IF EXISTS "tool_connections_transport_check"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT IF EXISTS "tool_connections_auth_kind_check"`;
+        await sql `ALTER TABLE "tool_connections" DROP COLUMN IF EXISTS "uid"`;
+        await sql `ALTER TABLE "tool_connections" DROP COLUMN IF EXISTS "ownership"`;
+        await sql `ALTER TABLE "tool_connections" DROP COLUMN IF EXISTS "auth_kind"`;
+        const companyId = randomUUID();
+        const applicationId = randomUUID();
+        const connectionId = randomUUID();
+        const secretId = randomUUID();
+        await sql `INSERT INTO "companies" ("id", "name", "issue_prefix") VALUES (${companyId}, 'Paperclip', 'PAP')`;
+        await sql `INSERT INTO "tool_applications" ("id", "company_id", "application_key", "name", "type") VALUES (${applicationId}, ${companyId}, 'linear', 'Linear', 'mcp_http')`;
+        await sql `
+      INSERT INTO "tool_connections" ("id", "company_id", "application_id", "name", "connection_kind", "transport", "config", "credential_secret_refs")
+      VALUES (${connectionId}, ${companyId}, ${applicationId}, 'Production', 'managed', 'remote_http', '{"oauth":{"provider":"linear"}}'::jsonb, ${sql.json([{ secretId, configPath: "oauth.refresh_token" }])})
+    `;
+        await applyPendingMigrations(database.connectionString);
+        await sql.unsafe(`ALTER TABLE "chat_endpoints" ADD CONSTRAINT "chat_endpoints_company_connection_fk" ${chatForeignKey.definition}`);
+        const [connection] = await sql `
+      SELECT "uid", "ownership", "transport", "auth_kind" FROM "tool_connections" WHERE "id" = ${connectionId}
+    `;
+        expect(connection).toMatchObject({ ownership: "customer", transport: "mcp_remote", auth_kind: "oauth" });
+        expect(connection?.uid).toMatch(/^linear\/production-[0-9a-f]{8}$/);
+        const [grant] = await sql `
+      SELECT "kind", "is_default", "credential_secret_refs" FROM "connection_grants" WHERE "connection_id" = ${connectionId}
+    `;
+        expect(grant).toMatchObject({ kind: "workspace", is_default: true });
+        expect(grant?.credential_secret_refs).toEqual([{ secretId, configPath: "oauth.refresh_token" }]);
+        const otherCompanyId = randomUUID();
+        await sql `INSERT INTO "companies" ("id", "name", "issue_prefix") VALUES (${otherCompanyId}, 'Other', 'OTH')`;
+        await expect(sql `
+      INSERT INTO "connection_grants" ("company_id", "connection_id", "kind")
+      VALUES (${otherCompanyId}, ${connectionId}, 'workspace')
+    `).rejects.toMatchObject({ code: "23503" });
+        await expect(sql `
+      INSERT INTO "connection_grants" ("company_id", "connection_id", "kind", "subject_user_id", "is_default")
+      VALUES (${companyId}, ${connectionId}, 'user', 'user-1', true)
+    `).rejects.toMatchObject({ code: "23514" });
+        await sql `ALTER TABLE "chat_endpoints" DROP CONSTRAINT "chat_endpoints_company_connection_fk"`;
+        await sql `DROP TABLE IF EXISTS "connection_grant_members"`;
+        await sql `DROP TABLE "connection_grants"`;
+        await sql `DROP INDEX "tool_connections_company_uid_uq"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT "tool_connections_company_id_uq"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT "tool_connections_ownership_check"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT "tool_connections_transport_check"`;
+        await sql `ALTER TABLE "tool_connections" DROP CONSTRAINT "tool_connections_auth_kind_check"`;
+        await sql `UPDATE "tool_connections" SET "transport" = 'remote_http' WHERE "transport" = 'mcp_remote'`;
+        await sql `ALTER TABLE "tool_connections" DROP COLUMN "uid"`;
+        await sql `ALTER TABLE "tool_connections" DROP COLUMN "ownership"`;
+        await sql `ALTER TABLE "tool_connections" DROP COLUMN "auth_kind"`;
+        const [rolledBack] = await sql `
+      SELECT "id", "transport" FROM "tool_connections" WHERE "id" = ${connectionId}
+    `;
+        expect(rolledBack).toEqual({ id: connectionId, transport: "remote_http" });
+    }, 30_000);
+});
+//# sourceMappingURL=connections-v3-schema-core-migration.test.js.map

package/dist/connections-v3-schema-core-migration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connections-v3-schema-core-migration.test.js","sourceRoot":"","sources":["../src/connections-v3-schema-core-migration.test.ts"],"names":[],"mappings":"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"}

package/dist/decision-queue-migrations.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=decision-queue-migrations.test.d.ts.map

package/dist/decision-queue-migrations.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision-queue-migrations.test.d.ts","sourceRoot":"","sources":["../src/decision-queue-migrations.test.ts"],"names":[],"mappings":""}

package/dist/decision-queue-migrations.test.js

@@ -0,0 +1,78 @@
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import { afterEach, describe, expect, it } from "vitest";
+import postgres from "postgres";
+import { getEmbeddedPostgresTestSupport, startEmbeddedPostgresTestDatabase, } from "./test-embedded-postgres.js";
+const DECISION_QUEUE_MIGRATIONS = [
+    "0198_decision_queues_and_triage.sql",
+    "0199_decision_queue_composite_key.sql",
+    "0200_yellow_maria_hill.sql",
+];
+const cleanups = [];
+const embeddedPostgresSupport = await getEmbeddedPostgresTestSupport();
+const describeEmbeddedPostgres = embeddedPostgresSupport.supported ? describe : describe.skip;
+async function readMigration(fileName) {
+    return fs.promises.readFile(new URL(`./migrations/${fileName}`, import.meta.url), "utf8");
+}
+async function reapplyDecisionQueueMigrations(sql) {
+    for (const fileName of DECISION_QUEUE_MIGRATIONS) {
+        await sql.unsafe(await readMigration(fileName));
+    }
+}
+afterEach(async () => {
+    while (cleanups.length > 0) {
+        await cleanups.pop()?.();
+    }
+});
+if (!embeddedPostgresSupport.supported) {
+    console.warn(`Skipping decision queue migration tests on this host: ${embeddedPostgresSupport.reason ?? "unsupported environment"}`);
+}
+describeEmbeddedPostgres("decision queue migrations", () => {
+    it("can be reapplied without changing schema or existing data", async () => {
+        const database = await startEmbeddedPostgresTestDatabase("paperclip-decision-queue-migrations-");
+        cleanups.push(database.cleanup);
+        const sql = postgres(database.connectionString, { max: 1, onnotice: () => { } });
+        const companyId = randomUUID();
+        const queueId = randomUUID();
+        const itemId = randomUUID();
+        try {
+            await sql `
+          INSERT INTO "companies" ("id", "name", "issue_prefix")
+          VALUES (${companyId}, 'Migration Test', 'DQM')
+        `;
+            await sql `
+          INSERT INTO "decision_queues" (
+            "id", "company_id", "key", "title", "created_by_type", "created_by_user_id"
+          ) VALUES (${queueId}, ${companyId}, 'migration-test', 'Migration Test', 'user', 'test-user')
+        `;
+            await sql `
+          INSERT INTO "decision_queue_items" (
+            "id", "company_id", "queue_id", "source_kind", "source_id", "added_by_type", "added_by_user_id"
+          ) VALUES (${itemId}, ${companyId}, ${queueId}, 'issue', 'DQM-1', 'user', 'test-user')
+        `;
+            await reapplyDecisionQueueMigrations(sql);
+            await reapplyDecisionQueueMigrations(sql);
+            const rows = await sql `
+          SELECT "id" FROM "decision_queue_items" WHERE "id" = ${itemId}
+        `;
+            expect(rows).toEqual([{ id: itemId }]);
+            const constraints = await sql `
+          SELECT "conname"
+          FROM "pg_constraint"
+          WHERE "conname" IN (
+            'decision_queues_id_company_uq',
+            'decision_queue_items_queue_company_fk'
+          )
+          ORDER BY "conname"
+        `;
+            expect(constraints).toEqual([
+                { conname: "decision_queue_items_queue_company_fk" },
+                { conname: "decision_queues_id_company_uq" },
+            ]);
+        }
+        finally {
+            await sql.end();
+        }
+    }, 30_000);
+});
+//# sourceMappingURL=decision-queue-migrations.test.js.map

package/dist/decision-queue-migrations.test.js.map

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

package/dist/embedded-postgres-error.d.ts

@@ -0,0 +1,9 @@
+export declare function createEmbeddedPostgresLogBuffer(limit?: number): {
+    append(message: unknown): void;
+    getRecentLogs(): string[];
+};
+export declare function formatEmbeddedPostgresError(error: unknown, input: {
+    fallbackMessage: string;
+    recentLogs?: string[];
+}): Error;
+//# sourceMappingURL=embedded-postgres-error.d.ts.map

package/dist/embedded-postgres-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-error.d.ts","sourceRoot":"","sources":["../src/embedded-postgres-error.ts"],"names":[],"mappings":"AAqCA,wBAAgB,+BAA+B,CAAC,KAAK,SAA2B,GAAG;IACjF,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,aAAa,IAAI,MAAM,EAAE,CAAC;CAC3B,CAyBA;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,KAAK,EAAE;IACL,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB,GACA,KAAK,CAeP"}

package/dist/embedded-postgres-error.js

@@ -0,0 +1,73 @@
+const DEFAULT_RECENT_LOG_LIMIT = 40;
+const RECENT_LOG_SUMMARY_LINES = 8;
+function toError(error, fallbackMessage) {
+    if (error instanceof Error)
+        return error;
+    if (error === undefined)
+        return new Error(fallbackMessage);
+    if (typeof error === "string")
+        return new Error(`${fallbackMessage}: ${error}`);
+    try {
+        return new Error(`${fallbackMessage}: ${JSON.stringify(error)}`);
+    }
+    catch {
+        return new Error(`${fallbackMessage}: ${String(error)}`);
+    }
+}
+function summarizeRecentLogs(recentLogs) {
+    if (recentLogs.length === 0)
+        return null;
+    return recentLogs
+        .slice(-RECENT_LOG_SUMMARY_LINES)
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0)
+        .join(" | ");
+}
+function detectEmbeddedPostgresHint(recentLogs) {
+    const haystack = recentLogs.join("\n").toLowerCase();
+    if (!haystack.includes("could not create shared memory segment")) {
+        return null;
+    }
+    return ("Embedded PostgreSQL bootstrap could not allocate shared memory. " +
+        "On macOS, this usually means the host's kern.sysv.shm* limits are too low for another local PostgreSQL cluster. " +
+        "Stop other local PostgreSQL servers or raise the shared-memory sysctls, then retry.");
+}
+export function createEmbeddedPostgresLogBuffer(limit = DEFAULT_RECENT_LOG_LIMIT) {
+    const recentLogs = [];
+    return {
+        append(message) {
+            const text = typeof message === "string"
+                ? message
+                : message instanceof Error
+                    ? message.message
+                    : String(message ?? "");
+            for (const rawLine of text.split(/\r?\n/)) {
+                const line = rawLine.trim();
+                if (!line)
+                    continue;
+                recentLogs.push(line);
+                if (recentLogs.length > limit) {
+                    recentLogs.splice(0, recentLogs.length - limit);
+                }
+            }
+        },
+        getRecentLogs() {
+            return [...recentLogs];
+        },
+    };
+}
+export function formatEmbeddedPostgresError(error, input) {
+    const baseError = toError(error, input.fallbackMessage);
+    const recentLogs = input.recentLogs ?? [];
+    const parts = [baseError.message];
+    const hint = detectEmbeddedPostgresHint(recentLogs);
+    const recentSummary = summarizeRecentLogs(recentLogs);
+    if (hint) {
+        parts.push(hint);
+    }
+    if (recentSummary) {
+        parts.push(`Recent embedded Postgres logs: ${recentSummary}`);
+    }
+    return new Error(parts.join(" "));
+}
+//# sourceMappingURL=embedded-postgres-error.js.map

package/dist/embedded-postgres-error.js.map

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

package/dist/embedded-postgres-error.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedded-postgres-error.test.d.ts.map

package/dist/embedded-postgres-error.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-error.test.d.ts","sourceRoot":"","sources":["../src/embedded-postgres-error.test.ts"],"names":[],"mappings":""}

package/dist/embedded-postgres-error.test.js

@@ -0,0 +1,25 @@
+import { describe, expect, it } from "vitest";
+import { createEmbeddedPostgresLogBuffer, formatEmbeddedPostgresError } from "./embedded-postgres-error.js";
+describe("formatEmbeddedPostgresError", () => {
+    it("adds a shared-memory hint when initdb logs expose the real cause", () => {
+        const error = formatEmbeddedPostgresError("Postgres init script exited with code 1.", {
+            fallbackMessage: "Failed to initialize embedded PostgreSQL cluster",
+            recentLogs: [
+                "running bootstrap script ...",
+                "FATAL:  could not create shared memory segment: Cannot allocate memory",
+                "DETAIL:  Failed system call was shmget(key=123, size=56, 03600).",
+            ],
+        });
+        expect(error.message).toContain("could not allocate shared memory");
+        expect(error.message).toContain("kern.sysv.shm");
+        expect(error.message).toContain("could not create shared memory segment");
+    });
+    it("keeps only recent non-empty log lines in the collector", () => {
+        const buffer = createEmbeddedPostgresLogBuffer(2);
+        buffer.append("line one\n\n");
+        buffer.append("line two");
+        buffer.append("line three");
+        expect(buffer.getRecentLogs()).toEqual(["line two", "line three"]);
+    });
+});
+//# sourceMappingURL=embedded-postgres-error.test.js.map

package/dist/embedded-postgres-error.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-error.test.js","sourceRoot":"","sources":["../src/embedded-postgres-error.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,+BAA+B,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAE5G,QAAQ,CAAC,6BAA6B,EAAE,GAAG,EAAE;IAC3C,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,KAAK,GAAG,2BAA2B,CAAC,0CAA0C,EAAE;YACpF,eAAe,EAAE,kDAAkD;YACnE,UAAU,EAAE;gBACV,8BAA8B;gBAC9B,wEAAwE;gBACxE,kEAAkE;aACnE;SACF,CAAC,CAAC;QAEH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,kCAAkC,CAAC,CAAC;QACpE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,wCAAwC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,+BAA+B,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;QAC9B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC1B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAE5B,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/embedded-postgres-lifecycle.d.ts

@@ -0,0 +1,16 @@
+type EmbeddedPostgresExitTarget = {
+    rawListeners(eventName: string): Function[];
+    removeListener(eventName: string, listener: (...args: any[]) => void): unknown;
+};
+/**
+ * embedded-postgres installs async-exit-hook listeners as an import side effect.
+ * Paperclip-managed clusters have an explicit owner and shutdown path, so those
+ * global listeners must not be allowed to stop a cluster independently of that
+ * owner (for example while a worktree seed restore is still streaming).
+ *
+ * Remove only listeners added by the supplied import and preserve every listener
+ * that was already registered by Paperclip or its host process.
+ */
+export declare function loadWithoutEmbeddedPostgresExitHooks<T>(load: () => Promise<T>, target?: EmbeddedPostgresExitTarget): Promise<T>;
+export {};
+//# sourceMappingURL=embedded-postgres-lifecycle.d.ts.map

package/dist/embedded-postgres-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-lifecycle.d.ts","sourceRoot":"","sources":["../src/embedded-postgres-lifecycle.ts"],"names":[],"mappings":"AAUA,KAAK,0BAA0B,GAAG;IAChC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAAC;IAC5C,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;CAChF,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,oCAAoC,CAAC,CAAC,EAC1D,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,MAAM,GAAE,0BAAoC,GAC3C,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/embedded-postgres-lifecycle.js

@@ -0,0 +1,43 @@
+const EMBEDDED_POSTGRES_EXIT_EVENTS = [
+    "exit",
+    "beforeExit",
+    "SIGHUP",
+    "SIGINT",
+    "SIGTERM",
+    "SIGBREAK",
+    "message",
+];
+/**
+ * embedded-postgres installs async-exit-hook listeners as an import side effect.
+ * Paperclip-managed clusters have an explicit owner and shutdown path, so those
+ * global listeners must not be allowed to stop a cluster independently of that
+ * owner (for example while a worktree seed restore is still streaming).
+ *
+ * Remove only listeners added by the supplied import and preserve every listener
+ * that was already registered by Paperclip or its host process.
+ */
+export async function loadWithoutEmbeddedPostgresExitHooks(load, target = process) {
+    const listenersBeforeLoad = new Map(EMBEDDED_POSTGRES_EXIT_EVENTS.map((eventName) => [
+        eventName,
+        target.rawListeners(eventName),
+    ]));
+    let loaded;
+    try {
+        loaded = await load();
+    }
+    finally {
+        for (const eventName of EMBEDDED_POSTGRES_EXIT_EVENTS) {
+            const remainingBeforeLoad = [...(listenersBeforeLoad.get(eventName) ?? [])];
+            for (const listener of target.rawListeners(eventName)) {
+                const existingIndex = remainingBeforeLoad.indexOf(listener);
+                if (existingIndex >= 0) {
+                    remainingBeforeLoad.splice(existingIndex, 1);
+                    continue;
+                }
+                target.removeListener(eventName, listener);
+            }
+        }
+    }
+    return loaded;
+}
+//# sourceMappingURL=embedded-postgres-lifecycle.js.map

package/dist/embedded-postgres-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-lifecycle.js","sourceRoot":"","sources":["../src/embedded-postgres-lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,6BAA6B,GAAG;IACpC,MAAM;IACN,YAAY;IACZ,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,UAAU;IACV,SAAS;CACD,CAAC;AAOX;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,oCAAoC,CACxD,IAAsB,EACtB,MAAM,GAA+B,OAAO;IAE5C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CACjC,6BAA6B,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC;QAC/C,SAAS;QACT,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC;KAC/B,CAAC,CACH,CAAC;IAEF,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;IACxB,CAAC;YAAS,CAAC;QACT,KAAK,MAAM,SAAS,IAAI,6BAA6B,EAAE,CAAC;YACtD,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YAC5E,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,CAAC;gBACtD,MAAM,aAAa,GAAG,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;gBAC5D,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;oBACvB,mBAAmB,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;oBAC7C,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,QAAoC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/embedded-postgres-lifecycle.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedded-postgres-lifecycle.test.d.ts.map

package/dist/embedded-postgres-lifecycle.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-lifecycle.test.d.ts","sourceRoot":"","sources":["../src/embedded-postgres-lifecycle.test.ts"],"names":[],"mappings":""}

package/dist/embedded-postgres-lifecycle.test.js

@@ -0,0 +1,64 @@
+import { EventEmitter } from "node:events";
+import { describe, expect, it, vi } from "vitest";
+import { loadWithoutEmbeddedPostgresExitHooks } from "./embedded-postgres-lifecycle.js";
+describe("loadWithoutEmbeddedPostgresExitHooks", () => {
+    it("removes every eager exit hook from the real embedded-postgres import", async () => {
+        const eventNames = [
+            "exit",
+            "beforeExit",
+            "SIGHUP",
+            "SIGINT",
+            "SIGTERM",
+            "SIGBREAK",
+            "message",
+        ];
+        const before = new Map(eventNames.map((eventName) => [
+            eventName,
+            process.rawListeners(eventName),
+        ]));
+        const moduleName = "embedded-postgres";
+        await loadWithoutEmbeddedPostgresExitHooks(() => import(moduleName));
+        for (const eventName of eventNames) {
+            expect(process.rawListeners(eventName)).toEqual(before.get(eventName));
+        }
+    });
+    it("removes dependency exit hooks while preserving existing listeners", async () => {
+        const target = new EventEmitter();
+        const existingSignalListener = vi.fn();
+        const existingExitListener = vi.fn();
+        target.on("SIGTERM", existingSignalListener);
+        target.on("exit", existingExitListener);
+        const dependencyListener = vi.fn();
+        const loaded = await loadWithoutEmbeddedPostgresExitHooks(async () => {
+            for (const eventName of [
+                "exit",
+                "beforeExit",
+                "SIGHUP",
+                "SIGINT",
+                "SIGTERM",
+                "SIGBREAK",
+                "message",
+            ]) {
+                target.on(eventName, dependencyListener);
+            }
+            return { default: class EmbeddedPostgres {
+                } };
+        }, target);
+        expect(loaded.default.name).toBe("EmbeddedPostgres");
+        expect(target.rawListeners("SIGTERM")).toEqual([existingSignalListener]);
+        expect(target.rawListeners("exit")).toEqual([existingExitListener]);
+        for (const eventName of ["beforeExit", "SIGHUP", "SIGINT", "SIGBREAK", "message"]) {
+            expect(target.rawListeners(eventName)).toEqual([]);
+        }
+    });
+    it("cleans up listeners even when the import fails", async () => {
+        const target = new EventEmitter();
+        const dependencyListener = vi.fn();
+        await expect(loadWithoutEmbeddedPostgresExitHooks(async () => {
+            target.on("SIGTERM", dependencyListener);
+            throw new Error("import failed");
+        }, target)).rejects.toThrow("import failed");
+        expect(target.rawListeners("SIGTERM")).toEqual([]);
+    });
+});
+//# sourceMappingURL=embedded-postgres-lifecycle.test.js.map

package/dist/embedded-postgres-lifecycle.test.js.map

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

package/dist/embedded-postgres-native.d.ts

@@ -0,0 +1,3 @@
+export declare function ensureLinuxSharedLibraryAliases(libDir: string): Promise<string[]>;
+export declare function prepareEmbeddedPostgresNativeRuntime(): Promise<void>;
+//# sourceMappingURL=embedded-postgres-native.d.ts.map

package/dist/embedded-postgres-native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-native.d.ts","sourceRoot":"","sources":["../src/embedded-postgres-native.ts"],"names":[],"mappings":"AAkDA,wBAAsB,+BAA+B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqBvF;AAED,wBAAsB,oCAAoC,IAAI,OAAO,CAAC,IAAI,CAAC,CAW1E"}

package/dist/embedded-postgres-native.js

@@ -0,0 +1,83 @@
+import { promises as fs } from "node:fs";
+import { createRequire } from "node:module";
+import path from "node:path";
+const require = createRequire(import.meta.url);
+function resolveNativePackageName() {
+    if (process.platform !== "linux")
+        return null;
+    switch (process.arch) {
+        case "arm64":
+            return "linux-arm64";
+        case "arm":
+            return "linux-arm";
+        case "ia32":
+            return "linux-ia32";
+        case "ppc64":
+            return "linux-ppc64";
+        case "x64":
+            return "linux-x64";
+        default:
+            return null;
+    }
+}
+async function pathExists(value) {
+    try {
+        await fs.stat(value);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function resolveEmbeddedPostgresPackageRoot() {
+    try {
+        const entry = require.resolve("embedded-postgres");
+        return path.dirname(path.dirname(entry));
+    }
+    catch {
+        return null;
+    }
+}
+function prependPathEnv(name, value) {
+    const current = process.env[name] ?? "";
+    const parts = current.split(path.delimiter).filter(Boolean);
+    if (parts.includes(value))
+        return;
+    process.env[name] = [value, ...parts].join(path.delimiter);
+}
+export async function ensureLinuxSharedLibraryAliases(libDir) {
+    const entries = await fs.readdir(libDir, { withFileTypes: true });
+    const created = [];
+    for (const entry of entries) {
+        if (!entry.isFile())
+            continue;
+        const match = entry.name.match(/^(lib.+\.so\.\d+)\.\d+(?:\.\d+)?$/);
+        if (!match)
+            continue;
+        const aliasName = match[1];
+        const aliasPath = path.join(libDir, aliasName);
+        try {
+            await fs.symlink(entry.name, aliasPath);
+            created.push(aliasPath);
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                continue;
+            throw error;
+        }
+    }
+    return created;
+}
+export async function prepareEmbeddedPostgresNativeRuntime() {
+    const nativePackageName = resolveNativePackageName();
+    const packageRoot = resolveEmbeddedPostgresPackageRoot();
+    if (!nativePackageName || !packageRoot)
+        return;
+    const nativeRoot = path.resolve(packageRoot, "..", "@embedded-postgres", nativePackageName);
+    const libDir = path.join(nativeRoot, "native", "lib");
+    if (!(await pathExists(libDir)))
+        return;
+    prependPathEnv("LD_LIBRARY_PATH", libDir);
+    await ensureLinuxSharedLibraryAliases(libDir);
+}
+//# sourceMappingURL=embedded-postgres-native.js.map

package/dist/embedded-postgres-native.js.map

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

package/dist/embedded-postgres-native.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=embedded-postgres-native.test.d.ts.map

package/dist/embedded-postgres-native.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedded-postgres-native.test.d.ts","sourceRoot":"","sources":["../src/embedded-postgres-native.test.ts"],"names":[],"mappings":""}