@storyshelf/app 0.6.2 → 0.8.0

package/dist/insights/stale.mjs

@@ -0,0 +1,20 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { InsightModel } from "@storyshelf/core/models";
+import { STALE_RUN_MS } from "@storyshelf/core/retention";
+// src/insights/stale.ts
+/** Lazy interruption check: a run stuck past the stale window is failed on read. */
+/** Return the row, first marking it `interrupted` when it is stale and still in flight. */
+async function freshen(deps, row) {
+	if (!(row.status === "pending" || row.status === "running") || Date.now() - Date.parse(row.createdAt) < STALE_RUN_MS) return row;
+	await new InsightModel(deps.db).markFailed(row.id, "interrupted");
+	return {
+		...row,
+		status: "failed",
+		errorCode: "interrupted"
+	};
+}
+export { freshen };
+
+//# sourceMappingURL=stale.mjs.map

package/dist/insights/stale.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale.mjs","names":[],"sources":["../../src/insights/stale.ts"],"sourcesContent":["import { InsightModel } from \"@storyshelf/core/models\";\n/** Lazy interruption check: a run stuck past the stale window is failed on read. */\nimport { STALE_RUN_MS } from \"@storyshelf/core/retention\";\nimport type { InsightRow } from \"@storyshelf/core/schema\";\nimport type { InsightDeps } from \"./deps.ts\";\n\n/** Return the row, first marking it `interrupted` when it is stale and still in flight. */\nexport async function freshen(deps: InsightDeps, row: InsightRow): Promise<InsightRow> {\n  const inFlight = row.status === \"pending\" || row.status === \"running\";\n  if (!inFlight || Date.now() - Date.parse(row.createdAt) < STALE_RUN_MS) {\n    return row;\n  }\n  await new InsightModel(deps.db).markFailed(row.id, \"interrupted\");\n  return { ...row, status: \"failed\", errorCode: \"interrupted\" };\n}\n"],"mappings":";;;;;;;;AAOA,eAAsB,QAAQ,MAAmB,KAAsC;CAErF,IAAI,EADa,IAAI,WAAW,aAAa,IAAI,WAAW,cAC3C,KAAK,IAAI,IAAI,KAAK,MAAM,IAAI,SAAS,IAAI,cACxD,OAAO;CAET,MAAM,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC,WAAW,IAAI,IAAI,aAAa;CAChE,OAAO;EAAE,GAAG;EAAK,QAAQ;EAAU,WAAW;CAAc;AAC9D"}

package/dist/insights/usage-report.mjs

@@ -0,0 +1,59 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { AiUsageModel } from "@storyshelf/core/models";
+import { countedTokens, utcDay } from "@storyshelf/core/insights";
+// src/insights/usage-report.ts
+/** Aggregates for the site-admin AI usage page (counted tokens per day and profile). */
+const DAY_MS = 864e5;
+function addTo(map, key, make, tokens, failed) {
+	const current = map.get(key) ?? make(key);
+	const next = {
+		...current,
+		tokens: current.tokens + tokens,
+		calls: current.calls + 1
+	};
+	map.set(key, "failed" in next ? {
+		...next,
+		failed: Number(next.failed) + Number(failed)
+	} : next);
+}
+function aggregate(rows, visionWeight) {
+	const days = /* @__PURE__ */ new Map();
+	const profiles = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const tokens = countedTokens(row, row.images, { visionWeight });
+		const failed = row.status === "failed";
+		addTo(days, row.createdAt.slice(0, 10), (day) => ({
+			day,
+			tokens: 0,
+			calls: 0,
+			failed: 0
+		}), tokens, failed);
+		addTo(profiles, row.profile, (profile) => ({
+			profile,
+			tokens: 0,
+			calls: 0
+		}), tokens, failed);
+	}
+	return {
+		days: [...days.values()].toSorted((a, b) => b.day.localeCompare(a.day)),
+		profiles: [...profiles.values()].toSorted((a, b) => b.tokens - a.tokens)
+	};
+}
+/** Summarize the last `windowDays` of usage (UTC days, newest first). */
+async function buildUsageReport(deps, windowDays = 14, now = /* @__PURE__ */ new Date()) {
+	const since = (/* @__PURE__ */ new Date(now.getTime() - windowDays * DAY_MS)).toISOString();
+	const rows = await new AiUsageModel(deps.db).listSince(since);
+	const { visionWeight, dailyTokens } = deps.ai.budget();
+	const { days, profiles } = aggregate(rows, visionWeight);
+	return {
+		days,
+		profiles,
+		todayTokens: days.find((d) => d.day === utcDay(now))?.tokens ?? 0,
+		dailyTokens: dailyTokens ?? null
+	};
+}
+export { buildUsageReport };
+
+//# sourceMappingURL=usage-report.mjs.map

package/dist/insights/usage-report.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-report.mjs","names":[],"sources":["../../src/insights/usage-report.ts"],"sourcesContent":["/** Aggregates for the site-admin AI usage page (counted tokens per day and profile). */\nimport { countedTokens, utcDay } from \"@storyshelf/core/insights\";\nimport { AiUsageModel } from \"@storyshelf/core/models\";\nimport type { AiUsageRow } from \"@storyshelf/core/schema\";\nimport type { InsightDeps } from \"./deps.ts\";\n\n/** One day's totals. */\nexport interface UsageDay {\n  day: string;\n  tokens: number;\n  calls: number;\n  failed: number;\n}\n\n/** One profile's totals over the window. */\nexport interface UsageProfile {\n  profile: string;\n  tokens: number;\n  calls: number;\n}\n\n/** What the admin page shows. */\nexport interface UsageReport {\n  days: UsageDay[];\n  profiles: UsageProfile[];\n  todayTokens: number;\n  dailyTokens: number | null;\n}\n\nconst DAY_MS = 86_400_000;\n\nfunction addTo<K extends string, V extends { tokens: number; calls: number }>(\n  map: Map<string, V>,\n  key: K,\n  make: (key: K) => V,\n  tokens: number,\n  failed: boolean,\n): void {\n  const current = map.get(key) ?? make(key);\n  const next = { ...current, tokens: current.tokens + tokens, calls: current.calls + 1 };\n  map.set(key, \"failed\" in next ? { ...next, failed: Number(next.failed) + Number(failed) } : next);\n}\n\nfunction aggregate(\n  rows: AiUsageRow[],\n  visionWeight: number,\n): { days: UsageDay[]; profiles: UsageProfile[] } {\n  const days = new Map<string, UsageDay>();\n  const profiles = new Map<string, UsageProfile>();\n  for (const row of rows) {\n    const tokens = countedTokens(row, row.images, { visionWeight });\n    const failed = row.status === \"failed\";\n    addTo(\n      days,\n      row.createdAt.slice(0, 10),\n      (day) => ({ day, tokens: 0, calls: 0, failed: 0 }),\n      tokens,\n      failed,\n    );\n    addTo(profiles, row.profile, (profile) => ({ profile, tokens: 0, calls: 0 }), tokens, failed);\n  }\n  return {\n    days: [...days.values()].toSorted((a, b) => b.day.localeCompare(a.day)),\n    profiles: [...profiles.values()].toSorted((a, b) => b.tokens - a.tokens),\n  };\n}\n\n/** Summarize the last `windowDays` of usage (UTC days, newest first). */\nexport async function buildUsageReport(\n  deps: InsightDeps,\n  windowDays = 14,\n  now = new Date(),\n): Promise<UsageReport> {\n  const since = new Date(now.getTime() - windowDays * DAY_MS).toISOString();\n  const rows = await new AiUsageModel(deps.db).listSince(since);\n  const { visionWeight, dailyTokens } = deps.ai.budget();\n  const { days, profiles } = aggregate(rows, visionWeight);\n  return {\n    days,\n    profiles,\n    todayTokens: days.find((d) => d.day === utcDay(now))?.tokens ?? 0,\n    dailyTokens: dailyTokens ?? null,\n  };\n}\n"],"mappings":";;;;;;;AA6BA,MAAM,SAAS;AAEf,SAAS,MACP,KACA,KACA,MACA,QACA,QACM;CACN,MAAM,UAAU,IAAI,IAAI,GAAG,KAAK,KAAK,GAAG;CACxC,MAAM,OAAO;EAAE,GAAG;EAAS,QAAQ,QAAQ,SAAS;EAAQ,OAAO,QAAQ,QAAQ;CAAE;CACrF,IAAI,IAAI,KAAK,YAAY,OAAO;EAAE,GAAG;EAAM,QAAQ,OAAO,KAAK,MAAM,IAAI,OAAO,MAAM;CAAE,IAAI,IAAI;AAClG;AAEA,SAAS,UACP,MACA,cACgD;CAChD,MAAM,uBAAO,IAAI,IAAsB;CACvC,MAAM,2BAAW,IAAI,IAA0B;CAC/C,KAAK,MAAM,OAAO,MAAM;EACtB,MAAM,SAAS,cAAc,KAAK,IAAI,QAAQ,EAAE,aAAa,CAAC;EAC9D,MAAM,SAAS,IAAI,WAAW;EAC9B,MACE,MACA,IAAI,UAAU,MAAM,GAAG,EAAE,IACxB,SAAS;GAAE;GAAK,QAAQ;GAAG,OAAO;GAAG,QAAQ;EAAE,IAChD,QACA,MACF;EACA,MAAM,UAAU,IAAI,UAAU,aAAa;GAAE;GAAS,QAAQ;GAAG,OAAO;EAAE,IAAI,QAAQ,MAAM;CAC9F;CACA,OAAO;EACL,MAAM,CAAC,GAAG,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,IAAI,cAAc,EAAE,GAAG,CAAC;EACtE,UAAU,CAAC,GAAG,SAAS,OAAO,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM;CACzE;AACF;;AAGA,eAAsB,iBACpB,MACA,aAAa,IACb,sBAAM,IAAI,KAAK,GACO;CACtB,MAAM,yBAAQ,IAAI,KAAK,IAAI,QAAQ,IAAI,aAAa,MAAM,EAAA,CAAE,YAAY;CACxE,MAAM,OAAO,MAAM,IAAI,aAAa,KAAK,EAAE,CAAC,CAAC,UAAU,KAAK;CAC5D,MAAM,EAAE,cAAc,gBAAgB,KAAK,GAAG,OAAO;CACrD,MAAM,EAAE,MAAM,aAAa,UAAU,MAAM,YAAY;CACvD,OAAO;EACL;EACA;EACA,aAAa,KAAK,MAAM,MAAM,EAAE,QAAQ,OAAO,GAAG,CAAC,CAAC,EAAE,UAAU;EAChE,aAAa,eAAe;CAC9B;AACF"}

