wiki-graph-core 0.3.1 → 0.4.0

package/dist/runtime/jobs/jobs.js

@@ -0,0 +1,416 @@
+import { randomUUID } from "crypto";
+import { resolve } from "path";
+import {
+  createJobCachePath,
+  createJobEventsPath,
+  createJobLogPath,
+  createJobWorkspacePath
+} from "./paths.js";
+import { createArchiveKey } from "./helpers.js";
+import { BuildJobStoppedError } from "./progress.js";
+import { appendBuildJobEvent } from "./events.js";
+import {
+  openBuildQueueDatabase,
+  openReadonlyBuildQueueDatabase,
+  readMaxQueueRank,
+  readMinQueueRank,
+  requireBuildJobById,
+  resolveBuildJobIdInState
+} from "./database.js";
+import { recoverStaleBuildJobs } from "./recovery.js";
+import { markBuildJobCanceled, markBuildJobCanceling } from "./state.js";
+import { formatBuildJobLane, mapBuildJob } from "./row.js";
+const ACTIVE_JOB_STATES = /* @__PURE__ */ new Set([
+  "queued",
+  "running",
+  "canceling",
+  "paused"
+]);
+async function addBuildJob(options) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await state.transaction(async () => {
+      const archivePath = resolve(options.archivePath);
+      const archiveKey = createArchiveKey(archivePath);
+      const now = Date.now();
+      const existing = await findActiveBuildJobInLane(state, {
+        archiveKey,
+        chapterId: options.chapterId,
+        target: options.target
+      });
+      if (existing !== void 0) {
+        return await mergeActiveBuildJob(state, existing, options, now);
+      }
+      const jobId = options.jobId ?? randomUUID();
+      const workspacePath = await createJobWorkspacePath(jobId);
+      const cachePath = await createJobCachePath(jobId);
+      const logPath = await createJobLogPath(jobId);
+      const eventsPath = await createJobEventsPath(jobId);
+      const queueRank = options.boost === true ? await readMinQueueRank(state) - 1 : await readMaxQueueRank(state) + 1;
+      await state.run(
+        `
+INSERT INTO build_jobs (
+  job_id, archive_key, archive_path, chapter_id, target, state, queue_rank,
+  workspace_path, cache_path, log_path, events_path, llm_json, prompt,
+  created_at, updated_at
+) VALUES (?, ?, ?, ?, ?, 'queued', ?, ?, ?, ?, ?, ?, ?, ?, ?)
+`,
+        [
+          jobId,
+          archiveKey,
+          archivePath,
+          options.chapterId,
+          options.target,
+          queueRank,
+          workspacePath,
+          cachePath,
+          logPath,
+          eventsPath,
+          options.llmJSON ?? null,
+          options.prompt ?? null,
+          now,
+          now
+        ]
+      );
+      const job = await requireBuildJobById(state, jobId);
+      await appendBuildJobEvent(job, {
+        at: now,
+        jobId,
+        seq: 0,
+        state: "queued",
+        type: "created"
+      });
+      return job;
+    });
+  } finally {
+    await state.close();
+  }
+}
+async function recordBuildJobInputRevision(input) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await state.transaction(async () => {
+      await state.run(
+        `
+UPDATE build_jobs
+SET input_revision = ?,
+    updated_at = ?
+WHERE job_id = ?
+  AND owner_id = ?
+  AND state = 'running'
+`,
+        [input.currentRevision, Date.now(), input.jobId, input.ownerId]
+      );
+    });
+    return await requireBuildJobById(state, input.jobId);
+  } finally {
+    await state.close();
+  }
+}
+async function assertBuildJobInputRevision(input) {
+  const job = await getBuildJob(input.jobId);
+  if (job.state !== "running" || job.ownerId !== input.ownerId) {
+    throw new BuildJobStoppedError(
+      `Job ${input.jobId} is ${job.state}. Stop current worker execution.`
+    );
+  }
+  if (job.inputRevision === void 0) {
+    throw new Error(
+      `Job ${input.jobId} has no recorded chapter input revision. Requeue the job before committing build output.`
+    );
+  }
+  if (job.inputRevision === input.currentRevision) {
+    return;
+  }
+  throw new Error(
+    `Chapter ${job.chapterId} changed while job ${job.jobId} was running. Requeue the job before committing build output.`
+  );
+}
+async function listBuildJobs(options = {}) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    const params = [];
+    const filters = [];
+    if (options.archivePath !== void 0) {
+      params.push(createArchiveKey(resolve(options.archivePath)));
+      filters.push("archive_key = ?");
+    }
+    if (options.activeOnly === true || options.all !== true) {
+      filters.push("state IN ('queued', 'running', 'canceling', 'paused')");
+    }
+    return await state.queryAll(
+      `
+SELECT *
+FROM build_jobs
+${filters.length === 0 ? "" : `WHERE ${filters.join(" AND ")}`}
+ORDER BY
+  CASE state
+    WHEN 'running' THEN 0
+    WHEN 'canceling' THEN 1
+    WHEN 'queued' THEN 2
+    WHEN 'paused' THEN 3
+    ELSE 4
+  END,
+  queue_rank ASC,
+  updated_at DESC
+`,
+      params,
+      mapBuildJob
+    );
+  } finally {
+    await state.close();
+  }
+}
+async function findActiveBuildJobInLane(state, input) {
+  const laneFilter = input.target === "knowledge-graph" ? "target = 'knowledge-graph'" : "target IN ('reading-graph', 'reading-summary')";
+  return await state.queryOne(
+    `
+SELECT *
+FROM build_jobs
+WHERE archive_key = ?
+  AND chapter_id = ?
+  AND state IN ('queued', 'running', 'canceling', 'paused')
+  AND ${laneFilter}
+ORDER BY updated_at DESC
+LIMIT 1
+`,
+    [input.archiveKey, input.chapterId],
+    mapBuildJob
+  );
+}
+async function mergeActiveBuildJob(state, job, options, now) {
+  const nextTarget = job.target === "reading-graph" && options.target === "reading-summary" ? "reading-summary" : job.target;
+  const nextQueueRank = options.boost === true && job.state === "queued" ? await readMinQueueRank(state) - 1 : job.queueRank;
+  if (nextTarget === job.target && nextQueueRank === job.queueRank) {
+    return job;
+  }
+  await state.run(
+    `
+UPDATE build_jobs
+SET target = ?, queue_rank = ?, updated_at = ?
+WHERE job_id = ?
+`,
+    [nextTarget, nextQueueRank, now, job.jobId]
+  );
+  const updated = await requireBuildJobById(state, job.jobId);
+  if (nextTarget !== job.target) {
+    await appendBuildJobEvent(updated, {
+      at: now,
+      from: job.target,
+      jobId: job.jobId,
+      seq: 0,
+      to: nextTarget,
+      type: "target_changed"
+    });
+  }
+  if (nextQueueRank !== job.queueRank) {
+    await appendBuildJobEvent(updated, {
+      at: now,
+      jobId: job.jobId,
+      seq: 0,
+      state: updated.state,
+      type: "boosted"
+    });
+  }
+  return updated;
+}
+async function getBuildJob(jobId) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await requireBuildJobById(state, jobId);
+  } finally {
+    await state.close();
+  }
+}
+async function readBuildJobForStopCheck(jobId) {
+  const state = await openReadonlyBuildQueueDatabase();
+  try {
+    return await requireBuildJobById(state, jobId);
+  } finally {
+    await state.close();
+  }
+}
+async function resolveBuildJobId(jobIdPrefix) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await resolveBuildJobIdInState(state, jobIdPrefix);
+  } finally {
+    await state.close();
+  }
+}
+async function pauseBuildJob(jobId) {
+  return await updateBuildJobState(jobId, "paused", "paused", {
+    allowedStates: ["queued", "running"]
+  });
+}
+async function resumeBuildJob(jobId) {
+  return await updateBuildJobState(jobId, "queued", "resumed", {
+    allowedStates: ["paused"],
+    clearOwner: true
+  });
+}
+async function cancelBuildJob(jobId) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await state.transaction(async () => {
+      const job = await requireBuildJobById(state, jobId);
+      if (job.state === "running") {
+        return await markBuildJobCanceling(state, job);
+      }
+      if (job.state === "queued" || job.state === "paused") {
+        return await markBuildJobCanceled(state, job);
+      }
+      throw new Error(`Cannot cancel ${job.state} job ${jobId}.`);
+    });
+  } finally {
+    await state.close();
+  }
+}
+async function boostBuildJob(jobId) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await state.transaction(async () => {
+      const job = await requireBuildJobById(state, jobId);
+      if (job.state !== "queued") {
+        throw new Error(
+          `Only queued jobs can be boosted. Job ${jobId} is ${job.state}.`
+        );
+      }
+      const now = Date.now();
+      await state.run(
+        `
+UPDATE build_jobs
+SET queue_rank = ?, updated_at = ?
+WHERE job_id = ?
+`,
+        [await readMinQueueRank(state) - 1, now, jobId]
+      );
+      const updated = await requireBuildJobById(state, jobId);
+      await appendBuildJobEvent(updated, {
+        at: now,
+        jobId,
+        seq: 0,
+        state: "queued",
+        type: "boosted"
+      });
+      return updated;
+    });
+  } finally {
+    await state.close();
+  }
+}
+async function updateBuildJobTarget(jobId, target) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await state.transaction(async () => {
+      const job = await requireBuildJobById(state, jobId);
+      if (!ACTIVE_JOB_STATES.has(job.state)) {
+        throw new Error(`Cannot change target for ${job.state} job ${jobId}.`);
+      }
+      if (job.target === target) {
+        return job;
+      }
+      const existing = await findActiveBuildJobInLane(state, {
+        archiveKey: job.archiveKey,
+        chapterId: job.chapterId,
+        target
+      });
+      if (existing !== void 0 && existing.jobId !== job.jobId) {
+        throw new Error(
+          `Chapter ${job.chapterId} already has active ${formatBuildJobLane(target)} job ${existing.jobId}.`
+        );
+      }
+      if (job.target === "reading-summary" && target === "reading-graph") {
+        if (job.readingSummaryStartedAt !== void 0 || job.currentStep === "reading-summary") {
+          throw new Error(
+            `Cannot downgrade job ${jobId} after summary has started. Cancel it explicitly instead.`
+          );
+        }
+      }
+      const now = Date.now();
+      await state.run(
+        `
+UPDATE build_jobs
+SET target = ?, updated_at = ?
+WHERE job_id = ?
+`,
+        [target, now, jobId]
+      );
+      const updated = await requireBuildJobById(state, jobId);
+      await appendBuildJobEvent(updated, {
+        at: now,
+        from: job.target,
+        jobId,
+        seq: 0,
+        to: target,
+        type: "target_changed"
+      });
+      return updated;
+    });
+  } finally {
+    await state.close();
+  }
+}
+async function updateBuildJobState(jobId, stateName, eventType, options) {
+  const state = await openBuildQueueDatabase();
+  try {
+    await recoverStaleBuildJobs(state);
+    return await state.transaction(async () => {
+      const job = await requireBuildJobById(state, jobId);
+      if (!options.allowedStates.includes(job.state)) {
+        throw new Error(`Cannot ${eventType} ${job.state} job ${jobId}.`);
+      }
+      const now = Date.now();
+      await state.run(
+        `
+UPDATE build_jobs
+SET state = ?, updated_at = ?, finished_at = ?,
+    owner_id = CASE WHEN ? = 1 THEN NULL ELSE owner_id END,
+    owner_pid = CASE WHEN ? = 1 THEN NULL ELSE owner_pid END
+WHERE job_id = ?
+`,
+        [
+          stateName,
+          now,
+          options.finished === true ? now : null,
+          options.clearOwner === true || options.finished === true ? 1 : 0,
+          options.clearOwner === true || options.finished === true ? 1 : 0,
+          jobId
+        ]
+      );
+      const updated = await requireBuildJobById(state, jobId);
+      await appendBuildJobEvent(updated, {
+        at: now,
+        jobId,
+        seq: 0,
+        state: stateName,
+        type: eventType
+      });
+      return updated;
+    });
+  } finally {
+    await state.close();
+  }
+}
+export {
+  addBuildJob,
+  assertBuildJobInputRevision,
+  boostBuildJob,
+  cancelBuildJob,
+  getBuildJob,
+  listBuildJobs,
+  pauseBuildJob,
+  readBuildJobForStopCheck,
+  recordBuildJobInputRevision,
+  resolveBuildJobId,
+  resumeBuildJob,
+  updateBuildJobTarget
+};
+//# sourceMappingURL=jobs.js.map

