@storyshelf/core 0.6.2 → 0.8.0

package/dist/models/build-review.mjs

@@ -0,0 +1,53 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { ulid } from "../utils/ulid.mjs";
+import { col } from "./columns.mjs";
+import { latestVerdicts } from "./build-review-status.mjs";
+import { asc, eq } from "drizzle-orm";
+// src/models/build-review.ts
+/** Build-level review verdicts (ADR 0013, decision 3). */
+/** Data operations for the verdicts reviewers give a build. */
+var BuildReviewModel = class {
+	#db;
+	#table;
+	constructor(db, tables) {
+		this.#db = db;
+		this.#table = (tables ?? { buildReviews: db.tables.buildReviews }).buildReviews;
+	}
+	/**
+	* Record a verdict. A reviewer rewrites theirs by adding another row; the newest row counts.
+	* `createdAt` is strictly increasing within a build, so "newest" never ties.
+	*/
+	async add(buildId, userId, verdict, body) {
+		const newest = (await this.listByBuild(buildId)).at(-1)?.createdAt;
+		return await this.#db.insert(this.#table, {
+			id: ulid(),
+			buildId,
+			userId,
+			verdict,
+			body: body === void 0 || body.length === 0 ? null : body,
+			createdAt: after(newest)
+		});
+	}
+	/** Every verdict of a build, oldest first. */
+	async listByBuild(buildId) {
+		return (await this.#db.list(this.#table, {
+			where: eq(col(this.#table, "buildId"), buildId),
+			orderBy: asc(col(this.#table, "createdAt"))
+		})).toSorted((a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id));
+	}
+	/** Each reviewer's latest verdict on a build. */
+	async latestByBuild(buildId) {
+		return latestVerdicts(await this.listByBuild(buildId));
+	}
+};
+/** Now, or one millisecond past `newest` when the clock has not moved on. */
+function after(newest) {
+	const now = Date.now();
+	const floor = newest === void 0 ? Number.NEGATIVE_INFINITY : Date.parse(newest) + 1;
+	return new Date(Math.max(now, floor)).toISOString();
+}
+export { BuildReviewModel };
+
+//# sourceMappingURL=build-review.mjs.map

package/dist/models/build-review.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-review.mjs","names":[],"sources":["../../src/models/build-review.ts"],"sourcesContent":["/** Build-level review verdicts (ADR 0013, decision 3). */\nimport { asc, eq } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { BuildReview } from \"../schema/build-review.ts\";\nimport type { ReviewVerdict } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { latestVerdicts } from \"./build-review-status.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildReviewModel}. */\nexport interface BuildReviewTables {\n  buildReviews: Table;\n}\n\n/** Data operations for the verdicts reviewers give a build. */\nexport class BuildReviewModel {\n  readonly #db: DatabaseAdapter;\n  readonly #table: Table;\n\n  constructor(db: DatabaseAdapter, tables?: BuildReviewTables) {\n    this.#db = db;\n    this.#table = (tables ?? { buildReviews: db.tables.buildReviews }).buildReviews;\n  }\n\n  /**\n   * Record a verdict. A reviewer rewrites theirs by adding another row; the newest row counts.\n   * `createdAt` is strictly increasing within a build, so \"newest\" never ties.\n   */\n  async add(\n    buildId: string,\n    userId: string | null,\n    verdict: ReviewVerdict,\n    body?: string,\n  ): Promise<BuildReview> {\n    const newest = (await this.listByBuild(buildId)).at(-1)?.createdAt;\n    return (await this.#db.insert(this.#table, {\n      id: ulid(),\n      buildId,\n      userId,\n      verdict,\n      body: body === undefined || body.length === 0 ? null : body,\n      createdAt: after(newest),\n    })) as unknown as BuildReview;\n  }\n\n  /** Every verdict of a build, oldest first. */\n  async listByBuild(buildId: string): Promise<BuildReview[]> {\n    const rows = (await this.#db.list(this.#table, {\n      where: eq(col(this.#table, \"buildId\"), buildId),\n      orderBy: asc(col(this.#table, \"createdAt\")),\n    })) as unknown as BuildReview[];\n    return rows.toSorted(\n      (a, b) => a.createdAt.localeCompare(b.createdAt) || a.id.localeCompare(b.id),\n    );\n  }\n\n  /** Each reviewer's latest verdict on a build. */\n  async latestByBuild(buildId: string): Promise<BuildReview[]> {\n    return latestVerdicts(await this.listByBuild(buildId));\n  }\n}\n\n/** Now, or one millisecond past `newest` when the clock has not moved on. */\nfunction after(newest: string | undefined): string {\n  const now = Date.now();\n  const floor = newest === undefined ? Number.NEGATIVE_INFINITY : Date.parse(newest) + 1;\n  return new Date(Math.max(now, floor)).toISOString();\n}\n"],"mappings":";;;;;;;;;;AAgBA,IAAa,mBAAb,MAA8B;CAC5B;CACA;CAEA,YAAY,IAAqB,QAA4B;EAC3D,KAAK,MAAM;EACX,KAAK,UAAU,UAAU,EAAE,cAAc,GAAG,OAAO,aAAa,EAAA,CAAG;CACrE;;;;;CAMA,MAAM,IACJ,SACA,QACA,SACA,MACsB;EACtB,MAAM,UAAU,MAAM,KAAK,YAAY,OAAO,EAAA,CAAG,GAAG,EAAE,CAAC,EAAE;EACzD,OAAQ,MAAM,KAAK,IAAI,OAAO,KAAK,QAAQ;GACzC,IAAI,KAAK;GACT;GACA;GACA;GACA,MAAM,SAAS,KAAA,KAAa,KAAK,WAAW,IAAI,OAAO;GACvD,WAAW,MAAM,MAAM;EACzB,CAAC;CACH;;CAGA,MAAM,YAAY,SAAyC;EAKzD,QAAO,MAJa,KAAK,IAAI,KAAK,KAAK,QAAQ;GAC7C,OAAO,GAAG,IAAI,KAAK,QAAQ,SAAS,GAAG,OAAO;GAC9C,SAAS,IAAI,IAAI,KAAK,QAAQ,WAAW,CAAC;EAC5C,CAAC,EAAA,CACW,UACT,GAAG,MAAM,EAAE,UAAU,cAAc,EAAE,SAAS,KAAK,EAAE,GAAG,cAAc,EAAE,EAAE,CAC7E;CACF;;CAGA,MAAM,cAAc,SAAyC;EAC3D,OAAO,eAAe,MAAM,KAAK,YAAY,OAAO,CAAC;CACvD;AACF;;AAGA,SAAS,MAAM,QAAoC;CACjD,MAAM,MAAM,KAAK,IAAI;CACrB,MAAM,QAAQ,WAAW,KAAA,IAAY,OAAO,oBAAoB,KAAK,MAAM,MAAM,IAAI;CACrF,OAAO,IAAI,KAAK,KAAK,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,YAAY;AACpD"}

package/dist/models/build.d.mts

@@ -1,10 +1,10 @@
 import __tsdown_shims_path from 'node:path';
 import __tsdown_shims_url from 'node:url';
+import { Logger } from "../logger.mjs";
 import { DatabaseAdapter } from "../adapter/database.mjs";
 import { BuildStatus } from "../types.mjs";
 import { Build } from "../schema/build.mjs";
 import { Table } from "drizzle-orm";