package/dist/insights/view.mjs

@@ -0,0 +1,47 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/insights/view.ts
+function parseResult(raw) {
+	if (!raw) return {
+		output: null,
+		meta: null
+	};
+	try {
+		const parsed = JSON.parse(raw);
+		return {
+			output: parsed.output ?? null,
+			meta: parsed.meta ?? null
+		};
+	} catch {
+		return {
+			output: null,
+			meta: null
+		};
+	}
+}
+/** Convert a stored row to its public view. */
+function toInsightView(row) {
+	const { output, meta } = parseResult(row.result);
+	return {
+		id: row.id,
+		kind: row.kind,
+		buildId: row.buildId,
+		window: row.windowKey,
+		status: row.status,
+		profile: row.profile,
+		model: row.model,
+		promptVersion: row.promptVersion,
+		verdict: row.verdict,
+		summary: row.summary,
+		output,
+		meta,
+		errorCode: row.errorCode,
+		createdAt: row.createdAt,
+		startedAt: row.startedAt,
+		finishedAt: row.finishedAt
+	};
+}
+export { toInsightView };
+
+//# sourceMappingURL=view.mjs.map

package/dist/insights/view.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.mjs","names":[],"sources":["../../src/insights/view.ts"],"sourcesContent":["/** API/UI view of an insight row (parses the stored envelope defensively). */\nimport type { InsightRow } from \"@storyshelf/core/schema\";\n\n/** Public shape of an insight. */\nexport interface InsightView {\n  id: string;\n  kind: string;\n  buildId: string | null;\n  window: string | null;\n  status: string;\n  profile: string;\n  model: string;\n  promptVersion: string;\n  verdict: string | null;\n  summary: string | null;\n  output: unknown;\n  meta: unknown;\n  errorCode: string | null;\n  createdAt: string;\n  startedAt: string | null;\n  finishedAt: string | null;\n}\n\nfunction parseResult(raw: string | null): { output: unknown; meta: unknown } {\n  if (!raw) {\n    return { output: null, meta: null };\n  }\n  try {\n    const parsed = JSON.parse(raw) as { output?: unknown; meta?: unknown };\n    return { output: parsed.output ?? null, meta: parsed.meta ?? null };\n  } catch {\n    return { output: null, meta: null };\n  }\n}\n\n/** Convert a stored row to its public view. */\nexport function toInsightView(row: InsightRow): InsightView {\n  const { output, meta } = parseResult(row.result);\n  return {\n    id: row.id,\n    kind: row.kind,\n    buildId: row.buildId,\n    window: row.windowKey,\n    status: row.status,\n    profile: row.profile,\n    model: row.model,\n    promptVersion: row.promptVersion,\n    verdict: row.verdict,\n    summary: row.summary,\n    output,\n    meta,\n    errorCode: row.errorCode,\n    createdAt: row.createdAt,\n    startedAt: row.startedAt,\n    finishedAt: row.finishedAt,\n  };\n}\n"],"mappings":";;;;AAuBA,SAAS,YAAY,KAAwD;CAC3E,IAAI,CAAC,KACH,OAAO;EAAE,QAAQ;EAAM,MAAM;CAAK;CAEpC,IAAI;EACF,MAAM,SAAS,KAAK,MAAM,GAAG;EAC7B,OAAO;GAAE,QAAQ,OAAO,UAAU;GAAM,MAAM,OAAO,QAAQ;EAAK;CACpE,QAAQ;EACN,OAAO;GAAE,QAAQ;GAAM,MAAM;EAAK;CACpC;AACF;;AAGA,SAAgB,cAAc,KAA8B;CAC1D,MAAM,EAAE,QAAQ,SAAS,YAAY,IAAI,MAAM;CAC/C,OAAO;EACL,IAAI,IAAI;EACR,MAAM,IAAI;EACV,SAAS,IAAI;EACb,QAAQ,IAAI;EACZ,QAAQ,IAAI;EACZ,SAAS,IAAI;EACb,OAAO,IAAI;EACX,eAAe,IAAI;EACnB,SAAS,IAAI;EACb,SAAS,IAAI;EACb;EACA;EACA,WAAW,IAAI;EACf,WAAW,IAAI;EACf,WAAW,IAAI;EACf,YAAY,IAAI;CAClB;AACF"}

package/dist/job-canceller.mjs

@@ -0,0 +1,13 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+// src/job-canceller.ts
+/** Ask each queue that can cancel to cancel the build's jobs; a queue without `cancel` is skipped. */
+function createJobCanceller(queues) {
+	return async (buildId) => {
+		return (await Promise.all(queues.map(async (queue) => await queue?.cancel?.(buildId) ?? false))).some(Boolean);
+	};
+}
+export { createJobCanceller };
+
+//# sourceMappingURL=job-canceller.mjs.map

