@vercel/factory 0.0.13 → 0.0.14

package/dist/approval-JX2Px9IC.mjs

@@ -0,0 +1,132 @@
+import { h as vocabularySchema } from "./id-BLIkCVue.mjs";
+import { z } from "zod";
+import { createHash } from "node:crypto";
+//#region src/schema/finding.ts
+const findingPrioritySchema = z.enum([
+	"P0",
+	"P1",
+	"P2",
+	"P3"
+]).describe("Urgency of a finding: P0 is drop-everything, P3 is nice-to-have.");
+const findingCategorySchema = z.enum([
+	"security",
+	"correctness",
+	"reliability",
+	"performance",
+	"compatibility",
+	"accessibility",
+	"documentation",
+	"maintainability",
+	"testing",
+	"usability"
+]);
+const findingVerificationLevelSchema = z.enum([
+	"unverified",
+	"supported",
+	"confirmed"
+]).describe("How sure the reporter is: unverified = suspected from reading; supported = evidence points to it; confirmed = demonstrated.");
+const findingVerificationMethodSchema = z.enum([
+	"code_inspection",
+	"static_analysis",
+	"manual_reproduction",
+	"unit_test",
+	"integration_test",
+	"e2e_test",
+	"runtime_observation",
+	"documentation"
+]);
+/**
+* What was done to check the finding. Forces a reporter to distinguish "I
+* think this is a problem" from "I demonstrated it", which is the axis a human
+* approving fixes cares about most.
+*/
+const findingVerificationSchema = z.strictObject({
+	level: findingVerificationLevelSchema,
+	method: findingVerificationMethodSchema,
+	summary: z.string().min(1).max(2e3).describe("What was checked and what it showed."),
+	limitations: z.string().min(1).max(2e3).optional().describe("What could not be checked.")
+});
+/** A single problem found in a repository, as a scanner or agent reports it. */
+const findingSchema = z.strictObject({
+	title: z.string().min(1).max(200),
+	body: z.string().min(1).max(8e3).describe("The problem, its impact, and how to fix it. Markdown."),
+	path: z.string().min(1).max(500).optional().describe("Repository-relative file path."),
+	line: z.number().int().min(1).optional(),
+	endLine: z.number().int().min(1).optional(),
+	priority: findingPrioritySchema,
+	category: findingCategorySchema,
+	verification: findingVerificationSchema,
+	tool: z.string().min(1).max(100).optional().describe("Scanner that produced it, e.g. deepsec."),
+	ruleId: z.string().min(1).max(200).optional().describe("Scanner rule or check id, when there is one.")
+});
+/**
+* Stable identity of a finding across scans, used as the signal's delivery id
+* so re-reporting is a no-op instead of a second task. A scanner finding is
+* the same problem when the same tool reports the same rule on the same file;
+* its title is model-written prose and changes between runs, so it is left
+* out. Without a rule id the title is all there is, normalised.
+*/
+function findingFingerprint(repositoryId, finding) {
+	const parts = finding.tool !== void 0 && finding.ruleId !== void 0 && finding.path !== void 0 ? [
+		repositoryId,
+		finding.tool,
+		finding.ruleId,
+		finding.path
+	] : [
+		repositoryId,
+		finding.tool ?? "",
+		finding.ruleId ?? "",
+		finding.path ?? "",
+		finding.title.trim().toLowerCase().replaceAll(/\s+/gu, " ")
+	];
+	return createHash("sha256").update(parts.join(" ")).digest("hex").slice(0, 32);
+}
+//#endregion
+//#region src/approval.ts
+/**
+* One approval rule. Every listed field must match for the rule to apply;
+* absent fields match anything. Rules are evaluated first-match.
+*/
+const approvalRuleSchema = z.strictObject({
+	source: vocabularySchema.optional().describe("Signal source, e.g. security_scan or github_issue."),
+	kind: vocabularySchema.optional().describe("Task kind, e.g. code_change."),
+	priority: z.array(findingPrioritySchema).min(1).optional().describe("Finding priorities the rule applies to."),
+	require: z.boolean().describe("Whether matching tasks wait for a human before dispatch.")
+});
+const approvalPolicySchema = z.array(approvalRuleSchema).describe("First-match rules deciding which tasks need a human before they run.");
+/**
+* The default: fixes for security findings wait for a human; everything else
+* runs as it always has. Handoffs between agents (verification) never wait,
+* because a human already approved the work they continue.
+*/
+const defaultApprovalPolicy = [
+	{
+		kind: "verification",
+		require: false
+	},
+	{
+		source: "security_scan",
+		require: true
+	},
+	{ require: false }
+];
+/**
+* Decide at task-creation time whether a task needs approval. Pure: the answer
+* is stamped on the task and never re-evaluated, so a later policy change
+* cannot silently release work a human was expecting to see.
+*/
+function requiresApproval(policy, subject) {
+	for (const rule of policy) {
+		if (rule.source !== void 0 && rule.source !== subject.source) continue;
+		if (rule.kind !== void 0 && rule.kind !== subject.kind) continue;
+		if (rule.priority !== void 0) {
+			if (subject.priority === void 0 || !rule.priority.includes(subject.priority)) continue;
+		}
+		return rule.require;
+	}
+	return false;
+}
+//#endregion
+export { findingCategorySchema as a, findingSchema as c, findingVerificationSchema as d, requiresApproval as i, findingVerificationLevelSchema as l, approvalRuleSchema as n, findingFingerprint as o, defaultApprovalPolicy as r, findingPrioritySchema as s, approvalPolicySchema as t, findingVerificationMethodSchema as u };
+
+//# sourceMappingURL=approval-JX2Px9IC.mjs.map

package/dist/approval-JX2Px9IC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-JX2Px9IC.mjs","names":[],"sources":["../src/schema/finding.ts","../src/approval.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { z } from \"zod\";\n\nexport const findingPrioritySchema = z\n  .enum([\"P0\", \"P1\", \"P2\", \"P3\"])\n  .describe(\"Urgency of a finding: P0 is drop-everything, P3 is nice-to-have.\");\n\nexport const findingCategorySchema = z.enum([\n  \"security\",\n  \"correctness\",\n  \"reliability\",\n  \"performance\",\n  \"compatibility\",\n  \"accessibility\",\n  \"documentation\",\n  \"maintainability\",\n  \"testing\",\n  \"usability\",\n]);\n\nexport const findingVerificationLevelSchema = z\n  .enum([\"unverified\", \"supported\", \"confirmed\"])\n  .describe(\n    \"How sure the reporter is: unverified = suspected from reading; supported = evidence points to it; confirmed = demonstrated.\",\n  );\n\nexport const findingVerificationMethodSchema = z.enum([\n  \"code_inspection\",\n  \"static_analysis\",\n  \"manual_reproduction\",\n  \"unit_test\",\n  \"integration_test\",\n  \"e2e_test\",\n  \"runtime_observation\",\n  \"documentation\",\n]);\n\n/**\n * What was done to check the finding. Forces a reporter to distinguish \"I\n * think this is a problem\" from \"I demonstrated it\", which is the axis a human\n * approving fixes cares about most.\n */\nexport const findingVerificationSchema = z.strictObject({\n  level: findingVerificationLevelSchema,\n  method: findingVerificationMethodSchema,\n  summary: z.string().min(1).max(2000).describe(\"What was checked and what it showed.\"),\n  limitations: z.string().min(1).max(2000).optional().describe(\"What could not be checked.\"),\n});\n\n/** A single problem found in a repository, as a scanner or agent reports it. */\nexport const findingSchema = z.strictObject({\n  title: z.string().min(1).max(200),\n  body: z.string().min(1).max(8000).describe(\"The problem, its impact, and how to fix it. Markdown.\"),\n  path: z.string().min(1).max(500).optional().describe(\"Repository-relative file path.\"),\n  line: z.number().int().min(1).optional(),\n  endLine: z.number().int().min(1).optional(),\n  priority: findingPrioritySchema,\n  category: findingCategorySchema,\n  verification: findingVerificationSchema,\n  tool: z.string().min(1).max(100).optional().describe(\"Scanner that produced it, e.g. deepsec.\"),\n  ruleId: z.string().min(1).max(200).optional().describe(\"Scanner rule or check id, when there is one.\"),\n});\n\nexport type FindingPriority = z.infer<typeof findingPrioritySchema>;\nexport type FindingCategory = z.infer<typeof findingCategorySchema>;\nexport type FindingVerification = z.infer<typeof findingVerificationSchema>;\nexport type Finding = z.infer<typeof findingSchema>;\n\n/**\n * Stable identity of a finding across scans, used as the signal's delivery id\n * so re-reporting is a no-op instead of a second task. A scanner finding is\n * the same problem when the same tool reports the same rule on the same file;\n * its title is model-written prose and changes between runs, so it is left\n * out. Without a rule id the title is all there is, normalised.\n */\nexport function findingFingerprint(repositoryId: string, finding: Finding): string {\n  const parts =\n    finding.tool !== undefined && finding.ruleId !== undefined && finding.path !== undefined\n      ? [repositoryId, finding.tool, finding.ruleId, finding.path]\n      : [\n          repositoryId,\n          finding.tool ?? \"\",\n          finding.ruleId ?? \"\",\n          finding.path ?? \"\",\n          finding.title.trim().toLowerCase().replaceAll(/\\s+/gu, \" \"),\n        ];\n  return createHash(\"sha256\").update(parts.join(\" \")).digest(\"hex\").slice(0, 32);\n}\n","import { z } from \"zod\";\nimport { vocabularySchema } from \"./schema/common\";\nimport { findingPrioritySchema, type FindingPriority } from \"./schema/finding\";\n\n/**\n * One approval rule. Every listed field must match for the rule to apply;\n * absent fields match anything. Rules are evaluated first-match.\n */\nexport const approvalRuleSchema = z.strictObject({\n  source: vocabularySchema.optional().describe(\"Signal source, e.g. security_scan or github_issue.\"),\n  kind: vocabularySchema.optional().describe(\"Task kind, e.g. code_change.\"),\n  priority: z\n    .array(findingPrioritySchema)\n    .min(1)\n    .optional()\n    .describe(\"Finding priorities the rule applies to.\"),\n  require: z.boolean().describe(\"Whether matching tasks wait for a human before dispatch.\"),\n});\n\nexport const approvalPolicySchema = z\n  .array(approvalRuleSchema)\n  .describe(\"First-match rules deciding which tasks need a human before they run.\");\n\nexport type ApprovalRule = z.infer<typeof approvalRuleSchema>;\nexport type ApprovalPolicy = z.infer<typeof approvalPolicySchema>;\n\n/**\n * The default: fixes for security findings wait for a human; everything else\n * runs as it always has. Handoffs between agents (verification) never wait,\n * because a human already approved the work they continue.\n */\nexport const defaultApprovalPolicy: ApprovalPolicy = [\n  { kind: \"verification\", require: false },\n  { source: \"security_scan\", require: true },\n  { require: false },\n];\n\nexport interface ApprovalSubject {\n  source?: string;\n  kind: string;\n  priority?: FindingPriority;\n}\n\n/**\n * Decide at task-creation time whether a task needs approval. Pure: the answer\n * is stamped on the task and never re-evaluated, so a later policy change\n * cannot silently release work a human was expecting to see.\n */\nexport function requiresApproval(policy: ApprovalPolicy, subject: ApprovalSubject): boolean {\n  for (const rule of policy) {\n    if (rule.source !== undefined && rule.source !== subject.source) continue;\n    if (rule.kind !== undefined && rule.kind !== subject.kind) continue;\n    if (rule.priority !== undefined) {\n      if (subject.priority === undefined || !rule.priority.includes(subject.priority)) continue;\n    }\n    return rule.require;\n  }\n  return false;\n}\n"],"mappings":"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"}