-//#region src/models/build.d.ts
 /** Tables required by {@link BuildModel}. */
 interface BuildTables {
   builds: Table;
@@ -13,9 +13,11 @@ interface BuildTables {
 }
 /** Data operations for build records. */
 declare class BuildModel {
-  private readonly db;
   private readonly tables;
-  constructor(db: DatabaseAdapter, tables?: BuildTables);
+  private readonly db;
+  private readonly logger;
+  /** `logger` only reports a status write refused by a `cancelled` build, at debug. */
+  constructor(db: DatabaseAdapter, tables?: BuildTables, logger?: Logger);
   create(projectId: string, input: BuildCreateInput): Promise<Build>;
   get(id: string): Promise<Build | null>;
   list(projectId: string, filter?: BuildListFilter): Promise<Build[]>;
@@ -30,13 +32,30 @@ declare class BuildModel {
     id: string;
     gitDefaultBranch: string;
   }): Promise<Build | null>;
-  update(id: string, patch: Partial<Pick<Build, "status" | "public" | "message" | "authorEmail" | "authorName">>): Promise<Build>;
+  /**
+   * Patch a build. A `cancelled` build is terminal (ADR 0006): a patch that carries another status
+   * is refused, the row is returned as it is, so a capture that ends after a cancel cannot move
+   * the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.
+   */
+  update(id: string, patch: Partial<Pick<Build, "status" | "public" | "message" | "authorEmail" | "authorName">>, options?: {
+    reset?: boolean;
+  }): Promise<Build>;
   setStatus(id: string, status: BuildStatus): Promise<Build>;
+  /**
+   * Put a finished build back to `status` for a retry. The one write that leaves `cancelled`
+   * (a user chose it), so it skips the terminal guard of {@link BuildModel.update}.
+   */
+  resetStatus(id: string, status: BuildStatus): Promise<Build>;
   /**
    * Record the affected-capture computation for a build. Idempotent: the CLI
    * posts this once after creating the build and before uploading the bundle.
    */
   setAffected(id: string, input: AffectedComputation): Promise<Build>;
+  /**
+   * Store the results of the build's `.test()` entries (`TestResult[]`, as JSON), or clear them
+   * with null. Written once per capture run, by the run that ran the tests.
+   */
+  setTestResults(id: string, results: readonly unknown[] | null): Promise<Build>;
   /**
    * Parse a build's affected import paths. Returns `null` for full capture
    * (no computation, or an unreadable payload) — callers render everything.
@@ -81,7 +100,8 @@ interface BuildListFilter {
   branch?: string;
   labelKey?: string;
   labelValue?: string;
+  /** Newest builds to return at most. */
+  limit?: number;
 }
-//#endregion
 export { AffectedComputation, BuildCreateInput, BuildListFilter, BuildModel, BuildTables, isPublicBuild };
 //# sourceMappingURL=build.d.mts.map

package/dist/models/build.mjs

@@ -2,15 +2,19 @@ import "node:path";
 import "node:url";
 import.meta.url;
 import { ulid } from "../utils/ulid.mjs";
-import { and, desc, eq, getTableColumns, inArray } from "drizzle-orm";
-//#region src/models/build.ts
+import { col } from "./columns.mjs";
+import { and, desc, eq, inArray, ne } from "drizzle-orm";
+// src/models/build.ts
 /** Build records, status transitions, and publication helpers. */
 /** Data operations for build records. */
 var BuildModel = class {
-	db;
 	tables;
-	constructor(db, tables) {
+	db;
+	logger;
+	/** `logger` only reports a status write refused by a `cancelled` build, at debug. */
+	constructor(db, tables, logger) {
 		this.db = db;
+		this.logger = logger;
 		this.tables = tables ?? {
 			builds: db.tables.builds,
 			buildLabels: db.tables.buildLabels,
@@ -42,17 +46,18 @@ var BuildModel = class {
 		return await this.db.get(this.tables.builds, id);
 	}
 	async list(projectId, filter = {}) {
-		const conditions = [eq(getTableColumns(this.tables.builds)["projectId"], projectId)];
-		if (filter.status) conditions.push(eq(getTableColumns(this.tables.builds)["status"], filter.status));
-		if (filter.branch) conditions.push(eq(getTableColumns(this.tables.builds)["gitBranch"], filter.branch));
+		const conditions = [eq(col(this.tables.builds, "projectId"), projectId)];
+		if (filter.status) conditions.push(eq(col(this.tables.builds, "status"), filter.status));
+		if (filter.branch) conditions.push(eq(col(this.tables.builds, "gitBranch"), filter.branch));
 		if (filter.labelKey && filter.labelValue) {
-			const ids = (await this.db.list(this.tables.buildLabels, { where: and(eq(getTableColumns(this.tables.buildLabels)["projectId"], projectId), eq(getTableColumns(this.tables.buildLabels)["typeKey"], filter.labelKey), eq(getTableColumns(this.tables.buildLabels)["value"], filter.labelValue)) })).map((l) => l.buildId);
+			const ids = (await this.db.list(this.tables.buildLabels, { where: and(eq(col(this.tables.buildLabels, "projectId"), projectId), eq(col(this.tables.buildLabels, "typeKey"), filter.labelKey), eq(col(this.tables.buildLabels, "value"), filter.labelValue)) })).map((l) => l.buildId);
 			if (ids.length === 0) return [];
-			conditions.push(inArray(getTableColumns(this.tables.builds)["id"], ids));
+			conditions.push(inArray(col(this.tables.builds, "id"), ids));
 		}
 		return await this.db.list(this.tables.builds, {
 			where: and(...conditions),
-			orderBy: desc(getTableColumns(this.tables.builds)["createdAt"])
+			orderBy: desc(col(this.tables.builds, "createdAt")),
+			...filter.limit === void 0 ? {} : { limit: filter.limit }
 		});
 	}
 	/**
@@ -68,16 +73,38 @@ var BuildModel = class {
 			status: "approved"
 		}))[0] ?? null;
 	}
-	async update(id, patch) {
-		return await this.db.update(this.tables.builds, id, {
+	/**
+	* Patch a build. A `cancelled` build is terminal (ADR 0006): a patch that carries another status
+	* is refused, the row is returned as it is, so a capture that ends after a cancel cannot move
+	* the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.
+	*/
+	async update(id, patch, options = {}) {
+		const values = {
 			...patch,
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
-		});
+		};
+		if (patch.status !== void 0 && patch.status !== "cancelled" && options.reset !== true) {
+			const current = await this.db.updateWhere(this.tables.builds, id, values, ne(col(this.tables.builds, "status"), "cancelled"));
+			if (!current) throw new Error("Build not found");
+			if (current.status === "cancelled") this.logger?.debug({
+				buildId: id,
+				refused: patch.status
+			}, "build is cancelled; status write refused");
+			return current;
+		}
+		return await this.db.update(this.tables.builds, id, values);
 	}
 	async setStatus(id, status) {
 		return await this.update(id, { status });
 	}
 	/**
+	* Put a finished build back to `status` for a retry. The one write that leaves `cancelled`
+	* (a user chose it), so it skips the terminal guard of {@link BuildModel.update}.
+	*/
+	async resetStatus(id, status) {
+		return await this.update(id, { status }, { reset: true });
+	}
+	/**
 	* Record the affected-capture computation for a build. Idempotent: the CLI
 	* posts this once after creating the build and before uploading the bundle.
 	*/
@@ -90,6 +117,16 @@ var BuildModel = class {
 		});
 	}
 	/**
+	* Store the results of the build's `.test()` entries (`TestResult[]`, as JSON), or clear them
+	* with null. Written once per capture run, by the run that ran the tests.
+	*/
+	async setTestResults(id, results) {
+		return await this.db.update(this.tables.builds, id, {
+			testResults: results === null ? null : JSON.stringify(results),
+			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+		});
+	}
+	/**
 	* Parse a build's affected import paths. Returns `null` for full capture
 	* (no computation, or an unreadable payload) — callers render everything.
 	*/