package/dist/job-canceller.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-canceller.mjs","names":[],"sources":["../src/job-canceller.ts"],"sourcesContent":["/**\n * Cancelling a build's background jobs (ADR 0006): every job kind of the build shares the\n * `capture_jobs` table, so one cancel by build id on the database queue covers capture, publish and\n * notify jobs.\n */\nimport type { CaptureQueue } from \"@storyshelf/core/adapter/capture-queue\";\n\n/** Cancels the unfinished jobs of a build; resolves true when any job was affected. */\nexport type JobCanceller = (buildId: string) => Promise<boolean>;\n\n/** Ask each queue that can cancel to cancel the build's jobs; a queue without `cancel` is skipped. */\nexport function createJobCanceller(\n  queues: readonly (CaptureQueue | null | undefined)[],\n): JobCanceller {\n  return async (buildId) => {\n    const outcomes = await Promise.all(\n      queues.map(async (queue) => (await queue?.cancel?.(buildId)) ?? false),\n    );\n    return outcomes.some(Boolean);\n  };\n}\n"],"mappings":";;;;;AAWA,SAAgB,mBACd,QACc;CACd,OAAO,OAAO,YAAY;EAIxB,QAAO,MAHgB,QAAQ,IAC7B,OAAO,IAAI,OAAO,UAAW,MAAM,OAAO,SAAS,OAAO,KAAM,KAAK,CACvE,EAAA,CACgB,KAAK,OAAO;CAC9B;AACF"}

package/dist/job-queue.mjs

@@ -0,0 +1,50 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { DATABASE_QUEUE_METADATA, createDatabaseCaptureQueue } from "@storyshelf/core/capture";
+// src/job-queue.ts
+/**
+* Create the lazy queue polling `kinds`, with `retries` after a first failed attempt, the lease
+* of `testing.leaseSeconds` and the clock of `testing.queueClock` (production: real time).
+*/
+function createJobQueue(options, kinds, retries) {
+	let queue;
+	const exhausted = {};
+	const get = () => {
+		queue ??= createDatabaseCaptureQueue(options.database, {
+			kinds: kinds.length > 0 ? kinds : ["capture"],
+			retries,
+			...options.testing?.leaseSeconds === void 0 ? {} : { leaseMs: Math.round(options.testing.leaseSeconds * 1e3) },
+			...options.testing?.queueClock === void 0 ? {} : {
+				now: options.testing.queueClock.now,
+				timers: options.testing.queueClock.timers
+			},
+			onExhausted: async (job, error) => {
+				await exhausted[job.kind]?.(job, error);
+			}
+		});
+		return queue;
+	};
+	return {
+		kinds,
+		get,
+		built: () => queue,
+		view: queueView(get),
+		exhausted
+	};
+}
+function queueView(get) {
+	return {
+		metadata: DATABASE_QUEUE_METADATA,
+		enqueue: async (job) => {
+			await get().enqueue(job);
+		},
+		status: async (buildId) => await get().status(buildId),
+		active: async () => await get().active(),
+		recent: async (limit) => await get().recent(limit),
+		cancel: async (id) => await get().cancel(id)
+	};
+}
+export { createJobQueue };
+
+//# sourceMappingURL=job-queue.mjs.map

package/dist/job-queue.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-queue.mjs","names":[],"sources":["../src/job-queue.ts"],"sourcesContent":["/**\n * The app's one job queue (ADR 0006, decision 4): the database queue, built on first use and\n * shared by every job kind. Capture, publish and notify jobs are enqueued onto it and consumed by\n * one consumer with a handler per kind. Building it lazily keeps hosts that never enqueue or\n * consume (OpenAPI generation, stub-table tests) from touching `capture_jobs`.\n */\nimport type { CaptureQueue } from \"@storyshelf/core/adapter/capture-queue\";\nimport {\n  createDatabaseCaptureQueue,\n  DATABASE_QUEUE_METADATA,\n  type DatabaseCaptureQueue,\n  type DatabaseJob,\n} from \"@storyshelf/core/capture\";\nimport type { ShelfOptions } from \"@storyshelf/core/config\";\nimport type { CaptureJobKind } from \"@storyshelf/core/schema\";\n\n/** What a kind does when a job of it failed because its last attempt lost its lease. */\nexport type ExhaustedHandler = (job: DatabaseJob, error: string) => Promise<void>;\n\n/** The shared database queue. */\nexport interface JobQueue {\n  /** Job kinds this instance polls; empty when it consumes none. */\n  kinds: readonly CaptureJobKind[];\n  /** The queue, built on first use. */\n  get(): DatabaseCaptureQueue;\n  /** The queue if it was ever built. */\n  built(): DatabaseCaptureQueue | undefined;\n  /** Capture-shaped view for pages and the store; builds the queue only when called. */\n  view: CaptureQueue;\n  /** Per-kind hooks for exhausted jobs, filled in by the kind's setup. */\n  exhausted: Partial<Record<CaptureJobKind, ExhaustedHandler>>;\n}\n\n/**\n * Create the lazy queue polling `kinds`, with `retries` after a first failed attempt, the lease\n * of `testing.leaseSeconds` and the clock of `testing.queueClock` (production: real time).\n */\nexport function createJobQueue(\n  options: ShelfOptions,\n  kinds: readonly CaptureJobKind[],\n  retries: number,\n): JobQueue {\n  let queue: DatabaseCaptureQueue | undefined;\n  const exhausted: JobQueue[\"exhausted\"] = {};\n  const get = (): DatabaseCaptureQueue => {\n    queue ??= createDatabaseCaptureQueue(options.database, {\n      kinds: kinds.length > 0 ? kinds : [\"capture\"],\n      retries,\n      ...(options.testing?.leaseSeconds === undefined\n        ? {}\n        : { leaseMs: Math.round(options.testing.leaseSeconds * 1000) }),\n      ...(options.testing?.queueClock === undefined\n        ? {}\n        : { now: options.testing.queueClock.now, timers: options.testing.queueClock.timers }),\n      onExhausted: async (job, error) => {\n        await exhausted[job.kind]?.(job, error);\n      },\n    });\n    return queue;\n  };\n  return { kinds, get, built: () => queue, view: queueView(get), exhausted };\n}\n\nfunction queueView(get: () => DatabaseCaptureQueue): CaptureQueue {\n  return {\n    metadata: DATABASE_QUEUE_METADATA,\n    enqueue: async (job) => {\n      await get().enqueue(job);\n    },\n    status: async (buildId) => await get().status(buildId),\n    active: async () => await get().active(),\n    recent: async (limit) => await get().recent(limit),\n    cancel: async (id) => await get().cancel(id),\n  };\n}\n"],"mappings":";;;;;;;;;AAqCA,SAAgB,eACd,SACA,OACA,SACU;CACV,IAAI;CACJ,MAAM,YAAmC,CAAC;CAC1C,MAAM,YAAkC;EACtC,UAAU,2BAA2B,QAAQ,UAAU;GACrD,OAAO,MAAM,SAAS,IAAI,QAAQ,CAAC,SAAS;GAC5C;GACA,GAAI,QAAQ,SAAS,iBAAiB,KAAA,IAClC,CAAC,IACD,EAAE,SAAS,KAAK,MAAM,QAAQ,QAAQ,eAAe,GAAI,EAAE;GAC/D,GAAI,QAAQ,SAAS,eAAe,KAAA,IAChC,CAAC,IACD;IAAE,KAAK,QAAQ,QAAQ,WAAW;IAAK,QAAQ,QAAQ,QAAQ,WAAW;GAAO;GACrF,aAAa,OAAO,KAAK,UAAU;IACjC,MAAM,UAAU,IAAI,KAAK,GAAG,KAAK,KAAK;GACxC;EACF,CAAC;EACD,OAAO;CACT;CACA,OAAO;EAAE;EAAO;EAAK,aAAa;EAAO,MAAM,UAAU,GAAG;EAAG;CAAU;AAC3E;AAEA,SAAS,UAAU,KAA+C;CAChE,OAAO;EACL,UAAU;EACV,SAAS,OAAO,QAAQ;GACtB,MAAM,IAAI,CAAC,CAAC,QAAQ,GAAG;EACzB;EACA,QAAQ,OAAO,YAAY,MAAM,IAAI,CAAC,CAAC,OAAO,OAAO;EACrD,QAAQ,YAAY,MAAM,IAAI,CAAC,CAAC,OAAO;EACvC,QAAQ,OAAO,UAAU,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK;EACjD,QAAQ,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC,OAAO,EAAE;CAC7C;AACF"}

package/dist/jobs-setup.mjs

