@ghostpaw/questlog 0.9.2 → 0.10.1

package/dist/index.js

@@ -1,9 +1,1026 @@
+import { randomBytes, createHmac } from 'node:crypto';
+import { basename, extname } from 'node:path';
+
 var __defProp = Object.defineProperty;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  addHook: () => addHook,
+  hookEventTypes: () => hookEventTypes,
+  hookLabel: () => hookLabel,
+  listDeliveries: () => listDeliveries,
+  listHooks: () => listHooks,
+  removeHook: () => removeHook,
+  testHook: () => testHook,
+  tickQuestlog: () => tickQuestlog,
+  watchQuestlog: () => watchQuestlog
+});
+
+// src/tags/normalize_tag_name.ts
+function normalizeTagName(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, " ");
+}
+
+// src/hooks/types.ts
+var hookEventTypes = [
+  "quest.due",
+  "quest.overdue",
+  "quest.unblocked",
+  "repeatable.spawned",
+  "rumor.captured"
+];
+
+// src/hooks/add_hook.ts
+function addHook(db, input) {
+  let url;
+  try {
+    url = new URL(input.url);
+  } catch {
+    throw new Error("Expected an HTTP or HTTPS URL");
+  }
+  if (!["http:", "https:"].includes(url.protocol)) throw new Error("Expected an HTTP or HTTPS URL");
+  const minGap = input.minGap ?? 60;
+  if (!Number.isSafeInteger(minGap) || minGap < 0)
+    throw new Error("Min gap must be a nonnegative integer");
+  const events = input.events ?? [...hookEventTypes];
+  if (!events.length || events.some((e) => !hookEventTypes.includes(e)))
+    throw new Error("Unknown event filter");
+  if (input.tag !== void 0 && !normalizeTagName(input.tag))
+    throw new Error("Expected a tag name");
+  const secret = input.secret ?? randomBytes(32).toString("hex");
+  if (!secret.trim()) throw new Error("Expected a nonempty signing secret");
+  const result = db.prepare(
+    "INSERT INTO hook_targets(url, secret, tag, events, min_gap, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+  ).run(
+    url.href,
+    secret,
+    input.tag === void 0 ? null : normalizeTagName(input.tag),
+    JSON.stringify(events),
+    minGap,
+    input.now ?? Date.now()
+  );
+  return { id: Number(result.lastInsertRowid), secret };
+}
+function hookLabel(db, name) {
+  if (name !== void 0) {
+    if (!name.trim()) throw new Error("Expected a nonempty database label");
+    db.prepare(
+      "INSERT INTO hook_settings(id, label) VALUES (1, ?) ON CONFLICT(id) DO UPDATE SET label = excluded.label"
+    ).run(name);
+  }
+  const saved = db.prepare("SELECT label FROM hook_settings WHERE id = 1").get();
+  if (saved) return String(saved.label);
+  const path = String(
+    db.prepare("PRAGMA database_list").all().find((row) => row.name === "main")?.file ?? ""
+  );
+  return path ? basename(path, extname(path)) : "questlog";
+}
+
+// src/hooks/list_deliveries.ts
+function listDeliveries(db, options = {}) {
+  return db.prepare(
+    `SELECT * FROM hook_deliveries ${options.includeDelivered ? "" : "WHERE status <> 'delivered'"} ORDER BY target_id, next_attempt_at, id`
+  ).all().map(
+    (row) => ({
+      id: String(row.id),
+      targetId: Number(row.target_id),
+      events: JSON.parse(String(row.events)),
+      status: row.status,
+      attempts: Number(row.attempts),
+      lastAttemptAt: row.last_attempt_at == null ? null : Number(row.last_attempt_at),
+      httpStatus: row.http_status == null ? null : Number(row.http_status),
+      errorClass: row.error_class == null ? null : String(row.error_class),
+      nextAttemptAt: Number(row.next_attempt_at)
+    })
+  ).filter(
+    (d) => options.questId === void 0 || d.events.some((e) => e.questId === options.questId)
+  );
+}
+
+// src/hooks/list_hooks.ts
+function listHooks(db) {
+  return db.prepare(`SELECT id, url, tag, events, min_gap, created_at, last_wake,
+ (SELECT COUNT(*) FROM hook_assignments a LEFT JOIN hook_deliveries d ON d.id = a.delivery_id WHERE a.target_id = t.id AND (a.delivery_id IS NULL OR d.status = 'pending')) AS pending,
+ (SELECT COUNT(*) FROM hook_deliveries d WHERE d.target_id = t.id AND d.status = 'failed') AS failed
+ FROM hook_targets t ORDER BY id`).all().map((row) => {
+    const url = new URL(String(row.url));
+    url.username = "";
+    url.password = "";
+    url.search = "";
+    url.hash = "";
+    return {
+      id: Number(row.id),
+      scope: row.tag == null ? "database" : "tag",
+      url: url.href,
+      tag: row.tag == null ? null : String(row.tag),
+      events: JSON.parse(String(row.events)),
+      minGap: Number(row.min_gap),
+      createdAt: Number(row.created_at),
+      lastWake: row.last_wake == null ? null : Number(row.last_wake),
+      pending: Number(row.pending),
+      failed: Number(row.failed)
+    };
+  });
+}
+
+// src/with_transaction.ts
+var transactionDepth = /* @__PURE__ */ new WeakMap();
+function withTransaction(db, fn) {
+  const depth = transactionDepth.get(db) ?? 0;
+  const savepoint = `questlog_${depth}`;
+  if (depth === 0) {
+    db.exec("BEGIN IMMEDIATE");
+  } else {
+    db.exec(`SAVEPOINT ${savepoint}`);
+  }
+  transactionDepth.set(db, depth + 1);
+  try {
+    const result = fn();
+    if (depth === 0) {
+      db.exec("COMMIT");
+    } else {
+      db.exec(`RELEASE SAVEPOINT ${savepoint}`);
+    }
+    transactionDepth.set(db, depth);
+    return result;
+  } catch (error) {
+    try {
+      if (depth === 0) {
+        db.exec("ROLLBACK");
+      } else {
+        db.exec(`ROLLBACK TO SAVEPOINT ${savepoint}`);
+        db.exec(`RELEASE SAVEPOINT ${savepoint}`);
+      }
+    } catch {
+    }
+    transactionDepth.set(db, depth);
+    throw error;
+  }
+}
+
+// src/hooks/remove_hook.ts
+function removeHook(db, id) {
+  withTransaction(db, () => {
+    db.prepare("DELETE FROM hook_assignments WHERE target_id = ?").run(id);
+    db.prepare("DELETE FROM hook_deliveries WHERE target_id = ?").run(id);
+    db.prepare("DELETE FROM hook_targets WHERE id = ?").run(id);
+  });
+}
+
+// src/version.ts
+var questlogVersion = "0.10.1";
+
+// src/hooks/send_hook_delivery.ts
+async function sendHookDelivery(db, delivery, target, options) {
+  const now = options.now ?? options.clock?.() ?? Date.now();
+  const timestamp = String(Math.floor(now / 1e3));
+  const body = JSON.stringify({
+    type: "questlog.events",
+    db: hookLabel(db),
+    deliveryId: delivery.id,
+    sentAt: new Date(now).toISOString(),
+    events: delivery.events
+  });
+  const signature = createHmac("sha256", target.secret).update(`${timestamp}.${body}`).digest("hex");
+  let status = null;
+  let errorClass = null;
+  try {
+    const response = await (options.fetch ?? globalThis.fetch)(target.url, {
+      method: "POST",
+      redirect: "error",
+      headers: {
+        "content-type": "application/json",
+        "user-agent": `questlog/${questlogVersion}`,
+        "x-questlog-delivery": delivery.id,
+        "x-questlog-timestamp": timestamp,
+        "x-questlog-signature": `sha256=${signature}`
+      },
+      body,
+      signal: AbortSignal.timeout(Math.max(1, Math.min(options.timeoutMs ?? 5e3, 5e3)))
+    });
+    status = response.status;
+    await response.body?.cancel();
+  } catch (error) {
+    errorClass = error instanceof Error && ["TimeoutError", "AbortError"].includes(error.name) ? error.name : "NetworkError";
+  }
+  const delivered = status != null && status >= 200 && status < 300;
+  const completedAt = options.now ?? options.clock?.() ?? Date.now();
+  withTransaction(db, () => {
+    if (!db.prepare("SELECT id FROM hook_targets WHERE id = ? AND claim = ?").get(target.id, target.claim))
+      return;
+    const delay = Math.min(36e5, 3e4 * 2 ** (delivery.attempts - 1));
+    const jitter = Number.parseInt(randomBytes(2).toString("hex"), 16) % 1e3;
+    db.prepare(
+      "UPDATE hook_deliveries SET status = ?, http_status = ?, error_class = ?, next_attempt_at = ? WHERE id = ?"
+    ).run(
+      delivered ? "delivered" : delivery.attempts >= 8 ? "failed" : "pending",
+      status,
+      errorClass,
+      completedAt + delay + jitter,
+      delivery.id
+    );
+    db.prepare(
+      "UPDATE hook_targets SET claim = NULL, lease_until = NULL WHERE id = ? AND claim = ?"
+    ).run(target.id, target.claim);
+    db.prepare(
+      "DELETE FROM hook_deliveries WHERE target_id = ? AND status = 'delivered' AND id NOT IN (SELECT id FROM hook_deliveries WHERE target_id = ? AND status = 'delivered' ORDER BY last_attempt_at DESC, id DESC LIMIT 500)"
+    ).run(target.id, target.id);
+  });
+  return delivered;
+}
+
+// src/hooks/test_hook.ts
+async function testHook(db, id, options = {}) {
+  const now = options.now ?? options.clock?.() ?? Date.now();
+  const claim = randomBytes(16).toString("hex");
+  const delivery = {
+    id: `d_${randomBytes(16).toString("hex")}`,
+    targetId: id,
+    events: [
+      {
+        id: `e_test_${randomBytes(16).toString("hex")}`,
+        type: "hook.test",
+        occurredAt: new Date(now).toISOString()
+      }
+    ],
+    status: "pending",
+    attempts: 1,
+    lastAttemptAt: now,
+    httpStatus: null,
+    errorClass: null,
+    nextAttemptAt: now
+  };
+  const target = withTransaction(db, () => {
+    const row = db.prepare("SELECT url, secret, lease_until FROM hook_targets WHERE id = ?").get(id);
+    if (!row) throw new Error("Hook not found");
+    if (row.lease_until != null && Number(row.lease_until) > now)
+      throw new Error("Hook delivery is in progress");
+    db.prepare(
+      "INSERT INTO hook_deliveries(id, target_id, events, status, attempts, last_attempt_at, next_attempt_at) VALUES (?, ?, ?, ?, ?, ?, ?)"
+    ).run(delivery.id, id, JSON.stringify(delivery.events), "pending", 1, now, now);
+    db.prepare(
+      "UPDATE hook_targets SET claim = ?, lease_until = ?, last_wake = ? WHERE id = ?"
+    ).run(claim, now + 12e4, now, id);
+    return { id, url: String(row.url), secret: String(row.secret), claim };
+  });
+  return { id: delivery.id, delivered: await sendHookDelivery(db, delivery, target, options) };
+}
+
+// src/quests/map_quest_row.ts
+function asBoolean(value) {
+  return Number(value) === 1;
+}
+function mapQuestRow(row) {
+  return {
+    id: Number(row.id),
+    questlineId: row.questline_id == null ? null : Number(row.questline_id),
+    sourceRumorId: row.source_rumor_id == null ? null : Number(row.source_rumor_id),
+    spawnedByQuestId: row.spawned_by_quest_id == null ? null : Number(row.spawned_by_quest_id),
+    spawnedFromRepeatableId: row.spawned_from_repeatable_id == null ? null : Number(row.spawned_from_repeatable_id),
+    spawnedForAt: row.spawned_for_at == null ? null : Number(row.spawned_for_at),
+    title: String(row.title),
+    objective: String(row.objective),
+    outcome: row.outcome == null ? null : String(row.outcome),
+    createdAt: Number(row.created_at),
+    updatedAt: Number(row.updated_at),
+    startedAt: row.started_at == null ? null : Number(row.started_at),
+    resolvedAt: row.resolved_at == null ? null : Number(row.resolved_at),
+    success: row.success == null ? null : asBoolean(row.success),
+    effortSeconds: Number(row.effort_seconds),
+    estimateSeconds: row.estimate_seconds == null ? null : Number(row.estimate_seconds),
+    notBeforeAt: row.not_before_at == null ? null : Number(row.not_before_at),
+    dueAt: row.due_at == null ? null : Number(row.due_at),
+    scheduledStartAt: row.scheduled_start_at == null ? null : Number(row.scheduled_start_at),
+    scheduledEndAt: row.scheduled_end_at == null ? null : Number(row.scheduled_end_at),
+    allDay: asBoolean(row.all_day),
+    deletedAt: row.deleted_at == null ? null : Number(row.deleted_at)
+  };
+}
+
+// src/quests/get_quest_or_throw.ts
+function getQuestOrThrow(db, questId) {
+  const row = db.prepare("SELECT * FROM quests WHERE id = ? AND deleted_at IS NULL").get(questId);
+  if (!row) {
+    throw new Error(`Quest ${questId} was not found.`);
+  }
+  return mapQuestRow(row);
+}
+
+// src/resolve_now.ts
+function resolveNow(now) {
+  return now ?? Date.now();
+}
+
+// src/rewards/copy_repeatable_quest_rewards_to_quest.ts
+function copyRepeatableQuestRewardsToQuest(db, repeatableQuestId, questId, now) {
+  const effectiveNow = resolveNow(now);
+  const rows = db.prepare(
+    `SELECT kind, name, description, quantity
+       FROM repeatable_quest_rewards
+       WHERE repeatable_quest_id = ? AND deleted_at IS NULL`
+  ).all(repeatableQuestId);
+  for (const row of rows) {
+    db.prepare(
+      `INSERT INTO quest_rewards (quest_id, kind, name, description, quantity, created_at)
+       VALUES (?, ?, ?, ?, ?, ?)`
+    ).run(
+      questId,
+      String(row.kind),
+      String(row.name),
+      row.description == null ? null : String(row.description),
+      row.quantity == null ? null : Number(row.quantity),
+      effectiveNow
+    );
+  }
+}
+
+// src/tags/copy_repeatable_quest_tags_to_quest.ts
+function copyRepeatableQuestTagsToQuest(db, repeatableQuestId, questId, now) {
+  const effectiveNow = resolveNow(now);
+  const rows = db.prepare(
+    `SELECT tag_id
+       FROM repeatable_quest_tags
+       WHERE repeatable_quest_id = ? AND deleted_at IS NULL`
+  ).all(repeatableQuestId);
+  for (const row of rows) {
+    db.prepare(
+      `INSERT INTO quest_tags (quest_id, tag_id, created_at)
+       VALUES (?, ?, ?)`
+    ).run(questId, Number(row.tag_id), effectiveNow);
+  }
+}
+
+// src/repeatable_quests/map_repeatable_quest_row.ts
+function asBoolean2(value) {
+  return Number(value) === 1;
+}
+function mapRepeatableQuestRow(row) {
+  return {
+    id: Number(row.id),
+    questlineId: row.questline_id == null ? null : Number(row.questline_id),
+    title: String(row.title),
+    objective: String(row.objective),
+    rrule: String(row.rrule),
+    anchorAt: Number(row.anchor_at),
+    notBeforeOffsetSeconds: row.not_before_offset_seconds == null ? null : Number(row.not_before_offset_seconds),
+    dueOffsetSeconds: row.due_offset_seconds == null ? null : Number(row.due_offset_seconds),
+    scheduledStartOffsetSeconds: row.scheduled_start_offset_seconds == null ? null : Number(row.scheduled_start_offset_seconds),
+    scheduledEndOffsetSeconds: row.scheduled_end_offset_seconds == null ? null : Number(row.scheduled_end_offset_seconds),
+    allDay: asBoolean2(row.all_day),
+    estimateSeconds: row.estimate_seconds == null ? null : Number(row.estimate_seconds),
+    createdAt: Number(row.created_at),
+    updatedAt: Number(row.updated_at),
+    archivedAt: row.archived_at == null ? null : Number(row.archived_at),
+    deletedAt: row.deleted_at == null ? null : Number(row.deleted_at)
+  };
+}
+
+// src/repeatable_quests/get_repeatable_quest_or_throw.ts
+function getRepeatableQuestOrThrow(db, repeatableQuestId) {
+  const row = db.prepare("SELECT * FROM repeatable_quests WHERE id = ? AND deleted_at IS NULL").get(repeatableQuestId);
+  if (!row) {
+    throw new Error(`Repeatable quest ${repeatableQuestId} was not found.`);
+  }
+  return mapRepeatableQuestRow(row);
+}
+
+// src/repeatable_quests/advance_anchor.ts
+var WEEK_MS = 7 * 864e5;
+function advanceAnchor(anchorAt, freq, interval) {
+  const date = new Date(anchorAt);
+  if (freq === "MONTHLY") {
+    date.setUTCMonth(date.getUTCMonth() + interval);
+    return date.getTime();
+  }
+  if (freq === "YEARLY") {
+    date.setUTCFullYear(date.getUTCFullYear() + interval);
+    return date.getTime();
+  }
+  return anchorAt + interval * WEEK_MS;
+}
+
+// src/repeatable_quests/parse_rrule.ts
+var WEEKDAY = {
+  SU: 0,
+  MO: 1,
+  TU: 2,
+  WE: 3,
+  TH: 4,
+  FR: 5,
+  SA: 6
+};
+function parseRRule(rrule) {
+  const parts = Object.fromEntries(
+    rrule.split(";").map((part) => part.trim()).filter(Boolean).map((part) => {
+      const [key, value] = part.split("=");
+      return [key, value];
+    })
+  );
+  const freq = parts.FREQ;
+  if (freq !== "DAILY" && freq !== "WEEKLY" && freq !== "MONTHLY" && freq !== "YEARLY") {
+    throw new Error(`Unsupported RRULE FREQ: ${freq ?? "missing"}`);
+  }
+  const interval = parts.INTERVAL == null ? 1 : Number(parts.INTERVAL);
+  if (!Number.isFinite(interval) || interval < 1) {
+    throw new Error("RRULE INTERVAL must be a positive integer.");
+  }
+  const count = parts.COUNT == null ? null : Number(parts.COUNT);
+  if (count != null && (!Number.isFinite(count) || count < 1)) {
+    throw new Error("RRULE COUNT must be a positive integer.");
+  }
+  const until = parts.UNTIL == null ? null : Date.parse(parts.UNTIL);
+  if (parts.UNTIL != null && Number.isNaN(until)) {
+    throw new Error("RRULE UNTIL must be parseable as a date.");
+  }
+  const byDay = parts.BYDAY == null ? null : parts.BYDAY.split(",").map((token) => {
+    const value = WEEKDAY[token];
+    if (value == null) {
+      throw new Error(`Unsupported RRULE BYDAY token: ${token}`);
+    }
+    return value;
+  });
+  return { freq, interval, count, until, byDay };
+}
+
+// src/repeatable_quests/start_of_utc_day.ts
+function startOfUtcDay(timestamp) {
+  const date = new Date(timestamp);
+  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+}
+
+// src/repeatable_quests/start_of_utc_week.ts
+var DAY_MS = 864e5;
+function startOfUtcWeek(dayStart) {
+  const date = new Date(dayStart);
+  return dayStart - date.getUTCDay() * DAY_MS;
+}
+
+// src/repeatable_quests/generate_anchors_until.ts
+var DAY_MS2 = 864e5;
+var WEEK_MS2 = 7 * DAY_MS2;
+function generateAnchorsUntil(repeatable, now) {
+  const rule = parseRRule(repeatable.rrule);
+  const anchors = [];
+  const until = rule.until == null ? now : Math.min(now, rule.until);
+  if (repeatable.anchorAt > until) {
+    return anchors;
+  }
+  if (rule.freq === "DAILY") {
+    let occurrence2 = 0;
+    for (let current2 = repeatable.anchorAt; current2 <= until; current2 += rule.interval * DAY_MS2) {
+      occurrence2 += 1;
+      if (rule.count != null && occurrence2 > rule.count) {
+        break;
+      }
+      anchors.push(current2);
+    }
+    return anchors;
+  }
+  if (rule.freq === "WEEKLY" && rule.byDay && rule.byDay.length > 0) {
+    const anchorDayStart = startOfUtcDay(repeatable.anchorAt);
+    const anchorWeekStart = startOfUtcWeek(anchorDayStart);
+    const timeOffset = repeatable.anchorAt - anchorDayStart;
+    let occurrence2 = 0;
+    for (let day = anchorDayStart; day <= until; day += DAY_MS2) {
+      const weeksSince = Math.floor((startOfUtcWeek(day) - anchorWeekStart) / WEEK_MS2);
+      if (weeksSince < 0 || weeksSince % rule.interval !== 0) {
+        continue;
+      }
+      if (!rule.byDay.includes(new Date(day).getUTCDay())) {
+        continue;
+      }
+      const anchor = day + timeOffset;
+      if (anchor < repeatable.anchorAt || anchor > until) {
+        continue;
+      }
+      occurrence2 += 1;
+      if (rule.count != null && occurrence2 > rule.count) {
+        break;
+      }
+      anchors.push(anchor);
+    }
+    return anchors;
+  }
+  let occurrence = 0;
+  let current = repeatable.anchorAt;
+  while (current <= until) {
+    occurrence += 1;
+    if (rule.count != null && occurrence > rule.count) {
+      break;
+    }
+    anchors.push(current);
+    current = advanceAnchor(current, rule.freq, rule.interval);
+  }
+  return anchors;
+}
+
+// src/repeatable_quests/list_due_repeatable_quest_anchors.ts
+function listDueRepeatableQuestAnchors(db, now) {
+  const repeatables = db.prepare(
+    `SELECT *
+       FROM repeatable_quests
+       WHERE deleted_at IS NULL
+         AND archived_at IS NULL`
+  ).all().map(mapRepeatableQuestRow);
+  const anchors = [];
+  if (repeatables.length === 0) {
+    return anchors;
+  }
+  const repeatableIds = repeatables.map((repeatable) => repeatable.id);
+  const maxAnchorAt = Math.max(
+    ...repeatables.map((repeatable) => Math.max(repeatable.anchorAt, now))
+  );
+  const existingRows = db.prepare(
+    `SELECT spawned_from_repeatable_id, spawned_for_at
+       FROM quests
+       WHERE spawned_from_repeatable_id IN (${repeatableIds.map(() => "?").join(", ")})
+         AND spawned_for_at IS NOT NULL
+         AND spawned_for_at <= ?`
+  ).all(...repeatableIds, maxAnchorAt);
+  const existingAnchors = new Set(
+    existingRows.map(
+      (row) => `${Number(row.spawned_from_repeatable_id)}:${Number(row.spawned_for_at)}`
+    )
+  );
+  for (const repeatable of repeatables) {
+    const dueAnchors = generateAnchorsUntil(repeatable, now);
+    for (const anchorAt of dueAnchors) {
+      if (!existingAnchors.has(`${repeatable.id}:${anchorAt}`)) {
+        anchors.push({
+          repeatableQuestId: repeatable.id,
+          anchorAt,
+          markerId: "attention.available.repeatable"
+        });
+      }
+    }
+  }
+  return anchors.sort(
+    (a, b) => a.anchorAt - b.anchorAt || a.repeatableQuestId - b.repeatableQuestId
+  );
+}
+
+// src/repeatable_quests/spawn_due_repeatable_quests.ts
+function spawnDueRepeatableQuests(db, now) {
+  return withTransaction(db, () => {
+    const anchors = listDueRepeatableQuestAnchors(db, now);
+    const quests = [];
+    for (const anchor of anchors) {
+      const repeatable = getRepeatableQuestOrThrow(db, anchor.repeatableQuestId);
+      const created = db.prepare(
+        `INSERT INTO quests (
+             questline_id,
+             source_rumor_id,
+             spawned_by_quest_id,
+             spawned_from_repeatable_id,
+             spawned_for_at,
+             title,
+             objective,
+             created_at,
+             updated_at,
+             effort_seconds,
+             estimate_seconds,
+             not_before_at,
+             due_at,
+             scheduled_start_at,
+             scheduled_end_at,
+             all_day
+           ) VALUES (?, NULL, NULL, ?, ?, ?, ?, ?, ?, 0, ?, ?, ?, ?, ?, ?)`
+      ).run(
+        repeatable.questlineId ?? null,
+        repeatable.id,
+        anchor.anchorAt,
+        repeatable.title,
+        repeatable.objective,
+        now,
+        now,
+        repeatable.estimateSeconds ?? null,
+        repeatable.notBeforeOffsetSeconds == null ? null : anchor.anchorAt + repeatable.notBeforeOffsetSeconds * 1e3,
+        repeatable.dueOffsetSeconds == null ? null : anchor.anchorAt + repeatable.dueOffsetSeconds * 1e3,
+        repeatable.scheduledStartOffsetSeconds == null ? null : anchor.anchorAt + repeatable.scheduledStartOffsetSeconds * 1e3,
+        repeatable.scheduledEndOffsetSeconds == null ? null : anchor.anchorAt + repeatable.scheduledEndOffsetSeconds * 1e3,
+        repeatable.allDay ? 1 : 0
+      );
+      const questId = Number(created.lastInsertRowid);
+      copyRepeatableQuestTagsToQuest(db, repeatable.id, questId, now);
+      copyRepeatableQuestRewardsToQuest(db, repeatable.id, questId, now);
+      quests.push(getQuestOrThrow(db, questId));
+    }
+    return quests;
+  });
+}
+
+// src/markers/derive_quest_marker_id.ts
+function deriveQuestMarkerId({
+  state,
+  available,
+  hasUnclaimedReward,
+  notBeforeAt,
+  blockerCount,
+  now
+}) {
+  if (state === "done") {
+    return hasUnclaimedReward ? "progress.complete" : null;
+  }
+  if (state === "abandoned") {
+    return null;
+  }
+  if (state === "in_progress") {
+    return "progress.incomplete";
+  }
+  if (available) {
+    return "attention.available";
+  }
+  if (notBeforeAt != null && notBeforeAt > now) {
+    return "attention.available.future";
+  }
+  if (blockerCount > 0) {
+    return "progress.incomplete";
+  }
+  return null;
+}
+
+// src/rewards/map_quest_reward_row.ts
+function mapQuestRewardRow(row) {
+  return {
+    id: Number(row.id),
+    questId: Number(row.quest_id),
+    kind: String(row.kind),
+    name: String(row.name),
+    description: row.description == null ? null : String(row.description),
+    quantity: row.quantity == null ? null : Number(row.quantity),
+    createdAt: Number(row.created_at),
+    claimedAt: row.claimed_at == null ? null : Number(row.claimed_at),
+    deletedAt: row.deleted_at == null ? null : Number(row.deleted_at)
+  };
+}
+
+// src/quests/derive_quest_state.ts
+function deriveQuestState(quest) {
+  if (quest.resolvedAt != null && quest.success === true) {
+    return "done";
+  }
+  if (quest.resolvedAt != null && quest.success === false) {
+    return "abandoned";
+  }
+  if (quest.startedAt != null) {
+    return "in_progress";
+  }
+  return "open";
+}
+
+// src/quests/query_quest_detail_records.ts
+function queryQuestDetailRecords(db, filters = {}, now = Date.now(), questIds) {
+  if (questIds && questIds.length === 0) {
+    return [];
+  }
+  const clauses = [];
+  const params = [];
+  if (!filters.includeDeleted) {
+    clauses.push("q.deleted_at IS NULL");
+  }
+  if (questIds && questIds.length > 0) {
+    clauses.push(`q.id IN (${questIds.map(() => "?").join(", ")})`);
+    params.push(...questIds);
+  }
+  if (filters.questlineId != null) {
+    clauses.push("q.questline_id = ?");
+    params.push(filters.questlineId);
+  }
+  if (filters.tagNames && filters.tagNames.length > 0) {
+    const normalized = [...new Set(filters.tagNames.map(normalizeTagName).filter(Boolean))];
+    for (const tag of normalized) {
+      clauses.push(
+        `EXISTS (
+           SELECT 1
+           FROM quest_tags qt
+           JOIN tags t ON t.id = qt.tag_id
+           WHERE qt.quest_id = q.id
+             AND qt.deleted_at IS NULL
+             AND t.deleted_at IS NULL
+             AND t.normalized_name = ?
+         )`
+      );
+      params.push(tag);
+    }
+  }
+  const where = clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
+  const rows = db.prepare(
+    `SELECT q.*,
+              COALESCE(q.due_at, ql.due_at) AS effective_due_at,
+              (
+                SELECT COUNT(*)
+                FROM quest_unlocks qu
+                JOIN quests blocker ON blocker.id = qu.from_quest_id
+                WHERE qu.to_quest_id = q.id
+                  AND qu.deleted_at IS NULL
+                  AND blocker.deleted_at IS NULL
+                  AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
+              ) AS blocker_count
+       FROM quests q
+       LEFT JOIN questlines ql ON ql.id = q.questline_id AND ql.deleted_at IS NULL
+       ${where}
+       ORDER BY q.created_at DESC, q.id DESC`
+  ).all(...params);
+  if (rows.length === 0) {
+    return [];
+  }
+  const ids = rows.map((row) => Number(row.id));
+  const placeholders = ids.map(() => "?").join(", ");
+  const tagNamesByQuestId = /* @__PURE__ */ new Map();
+  const rewardsByQuestId = /* @__PURE__ */ new Map();
+  const unlocksByQuestId = /* @__PURE__ */ new Map();
+  const unlockedByQuestId = /* @__PURE__ */ new Map();
+  for (const row of db.prepare(
+    `SELECT qt.quest_id, t.name
+       FROM quest_tags qt
+       JOIN tags t ON t.id = qt.tag_id
+       WHERE qt.quest_id IN (${placeholders})
+         AND qt.deleted_at IS NULL
+         AND t.deleted_at IS NULL
+       ORDER BY qt.quest_id, t.name`
+  ).all(...ids)) {
+    const questId = Number(row.quest_id);
+    const tagNames = tagNamesByQuestId.get(questId) ?? [];
+    tagNames.push(String(row.name));
+    tagNamesByQuestId.set(questId, tagNames);
+  }
+  for (const row of db.prepare(
+    `SELECT *
+       FROM quest_rewards
+       WHERE quest_id IN (${placeholders})
+         AND deleted_at IS NULL
+       ORDER BY quest_id, created_at, id`
+  ).all(...ids)) {
+    const reward = mapQuestRewardRow(row);
+    const rewards = rewardsByQuestId.get(reward.questId) ?? [];
+    rewards.push(reward);
+    rewardsByQuestId.set(reward.questId, rewards);
+  }
+  for (const row of db.prepare(
+    `SELECT from_quest_id, to_quest_id
+       FROM quest_unlocks
+       WHERE from_quest_id IN (${placeholders})
+         AND deleted_at IS NULL
+       ORDER BY from_quest_id, to_quest_id`
+  ).all(...ids)) {
+    const questId = Number(row.from_quest_id);
+    const unlocks = unlocksByQuestId.get(questId) ?? [];
+    unlocks.push(Number(row.to_quest_id));
+    unlocksByQuestId.set(questId, unlocks);
+  }
+  for (const row of db.prepare(
+    `SELECT from_quest_id, to_quest_id
+       FROM quest_unlocks
+       WHERE to_quest_id IN (${placeholders})
+         AND deleted_at IS NULL
+       ORDER BY to_quest_id, from_quest_id`
+  ).all(...ids)) {
+    const questId = Number(row.to_quest_id);
+    const unlockedBy = unlockedByQuestId.get(questId) ?? [];
+    unlockedBy.push(Number(row.from_quest_id));
+    unlockedByQuestId.set(questId, unlockedBy);
+  }
+  return rows.map((row) => {
+    const quest = mapQuestRow(row);
+    const blockerCount = Number(row.blocker_count ?? 0);
+    const effectiveDueAt = row.effective_due_at == null ? null : Number(row.effective_due_at);
+    const rewards = rewardsByQuestId.get(quest.id) ?? [];
+    const state = deriveQuestState(quest);
+    const available = quest.deletedAt == null && quest.resolvedAt == null && (quest.notBeforeAt == null || quest.notBeforeAt <= now) && blockerCount === 0;
+    const markerId = deriveQuestMarkerId({
+      state,
+      available,
+      hasUnclaimedReward: rewards.some((reward) => reward.claimedAt == null),
+      notBeforeAt: quest.notBeforeAt,
+      blockerCount,
+      now
+    });
+    return {
+      detail: {
+        ...quest,
+        state,
+        markerId,
+        effectiveDueAt,
+        available,
+        tagNames: tagNamesByQuestId.get(quest.id) ?? [],
+        rewards,
+        unlocksQuestIds: unlocksByQuestId.get(quest.id) ?? [],
+        unlockedByQuestIds: unlockedByQuestId.get(quest.id) ?? []
+      },
+      blockerCount
+    };
+  });
+}
+
+// src/hooks/detect_hook_events.ts
+function detectHookEvents(db, now) {
+  const events = [];
+  const add = (type, at, ids) => {
+    events.push({
+      id: `e_${type}_${ids.questId ?? ids.rumorId}_${ids.repeatableId ?? ""}_${at}`,
+      type,
+      ...ids,
+      occurredAt: new Date(at).toISOString()
+    });
+  };
+  for (const { detail: q } of queryQuestDetailRecords(db, {}, now)) {
+    if (q.resolvedAt == null && q.effectiveDueAt != null && q.effectiveDueAt <= now) {
+      add("quest.due", q.effectiveDueAt, { questId: q.id });
+      if (q.effectiveDueAt < now) add("quest.overdue", q.effectiveDueAt, { questId: q.id });
+    }
+    if (q.available) {
+      const prerequisites = db.prepare(
+        `SELECT p.id, p.resolved_at, u.created_at FROM quest_unlocks u JOIN quests p ON p.id = u.from_quest_id WHERE u.to_quest_id = ? AND u.deleted_at IS NULL AND p.deleted_at IS NULL AND p.success = 1 AND p.resolved_at IS NOT NULL`
+      ).all(q.id);
+      if (prerequisites.some((p) => Number(p.resolved_at) >= Number(p.created_at))) {
+        const at = Math.max(q.notBeforeAt ?? 0, ...prerequisites.map((p) => Number(p.resolved_at)));
+        if (at <= now) add("quest.unblocked", at, { questId: q.id });
+      }
+    }
+    if (q.spawnedFromRepeatableId != null && q.createdAt <= now)
+      add("repeatable.spawned", q.createdAt, {
+        questId: q.id,
+        repeatableId: q.spawnedFromRepeatableId
+      });
+  }
+  for (const row of db.prepare("SELECT id, created_at FROM rumors WHERE deleted_at IS NULL AND created_at <= ?").all(now))
+    add("rumor.captured", Number(row.created_at), { rumorId: Number(row.id) });
+  return events.sort(
+    (a, b) => a.occurredAt.localeCompare(b.occurredAt) || a.id.localeCompare(b.id)
+  );
+}
+
+// src/hooks/tick_questlog.ts
+async function tickQuestlog(db, options = {}) {
+  const now = options.now ?? options.clock?.() ?? Date.now();
+  const result = {
+    events: [],
+    batches: [],
+    sent: 0,
+    queued: 0,
+    retrying: 0,
+    failed: 0
+  };
+  const claims = [];
+  const collect = () => {
+    spawnDueRepeatableQuests(db, now);
+    const detected = detectHookEvents(db, now);
+    result.events = detected.filter(
+      (e) => !db.prepare("SELECT id FROM hook_events WHERE id = ?").get(e.id)
+    );
+    for (const event of result.events)
+      db.prepare("INSERT INTO hook_events(id, occurred_at, event) VALUES (?, ?, ?)").run(
+        event.id,
+        Date.parse(event.occurredAt),
+        JSON.stringify(event)
+      );
+    for (const target of listHooks(db)) {
+      const events = db.prepare(
+        "SELECT e.event FROM hook_events e WHERE occurred_at >= ? AND NOT EXISTS (SELECT 1 FROM hook_assignments a WHERE a.target_id = ? AND a.event_id = e.id) ORDER BY occurred_at, id"
+      ).all(target.createdAt, target.id).map((row2) => JSON.parse(String(row2.event))).filter((event) => {
+        if (!target.events.includes(event.type)) return false;
+        if (target.tag == null) return true;
+        return event.questId !== void 0 && db.prepare(
+          "SELECT 1 FROM quest_tags qt JOIN tags t ON t.id = qt.tag_id WHERE qt.quest_id = ? AND qt.deleted_at IS NULL AND t.deleted_at IS NULL AND t.normalized_name = ?"
+        ).get(event.questId, normalizeTagName(target.tag)) !== void 0;
+      });
+      for (const event of events)
+        db.prepare("INSERT INTO hook_assignments(target_id, event_id) VALUES (?, ?)").run(
+          target.id,
+          event.id
+        );
+      const row = db.prepare("SELECT url, secret, lease_until FROM hook_targets WHERE id = ?").get(target.id);
+      if (!row || row.lease_until != null && Number(row.lease_until) > now) continue;
+      let pending = listDeliveries(db).find(
+        (d) => d.targetId === target.id && d.status === "pending"
+      );
+      const queued = db.prepare(
+        "SELECT e.event FROM hook_assignments a JOIN hook_events e ON e.id = a.event_id WHERE a.target_id = ? AND a.delivery_id IS NULL ORDER BY e.occurred_at, e.id"
+      ).all(target.id).map((r) => JSON.parse(String(r.event)));
+      if (!pending && queued.length) {
+        const id = `d_${randomBytes(16).toString("hex")}`;
+        db.prepare(
+          "INSERT INTO hook_deliveries(id, target_id, events, status, next_attempt_at) VALUES (?, ?, ?, 'pending', ?)"
+        ).run(
+          id,
+          target.id,
+          JSON.stringify(queued),
+          Math.max(now, (target.lastWake ?? -Infinity) + target.minGap * 1e3)
+        );
+        db.prepare(
+          "UPDATE hook_assignments SET delivery_id = ? WHERE target_id = ? AND delivery_id IS NULL"
+        ).run(id, target.id);
+        pending = listDeliveries(db).find((d) => d.id === id);
+      }
+      if (!pending) continue;
+      if (pending.attempts === 0 && queued.length && !queued.every((e) => pending?.events.some((p) => p.id === e.id))) {
+        pending.events.push(...queued);
+        db.prepare("UPDATE hook_deliveries SET events = ? WHERE id = ?").run(
+          JSON.stringify(pending.events),
+          pending.id
+        );
+        db.prepare(
+          "UPDATE hook_assignments SET delivery_id = ? WHERE target_id = ? AND delivery_id IS NULL"
+        ).run(pending.id, target.id);
+      }
+      if (pending.nextAttemptAt > now || target.lastWake != null && target.lastWake + target.minGap * 1e3 > now)
+        continue;
+      if (pending.attempts >= 8) {
+        db.prepare("UPDATE hook_deliveries SET status = 'failed' WHERE id = ?").run(pending.id);
+        continue;
+      }
+      const claim = randomBytes(16).toString("hex");
+      db.prepare(
+        "UPDATE hook_targets SET claim = ?, lease_until = ?, last_wake = ? WHERE id = ?"
+      ).run(claim, now + 12e4, now, target.id);
+      db.prepare(
+        "UPDATE hook_deliveries SET attempts = attempts + 1, last_attempt_at = ? WHERE id = ?"
+      ).run(now, pending.id);
+      pending.attempts++;
+      pending.lastAttemptAt = now;
+      result.batches.push({ targetId: target.id, events: pending.events });
+      claims.push({
+        delivery: pending,
+        target: { id: target.id, url: String(row.url), secret: String(row.secret), claim }
+      });
+    }
+  };
+  if (options.dryRun) {
+    const rollback = new Error("preview rollback");
+    try {
+      withTransaction(db, () => {
+        collect();
+        throw rollback;
+      });
+    } catch (error) {
+      if (error !== rollback) throw error;
+    }
+  } else withTransaction(db, collect);
+  if (!options.dryRun) {
+    const sent = await Promise.all(
+      claims.map((claim) => sendHookDelivery(db, claim.delivery, claim.target, options))
+    );
+    result.sent = sent.filter(Boolean).length;
+  }
+  const deliveries = listDeliveries(db);
+  result.queued = deliveries.filter((d) => d.status === "pending" && d.attempts === 0).length + Number(
+    db.prepare(
+      "SELECT COUNT(DISTINCT target_id) AS n FROM hook_assignments WHERE delivery_id IS NULL"
+    ).get()?.n ?? 0
+  );
+  result.retrying = deliveries.filter((d) => d.status === "pending" && d.attempts > 0).length;
+  result.failed = deliveries.filter((d) => d.status === "failed").length;
+  return result;
+}
+
+// src/hooks/watch_questlog.ts
+async function watchQuestlog(db, options) {
+  const interval = options.interval ?? 60;
+  if (!Number.isFinite(interval) || interval < 5)
+    throw new Error("Interval must be at least 5 seconds");
+  while (!options.signal.aborted) {
+    options.onTick?.(await tickQuestlog(db, options));
+    if (options.signal.aborted) break;
+    await new Promise((resolve) => {
+      const finish = () => {
+        clearTimeout(timer);
+        options.signal.removeEventListener("abort", finish);
+        resolve();
+      };
+      const timer = setTimeout(finish, interval * 1e3);
+      options.signal.addEventListener("abort", finish, { once: true });
+    });
+  }
+}
+
+// src/hooks/init_hook_tables.ts
+function initHookTables(db) {
+  db.exec(`
+ CREATE TABLE IF NOT EXISTS hook_targets (
+ id INTEGER PRIMARY KEY AUTOINCREMENT, url TEXT NOT NULL, secret TEXT NOT NULL,
+ tag TEXT, events TEXT NOT NULL, min_gap INTEGER NOT NULL, created_at INTEGER NOT NULL,
+ last_wake INTEGER, lease_until INTEGER, claim TEXT);
+ CREATE TABLE IF NOT EXISTS hook_events (
+ id TEXT PRIMARY KEY, occurred_at INTEGER NOT NULL, event TEXT NOT NULL);
+ CREATE TABLE IF NOT EXISTS hook_assignments (
+ target_id INTEGER NOT NULL REFERENCES hook_targets(id) ON DELETE CASCADE,
+ event_id TEXT NOT NULL REFERENCES hook_events(id), delivery_id TEXT,
+ PRIMARY KEY(target_id, event_id));
+ CREATE TABLE IF NOT EXISTS hook_deliveries (
+ id TEXT PRIMARY KEY, target_id INTEGER NOT NULL REFERENCES hook_targets(id) ON DELETE CASCADE,
+ events TEXT NOT NULL, status TEXT NOT NULL, attempts INTEGER NOT NULL DEFAULT 0,
+ last_attempt_at INTEGER, http_status INTEGER, error_class TEXT,
+ next_attempt_at INTEGER NOT NULL);
+ CREATE INDEX IF NOT EXISTS idx_hook_deliveries_target ON hook_deliveries(target_id, status, next_attempt_at);
+ CREATE TABLE IF NOT EXISTS hook_settings (id INTEGER PRIMARY KEY CHECK(id = 1), label TEXT NOT NULL);
+ `);
+}
+
 // src/questlines/init_questline_tables.ts
 function initQuestlineTables(db) {
   db.exec(`
@@ -352,6 +1369,7 @@ function initQuestlogTables(db) {
   initTagTables(db);
   initQuestSearch(db);
   initRumorSearch(db);
+  initHookTables(db);
 }
 
 // src/markers/index.ts
@@ -362,36 +1380,6 @@ __export(markers_exports, {
   markerLookup: () => markerLookup
 });
 
-// src/markers/derive_quest_marker_id.ts
-function deriveQuestMarkerId({
-  state,
-  available,
-  hasUnclaimedReward,
-  notBeforeAt,
-  blockerCount,
-  now
-}) {
-  if (state === "done") {
-    return hasUnclaimedReward ? "progress.complete" : null;
-  }
-  if (state === "abandoned") {
-    return null;
-  }
-  if (state === "in_progress") {
-    return "progress.incomplete";
-  }
-  if (available) {
-    return "attention.available";
-  }
-  if (notBeforeAt != null && notBeforeAt > now) {
-    return "attention.available.future";
-  }
-  if (blockerCount > 0) {
-    return "progress.incomplete";
-  }
-  return null;
-}
-
 // src/markers/derive_rumor_marker_id.ts
 function deriveRumorMarkerId({ state }) {
   if (state === "open") {
@@ -479,11 +1467,6 @@ __export(read_exports, {
   searchQuestlog: () => searchQuestlog
 });
 
-// src/resolve_now.ts
-function resolveNow(now) {
-  return now ?? Date.now();
-}
-
 // src/assert_non_empty.ts
 function assertNonEmpty(value, label) {
   const trimmed = value.trim();
@@ -493,41 +1476,6 @@ function assertNonEmpty(value, label) {
   return trimmed;
 }
 
-// src/with_transaction.ts
-var transactionDepth = /* @__PURE__ */ new WeakMap();
-function withTransaction(db, fn) {
-  const depth = transactionDepth.get(db) ?? 0;
-  const savepoint = `questlog_${depth}`;
-  if (depth === 0) {
-    db.exec("BEGIN IMMEDIATE");
-  } else {
-    db.exec(`SAVEPOINT ${savepoint}`);
-  }
-  transactionDepth.set(db, depth + 1);
-  try {
-    const result = fn();
-    if (depth === 0) {
-      db.exec("COMMIT");
-    } else {
-      db.exec(`RELEASE SAVEPOINT ${savepoint}`);
-    }
-    transactionDepth.set(db, depth);
-    return result;
-  } catch (error) {
-    try {
-      if (depth === 0) {
-        db.exec("ROLLBACK");
-      } else {
-        db.exec(`ROLLBACK TO SAVEPOINT ${savepoint}`);
-        db.exec(`RELEASE SAVEPOINT ${savepoint}`);
-      }
-    } catch {
-    }
-    transactionDepth.set(db, depth);
-    throw error;
-  }
-}
-
 // src/questlines/map_questline_row.ts
 function mapQuestlineRow(row) {
   return {
@@ -756,46 +1704,6 @@ function softDeleteQuestline(db, questlineId, deletedAt) {
   ).run(now, now, questlineId);
 }
 
-// src/quests/map_quest_row.ts
-function asBoolean(value) {
-  return Number(value) === 1;
-}
-function mapQuestRow(row) {
-  return {
-    id: Number(row.id),
-    questlineId: row.questline_id == null ? null : Number(row.questline_id),
-    sourceRumorId: row.source_rumor_id == null ? null : Number(row.source_rumor_id),
-    spawnedByQuestId: row.spawned_by_quest_id == null ? null : Number(row.spawned_by_quest_id),
-    spawnedFromRepeatableId: row.spawned_from_repeatable_id == null ? null : Number(row.spawned_from_repeatable_id),
-    spawnedForAt: row.spawned_for_at == null ? null : Number(row.spawned_for_at),
-    title: String(row.title),
-    objective: String(row.objective),
-    outcome: row.outcome == null ? null : String(row.outcome),
-    createdAt: Number(row.created_at),
-    updatedAt: Number(row.updated_at),
-    startedAt: row.started_at == null ? null : Number(row.started_at),
-    resolvedAt: row.resolved_at == null ? null : Number(row.resolved_at),
-    success: row.success == null ? null : asBoolean(row.success),
-    effortSeconds: Number(row.effort_seconds),
-    estimateSeconds: row.estimate_seconds == null ? null : Number(row.estimate_seconds),
-    notBeforeAt: row.not_before_at == null ? null : Number(row.not_before_at),
-    dueAt: row.due_at == null ? null : Number(row.due_at),
-    scheduledStartAt: row.scheduled_start_at == null ? null : Number(row.scheduled_start_at),
-    scheduledEndAt: row.scheduled_end_at == null ? null : Number(row.scheduled_end_at),
-    allDay: asBoolean(row.all_day),
-    deletedAt: row.deleted_at == null ? null : Number(row.deleted_at)
-  };
-}
-
-// src/quests/get_quest_or_throw.ts
-function getQuestOrThrow(db, questId) {
-  const row = db.prepare("SELECT * FROM quests WHERE id = ? AND deleted_at IS NULL").get(questId);
-  if (!row) {
-    throw new Error(`Quest ${questId} was not found.`);
-  }
-  return mapQuestRow(row);
-}
-
 // src/quests/resolve_quest.ts
 function resolveQuest(db, questId, success, outcome, resolvedAt) {
   const current = getQuestOrThrow(db, questId);
@@ -897,11 +1805,6 @@ function replaceActiveQuestRewards(db, questId, rewards, now) {
   }
 }
 
-// src/tags/normalize_tag_name.ts
-function normalizeTagName(name) {
-  return name.trim().toLowerCase().replace(/\s+/g, " ");
-}
-
 // src/tags/replace_active_quest_tags.ts
 function getOrCreateTagId(db, name, now) {
   const normalizedName = normalizeTagName(name);
@@ -998,215 +1901,42 @@ function createQuest(db, input) {
     if (input.tags && input.tags.length > 0) {
       replaceActiveQuestTags(db, questId, input.tags, now);
     }
-    if (input.rewards && input.rewards.length > 0) {
-      replaceActiveQuestRewards(db, questId, input.rewards, now);
-    }
-    return getQuestOrThrow(db, questId);
-  });
-}
-
-// src/quests/abandon_quest_and_spawn_followups.ts
-function abandonQuestAndSpawnFollowups(db, questId, outcome, followups, resolvedAt) {
-  return withTransaction(db, () => {
-    const abandonedQuest = abandonQuest(db, questId, outcome, resolvedAt);
-    const now = resolveNow(resolvedAt);
-    const followupQuests = followups.map(
-      (followup) => createQuest(db, {
-        ...followup,
-        questlineId: followup.questlineId ?? abandonedQuest.questlineId,
-        spawnedByQuestId: questId,
-        now
-      })
-    );
-    for (let i = 0; i < followups.length; i += 1) {
-      const followup = followups[i];
-      const created = followupQuests[i];
-      if (followup?.unlocksParent && created) {
-        addUnlock(db, created.id, questId, resolvedAt);
-      }
-    }
-    return { abandonedQuest, followupQuests };
-  });
-}
-
-// src/quests/finish_quest.ts
-function finishQuest(db, questId, outcome, resolvedAt) {
-  return resolveQuest(db, questId, true, outcome, resolvedAt);
-}
-
-// src/rewards/map_quest_reward_row.ts
-function mapQuestRewardRow(row) {
-  return {
-    id: Number(row.id),
-    questId: Number(row.quest_id),
-    kind: String(row.kind),
-    name: String(row.name),
-    description: row.description == null ? null : String(row.description),
-    quantity: row.quantity == null ? null : Number(row.quantity),
-    createdAt: Number(row.created_at),
-    claimedAt: row.claimed_at == null ? null : Number(row.claimed_at),
-    deletedAt: row.deleted_at == null ? null : Number(row.deleted_at)
-  };
-}
-
-// src/quests/derive_quest_state.ts
-function deriveQuestState(quest) {
-  if (quest.resolvedAt != null && quest.success === true) {
-    return "done";
-  }
-  if (quest.resolvedAt != null && quest.success === false) {
-    return "abandoned";
-  }
-  if (quest.startedAt != null) {
-    return "in_progress";
-  }
-  return "open";
+    if (input.rewards && input.rewards.length > 0) {
+      replaceActiveQuestRewards(db, questId, input.rewards, now);
+    }
+    return getQuestOrThrow(db, questId);
+  });
 }
 
-// src/quests/query_quest_detail_records.ts
-function queryQuestDetailRecords(db, filters = {}, now = Date.now(), questIds) {
-  if (questIds && questIds.length === 0) {
-    return [];
-  }
-  const clauses = [];
-  const params = [];
-  if (!filters.includeDeleted) {
-    clauses.push("q.deleted_at IS NULL");
-  }
-  if (questIds && questIds.length > 0) {
-    clauses.push(`q.id IN (${questIds.map(() => "?").join(", ")})`);
-    params.push(...questIds);
-  }
-  if (filters.questlineId != null) {
-    clauses.push("q.questline_id = ?");
-    params.push(filters.questlineId);
-  }
-  if (filters.tagNames && filters.tagNames.length > 0) {
-    const normalized = [...new Set(filters.tagNames.map(normalizeTagName).filter(Boolean))];
-    for (const tag of normalized) {
-      clauses.push(
-        `EXISTS (
-           SELECT 1
-           FROM quest_tags qt
-           JOIN tags t ON t.id = qt.tag_id
-           WHERE qt.quest_id = q.id
-             AND qt.deleted_at IS NULL
-             AND t.deleted_at IS NULL
-             AND t.normalized_name = ?
-         )`
-      );
-      params.push(tag);
+// src/quests/abandon_quest_and_spawn_followups.ts
+function abandonQuestAndSpawnFollowups(db, questId, outcome, followups, resolvedAt) {
+  return withTransaction(db, () => {
+    const abandonedQuest = abandonQuest(db, questId, outcome, resolvedAt);
+    const now = resolveNow(resolvedAt);
+    const followupQuests = followups.map(
+      (followup) => createQuest(db, {
+        ...followup,
+        questlineId: followup.questlineId ?? abandonedQuest.questlineId,
+        spawnedByQuestId: questId,
+        now
+      })
+    );
+    for (let i = 0; i < followups.length; i += 1) {
+      const followup = followups[i];
+      const created = followupQuests[i];
+      if (followup?.unlocksParent && created) {
+        addUnlock(db, created.id, questId, resolvedAt);
+      }
     }
-  }
-  const where = clauses.length > 0 ? `WHERE ${clauses.join(" AND ")}` : "";
-  const rows = db.prepare(
-    `SELECT q.*,
-              COALESCE(q.due_at, ql.due_at) AS effective_due_at,
-              (
-                SELECT COUNT(*)
-                FROM quest_unlocks qu
-                JOIN quests blocker ON blocker.id = qu.from_quest_id
-                WHERE qu.to_quest_id = q.id
-                  AND qu.deleted_at IS NULL
-                  AND blocker.deleted_at IS NULL
-                  AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
-              ) AS blocker_count
-       FROM quests q
-       LEFT JOIN questlines ql ON ql.id = q.questline_id AND ql.deleted_at IS NULL
-       ${where}
-       ORDER BY q.created_at DESC, q.id DESC`
-  ).all(...params);
-  if (rows.length === 0) {
-    return [];
-  }
-  const ids = rows.map((row) => Number(row.id));
-  const placeholders = ids.map(() => "?").join(", ");
-  const tagNamesByQuestId = /* @__PURE__ */ new Map();
-  const rewardsByQuestId = /* @__PURE__ */ new Map();
-  const unlocksByQuestId = /* @__PURE__ */ new Map();
-  const unlockedByQuestId = /* @__PURE__ */ new Map();
-  for (const row of db.prepare(
-    `SELECT qt.quest_id, t.name
-       FROM quest_tags qt
-       JOIN tags t ON t.id = qt.tag_id
-       WHERE qt.quest_id IN (${placeholders})
-         AND qt.deleted_at IS NULL
-         AND t.deleted_at IS NULL
-       ORDER BY qt.quest_id, t.name`
-  ).all(...ids)) {
-    const questId = Number(row.quest_id);
-    const tagNames = tagNamesByQuestId.get(questId) ?? [];
-    tagNames.push(String(row.name));
-    tagNamesByQuestId.set(questId, tagNames);
-  }
-  for (const row of db.prepare(
-    `SELECT *
-       FROM quest_rewards
-       WHERE quest_id IN (${placeholders})
-         AND deleted_at IS NULL
-       ORDER BY quest_id, created_at, id`
-  ).all(...ids)) {
-    const reward = mapQuestRewardRow(row);
-    const rewards = rewardsByQuestId.get(reward.questId) ?? [];
-    rewards.push(reward);
-    rewardsByQuestId.set(reward.questId, rewards);
-  }
-  for (const row of db.prepare(
-    `SELECT from_quest_id, to_quest_id
-       FROM quest_unlocks
-       WHERE from_quest_id IN (${placeholders})
-         AND deleted_at IS NULL
-       ORDER BY from_quest_id, to_quest_id`
-  ).all(...ids)) {
-    const questId = Number(row.from_quest_id);
-    const unlocks = unlocksByQuestId.get(questId) ?? [];
-    unlocks.push(Number(row.to_quest_id));
-    unlocksByQuestId.set(questId, unlocks);
-  }
-  for (const row of db.prepare(
-    `SELECT from_quest_id, to_quest_id
-       FROM quest_unlocks
-       WHERE to_quest_id IN (${placeholders})
-         AND deleted_at IS NULL
-       ORDER BY to_quest_id, from_quest_id`
-  ).all(...ids)) {
-    const questId = Number(row.to_quest_id);
-    const unlockedBy = unlockedByQuestId.get(questId) ?? [];
-    unlockedBy.push(Number(row.from_quest_id));
-    unlockedByQuestId.set(questId, unlockedBy);
-  }
-  return rows.map((row) => {
-    const quest = mapQuestRow(row);
-    const blockerCount = Number(row.blocker_count ?? 0);
-    const effectiveDueAt = row.effective_due_at == null ? null : Number(row.effective_due_at);
-    const rewards = rewardsByQuestId.get(quest.id) ?? [];
-    const state = deriveQuestState(quest);
-    const available = quest.deletedAt == null && quest.resolvedAt == null && (quest.notBeforeAt == null || quest.notBeforeAt <= now) && blockerCount === 0;
-    const markerId = deriveQuestMarkerId({
-      state,
-      available,
-      hasUnclaimedReward: rewards.some((reward) => reward.claimedAt == null),
-      notBeforeAt: quest.notBeforeAt,
-      blockerCount,
-      now
-    });
-    return {
-      detail: {
-        ...quest,
-        state,
-        markerId,
-        effectiveDueAt,
-        available,
-        tagNames: tagNamesByQuestId.get(quest.id) ?? [],
-        rewards,
-        unlocksQuestIds: unlocksByQuestId.get(quest.id) ?? [],
-        unlockedByQuestIds: unlockedByQuestId.get(quest.id) ?? []
-      },
-      blockerCount
-    };
+    return { abandonedQuest, followupQuests };
   });
 }
 
+// src/quests/finish_quest.ts
+function finishQuest(db, questId, outcome, resolvedAt) {
+  return resolveQuest(db, questId, true, outcome, resolvedAt);
+}
+
 // src/quests/get_quest_detail.ts
 function getQuestDetail(db, questId, now = Date.now()) {
   const [record] = queryQuestDetailRecords(db, {}, now, [questId]);
@@ -1379,92 +2109,15 @@ function startQuest(db, questId, startedAt) {
     return current;
   }
   if (current.resolvedAt != null) {
-    throw new Error("Resolved quests cannot be started.");
-  }
-  const now = resolveNow(startedAt);
-  db.prepare(
-    `UPDATE quests
-     SET started_at = ?, updated_at = ?
-     WHERE id = ? AND deleted_at IS NULL`
-  ).run(now, now, questId);
-  return getQuestOrThrow(db, questId);
-}
-
-// src/repeatable_quests/map_repeatable_quest_row.ts
-function asBoolean2(value) {
-  return Number(value) === 1;
-}
-function mapRepeatableQuestRow(row) {
-  return {
-    id: Number(row.id),
-    questlineId: row.questline_id == null ? null : Number(row.questline_id),
-    title: String(row.title),
-    objective: String(row.objective),
-    rrule: String(row.rrule),
-    anchorAt: Number(row.anchor_at),
-    notBeforeOffsetSeconds: row.not_before_offset_seconds == null ? null : Number(row.not_before_offset_seconds),
-    dueOffsetSeconds: row.due_offset_seconds == null ? null : Number(row.due_offset_seconds),
-    scheduledStartOffsetSeconds: row.scheduled_start_offset_seconds == null ? null : Number(row.scheduled_start_offset_seconds),
-    scheduledEndOffsetSeconds: row.scheduled_end_offset_seconds == null ? null : Number(row.scheduled_end_offset_seconds),
-    allDay: asBoolean2(row.all_day),
-    estimateSeconds: row.estimate_seconds == null ? null : Number(row.estimate_seconds),
-    createdAt: Number(row.created_at),
-    updatedAt: Number(row.updated_at),
-    archivedAt: row.archived_at == null ? null : Number(row.archived_at),
-    deletedAt: row.deleted_at == null ? null : Number(row.deleted_at)
-  };
-}
-
-// src/repeatable_quests/get_repeatable_quest_or_throw.ts
-function getRepeatableQuestOrThrow(db, repeatableQuestId) {
-  const row = db.prepare("SELECT * FROM repeatable_quests WHERE id = ? AND deleted_at IS NULL").get(repeatableQuestId);
-  if (!row) {
-    throw new Error(`Repeatable quest ${repeatableQuestId} was not found.`);
-  }
-  return mapRepeatableQuestRow(row);
-}
-
-// src/repeatable_quests/parse_rrule.ts
-var WEEKDAY = {
-  SU: 0,
-  MO: 1,
-  TU: 2,
-  WE: 3,
-  TH: 4,
-  FR: 5,
-  SA: 6
-};
-function parseRRule(rrule) {
-  const parts = Object.fromEntries(
-    rrule.split(";").map((part) => part.trim()).filter(Boolean).map((part) => {
-      const [key, value] = part.split("=");
-      return [key, value];
-    })
-  );
-  const freq = parts.FREQ;
-  if (freq !== "DAILY" && freq !== "WEEKLY" && freq !== "MONTHLY" && freq !== "YEARLY") {
-    throw new Error(`Unsupported RRULE FREQ: ${freq ?? "missing"}`);
-  }
-  const interval = parts.INTERVAL == null ? 1 : Number(parts.INTERVAL);
-  if (!Number.isFinite(interval) || interval < 1) {
-    throw new Error("RRULE INTERVAL must be a positive integer.");
-  }
-  const count = parts.COUNT == null ? null : Number(parts.COUNT);
-  if (count != null && (!Number.isFinite(count) || count < 1)) {
-    throw new Error("RRULE COUNT must be a positive integer.");
-  }
-  const until = parts.UNTIL == null ? null : Date.parse(parts.UNTIL);
-  if (parts.UNTIL != null && Number.isNaN(until)) {
-    throw new Error("RRULE UNTIL must be parseable as a date.");
-  }
-  const byDay = parts.BYDAY == null ? null : parts.BYDAY.split(",").map((token) => {
-    const value = WEEKDAY[token];
-    if (value == null) {
-      throw new Error(`Unsupported RRULE BYDAY token: ${token}`);
-    }
-    return value;
-  });
-  return { freq, interval, count, until, byDay };
+    throw new Error("Resolved quests cannot be started.");
+  }
+  const now = resolveNow(startedAt);
+  db.prepare(
+    `UPDATE quests
+     SET started_at = ?, updated_at = ?
+     WHERE id = ? AND deleted_at IS NULL`
+  ).run(now, now, questId);
+  return getQuestOrThrow(db, questId);
 }
 
 // src/repeatable_quests/update_repeatable_quest.ts
@@ -1625,138 +2278,6 @@ function createRepeatableQuest(db, input) {
   });
 }
 
-// src/repeatable_quests/advance_anchor.ts
-var WEEK_MS = 7 * 864e5;
-function advanceAnchor(anchorAt, freq, interval) {
-  const date = new Date(anchorAt);
-  if (freq === "MONTHLY") {
-    date.setUTCMonth(date.getUTCMonth() + interval);
-    return date.getTime();
-  }
-  if (freq === "YEARLY") {
-    date.setUTCFullYear(date.getUTCFullYear() + interval);
-    return date.getTime();
-  }
-  return anchorAt + interval * WEEK_MS;
-}
-
-// src/repeatable_quests/start_of_utc_day.ts
-function startOfUtcDay(timestamp) {
-  const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
-}
-
-// src/repeatable_quests/start_of_utc_week.ts
-var DAY_MS = 864e5;
-function startOfUtcWeek(dayStart) {
-  const date = new Date(dayStart);
-  return dayStart - date.getUTCDay() * DAY_MS;
-}
-
-// src/repeatable_quests/generate_anchors_until.ts
-var DAY_MS2 = 864e5;
-var WEEK_MS2 = 7 * DAY_MS2;
-function generateAnchorsUntil(repeatable, now) {
-  const rule = parseRRule(repeatable.rrule);
-  const anchors = [];
-  const until = rule.until == null ? now : Math.min(now, rule.until);
-  if (repeatable.anchorAt > until) {
-    return anchors;
-  }
-  if (rule.freq === "DAILY") {
-    let occurrence2 = 0;
-    for (let current2 = repeatable.anchorAt; current2 <= until; current2 += rule.interval * DAY_MS2) {
-      occurrence2 += 1;
-      if (rule.count != null && occurrence2 > rule.count) {
-        break;
-      }
-      anchors.push(current2);
-    }
-    return anchors;
-  }
-  if (rule.freq === "WEEKLY" && rule.byDay && rule.byDay.length > 0) {
-    const anchorDayStart = startOfUtcDay(repeatable.anchorAt);
-    const anchorWeekStart = startOfUtcWeek(anchorDayStart);
-    const timeOffset = repeatable.anchorAt - anchorDayStart;
-    let occurrence2 = 0;
-    for (let day = anchorDayStart; day <= until; day += DAY_MS2) {
-      const weeksSince = Math.floor((startOfUtcWeek(day) - anchorWeekStart) / WEEK_MS2);
-      if (weeksSince < 0 || weeksSince % rule.interval !== 0) {
-        continue;
-      }
-      if (!rule.byDay.includes(new Date(day).getUTCDay())) {
-        continue;
-      }
-      const anchor = day + timeOffset;
-      if (anchor < repeatable.anchorAt || anchor > until) {
-        continue;
-      }
-      occurrence2 += 1;
-      if (rule.count != null && occurrence2 > rule.count) {
-        break;
-      }
-      anchors.push(anchor);
-    }
-    return anchors;
-  }
-  let occurrence = 0;
-  let current = repeatable.anchorAt;
-  while (current <= until) {
-    occurrence += 1;
-    if (rule.count != null && occurrence > rule.count) {
-      break;
-    }
-    anchors.push(current);
-    current = advanceAnchor(current, rule.freq, rule.interval);
-  }
-  return anchors;
-}
-
-// src/repeatable_quests/list_due_repeatable_quest_anchors.ts
-function listDueRepeatableQuestAnchors(db, now) {
-  const repeatables = db.prepare(
-    `SELECT *
-       FROM repeatable_quests
-       WHERE deleted_at IS NULL
-         AND archived_at IS NULL`
-  ).all().map(mapRepeatableQuestRow);
-  const anchors = [];
-  if (repeatables.length === 0) {
-    return anchors;
-  }
-  const repeatableIds = repeatables.map((repeatable) => repeatable.id);
-  const maxAnchorAt = Math.max(
-    ...repeatables.map((repeatable) => Math.max(repeatable.anchorAt, now))
-  );
-  const existingRows = db.prepare(
-    `SELECT spawned_from_repeatable_id, spawned_for_at
-       FROM quests
-       WHERE spawned_from_repeatable_id IN (${repeatableIds.map(() => "?").join(", ")})
-         AND spawned_for_at IS NOT NULL
-         AND spawned_for_at <= ?`
-  ).all(...repeatableIds, maxAnchorAt);
-  const existingAnchors = new Set(
-    existingRows.map(
-      (row) => `${Number(row.spawned_from_repeatable_id)}:${Number(row.spawned_for_at)}`
-    )
-  );
-  for (const repeatable of repeatables) {
-    const dueAnchors = generateAnchorsUntil(repeatable, now);
-    for (const anchorAt of dueAnchors) {
-      if (!existingAnchors.has(`${repeatable.id}:${anchorAt}`)) {
-        anchors.push({
-          repeatableQuestId: repeatable.id,
-          anchorAt,
-          markerId: "attention.available.repeatable"
-        });
-      }
-    }
-  }
-  return anchors.sort(
-    (a, b) => a.anchorAt - b.anchorAt || a.repeatableQuestId - b.repeatableQuestId
-  );
-}
-
 // src/repeatable_quests/soft_delete_repeatable_quest.ts
 function softDeleteRepeatableQuest(db, repeatableQuestId, deletedAt) {
   const now = resolveNow(deletedAt);
@@ -1768,95 +2289,6 @@ function softDeleteRepeatableQuest(db, repeatableQuestId, deletedAt) {
   ).run(now, now, repeatableQuestId);
 }
 
-// src/rewards/copy_repeatable_quest_rewards_to_quest.ts
-function copyRepeatableQuestRewardsToQuest(db, repeatableQuestId, questId, now) {
-  const effectiveNow = resolveNow(now);
-  const rows = db.prepare(
-    `SELECT kind, name, description, quantity
-       FROM repeatable_quest_rewards
-       WHERE repeatable_quest_id = ? AND deleted_at IS NULL`
-  ).all(repeatableQuestId);
-  for (const row of rows) {
-    db.prepare(
-      `INSERT INTO quest_rewards (quest_id, kind, name, description, quantity, created_at)
-       VALUES (?, ?, ?, ?, ?, ?)`
-    ).run(
-      questId,
-      String(row.kind),
-      String(row.name),
-      row.description == null ? null : String(row.description),
-      row.quantity == null ? null : Number(row.quantity),
-      effectiveNow
-    );
-  }
-}
-
-// src/tags/copy_repeatable_quest_tags_to_quest.ts
-function copyRepeatableQuestTagsToQuest(db, repeatableQuestId, questId, now) {
-  const effectiveNow = resolveNow(now);
-  const rows = db.prepare(
-    `SELECT tag_id
-       FROM repeatable_quest_tags
-       WHERE repeatable_quest_id = ? AND deleted_at IS NULL`
-  ).all(repeatableQuestId);
-  for (const row of rows) {
-    db.prepare(
-      `INSERT INTO quest_tags (quest_id, tag_id, created_at)
-       VALUES (?, ?, ?)`
-    ).run(questId, Number(row.tag_id), effectiveNow);
-  }
-}
-
-// src/repeatable_quests/spawn_due_repeatable_quests.ts
-function spawnDueRepeatableQuests(db, now) {
-  return withTransaction(db, () => {
-    const anchors = listDueRepeatableQuestAnchors(db, now);
-    const quests = [];
-    for (const anchor of anchors) {
-      const repeatable = getRepeatableQuestOrThrow(db, anchor.repeatableQuestId);
-      const created = db.prepare(
-        `INSERT INTO quests (
-             questline_id,
-             source_rumor_id,
-             spawned_by_quest_id,
-             spawned_from_repeatable_id,
-             spawned_for_at,
-             title,
-             objective,
-             created_at,
-             updated_at,
-             effort_seconds,
-             estimate_seconds,
-             not_before_at,
-             due_at,
-             scheduled_start_at,
-             scheduled_end_at,
-             all_day
-           ) VALUES (?, NULL, NULL, ?, ?, ?, ?, ?, ?, 0, ?, ?, ?, ?, ?, ?)`
-      ).run(
-        repeatable.questlineId ?? null,
-        repeatable.id,
-        anchor.anchorAt,
-        repeatable.title,
-        repeatable.objective,
-        now,
-        now,
-        repeatable.estimateSeconds ?? null,
-        repeatable.notBeforeOffsetSeconds == null ? null : anchor.anchorAt + repeatable.notBeforeOffsetSeconds * 1e3,
-        repeatable.dueOffsetSeconds == null ? null : anchor.anchorAt + repeatable.dueOffsetSeconds * 1e3,
-        repeatable.scheduledStartOffsetSeconds == null ? null : anchor.anchorAt + repeatable.scheduledStartOffsetSeconds * 1e3,
-        repeatable.scheduledEndOffsetSeconds == null ? null : anchor.anchorAt + repeatable.scheduledEndOffsetSeconds * 1e3,
-        repeatable.allDay ? 1 : 0
-      );
-      const questId = Number(created.lastInsertRowid);
-      copyRepeatableQuestTagsToQuest(db, repeatable.id, questId, now);
-      copyRepeatableQuestRewardsToQuest(db, repeatable.id, questId, now);
-      quests.push(getQuestOrThrow(db, questId));
-    }
-    return quests;
-  });
-}
-
 // src/rumors/derive_rumor_state.ts
 function deriveRumorState(rumor) {
   if (rumor.dismissedAt != null) {
@@ -2862,8 +3294,16 @@ Failure handling:
 - Do not filter by tags and assume that is the same as a schedule or dependency review.`
 });
 