@@ -97,16 +134,18 @@ var BuildModel = class {
 		return parsePaths(build.affectedImportPaths);
 	}
 	async updateCounts(id) {
-		const rows = await this.db.list(this.tables.snapshots, { where: eq(getTableColumns(this.tables.snapshots)["buildId"], id) });
+		const rows = await this.db.list(this.tables.snapshots, { where: eq(col(this.tables.snapshots, "buildId"), id) });
 		const snapshotCount = rows.length;
 		const changedCount = rows.filter((s) => s.status === "changed" || s.status === "new").length;
 		const approvedCount = rows.filter((s) => s.status === "approved" || s.status === "unchanged").length;
 		const rejectedCount = rows.filter((s) => s.status === "rejected").length;
+		const inheritedCount = rows.filter((s) => s.inherited).length;
 		return await this.db.update(this.tables.builds, id, {
 			snapshotCount,
 			changedCount,
 			approvedCount,
 			rejectedCount,
+			inheritedCount,
 			updatedAt: (/* @__PURE__ */ new Date()).toISOString()
 		});
 	}
@@ -141,7 +180,6 @@ function parsePaths(raw) {
 		return null;
 	}
 }
-//#endregion
 export { BuildModel, isPublicBuild };
 
 //# sourceMappingURL=build.mjs.map