@@ -0,0 +1,131 @@
+import "node:path";
+import "node:url";
+import.meta.url;
+import { setupBuildState } from "./build-state-setup.mjs";
+import { setupCapture } from "./capture-setup.mjs";
+import { combineConsumers, jobMetrics, lazyConsumer } from "./consumer-setup.mjs";
+import { createJobCanceller } from "./job-canceller.mjs";
+import { createJobQueue } from "./job-queue.mjs";
+import { setupPublishing } from "./publish-setup.mjs";
+import { REVIEW_EVENTS, announceReviewWith, reviewRequestedData } from "./review-events.mjs";
+import { isServerlessHost as isServerlessHost$1 } from "./serverless.mjs";
+import { DEFAULT_SCRATCH_DIR } from "@storyshelf/core/config";
+import { DEFAULT_RETRIES, NOTIFY_MAX_ATTEMPTS } from "@storyshelf/core/capture";
+// src/jobs-setup.ts
+/**
+* Background jobs of the app (ADR 0006): the one database queue, the handlers of its job kinds
+* (`capture` with `testing`, `publish` on a long-running host, `notify` on a queue of its own) and the one consumer that runs
+* them.
+*/
+/** Wire the queue, the handlers and the consumer for `options`. */
+function setupJobs(options, runtime, env = process.env) {
+	const { jobs, notifyJobs } = queuesFor(options, isServerlessHost$1(env));
+	const buildState = setupBuildState(options, runtime, notifyJobs);
+	const capture = setupCapture(options, runtime.config, {
+		notifiers: runtime.notifiers,
+		buildState: buildState.publisher,
+		publicOrigin: async () => await runtime.publicOrigin.url()
+	}, runtime.logger, jobs);
+	const publishing = setupPublishing(options, runtime.config, runtime.logger, capture.enqueueCapture !== void 0, {
+		jobs,
+		buildState: buildState.publisher,
+		reviewRequested: reviewRequestedFor(options, runtime)
+	});
+	const wiring = {
+		capture,
+		publishing,
+		buildState,
+		notifyJobs
+	};
+	return {
+		captureQueue: capture.queue,
+		enqueueCapture: capture.enqueueCapture,
+		capturesHere: capture.handler !== null,
+		publish: publishing,
+		buildState: buildState.publisher,
+		cancelBuildJobs: createJobCanceller([jobs.view]),
+		consumer: combineConsumers(consumersOf(options, runtime, jobs, wiring))
+	};
+}
+/**
+* The database queue (captures with `testing`, publishing on a long-running host) and,
+* on a long-running host, a queue of its own for `notify` jobs: a status must not wait behind a
+* capture that holds every slot for minutes.
+*/
+function queuesFor(options, serverless) {
+	const testing = options.testing;
+	const kinds = [...testing?.runner !== void 0 ? ["capture"] : [], ...serverless ? [] : ["publish"]];
+	return {
+		jobs: createJobQueue(options, kinds, testing?.retries ?? DEFAULT_RETRIES),
+		notifyJobs: serverless ? null : createJobQueue(options, ["notify"], NOTIFY_MAX_ATTEMPTS - 1)
+	};
+}
+/** Every consumer this instance runs; none on a host that polls nothing. */
+function consumersOf(options, runtime, jobs, wiring) {
+	const { capture, publishing, buildState, notifyJobs } = wiring;
+	return [...jobs.kinds.length > 0 ? [databaseConsumer(options, runtime, jobs, {
+		capture,
+		publishing
+	})] : [], ...buildState.handler !== null && notifyJobs !== null ? [notifyConsumer(options, runtime, notifyJobs, buildState.handler)] : []];
+}
+/** The consumer of the database queue: capture and publish jobs. */
+function databaseConsumer(options, runtime, jobs, wiring) {
+	const { capture, publishing } = wiring;
+	const capturesHere = jobs.kinds.includes("capture");
+	return lazyConsumer(() => ({
+		queue: jobs.get(),
+		handlers: {
+			...capturesHere && capture.handler ? { capture: capture.handler } : {},
+			...publishing.handler ? { publish: publishing.handler } : {}
+		},
+		config: {
+			concurrency: capturesHere ? options.testing?.concurrency : 1,
+			maxRetries: options.testing?.retries ?? DEFAULT_RETRIES
+		},
+		scratchDir: runtime.config.scratchDir ?? DEFAULT_SCRATCH_DIR,
+		metrics: jobMetrics(),
+		logger: runtime.logger.child({ component: "job-consumer" }),
+		...options.testing?.queueClock === void 0 ? {} : {
+			now: options.testing.queueClock.now,
+			timers: options.testing.queueClock.timers
+		}
+	}), [async () => {
+		if (capturesHere) await capture.handler?.close?.();
+		await jobs.built()?.lifecycle.teardown();
+	}]);
+}
+/** Deliveries running at once: short HTTP calls to a git host, bounded to stay clear of its rate limits. */
+const NOTIFY_CONCURRENCY = 4;
+/** The consumer of `notify` jobs, on its own queue so no capture or publish job can starve it. */
+function notifyConsumer(options, runtime, queue, handler) {
+	return lazyConsumer(() => ({
+		queue: queue.get(),
+		handlers: { notify: handler },
+		config: { concurrency: NOTIFY_CONCURRENCY },
+		metrics: jobMetrics(),
+		logger: runtime.logger.child({ component: "notify-consumer" }),
+		...options.testing?.queueClock === void 0 ? {} : {
+			now: options.testing.queueClock.now,
+			timers: options.testing.queueClock.timers
+		}
+	}), [async () => {
+		await queue.built()?.lifecycle.teardown();
+	}]);
+}
+/** Tells the project's reviewers a published build waits for a verdict (webhook and notifications). */
+function reviewRequestedFor(options, runtime) {
+	return async (project, build) => {
+		await announceReviewWith({
+			db: options.database,
+			config: runtime.config,
+			ui: runtime.ui,
+			logger: runtime.logger,
+			notifiers: runtime.notifiers,
+			notificationsConfig: options.notifications?.config,
+			publicOrigin: runtime.publicOrigin
+		}, project, REVIEW_EVENTS.requested, reviewRequestedData(build), build.id);
+	};
+}
+export { setupJobs };
+
+//# sourceMappingURL=jobs-setup.mjs.map