package/dist/runtime/jobs/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/jobs/jobs.ts"],"sourcesContent":["import { randomUUID } from \"crypto\";\nimport { resolve } from \"path\";\nimport type { Database } from \"../../document/index.js\";\nimport {\n  createJobCachePath,\n  createJobEventsPath,\n  createJobLogPath,\n  createJobWorkspacePath,\n} from \"./paths.js\";\nimport { createArchiveKey } from \"./helpers.js\";\nimport { BuildJobStoppedError } from \"./progress.js\";\nimport { appendBuildJobEvent } from \"./events.js\";\nimport {\n  openBuildQueueDatabase,\n  openReadonlyBuildQueueDatabase,\n  readMaxQueueRank,\n  readMinQueueRank,\n  requireBuildJobById,\n  resolveBuildJobIdInState,\n} from \"./database.js\";\nimport { recoverStaleBuildJobs } from \"./recovery.js\";\nimport { markBuildJobCanceled, markBuildJobCanceling } from \"./state.js\";\nimport { formatBuildJobLane, mapBuildJob } from \"./row.js\";\nimport type {\n  AddBuildJobOptions,\n  BuildJob,\n  BuildJobEvent,\n  BuildJobListOptions,\n  BuildJobState,\n  BuildJobTarget,\n} from \"./types.js\";\n\nconst ACTIVE_JOB_STATES = new Set<BuildJobState>([\n  \"queued\",\n  \"running\",\n  \"canceling\",\n  \"paused\",\n]);\nexport async function addBuildJob(\n  options: AddBuildJobOptions,\n): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await state.transaction(async () => {\n      const archivePath = resolve(options.archivePath);\n      const archiveKey = createArchiveKey(archivePath);\n      const now = Date.now();\n      const existing = await findActiveBuildJobInLane(state, {\n        archiveKey,\n        chapterId: options.chapterId,\n        target: options.target,\n      });\n\n      if (existing !== undefined) {\n        return await mergeActiveBuildJob(state, existing, options, now);\n      }\n\n      const jobId = options.jobId ?? randomUUID();\n      const workspacePath = await createJobWorkspacePath(jobId);\n      const cachePath = await createJobCachePath(jobId);\n      const logPath = await createJobLogPath(jobId);\n      const eventsPath = await createJobEventsPath(jobId);\n      const queueRank =\n        options.boost === true\n          ? (await readMinQueueRank(state)) - 1\n          : (await readMaxQueueRank(state)) + 1;\n\n      await state.run(\n        `\nINSERT INTO build_jobs (\n  job_id, archive_key, archive_path, chapter_id, target, state, queue_rank,\n  workspace_path, cache_path, log_path, events_path, llm_json, prompt,\n  created_at, updated_at\n) VALUES (?, ?, ?, ?, ?, 'queued', ?, ?, ?, ?, ?, ?, ?, ?, ?)\n`,\n        [\n          jobId,\n          archiveKey,\n          archivePath,\n          options.chapterId,\n          options.target,\n          queueRank,\n          workspacePath,\n          cachePath,\n          logPath,\n          eventsPath,\n          options.llmJSON ?? null,\n          options.prompt ?? null,\n          now,\n          now,\n        ],\n      );\n\n      const job = await requireBuildJobById(state, jobId);\n\n      await appendBuildJobEvent(job, {\n        at: now,\n        jobId,\n        seq: 0,\n        state: \"queued\",\n        type: \"created\",\n      });\n      return job;\n    });\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function recordBuildJobInputRevision(input: {\n  readonly currentRevision: number;\n  readonly jobId: string;\n  readonly ownerId: string;\n}): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await state.transaction(async () => {\n      await state.run(\n        `\nUPDATE build_jobs\nSET input_revision = ?,\n    updated_at = ?\nWHERE job_id = ?\n  AND owner_id = ?\n  AND state = 'running'\n`,\n        [input.currentRevision, Date.now(), input.jobId, input.ownerId],\n      );\n    });\n\n    return await requireBuildJobById(state, input.jobId);\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function assertBuildJobInputRevision(input: {\n  readonly currentRevision: number;\n  readonly jobId: string;\n  readonly ownerId: string;\n}): Promise<void> {\n  const job = await getBuildJob(input.jobId);\n\n  if (job.state !== \"running\" || job.ownerId !== input.ownerId) {\n    throw new BuildJobStoppedError(\n      `Job ${input.jobId} is ${job.state}. Stop current worker execution.`,\n    );\n  }\n  if (job.inputRevision === undefined) {\n    throw new Error(\n      `Job ${input.jobId} has no recorded chapter input revision. Requeue the job before committing build output.`,\n    );\n  }\n  if (job.inputRevision === input.currentRevision) {\n    return;\n  }\n\n  throw new Error(\n    `Chapter ${job.chapterId} changed while job ${job.jobId} was running. Requeue the job before committing build output.`,\n  );\n}\n\nexport async function listBuildJobs(\n  options: BuildJobListOptions = {},\n): Promise<BuildJob[]> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    const params: Array<number | string> = [];\n    const filters: string[] = [];\n\n    if (options.archivePath !== undefined) {\n      params.push(createArchiveKey(resolve(options.archivePath)));\n      filters.push(\"archive_key = ?\");\n    }\n    if (options.activeOnly === true || options.all !== true) {\n      filters.push(\"state IN ('queued', 'running', 'canceling', 'paused')\");\n    }\n\n    return await state.queryAll(\n      `\nSELECT *\nFROM build_jobs\n${filters.length === 0 ? \"\" : `WHERE ${filters.join(\" AND \")}`}\nORDER BY\n  CASE state\n    WHEN 'running' THEN 0\n    WHEN 'canceling' THEN 1\n    WHEN 'queued' THEN 2\n    WHEN 'paused' THEN 3\n    ELSE 4\n  END,\n  queue_rank ASC,\n  updated_at DESC\n`,\n      params,\n      mapBuildJob,\n    );\n  } finally {\n    await state.close();\n  }\n}\n\nasync function findActiveBuildJobInLane(\n  state: Database,\n  input: {\n    readonly archiveKey: string;\n    readonly chapterId: number;\n    readonly target: BuildJobTarget;\n  },\n): Promise<BuildJob | undefined> {\n  const laneFilter =\n    input.target === \"knowledge-graph\"\n      ? \"target = 'knowledge-graph'\"\n      : \"target IN ('reading-graph', 'reading-summary')\";\n\n  return await state.queryOne(\n    `\nSELECT *\nFROM build_jobs\nWHERE archive_key = ?\n  AND chapter_id = ?\n  AND state IN ('queued', 'running', 'canceling', 'paused')\n  AND ${laneFilter}\nORDER BY updated_at DESC\nLIMIT 1\n`,\n    [input.archiveKey, input.chapterId],\n    mapBuildJob,\n  );\n}\n\nasync function mergeActiveBuildJob(\n  state: Database,\n  job: BuildJob,\n  options: AddBuildJobOptions,\n  now: number,\n): Promise<BuildJob> {\n  const nextTarget =\n    job.target === \"reading-graph\" && options.target === \"reading-summary\"\n      ? \"reading-summary\"\n      : job.target;\n  const nextQueueRank =\n    options.boost === true && job.state === \"queued\"\n      ? (await readMinQueueRank(state)) - 1\n      : job.queueRank;\n\n  if (nextTarget === job.target && nextQueueRank === job.queueRank) {\n    return job;\n  }\n\n  await state.run(\n    `\nUPDATE build_jobs\nSET target = ?, queue_rank = ?, updated_at = ?\nWHERE job_id = ?\n`,\n    [nextTarget, nextQueueRank, now, job.jobId],\n  );\n\n  const updated = await requireBuildJobById(state, job.jobId);\n\n  if (nextTarget !== job.target) {\n    await appendBuildJobEvent(updated, {\n      at: now,\n      from: job.target,\n      jobId: job.jobId,\n      seq: 0,\n      to: nextTarget,\n      type: \"target_changed\",\n    });\n  }\n  if (nextQueueRank !== job.queueRank) {\n    await appendBuildJobEvent(updated, {\n      at: now,\n      jobId: job.jobId,\n      seq: 0,\n      state: updated.state,\n      type: \"boosted\",\n    });\n  }\n\n  return updated;\n}\n\nexport async function getBuildJob(jobId: string): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await requireBuildJobById(state, jobId);\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function readBuildJobForStopCheck(\n  jobId: string,\n): Promise<BuildJob> {\n  const state = await openReadonlyBuildQueueDatabase();\n\n  try {\n    return await requireBuildJobById(state, jobId);\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function resolveBuildJobId(jobIdPrefix: string): Promise<string> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await resolveBuildJobIdInState(state, jobIdPrefix);\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function pauseBuildJob(jobId: string): Promise<BuildJob> {\n  return await updateBuildJobState(jobId, \"paused\", \"paused\", {\n    allowedStates: [\"queued\", \"running\"],\n  });\n}\n\nexport async function resumeBuildJob(jobId: string): Promise<BuildJob> {\n  return await updateBuildJobState(jobId, \"queued\", \"resumed\", {\n    allowedStates: [\"paused\"],\n    clearOwner: true,\n  });\n}\n\nexport async function cancelBuildJob(jobId: string): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await state.transaction(async () => {\n      const job = await requireBuildJobById(state, jobId);\n\n      if (job.state === \"running\") {\n        return await markBuildJobCanceling(state, job);\n      }\n      if (job.state === \"queued\" || job.state === \"paused\") {\n        return await markBuildJobCanceled(state, job);\n      }\n\n      throw new Error(`Cannot cancel ${job.state} job ${jobId}.`);\n    });\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function boostBuildJob(jobId: string): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await state.transaction(async () => {\n      const job = await requireBuildJobById(state, jobId);\n\n      if (job.state !== \"queued\") {\n        throw new Error(\n          `Only queued jobs can be boosted. Job ${jobId} is ${job.state}.`,\n        );\n      }\n\n      const now = Date.now();\n      await state.run(\n        `\nUPDATE build_jobs\nSET queue_rank = ?, updated_at = ?\nWHERE job_id = ?\n`,\n        [(await readMinQueueRank(state)) - 1, now, jobId],\n      );\n\n      const updated = await requireBuildJobById(state, jobId);\n      await appendBuildJobEvent(updated, {\n        at: now,\n        jobId,\n        seq: 0,\n        state: \"queued\",\n        type: \"boosted\",\n      });\n      return updated;\n    });\n  } finally {\n    await state.close();\n  }\n}\n\nexport async function updateBuildJobTarget(\n  jobId: string,\n  target: BuildJobTarget,\n): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await state.transaction(async () => {\n      const job = await requireBuildJobById(state, jobId);\n\n      if (!ACTIVE_JOB_STATES.has(job.state)) {\n        throw new Error(`Cannot change target for ${job.state} job ${jobId}.`);\n      }\n      if (job.target === target) {\n        return job;\n      }\n      const existing = await findActiveBuildJobInLane(state, {\n        archiveKey: job.archiveKey,\n        chapterId: job.chapterId,\n        target,\n      });\n\n      if (existing !== undefined && existing.jobId !== job.jobId) {\n        throw new Error(\n          `Chapter ${job.chapterId} already has active ${formatBuildJobLane(target)} job ${existing.jobId}.`,\n        );\n      }\n      if (job.target === \"reading-summary\" && target === \"reading-graph\") {\n        if (\n          job.readingSummaryStartedAt !== undefined ||\n          job.currentStep === \"reading-summary\"\n        ) {\n          throw new Error(\n            `Cannot downgrade job ${jobId} after summary has started. Cancel it explicitly instead.`,\n          );\n        }\n      }\n\n      const now = Date.now();\n      await state.run(\n        `\nUPDATE build_jobs\nSET target = ?, updated_at = ?\nWHERE job_id = ?\n`,\n        [target, now, jobId],\n      );\n\n      const updated = await requireBuildJobById(state, jobId);\n      await appendBuildJobEvent(updated, {\n        at: now,\n        from: job.target,\n        jobId,\n        seq: 0,\n        to: target,\n        type: \"target_changed\",\n      });\n      return updated;\n    });\n  } finally {\n    await state.close();\n  }\n}\n\nasync function updateBuildJobState(\n  jobId: string,\n  stateName: BuildJobState,\n  eventType: Extract<BuildJobEvent[\"type\"], \"paused\" | \"resumed\">,\n  options: {\n    readonly allowedStates: readonly BuildJobState[];\n    readonly clearOwner?: boolean;\n    readonly finished?: boolean;\n  },\n): Promise<BuildJob> {\n  const state = await openBuildQueueDatabase();\n\n  try {\n    await recoverStaleBuildJobs(state);\n    return await state.transaction(async () => {\n      const job = await requireBuildJobById(state, jobId);\n\n      if (!options.allowedStates.includes(job.state)) {\n        throw new Error(`Cannot ${eventType} ${job.state} job ${jobId}.`);\n      }\n\n      const now = Date.now();\n      await state.run(\n        `\nUPDATE build_jobs\nSET state = ?, updated_at = ?, finished_at = ?,\n    owner_id = CASE WHEN ? = 1 THEN NULL ELSE owner_id END,\n    owner_pid = CASE WHEN ? = 1 THEN NULL ELSE owner_pid END\nWHERE job_id = ?\n`,\n        [\n          stateName,\n          now,\n          options.finished === true ? now : null,\n          options.clearOwner === true || options.finished === true ? 1 : 0,\n          options.clearOwner === true || options.finished === true ? 1 : 0,\n          jobId,\n        ],\n      );\n\n      const updated = await requireBuildJobById(state, jobId);\n      await appendBuildJobEvent(updated, {\n        at: now,\n        jobId,\n        seq: 0,\n        state: stateName as \"queued\" | \"paused\",\n        type: eventType,\n      } as BuildJobEvent);\n      return updated;\n    });\n  } finally {\n    await state.close();\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/runtime/jobs/paths.d.ts