package/dist/models/build.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.mjs","names":[],"sources":["../../src/models/build.ts"],"sourcesContent":["/** Build records, status transitions, and publication helpers. */\nimport { and, desc, eq, getTableColumns, inArray } from \"drizzle-orm\";\nimport type { SQLWrapper, Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { BuildStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\n\n/** Tables required by {@link BuildModel}. */\nexport interface BuildTables {\n  builds: Table;\n  buildLabels: Table;\n  snapshots: Table;\n}\n\n/** Data operations for build records. */\nexport class BuildModel {\n  private readonly tables: BuildTables;\n  constructor(\n    private readonly db: DatabaseAdapter,\n    tables?: BuildTables,\n  ) {\n    this.tables = tables ?? {\n      builds: db.tables.builds,\n      buildLabels: db.tables.buildLabels,\n      snapshots: db.tables.snapshots,\n    };\n  }\n\n  async create(projectId: string, input: BuildCreateInput): Promise<Build> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.builds, {\n      id: ulid(),\n      projectId,\n      gitSha: input.gitSha,\n      gitBranch: input.gitBranch,\n      isDefault: input.isDefault ?? false,\n      authorEmail: input.authorEmail,\n      authorName: input.authorName,\n      message: input.message,\n      public: input.public ?? false,\n      affectedOnly: input.affectedOnly ?? true,\n      baselineSha: input.baselineSha ?? null,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Build;\n  }\n\n  async get(id: string): Promise<Build | null> {\n    return (await this.db.get(this.tables.builds, id)) as unknown as Build | null;\n  }\n\n  async list(projectId: string, filter: BuildListFilter = {}): Promise<Build[]> {\n    const conditions = [\n      eq(getTableColumns(this.tables.builds)[\"projectId\"] as unknown as SQLWrapper, projectId),\n    ];\n    if (filter.status) {\n      conditions.push(\n        eq(getTableColumns(this.tables.builds)[\"status\"] as unknown as SQLWrapper, filter.status),\n      );\n    }\n    if (filter.branch) {\n      conditions.push(\n        eq(\n          getTableColumns(this.tables.builds)[\"gitBranch\"] as unknown as SQLWrapper,\n          filter.branch,\n        ),\n      );\n    }\n    if (filter.labelKey && filter.labelValue) {\n      const labels = (await this.db.list(this.tables.buildLabels, {\n        where: and(\n          eq(\n            getTableColumns(this.tables.buildLabels)[\"projectId\"] as unknown as SQLWrapper,\n            projectId,\n          ),\n          eq(\n            getTableColumns(this.tables.buildLabels)[\"typeKey\"] as unknown as SQLWrapper,\n            filter.labelKey,\n          ),\n          eq(\n            getTableColumns(this.tables.buildLabels)[\"value\"] as unknown as SQLWrapper,\n            filter.labelValue,\n          ),\n        ),\n      })) as unknown as { buildId: string }[];\n      const ids = labels.map((l) => l.buildId);\n      if (ids.length === 0) {\n        return [];\n      }\n      conditions.push(\n        inArray(getTableColumns(this.tables.builds)[\"id\"] as unknown as SQLWrapper, ids),\n      );\n    }\n    return (await this.db.list(this.tables.builds, {\n      where: and(...conditions),\n      orderBy: desc(getTableColumns(this.tables.builds)[\"createdAt\"] as unknown as SQLWrapper),\n    })) as unknown as Build[];\n  }\n\n  /**\n   * Return the build a project-slug Storybook link resolves to: the most recent\n   * `approved` build on the project's default branch. Approved builds on other\n   * branches never qualify (their PR can still be dismissed), and neither do\n   * pending, failed, or unreviewed default-branch builds. Visibility (public or\n   * authenticated) is checked separately by the caller.\n   */\n  async latestApprovedDefault(project: {\n    id: string;\n    gitDefaultBranch: string;\n  }): Promise<Build | null> {\n    const rows = await this.list(project.id, {\n      branch: project.gitDefaultBranch,\n      status: \"approved\",\n    });\n    return rows[0] ?? null;\n  }\n\n  async update(\n    id: string,\n    patch: Partial<Pick<Build, \"status\" | \"public\" | \"message\" | \"authorEmail\" | \"authorName\">>,\n  ): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      ...patch,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  async setStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status });\n  }\n\n  /**\n   * Record the affected-capture computation for a build. Idempotent: the CLI\n   * posts this once after creating the build and before uploading the bundle.\n   */\n  async setAffected(id: string, input: AffectedComputation): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      baselineSha: input.baselineSha,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Parse a build's affected import paths. Returns `null` for full capture\n   * (no computation, or an unreadable payload) — callers render everything.\n   */\n  static affectedPaths(build: Pick<Build, \"affectedImportPaths\">): string[] | null {\n    return parsePaths(build.affectedImportPaths);\n  }\n\n  async updateCounts(id: string): Promise<Build> {\n    const rows = (await this.db.list(this.tables.snapshots, {\n      where: eq(getTableColumns(this.tables.snapshots)[\"buildId\"] as unknown as SQLWrapper, id),\n    })) as unknown as { status: string }[];\n    const snapshotCount = rows.length;\n    const changedCount = rows.filter((s) => s.status === \"changed\" || s.status === \"new\").length;\n    const approvedCount = rows.filter(\n      (s) => s.status === \"approved\" || s.status === \"unchanged\",\n    ).length;\n    const rejectedCount = rows.filter((s) => s.status === \"rejected\").length;\n    return (await this.db.update(this.tables.builds, id, {\n      snapshotCount,\n      changedCount,\n      approvedCount,\n      rejectedCount,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  async remove(id: string): Promise<void> {\n    await this.db.remove(this.tables.builds, id);\n  }\n}\n\n/**\n * Return whether a build is publicly viewable without a session.\n *\n * A build is public iff `builds.public` is set or its branch matches the\n * project's `public_branch_regex` (ADR 0011). Supplying an empty/nonexistent\n * regex makes every build require auth.\n */\nexport function isPublicBuild(\n  project: { publicBranchRegex: string | null },\n  build: Pick<Build, \"public\" | \"gitBranch\">,\n): boolean {\n  if (build.public) {\n    return true;\n  }\n  if (!project.publicBranchRegex) {\n    return false;\n  }\n  return new RegExp(project.publicBranchRegex, \"u\").test(build.gitBranch);\n}\n\n/** Input for creating a build. */\nexport interface BuildCreateInput {\n  gitSha: string;\n  gitBranch: string;\n  isDefault?: boolean;\n  authorEmail?: string;\n  authorName?: string;\n  message?: string;\n  public?: boolean;\n  affectedOnly?: boolean;\n  baselineSha?: string | null;\n  changedFiles?: string[] | null;\n  affectedImportPaths?: string[] | null;\n}\n\n/** Affected-capture computation posted after build creation. */\nexport interface AffectedComputation {\n  baselineSha: string | null;\n  changedFiles: string[];\n  affectedImportPaths: string[] | null;\n}\n\n/** Serialize an optional path list to its JSON text form (or null). */\nfunction serializePaths(paths: string[] | null | undefined): string | null {\n  if (!paths) {\n    return null;\n  }\n  return JSON.stringify(paths);\n}\n\n/** Parse a JSON path list; null (full capture) on missing/invalid input. */\nfunction parsePaths(raw: string | null): string[] | null {\n  if (!raw) {\n    return null;\n  }\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return Array.isArray(parsed) && parsed.every((entry) => typeof entry === \"string\")\n      ? (parsed as string[])\n      : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Filter options for listing builds. */\nexport interface BuildListFilter {\n  status?: BuildStatus;\n  branch?: string;\n  labelKey?: string;\n  labelValue?: string;\n}\n"],"mappings":"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"}
+{"version":3,"file":"build.mjs","names":[],"sources":["../../src/models/build.ts"],"sourcesContent":["/** Build records, status transitions, and publication helpers. */\nimport { and, desc, eq, inArray, ne } from \"drizzle-orm\";\nimport type { Table } from \"drizzle-orm\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { Logger } from \"../logger.ts\";\nimport type { Build } from \"../schema/build.ts\";\nimport type { BuildStatus } from \"../types.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link BuildModel}. */\nexport interface BuildTables {\n  builds: Table;\n  buildLabels: Table;\n  snapshots: Table;\n}\n\n/** Data operations for build records. */\nexport class BuildModel {\n  private readonly tables: BuildTables;\n  private readonly db: DatabaseAdapter;\n  private readonly logger: Logger | undefined;\n\n  /** `logger` only reports a status write refused by a `cancelled` build, at debug. */\n  constructor(db: DatabaseAdapter, tables?: BuildTables, logger?: Logger) {\n    this.db = db;\n    this.logger = logger;\n    this.tables = tables ?? {\n      builds: db.tables.builds,\n      buildLabels: db.tables.buildLabels,\n      snapshots: db.tables.snapshots,\n    };\n  }\n\n  async create(projectId: string, input: BuildCreateInput): Promise<Build> {\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.builds, {\n      id: ulid(),\n      projectId,\n      gitSha: input.gitSha,\n      gitBranch: input.gitBranch,\n      isDefault: input.isDefault ?? false,\n      authorEmail: input.authorEmail,\n      authorName: input.authorName,\n      message: input.message,\n      public: input.public ?? false,\n      affectedOnly: input.affectedOnly ?? true,\n      baselineSha: input.baselineSha ?? null,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      status: \"pending\",\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as Build;\n  }\n\n  async get(id: string): Promise<Build | null> {\n    return (await this.db.get(this.tables.builds, id)) as unknown as Build | null;\n  }\n\n  async list(projectId: string, filter: BuildListFilter = {}): Promise<Build[]> {\n    const conditions = [eq(col(this.tables.builds, \"projectId\"), projectId)];\n    if (filter.status) {\n      conditions.push(eq(col(this.tables.builds, \"status\"), filter.status));\n    }\n    if (filter.branch) {\n      conditions.push(eq(col(this.tables.builds, \"gitBranch\"), filter.branch));\n    }\n    if (filter.labelKey && filter.labelValue) {\n      const labels = (await this.db.list(this.tables.buildLabels, {\n        where: and(\n          eq(col(this.tables.buildLabels, \"projectId\"), projectId),\n          eq(col(this.tables.buildLabels, \"typeKey\"), filter.labelKey),\n          eq(col(this.tables.buildLabels, \"value\"), filter.labelValue),\n        ),\n      })) as unknown as { buildId: string }[];\n      const ids = labels.map((l) => l.buildId);\n      if (ids.length === 0) {\n        return [];\n      }\n      conditions.push(inArray(col(this.tables.builds, \"id\"), ids));\n    }\n    return (await this.db.list(this.tables.builds, {\n      where: and(...conditions),\n      orderBy: desc(col(this.tables.builds, \"createdAt\")),\n      ...(filter.limit === undefined ? {} : { limit: filter.limit }),\n    })) as unknown as Build[];\n  }\n\n  /**\n   * Return the build a project-slug Storybook link resolves to: the most recent\n   * `approved` build on the project's default branch. Approved builds on other\n   * branches never qualify (their PR can still be dismissed), and neither do\n   * pending, failed, or unreviewed default-branch builds. Visibility (public or\n   * authenticated) is checked separately by the caller.\n   */\n  async latestApprovedDefault(project: {\n    id: string;\n    gitDefaultBranch: string;\n  }): Promise<Build | null> {\n    const rows = await this.list(project.id, {\n      branch: project.gitDefaultBranch,\n      status: \"approved\",\n    });\n    return rows[0] ?? null;\n  }\n\n  /**\n   * Patch a build. A `cancelled` build is terminal (ADR 0006): a patch that carries another status\n   * is refused, the row is returned as it is, so a capture that ends after a cancel cannot move\n   * the build. Only {@link BuildModel.resetStatus} leaves `cancelled`.\n   */\n  async update(\n    id: string,\n    patch: Partial<Pick<Build, \"status\" | \"public\" | \"message\" | \"authorEmail\" | \"authorName\">>,\n    options: { reset?: boolean } = {},\n  ): Promise<Build> {\n    const values = { ...patch, updatedAt: new Date().toISOString() };\n    if (patch.status !== undefined && patch.status !== \"cancelled\" && options.reset !== true) {\n      const current = (await this.db.updateWhere(\n        this.tables.builds,\n        id,\n        values,\n        ne(col(this.tables.builds, \"status\"), \"cancelled\"),\n      )) as unknown as Build | null;\n      if (!current) throw new Error(\"Build not found\");\n      if (current.status === \"cancelled\") {\n        this.logger?.debug(\n          { buildId: id, refused: patch.status },\n          \"build is cancelled; status write refused\",\n        );\n      }\n      return current;\n    }\n    return (await this.db.update(this.tables.builds, id, values)) as unknown as Build;\n  }\n\n  async setStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status });\n  }\n\n  /**\n   * Put a finished build back to `status` for a retry. The one write that leaves `cancelled`\n   * (a user chose it), so it skips the terminal guard of {@link BuildModel.update}.\n   */\n  async resetStatus(id: string, status: BuildStatus): Promise<Build> {\n    return await this.update(id, { status }, { reset: true });\n  }\n\n  /**\n   * Record the affected-capture computation for a build. Idempotent: the CLI\n   * posts this once after creating the build and before uploading the bundle.\n   */\n  async setAffected(id: string, input: AffectedComputation): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      baselineSha: input.baselineSha,\n      changedFiles: serializePaths(input.changedFiles),\n      affectedImportPaths: serializePaths(input.affectedImportPaths),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Store the results of the build's `.test()` entries (`TestResult[]`, as JSON), or clear them\n   * with null. Written once per capture run, by the run that ran the tests.\n   */\n  async setTestResults(id: string, results: readonly unknown[] | null): Promise<Build> {\n    return (await this.db.update(this.tables.builds, id, {\n      testResults: results === null ? null : JSON.stringify(results),\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  /**\n   * Parse a build's affected import paths. Returns `null` for full capture\n   * (no computation, or an unreadable payload) — callers render everything.\n   */\n  static affectedPaths(build: Pick<Build, \"affectedImportPaths\">): string[] | null {\n    return parsePaths(build.affectedImportPaths);\n  }\n\n  async updateCounts(id: string): Promise<Build> {\n    const rows = (await this.db.list(this.tables.snapshots, {\n      where: eq(col(this.tables.snapshots, \"buildId\"), id),\n    })) as unknown as { status: string; inherited: boolean }[];\n    const snapshotCount = rows.length;\n    const changedCount = rows.filter((s) => s.status === \"changed\" || s.status === \"new\").length;\n    const approvedCount = rows.filter(\n      (s) => s.status === \"approved\" || s.status === \"unchanged\",\n    ).length;\n    const rejectedCount = rows.filter((s) => s.status === \"rejected\").length;\n    const inheritedCount = rows.filter((s) => s.inherited).length;\n    return (await this.db.update(this.tables.builds, id, {\n      snapshotCount,\n      changedCount,\n      approvedCount,\n      rejectedCount,\n      inheritedCount,\n      updatedAt: new Date().toISOString(),\n    })) as unknown as Build;\n  }\n\n  async remove(id: string): Promise<void> {\n    await this.db.remove(this.tables.builds, id);\n  }\n}\n\n/**\n * Return whether a build is publicly viewable without a session.\n *\n * A build is public iff `builds.public` is set or its branch matches the\n * project's `public_branch_regex` (ADR 0011). Supplying an empty/nonexistent\n * regex makes every build require auth.\n */\nexport function isPublicBuild(\n  project: { publicBranchRegex: string | null },\n  build: Pick<Build, \"public\" | \"gitBranch\">,\n): boolean {\n  if (build.public) {\n    return true;\n  }\n  if (!project.publicBranchRegex) {\n    return false;\n  }\n  return new RegExp(project.publicBranchRegex, \"u\").test(build.gitBranch);\n}\n\n/** Input for creating a build. */\nexport interface BuildCreateInput {\n  gitSha: string;\n  gitBranch: string;\n  isDefault?: boolean;\n  authorEmail?: string;\n  authorName?: string;\n  message?: string;\n  public?: boolean;\n  affectedOnly?: boolean;\n  baselineSha?: string | null;\n  changedFiles?: string[] | null;\n  affectedImportPaths?: string[] | null;\n}\n\n/** Affected-capture computation posted after build creation. */\nexport interface AffectedComputation {\n  baselineSha: string | null;\n  changedFiles: string[];\n  affectedImportPaths: string[] | null;\n}\n\n/** Serialize an optional path list to its JSON text form (or null). */\nfunction serializePaths(paths: string[] | null | undefined): string | null {\n  if (!paths) {\n    return null;\n  }\n  return JSON.stringify(paths);\n}\n\n/** Parse a JSON path list; null (full capture) on missing/invalid input. */\nfunction parsePaths(raw: string | null): string[] | null {\n  if (!raw) {\n    return null;\n  }\n  try {\n    const parsed: unknown = JSON.parse(raw);\n    return Array.isArray(parsed) && parsed.every((entry) => typeof entry === \"string\")\n      ? (parsed as string[])\n      : null;\n  } catch {\n    return null;\n  }\n}\n\n/** Filter options for listing builds. */\nexport interface BuildListFilter {\n  status?: BuildStatus;\n  branch?: string;\n  labelKey?: string;\n  labelValue?: string;\n  /** Newest builds to return at most. */\n  limit?: number;\n}\n"],"mappings":"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"}