package/dist/jobs-setup.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs-setup.mjs","names":["isServerlessHost"],"sources":["../src/jobs-setup.ts"],"sourcesContent":["/**\n * Background jobs of the app (ADR 0006): the one database queue, the handlers of its job kinds\n * (`capture` with `testing`, `publish` on a long-running host, `notify` on a queue of its own) and the one consumer that runs\n * them.\n */\nimport {\n  DEFAULT_RETRIES,\n  NOTIFY_MAX_ATTEMPTS,\n  type BuildStatePublisher,\n  type CaptureConsumer,\n  type KindHandler,\n} from \"@storyshelf/core/capture\";\nimport type { ShelfOptions } from \"@storyshelf/core/config\";\nimport { DEFAULT_SCRATCH_DIR } from \"@storyshelf/core/config\";\nimport type { Build, CaptureJobKind, Project } from \"@storyshelf/core/schema\";\nimport { setupBuildState, type BuildStateWiring } from \"./build-state-setup.ts\";\nimport { setupCapture, type CaptureWiring } from \"./capture-setup.ts\";\nimport { combineConsumers, jobMetrics, lazyConsumer } from \"./consumer-setup.ts\";\nimport { createJobCanceller, type JobCanceller } from \"./job-canceller.ts\";\nimport { createJobQueue, type JobQueue } from \"./job-queue.ts\";\nimport { setupPublishing, type PublishService, type PublishWiring } from \"./publish-setup.ts\";\nimport { announceReviewWith, REVIEW_EVENTS, reviewRequestedData } from \"./review-events.ts\";\nimport type { ServerRuntime } from \"./runtime.ts\";\nimport { isServerlessHost } from \"./serverless.ts\";\n\n/** What the rest of the app takes from the job wiring. */\nexport interface JobsWiring {\n  /** Where captures queue; null without `testing`. */\n  captureQueue: CaptureWiring[\"queue\"];\n  enqueueCapture: CaptureWiring[\"enqueueCapture\"];\n  /** Whether this instance runs the capture jobs (the retry and compute-jobs UI applies). */\n  capturesHere: boolean;\n  publish: PublishService;\n  /** Asks for a build's current state to be shown on its git channels (ADR 0014). */\n  buildState: BuildStatePublisher;\n  /** Cancels every unfinished job of a build, of any kind (capture, publish, notify). */\n  cancelBuildJobs: JobCanceller;\n  /** Runs every handler this instance has; null when it consumes nothing. */\n  consumer: CaptureConsumer | null;\n}\n\n/** Wire the queue, the handlers and the consumer for `options`. */\nexport function setupJobs(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n  env: NodeJS.ProcessEnv = process.env,\n): JobsWiring {\n  const { jobs, notifyJobs } = queuesFor(options, isServerlessHost(env));\n  const buildState = setupBuildState(options, runtime, notifyJobs);\n  const capture = setupCapture(\n    options,\n    runtime.config,\n    {\n      notifiers: runtime.notifiers,\n      buildState: buildState.publisher,\n      publicOrigin: async () => await runtime.publicOrigin.url(),\n    },\n    runtime.logger,\n    jobs,\n  );\n  const publishing = setupPublishing(\n    options,\n    runtime.config,\n    runtime.logger,\n    capture.enqueueCapture !== undefined,\n    {\n      jobs,\n      buildState: buildState.publisher,\n      reviewRequested: reviewRequestedFor(options, runtime),\n    },\n  );\n  const wiring = { capture, publishing, buildState, notifyJobs };\n  return {\n    captureQueue: capture.queue,\n    enqueueCapture: capture.enqueueCapture,\n    capturesHere: capture.handler !== null,\n    publish: publishing,\n    buildState: buildState.publisher,\n    cancelBuildJobs: createJobCanceller([jobs.view]),\n    consumer: combineConsumers(consumersOf(options, runtime, jobs, wiring)),\n  };\n}\n\n/**\n * The database queue (captures with `testing`, publishing on a long-running host) and,\n * on a long-running host, a queue of its own for `notify` jobs: a status must not wait behind a\n * capture that holds every slot for minutes.\n */\nfunction queuesFor(\n  options: ShelfOptions,\n  serverless: boolean,\n): { jobs: JobQueue; notifyJobs: JobQueue | null } {\n  const testing = options.testing;\n  const databaseCaptures = testing?.runner !== undefined;\n  const kinds: CaptureJobKind[] = [\n    ...(databaseCaptures ? ([\"capture\"] as const) : []),\n    ...(serverless ? [] : ([\"publish\"] as const)),\n  ];\n  return {\n    jobs: createJobQueue(options, kinds, testing?.retries ?? DEFAULT_RETRIES),\n    notifyJobs: serverless ? null : createJobQueue(options, [\"notify\"], NOTIFY_MAX_ATTEMPTS - 1),\n  };\n}\n\n/** Every consumer this instance runs; none on a host that polls nothing. */\nfunction consumersOf(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n  jobs: JobQueue,\n  wiring: {\n    capture: CaptureWiring;\n    publishing: Pick<PublishWiring, \"handler\">;\n    buildState: Pick<BuildStateWiring, \"handler\">;\n    notifyJobs: JobQueue | null;\n  },\n): CaptureConsumer[] {\n  const { capture, publishing, buildState, notifyJobs } = wiring;\n  return [\n    ...(jobs.kinds.length > 0\n      ? [databaseConsumer(options, runtime, jobs, { capture, publishing })]\n      : []),\n    ...(buildState.handler !== null && notifyJobs !== null\n      ? [notifyConsumer(options, runtime, notifyJobs, buildState.handler)]\n      : []),\n  ];\n}\n\n/** The consumer of the database queue: capture and publish jobs. */\nfunction databaseConsumer(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n  jobs: JobQueue,\n  wiring: {\n    capture: CaptureWiring;\n    publishing: Pick<PublishWiring, \"handler\">;\n  },\n): CaptureConsumer {\n  const { capture, publishing } = wiring;\n  const capturesHere = jobs.kinds.includes(\"capture\");\n  return lazyConsumer(\n    () => ({\n      queue: jobs.get(),\n      handlers: {\n        ...(capturesHere && capture.handler ? { capture: capture.handler } : {}),\n        ...(publishing.handler ? { publish: publishing.handler } : {}),\n      },\n      // Publishing alone is one job at a time, so a big zip never crowds out the web server.\n      config: {\n        concurrency: capturesHere ? options.testing?.concurrency : 1,\n        maxRetries: options.testing?.retries ?? DEFAULT_RETRIES,\n      },\n      scratchDir: runtime.config.scratchDir ?? DEFAULT_SCRATCH_DIR,\n      metrics: jobMetrics(),\n      logger: runtime.logger.child({ component: \"job-consumer\" }),\n      ...(options.testing?.queueClock === undefined\n        ? {}\n        : { now: options.testing.queueClock.now, timers: options.testing.queueClock.timers }),\n    }),\n    [\n      async () => {\n        if (capturesHere) {\n          await capture.handler?.close?.();\n        }\n        await jobs.built()?.lifecycle.teardown();\n      },\n    ],\n  );\n}\n\n/** Deliveries running at once: short HTTP calls to a git host, bounded to stay clear of its rate limits. */\nconst NOTIFY_CONCURRENCY = 4;\n\n/** The consumer of `notify` jobs, on its own queue so no capture or publish job can starve it. */\nfunction notifyConsumer(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n  queue: JobQueue,\n  handler: KindHandler,\n): CaptureConsumer {\n  return lazyConsumer(\n    () => ({\n      queue: queue.get(),\n      handlers: { notify: handler },\n      config: { concurrency: NOTIFY_CONCURRENCY },\n      metrics: jobMetrics(),\n      logger: runtime.logger.child({ component: \"notify-consumer\" }),\n      ...(options.testing?.queueClock === undefined\n        ? {}\n        : { now: options.testing.queueClock.now, timers: options.testing.queueClock.timers }),\n    }),\n    [\n      async () => {\n        await queue.built()?.lifecycle.teardown();\n      },\n    ],\n  );\n}\n\n/** Tells the project's reviewers a published build waits for a verdict (webhook and notifications). */\nfunction reviewRequestedFor(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n): (project: Project, build: Build) => Promise<void> {\n  return async (project, build) => {\n    await announceReviewWith(\n      {\n        db: options.database,\n        config: runtime.config,\n        ui: runtime.ui,\n        logger: runtime.logger,\n        notifiers: runtime.notifiers,\n        notificationsConfig: options.notifications?.config,\n        publicOrigin: runtime.publicOrigin,\n      },\n      project,\n      REVIEW_EVENTS.requested,\n      reviewRequestedData(build),\n      build.id,\n    );\n  };\n}\n"],"mappings":"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"}

package/dist/lifecycle.mjs

@@ -1,16 +1,33 @@
 import "node:path";
 import "node:url";
 import.meta.url;
+import { settleInsightJobs } from "./insights/job.mjs";
 import { startBranchGcTimer } from "./retention-timer.mjs";
-import { AdapterLifecycleError, bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns, validateBootAssembly } from "@storyshelf/core/adapter/setup";
+import { AdapterLifecycleError, adapterSourcesOf, bindAdapterLoggers, collectSetups, collectTeardowns, runAdapterSetups, runAdapterTeardowns, validateBootAssembly } from "@storyshelf/core/adapter/setup";
+import { shutdownDiffPool, verifyImageEngine } from "@storyshelf/core/diff";
 import { sanitizeErrorText } from "@storyshelf/core/utils";
-//#region src/lifecycle.ts
+import { purgeAiData } from "@storyshelf/core/retention";
+// src/lifecycle.ts
 /** Longest teardown waits for background boot tasks before closing adapters anyway. */
 const BACKGROUND_DRAIN_MS = 5e3;
 /** Register a boot task so `teardown()` does not close adapters underneath it. */
 function trackBackground(cell, task) {
 	(cell.background ??= []).push(task);
 }