package/dist/blob/index.d.mts

@@ -1,4 +1,4 @@
-import { i as StoreDriver } from "../driver-BJutB0PE.mjs";
+import { i as StoreDriver } from "../driver-BC0Mt5KG.mjs";
 //#region src/blob/index.d.ts
 interface BlobObject {
   body: string;
@@ -17,11 +17,12 @@ interface BlobDriverOptions {
   client?: BlobClient;
   /** Path prefix inside the blob store; defaults to "factory". */
   prefix?: string;
+  /** Maximum Blob downloads in flight while listing a collection. Default 32. */
+  readConcurrency?: number;
 }
 /**
  * Store driver on Vercel Blob: durable and dependency-free (one Blob store on
- * the project, no database). Inserts and receipts are exactly as safe as on
- * Postgres (create-if-absent is atomic). Updates read the latest content,
+ * the project, no database). Inserts are create-if-absent. Updates read the latest content,
  * bypassing Blob's CDN cache, and write with an ETag precondition, so a
  * writer that lost a race gets a VersionConflictError rather than
  * overwriting the winner.

package/dist/blob/index.mjs

@@ -53,8 +53,7 @@ const vercelBlobClient = {
 };
 /**
 * Store driver on Vercel Blob: durable and dependency-free (one Blob store on
-* the project, no database). Inserts and receipts are exactly as safe as on
-* Postgres (create-if-absent is atomic). Updates read the latest content,
+* the project, no database). Inserts are create-if-absent. Updates read the latest content,
 * bypassing Blob's CDN cache, and write with an ETag precondition, so a
 * writer that lost a race gets a VersionConflictError rather than
 * overwriting the winner.
@@ -62,6 +61,8 @@ const vercelBlobClient = {
 function createBlobDriver(options = {}) {
 	const client = options.client ?? vercelBlobClient;
 	const prefix = options.prefix ?? "factory";
+	const readConcurrency = options.readConcurrency ?? 32;
+	if (!Number.isInteger(readConcurrency) || readConcurrency < 1) throw new Error("Blob read concurrency must be a positive integer");
 	function pathFor(collection, id) {
 		return `${prefix}/${collection}/${id}.json`;
 	}
@@ -119,19 +120,24 @@ function createBlobDriver(options = {}) {
 		async list(collection) {
 			const dir = `${prefix}/${collection}/`;
 			const paths = await client.listPaths(dir);
-			const entries = [];
-			for (const pathname of paths) {
-				const id = pathname.slice(dir.length).replace(/\.json$/u, "");
-				const record = await readRecord(collection, id);
-				if (record !== null) entries.push({
-					id,
-					record: {
-						value: record.value,
-						version: record.version
-					}
-				});
-			}
-			return entries;
+			const entries = new Array(paths.length);
+			let next = 0;
+			const workers = Array.from({ length: Math.min(readConcurrency, paths.length) }, async () => {
+				while (next < paths.length) {
+					const index = next++;
+					const id = paths[index].slice(dir.length).replace(/\.json$/u, "");
+					const record = await readRecord(collection, id);
+					entries[index] = record === null ? null : {
+						id,
+						record: {
+							value: record.value,
+							version: record.version
+						}
+					};
+				}
+			});
+			await Promise.all(workers);
+			return entries.filter((entry) => entry !== null);
 		}
 	};
 }

package/dist/blob/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/blob/index.ts"],"sourcesContent":["import { get, list, put } from \"@vercel/blob\";\nimport {\n  RecordExistsError,\n  RecordNotFoundError,\n  VersionConflictError,\n  type CollectionName,\n  type StoredEntry,\n  type StoreDriver,\n} from \"../store/driver\";\n\nexport interface BlobObject {\n  body: string;\n  etag: string;\n}\n\n/** The narrow blob operations the driver needs; injectable for tests. */\nexport interface BlobClient {\n  /** Must return the latest content, never a cached copy. */\n  read(pathname: string): Promise<BlobObject | null>;\n  /** Must reject if overwrite is false and the path exists, or if ifMatch is given and the ETag differs. */\n  write(pathname: string, body: string, overwrite: boolean, ifMatch?: string): Promise<void>;\n  listPaths(prefix: string): Promise<string[]>;\n}\n\n// @vercel/blob throws BlobNotFoundError with the message\n// \"Vercel Blob: The requested blob does not exist\".\nfunction isNotFoundError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    (error.name === \"BlobNotFoundError\" ||\n      /does not exist|not.?found|404/iu.test(error.message))\n  );\n}\n\nfunction isAlreadyExistsError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    /already exists|not allowed to overwrite|overwrite/iu.test(error.message)\n  );\n}\n\n// @vercel/blob throws BlobPreconditionFailedError when ifMatch does not hold.\nfunction isPreconditionError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    (error.name === \"BlobPreconditionFailedError\" || /precondition|etag|412/iu.test(error.message))\n  );\n}\n\nexport const vercelBlobClient: BlobClient = {\n  async read(pathname) {\n    let result;\n    try {\n      // Uncached: the ledger is read-modify-write and must see the latest version.\n      result = await get(pathname, { access: \"private\", useCache: false });\n    } catch (error) {\n      if (isNotFoundError(error)) {\n        return null;\n      }\n      throw error;\n    }\n    if (result === null || result.stream === null) {\n      return null;\n    }\n    return { body: await new Response(result.stream).text(), etag: result.blob.etag };\n  },\n\n  async write(pathname, body, overwrite, ifMatch) {\n    await put(pathname, body, {\n      access: \"private\",\n      allowOverwrite: overwrite,\n      contentType: \"application/json\",\n      ...(ifMatch === undefined ? {} : { ifMatch }),\n    });\n  },\n\n  async listPaths(prefix) {\n    const paths: string[] = [];\n    let cursor: string | undefined;\n    do {\n      const page = await list({ prefix, cursor, limit: 1000 });\n      paths.push(...page.blobs.map((blob) => blob.pathname));\n      cursor = page.hasMore ? page.cursor : undefined;\n    } while (cursor !== undefined);\n    return paths;\n  },\n};\n\nexport interface BlobDriverOptions {\n  client?: BlobClient;\n  /** Path prefix inside the blob store; defaults to \"factory\". */\n  prefix?: string;\n}\n\n/**\n * Store driver on Vercel Blob: durable and dependency-free (one Blob store on\n * the project, no database). Inserts and receipts are exactly as safe as on\n * Postgres (create-if-absent is atomic). Updates read the latest content,\n * bypassing Blob's CDN cache, and write with an ETag precondition, so a\n * writer that lost a race gets a VersionConflictError rather than\n * overwriting the winner.\n */\nexport function createBlobDriver(options: BlobDriverOptions = {}): StoreDriver {\n  const client = options.client ?? vercelBlobClient;\n  const prefix = options.prefix ?? \"factory\";\n\n  function pathFor(collection: CollectionName, id: string): string {\n    return `${prefix}/${collection}/${id}.json`;\n  }\n\n  async function readRecord(\n    collection: CollectionName,\n    id: string,\n  ): Promise<{ value: unknown; version: number; etag: string } | null> {\n    let object: BlobObject | null;\n    try {\n      object = await client.read(pathFor(collection, id));\n    } catch (error) {\n      if (isNotFoundError(error)) {\n        return null;\n      }\n      throw error;\n    }\n    if (object === null) {\n      return null;\n    }\n    const parsed = JSON.parse(object.body) as { value: unknown; version: number };\n    if (typeof parsed.version !== \"number\") {\n      throw new Error(`malformed stored record at ${pathFor(collection, id)}`);\n    }\n    return { value: parsed.value, version: parsed.version, etag: object.etag };\n  }\n\n  return {\n    name: \"blob\",\n\n    async get(collection, id) {\n      const record = await readRecord(collection, id);\n      return record === null ? null : { value: record.value, version: record.version };\n    },\n\n    async insert(collection, id, value) {\n      try {\n        await client.write(\n          pathFor(collection, id),\n          JSON.stringify({ value, version: 1 }),\n          false,\n        );\n      } catch (error) {\n        if (isAlreadyExistsError(error)) {\n          throw new RecordExistsError(collection, id);\n        }\n        throw error;\n      }\n    },\n\n    async update(collection, id, value, expectedVersion) {\n      const existing = await readRecord(collection, id);\n      if (existing === null) {\n        throw new RecordNotFoundError(collection, id);\n      }\n      if (existing.version !== expectedVersion) {\n        throw new VersionConflictError(collection, id, expectedVersion);\n      }\n      try {\n        await client.write(\n          pathFor(collection, id),\n          JSON.stringify({ value, version: expectedVersion + 1 }),\n          true,\n          // The write API's ifMatch rejects the weak form (W/\"…\") that reads return.\n          existing.etag.replace(/^W\\//u, \"\"),\n        );\n      } catch (error) {\n        if (isPreconditionError(error)) {\n          throw new VersionConflictError(collection, id, expectedVersion);\n        }\n        throw error;\n      }\n    },\n\n    async list(collection) {\n      const dir = `${prefix}/${collection}/`;\n      const paths = await client.listPaths(dir);\n      const entries: StoredEntry[] = [];\n      for (const pathname of paths) {\n        const id = pathname.slice(dir.length).replace(/\\.json$/u, \"\");\n        const record = await readRecord(collection, id);\n        if (record !== null) {\n          entries.push({ id, record: { value: record.value, version: record.version } });\n        }\n      }\n      return entries;\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/blob/index.ts"],"sourcesContent":["import { get, list, put } from \"@vercel/blob\";\nimport {\n  RecordExistsError,\n  RecordNotFoundError,\n  VersionConflictError,\n  type CollectionName,\n  type StoredEntry,\n  type StoreDriver,\n} from \"../store/driver\";\n\nexport interface BlobObject {\n  body: string;\n  etag: string;\n}\n\n/** The narrow blob operations the driver needs; injectable for tests. */\nexport interface BlobClient {\n  /** Must return the latest content, never a cached copy. */\n  read(pathname: string): Promise<BlobObject | null>;\n  /** Must reject if overwrite is false and the path exists, or if ifMatch is given and the ETag differs. */\n  write(pathname: string, body: string, overwrite: boolean, ifMatch?: string): Promise<void>;\n  listPaths(prefix: string): Promise<string[]>;\n}\n\n// @vercel/blob throws BlobNotFoundError with the message\n// \"Vercel Blob: The requested blob does not exist\".\nfunction isNotFoundError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    (error.name === \"BlobNotFoundError\" ||\n      /does not exist|not.?found|404/iu.test(error.message))\n  );\n}\n\nfunction isAlreadyExistsError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    /already exists|not allowed to overwrite|overwrite/iu.test(error.message)\n  );\n}\n\n// @vercel/blob throws BlobPreconditionFailedError when ifMatch does not hold.\nfunction isPreconditionError(error: unknown): boolean {\n  return (\n    error instanceof Error &&\n    (error.name === \"BlobPreconditionFailedError\" || /precondition|etag|412/iu.test(error.message))\n  );\n}\n\nexport const vercelBlobClient: BlobClient = {\n  async read(pathname) {\n    let result;\n    try {\n      // Uncached: the ledger is read-modify-write and must see the latest version.\n      result = await get(pathname, { access: \"private\", useCache: false });\n    } catch (error) {\n      if (isNotFoundError(error)) {\n        return null;\n      }\n      throw error;\n    }\n    if (result === null || result.stream === null) {\n      return null;\n    }\n    return { body: await new Response(result.stream).text(), etag: result.blob.etag };\n  },\n\n  async write(pathname, body, overwrite, ifMatch) {\n    await put(pathname, body, {\n      access: \"private\",\n      allowOverwrite: overwrite,\n      contentType: \"application/json\",\n      ...(ifMatch === undefined ? {} : { ifMatch }),\n    });\n  },\n\n  async listPaths(prefix) {\n    const paths: string[] = [];\n    let cursor: string | undefined;\n    do {\n      const page = await list({ prefix, cursor, limit: 1000 });\n      paths.push(...page.blobs.map((blob) => blob.pathname));\n      cursor = page.hasMore ? page.cursor : undefined;\n    } while (cursor !== undefined);\n    return paths;\n  },\n};\n\nexport interface BlobDriverOptions {\n  client?: BlobClient;\n  /** Path prefix inside the blob store; defaults to \"factory\". */\n  prefix?: string;\n  /** Maximum Blob downloads in flight while listing a collection. Default 32. */\n  readConcurrency?: number;\n}\n\n/**\n * Store driver on Vercel Blob: durable and dependency-free (one Blob store on\n * the project, no database). Inserts are create-if-absent. Updates read the latest content,\n * bypassing Blob's CDN cache, and write with an ETag precondition, so a\n * writer that lost a race gets a VersionConflictError rather than\n * overwriting the winner.\n */\nexport function createBlobDriver(options: BlobDriverOptions = {}): StoreDriver {\n  const client = options.client ?? vercelBlobClient;\n  const prefix = options.prefix ?? \"factory\";\n  const readConcurrency = options.readConcurrency ?? 32;\n  if (!Number.isInteger(readConcurrency) || readConcurrency < 1) {\n    throw new Error(\"Blob read concurrency must be a positive integer\");\n  }\n\n  function pathFor(collection: CollectionName, id: string): string {\n    return `${prefix}/${collection}/${id}.json`;\n  }\n\n  async function readRecord(\n    collection: CollectionName,\n    id: string,\n  ): Promise<{ value: unknown; version: number; etag: string } | null> {\n    let object: BlobObject | null;\n    try {\n      object = await client.read(pathFor(collection, id));\n    } catch (error) {\n      if (isNotFoundError(error)) {\n        return null;\n      }\n      throw error;\n    }\n    if (object === null) {\n      return null;\n    }\n    const parsed = JSON.parse(object.body) as { value: unknown; version: number };\n    if (typeof parsed.version !== \"number\") {\n      throw new Error(`malformed stored record at ${pathFor(collection, id)}`);\n    }\n    return { value: parsed.value, version: parsed.version, etag: object.etag };\n  }\n\n  return {\n    name: \"blob\",\n\n    async get(collection, id) {\n      const record = await readRecord(collection, id);\n      return record === null ? null : { value: record.value, version: record.version };\n    },\n\n    async insert(collection, id, value) {\n      try {\n        await client.write(\n          pathFor(collection, id),\n          JSON.stringify({ value, version: 1 }),\n          false,\n        );\n      } catch (error) {\n        if (isAlreadyExistsError(error)) {\n          throw new RecordExistsError(collection, id);\n        }\n        throw error;\n      }\n    },\n\n    async update(collection, id, value, expectedVersion) {\n      const existing = await readRecord(collection, id);\n      if (existing === null) {\n        throw new RecordNotFoundError(collection, id);\n      }\n      if (existing.version !== expectedVersion) {\n        throw new VersionConflictError(collection, id, expectedVersion);\n      }\n      try {\n        await client.write(\n          pathFor(collection, id),\n          JSON.stringify({ value, version: expectedVersion + 1 }),\n          true,\n          // The write API's ifMatch rejects the weak form (W/\"…\") that reads return.\n          existing.etag.replace(/^W\\//u, \"\"),\n        );\n      } catch (error) {\n        if (isPreconditionError(error)) {\n          throw new VersionConflictError(collection, id, expectedVersion);\n        }\n        throw error;\n      }\n    },\n\n    async list(collection) {\n      const dir = `${prefix}/${collection}/`;\n      const paths = await client.listPaths(dir);\n      const entries: (StoredEntry | null)[] = new Array(paths.length);\n      let next = 0;\n      const workers = Array.from(\n        { length: Math.min(readConcurrency, paths.length) },\n        async () => {\n          while (next < paths.length) {\n            const index = next++;\n            const pathname = paths[index]!;\n            const id = pathname.slice(dir.length).replace(/\\.json$/u, \"\");\n            const record = await readRecord(collection, id);\n            entries[index] = record === null\n              ? null\n              : { id, record: { value: record.value, version: record.version } };\n          }\n        },\n      );\n      await Promise.all(workers);\n      return entries.filter((entry): entry is StoredEntry => entry !== null);\n    },\n  };\n}\n"],"mappings":";;;AA0BA,SAAS,gBAAgB,OAAyB;CAChD,OACE,iBAAiB,UAChB,MAAM,SAAS,uBACd,kCAAkC,KAAK,MAAM,OAAO;AAE1D;AAEA,SAAS,qBAAqB,OAAyB;CACrD,OACE,iBAAiB,SACjB,sDAAsD,KAAK,MAAM,OAAO;AAE5E;AAGA,SAAS,oBAAoB,OAAyB;CACpD,OACE,iBAAiB,UAChB,MAAM,SAAS,iCAAiC,0BAA0B,KAAK,MAAM,OAAO;AAEjG;AAEA,MAAa,mBAA+B;CAC1C,MAAM,KAAK,UAAU;EACnB,IAAI;EACJ,IAAI;GAEF,SAAS,MAAM,IAAI,UAAU;IAAE,QAAQ;IAAW,UAAU;GAAM,CAAC;EACrE,SAAS,OAAO;GACd,IAAI,gBAAgB,KAAK,GACvB,OAAO;GAET,MAAM;EACR;EACA,IAAI,WAAW,QAAQ,OAAO,WAAW,MACvC,OAAO;EAET,OAAO;GAAE,MAAM,MAAM,IAAI,SAAS,OAAO,MAAM,CAAC,CAAC,KAAK;GAAG,MAAM,OAAO,KAAK;EAAK;CAClF;CAEA,MAAM,MAAM,UAAU,MAAM,WAAW,SAAS;EAC9C,MAAM,IAAI,UAAU,MAAM;GACxB,QAAQ;GACR,gBAAgB;GAChB,aAAa;GACb,GAAI,YAAY,KAAA,IAAY,CAAC,IAAI,EAAE,QAAQ;EAC7C,CAAC;CACH;CAEA,MAAM,UAAU,QAAQ;EACtB,MAAM,QAAkB,CAAC;EACzB,IAAI;EACJ,GAAG;GACD,MAAM,OAAO,MAAM,KAAK;IAAE;IAAQ;IAAQ,OAAO;GAAK,CAAC;GACvD,MAAM,KAAK,GAAG,KAAK,MAAM,KAAK,SAAS,KAAK,QAAQ,CAAC;GACrD,SAAS,KAAK,UAAU,KAAK,SAAS,KAAA;EACxC,SAAS,WAAW,KAAA;EACpB,OAAO;CACT;AACF;;;;;;;;AAiBA,SAAgB,iBAAiB,UAA6B,CAAC,GAAgB;CAC7E,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,kBAAkB,QAAQ,mBAAmB;CACnD,IAAI,CAAC,OAAO,UAAU,eAAe,KAAK,kBAAkB,GAC1D,MAAM,IAAI,MAAM,kDAAkD;CAGpE,SAAS,QAAQ,YAA4B,IAAoB;EAC/D,OAAO,GAAG,OAAO,GAAG,WAAW,GAAG,GAAG;CACvC;CAEA,eAAe,WACb,YACA,IACmE;EACnE,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,OAAO,KAAK,QAAQ,YAAY,EAAE,CAAC;EACpD,SAAS,OAAO;GACd,IAAI,gBAAgB,KAAK,GACvB,OAAO;GAET,MAAM;EACR;EACA,IAAI,WAAW,MACb,OAAO;EAET,MAAM,SAAS,KAAK,MAAM,OAAO,IAAI;EACrC,IAAI,OAAO,OAAO,YAAY,UAC5B,MAAM,IAAI,MAAM,8BAA8B,QAAQ,YAAY,EAAE,GAAG;EAEzE,OAAO;GAAE,OAAO,OAAO;GAAO,SAAS,OAAO;GAAS,MAAM,OAAO;EAAK;CAC3E;CAEA,OAAO;EACL,MAAM;EAEN,MAAM,IAAI,YAAY,IAAI;GACxB,MAAM,SAAS,MAAM,WAAW,YAAY,EAAE;GAC9C,OAAO,WAAW,OAAO,OAAO;IAAE,OAAO,OAAO;IAAO,SAAS,OAAO;GAAQ;EACjF;EAEA,MAAM,OAAO,YAAY,IAAI,OAAO;GAClC,IAAI;IACF,MAAM,OAAO,MACX,QAAQ,YAAY,EAAE,GACtB,KAAK,UAAU;KAAE;KAAO,SAAS;IAAE,CAAC,GACpC,KACF;GACF,SAAS,OAAO;IACd,IAAI,qBAAqB,KAAK,GAC5B,MAAM,IAAI,kBAAkB,YAAY,EAAE;IAE5C,MAAM;GACR;EACF;EAEA,MAAM,OAAO,YAAY,IAAI,OAAO,iBAAiB;GACnD,MAAM,WAAW,MAAM,WAAW,YAAY,EAAE;GAChD,IAAI,aAAa,MACf,MAAM,IAAI,oBAAoB,YAAY,EAAE;GAE9C,IAAI,SAAS,YAAY,iBACvB,MAAM,IAAI,qBAAqB,YAAY,IAAI,eAAe;GAEhE,IAAI;IACF,MAAM,OAAO,MACX,QAAQ,YAAY,EAAE,GACtB,KAAK,UAAU;KAAE;KAAO,SAAS,kBAAkB;IAAE,CAAC,GACtD,MAEA,SAAS,KAAK,QAAQ,SAAS,EAAE,CACnC;GACF,SAAS,OAAO;IACd,IAAI,oBAAoB,KAAK,GAC3B,MAAM,IAAI,qBAAqB,YAAY,IAAI,eAAe;IAEhE,MAAM;GACR;EACF;EAEA,MAAM,KAAK,YAAY;GACrB,MAAM,MAAM,GAAG,OAAO,GAAG,WAAW;GACpC,MAAM,QAAQ,MAAM,OAAO,UAAU,GAAG;GACxC,MAAM,UAAkC,IAAI,MAAM,MAAM,MAAM;GAC9D,IAAI,OAAO;GACX,MAAM,UAAU,MAAM,KACpB,EAAE,QAAQ,KAAK,IAAI,iBAAiB,MAAM,MAAM,EAAE,GAClD,YAAY;IACV,OAAO,OAAO,MAAM,QAAQ;KAC1B,MAAM,QAAQ;KAEd,MAAM,KADW,MAAM,MACJ,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,QAAQ,YAAY,EAAE;KAC5D,MAAM,SAAS,MAAM,WAAW,YAAY,EAAE;KAC9C,QAAQ,SAAS,WAAW,OACxB,OACA;MAAE;MAAI,QAAQ;OAAE,OAAO,OAAO;OAAO,SAAS,OAAO;MAAQ;KAAE;IACrE;GACF,CACF;GACA,MAAM,QAAQ,IAAI,OAAO;GACzB,OAAO,QAAQ,QAAQ,UAAgC,UAAU,IAAI;EACvE;CACF;AACF"}

package/dist/budget-DzSiIA4t.mjs

@@ -0,0 +1,42 @@
+import { d as isoDateTimeSchema, m as usdSchema, o as repositoryIdSchema, p as schemaVersionSchema, r as factoryIdSchema } from "./id-BLIkCVue.mjs";
+import { z } from "zod";
+//#region src/schema/repository.ts
+const repositorySlugSchema = z.string().regex(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?\/[a-z0-9._-]+$/).describe("owner/name, lowercase, e.g. acme/web.");
+const repositorySchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	id: repositoryIdSchema,
+	slug: repositorySlugSchema,
+	defaultBranch: z.string().min(1).describe("Branch changes land on, usually main."),
+	enabled: z.boolean().describe("Whether the factory may work on this repository."),
+	dependsOn: z.array(repositorySlugSchema).describe("Slugs of repositories this one consumes, for multi-repo work ordering."),
+	devbox: z.strictObject({
+		projectId: z.string().min(1),
+		teamId: z.string().min(1),
+		snapshot: z.string().min(1).optional().describe("Prebuilt snapshot to boot from.")
+	}).optional().describe("Devbox execution config. Absent when this repository never uses devboxes."),
+	connectedAt: isoDateTimeSchema
+});
+//#endregion
+//#region src/schema/budget.ts
+const budgetMonthSchema = z.string().regex(/^\d{4}-(0[1-9]|1[0-2])$/);
+const budgetLimitsSchema = z.strictObject({
+	totalUsd: usdSchema,
+	investigationUsd: usdSchema,
+	perTaskReservationUsd: usdSchema,
+	warningPercent: z.number().int().min(1).max(100),
+	perRepositoryUsd: z.record(repositorySlugSchema, usdSchema).optional()
+});
+const budgetSchema = z.strictObject({
+	schemaVersion: schemaVersionSchema,
+	factoryId: factoryIdSchema,
+	month: budgetMonthSchema,
+	limits: budgetLimitsSchema,
+	notices: z.strictObject({
+		warningAt: isoDateTimeSchema.optional(),
+		exhaustedAt: isoDateTimeSchema.optional()
+	})
+});
+//#endregion
+export { repositorySlugSchema as a, repositorySchema as i, budgetMonthSchema as n, budgetSchema as r, budgetLimitsSchema as t };
+
+//# sourceMappingURL=budget-DzSiIA4t.mjs.map