package/dist/models/capture-attempt.d.mts

@@ -5,15 +5,15 @@ import { JobStatus } from "../adapter/capture-queue.mjs";
 import { CaptureAttempt, CaptureLogLevel } from "../schema/capture-attempt.mjs";
 import { Logger } from "pino";
 import { Table } from "drizzle-orm";
-//#region src/models/capture-attempt.d.ts
 /** Tables required by {@link CaptureAttemptModel}. */
 interface CaptureAttemptTables {
   captureAttempts: Table;
 }
 /** Data operations for capture attempts (one row per build run). */
 declare class CaptureAttemptModel {
-  private readonly db;
+  #private;
   private readonly tables;
+  private readonly db;
   constructor(db: DatabaseAdapter, tables?: CaptureAttemptTables);
   listByBuild(buildId: string): Promise<CaptureAttempt[]>;
   getByNo(buildId: string, attemptNo: number): Promise<CaptureAttempt | null>;
@@ -23,6 +23,11 @@ declare class CaptureAttemptModel {
     storyCount: number;
     failedCount: number;
   }): Promise<CaptureAttempt>;
+  /**
+   * Close every attempt of a build still `queued` or `running` other than `keepId`, as `cancelled`
+   * with `reason`: a new plan of the build supersedes them, and nothing else would ever close them.
+   */
+  closeOthers(buildId: string, keepId: string | null, reason: string): Promise<number>;
 }
 /**
  * Recorder writing one attempt log line to the `capture_logs` table.
@@ -35,6 +40,5 @@ type AttemptLogRecorder = (level: CaptureLogLevel, message: string, fields?: unk
  * Log-write failures are reported through pino and never thrown.
  */
 declare function emitAttemptLog(record: AttemptLogRecorder | undefined, logger: Logger | undefined, level: CaptureLogLevel, message: string, fields?: unknown): Promise<void>;
-//#endregion
 export { AttemptLogRecorder, CaptureAttemptModel, CaptureAttemptTables, emitAttemptLog };
 //# sourceMappingURL=capture-attempt.d.mts.map

package/dist/models/capture-attempt.mjs

@@ -1,14 +1,16 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { redactSecrets } from "../utils/redact.mjs";
 import { ulid } from "../utils/ulid.mjs";
