@cedarjs/pg 0.2.0-alpha.0 → 0.3.0

package/dist/index.d.cts

@@ -1,5 +1,25 @@
-import { a as WorktreeIdentity, i as buildRoleName, n as buildCloneDatabaseName, o as resolveRoot, r as buildDatabaseName, s as resolveWorktreeIdentity, t as DbMode } from "./naming-C2nGVxPk.cjs";
-import { a as readLease, i as parseLease, n as envFilePath, r as isOrphanLease, t as Lease } from "./lease-t4I9JahV.cjs";
+import { a as WorktreeIdentity, i as buildRoleName, n as buildCloneDatabaseName, o as resolveRoot, r as buildDatabaseName, s as resolveWorktreeIdentity, t as DbMode } from "./naming-Df4fz_Fb.cjs";
+//#region src/core/lease.d.ts
+type Lease = {
+  schemaVersion: 1;
+  mode: DbMode;
+  root: string;
+  repoSlug: string;
+  worktreeSlug: string;
+  pathHash: string;
+  databaseName: string;
+  roleName: string;
+  port: number;
+  pid: number;
+  createdAt: string;
+};
+/** Narrow-parse a lease; reject incomplete or wrong-version records. */
+declare function parseLease(raw: unknown): Lease | null;
+/** Absolute `.cedarpg/<mode>.env` path (resolves root when omitted). */
+declare function envFilePath(root: string | undefined, mode: DbMode): string;
+declare function readLease(root: string, mode: DbMode): Lease | null;
+declare function isOrphanLease(lease: Lease): boolean;
+//#endregion
 //#region src/core/policy.d.ts
 /**
  * Shared acquire skip policy for test-runner adapters and Cedar CLI bridges.
@@ -58,6 +78,14 @@ type AcquireOptions = {
   mode: DbMode;
   /** Inject DATABASE_URL / TEST_DATABASE_URL into process.env (default true). */
   setEnv?: boolean;