package/dist/budget-DzSiIA4t.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-DzSiIA4t.mjs","names":[],"sources":["../src/schema/repository.ts","../src/schema/budget.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema } from \"./common\";\nimport { repositoryIdSchema } from \"./id\";\n\nexport const repositorySlugSchema = z\n  .string()\n  .regex(/^[a-z0-9]([a-z0-9-]*[a-z0-9])?\\/[a-z0-9._-]+$/)\n  .describe(\"owner/name, lowercase, e.g. acme/web.\");\n\nexport const repositorySchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  id: repositoryIdSchema,\n  slug: repositorySlugSchema,\n  defaultBranch: z.string().min(1).describe(\"Branch changes land on, usually main.\"),\n  enabled: z.boolean().describe(\"Whether the factory may work on this repository.\"),\n  dependsOn: z\n    .array(repositorySlugSchema)\n    .describe(\"Slugs of repositories this one consumes, for multi-repo work ordering.\"),\n  devbox: z\n    .strictObject({\n      projectId: z.string().min(1),\n      teamId: z.string().min(1),\n      snapshot: z.string().min(1).optional().describe(\"Prebuilt snapshot to boot from.\"),\n    })\n    .optional()\n    .describe(\"Devbox execution config. Absent when this repository never uses devboxes.\"),\n  connectedAt: isoDateTimeSchema,\n});\n\nexport type RepositorySlug = z.infer<typeof repositorySlugSchema>;\nexport type Repository = z.infer<typeof repositorySchema>;\n","import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema, usdSchema } from \"./common\";\nimport { factoryIdSchema } from \"./id\";\nimport { repositorySlugSchema } from \"./repository\";\n\nexport const budgetMonthSchema = z.string().regex(/^\\d{4}-(0[1-9]|1[0-2])$/);\n\nexport const budgetLimitsSchema = z.strictObject({\n  totalUsd: usdSchema,\n  investigationUsd: usdSchema,\n  perTaskReservationUsd: usdSchema,\n  warningPercent: z.number().int().min(1).max(100),\n  perRepositoryUsd: z.record(repositorySlugSchema, usdSchema).optional(),\n});\n\nexport const budgetSchema = z.strictObject({\n  schemaVersion: schemaVersionSchema,\n  factoryId: factoryIdSchema,\n  month: budgetMonthSchema,\n  limits: budgetLimitsSchema,\n  notices: z.strictObject({\n    warningAt: isoDateTimeSchema.optional(),\n    exhaustedAt: isoDateTimeSchema.optional(),\n  }),\n});\n\nexport type BudgetLimits = z.infer<typeof budgetLimitsSchema>;\nexport type Budget = z.infer<typeof budgetSchema>;\n"],"mappings":";;;AAIA,MAAa,uBAAuB,EACjC,OAAO,CAAC,CACR,MAAM,+CAA+C,CAAC,CACtD,SAAS,uCAAuC;AAEnD,MAAa,mBAAmB,EAAE,aAAa;CAC7C,eAAe;CACf,IAAI;CACJ,MAAM;CACN,eAAe,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,uCAAuC;CACjF,SAAS,EAAE,QAAQ,CAAC,CAAC,SAAS,kDAAkD;CAChF,WAAW,EACR,MAAM,oBAAoB,CAAC,CAC3B,SAAS,wEAAwE;CACpF,QAAQ,EACL,aAAa;EACZ,WAAW,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;EAC3B,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC;EACxB,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,iCAAiC;CACnF,CAAC,CAAC,CACD,SAAS,CAAC,CACV,SAAS,2EAA2E;CACvF,aAAa;AACf,CAAC;;;ACtBD,MAAa,oBAAoB,EAAE,OAAO,CAAC,CAAC,MAAM,yBAAyB;AAE3E,MAAa,qBAAqB,EAAE,aAAa;CAC/C,UAAU;CACV,kBAAkB;CAClB,uBAAuB;CACvB,gBAAgB,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG;CAC/C,kBAAkB,EAAE,OAAO,sBAAsB,SAAS,CAAC,CAAC,SAAS;AACvE,CAAC;AAED,MAAa,eAAe,EAAE,aAAa;CACzC,eAAe;CACf,WAAW;CACX,OAAO;CACP,QAAQ;CACR,SAAS,EAAE,aAAa;EACtB,WAAW,kBAAkB,SAAS;EACtC,aAAa,kBAAkB,SAAS;CAC1C,CAAC;AACH,CAAC"}