-import { and, asc, eq, getTableColumns } from "drizzle-orm";
-//#region src/models/capture-attempt.ts
+import { col } from "./columns.mjs";
+import { and, asc, eq } from "drizzle-orm";
+// src/models/capture-attempt.ts
 /** Capture attempts and their log lines: per-run history for a build. */
 /** Data operations for capture attempts (one row per build run). */
 var CaptureAttemptModel = class {
-	db;
 	tables;
+	db;
 	constructor(db, tables) {
 		this.db = db;
 		this.tables = tables ?? { captureAttempts: db.tables.captureAttempts };
@@ -45,6 +47,8 @@ var CaptureAttemptModel = class {
 		});
 	}
 	async markRunning(id) {
+		const settled = await this.#cancelled(id);
+		if (settled) return settled;
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		return await this.db.update(this.tables.captureAttempts, id, {
 			status: "running",
@@ -53,6 +57,8 @@ var CaptureAttemptModel = class {
 		});
 	}
 	async markFinished(id, status, error, counts) {
+		const settled = status === "cancelled" ? null : await this.#cancelled(id);
+		if (settled) return settled;
 		const now = (/* @__PURE__ */ new Date()).toISOString();
 		return await this.db.update(this.tables.captureAttempts, id, {
 			status,
@@ -63,9 +69,28 @@ var CaptureAttemptModel = class {
 			updatedAt: now
 		});
 	}
+	/**
+	* The attempt row when a cancel already closed it (ADR 0006): a run that ends after a user
+	* cancelled the build must not rewrite the row as `completed` or `failed`. Null otherwise.
+	*/
+	async #cancelled(id) {
+		const row = await this.db.get(this.tables.captureAttempts, id);
+		return row?.status === "cancelled" ? row : null;
+	}
+	/**
+	* Close every attempt of a build still `queued` or `running` other than `keepId`, as `cancelled`
+	* with `reason`: a new plan of the build supersedes them, and nothing else would ever close them.
+	*/
+	async closeOthers(buildId, keepId, reason) {
+		const open = (await this.listByBuild(buildId)).filter((row) => row.id !== keepId && (row.status === "queued" || row.status === "running"));
+		await Promise.all(open.map(async (row) => {
+			await this.markFinished(row.id, "cancelled", reason);
+		}));
+		return open.length;
+	}
 };
 function columnsOf(table, column) {
-	return getTableColumns(table)[column];
+	return col(table, column);
 }
 /**
 * Record one attempt log line without breaking the capture on write failure.
@@ -74,12 +99,11 @@ function columnsOf(table, column) {
 async function emitAttemptLog(record, logger, level, message, fields) {
 	if (!record) return;
 	try {
-		await record(level, message, fields);
+		await record(level, redactSecrets(message), fields);
 	} catch (error) {
 		logger?.warn({ err: error }, "attempt log write failed");
 	}
 }
-//#endregion
 export { CaptureAttemptModel, emitAttemptLog };
 
 //# sourceMappingURL=capture-attempt.mjs.map

package/dist/models/capture-attempt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"capture-attempt.mjs","names":[],"sources":["../../src/models/capture-attempt.ts"],"sourcesContent":["/** Capture attempts and their log lines: per-run history for a build. */\nimport { and, asc, eq, getTableColumns } from \"drizzle-orm\";\nimport type { SQLWrapper, Table } from \"drizzle-orm\";\nimport type { Logger } from \"pino\";\nimport type { JobStatus } from \"../adapters/capture-queue.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { CaptureAttempt, CaptureLogLevel } from \"../schema/capture-attempt.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\n\n/** Tables required by {@link CaptureAttemptModel}. */\nexport interface CaptureAttemptTables {\n  captureAttempts: Table;\n}\n\n/** Data operations for capture attempts (one row per build run). */\nexport class CaptureAttemptModel {\n  private readonly tables: CaptureAttemptTables;\n  constructor(\n    private readonly db: DatabaseAdapter,\n    tables?: CaptureAttemptTables,\n  ) {\n    this.tables = tables ?? { captureAttempts: db.tables.captureAttempts };\n  }\n\n  async listByBuild(buildId: string): Promise<CaptureAttempt[]> {\n    return (await this.db.list(this.tables.captureAttempts, {\n      where: eq(columnsOf(this.tables.captureAttempts, \"buildId\"), buildId),\n      orderBy: asc(columnsOf(this.tables.captureAttempts, \"attemptNo\")),\n    })) as unknown as CaptureAttempt[];\n  }\n\n  async getByNo(buildId: string, attemptNo: number): Promise<CaptureAttempt | null> {\n    const rows = (await this.db.list(this.tables.captureAttempts, {\n      where: and(\n        eq(columnsOf(this.tables.captureAttempts, \"buildId\"), buildId),\n        eq(columnsOf(this.tables.captureAttempts, \"attemptNo\"), attemptNo),\n      ),\n    })) as unknown as CaptureAttempt[];\n    return rows[0] ?? null;\n  }\n\n  async startAttempt(projectId: string, buildId: string, reqId?: string): Promise<CaptureAttempt> {\n    const existing = await this.listByBuild(buildId);\n    let attemptNo = 1;\n    for (const row of existing) {\n      if (row.attemptNo >= attemptNo) {\n        attemptNo = row.attemptNo + 1;\n      }\n    }\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.captureAttempts, {\n      id: ulid(),\n      projectId,\n      buildId,\n      attemptNo,\n      status: \"queued\",\n      error: null,\n      reqId: reqId ?? null,\n      storyCount: 0,\n      failedCount: 0,\n      queuedAt: now,\n      startedAt: null,\n      finishedAt: null,\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as CaptureAttempt;\n  }\n\n  async markRunning(id: string): Promise<CaptureAttempt> {\n    const now = new Date().toISOString();\n    return (await this.db.update(this.tables.captureAttempts, id, {\n      status: \"running\",\n      startedAt: now,\n      updatedAt: now,\n    })) as unknown as CaptureAttempt;\n  }\n\n  async markFinished(\n    id: string,\n    status: Extract<JobStatus, \"completed\" | \"failed\" | \"cancelled\">,\n    error?: string,\n    counts?: { storyCount: number; failedCount: number },\n  ): Promise<CaptureAttempt> {\n    const now = new Date().toISOString();\n    return (await this.db.update(this.tables.captureAttempts, id, {\n      status,\n      error: error ?? null,\n      storyCount: counts?.storyCount ?? 0,\n      failedCount: counts?.failedCount ?? 0,\n      finishedAt: now,\n      updatedAt: now,\n    })) as unknown as CaptureAttempt;\n  }\n}\n\nfunction columnsOf(table: Table, column: string): SQLWrapper {\n  return getTableColumns(table)[column] as unknown as SQLWrapper;\n}\n\n/**\n * Recorder writing one attempt log line to the `capture_logs` table.\n * Dispatch builds it per attempt; the orchestrator and pipeline call it\n * alongside every pino log so the UI can replay the run later.\n */\nexport type AttemptLogRecorder = (\n  level: CaptureLogLevel,\n  message: string,\n  fields?: unknown,\n) => Promise<void>;\n\n/**\n * Record one attempt log line without breaking the capture on write failure.\n * Log-write failures are reported through pino and never thrown.\n */\nexport async function emitAttemptLog(\n  record: AttemptLogRecorder | undefined,\n  logger: Logger | undefined,\n  level: CaptureLogLevel,\n  message: string,\n  fields?: unknown,\n): Promise<void> {\n  if (!record) {\n    return;\n  }\n  try {\n    await record(level, message, fields);\n  } catch (error) {\n    logger?.warn({ err: error }, \"attempt log write failed\");\n  }\n}\n"],"mappings":";;;;;;;;AAeA,IAAa,sBAAb,MAAiC;CAGZ;CAFnB;CACA,YACE,IACA,QACA;EAFiB,KAAA,KAAA;EAGjB,KAAK,SAAS,UAAU,EAAE,iBAAiB,GAAG,OAAO,gBAAgB;CACvE;CAEA,MAAM,YAAY,SAA4C;EAC5D,OAAQ,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,iBAAiB;GACtD,OAAO,GAAG,UAAU,KAAK,OAAO,iBAAiB,SAAS,GAAG,OAAO;GACpE,SAAS,IAAI,UAAU,KAAK,OAAO,iBAAiB,WAAW,CAAC;EAClE,CAAC;CACH;CAEA,MAAM,QAAQ,SAAiB,WAAmD;EAOhF,QAAO,MANa,KAAK,GAAG,KAAK,KAAK,OAAO,iBAAiB,EAC5D,OAAO,IACL,GAAG,UAAU,KAAK,OAAO,iBAAiB,SAAS,GAAG,OAAO,GAC7D,GAAG,UAAU,KAAK,OAAO,iBAAiB,WAAW,GAAG,SAAS,CACnE,EACF,CAAC,EAAA,CACW,MAAM;CACpB;CAEA,MAAM,aAAa,WAAmB,SAAiB,OAAyC;EAC9F,MAAM,WAAW,MAAM,KAAK,YAAY,OAAO;EAC/C,IAAI,YAAY;EAChB,KAAK,MAAM,OAAO,UAChB,IAAI,IAAI,aAAa,WACnB,YAAY,IAAI,YAAY;EAGhC,MAAM,uBAAM,IAAI,KAAK,EAAA,CAAE,YAAY;EACnC,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,iBAAiB;GACxD,IAAI,KAAK;GACT;GACA;GACA;GACA,QAAQ;GACR,OAAO;GACP,OAAO,SAAS;GAChB,YAAY;GACZ,aAAa;GACb,UAAU;GACV,WAAW;GACX,YAAY;GACZ,WAAW;GACX,WAAW;EACb,CAAC;CACH;CAEA,MAAM,YAAY,IAAqC;EACrD,MAAM,uBAAM,IAAI,KAAK,EAAA,CAAE,YAAY;EACnC,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,iBAAiB,IAAI;GAC5D,QAAQ;GACR,WAAW;GACX,WAAW;EACb,CAAC;CACH;CAEA,MAAM,aACJ,IACA,QACA,OACA,QACyB;EACzB,MAAM,uBAAM,IAAI,KAAK,EAAA,CAAE,YAAY;EACnC,OAAQ,MAAM,KAAK,GAAG,OAAO,KAAK,OAAO,iBAAiB,IAAI;GAC5D;GACA,OAAO,SAAS;GAChB,YAAY,QAAQ,cAAc;GAClC,aAAa,QAAQ,eAAe;GACpC,YAAY;GACZ,WAAW;EACb,CAAC;CACH;AACF;AAEA,SAAS,UAAU,OAAc,QAA4B;CAC3D,OAAO,gBAAgB,KAAK,CAAC,CAAC;AAChC;;;;;AAiBA,eAAsB,eACpB,QACA,QACA,OACA,SACA,QACe;CACf,IAAI,CAAC,QACH;CAEF,IAAI;EACF,MAAM,OAAO,OAAO,SAAS,MAAM;CACrC,SAAS,OAAO;EACd,QAAQ,KAAK,EAAE,KAAK,MAAM,GAAG,0BAA0B;CACzD;AACF"}
+{"version":3,"file":"capture-attempt.mjs","names":[],"sources":["../../src/models/capture-attempt.ts"],"sourcesContent":["/** Capture attempts and their log lines: per-run history for a build. */\nimport { and, asc, eq } from \"drizzle-orm\";\nimport type { SQLWrapper, Table } from \"drizzle-orm\";\nimport type { Logger } from \"pino\";\nimport type { JobStatus } from \"../adapters/capture-queue.ts\";\nimport type { DatabaseAdapter } from \"../adapters/database.ts\";\nimport type { CaptureAttempt, CaptureLogLevel } from \"../schema/capture-attempt.ts\";\nimport { redactSecrets } from \"../utils/redact.ts\";\nimport { ulid } from \"../utils/ulid.ts\";\nimport { col } from \"./columns.ts\";\n\n/** Tables required by {@link CaptureAttemptModel}. */\nexport interface CaptureAttemptTables {\n  captureAttempts: Table;\n}\n\n/** Data operations for capture attempts (one row per build run). */\nexport class CaptureAttemptModel {\n  private readonly tables: CaptureAttemptTables;\n  private readonly db: DatabaseAdapter;\n\n  constructor(db: DatabaseAdapter, tables?: CaptureAttemptTables) {\n    this.db = db;\n    this.tables = tables ?? { captureAttempts: db.tables.captureAttempts };\n  }\n\n  async listByBuild(buildId: string): Promise<CaptureAttempt[]> {\n    return (await this.db.list(this.tables.captureAttempts, {\n      where: eq(columnsOf(this.tables.captureAttempts, \"buildId\"), buildId),\n      orderBy: asc(columnsOf(this.tables.captureAttempts, \"attemptNo\")),\n    })) as unknown as CaptureAttempt[];\n  }\n\n  async getByNo(buildId: string, attemptNo: number): Promise<CaptureAttempt | null> {\n    const rows = (await this.db.list(this.tables.captureAttempts, {\n      where: and(\n        eq(columnsOf(this.tables.captureAttempts, \"buildId\"), buildId),\n        eq(columnsOf(this.tables.captureAttempts, \"attemptNo\"), attemptNo),\n      ),\n    })) as unknown as CaptureAttempt[];\n    return rows[0] ?? null;\n  }\n\n  async startAttempt(projectId: string, buildId: string, reqId?: string): Promise<CaptureAttempt> {\n    const existing = await this.listByBuild(buildId);\n    let attemptNo = 1;\n    for (const row of existing) {\n      if (row.attemptNo >= attemptNo) {\n        attemptNo = row.attemptNo + 1;\n      }\n    }\n    const now = new Date().toISOString();\n    return (await this.db.insert(this.tables.captureAttempts, {\n      id: ulid(),\n      projectId,\n      buildId,\n      attemptNo,\n      status: \"queued\",\n      error: null,\n      reqId: reqId ?? null,\n      storyCount: 0,\n      failedCount: 0,\n      queuedAt: now,\n      startedAt: null,\n      finishedAt: null,\n      createdAt: now,\n      updatedAt: now,\n    })) as unknown as CaptureAttempt;\n  }\n\n  async markRunning(id: string): Promise<CaptureAttempt> {\n    const settled = await this.#cancelled(id);\n    if (settled) {\n      return settled;\n    }\n    const now = new Date().toISOString();\n    return (await this.db.update(this.tables.captureAttempts, id, {\n      status: \"running\",\n      startedAt: now,\n      updatedAt: now,\n    })) as unknown as CaptureAttempt;\n  }\n\n  async markFinished(\n    id: string,\n    status: Extract<JobStatus, \"completed\" | \"failed\" | \"cancelled\">,\n    error?: string,\n    counts?: { storyCount: number; failedCount: number },\n  ): Promise<CaptureAttempt> {\n    const settled = status === \"cancelled\" ? null : await this.#cancelled(id);\n    if (settled) {\n      return settled;\n    }\n    const now = new Date().toISOString();\n    return (await this.db.update(this.tables.captureAttempts, id, {\n      status,\n      error: error ?? null,\n      storyCount: counts?.storyCount ?? 0,\n      failedCount: counts?.failedCount ?? 0,\n      finishedAt: now,\n      updatedAt: now,\n    })) as unknown as CaptureAttempt;\n  }\n\n  /**\n   * The attempt row when a cancel already closed it (ADR 0006): a run that ends after a user\n   * cancelled the build must not rewrite the row as `completed` or `failed`. Null otherwise.\n   */\n  async #cancelled(id: string): Promise<CaptureAttempt | null> {\n    const row = (await this.db.get(\n      this.tables.captureAttempts,\n      id,\n    )) as unknown as CaptureAttempt | null;\n    return row?.status === \"cancelled\" ? row : null;\n  }\n\n  /**\n   * Close every attempt of a build still `queued` or `running` other than `keepId`, as `cancelled`\n   * with `reason`: a new plan of the build supersedes them, and nothing else would ever close them.\n   */\n  async closeOthers(buildId: string, keepId: string | null, reason: string): Promise<number> {\n    const open = (await this.listByBuild(buildId)).filter(\n      (row) => row.id !== keepId && (row.status === \"queued\" || row.status === \"running\"),\n    );\n    await Promise.all(\n      open.map(async (row) => {\n        await this.markFinished(row.id, \"cancelled\", reason);\n      }),\n    );\n    return open.length;\n  }\n}\n\nfunction columnsOf(table: Table, column: string): SQLWrapper {\n  return col(table, column);\n}\n\n/**\n * Recorder writing one attempt log line to the `capture_logs` table.\n * Dispatch builds it per attempt; the orchestrator and pipeline call it\n * alongside every pino log so the UI can replay the run later.\n */\nexport type AttemptLogRecorder = (\n  level: CaptureLogLevel,\n  message: string,\n  fields?: unknown,\n) => Promise<void>;\n\n/**\n * Record one attempt log line without breaking the capture on write failure.\n * Log-write failures are reported through pino and never thrown.\n */\nexport async function emitAttemptLog(\n  record: AttemptLogRecorder | undefined,\n  logger: Logger | undefined,\n  level: CaptureLogLevel,\n  message: string,\n  fields?: unknown,\n): Promise<void> {\n  if (!record) {\n    return;\n  }\n  try {\n    await record(level, redactSecrets(message), fields);\n  } catch (error) {\n    logger?.warn({ err: error }, \"attempt log write failed\");\n  }\n}\n"],"mappings":"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"}