+/** Start the job consumer once adapters are set up; a no-op when none exists or it runs. */
+function startConsumer(cell, logger) {
+	const consumer = cell.consumer;
+	if (!consumer || consumer.isRunning() || cell.consumerStopped) return;
+	cell.consumerRun = consumer.start().catch((error) => {
+		logger.error({ err: error }, "job consumer stopped");
+	});
+}
+/** Stop polling and wait for the jobs in flight to finish (the SIGTERM drain). */
+async function stopConsumer(cell) {
+	cell.consumerStopped = true;
+	await cell.consumer?.stop();
+	await cell.consumerRun;
+}
 /** Wait for tracked boot tasks, bounded so a hung task can never block shutdown. */
 async function drainBackground(cell) {
 	const pending = Promise.allSettled(cell.background ?? []);
@@ -32,23 +49,33 @@ function trackSettlement(cell, promise) {
 		};
 	});
 }
+/** First failing boot check (assembly, auth, AI), or null when all pass. */
+async function firstBootFailure(options, logger) {
+	const invalid = validateBootAssembly(adapterSourcesOf(options));
+	if (invalid.length > 0) {
+		logger.error({ failures: invalid }, "adapter validation failed");
+		return {
+			ok: false,
+			failures: invalid
+		};
+	}
+	for (const [label, run] of [
+		["auth", runAuthSetup],
+		["ai", runAiSetup],
+		["images", runImagesSetup]
+	]) {
+		const failed = await run(options);
+		if (failed) {
+			logger.error({ failures: failed.failures }, `${label} setup failed`);
+			return failed;
+		}
+	}
+	return null;
+}
 /** Kick the eager background setup run (resolves; never rejects). */
 function kickSetup(options, ctx, logger, cell) {
 	cell.ready = (async () => {
-		const invalid = validateBootAssembly(options);
-		if (invalid.length > 0) {
-			logger.error({ failures: invalid }, "adapter validation failed");
-			return {
-				ok: false,
-				failures: invalid
-			};
-		}
-		const authFailed = await runAuthSetup(options);
-		if (authFailed) {
-			logger.error({ failures: authFailed.failures }, "auth setup failed");
-			return authFailed;
-		}
-		return await runAdapterSetups(collectSetups(options), ctx, logger);
+		return await firstBootFailure(options, logger) ?? await runAdapterSetups(collectSetups(adapterSourcesOf(options)), ctx, logger);
 	})();
 	trackSettlement(cell, cell.ready);
 }
@@ -80,13 +107,14 @@ function attachLifecycle(app, options, runtime, cell) {
 		logger: runtime.logger
 	};
 	bindAdapterLoggers(options, runtime.logger);
+	options.ai?.setLogger?.(runtime.logger.child({ component: "ai" }));
 	logAuthMode(options, runtime.logger);
 	kickSetup(options, setupCtx, runtime.logger, cell);
 	const timer = startBranchGcInterval(options, runtime);
 	Object.assign(app, { lifecycle: createLifecycle(options, setupCtx, runtime.logger, cell, timer) });
 }
 function startBranchGcInterval(options, runtime) {
-	return startBranchGcTimer(options.database, options.storage, runtime.config, runtime.logger);
+	return startBranchGcTimer(options.database, options.storage, runtime.config, runtime.logger, Boolean(options.testing));
 }
 /** Run auth boot validation, returning a failure result instead of throwing. */
 async function runAuthSetup(options) {
@@ -106,9 +134,47 @@ async function runAuthSetup(options) {
 		};
 	}
 }