package/dist/build-factory.mjs

@@ -1,4 +1,4 @@
-import { n as defineFactory } from "./factory-config-BJcjsPKl.mjs";
+import { n as defineFactory } from "./factory-config-BoRXOw43.mjs";
 import { readdirSync } from "node:fs";
 import path from "node:path";
 //#region src/build-factory.ts

package/dist/{change-CzEAoFVE.mjs → change-D2U6v7Ek.mjs}

@@ -1,5 +1,5 @@
-import { d as schemaVersionSchema, i as repositoryIdSchema, l as isoDateTimeSchema, n as factoryIdSchema, s as taskIdSchema, t as changeIdSchema } from "./id-DwCihQr4.mjs";
-import { _ as taskExecutionRepositoryIdsSchema } from "./approval-CwhTP1XB.mjs";
+import { d as isoDateTimeSchema, l as taskIdSchema, n as changeIdSchema, o as repositoryIdSchema, p as schemaVersionSchema, r as factoryIdSchema } from "./id-BLIkCVue.mjs";
+import { o as taskExecutionRepositoryIdsSchema } from "./task-CcOyOJ3k.mjs";
 import { n as RecordNotFoundError, r as VersionConflictError } from "./driver-Bbd25rNM.mjs";
 import { z } from "zod";
 import { createHash } from "node:crypto";