package/dist/models/capture-job.d.mts

@@ -0,0 +1,104 @@
+import __tsdown_shims_path from 'node:path';
+import __tsdown_shims_url from 'node:url';
+import { DatabaseAdapter } from "../adapter/database.mjs";
+import { CaptureAttemptStatus, CaptureJobKind, CaptureJobRow, CaptureJobStatus } from "../schema/capture-job.mjs";
+import { Table } from "drizzle-orm";
+/** Tables required by {@link CaptureJobModel}. */
+interface CaptureJobTables {
+  captureJobs: Table;
+}
+/** A job to put on the queue. */
+interface NewCaptureJob {
+  id: string;
+  kind: CaptureJobKind;
+  buildId?: string | null;
+  shardId?: string | null;
+  maxAttempts: number;
+  /** JSON payload (request id, traceparent, kind-specific fields). */
+  payload?: string | null;
+  /** When the job may first be claimed; defaults to `now`. */
+  visibleAt?: string;
+}
+/** The claim an instance makes on a job: attempt `attempt`, held by `owner` until `leaseUntil`. */
+interface AttemptClaim {
+  job: CaptureJobRow;
+  attempt: number;
+  owner: string;
+  leaseUntil: string;
+}
+/** Job statuses that end a job: nothing claims it again. */
+declare const TERMINAL_JOB_STATUSES: readonly CaptureJobStatus[];
+/**
+ * Data operations of the database queue. Every write is an unconditional update by id or an
+ * insert; the only atomic primitive is the unique-key insert of an attempt row ({@link claim}),
+ * which is what fences concurrent claimers on every supported database.
+ */
+declare class CaptureJobModel {
+  #private;
+  constructor(db: DatabaseAdapter, tables?: CaptureJobTables);
+  get(id: string): Promise<CaptureJobRow | null>;
+  /** Insert a queued job row. */
+  create(input: NewCaptureJob, now: string): Promise<CaptureJobRow>;
+  /**
+   * The poll probe: the oldest row of `kinds` that may be claimed at `now`. One indexed range query
+   * on `(kind, visible_at, status)`, limit 1; only candidates have a `visibleAt`, so an empty queue
+   * reads no rows and a busy one reads one.
+   */
+  nextCandidate(kinds: readonly CaptureJobKind[], now: string): Promise<CaptureJobRow | null>;
+  /**
+   * Claim attempt `attempt` of a job by inserting its row `<jobId>:<attempt>`. Exactly one caller
+   * succeeds on every database; the others hit the primary key, which this reports as `false`
+   * (told apart from real failures by re-reading the row, as `CaptureShardModel.claimFinalize`).
+   */
+  claim(input: AttemptClaim, now: string): Promise<boolean>;
+  /** The claim won: the job row records the running attempt and leaves the poll's index range. */
+  markRunning(jobId: string, attempt: number, now: string): Promise<void>;
+  /** Push an attempt's lease out. Returns the row (null if gone) so the caller sees cancel or expiry. */
+  renew(attemptId: string, leaseUntil: string, now: string): Promise<CaptureJobRow | null>;
+  /** The attempt row `attemptId` if it is running with a lease that passed by `now`, else null. */
+  expiredAttempt(attemptId: string, now: string): Promise<CaptureJobRow | null>;
+  /** Move a row's visibility time (and nothing else). */
+  defer(id: string, visibleAt: string, now: string): Promise<void>;
+  /** Take a row out of the poll's index range without changing its status. */
+  clearVisibility(id: string, now: string): Promise<void>;
+  /** End an attempt row: `done`, `failed` (with its error) or `expired` (taken over). */
+  finishAttempt(attemptId: string, status: Exclude<CaptureAttemptStatus, "running">, now: string, error?: string | null): Promise<void>;
+  /** End a job row for good. */
+  finishJob(jobId: string, status: Exclude<CaptureJobStatus, "queued" | "running">, now: string, error?: string | null): Promise<void>;
+  /** Put a job back on the queue, claimable from `visibleAt`, remembering why the attempt failed. */
+  requeue(jobId: string, visibleAt: string, error: string | null, now: string): Promise<void>;
+  /** Flag a row as cancel-requested; the flag is never cleared. */
+  flagCancel(id: string, now: string): Promise<void>;
+  /** Job rows of a build (its own job and its shard jobs), oldest first. */
+  listForBuild(buildId: string): Promise<CaptureJobRow[]>;
+  /** The build's own (non-shard) job of `kinds` most recently queued, or null. */
+  latestForBuild(buildId: string, kinds: readonly CaptureJobKind[]): Promise<CaptureJobRow | null>;
+  /** Attempt rows of a job, by attempt number. */
+  attempts(jobId: string): Promise<CaptureJobRow[]>;
+  /** Job rows of `kinds` that are queued or running, oldest first. */
+  listActive(kinds: readonly CaptureJobKind[]): Promise<CaptureJobRow[]>;
+  /** The newest job rows of `kinds`, newest first. */
+  listRecent(kinds: readonly CaptureJobKind[], limit: number): Promise<CaptureJobRow[]>;
+  /**
+   * Retention: delete finished jobs created before `before`, with their attempt rows. Returns the
+   * number of jobs removed. Running and queued jobs are never touched.
+   */
+  purgeFinished(before: string): Promise<number>;
+  /**
+   * A build was removed: delete every `capture_jobs` row that points at it (job and attempt rows,
+   * whatever their status). There is no foreign key, so retention does this by hand. Returns the
+   * number of rows removed.
+   */
+  removeForBuild(buildId: string): Promise<number>;
+}
+/** Primary key of attempt `attempt` of a job. */
+declare function attemptRowId(jobId: string, attempt: number): string;
+/** Split an attempt row id back into its job id and number; null when it is not one. */
+declare function parseAttemptRowId(id: string): {
+  jobId: string;
+  attempt: number;
+} | null;
+/** Whether a job row has ended. */
+declare function isTerminalJob(row: CaptureJobRow): boolean;
+export { AttemptClaim, CaptureJobModel, CaptureJobTables, NewCaptureJob, TERMINAL_JOB_STATUSES, attemptRowId, isTerminalJob, parseAttemptRowId };
+//# sourceMappingURL=capture-job.d.mts.map