@@ -0,0 +1,9 @@
+declare function getBuildQueueDatabasePath(): string;
+declare function createJobWorkspacePath(jobId: string): Promise<string>;
+declare function getBuildJobWorkspaceRootPath(): string;
+declare function createJobCachePath(jobId: string): Promise<string>;
+declare function createJobLogPath(jobId: string): Promise<string>;
+declare function createJobEventsPath(jobId: string): Promise<string>;
+declare function getBuildQueueStateDirectoryPath(): string;
+
+export { createJobCachePath, createJobEventsPath, createJobLogPath, createJobWorkspacePath, getBuildJobWorkspaceRootPath, getBuildQueueDatabasePath, getBuildQueueStateDirectoryPath };

package/dist/runtime/jobs/paths.js

@@ -0,0 +1,48 @@
+import { mkdir } from "fs/promises";
+import { join } from "path";
+import { resolveWikiGraphJobsDirectoryPath } from "../common/wiki-graph/dir.js";
+function getBuildQueueDatabasePath() {
+  return join(getBuildQueueStateDirectoryPath(), "job.sqlite");
+}
+async function createJobWorkspacePath(jobId) {
+  const workspacePath = join(getBuildJobWorkspaceRootPath(), jobId);
+  await mkdir(workspacePath, { recursive: true });
+  return workspacePath;
+}
+function getBuildJobWorkspaceRootPath() {
+  return join(getBuildQueueStateDirectoryPath(), "work");
+}
+async function createJobCachePath(jobId) {
+  const cachePath = join(getBuildJobCacheRootPath(), jobId);
+  await mkdir(cachePath, { recursive: true });
+  return cachePath;
+}
+function getBuildJobCacheRootPath() {
+  return join(getBuildQueueStateDirectoryPath(), "cache");
+}
+async function createJobLogPath(jobId) {
+  const logPath = join(getBuildJobLogRootPath(), jobId);
+  await mkdir(logPath, { recursive: true });
+  return logPath;
+}
+function getBuildJobLogRootPath() {
+  return join(getBuildQueueStateDirectoryPath(), "logs");
+}
+async function createJobEventsPath(jobId) {
+  const rootPath = join(getBuildQueueStateDirectoryPath(), "events");
+  await mkdir(rootPath, { recursive: true });
+  return join(rootPath, `${jobId}.ndjson`);
+}
+function getBuildQueueStateDirectoryPath() {
+  return resolveWikiGraphJobsDirectoryPath();
+}
+export {
+  createJobCachePath,
+  createJobEventsPath,
+  createJobLogPath,
+  createJobWorkspacePath,
+  getBuildJobWorkspaceRootPath,
+  getBuildQueueDatabasePath,
+  getBuildQueueStateDirectoryPath
+};
+//# sourceMappingURL=paths.js.map