+// src/skills/webhooks.ts
+var webhooksSkill = defineQuestlogSkill({
+  name: "webhooks",
+  description: "Configure signed outbound event webhooks and verify deliveries.",
+  content: '# Webhooks\n\nUse `questlog` to configure opt-in outbound automation. No server or scheduler is added.\nNo targets means no network calls. `manage_hooks` supports list, remove, tick with\n`dry_run`, and deliveries; add/test are CLI-only. `review_questlog` view `deliveries`\nand `questlog show <id>` expose pending/failed deliveries.\n\n```sh\nquestlog hook add https://example.org/wake --min-gap 60\nquestlog hook add https://example.org/team --tag work --events quest.due,quest.overdue --secret-stdin\nquestlog hook label work\nquestlog hook list\nquestlog tick --dry-run\nquestlog tick\nquestlog watch --interval 60\nquestlog hook test 1\nquestlog review deliveries\nquestlog show 12\nquestlog hook remove 1\n```\n\n`hook add` prints its random 32-byte signing secret once, also as `secret` in `--json`.\nSave it securely. `--secret-stdin` supplies one via stdin; there is no secret flag.\nList output redacts userinfo/query strings. Removal deletes the target and deliveries.\nDefault scope is the database; `--tag` matches quest tags, never rumors.\n`--events` defaults to all types. The DB label defaults to the filename without its\npath/extension (`questlog` in memory); set it to a name suitable for disclosure.\n\n```cron\n* * * * * questlog tick\n```\n\nCron\'s PATH may need `$HOME/.local/bin/questlog tick --db /path/to/quests.db`.\nWatch defaults to 60 seconds (minimum 5); SIGINT/SIGTERM finishes the current tick.\nTick exits 0 even when deliveries need retries. Dry-run records nothing and sends nothing.\n\nEvents are detected from the model at tick time:\n\n- `quest.due`: an unresolved, undeleted quest reaches its effective due time (own `due_at`, otherwise its undeleted questline\'s due time).\n- `quest.overdue`: that effective deadline is strictly earlier than now and the quest remains unresolved.\n- `quest.unblocked`: an unresolved quest is available, all active prerequisites have succeeded or been deleted, and at least one prerequisite succeeded after its unlock was installed. Occurrence time is the latest active prerequisite success or not-before time, whichever is later.\n- `repeatable.spawned`: a concrete repeatable instance was created; occurrence time is its creation time. Tick first materializes due anchors through the existing spawn operation.\n- `rumor.captured`: an undeleted rumor was created; occurrence time is its creation time, even if subsequently settled or dismissed.\n\nPersistent event keys contain type, entity ids, and occurrence time. Restarts and repeated\nticks do not repeat occurrences. Removed transitions between ticks cannot be reconstructed.\nOnly occurrences at/after target creation are assigned; tags are evaluated at assignment.\nTick materializes due repeatables using the existing spawn path, including during preview\nwith rollback. Batches contain only ids, event types, timestamps, and the DB label:\n\n```json\n{"type":"questlog.events","db":"work","deliveryId":"d_\u2026","sentAt":"2026-10-28T10:00:00.000Z","events":[{"id":"e_\u2026","type":"quest.due","questId":12,"occurredAt":"2026-10-28T09:59:00.000Z"}]}\n```\n\nHeaders are `content-type: application/json`, `user-agent: questlog/<version>`,\n`x-questlog-delivery: <deliveryId>`, `x-questlog-timestamp: <unix seconds>`, and\n`x-questlog-signature: sha256=<hex HMAC-SHA256(secret, timestamp + "." + rawBody)>`.\nNo titles, objectives, details, or tag text are sent. `hook test` sends a logged `hook.test`\nevent immediately, ignoring the min gap. Add and test are CLI-only in the tool facade;\n`manage_hooks` supports list, remove, tick (with `dry_run`), and deliveries.\n\n2xx delivers. Timeout is 5 seconds. Failures retry after 30 s, 1 m, 2 m, 4 m, doubling\nto 1 h plus <1 s jitter, subject to the target\'s min gap. Eight failures mark failed.\nRetries keep the delivery id/events; new events queue behind them. Keep the last 500\ndelivered log entries per target and all pending/failed entries. Transactional claims\nlease work for two minutes. A crash after receipt may retry: dedupe at the receiver.\n\n### Verifying a delivery\n\nCompute HMAC-SHA256 over `timestamp + "." + rawBody` with the secret and compare in constant\ntime. Reject timestamps older than 5 minutes (and timestamps too far in the future), then\ndedupe on `x-questlog-delivery`. Use durable deduplication storage in a production receiver.\nThis 15-line Node example uses an in-memory set:\n\n```js\nimport { createHmac, timingSafeEqual } from \'node:crypto\';\nimport { createServer } from \'node:http\';\nconst secret = process.env.WEBHOOK_SECRET, seen = new Set();\ncreateServer(async (req, res) => {\n  const chunks = []; for await (const chunk of req) chunks.push(chunk);\n  const rawBody = Buffer.concat(chunks), h = req.headers;\n  const timestamp = h[\'x-questlog-timestamp\'], id = h[\'x-questlog-delivery\'];\n  const age = Date.now() / 1000 - Number(timestamp);\n  const expected = createHmac(\'sha256\', secret).update(timestamp + \'.\').update(rawBody).digest();\n  const signature = String(h[\'x-questlog-signature\'] || \'\');\n  const actual = Buffer.from(signature.slice(7), \'hex\');\n  if (!id || !/^\\d+$/.test(timestamp) || age > 300 || age < -300 || !/^sha256=[a-f0-9]{64}$/.test(signature) || actual.length !== expected.length || !timingSafeEqual(actual, expected)) { res.writeHead(401).end(); return; }\n  if (!seen.has(id)) { seen.add(id); console.log(JSON.parse(rawBody)); }\n  res.writeHead(204).end();\n}).listen(8080, \'127.0.0.1\');\n```\n'
+});
+
 // src/skills/skill_registry.ts
 var questlogSkills = [
+  webhooksSkill,
   archiveDeleteAndPruneSkill,
   chooseWorkShapeSkill,
   clarifyAmbiguousRequestsSkill,
@@ -2969,6 +3409,8 @@ __export(tools_exports, {
   integerSchema: () => integerSchema,
   listQuestlogToolDefinitions: () => listQuestlogToolDefinitions,
   literalSchema: () => literalSchema,
+  manageHooksTool: () => manageHooksTool,
+  manageHooksToolName: () => manageHooksToolName,
   manageRepeatableTool: () => manageRepeatableTool,
   manageRepeatableToolHandler: () => manageRepeatableToolHandler,
   manageRepeatableToolName: () => manageRepeatableToolName,
@@ -3025,6 +3467,7 @@ var manageRepeatableToolName = "manage_repeatable";
 var tagWorkToolName = "tag_work";
 var rewardWorkToolName = "reward_work";
 var retireWorkToolName = "retire_work";
+var manageHooksToolName = "manage_hooks";
 
 // src/tools/tool_types.ts
 function withOptionalFields(result, options) {
@@ -3280,6 +3723,7 @@ function validateInput(schema, input, path = "$") {
 
 // src/tools/action_requirements.ts
 var actionRequirements = {
+  manage_hooks: { remove: ["id"] },
   shape_work: {
     create_quest: ["quest"],
     create_questline: ["questline"],
@@ -3662,7 +4106,8 @@ function inspectQuestlogItemToolHandler(db, input) {
               detail: detailLevel === "full" ? detail : toQuestCompactDetail(detail)
             },
             related,
-            detailLevel
+            detailLevel,
+            deliveries: listDeliveries(db, { questId: detail.id })
           },
           { entities }
         );
@@ -3768,6 +4213,56 @@ var inspectQuestlogItemTool = defineQuestlogTool({
   handler: inspectQuestlogItemToolHandler
 });
 
+// src/tools/manage_hooks_tool.ts
+var manageHooksTool = defineQuestlogTool({
+  name: "manage_hooks",
+  description: "List or remove outbound webhook targets, run a tick, or inspect pending and failed deliveries.",
+  whenToUse: "Use to operate configured outbound webhooks. Add and test targets with the CLI.",
+  whenNotToUse: "Use quest tools to change work itself.",
+  sideEffects: "writes_state",
+  readOnly: false,
+  supportsClarification: false,
+  targetKinds: ["hook"],
+  inputDescriptions: {
+    action: "Operation to perform.",
+    id: "Target id for removal.",
+    dry_run: "Preview a tick without recording or sending."
+  },
+  outputDescription: "Returns redacted targets, delivery metadata, or a tick summary. Never returns signing secrets.",
+  inputSchema: objectSchema(
+    {
+      action: enumSchema("Operation.", ["list", "remove", "tick", "deliveries"]),
+      id: integerSchema("Target id."),
+      dry_run: booleanSchema("Preview only.")
+    },
+    ["action"]
+  ),
+  handler: async (db, input) => {
+    switch (input.action) {
+      case "list":
+        return toolSuccess("Webhook targets.", listHooks(db));
+      case "deliveries":
+        return toolSuccess("Pending and failed deliveries.", listDeliveries(db));
+      case "remove":
+        if (!Number.isSafeInteger(input.id) || Number(input.id) < 1)
+          return toolFailure(
+            "protocol",
+            "invalid_input",
+            "Target id required.",
+            "Provide a positive target id.",
+            { recovery: 'Pass {"action":"remove","id":1}' }
+          );
+        removeHook(db, Number(input.id));
+        return toolSuccess("Webhook target removed.", {});
+      case "tick":
+        return toolSuccess(
+          "Webhook tick completed.",
+          await tickQuestlog(db, { dryRun: input.dry_run ?? false })
+        );
+    }
+  }
+});
+
 // src/tools/manage_repeatable_tool.ts
 function manageRepeatableToolHandler(db, input) {
   try {
@@ -4467,7 +4962,7 @@ function validateReviewInput(input) {
       'Use `filters.dayAt` only with `view: "quests.scheduled_for_day"`.'
     );
   }
-  if ((input.view === "rumors" || input.view === "questlines") && hasQuestFilters(input.filters)) {
+  if ((input.view === "rumors" || input.view === "questlines" || input.view === "deliveries") && hasQuestFilters(input.filters)) {
     return toolFailure(
       "protocol",
       "invalid_input",
@@ -4535,6 +5030,15 @@ function reviewQuestlogToolHandler(db, input) {
   if (invalid) {
     return invalid;
   }
+  if (input.view === "deliveries")
+    return toolSuccess("Pending and failed deliveries.", {
+      view: input.view,
+      items: [],
+      deliveries: listDeliveries(db),
+      count: listDeliveries(db).length,
+      appliedFilters: input.filters,
+      evaluatedAt: input.now ?? Date.now()
+    });
   const now = input.now ?? Date.now();
   let items = [];
   switch (input.view) {
@@ -4594,6 +5098,7 @@ var reviewQuestlogTool = defineQuestlogTool({
   inputSchema: objectSchema(
     {
       view: enumSchema("Which operational review surface to return.", [
+        "deliveries",
         "questlines",
         "quests.active",
         "quests.available",
@@ -5795,6 +6300,7 @@ var tagWorkTool = defineQuestlogTool({
 
 // src/tools/tool_mapping.ts
 var questlogToolMappings = [
+  { source: "tickQuestlog", tool: "manage_hooks", action: "tick" },
   { source: "searchQuestlog", tool: "search_questlog" },
   { source: "listRumors", tool: "review_questlog", action: "rumors" },
   { source: "listQuestlines", tool: "review_questlog", action: "questlines" },
@@ -5892,6 +6398,7 @@ var questlogToolMappings = [
 
 // src/tools/tool_registry.ts
 var questlogTools = [
+  manageHooksTool,
   searchQuestlogTool,
   reviewQuestlogTool,
   inspectQuestlogItemTool,
@@ -5955,4 +6462,4 @@ __export(write_exports, {
   updateRumor: () => updateRumor
 });
 
-export { initQuestlogTables, markers_exports as markers, read_exports as read, skills_exports as skills, soul_exports as soul, tools_exports as tools, write_exports as write };
+export { hooks_exports as hooks, initQuestlogTables, markers_exports as markers, read_exports as read, skills_exports as skills, soul_exports as soul, tools_exports as tools, write_exports as write };