@@ -125,78 +125,6 @@ async function sweepBudget(stores, options) {
 	};
 }
 //#endregion
-//#region src/coordination.ts
-/** Create one non-executable parent and one independently executable child per repository. */
-async function createCoordination(stores, input) {
-	const repositoryIds = [...new Set(input.repositoryIds)];
-	if (repositoryIds.length < 2) throw new Error("coordination requires at least two distinct repositories");
-	const parent = await stores.tasks.create({
-		repositoryIds,
-		kind: "coordination",
-		origin: input.signalId === void 0 ? { operator: input.operator } : { signalId: input.signalId },
-		replyTo: input.replyTo,
-		dedupeKey: input.dedupeKey
-	});
-	return {
-		parent: parent.state === "queued" ? await stores.tasks.transition(parent.id, "running", { reason: "repository-scoped child tasks created" }) : parent,
-		children: await Promise.all(repositoryIds.map((repositoryId) => stores.tasks.create({
-			repositoryIds: [repositoryId],
-			kind: "code_change",
-			origin: { parentTaskId: parent.id },
-			replyTo: input.replyTo,
-			dedupeKey: input.dedupeKey === void 0 ? void 0 : `${input.dedupeKey}:${repositoryId}`
-		})))
-	};
-}
-/** Reconcile a coordination parent from its direct children without ever dispatching the parent. */
-async function reconcileCoordination(stores, parentTaskId, options) {
-	const parent = await stores.tasks.get(parentTaskId);
-	if (parent === null) throw new RecordNotFoundError("tasks", parentTaskId);
-	if (parent.kind !== "coordination") throw new Error(`task ${parentTaskId} is ${parent.kind}, not coordination`);
-	const children = (await stores.tasks.list()).filter((task) => task.origin.parentTaskId === parentTaskId);
-	if (children.length !== parent.repositoryIds.length) return {
-		status: "pending",
-		parent,
-		children
-	};
-	if (parent.state === "succeeded" || parent.state === "failed") return {
-		status: parent.state,
-		transitioned: false,
-		parent,
-		children
-	};
-	if (children.some((child) => child.state === "failed" || child.state === "cancelled")) {
-		await options.present({
-			status: "failed",
-			parent,
-			children
-		});
-		return {
-			status: "failed",
-			transitioned: true,
-			parent: await stores.tasks.transition(parent.id, "failed", { reason: "one or more repository tasks failed" }),
-			children
-		};
-	}
-	if (!children.every((child) => child.state === "succeeded")) return {
-		status: "pending",
-		parent,
-		children
-	};
-	await options.present({
-		status: "succeeded",
-		parent,
-		children
-	});
-	await stores.tasks.transition(parent.id, "verifying", { reason: "all repository tasks succeeded" });
-	return {
-		status: "succeeded",
-		transitioned: true,
-		parent: await stores.tasks.transition(parent.id, "succeeded", { reason: "aggregate multi-repository handoff is ready" }),
-		children
-	};
-}
-//#endregion
 //#region src/schema/transitions.ts
 const taskInitialState = "queued";
 const taskTransitions = [
@@ -329,6 +257,12 @@ const taskTransitions = [
 ];
 const changeInitialState = "verifying";
 const changeTransitions = [
+	{
+		from: "ready",
+		to: "verifying",
+		trigger: "a code_change task updated the existing pull request head",
+		actor: "reconciler"
+	},
 	{
 		from: "verifying",
 		to: "ready",
@@ -615,6 +549,6 @@ const changeSchema = z.strictObject({
 	});
 });
 //#endregion
-export { budgetStatus as C, sweepBudget as D, deriveFactoryId as E, sweepSettlements as O, budgetMonthOf as S, computeMonthSpendUsd as T, taskInitialState as _, BudgetExhaustedError as a, createCoordination as b, dispatchTask as c, changeInitialState as d, changeTransitions as f, signalOutcomeTransitions as g, signalInitialOutcome as h, levelSchema as i, InvalidTransitionError as l, legalNextStates as m, changeSchema as n, DEFAULT_MAX_LAUNCH_ATTEMPTS as o, isTransitionAllowed as p, changeStateSchema as r, DispatchRefusedError as s, changeEvidenceSchema as t, assertTransition as u, taskTransitions as v, canReserve as w, reconcileCoordination as x, terminalStates as y };
+export { computeMonthSpendUsd as C, sweepSettlements as E, canReserve as S, sweepBudget as T, taskInitialState as _, BudgetExhaustedError as a, budgetMonthOf as b, dispatchTask as c, changeInitialState as d, changeTransitions as f, signalOutcomeTransitions as g, signalInitialOutcome as h, levelSchema as i, InvalidTransitionError as l, legalNextStates as m, changeSchema as n, DEFAULT_MAX_LAUNCH_ATTEMPTS as o, isTransitionAllowed as p, changeStateSchema as r, DispatchRefusedError as s, changeEvidenceSchema as t, assertTransition as u, taskTransitions as v, deriveFactoryId as w, budgetStatus as x, terminalStates as y };
 
-//# sourceMappingURL=change-CzEAoFVE.mjs.map
+//# sourceMappingURL=change-D2U6v7Ek.mjs.map

package/dist/change-D2U6v7Ek.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-D2U6v7Ek.mjs","names":[],"sources":["../src/budget.ts","../src/schema/transitions.ts","../src/dispatch.ts","../src/schema/change.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { factoryIdSchema, type FactoryId, type TaskId } from \"./schema/id\";\nimport type { BudgetLimits } from \"./schema/budget\";\nimport type { Task } from \"./schema/task\";\nimport type { FactoryStores } from \"./store/engine\";\n\n/**\n * Stable factory identity for budget rows. Nothing mints factory ids yet, so\n * the app derives one from a deployment-stable seed such as the Vercel\n * project id.\n */\nexport function deriveFactoryId(seed: string): FactoryId {\n  return factoryIdSchema.parse(\n    `fac_${createHash(\"sha256\").update(seed).digest(\"hex\").slice(0, 32)}`,\n  );\n}\n\n/** The budget month (\"YYYY-MM\", UTC) a timestamp falls into. */\nexport function budgetMonthOf(isoDateTime: string): string {\n  return isoDateTime.slice(0, 7);\n}\n\n// Currency math runs in integer micro-dollars so decimal limits compare\n// exactly; 0.1 + 0.2 must never refuse an exact-fit reservation.\nfunction microsOf(usd: number): number {\n  return Math.round(usd * 1_000_000);\n}\n\n/**\n * Monthly spend is derived from task rows, never stored: each task counts its\n * settled cost once that exists, otherwise its held reservation. A task\n * settles once, so a settled row never also counts its reservation.\n * Attribution uses the reservation time so tasks that wait across a month\n * boundary charge the month they actually ran in.\n */\nexport function computeMonthSpendUsd(tasks: readonly Task[], month: string): number {\n  let spendMicros = 0;\n  for (const task of tasks) {\n    if (budgetMonthOf(task.reservedAt ?? task.createdAt) !== month) {\n      continue;\n    }\n    spendMicros += microsOf(task.settledUsd ?? task.reservedUsd ?? 0);\n  }\n  return spendMicros / 1_000_000;\n}\n\nexport type BudgetStatus = \"ok\" | \"warning\" | \"exhausted\";\n\n/**\n * True when one more per-task slice fits under the monthly total. Dispatch\n * refuses on this exact predicate and budgetStatus reports \"exhausted\" on its\n * negation, so refusing and reporting can never disagree.\n */\nexport function canReserve(\n  spendUsd: number,\n  limits: Pick<BudgetLimits, \"totalUsd\" | \"perTaskReservationUsd\">,\n): boolean {\n  return microsOf(spendUsd) + microsOf(limits.perTaskReservationUsd) <= microsOf(limits.totalUsd);\n}\n\nexport function budgetStatus(\n  spendUsd: number,\n  limits: Pick<BudgetLimits, \"totalUsd\" | \"perTaskReservationUsd\" | \"warningPercent\">,\n): BudgetStatus {\n  if (!canReserve(spendUsd, limits)) {\n    return \"exhausted\";\n  }\n  // Integer comparison: spend/total * 100 >= warningPercent without float\n  // drift on decimal limits.\n  if (microsOf(spendUsd) * 100 >= microsOf(limits.totalUsd) * limits.warningPercent) {\n    return \"warning\";\n  }\n  return \"ok\";\n}\n\nconst TERMINAL_TASK_STATES = new Set<Task[\"state\"]>([\"succeeded\", \"failed\", \"cancelled\"]);\n\nexport interface SettleSweepOptions {\n  /** How long a terminal task waits for late usage before the sweep settles it. */\n  graceMinutes?: number;\n  now?: () => Date;\n}\n\nexport interface SettleSweepResult {\n  settled: { taskId: TaskId; totalUsd: number }[];\n}\n\n/**\n * Settle reserved terminal tasks the session hook did not: a task that ended\n * after its session (a change verified later) or whose session died. Settles\n * at the recorded usage, or at zero with a warning reason when none was\n * recorded within the grace window.\n */\nexport async function sweepSettlements(\n  stores: FactoryStores,\n  options: SettleSweepOptions = {},\n): Promise<SettleSweepResult> {\n  const graceMs = (options.graceMinutes ?? 10) * 60_000;\n  const nowMs = (options.now ?? (() => new Date()))().getTime();\n  const settled: SettleSweepResult[\"settled\"] = [];\n  for (const task of await stores.tasks.list()) {\n    if (task.reservedUsd === undefined || task.settledUsd !== undefined) {\n      continue;\n    }\n    if (!TERMINAL_TASK_STATES.has(task.state)) {\n      continue;\n    }\n    if (nowMs - Date.parse(task.updatedAt) < graceMs) {\n      continue;\n    }\n    // A concurrent writer (operator retry, another sweep) may move the task\n    // between the list and the settle; skip it rather than aborting the pass.\n    const totalUsd = task.usage?.costUsd ?? 0;\n    try {\n      const result = await stores.tasks.settle(\n        task.id,\n        { totalUsd },\n        {\n          reason: task.usage === undefined\n            ? \"usage missing after ten minutes; settled at zero\"\n            : \"measured usage settled by sweep\",\n        },\n      );\n      // Report this settlement's amount, not the task's accumulated total.\n      settled.push({ taskId: result.id, totalUsd });\n    } catch {\n      continue;\n    }\n  }\n  return { settled };\n}\n\nexport interface BudgetNotice {\n  outcome: \"budget_warning\" | \"budget_exhausted\";\n  month: string;\n  spendUsd: number;\n  limits: BudgetLimits;\n}\n\nexport interface BudgetSweepOptions {\n  factoryId: FactoryId;\n  limits: BudgetLimits;\n  /** Defaults to the current UTC month. */\n  month?: string;\n  now?: () => Date;\n  /** Owner-only delivery; invoked at most once per month per outcome. */\n  notify?: (notice: BudgetNotice) => Promise<void>;\n}\n\nexport interface BudgetSweepResult {\n  month: string;\n  spendUsd: number;\n  status: BudgetStatus;\n  warned: boolean;\n  exhausted: boolean;\n}\n\n/**\n * Ensure the month's budget row, derive spend, and record threshold crossings\n * write-once. Delivery comes first and the stamp only lands after it, so a\n * failed notification retries on the next sweep instead of being lost; the\n * write-once stamp still keeps each threshold to one message per month.\n */\nexport async function sweepBudget(\n  stores: FactoryStores,\n  options: BudgetSweepOptions,\n): Promise<BudgetSweepResult> {\n  const now = options.now ?? (() => new Date());\n  const month = options.month ?? budgetMonthOf(now().toISOString());\n  const budget = await stores.budgets.ensure({\n    factoryId: options.factoryId,\n    month,\n    limits: options.limits,\n  });\n  const spendUsd = computeMonthSpendUsd(await stores.tasks.list(), month);\n  const status = budgetStatus(spendUsd, options.limits);\n\n  async function crossThreshold(\n    notice: \"warning\" | \"exhausted\",\n    outcome: BudgetNotice[\"outcome\"],\n  ): Promise<boolean> {\n    const field = notice === \"warning\" ? \"warningAt\" : \"exhaustedAt\";\n    if (budget.notices[field] !== undefined) {\n      return false;\n    }\n    if (options.notify !== undefined) {\n      try {\n        await options.notify({ outcome, month, spendUsd, limits: options.limits });\n      } catch {\n        // Leave the notice unstamped so the next sweep retries delivery.\n        return false;\n      }\n    }\n    return (await stores.budgets.stampNotice(month, notice)).stamped;\n  }\n\n  let warned = false;\n  let exhausted = false;\n  if (status === \"exhausted\") {\n    exhausted = await crossThreshold(\"exhausted\", \"budget_exhausted\");\n    // The warning threshold was necessarily crossed too; stamp it silently so\n    // a later settle-down cannot deliver \"warning\" after \"exhausted\".\n    if (budget.notices.warningAt === undefined) {\n      await stores.budgets.stampNotice(month, \"warning\");\n    }\n  } else if (status === \"warning\") {\n    warned = await crossThreshold(\"warning\", \"budget_warning\");\n  }\n  return { month, spendUsd, status, warned, exhausted };\n}\n","import type { ChangeState } from \"./change\";\nimport type { SignalOutcome } from \"./signal\";\nimport type { TaskState } from \"./task\";\n\nexport type TransitionActor =\n  | \"system\"\n  | \"reconciler\"\n  | \"foreman\"\n  | \"operator\"\n  | \"webhook\"\n  | \"human\";\n\nexport interface Transition<State extends string> {\n  readonly from: State;\n  readonly to: State;\n  readonly trigger: string;\n  readonly actor: TransitionActor;\n}\n\nexport const taskInitialState = \"queued\" satisfies TaskState;\n\nexport const taskTransitions: readonly Transition<TaskState>[] = [\n  {\n    from: \"queued\",\n    to: \"running\",\n    trigger: \"dependencies have a change, reservation succeeded, devbox created\",\n    actor: \"reconciler\",\n  },\n  { from: \"queued\", to: \"failed\", trigger: \"reservation refused\", actor: \"reconciler\" },\n  { from: \"queued\", to: \"needs_human\", trigger: \"kind is question\", actor: \"system\" },\n  { from: \"queued\", to: \"cancelled\", trigger: \"cancel or kill\", actor: \"operator\" },\n  { from: \"running\", to: \"verifying\", trigger: \"devbox task reported complete\", actor: \"reconciler\" },\n  {\n    from: \"running\",\n    to: \"queued\",\n    trigger: \"launch failed below attempt limit\",\n    actor: \"reconciler\",\n  },\n  {\n    from: \"running\",\n    to: \"failed\",\n    trigger: \"devbox task errored, deadline exceeded, or launch failed at attempt limit\",\n    actor: \"reconciler\",\n  },\n  {\n    from: \"running\",\n    to: \"needs_human\",\n    trigger: \"an open QuestionTask requests human input or action\",\n    actor: \"reconciler\",\n  },\n  { from: \"running\", to: \"cancelled\", trigger: \"cancel or kill\", actor: \"operator\" },\n  { from: \"running\", to: \"stalled\", trigger: \"no progress within the stall window\", actor: \"reconciler\" },\n  {\n    from: \"stalled\",\n    to: \"queued\",\n    trigger: \"replacement attempt below attempt limit, or operator retry\",\n    actor: \"reconciler\",\n  },\n  { from: \"stalled\", to: \"failed\", trigger: \"attempt limit exhausted\", actor: \"reconciler\" },\n  { from: \"stalled\", to: \"cancelled\", trigger: \"cancel or kill\", actor: \"operator\" },\n  { from: \"verifying\", to: \"succeeded\", trigger: \"kind criterion true\", actor: \"reconciler\" },\n  {\n    from: \"verifying\",\n    to: \"running\",\n    trigger: \"verification failed below attempt limit\",\n    actor: \"reconciler\",\n  },\n  {\n    from: \"verifying\",\n    to: \"failed\",\n    trigger: \"verification failed at attempt limit\",\n    actor: \"reconciler\",\n  },\n  { from: \"verifying\", to: \"cancelled\", trigger: \"cancel or kill\", actor: \"operator\" },\n  { from: \"needs_human\", to: \"succeeded\", trigger: \"question answered\", actor: \"operator\" },\n  { from: \"needs_human\", to: \"queued\", trigger: \"operator retry\", actor: \"operator\" },\n  { from: \"needs_human\", to: \"cancelled\", trigger: \"cancel or kill\", actor: \"operator\" },\n  { from: \"failed\", to: \"queued\", trigger: \"operator retry\", actor: \"operator\" },\n];\n\nexport const changeInitialState = \"verifying\" satisfies ChangeState;\n\nexport const changeTransitions: readonly Transition<ChangeState>[] = [\n  {\n    from: \"ready\",\n    to: \"verifying\",\n    trigger: \"a code_change task updated the existing pull request head\",\n    actor: \"reconciler\",\n  },\n  {\n    from: \"verifying\",\n    to: \"ready\",\n    trigger: \"configured verification policy completed, risk and confidence written\",\n    actor: \"reconciler\",\n  },\n  {\n    from: \"verifying\",\n    to: \"closed\",\n    trigger: \"verification failed at attempt limit or pr closed upstream\",\n    actor: \"reconciler\",\n  },\n  { from: \"ready\", to: \"merged\", trigger: \"pr merged on github\", actor: \"webhook\" },\n  { from: \"ready\", to: \"closed\", trigger: \"pr closed without merge\", actor: \"webhook\" },\n  {\n    from: \"merged\",\n    to: \"deployed\",\n    trigger: \"production deployment ready containing the merge sha\",\n    actor: \"webhook\",\n  },\n  {\n    from: \"deployed\",\n    to: \"rolled_out\",\n    trigger: \"no flag, or flag ramped to full and held\",\n    actor: \"foreman\",\n  },\n  { from: \"deployed\", to: \"rolled_back\", trigger: \"rollback rule crossed\", actor: \"foreman\" },\n  {\n    from: \"rolled_out\",\n    to: \"rolled_back\",\n    trigger: \"rollback rule crossed or flag flipped off\",\n    actor: \"foreman\",\n  },\n  { from: \"rolled_back\", to: \"deployed\", trigger: \"human retried the ramp\", actor: \"human\" },\n];\n\nexport const signalInitialOutcome = \"pending\" satisfies SignalOutcome;\n\nexport const signalOutcomeTransitions: readonly Transition<SignalOutcome>[] = [\n  { from: \"pending\", to: \"accepted\", trigger: \"classified as actionable\", actor: \"reconciler\" },\n  { from: \"pending\", to: \"duplicate\", trigger: \"classified as duplicate\", actor: \"reconciler\" },\n  {\n    from: \"pending\",\n    to: \"unactionable\",\n    trigger: \"classified as unactionable\",\n    actor: \"reconciler\",\n  },\n  {\n    from: \"pending\",\n    to: \"low_confidence\",\n    trigger: \"classified below confidence threshold\",\n    actor: \"reconciler\",\n  },\n  { from: \"pending\", to: \"ignored\", trigger: \"classified as ignorable\", actor: \"reconciler\" },\n];\n\nexport function isTransitionAllowed<State extends string>(\n  transitions: readonly Transition<State>[],\n  from: State,\n  to: State,\n): boolean {\n  return transitions.some((transition) => transition.from === from && transition.to === to);\n}\n\nexport function legalNextStates<State extends string>(\n  transitions: readonly Transition<State>[],\n  from: State,\n): readonly State[] {\n  return [\n    ...new Set(\n      transitions.filter((transition) => transition.from === from).map((t) => t.to),\n    ),\n  ];\n}\n\nexport class InvalidTransitionError<State extends string> extends Error {\n  readonly from: State;\n  readonly to: State;\n  readonly legalNextStates: readonly State[];\n\n  constructor(from: State, to: State, legal: readonly State[]) {\n    super(\n      legal.length > 0\n        ? `invalid transition from \"${from}\" to \"${to}\"; legal next states: ${legal\n            .map((state) => `\"${state}\"`)\n            .join(\", \")}`\n        : `invalid transition from \"${from}\" to \"${to}\"; \"${from}\" is terminal`,\n    );\n    this.name = \"InvalidTransitionError\";\n    this.from = from;\n    this.to = to;\n    this.legalNextStates = legal;\n  }\n}\n\nexport function assertTransition<State extends string>(\n  transitions: readonly Transition<State>[],\n  from: State,\n  to: State,\n): void {\n  if (!isTransitionAllowed(transitions, from, to)) {\n    throw new InvalidTransitionError(from, to, legalNextStates(transitions, from));\n  }\n}\n\nexport function terminalStates<State extends string>(\n  transitions: readonly Transition<State>[],\n): readonly State[] {\n  const states = new Set<State>();\n  for (const transition of transitions) {\n    states.add(transition.from);\n    states.add(transition.to);\n  }\n  return [...states].filter(\n    (state) => !transitions.some((transition) => transition.from === state),\n  );\n}\n","import { budgetMonthOf, canReserve, computeMonthSpendUsd } from \"./budget\";\nimport type { BudgetLimits } from \"./schema/budget\";\nimport type { TaskId } from \"./schema/id\";\nimport { taskExecutionRepositoryIdsSchema, type ExecutionReference, type Task } from \"./schema/task\";\nimport { InvalidTransitionError } from \"./schema/transitions\";\nimport { RecordNotFoundError, VersionConflictError } from \"./store/driver\";\nimport type { FactoryStores } from \"./store/engine\";\n\nexport class DispatchRefusedError extends Error {\n  readonly taskId: TaskId;\n  readonly reason: string;\n\n  constructor(taskId: TaskId, reason: string) {\n    super(`dispatch of \"${taskId}\" refused: ${reason}`);\n    this.name = \"DispatchRefusedError\";\n    this.taskId = taskId;\n    this.reason = reason;\n  }\n}\n\n/**\n * An exhausted budget is definitive, not a retryable refusal: the task has\n * already been failed and receipted when this throws, so it never re-enters\n * the sweep. Operator retry recovers it once budget frees up.\n */\nexport class BudgetExhaustedError extends Error {\n  readonly taskId: TaskId;\n  readonly month: string;\n  readonly spendUsd: number;\n\n  constructor(taskId: TaskId, month: string, spendUsd: number) {\n    super(`dispatch of \"${taskId}\" refused: budget for ${month} is exhausted at $${spendUsd}`);\n    this.name = \"BudgetExhaustedError\";\n    this.taskId = taskId;\n    this.month = month;\n    this.spendUsd = spendUsd;\n  }\n}\n\nexport interface DispatchBudget {\n  limits: Pick<BudgetLimits, \"totalUsd\" | \"perTaskReservationUsd\">;\n  /** Defaults to the current UTC month. */\n  month?: string;\n  now?: () => Date;\n}\n\nexport interface DispatchOptions {\n  /**\n   * Starts the durable execution for the task (an Eve agent run). Runs after\n   * the task has won the queued -> running transition. Returning the\n   * provider's execution reference records it on the task so the reconciler\n   * can find the run; returning nothing leaves the task reachable only by the\n   * stall window.\n   */\n  launch: (task: Task) => Promise<ExecutionReference | void>;\n  /** How many launches to try before the task fails for good; a failure re-queues for the next sweep. */\n  maxLaunchAttempts?: number;\n  /**\n   * Reserve-before-execution. When set, dispatch refuses definitively once\n   * the month's derived spend cannot fit another reservation, and otherwise\n   * stamps the reservation in the same write that wins queued -> running.\n   */\n  budget?: DispatchBudget;\n}\n\n// A fresh Vercel project rejects its own agents' sessions until its identity\n// finishes provisioning; at one sweep per minute the budget must outlast that.\nexport const DEFAULT_MAX_LAUNCH_ATTEMPTS = 45;\n\n/**\n * The handshake between recorded work and execution: win the store-gated\n * transition (at most one dispatcher can succeed), then start the run. A\n * launch failure re-queues the task (bumping its attempt) until the attempt\n * limit, then fails it; a crash between the transition and the launch leaves\n * a running task with no execution, which the sweep reaps.\n */\nexport async function dispatchTask(\n  stores: FactoryStores,\n  taskId: TaskId,\n  options: DispatchOptions,\n): Promise<Task> {\n  const task = await stores.tasks.get(taskId);\n  if (task === null) {\n    throw new RecordNotFoundError(\"tasks\", taskId);\n  }\n  if (task.kind === \"question\") {\n    throw new DispatchRefusedError(taskId, \"question tasks are answered, not dispatched\");\n  }\n  if (task.kind === \"coordination\") {\n    throw new DispatchRefusedError(taskId, \"coordination tasks are reconciled, not dispatched\");\n  }\n  if (!taskExecutionRepositoryIdsSchema.safeParse(task.repositoryIds).success) {\n    throw new DispatchRefusedError(taskId, \"task execution requires exactly one repository\");\n  }\n  if (task.approval === \"required\") {\n    throw new DispatchRefusedError(taskId, \"awaiting human approval\");\n  }\n  if (task.approval === \"denied\") {\n    throw new DispatchRefusedError(taskId, \"approval was denied\");\n  }\n  for (const dependencyId of task.dependsOn ?? []) {\n    const dependency = await stores.tasks.get(dependencyId);\n    if (dependency === null) {\n      throw new DispatchRefusedError(taskId, `dependency \"${dependencyId}\" does not exist`);\n    }\n    if (dependency.changeId === undefined) {\n      throw new DispatchRefusedError(\n        taskId,\n        `dependency \"${dependencyId}\" has not produced a change`,\n      );\n    }\n  }\n\n  // The reservation gates queued -> running only; any other state falls\n  // through to the transition below, which rejects it as invalid.\n  let reservation: { reservedUsd: number; reservedAt: string } | undefined;\n  if (options.budget !== undefined && task.state === \"queued\") {\n    const budgetNow = (options.budget.now ?? (() => new Date()))().toISOString();\n    const month = options.budget.month ?? budgetMonthOf(budgetNow);\n    // This task's own retained reservation from a prior attempt is excluded,\n    // because re-reserving overwrites it. Its settled cost stays counted:\n    // that money was actually spent and a retry must not reopen it.\n    const rows = (await stores.tasks.list()).map((row) =>\n      row.id === taskId ? { ...row, reservedUsd: undefined } : row,\n    );\n    const spendUsd = computeMonthSpendUsd(rows, month);\n    const { totalUsd, perTaskReservationUsd } = options.budget.limits;\n    if (!canReserve(spendUsd, options.budget.limits)) {\n      const reason = `budget exhausted: ${month} spend $${spendUsd} cannot fit a $${perTaskReservationUsd} reservation under $${totalUsd}`;\n      // Fail first, so BudgetExhaustedError's contract (task already failed)\n      // holds; losing the task to a concurrent dispatcher surfaces as a\n      // refusal, never as a false exhaustion with a misleading receipt.\n      try {\n        await stores.tasks.transition(taskId, \"failed\", { reason, expectFrom: \"queued\" });\n      } catch (error) {\n        if (error instanceof InvalidTransitionError || error instanceof VersionConflictError) {\n          throw new DispatchRefusedError(taskId, \"another dispatcher took the task\");\n        }\n        throw error;\n      }\n      // Best-effort: the failed transition above already wrote its own\n      // receipt carrying this reason, so losing this supplementary one\n      // cannot lose the evidence.\n      if (task.repositoryIds !== undefined) {\n        await stores.receipts\n          .append({\n            repositoryIds: task.repositoryIds,\n            taskId,\n            kind: task.kind,\n            state: \"reservation_refused\",\n            phase: \"budget\",\n            reason,\n            attempt: task.attempt,\n            dedupeKey: `task:${taskId}:reservation_refused:${task.attempt}`,\n          })\n          .catch(() => undefined);\n      }\n      throw new BudgetExhaustedError(taskId, month, spendUsd);\n    }\n    reservation = { reservedUsd: perTaskReservationUsd, reservedAt: budgetNow };\n  }\n\n  // A resurrected task keeps its settled cost: multi-attempt accumulation is\n  // an open spec decision, so the first settlement stays authoritative and\n  // the new slice is only held until then.\n  const running = await stores.tasks.transition(\n    taskId,\n    \"running\",\n    reservation === undefined\n      ? undefined\n      : {\n        patch: {\n          reservedUsd: reservation.reservedUsd,\n          reservedAt: reservation.reservedAt,\n        },\n      },\n  );\n  let execution: ExecutionReference | void;\n  try {\n    execution = await options.launch(running);\n  } catch (error) {\n    const reason = (error instanceof Error ? error.message : String(error)).slice(0, 500);\n    const limit = options.maxLaunchAttempts ?? DEFAULT_MAX_LAUNCH_ATTEMPTS;\n    if (running.attempt < limit) {\n      const retryReason = `launch failed (attempt ${running.attempt} of ${limit}), will retry: ${reason}`;\n      await stores.tasks.transition(taskId, \"queued\", { reason: retryReason }).catch(() => undefined);\n      // The queued transition writes no receipt; leave one so the retry is visible.\n      if (running.repositoryIds !== undefined) {\n        await stores.receipts\n          .append({\n            repositoryIds: running.repositoryIds,\n            taskId,\n            kind: \"task\",\n            state: \"launch_retry\",\n            reason: retryReason,\n            dedupeKey: `task:${taskId}:launch_retry:${running.attempt}`,\n          })\n          .catch(() => undefined);\n      }\n    } else {\n      await stores.tasks\n        .transition(taskId, \"failed\", { reason: `launch failed after ${running.attempt} attempts: ${reason}` })\n        .catch(() => undefined);\n    }\n    throw error;\n  }\n  if (execution === undefined) {\n    return running;\n  }\n  // The run exists either way; a lost write here leaves a running task with\n  // no reference, which the stall sweep still reaps.\n  return stores.tasks.recordExecution(taskId, execution).catch(() => running);\n}\n","import { z } from \"zod\";\nimport { isoDateTimeSchema, schemaVersionSchema } from \"./common\";\nimport { changeIdSchema, repositoryIdSchema, taskIdSchema } from \"./id\";\n\nexport const levelSchema = z.enum([\"low\", \"medium\", \"high\"]);\n\nexport const changeStateSchema = z.enum([\n  \"verifying\",\n  \"ready\",\n  \"merged\",\n  \"deployed\",\n  \"rolled_out\",\n  \"rolled_back\",\n  \"closed\",\n]);\n\nconst postMergeStates: readonly string[] = [\"merged\", \"deployed\", \"rolled_out\", \"rolled_back\"];\n\nexport const changeEvidenceSchema = z.strictObject({\n  reproVerified: z.boolean(),\n  testsAdded: z.number().int().min(0),\n  checksGreen: z.boolean(),\n  attackPassed: z.boolean(),\n  scopeMatches: z.boolean(),\n  previewUrl: z.url().optional(),\n});\n\nexport const changeSchema = z\n  .strictObject({\n    schemaVersion: schemaVersionSchema,\n    id: changeIdSchema,\n    repositoryId: repositoryIdSchema,\n    taskId: taskIdSchema.optional(),\n    groupId: taskIdSchema.optional(),\n    prNumber: z.number().int().min(1),\n    prUrl: z.url(),\n    author: z.string().min(1),\n    risk: levelSchema,\n    confidence: levelSchema,\n    evidence: changeEvidenceSchema,\n    state: changeStateSchema,\n    mergeSha: z\n      .string()\n      .regex(/^[0-9a-f]{40}$/)\n      .optional()\n      .describe(\"Merge commit sha recorded when the pull request merges, matched against production deployments.\"),\n    decidedBy: z.string().min(1).optional(),\n    createdAt: isoDateTimeSchema,\n    updatedAt: isoDateTimeSchema,\n  })\n  .superRefine((change, ctx) => {\n    if (postMergeStates.includes(change.state) && change.decidedBy === undefined) {\n      ctx.addIssue({\n        code: \"custom\",\n        path: [\"decidedBy\"],\n        message: `${change.state} changes require decidedBy`,\n      });\n    }\n  });\n\nexport type Level = z.infer<typeof levelSchema>;\nexport type ChangeState = z.infer<typeof changeStateSchema>;\nexport type ChangeEvidence = z.infer<typeof changeEvidenceSchema>;\nexport type Change = z.infer<typeof changeSchema>;\n"],"mappings":"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"}