package/dist/runtime/jobs/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/runtime/jobs/paths.ts"],"sourcesContent":["import { mkdir } from \"fs/promises\";\nimport { join } from \"path\";\n\nimport { resolveWikiGraphJobsDirectoryPath } from \"../common/wiki-graph/dir.js\";\n\nexport function getBuildQueueDatabasePath(): string {\n  return join(getBuildQueueStateDirectoryPath(), \"job.sqlite\");\n}\n\nexport async function createJobWorkspacePath(jobId: string): Promise<string> {\n  const workspacePath = join(getBuildJobWorkspaceRootPath(), jobId);\n\n  await mkdir(workspacePath, { recursive: true });\n  return workspacePath;\n}\n\nexport function getBuildJobWorkspaceRootPath(): string {\n  return join(getBuildQueueStateDirectoryPath(), \"work\");\n}\n\nexport async function createJobCachePath(jobId: string): Promise<string> {\n  const cachePath = join(getBuildJobCacheRootPath(), jobId);\n\n  await mkdir(cachePath, { recursive: true });\n  return cachePath;\n}\n\nfunction getBuildJobCacheRootPath(): string {\n  return join(getBuildQueueStateDirectoryPath(), \"cache\");\n}\n\nexport async function createJobLogPath(jobId: string): Promise<string> {\n  const logPath = join(getBuildJobLogRootPath(), jobId);\n\n  await mkdir(logPath, { recursive: true });\n  return logPath;\n}\n\nfunction getBuildJobLogRootPath(): string {\n  return join(getBuildQueueStateDirectoryPath(), \"logs\");\n}\n\nexport async function createJobEventsPath(jobId: string): Promise<string> {\n  const rootPath = join(getBuildQueueStateDirectoryPath(), \"events\");\n\n  await mkdir(rootPath, { recursive: true });\n  return join(rootPath, `${jobId}.ndjson`);\n}\n\nexport function getBuildQueueStateDirectoryPath(): string {\n  return resolveWikiGraphJobsDirectoryPath();\n}\n"],"mappings":"AAAA,SAAS,aAAa;AACtB,SAAS,YAAY;AAErB,SAAS,yCAAyC;AAE3C,SAAS,4BAAoC;AAClD,SAAO,KAAK,gCAAgC,GAAG,YAAY;AAC7D;AAEA,eAAsB,uBAAuB,OAAgC;AAC3E,QAAM,gBAAgB,KAAK,6BAA6B,GAAG,KAAK;AAEhE,QAAM,MAAM,eAAe,EAAE,WAAW,KAAK,CAAC;AAC9C,SAAO;AACT;AAEO,SAAS,+BAAuC;AACrD,SAAO,KAAK,gCAAgC,GAAG,MAAM;AACvD;AAEA,eAAsB,mBAAmB,OAAgC;AACvE,QAAM,YAAY,KAAK,yBAAyB,GAAG,KAAK;AAExD,QAAM,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAC1C,SAAO;AACT;AAEA,SAAS,2BAAmC;AAC1C,SAAO,KAAK,gCAAgC,GAAG,OAAO;AACxD;AAEA,eAAsB,iBAAiB,OAAgC;AACrE,QAAM,UAAU,KAAK,uBAAuB,GAAG,KAAK;AAEpD,QAAM,MAAM,SAAS,EAAE,WAAW,KAAK,CAAC;AACxC,SAAO;AACT;AAEA,SAAS,yBAAiC;AACxC,SAAO,KAAK,gCAAgC,GAAG,MAAM;AACvD;AAEA,eAAsB,oBAAoB,OAAgC;AACxE,QAAM,WAAW,KAAK,gCAAgC,GAAG,QAAQ;AAEjE,QAAM,MAAM,UAAU,EAAE,WAAW,KAAK,CAAC;AACzC,SAAO,KAAK,UAAU,GAAG,KAAK,SAAS;AACzC;AAEO,SAAS,kCAA0C;AACxD,SAAO,kCAAkC;AAC3C;","names":[]}