+/** Run AI boot checks and the stale-run sweep; failure fails readiness like auth. */
+async function runAiSetup(options) {
+	if (!options.ai) return null;
+	try {
+		await options.ai.setup();
+		await purgeAiData(options.database);
+		return null;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return {
+			ok: false,
+			failures: [{
+				category: "ai",
+				kind: "ai",
+				name: "ai",
+				error: sanitizeErrorText(message, 500)
+			}]
+		};
+	}
+}
+/** Load the configured image engine now, so a missing `sharp` fails readiness instead of the first diff. */
+async function runImagesSetup() {
+	try {
+		await verifyImageEngine();
+		return null;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		return {
+			ok: false,
+			failures: [{
+				category: "images",
+				kind: "images",
+				name: "images",
+				error: sanitizeErrorText(message, 500)
+			}]
+		};
+	}
+}
 /** Validation failure settled on the cell — null when the assembly is sound. */
 function invalidSources(options, cell) {
-	const invalid = validateBootAssembly(options);
+	const invalid = validateBootAssembly(adapterSourcesOf(options));
 	if (invalid.length === 0) return null;
 	const result = {
 		ok: false,
@@ -128,15 +194,21 @@ function createLifecycle(options, ctx, logger, cell, timer = null) {
 		setup: async () => {
 			const blocked = invalidSources(options, cell);
 			if (blocked) throw new AdapterLifecycleError("setup", blocked.failures);
-			const result = await runAdapterSetups(collectSetups(options), ctx, logger);
+			const result = await runAdapterSetups(collectSetups(adapterSourcesOf(options)), ctx, logger);
 			cell.ready = Promise.resolve(result);
 			cell.settled = result;
 			if (!result.ok) throw new AdapterLifecycleError("setup", result.failures);
+			cell.consumerStopped = false;
+			startConsumer(cell, logger);
 		},
 		teardown: async () => {
 			timer?.stop();
+			await stopConsumer(cell);
 			await drainBackground(cell);
-			const result = await runAdapterTeardowns(collectTeardowns(options), ctx, logger);
+			await settleInsightJobs();
+			await options.ai?.teardown();
+			await shutdownDiffPool();
+			const result = await runAdapterTeardowns(collectTeardowns(adapterSourcesOf(options)), ctx, logger);
 			await options.observability?.shutdown().catch((error) => {
 				logger.error({ err: error }, "observability shutdown failed");
 			});
@@ -144,7 +216,6 @@ function createLifecycle(options, ctx, logger, cell, timer = null) {
 		}
 	};
 }
-//#endregion
-export { attachLifecycle, trackBackground };
+export { attachLifecycle, startConsumer, trackBackground };
 
 //# sourceMappingURL=lifecycle.mjs.map

package/dist/lifecycle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.mjs","names":[],"sources":["../src/lifecycle.ts"],"sourcesContent":["import type { AdapterSetupContext } from \"@storyshelf/core/adapter/metadata\";\nimport {\n  AdapterLifecycleError,\n  bindAdapterLoggers,\n  collectSetups,\n  collectTeardowns,\n  runAdapterSetups,\n  runAdapterTeardowns,\n  validateBootAssembly,\n} from \"@storyshelf/core/adapter/setup\";\nimport type { AdapterSetupResult } from \"@storyshelf/core/adapter/setup\";\nimport type { ShelfOptions } from \"@storyshelf/core/config\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { sanitizeErrorText } from \"@storyshelf/core/utils\";\nimport type { ShelfRouter, ShelfLifecycle } from \"./app-types.ts\";\nimport { startBranchGcTimer } from \"./retention-timer.ts\";\nimport type { ServerRuntime } from \"./runtime.ts\";\n\n/** Mutable setup-settlement cell shared by the gate, health, and `setup()`. */\nexport interface LifecycleCell {\n  ready: Promise<AdapterSetupResult>;\n  settled: AdapterSetupResult | null;\n  /** Fire-and-forget boot tasks (recovery, credential check) that teardown must outwait. */\n  background?: Promise<unknown>[];\n  /** Override of {@link BACKGROUND_DRAIN_MS} (tests). */\n  drainMs?: number;\n}\n\n/** Longest teardown waits for background boot tasks before closing adapters anyway. */\nconst BACKGROUND_DRAIN_MS = 5000;\n\n/** Register a boot task so `teardown()` does not close adapters underneath it. */\nexport function trackBackground(cell: LifecycleCell, task: Promise<unknown>): void {\n  (cell.background ??= []).push(task);\n}\n\n/** Wait for tracked boot tasks, bounded so a hung task can never block shutdown. */\nasync function drainBackground(cell: LifecycleCell): Promise<void> {\n  const pending = Promise.allSettled(cell.background ?? []);\n  let timer: NodeJS.Timeout | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timer = setTimeout(resolve, cell.drainMs ?? BACKGROUND_DRAIN_MS);\n    timer.unref();\n  });\n  await Promise.race([pending, timeout]);\n  clearTimeout(timer);\n}\n\nfunction trackSettlement(cell: LifecycleCell, promise: Promise<AdapterSetupResult>): void {\n  promise.then(\n    (result) => {\n      cell.settled = result;\n    },\n    () => {\n      cell.settled = { ok: false, failures: [] };\n    },\n  );\n}\n\n/** Kick the eager background setup run (resolves; never rejects). */\nfunction kickSetup(\n  options: ShelfOptions,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  cell: LifecycleCell,\n): void {\n  // Auth is not an adapter: its one-shot boot validation runs first, then\n  // the adapter setups. A failing secret check fails readiness, like others.\n  cell.ready = (async (): Promise<AdapterSetupResult> => {\n    const invalid = validateBootAssembly(options);\n    if (invalid.length > 0) {\n      logger.error({ failures: invalid }, \"adapter validation failed\");\n      return { ok: false, failures: invalid };\n    }\n    const authFailed = await runAuthSetup(options);\n    if (authFailed) {\n      logger.error({ failures: authFailed.failures }, \"auth setup failed\");\n      return authFailed;\n    }\n    return await runAdapterSetups(collectSetups(options), ctx, logger);\n  })();\n  trackSettlement(cell, cell.ready);\n}\n\n/** Login method count, or null when the engine throws during introspection. */\nfunction loginMethodCount(auth: NonNullable<ShelfOptions[\"auth\"]>): number | null {\n  try {\n    return auth.loginMethods().length;\n  } catch {\n    return null;\n  }\n}\n\n/** Log which auth mode the server boots with (open servers stay visible). */\nfunction logAuthMode(options: ShelfOptions, logger: Logger): void {\n  if (!options.auth) {\n    logger.info(\"auth disabled (local default; every route is open)\");\n    return;\n  }\n  const methods = loginMethodCount(options.auth);\n  if (methods === null) {\n    logger.warn(\"auth loginMethods() threw during boot logging\");\n    return;\n  }\n  logger.info({ loginMethods: methods }, \"auth enabled\");\n}\n\n/** Kick eager setup and attach the `app.lifecycle` namespace (single run). */\nexport function attachLifecycle(\n  app: ShelfRouter,\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n  cell: LifecycleCell,\n): void {\n  const setupCtx: AdapterSetupContext = { config: runtime.config, logger: runtime.logger };\n  bindAdapterLoggers(options, runtime.logger);\n  logAuthMode(options, runtime.logger);\n  kickSetup(options, setupCtx, runtime.logger, cell);\n  const timer = startBranchGcInterval(options, runtime);\n  Object.assign(app, {\n    lifecycle: createLifecycle(options, setupCtx, runtime.logger, cell, timer),\n  });\n}\n\nfunction startBranchGcInterval(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n): { stop(): void } | null {\n  return startBranchGcTimer(options.database, options.storage, runtime.config, runtime.logger);\n}\n\n/** Run auth boot validation, returning a failure result instead of throwing. */\nasync function runAuthSetup(options: ShelfOptions): Promise<AdapterSetupResult | null> {\n  try {\n    await options.auth?.setup?.();\n    return null;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return {\n      ok: false,\n      failures: [\n        { category: \"auth\", kind: \"auth\", name: \"auth\", error: sanitizeErrorText(message, 500) },\n      ],\n    };\n  }\n}\n/** Validation failure settled on the cell — null when the assembly is sound. */\nfunction invalidSources(options: ShelfOptions, cell: LifecycleCell): AdapterSetupResult | null {\n  const invalid = validateBootAssembly(options);\n  if (invalid.length === 0) {\n    return null;\n  }\n  const result: AdapterSetupResult = { ok: false, failures: invalid };\n  cell.ready = Promise.resolve(result);\n  cell.settled = result;\n  return result;\n}\n/** Build the `app.lifecycle` namespace closing over one settlement cell. */\nfunction createLifecycle(\n  options: ShelfOptions,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  cell: LifecycleCell,\n  timer: { stop(): void } | null = null,\n): ShelfLifecycle {\n  return {\n    get ready() {\n      return cell.ready;\n    },\n    logger,\n    setup: async () => {\n      const blocked = invalidSources(options, cell);\n      if (blocked) {\n        throw new AdapterLifecycleError(\"setup\", blocked.failures);\n      }\n      const result = await runAdapterSetups(collectSetups(options), ctx, logger);\n      cell.ready = Promise.resolve(result);\n      cell.settled = result;\n      if (!result.ok) {\n        throw new AdapterLifecycleError(\"setup\", result.failures);\n      }\n    },\n    teardown: async () => {\n      timer?.stop();\n      await drainBackground(cell);\n      const result = await runAdapterTeardowns(collectTeardowns(options), ctx, logger);\n      await options.observability?.shutdown().catch((error: unknown) => {\n        logger.error({ err: error }, \"observability shutdown failed\");\n      });\n      if (!result.ok) {\n        throw new AdapterLifecycleError(\"teardown\", result.failures);\n      }\n    },\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"lifecycle.mjs","names":[],"sources":["../src/lifecycle.ts"],"sourcesContent":["import type { AdapterSetupContext } from \"@storyshelf/core/adapter/metadata\";\nimport {\n  AdapterLifecycleError,\n  bindAdapterLoggers,\n  adapterSourcesOf,\n  collectSetups,\n  collectTeardowns,\n  runAdapterSetups,\n  runAdapterTeardowns,\n  validateBootAssembly,\n} from \"@storyshelf/core/adapter/setup\";\nimport type { AdapterSetupResult } from \"@storyshelf/core/adapter/setup\";\nimport type { CaptureConsumer } from \"@storyshelf/core/capture\";\nimport type { ShelfOptions } from \"@storyshelf/core/config\";\nimport { shutdownDiffPool, verifyImageEngine } from \"@storyshelf/core/diff\";\nimport type { Logger } from \"@storyshelf/core/logger\";\nimport { purgeAiData } from \"@storyshelf/core/retention\";\nimport { sanitizeErrorText } from \"@storyshelf/core/utils\";\nimport type { ShelfRouter, ShelfLifecycle } from \"./app-types.ts\";\nimport { settleInsightJobs } from \"./insights/job.ts\";\nimport { startBranchGcTimer } from \"./retention-timer.ts\";\nimport type { ServerRuntime } from \"./runtime.ts\";\n\n/** Mutable setup-settlement cell shared by the gate, health, and `setup()`. */\nexport interface LifecycleCell {\n  ready: Promise<AdapterSetupResult>;\n  settled: AdapterSetupResult | null;\n  /** Fire-and-forget boot tasks (recovery, credential check) that teardown must outwait. */\n  background?: Promise<unknown>[];\n  /** Override of {@link BACKGROUND_DRAIN_MS} (tests). */\n  drainMs?: number;\n  /** The job consumer (null on hosts that run none); started once adapters are ready, drained by `teardown()`. */\n  consumer?: CaptureConsumer | null;\n  /** The running consumer session, settled once it was stopped and drained. */\n  consumerRun?: Promise<void>;\n  /** Teardown ran: the consumer stays stopped (a late \"adapters are ready\" must not restart it). */\n  consumerStopped?: boolean;\n}\n\n/** Longest teardown waits for background boot tasks before closing adapters anyway. */\nconst BACKGROUND_DRAIN_MS = 5000;\n\n/** Register a boot task so `teardown()` does not close adapters underneath it. */\nexport function trackBackground(cell: LifecycleCell, task: Promise<unknown>): void {\n  (cell.background ??= []).push(task);\n}\n\n/** Start the job consumer once adapters are set up; a no-op when none exists or it runs. */\nexport function startConsumer(cell: LifecycleCell, logger: Logger): void {\n  const consumer = cell.consumer;\n  if (!consumer || consumer.isRunning() || cell.consumerStopped) {\n    return;\n  }\n  cell.consumerRun = consumer.start().catch((error: unknown) => {\n    logger.error({ err: error }, \"job consumer stopped\");\n  });\n}\n\n/** Stop polling and wait for the jobs in flight to finish (the SIGTERM drain). */\nasync function stopConsumer(cell: LifecycleCell): Promise<void> {\n  cell.consumerStopped = true;\n  await cell.consumer?.stop();\n  await cell.consumerRun;\n}\n\n/** Wait for tracked boot tasks, bounded so a hung task can never block shutdown. */\nasync function drainBackground(cell: LifecycleCell): Promise<void> {\n  const pending = Promise.allSettled(cell.background ?? []);\n  let timer: NodeJS.Timeout | undefined;\n  const timeout = new Promise<void>((resolve) => {\n    timer = setTimeout(resolve, cell.drainMs ?? BACKGROUND_DRAIN_MS);\n    timer.unref();\n  });\n  await Promise.race([pending, timeout]);\n  clearTimeout(timer);\n}\n\nfunction trackSettlement(cell: LifecycleCell, promise: Promise<AdapterSetupResult>): void {\n  promise.then(\n    (result) => {\n      cell.settled = result;\n    },\n    () => {\n      cell.settled = { ok: false, failures: [] };\n    },\n  );\n}\n\n/** First failing boot check (assembly, auth, AI), or null when all pass. */\nasync function firstBootFailure(\n  options: ShelfOptions,\n  logger: Logger,\n): Promise<AdapterSetupResult | null> {\n  const invalid = validateBootAssembly(adapterSourcesOf(options));\n  if (invalid.length > 0) {\n    logger.error({ failures: invalid }, \"adapter validation failed\");\n    return { ok: false, failures: invalid };\n  }\n  for (const [label, run] of [\n    [\"auth\", runAuthSetup],\n    [\"ai\", runAiSetup],\n    [\"images\", runImagesSetup],\n  ] as const) {\n    // eslint-disable-next-line no-await-in-loop -- boot checks run in order and stop at the first failure\n    const failed = await run(options);\n    if (failed) {\n      logger.error({ failures: failed.failures }, `${label} setup failed`);\n      return failed;\n    }\n  }\n  return null;\n}\n\n/** Kick the eager background setup run (resolves; never rejects). */\nfunction kickSetup(\n  options: ShelfOptions,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  cell: LifecycleCell,\n): void {\n  // Auth is not an adapter: its one-shot boot validation runs first, then\n  // the adapter setups. A failing secret check fails readiness, like others.\n  cell.ready = (async (): Promise<AdapterSetupResult> => {\n    const failed = await firstBootFailure(options, logger);\n    return (\n      failed ?? (await runAdapterSetups(collectSetups(adapterSourcesOf(options)), ctx, logger))\n    );\n  })();\n  trackSettlement(cell, cell.ready);\n}\n\n/** Login method count, or null when the engine throws during introspection. */\nfunction loginMethodCount(auth: NonNullable<ShelfOptions[\"auth\"]>): number | null {\n  try {\n    return auth.loginMethods().length;\n  } catch {\n    return null;\n  }\n}\n\n/** Log which auth mode the server boots with (open servers stay visible). */\nfunction logAuthMode(options: ShelfOptions, logger: Logger): void {\n  if (!options.auth) {\n    logger.info(\"auth disabled (local default; every route is open)\");\n    return;\n  }\n  const methods = loginMethodCount(options.auth);\n  if (methods === null) {\n    logger.warn(\"auth loginMethods() threw during boot logging\");\n    return;\n  }\n  logger.info({ loginMethods: methods }, \"auth enabled\");\n}\n\n/** Kick eager setup and attach the `app.lifecycle` namespace (single run). */\nexport function attachLifecycle(\n  app: ShelfRouter,\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n  cell: LifecycleCell,\n): void {\n  const setupCtx: AdapterSetupContext = { config: runtime.config, logger: runtime.logger };\n  bindAdapterLoggers(options, runtime.logger);\n  options.ai?.setLogger?.(runtime.logger.child({ component: \"ai\" }));\n  logAuthMode(options, runtime.logger);\n  kickSetup(options, setupCtx, runtime.logger, cell);\n  const timer = startBranchGcInterval(options, runtime);\n  Object.assign(app, {\n    lifecycle: createLifecycle(options, setupCtx, runtime.logger, cell, timer),\n  });\n}\n\nfunction startBranchGcInterval(\n  options: ShelfOptions,\n  runtime: ServerRuntime,\n): { stop(): void } | null {\n  return startBranchGcTimer(\n    options.database,\n    options.storage,\n    runtime.config,\n    runtime.logger,\n    Boolean(options.testing),\n  );\n}\n\n/** Run auth boot validation, returning a failure result instead of throwing. */\nasync function runAuthSetup(options: ShelfOptions): Promise<AdapterSetupResult | null> {\n  try {\n    await options.auth?.setup?.();\n    return null;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return {\n      ok: false,\n      failures: [\n        { category: \"auth\", kind: \"auth\", name: \"auth\", error: sanitizeErrorText(message, 500) },\n      ],\n    };\n  }\n}\n/** Run AI boot checks and the stale-run sweep; failure fails readiness like auth. */\nasync function runAiSetup(options: ShelfOptions): Promise<AdapterSetupResult | null> {\n  if (!options.ai) {\n    return null;\n  }\n  try {\n    await options.ai.setup();\n    await purgeAiData(options.database);\n    return null;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return {\n      ok: false,\n      failures: [\n        { category: \"ai\", kind: \"ai\", name: \"ai\", error: sanitizeErrorText(message, 500) },\n      ],\n    };\n  }\n}\n/** Load the configured image engine now, so a missing `sharp` fails readiness instead of the first diff. */\nasync function runImagesSetup(): Promise<AdapterSetupResult | null> {\n  try {\n    await verifyImageEngine();\n    return null;\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    return {\n      ok: false,\n      failures: [\n        {\n          category: \"images\",\n          kind: \"images\",\n          name: \"images\",\n          error: sanitizeErrorText(message, 500),\n        },\n      ],\n    };\n  }\n}\n/** Validation failure settled on the cell — null when the assembly is sound. */\nfunction invalidSources(options: ShelfOptions, cell: LifecycleCell): AdapterSetupResult | null {\n  const invalid = validateBootAssembly(adapterSourcesOf(options));\n  if (invalid.length === 0) {\n    return null;\n  }\n  const result: AdapterSetupResult = { ok: false, failures: invalid };\n  cell.ready = Promise.resolve(result);\n  cell.settled = result;\n  return result;\n}\n/** Build the `app.lifecycle` namespace closing over one settlement cell. */\nfunction createLifecycle(\n  options: ShelfOptions,\n  ctx: AdapterSetupContext,\n  logger: Logger,\n  cell: LifecycleCell,\n  timer: { stop(): void } | null = null,\n): ShelfLifecycle {\n  return {\n    get ready() {\n      return cell.ready;\n    },\n    logger,\n    setup: async () => {\n      const blocked = invalidSources(options, cell);\n      if (blocked) {\n        throw new AdapterLifecycleError(\"setup\", blocked.failures);\n      }\n      const result = await runAdapterSetups(collectSetups(adapterSourcesOf(options)), ctx, logger);\n      cell.ready = Promise.resolve(result);\n      cell.settled = result;\n      if (!result.ok) {\n        throw new AdapterLifecycleError(\"setup\", result.failures);\n      }\n      cell.consumerStopped = false;\n      startConsumer(cell, logger);\n    },\n    teardown: async () => {\n      timer?.stop();\n      await stopConsumer(cell);\n      await drainBackground(cell);\n      await settleInsightJobs();\n      await options.ai?.teardown();\n      await shutdownDiffPool();\n      const result = await runAdapterTeardowns(\n        collectTeardowns(adapterSourcesOf(options)),\n        ctx,\n        logger,\n      );\n      await options.observability?.shutdown().catch((error: unknown) => {\n        logger.error({ err: error }, \"observability shutdown failed\");\n      });\n      if (!result.ok) {\n        throw new AdapterLifecycleError(\"teardown\", result.failures);\n      }\n    },\n  };\n}\n"],"mappings":"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"}