package/dist/communication-Kd9nU5RP.mjs

@@ -0,0 +1,30 @@
+import { f as replyToSchema, l as taskIdSchema, n as changeIdSchema, s as repositoryIdsSchema } from "./id-BLIkCVue.mjs";
+import { z } from "zod";
+//#region src/schema/communication.ts
+const communicationOutcomes = [
+	"accepted",
+	"started",
+	"succeeded",
+	"failed",
+	"needs_human",
+	"question",
+	"digest",
+	"rolled_back",
+	"budget_warning",
+	"budget_exhausted",
+	"message"
+];
+const communicationOutcomeSchema = z.enum(communicationOutcomes).describe("Lifecycle outcome a connector should render and deliver.");
+const communicationEventSchema = z.strictObject({
+	eventId: z.string().min(1).describe("Stable idempotency key for this delivery."),
+	repositoryIds: repositoryIdsSchema,
+	taskId: taskIdSchema.optional(),
+	changeId: changeIdSchema.optional(),
+	replyTo: replyToSchema,
+	outcome: communicationOutcomeSchema,
+	data: z.record(z.string(), z.unknown()).describe("Outcome-specific connector payload.")
+});
+//#endregion
+export { communicationOutcomeSchema as n, communicationOutcomes as r, communicationEventSchema as t };
+
+//# sourceMappingURL=communication-Kd9nU5RP.mjs.map