package/dist/runtime/jobs/progress.d.ts

@@ -0,0 +1,37 @@
+import { BuildJobProgressReporter, BuildJob, BuildJobEvent, BuildJobTarget, BuildJobTokenUsage, BuildJobProgressPhase, BuildJobProgressUnit } from './types.js';
+
+interface BuildJobProgressAccumulatorActions {
+    appendBuildJobEvent(job: BuildJob, event: BuildJobEvent): Promise<void>;
+    markBuildJobStep(jobId: string, step: BuildJobTarget): Promise<void>;
+    readBuildJobForStopCheck(jobId: string): Promise<BuildJob>;
+}
+declare class BuildJobProgressAccumulator implements BuildJobProgressReporter {
+    #private;
+    constructor(job: BuildJob, ownerId: string, actions: BuildJobProgressAccumulatorActions);
+    addOutputCharacters(characters: number): Promise<void>;
+    addTokenUsage(usage: BuildJobTokenUsage): Promise<void>;
+    setTotals(input: {
+        readonly totalGraphWords?: number;
+        readonly totalReadingSummaryWords?: number;
+    }): Promise<void>;
+    stepStarted(step: BuildJobTarget): Promise<void>;
+    stepCompleted(step: BuildJobTarget): Promise<void>;
+    updateWords(input: {
+        readonly graphWords?: number;
+        readonly readingSummaryWords?: number;
+    }): Promise<void>;
+    updatePhase(input: {
+        readonly done: number;
+        readonly force?: boolean;
+        readonly phase: BuildJobProgressPhase;
+        readonly phaseDetail?: string;
+        readonly total: number;
+        readonly unit: BuildJobProgressUnit;
+    }): Promise<void>;
+    throwIfStopped(): Promise<void>;
+}
+declare class BuildJobStoppedError extends Error {
+    constructor(message: string);
+}
+
+export { BuildJobProgressAccumulator, type BuildJobProgressAccumulatorActions, BuildJobStoppedError };