+  /**
+   * Start from an empty database (default false): first DROP every database
+   * owned by this worktree's role for `mode` — the leased DB, TEMPLATE clones,
+   * crashed-run leftovers — then create it again. Scoped by the role (the
+   * lease's when it is for this database, else the derived name), so it works
+   * without a lease file and never touches other worktrees.
+   */
+  fresh?: boolean;
 };
 type AcquireResult = {
   databaseUrl: string;
@@ -128,7 +156,7 @@ declare function gc(): Promise<{
 type MarkTemplateOptions = {
   root?: string;
   mode: DbMode;
-  /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */
+  /** Superuser URL from `acquire`; when omitted, built from the lease port (never starts the host). */
   adminUrl?: string;
 };
 /**
@@ -142,13 +170,19 @@ declare function markTemplate(options: MarkTemplateOptions): Promise<{
 type CloneFromTemplateOptions = {
   root?: string;
   mode: DbMode;
-  /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */
+  /** Superuser URL from `acquire`; when omitted, built from the lease port (never starts the host). */
   adminUrl?: string;
   /**
    * Suffix for the clone datname (e.g. Jest worker id).
    * Defaults to `<pid>_<base36 time>`.
    */
   name?: string;
+  /**
+   * Keep an existing `<template>_c_<name>` owned by the lease role instead of
+   * failing with `database already exists` (default false). Worker adapters pass
+   * true so every test file in one worker attaches to the same clone.
+   */
+  reuse?: boolean;
   /**
    * Inject DATABASE_URL / TEST_DATABASE_URL for this clone (default false).
    * Host `cloneFromTemplateIfNeeded` defaults true; worker adapters pass true explicitly.
@@ -172,7 +206,9 @@ type CloneResult = {
  * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).
  * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).
  * Provider rejects when the leased DB is not marked TEMPLATE.
- * Port comes from the lease; admin URL is passed through or rediscovered.
+ * Port comes from the lease; admin URL is passed through or built from the lease
+ * port. Fails when nothing listens there (setup should have acquired).
+ * An existing clone datname fails unless `reuse` is set and the lease role owns it.
  */
 declare function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult>;
 type CloneFromTemplateIfNeededOptions = CloneFromTemplateOptions & ResolveAcquireSkipInput;
@@ -247,25 +283,60 @@ type CreateAcquireTaskOptions = {
 /** Run acquireIfNeeded, then optional afterAcquire (migrate / db:ready). */
 declare function createAcquireTask(options: CreateAcquireTaskOptions): () => Promise<void>;
 //#endregion
+//#region src/core/status.d.ts
+type ResolveDevStatusOptions = {
+  root?: string;
+  mode?: DbMode;
+};
+type DevStatus = {
+  ok: true;
+  mode: DbMode;
+  root: string;
+  lease: Lease;
+  databaseUrl: string;
+  envPath: string;
+} | {
+  ok: false;
+  mode: DbMode;
+  root: string;
+};
+/** Read-only lease snapshot for CLI / Vite panel (no acquire, no host). */
+declare function resolveDevStatus(options?: ResolveDevStatusOptions): DevStatus;
+//#endregion
 //#region src/providers/autopg.d.ts
 type AutopgDiscovery = {
   port: number;
   adminUrl: string;
   bin: string;
 };
+type HostStatusPaths = {
+  dataDir?: string;
+  socketDir?: string;
+  logsDir?: string;
+};
 declare const INSTALL_HINT: string;
 /** Password scheme v2: sha256(PASSWORD_SALT_PREFIX + "\\0" + roleName) hex[:32]. Frozen for URL rebuild. */
 declare const ROLE_PASSWORD_SCHEME: "v2";
 declare function resolveAutopgBin(): string | null;
 declare function requireAutopgBin(): string;
 /**
- * Parse `autopg status --json` output. Requires a numeric port and running !== false.
+ * Parse `autopg status --json` → the **registered** port (and data/socket/logs
+ * dirs when present). Throws only when the output is not autopg status JSON.
+ *
+ * Registration is not liveness: autopg reports a port for a stopped host too,
+ * and its `status` / `ready` describe the supervisor (autopg ≥ v3.2: `ready` needs
+ * pm2 `online`; pm2's raw state is `supervisorStatus`). Neither, nor `runtime.live`,
+ * is the attach gate — a bare postmaster (e.g. one cedar-pg revived) is
+ * query-ready while status stays `stopped` / `ready: false`.
+ * Liveness is a TCP accept on the port, proven by the caller (`acquire`).
  */
-declare function parseHostStatus(json: string): {
+declare function parseHostStatus(json: string): HostStatusPaths & {
   port: number;
 };
 /**
- * Discover a live autopg host via `autopg status --json`. Throws if the host is not proven live.
+ * Discover the registered autopg host (port + admin URL) via `autopg status --json`.
+ * Throws when autopg cannot be queried; does **not** prove a listener — probe TCP
+ * (or use `acquire`, which does) before connecting.
  */
 declare function discoverHost(bin?: string): AutopgDiscovery;
 /**
@@ -283,5 +354,5 @@ declare function buildDatabaseUrl(opts: {
   password?: string;
 }): string;
 //#endregion
-export { type AcquireIfNeededOptions, type AcquireIfNeededResult, type AcquireOptions, type AcquireResult, type AcquireSkip, type AcquireTaskContext, type AutopgDiscovery, CLI_NAME, type CloneFromTemplateIfNeededOptions, type CloneFromTemplateIfNeededResult, type CloneFromTemplateOptions, type CloneResult, type CreateAcquireTaskOptions, type DbMode, type DisposeOptions, type DisposeResult, INSTALL_HINT, type Lease, type LoadDevEnvOptions, type LoadTestEnvOptions, type MarkTemplateOptions, ROLE_PASSWORD_SCHEME, type ResolveAcquireSkipInput, STATE_DIRNAME, type WorktreeIdentity, acquire, acquireIfNeeded, applyDatabaseUrlEnv, buildCloneDatabaseName, buildDatabaseName, buildDatabaseUrl, buildRoleName, cloneFromTemplate, cloneFromTemplateIfNeeded, createAcquireTask, discoverHost, dispose, envFilePath, gc, isCedarPgManagedUrl, isExternalDatabaseEscapeHatch, isOrphanLease, loadDevEnv, loadTestEnv, markTemplate, parseHostStatus, parseLease, readLease, requireAutopgBin, resolveAcquireSkip, resolveAutopgBin, resolveRoot, resolveWorktreeIdentity, rolePasswordFor, urlFromLease };
+export { type AcquireIfNeededOptions, type AcquireIfNeededResult, type AcquireOptions, type AcquireResult, type AcquireSkip, type AcquireTaskContext, type AutopgDiscovery, CLI_NAME, type CloneFromTemplateIfNeededOptions, type CloneFromTemplateIfNeededResult, type CloneFromTemplateOptions, type CloneResult, type CreateAcquireTaskOptions, type DbMode, type DevStatus, type DisposeOptions, type DisposeResult, INSTALL_HINT, type Lease, type LoadDevEnvOptions, type LoadTestEnvOptions, type MarkTemplateOptions, ROLE_PASSWORD_SCHEME, type ResolveAcquireSkipInput, type ResolveDevStatusOptions, STATE_DIRNAME, type WorktreeIdentity, acquire, acquireIfNeeded, applyDatabaseUrlEnv, buildCloneDatabaseName, buildDatabaseName, buildDatabaseUrl, buildRoleName, cloneFromTemplate, cloneFromTemplateIfNeeded, createAcquireTask, discoverHost, dispose, envFilePath, gc, isCedarPgManagedUrl, isExternalDatabaseEscapeHatch, isOrphanLease, loadDevEnv, loadTestEnv, markTemplate, parseHostStatus, parseLease, readLease, requireAutopgBin, resolveAcquireSkip, resolveAutopgBin, resolveDevStatus, resolveRoot, resolveWorktreeIdentity, rolePasswordFor, urlFromLease };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,5 +1,25 @@
-import { a as WorktreeIdentity, i as buildRoleName, n as buildCloneDatabaseName, o as resolveRoot, r as buildDatabaseName, s as resolveWorktreeIdentity, t as DbMode } from "./naming-C2nGVxPk.mjs";
-import { a as readLease, i as parseLease, n as envFilePath, r as isOrphanLease, t as Lease } from "./lease-B3TuX92y.mjs";
+import { a as WorktreeIdentity, i as buildRoleName, n as buildCloneDatabaseName, o as resolveRoot, r as buildDatabaseName, s as resolveWorktreeIdentity, t as DbMode } from "./naming-Df4fz_Fb.mjs";
+//#region src/core/lease.d.ts
+type Lease = {
+  schemaVersion: 1;
+  mode: DbMode;
+  root: string;
+  repoSlug: string;
+  worktreeSlug: string;
+  pathHash: string;
+  databaseName: string;
+  roleName: string;
+  port: number;
+  pid: number;
+  createdAt: string;
+};
+/** Narrow-parse a lease; reject incomplete or wrong-version records. */
+declare function parseLease(raw: unknown): Lease | null;
+/** Absolute `.cedarpg/<mode>.env` path (resolves root when omitted). */
+declare function envFilePath(root: string | undefined, mode: DbMode): string;
+declare function readLease(root: string, mode: DbMode): Lease | null;
+declare function isOrphanLease(lease: Lease): boolean;
+//#endregion
 //#region src/core/policy.d.ts
 /**
  * Shared acquire skip policy for test-runner adapters and Cedar CLI bridges.
@@ -58,6 +78,14 @@ type AcquireOptions = {
   mode: DbMode;
   /** Inject DATABASE_URL / TEST_DATABASE_URL into process.env (default true). */
   setEnv?: boolean;
+  /**
+   * Start from an empty database (default false): first DROP every database
+   * owned by this worktree's role for `mode` — the leased DB, TEMPLATE clones,
+   * crashed-run leftovers — then create it again. Scoped by the role (the
+   * lease's when it is for this database, else the derived name), so it works
+   * without a lease file and never touches other worktrees.
+   */
+  fresh?: boolean;
 };
 type AcquireResult = {
   databaseUrl: string;
@@ -128,7 +156,7 @@ declare function gc(): Promise<{
 type MarkTemplateOptions = {
   root?: string;
   mode: DbMode;
-  /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */
+  /** Superuser URL from `acquire`; when omitted, built from the lease port (never starts the host). */
   adminUrl?: string;
 };
 /**
@@ -142,13 +170,19 @@ declare function markTemplate(options: MarkTemplateOptions): Promise<{
 type CloneFromTemplateOptions = {
   root?: string;
   mode: DbMode;
-  /** Superuser URL from `acquire`; when omitted, discovers/starts the host. */
+  /** Superuser URL from `acquire`; when omitted, built from the lease port (never starts the host). */
   adminUrl?: string;
   /**
    * Suffix for the clone datname (e.g. Jest worker id).
    * Defaults to `<pid>_<base36 time>`.
    */
   name?: string;
+  /**
+   * Keep an existing `<template>_c_<name>` owned by the lease role instead of
+   * failing with `database already exists` (default false). Worker adapters pass
+   * true so every test file in one worker attaches to the same clone.
+   */
+  reuse?: boolean;
   /**
    * Inject DATABASE_URL / TEST_DATABASE_URL for this clone (default false).
    * Host `cloneFromTemplateIfNeeded` defaults true; worker adapters pass true explicitly.
@@ -172,7 +206,9 @@ type CloneResult = {
  * Clone the leased TEMPLATE database via admin (`CREATE DATABASE … TEMPLATE`).
  * Reuses the template role so `databaseUrl` passwords stay valid (scheme v2).
  * Provider rejects when the leased DB is not marked TEMPLATE.
- * Port comes from the lease; admin URL is passed through or rediscovered.
+ * Port comes from the lease; admin URL is passed through or built from the lease
+ * port. Fails when nothing listens there (setup should have acquired).
+ * An existing clone datname fails unless `reuse` is set and the lease role owns it.
  */
 declare function cloneFromTemplate(options: CloneFromTemplateOptions): Promise<CloneResult>;
 type CloneFromTemplateIfNeededOptions = CloneFromTemplateOptions & ResolveAcquireSkipInput;
@@ -247,25 +283,60 @@ type CreateAcquireTaskOptions = {
 /** Run acquireIfNeeded, then optional afterAcquire (migrate / db:ready). */
 declare function createAcquireTask(options: CreateAcquireTaskOptions): () => Promise<void>;
 //#endregion
+//#region src/core/status.d.ts
+type ResolveDevStatusOptions = {
+  root?: string;
+  mode?: DbMode;
+};
+type DevStatus = {
+  ok: true;
+  mode: DbMode;
+  root: string;
+  lease: Lease;
+  databaseUrl: string;
+  envPath: string;
+} | {
+  ok: false;
+  mode: DbMode;
+  root: string;
+};
+/** Read-only lease snapshot for CLI / Vite panel (no acquire, no host). */
+declare function resolveDevStatus(options?: ResolveDevStatusOptions): DevStatus;
+//#endregion
 //#region src/providers/autopg.d.ts
 type AutopgDiscovery = {
   port: number;
   adminUrl: string;
   bin: string;
 };
+type HostStatusPaths = {
+  dataDir?: string;
+  socketDir?: string;
+  logsDir?: string;
+};
 declare const INSTALL_HINT: string;
 /** Password scheme v2: sha256(PASSWORD_SALT_PREFIX + "\\0" + roleName) hex[:32]. Frozen for URL rebuild. */
 declare const ROLE_PASSWORD_SCHEME: "v2";
 declare function resolveAutopgBin(): string | null;
 declare function requireAutopgBin(): string;
 /**
- * Parse `autopg status --json` output. Requires a numeric port and running !== false.
+ * Parse `autopg status --json` → the **registered** port (and data/socket/logs
+ * dirs when present). Throws only when the output is not autopg status JSON.
+ *
+ * Registration is not liveness: autopg reports a port for a stopped host too,
+ * and its `status` / `ready` describe the supervisor (autopg ≥ v3.2: `ready` needs
+ * pm2 `online`; pm2's raw state is `supervisorStatus`). Neither, nor `runtime.live`,
+ * is the attach gate — a bare postmaster (e.g. one cedar-pg revived) is
+ * query-ready while status stays `stopped` / `ready: false`.
+ * Liveness is a TCP accept on the port, proven by the caller (`acquire`).
  */
-declare function parseHostStatus(json: string): {
+declare function parseHostStatus(json: string): HostStatusPaths & {
   port: number;
 };
 /**
- * Discover a live autopg host via `autopg status --json`. Throws if the host is not proven live.
+ * Discover the registered autopg host (port + admin URL) via `autopg status --json`.
+ * Throws when autopg cannot be queried; does **not** prove a listener — probe TCP
+ * (or use `acquire`, which does) before connecting.
  */
 declare function discoverHost(bin?: string): AutopgDiscovery;
 /**
@@ -283,5 +354,5 @@ declare function buildDatabaseUrl(opts: {
   password?: string;
 }): string;
 //#endregion
-export { type AcquireIfNeededOptions, type AcquireIfNeededResult, type AcquireOptions, type AcquireResult, type AcquireSkip, type AcquireTaskContext, type AutopgDiscovery, CLI_NAME, type CloneFromTemplateIfNeededOptions, type CloneFromTemplateIfNeededResult, type CloneFromTemplateOptions, type CloneResult, type CreateAcquireTaskOptions, type DbMode, type DisposeOptions, type DisposeResult, INSTALL_HINT, type Lease, type LoadDevEnvOptions, type LoadTestEnvOptions, type MarkTemplateOptions, ROLE_PASSWORD_SCHEME, type ResolveAcquireSkipInput, STATE_DIRNAME, type WorktreeIdentity, acquire, acquireIfNeeded, applyDatabaseUrlEnv, buildCloneDatabaseName, buildDatabaseName, buildDatabaseUrl, buildRoleName, cloneFromTemplate, cloneFromTemplateIfNeeded, createAcquireTask, discoverHost, dispose, envFilePath, gc, isCedarPgManagedUrl, isExternalDatabaseEscapeHatch, isOrphanLease, loadDevEnv, loadTestEnv, markTemplate, parseHostStatus, parseLease, readLease, requireAutopgBin, resolveAcquireSkip, resolveAutopgBin, resolveRoot, resolveWorktreeIdentity, rolePasswordFor, urlFromLease };
+export { type AcquireIfNeededOptions, type AcquireIfNeededResult, type AcquireOptions, type AcquireResult, type AcquireSkip, type AcquireTaskContext, type AutopgDiscovery, CLI_NAME, type CloneFromTemplateIfNeededOptions, type CloneFromTemplateIfNeededResult, type CloneFromTemplateOptions, type CloneResult, type CreateAcquireTaskOptions, type DbMode, type DevStatus, type DisposeOptions, type DisposeResult, INSTALL_HINT, type Lease, type LoadDevEnvOptions, type LoadTestEnvOptions, type MarkTemplateOptions, ROLE_PASSWORD_SCHEME, type ResolveAcquireSkipInput, type ResolveDevStatusOptions, STATE_DIRNAME, type WorktreeIdentity, acquire, acquireIfNeeded, applyDatabaseUrlEnv, buildCloneDatabaseName, buildDatabaseName, buildDatabaseUrl, buildRoleName, cloneFromTemplate, cloneFromTemplateIfNeeded, createAcquireTask, discoverHost, dispose, envFilePath, gc, isCedarPgManagedUrl, isExternalDatabaseEscapeHatch, isOrphanLease, loadDevEnv, loadTestEnv, markTemplate, parseHostStatus, parseLease, readLease, requireAutopgBin, resolveAcquireSkip, resolveAutopgBin, resolveDevStatus, resolveRoot, resolveWorktreeIdentity, rolePasswordFor, urlFromLease };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,9 +1,9 @@
-import { C as buildCloneDatabaseName, T as buildRoleName, a as urlFromLease, b as isExternalDatabaseEscapeHatch, c as ROLE_PASSWORD_SCHEME, d as discoverHost, g as rolePasswordFor, h as resolveAutopgBin, i as gc, l as buildDatabaseUrl, m as requireAutopgBin, n as acquireIfNeeded, p as parseHostStatus, r as dispose, s as INSTALL_HINT, t as acquire, v as applyDatabaseUrlEnv, w as buildDatabaseName, x as resolveAcquireSkip, y as isCedarPgManagedUrl } from "./lifecycle-BOo6xBjD.mjs";
-import { r as STATE_DIRNAME, t as CLI_NAME } from "./constants-NLR0U4NR.mjs";
-import { c as parseLease, d as resolveRoot, f as resolveWorktreeIdentity, i as isOrphanLease, l as readLease, t as envFilePath } from "./lease-BSBBpaR4.mjs";
-import { n as cloneFromTemplateIfNeeded, r as markTemplate, t as cloneFromTemplate } from "./template-CGw3C1Ob.mjs";
-import { t as loadTestEnv } from "./load-test-env-C34wpkIX.mjs";
-import { t as loadDevEnv } from "./load-dev-env-7UjMHhw7.mjs";
+import { c as parseLease, d as resolveRoot, f as resolveWorktreeIdentity, h as STATE_DIRNAME, i as isOrphanLease, l as readLease, p as CLI_NAME, t as envFilePath } from "./lease-DS1SX8U_.mjs";
+import { C as resolveAcquireSkip, D as buildRoleName, E as buildDatabaseName, S as isExternalDatabaseEscapeHatch, T as buildCloneDatabaseName, _ as rolePasswordFor, a as gc, b as applyDatabaseUrlEnv, c as ROLE_PASSWORD_SCHEME, f as discoverHost, g as resolveAutopgBin, h as requireAutopgBin, i as dispose, m as parseHostStatus, n as acquireIfNeeded, o as urlFromLease, s as INSTALL_HINT, t as acquire, u as buildDatabaseUrl, x as isCedarPgManagedUrl } from "./lifecycle-2BZgSVz2.mjs";
+import { n as cloneFromTemplateIfNeeded, r as markTemplate, t as cloneFromTemplate } from "./template-DlqHL8Go.mjs";
+import { t as loadTestEnv } from "./load-test-env-BqtA6V-d.mjs";
+import { t as loadDevEnv } from "./load-dev-env-BULkXyen.mjs";
+import { t as resolveDevStatus } from "./status-B68SGSKx.mjs";
 //#region src/adapters/acquire-task.ts
 /** Run acquireIfNeeded, then optional afterAcquire (migrate / db:ready). */
 function createAcquireTask(options) {
@@ -27,6 +27,6 @@ function createAcquireTask(options) {
 	};
 }
 //#endregion
-export { CLI_NAME, INSTALL_HINT, ROLE_PASSWORD_SCHEME, STATE_DIRNAME, acquire, acquireIfNeeded, applyDatabaseUrlEnv, buildCloneDatabaseName, buildDatabaseName, buildDatabaseUrl, buildRoleName, cloneFromTemplate, cloneFromTemplateIfNeeded, createAcquireTask, discoverHost, dispose, envFilePath, gc, isCedarPgManagedUrl, isExternalDatabaseEscapeHatch, isOrphanLease, loadDevEnv, loadTestEnv, markTemplate, parseHostStatus, parseLease, readLease, requireAutopgBin, resolveAcquireSkip, resolveAutopgBin, resolveRoot, resolveWorktreeIdentity, rolePasswordFor, urlFromLease };
+export { CLI_NAME, INSTALL_HINT, ROLE_PASSWORD_SCHEME, STATE_DIRNAME, acquire, acquireIfNeeded, applyDatabaseUrlEnv, buildCloneDatabaseName, buildDatabaseName, buildDatabaseUrl, buildRoleName, cloneFromTemplate, cloneFromTemplateIfNeeded, createAcquireTask, discoverHost, dispose, envFilePath, gc, isCedarPgManagedUrl, isExternalDatabaseEscapeHatch, isOrphanLease, loadDevEnv, loadTestEnv, markTemplate, parseHostStatus, parseLease, readLease, requireAutopgBin, resolveAcquireSkip, resolveAutopgBin, resolveDevStatus, resolveRoot, resolveWorktreeIdentity, rolePasswordFor, urlFromLease };
 
 //# sourceMappingURL=index.mjs.map

package/dist/jest-teardown.cjs

@@ -1,4 +1,4 @@
-const require_lifecycle = require("./lifecycle-DEJ4GgWV.cjs");
+const require_lifecycle = require("./lifecycle-BCeM96tI.cjs");
 //#region src/adapters/jest-teardown.ts
 /**
 * Jest `globalTeardown` entry (default export).

package/dist/jest-teardown.mjs

@@ -1,4 +1,4 @@
-import { r as dispose } from "./lifecycle-BOo6xBjD.mjs";
+import { i as dispose } from "./lifecycle-2BZgSVz2.mjs";
 //#region src/adapters/jest-teardown.ts
 /**
 * Jest `globalTeardown` entry (default export).

package/dist/jest-template.cjs

@@ -2,10 +2,11 @@ Object.defineProperties(exports, {
 	__esModule: { value: true },
 	[Symbol.toStringTag]: { value: "Module" }
 });
-const require_template_mode = require("./template-mode-BkEs9LnY.cjs");
+const require_template_mode = require("./template-mode-DMO5-z7O.cjs");
 //#region src/adapters/jest-template.ts
 /**
-* Jest globalSetup (template mode).
+* Jest globalSetup (template mode). Drops crashed-run leftovers under this
+* worktree's test role, then acquire → migrate → markTemplate.
 *
 * ```js
 * // jest.cedar-global.cjs
@@ -13,8 +14,12 @@ const require_template_mode = require("./template-mode-BkEs9LnY.cjs");
 * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });
 *
 * // jest.config.cjs
+* // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):
+* // process.env.CEDAR_PG_FORCE = "1";
 * globalSetup: "<rootDir>/jest.cedar-global.cjs",
 * globalTeardown: require.resolve("@cedarjs/pg/jest-teardown"),
+* // Runs per test file; every file in a worker reuses that worker's clone,
+* // truncated with RESTART IDENTITY first (`cloneWorkerDatabase({ reset: "none" })` opts out).
 * setupFilesAfterEnv: ["<rootDir>/jest.cedar-worker.cjs"],
 *
 * // jest.cedar-worker.cjs

package/dist/jest-template.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"jest-template.cjs","names":["setupTemplateMode"],"sources":["../src/adapters/jest-template.ts"],"sourcesContent":["import {\n  cloneWorkerDatabase,\n  setupTemplateMode,\n  type SetupTemplateModeOptions,\n} from \"./template-mode.ts\";\n\nexport { cloneWorkerDatabase };\nexport type {\n  SetupTemplateModeOptions,\n  TemplateMigrateFn,\n  TemplateMigrateContext,\n} from \"./template-mode.ts\";\n\n/**\n * Jest globalSetup (template mode).\n *\n * ```js\n * // jest.cedar-global.cjs\n * const { createGlobalSetup } = require(\"@cedarjs/pg/jest/template\");\n * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });\n *\n * // jest.config.cjs\n * globalSetup: \"<rootDir>/jest.cedar-global.cjs\",\n * globalTeardown: require.resolve(\"@cedarjs/pg/jest-teardown\"),\n * setupFilesAfterEnv: [\"<rootDir>/jest.cedar-worker.cjs\"],\n *\n * // jest.cedar-worker.cjs\n * const { cloneWorkerDatabase } = require(\"@cedarjs/pg/jest/template\");\n * beforeAll(() => cloneWorkerDatabase());\n * ```\n *\n * Stock `@cedarjs/pg/jest` is one shared test DB only.\n */\nexport function createGlobalSetup(options: SetupTemplateModeOptions) {\n  return async () => {\n    await setupTemplateMode(options);\n  };\n}\n\n/** String `require.resolve` without a migrate hook is unsupported — use `createGlobalSetup`. */\nexport default async function globalSetup(): Promise<void> {\n  throw new Error(\n    \"@cedarjs/pg/jest/template requires createGlobalSetup({ migrate }). \" +\n      \"Point globalSetup at a local module that exports createGlobalSetup({ migrate }).\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,kBAAkB,SAAmC;CACnE,OAAO,YAAY;EACjB,MAAMA,sBAAAA,kBAAkB,OAAO;CACjC;AACF;;AAGA,eAA8B,cAA6B;CACzD,MAAM,IAAI,MACR,qJAEF;AACF"}
+{"version":3,"file":"jest-template.cjs","names":["setupTemplateMode"],"sources":["../src/adapters/jest-template.ts"],"sourcesContent":["import {\n  cloneWorkerDatabase,\n  setupTemplateMode,\n  type SetupTemplateModeOptions,\n} from \"./template-mode.ts\";\n\nexport { cloneWorkerDatabase };\nexport type {\n  SetupTemplateModeOptions,\n  TemplateMigrateFn,\n  TemplateMigrateContext,\n} from \"./template-mode.ts\";\n\n/**\n * Jest globalSetup (template mode). Drops crashed-run leftovers under this\n * worktree's test role, then acquire → migrate → markTemplate.\n *\n * ```js\n * // jest.cedar-global.cjs\n * const { createGlobalSetup } = require(\"@cedarjs/pg/jest/template\");\n * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });\n *\n * // jest.config.cjs\n * // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):\n * // process.env.CEDAR_PG_FORCE = \"1\";\n * globalSetup: \"<rootDir>/jest.cedar-global.cjs\",\n * globalTeardown: require.resolve(\"@cedarjs/pg/jest-teardown\"),\n * // Runs per test file; every file in a worker reuses that worker's clone,\n * // truncated with RESTART IDENTITY first (`cloneWorkerDatabase({ reset: \"none\" })` opts out).\n * setupFilesAfterEnv: [\"<rootDir>/jest.cedar-worker.cjs\"],\n *\n * // jest.cedar-worker.cjs\n * const { cloneWorkerDatabase } = require(\"@cedarjs/pg/jest/template\");\n * beforeAll(() => cloneWorkerDatabase());\n * ```\n *\n * Stock `@cedarjs/pg/jest` is one shared test DB only.\n */\nexport function createGlobalSetup(options: SetupTemplateModeOptions) {\n  return async () => {\n    await setupTemplateMode(options);\n  };\n}\n\n/** String `require.resolve` without a migrate hook is unsupported — use `createGlobalSetup`. */\nexport default async function globalSetup(): Promise<void> {\n  throw new Error(\n    \"@cedarjs/pg/jest/template requires createGlobalSetup({ migrate }). \" +\n      \"Point globalSetup at a local module that exports createGlobalSetup({ migrate }).\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,kBAAkB,SAAmC;CACnE,OAAO,YAAY;EACjB,MAAMA,sBAAAA,kBAAkB,OAAO;CACjC;AACF;;AAGA,eAA8B,cAA6B;CACzD,MAAM,IAAI,MACR,qJAEF;AACF"}

package/dist/jest-template.d.cts

@@ -1,7 +1,8 @@
-import { i as cloneWorkerDatabase, n as TemplateMigrateContext, r as TemplateMigrateFn, t as SetupTemplateModeOptions } from "./template-mode-CcxV_Iju.cjs";
+import { i as cloneWorkerDatabase, n as TemplateMigrateContext, r as TemplateMigrateFn, t as SetupTemplateModeOptions } from "./template-mode-BqV3GjXI.cjs";
 //#region src/adapters/jest-template.d.ts
 /**
- * Jest globalSetup (template mode).
+ * Jest globalSetup (template mode). Drops crashed-run leftovers under this
+ * worktree's test role, then acquire → migrate → markTemplate.
  *
  * ```js
  * // jest.cedar-global.cjs
@@ -9,8 +10,12 @@ import { i as cloneWorkerDatabase, n as TemplateMigrateContext, r as TemplateMig
  * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });
  *
  * // jest.config.cjs
+ * // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):
+ * // process.env.CEDAR_PG_FORCE = "1";
  * globalSetup: "<rootDir>/jest.cedar-global.cjs",
  * globalTeardown: require.resolve("@cedarjs/pg/jest-teardown"),
+ * // Runs per test file; every file in a worker reuses that worker's clone,
+ * // truncated with RESTART IDENTITY first (`cloneWorkerDatabase({ reset: "none" })` opts out).
  * setupFilesAfterEnv: ["<rootDir>/jest.cedar-worker.cjs"],
  *
  * // jest.cedar-worker.cjs

package/dist/jest-template.d.mts

@@ -1,7 +1,8 @@
-import { i as cloneWorkerDatabase, n as TemplateMigrateContext, r as TemplateMigrateFn, t as SetupTemplateModeOptions } from "./template-mode-CcxV_Iju.mjs";
+import { i as cloneWorkerDatabase, n as TemplateMigrateContext, r as TemplateMigrateFn, t as SetupTemplateModeOptions } from "./template-mode-BqV3GjXI.mjs";
 //#region src/adapters/jest-template.d.ts
 /**
- * Jest globalSetup (template mode).
+ * Jest globalSetup (template mode). Drops crashed-run leftovers under this
+ * worktree's test role, then acquire → migrate → markTemplate.
  *
  * ```js
  * // jest.cedar-global.cjs
@@ -9,8 +10,12 @@ import { i as cloneWorkerDatabase, n as TemplateMigrateContext, r as TemplateMig
  * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });
  *
  * // jest.config.cjs
+ * // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):
+ * // process.env.CEDAR_PG_FORCE = "1";
  * globalSetup: "<rootDir>/jest.cedar-global.cjs",
  * globalTeardown: require.resolve("@cedarjs/pg/jest-teardown"),
+ * // Runs per test file; every file in a worker reuses that worker's clone,
+ * // truncated with RESTART IDENTITY first (`cloneWorkerDatabase({ reset: "none" })` opts out).
  * setupFilesAfterEnv: ["<rootDir>/jest.cedar-worker.cjs"],
  *
  * // jest.cedar-worker.cjs

package/dist/jest-template.mjs

@@ -1,7 +1,8 @@
-import { n as setupTemplateMode, t as cloneWorkerDatabase } from "./template-mode-IjlFOG4O.mjs";
+import { n as setupTemplateMode, t as cloneWorkerDatabase } from "./template-mode-DK5cAlv9.mjs";
 //#region src/adapters/jest-template.ts
 /**
-* Jest globalSetup (template mode).
+* Jest globalSetup (template mode). Drops crashed-run leftovers under this
+* worktree's test role, then acquire → migrate → markTemplate.
 *
 * ```js
 * // jest.cedar-global.cjs
@@ -9,8 +10,12 @@ import { n as setupTemplateMode, t as cloneWorkerDatabase } from "./template-mod
 * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });
 *
 * // jest.config.cjs
+* // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):
+* // process.env.CEDAR_PG_FORCE = "1";
 * globalSetup: "<rootDir>/jest.cedar-global.cjs",
 * globalTeardown: require.resolve("@cedarjs/pg/jest-teardown"),
+* // Runs per test file; every file in a worker reuses that worker's clone,
+* // truncated with RESTART IDENTITY first (`cloneWorkerDatabase({ reset: "none" })` opts out).
 * setupFilesAfterEnv: ["<rootDir>/jest.cedar-worker.cjs"],
 *
 * // jest.cedar-worker.cjs

package/dist/jest-template.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"jest-template.mjs","names":[],"sources":["../src/adapters/jest-template.ts"],"sourcesContent":["import {\n  cloneWorkerDatabase,\n  setupTemplateMode,\n  type SetupTemplateModeOptions,\n} from \"./template-mode.ts\";\n\nexport { cloneWorkerDatabase };\nexport type {\n  SetupTemplateModeOptions,\n  TemplateMigrateFn,\n  TemplateMigrateContext,\n} from \"./template-mode.ts\";\n\n/**\n * Jest globalSetup (template mode).\n *\n * ```js\n * // jest.cedar-global.cjs\n * const { createGlobalSetup } = require(\"@cedarjs/pg/jest/template\");\n * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });\n *\n * // jest.config.cjs\n * globalSetup: \"<rootDir>/jest.cedar-global.cjs\",\n * globalTeardown: require.resolve(\"@cedarjs/pg/jest-teardown\"),\n * setupFilesAfterEnv: [\"<rootDir>/jest.cedar-worker.cjs\"],\n *\n * // jest.cedar-worker.cjs\n * const { cloneWorkerDatabase } = require(\"@cedarjs/pg/jest/template\");\n * beforeAll(() => cloneWorkerDatabase());\n * ```\n *\n * Stock `@cedarjs/pg/jest` is one shared test DB only.\n */\nexport function createGlobalSetup(options: SetupTemplateModeOptions) {\n  return async () => {\n    await setupTemplateMode(options);\n  };\n}\n\n/** String `require.resolve` without a migrate hook is unsupported — use `createGlobalSetup`. */\nexport default async function globalSetup(): Promise<void> {\n  throw new Error(\n    \"@cedarjs/pg/jest/template requires createGlobalSetup({ migrate }). \" +\n      \"Point globalSetup at a local module that exports createGlobalSetup({ migrate }).\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAiCA,SAAgB,kBAAkB,SAAmC;CACnE,OAAO,YAAY;EACjB,MAAM,kBAAkB,OAAO;CACjC;AACF;;AAGA,eAA8B,cAA6B;CACzD,MAAM,IAAI,MACR,qJAEF;AACF"}
+{"version":3,"file":"jest-template.mjs","names":[],"sources":["../src/adapters/jest-template.ts"],"sourcesContent":["import {\n  cloneWorkerDatabase,\n  setupTemplateMode,\n  type SetupTemplateModeOptions,\n} from \"./template-mode.ts\";\n\nexport { cloneWorkerDatabase };\nexport type {\n  SetupTemplateModeOptions,\n  TemplateMigrateFn,\n  TemplateMigrateContext,\n} from \"./template-mode.ts\";\n\n/**\n * Jest globalSetup (template mode). Drops crashed-run leftovers under this\n * worktree's test role, then acquire → migrate → markTemplate.\n *\n * ```js\n * // jest.cedar-global.cjs\n * const { createGlobalSetup } = require(\"@cedarjs/pg/jest/template\");\n * module.exports = createGlobalSetup({ migrate: async ({ databaseUrl }) => {} });\n *\n * // jest.config.cjs\n * // When .env has a real TEST_DATABASE_URL, set once here (inherits to workers):\n * // process.env.CEDAR_PG_FORCE = \"1\";\n * globalSetup: \"<rootDir>/jest.cedar-global.cjs\",\n * globalTeardown: require.resolve(\"@cedarjs/pg/jest-teardown\"),\n * // Runs per test file; every file in a worker reuses that worker's clone,\n * // truncated with RESTART IDENTITY first (`cloneWorkerDatabase({ reset: \"none\" })` opts out).\n * setupFilesAfterEnv: [\"<rootDir>/jest.cedar-worker.cjs\"],\n *\n * // jest.cedar-worker.cjs\n * const { cloneWorkerDatabase } = require(\"@cedarjs/pg/jest/template\");\n * beforeAll(() => cloneWorkerDatabase());\n * ```\n *\n * Stock `@cedarjs/pg/jest` is one shared test DB only.\n */\nexport function createGlobalSetup(options: SetupTemplateModeOptions) {\n  return async () => {\n    await setupTemplateMode(options);\n  };\n}\n\n/** String `require.resolve` without a migrate hook is unsupported — use `createGlobalSetup`. */\nexport default async function globalSetup(): Promise<void> {\n  throw new Error(\n    \"@cedarjs/pg/jest/template requires createGlobalSetup({ migrate }). \" +\n      \"Point globalSetup at a local module that exports createGlobalSetup({ migrate }).\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,SAAgB,kBAAkB,SAAmC;CACnE,OAAO,YAAY;EACjB,MAAM,kBAAkB,OAAO;CACjC;AACF;;AAGA,eAA8B,cAA6B;CACzD,MAAM,IAAI,MACR,qJAEF;AACF"}

package/dist/jest.cjs

@@ -1,4 +1,4 @@
-const require_lifecycle = require("./lifecycle-DEJ4GgWV.cjs");
+const require_lifecycle = require("./lifecycle-BCeM96tI.cjs");
 //#region src/adapters/jest.ts
 /**
 * Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).

package/dist/jest.mjs

@@ -1,4 +1,4 @@
-import { n as acquireIfNeeded } from "./lifecycle-BOo6xBjD.mjs";
+import { n as acquireIfNeeded } from "./lifecycle-2BZgSVz2.mjs";
 //#region src/adapters/jest.ts
 /**
 * Jest globalSetup for a single shared test DB (`acquireIfNeeded` + dispose).

package/dist/{lease-BSBBpaR4.mjs → lease-DS1SX8U_.mjs}

@@ -1,9 +1,29 @@
-import { r as STATE_DIRNAME } from "./constants-NLR0U4NR.mjs";
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { basename, dirname, join, resolve } from "node:path";
 import { createHash } from "node:crypto";
 import { execFileSync } from "node:child_process";
+//#region src/core/constants.ts
+/**
+* Product identity vs frozen crypto.
+*
+* State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under
+* autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).
+* Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.
+*/
+/** User-facing CLI binary (`package.json` bin) and log prefix */
+const CLI_NAME = "cedarpg";
+/**
+* Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).
+* Frozen for lease/gc discovery after first alpha consumers appear.
+*/
+const STATE_DIRNAME = ".cedarpg";
+/**
+* Password scheme v2 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\0` + roleName).
+* Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.
+*/
+const PASSWORD_SALT_PREFIX = "cedar-pg";
+//#endregion
 //#region src/core/worktree.ts
 function git(args, cwd) {
 	try {
@@ -196,6 +216,6 @@ function isOrphanLease(lease) {
 	return !existsSync(lease.root);
 }
 //#endregion
-export { leaseDir as a, parseLease as c, resolveRoot as d, resolveWorktreeIdentity as f, isOrphanLease as i, readLease as l, envPath as n, leasePath as o, forgetLease as r, listRegistryLeases as s, envFilePath as t, writeLease as u };
+export { leaseDir as a, parseLease as c, resolveRoot as d, resolveWorktreeIdentity as f, STATE_DIRNAME as h, isOrphanLease as i, readLease as l, PASSWORD_SALT_PREFIX as m, envPath as n, leasePath as o, CLI_NAME as p, forgetLease as r, listRegistryLeases as s, envFilePath as t, writeLease as u };
 
-//# sourceMappingURL=lease-BSBBpaR4.mjs.map
+//# sourceMappingURL=lease-DS1SX8U_.mjs.map

package/dist/lease-DS1SX8U_.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease-DS1SX8U_.mjs","names":[],"sources":["../src/core/constants.ts","../src/core/worktree.ts","../src/core/lease.ts"],"sourcesContent":["/**\n * Product identity vs frozen crypto.\n *\n * State dirs follow the CLI name (`.cedarpg`): product-owned, not nested under\n * autopg's `~/.autopg/` (host owns that) and not a generic `.pg` (collision-prone).\n * Password salt is an opaque crypto constant; bump ROLE_PASSWORD_SCHEME to change it.\n */\n\n/** User-facing CLI binary (`package.json` bin) and log prefix */\nexport const CLI_NAME = \"cedarpg\";\n\n/**\n * Worktree-local state dir and home-registry parent (`~/.cedarpg/registry`).\n * Frozen for lease/gc discovery after first alpha consumers appear.\n */\nexport const STATE_DIRNAME = \".cedarpg\";\n\n/**\n * Password scheme v2 salt prefix: sha256(`${PASSWORD_SALT_PREFIX}\\0` + roleName).\n * Opaque; independent of STATE_DIRNAME / CLI_NAME. Bump ROLE_PASSWORD_SCHEME to change.\n */\nexport const PASSWORD_SALT_PREFIX = \"cedar-pg\";\n","import { createHash } from \"node:crypto\";\nimport { existsSync, readFileSync } from \"node:fs\";\nimport { basename, dirname, resolve } from \"node:path\";\nimport { execFileSync } from \"node:child_process\";\n\nexport type WorktreeIdentity = {\n  /** Absolute path to the worktree / project root. */\n  root: string;\n  /** Basename of the git common dir / main checkout (e.g. `cedar`). */\n  repoSlug: string;\n  /** Basename of this worktree directory (e.g. `feat-auth`). */\n  worktreeSlug: string;\n  /** First 8 hex chars of sha256(absolute root). */\n  pathHash: string;\n};\n\nfunction git(args: string[], cwd: string): string | null {\n  try {\n    return execFileSync(\"git\", args, {\n      cwd,\n      encoding: \"utf8\",\n      stdio: [\"ignore\", \"pipe\", \"ignore\"],\n    }).trim();\n  } catch {\n    return null;\n  }\n}\n\nfunction sanitizeSlug(input: string): string {\n  return input\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"_\")\n    .replace(/_+/g, \"_\")\n    .replace(/^_|_$/g, \"\");\n}\n\n/**\n * Resolve the project / worktree root.\n * Explicit `root` wins (app project path). Otherwise prefer git toplevel, then cwd.\n */\nexport function resolveRoot(root?: string): string {\n  if (root) return resolve(root);\n  const start = resolve(process.cwd());\n  const toplevel = git([\"rev-parse\", \"--show-toplevel\"], start);\n  if (toplevel) return toplevel;\n  return start;\n}\n\n/**\n * Identify repo + worktree for observable DB naming.\n */\nexport function resolveWorktreeIdentity(root?: string): WorktreeIdentity {\n  const absRoot = resolveRoot(root);\n  const pathHash = createHash(\"sha256\").update(absRoot).digest(\"hex\").slice(0, 8);\n\n  const commonDir = git([\"rev-parse\", \"--git-common-dir\"], absRoot);\n  let repoSlug = sanitizeSlug(basename(absRoot));\n  if (commonDir) {\n    // common-dir is often `<main>/.git` or an absolute path to the main .git\n    const commonAbs = resolve(absRoot, commonDir);\n    // If commonAbs ends with `.git`, parent is main worktree root\n    const mainRoot = basename(commonAbs) === \".git\" ? dirname(commonAbs) : commonAbs;\n    // For linked worktrees, common-dir may be `.../main/.git`\n    const candidate = basename(mainRoot) === \".git\" ? dirname(mainRoot) : mainRoot;\n    const fromGit = sanitizeSlug(basename(candidate));\n    if (fromGit) repoSlug = fromGit;\n  }\n\n  // Prefer gitdir worktree name when present (`.git` file pointing at worktrees/<name>)\n  let worktreeSlug = sanitizeSlug(basename(absRoot));\n  const gitFile = resolve(absRoot, \".git\");\n  if (existsSync(gitFile)) {\n    try {\n      const content = readFileSync(gitFile, \"utf8\").trim();\n      const match = content.match(/gitdir:\\s*(.+)$/m);\n      if (match?.[1]) {\n        const gitdir = resolve(absRoot, match[1].trim());\n        // .../.git/worktrees/<name>\n        const parts = gitdir.split(/[/\\\\]/);\n        const wtIdx = parts.lastIndexOf(\"worktrees\");\n        if (wtIdx >= 0 && parts[wtIdx + 1]) {\n          const fromWt = sanitizeSlug(parts[wtIdx + 1]!);\n          if (fromWt) worktreeSlug = fromWt;\n        }\n      }\n    } catch {\n      // keep basename slug\n    }\n  }\n\n  if (!repoSlug) repoSlug = \"repo\";\n  if (!worktreeSlug) worktreeSlug = \"wt\";\n\n  return { root: absRoot, repoSlug, worktreeSlug, pathHash };\n}\n","import {\n  existsSync,\n  mkdirSync,\n  readdirSync,\n  readFileSync,\n  renameSync,\n  unlinkSync,\n  writeFileSync,\n} from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { STATE_DIRNAME } from \"./constants.ts\";\nimport type { DbMode } from \"./naming.ts\";\nimport { resolveRoot } from \"./worktree.ts\";\n\nexport type Lease = {\n  schemaVersion: 1;\n  mode: DbMode;\n  root: string;\n  repoSlug: string;\n  worktreeSlug: string;\n  pathHash: string;\n  databaseName: string;\n  roleName: string;\n  port: number;\n  pid: number;\n  createdAt: string;\n};\n\nfunction isDbMode(value: unknown): value is DbMode {\n  return value === \"dev\" || value === \"test\";\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\n/** Narrow-parse a lease; reject incomplete or wrong-version records. */\nexport function parseLease(raw: unknown): Lease | null {\n  if (!raw || typeof raw !== \"object\") return null;\n  const o = raw as Record<string, unknown>;\n  if (o.schemaVersion !== 1) return null;\n  if (!isDbMode(o.mode)) return null;\n  if (!isNonEmptyString(o.root)) return null;\n  if (!isNonEmptyString(o.repoSlug)) return null;\n  if (!isNonEmptyString(o.worktreeSlug)) return null;\n  if (!isNonEmptyString(o.pathHash)) return null;\n  if (!isNonEmptyString(o.databaseName)) return null;\n  if (!isNonEmptyString(o.roleName)) return null;\n  if (typeof o.port !== \"number\") return null;\n  if (typeof o.pid !== \"number\") return null;\n  if (!isNonEmptyString(o.createdAt)) return null;\n  return {\n    schemaVersion: 1,\n    mode: o.mode,\n    root: o.root,\n    repoSlug: o.repoSlug,\n    worktreeSlug: o.worktreeSlug,\n    pathHash: o.pathHash,\n    databaseName: o.databaseName,\n    roleName: o.roleName,\n    port: o.port,\n    pid: o.pid,\n    createdAt: o.createdAt,\n  };\n}\n\nexport function leaseDir(root: string): string {\n  return join(root, STATE_DIRNAME);\n}\n\nexport function leasePath(root: string, mode: DbMode): string {\n  return join(leaseDir(root), `${mode}.json`);\n}\n\nexport function envPath(root: string, mode: DbMode): string {\n  return join(leaseDir(root), `${mode}.env`);\n}\n\n/** Absolute `.cedarpg/<mode>.env` path (resolves root when omitted). */\nexport function envFilePath(root: string | undefined, mode: DbMode): string {\n  return envPath(resolveRoot(root), mode);\n}\n\n/** Best-effort delete worktree lease JSON + mode env (missing is fine). */\nfunction unlinkWorktreeArtifacts(root: string, mode: DbMode): void {\n  for (const file of [leasePath(root, mode), envPath(root, mode)]) {\n    try {\n      unlinkSync(file);\n    } catch {\n      // root or file may already be gone\n    }\n  }\n}\n\n/** Durable registry outside worktrees so GC can find orphans after a checkout is deleted. */\nexport function registryDir(): string {\n  return process.env.CEDAR_PG_REGISTRY_DIR || join(homedir(), STATE_DIRNAME, \"registry\");\n}\n\nfunction registryPath(databaseName: string): string {\n  return join(registryDir(), `${databaseName}.json`);\n}\n\nfunction writeJsonAtomic(file: string, value: unknown): void {\n  mkdirSync(dirname(file), { recursive: true, mode: 0o700 });\n  const tmp = `${file}.tmp.${process.pid}`;\n  writeFileSync(tmp, `${JSON.stringify(value, null, 2)}\\n`, { mode: 0o600 });\n  renameSync(tmp, file);\n}\n\nfunction registerLease(lease: Lease): void {\n  writeJsonAtomic(registryPath(lease.databaseName), lease);\n}\n\nfunction unregisterLease(databaseName: string): void {\n  try {\n    unlinkSync(registryPath(databaseName));\n  } catch {\n    // missing is fine\n  }\n}\n\nfunction peekDatabaseName(root: string, mode: DbMode): string | undefined {\n  const file = leasePath(root, mode);\n  if (!existsSync(file)) return undefined;\n  try {\n    const raw = JSON.parse(readFileSync(file, \"utf8\")) as { databaseName?: unknown };\n    return typeof raw.databaseName === \"string\" && raw.databaseName ? raw.databaseName : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function readLease(root: string, mode: DbMode): Lease | null {\n  const file = leasePath(root, mode);\n  if (!existsSync(file)) return null;\n  try {\n    return parseLease(JSON.parse(readFileSync(file, \"utf8\")));\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Persist lease. Registry is written first (GC source of truth), then the worktree cache.\n */\nexport function writeLease(lease: Lease): void {\n  registerLease(lease);\n  const dir = leaseDir(lease.root);\n  mkdirSync(dir, { recursive: true, mode: 0o700 });\n  writeJsonAtomic(leasePath(lease.root, lease.mode), lease);\n}\n\n/**\n * Remove registry entry by databaseName and best-effort delete worktree lease + env.\n * Call only after a successful DROP (or when intentionally abandoning tracking).\n */\nexport function forgetLease(lease: Pick<Lease, \"root\" | \"mode\" | \"databaseName\">): void {\n  unregisterLease(lease.databaseName);\n  unlinkWorktreeArtifacts(lease.root, lease.mode);\n}\n\n/**\n * Clear worktree lease + env + registry. Unregisters by databaseName even when the local\n * file fails full parse (peeks databaseName from raw JSON).\n */\nexport function clearLease(root: string, mode: DbMode): void {\n  const existing = readLease(root, mode);\n  if (existing) {\n    forgetLease(existing);\n    return;\n  }\n  const databaseName = peekDatabaseName(root, mode);\n  unlinkWorktreeArtifacts(root, mode);\n  if (databaseName) {\n    unregisterLease(databaseName);\n  }\n}\n\n/** All registry entries (used by gc). */\nexport function listRegistryLeases(): Lease[] {\n  const dir = registryDir();\n  if (!existsSync(dir)) return [];\n  const out: Lease[] = [];\n  for (const name of readdirSync(dir)) {\n    if (!name.endsWith(\".json\")) continue;\n    try {\n      const lease = parseLease(JSON.parse(readFileSync(join(dir, name), \"utf8\")));\n      if (lease) out.push(lease);\n    } catch {\n      // skip corrupt\n    }\n  }\n  return out;\n}\n\nexport function isOrphanLease(lease: Lease): boolean {\n  return !existsSync(lease.root);\n}\n"],"mappings":"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"}