package/dist/communication-Kd9nU5RP.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"communication-Kd9nU5RP.mjs","names":[],"sources":["../src/schema/communication.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { replyToSchema } from \"./common\";\nimport { changeIdSchema, repositoryIdsSchema, taskIdSchema } from \"./id\";\n\nexport const communicationOutcomes = [\n  \"accepted\",\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n  \"needs_human\",\n  \"question\",\n  \"digest\",\n  \"rolled_back\",\n  \"budget_warning\",\n  \"budget_exhausted\",\n  \"message\",\n] as const;\n\nexport const communicationOutcomeSchema = z\n  .enum(communicationOutcomes)\n  .describe(\"Lifecycle outcome a connector should render and deliver.\");\n\nexport const communicationEventSchema = z.strictObject({\n  eventId: z.string().min(1).describe(\"Stable idempotency key for this delivery.\"),\n  repositoryIds: repositoryIdsSchema,\n  taskId: taskIdSchema.optional(),\n  changeId: changeIdSchema.optional(),\n  replyTo: replyToSchema,\n  outcome: communicationOutcomeSchema,\n  data: z.record(z.string(), z.unknown()).describe(\"Outcome-specific connector payload.\"),\n});\n\nexport type CommunicationOutcome = z.infer<typeof communicationOutcomeSchema>;\nexport type CommunicationEvent = z.infer<typeof communicationEventSchema>;\n"],"mappings":";;;AAIA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,6BAA6B,EACvC,KAAK,qBAAqB,CAAC,CAC3B,SAAS,0DAA0D;AAEtE,MAAa,2BAA2B,EAAE,aAAa;CACrD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,2CAA2C;CAC/E,eAAe;CACf,QAAQ,aAAa,SAAS;CAC9B,UAAU,eAAe,SAAS;CAClC,SAAS;CACT,SAAS;CACT,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,qCAAqC;AACxF,CAAC"}

package/dist/connectors/index.d.mts

@@ -1,2 +1,3 @@
-import { a as NormalizedSignal, c as communicationEventSchema, d as createCommunicationRouter, i as CommunicationRouter, l as communicationOutcomeSchema, n as CommunicationEvent, o as SignalNormalizer, r as CommunicationOutcome, s as WebhookEvent, t as CommunicationAdapter, u as communicationOutcomes } from "../index-Cy4jfXh5.mjs";
-export { CommunicationAdapter, CommunicationEvent, CommunicationOutcome, CommunicationRouter, NormalizedSignal, SignalNormalizer, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter };
+import { ct as CommunicationOutcome, dt as communicationOutcomes, lt as communicationEventSchema, st as CommunicationEvent, ut as communicationOutcomeSchema } from "../engine-DFHU2Pe-.mjs";
+import { a as WebhookEvent, c as OutboxSweepResult, i as SignalNormalizer, l as createOutboxCommunicationRouter, n as CommunicationRouter, o as createCommunicationRouter, r as NormalizedSignal, s as OutboxDeliveryOptions, t as CommunicationAdapter, u as sweepCommunicationOutbox } from "../index-Bw6hggoH.mjs";
+export { CommunicationAdapter, type CommunicationEvent, type CommunicationOutcome, CommunicationRouter, NormalizedSignal, OutboxDeliveryOptions, OutboxSweepResult, SignalNormalizer, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, sweepCommunicationOutbox };