@ghostpaw/questlog 0.9.1 → 0.10.1

package/dist/{chunk-3Y5F3SMB.js → chunk-55JAQORX.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import { tickQuestlog, removeHook, listDeliveries, listHooks, listDueRepeatableQuestAnchors, getRepeatableQuestOrThrow, spawnDueRepeatableQuests, deriveQuestState, deriveQuestMarkerId, queryQuestDetailRecords, resolveNow, withTransaction, getQuestOrThrow, parseRRule, mapQuestRewardRow, normalizeTagName } from './chunk-N7V7VUI5.js';
+import { registerSchemaActions, minimalInput, requiredForAction } from './chunk-QYSIJ2YN.js';
+
 // src/questlines/map_questline_row.ts
 function mapQuestlineRow(row) {
   return {
@@ -116,51 +119,6 @@ function assertNonEmpty(value, label) {
   return trimmed;
 }
 
-// src/resolve_now.ts
-function resolveNow(now) {
-  return now ?? Date.now();
-}
-
-// 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);
@@ -233,41 +191,6 @@ function addUnlock(db, fromQuestId, toQuestId, now) {
   ).run(fromQuestId, toQuestId, resolveNow(now));
 }
 
-// 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/assert_non_negative_seconds.ts
 function assertNonNegativeSeconds(value, label) {
   if (value != null && value < 0) {
@@ -305,11 +228,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);
@@ -442,209 +360,6 @@ function finishQuest(db, questId, outcome, resolvedAt) {
   return resolveQuest(db, questId, true, outcome, resolvedAt);
 }
 
-// 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/quests/get_quest_detail.ts
 function getQuestDetail(db, questId, now = Date.now()) {
   const [record] = queryQuestDetailRecords(db, {}, now, [questId]);
@@ -828,215 +543,6 @@ function startQuest(db, questId, startedAt) {
   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/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/markers/derive_rumor_marker_id.ts
 function deriveRumorMarkerId({ state }) {
   if (state === "open") {
@@ -1080,8 +586,182 @@ function listRumors(db) {
   return db.prepare("SELECT * FROM rumors WHERE deleted_at IS NULL ORDER BY created_at DESC, id DESC").all().map(mapRumorRow);
 }
 
+// src/surfaces/validate_input.ts
+function validateInput(schema, input, path = "$") {
+  const errors = [];
+  const matchesType = (type) => {
+    switch (type) {
+      case "object":
+        return typeof input === "object" && input !== null && !Array.isArray(input);
+      case "array":
+        return Array.isArray(input);
+      case "integer":
+        return typeof input === "number" && Number.isInteger(input);
+      case "number":
+        return typeof input === "number" && Number.isFinite(input);
+      case "null":
+        return input === null;
+      default:
+        return typeof input === type;
+    }
+  };
+  if (schema.type && !(Array.isArray(schema.type) ? schema.type : [schema.type]).some(matchesType)) {
+    return [`${path}: expected ${String(schema.type)}`];
+  }
+  if (schema.enum && !schema.enum.some((value) => JSON.stringify(value) === JSON.stringify(input)))
+    errors.push(`${path}: expected one of ${JSON.stringify(schema.enum)}`);
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0 && constant !== input)
+    errors.push(`${path}: expected ${JSON.stringify(constant)}`);
+  if (schema.oneOf) {
+    const branches = schema.oneOf.map((branch) => validateInput(branch, input, path));
+    if (!branches.some((errors2) => errors2.length === 0)) {
+      errors.push(
+        ...branches.sort((a, b) => a.length - b.length)[0] ?? [
+          `${path}: must match at least one schema branch`
+        ]
+      );
+    }
+  }
+  if (typeof input === "object" && input !== null && !Array.isArray(input)) {
+    const record = input;
+    for (const name of [...schema.required ?? [], ...requiredForAction(schema, record.action)])
+      if (!Object.hasOwn(record, name)) errors.push(`${path}.${name}: required`);
+    for (const [name, property] of Object.entries(schema.properties ?? {}))
+      if (Object.hasOwn(record, name))
+        errors.push(...validateInput(property, record[name], `${path}.${name}`));
+  }
+  if (Array.isArray(input) && schema.items)
+    input.forEach((value, index) => {
+      errors.push(...validateInput(schema.items, value, `${path}[${index}]`));
+    });
+  return errors;
+}
+
+// src/tools/action_requirements.ts
+var actionRequirements = {
+  manage_hooks: { remove: ["id"] },
+  shape_work: {
+    create_quest: ["quest"],
+    create_questline: ["questline"],
+    attach_quest_to_questline: ["questId", "questlineId"],
+    detach_quest_from_questline: ["questId"],
+    dismiss_rumor: ["rumorId"],
+    reopen_rumor: ["rumorId"],
+    settle_rumor: ["rumorId"],
+    update_rumor: ["rumorId"]
+  },
+  manage_repeatable: {
+    create: ["repeatableQuest"],
+    archive: ["repeatableQuestId"],
+    update: ["repeatableQuestId"],
+    spawn_due: ["now"]
+  },
+  organize_work: {
+    add_unlock: ["fromQuestId", "toQuestId"],
+    remove_unlock: ["fromQuestId", "toQuestId"],
+    replace_unlocks: ["fromQuestIds", "toQuestId"],
+    archive_questline: ["questlineId"],
+    set_questline_fields: ["questlineId"]
+  },
+  plan_quest: { revise_objective: ["objective"] },
+  run_quest: {
+    abandon_and_spawn_followups: ["followups"],
+    log_effort: ["effortSeconds"]
+  },
+  reward_work: { add: ["reward"], update: ["reward"], replace_repeatable_template: ["rewards"] }
+};
+
+// src/tools/tool_types.ts
+function withOptionalFields(result, options) {
+  if (options.next && options.next.length > 0) {
+    result.next = options.next;
+  }
+  if (options.warnings && options.warnings.length > 0) {
+    result.warnings = options.warnings;
+  }
+  return result;
+}
+function toolWarning(code, message) {
+  return { code, message };
+}
+function toolSuccess(summary, data, options = {}) {
+  return withOptionalFields(
+    {
+      ok: true,
+      outcome: "success",
+      summary,
+      entities: options.entities ?? [],
+      data
+    },
+    options
+  );
+}
+function toolNoOp(summary, data, options = {}) {
+  return withOptionalFields(
+    {
+      ok: true,
+      outcome: "no_op",
+      summary,
+      entities: options.entities ?? [],
+      data
+    },
+    options
+  );
+}
+function toolNeedsClarification(code, question, missing, options = {}) {
+  return withOptionalFields(
+    {
+      ok: false,
+      outcome: "needs_clarification",
+      summary: question,
+      entities: options.entities ?? [],
+      clarification: {
+        code,
+        question,
+        missing,
+        options: options.options
+      }
+    },
+    options
+  );
+}
+function toolFailure(kind, code, summary, message, options = {}) {
+  return withOptionalFields(
+    {
+      ok: false,
+      outcome: "error",
+      summary,
+      entities: options.entities ?? [],
+      error: {
+        kind,
+        code,
+        message,
+        recovery: options.recovery,
+        details: options.details
+      }
+    },
+    options
+  );
+}
+
 // src/tools/tool_metadata.ts
 function defineQuestlogTool(definition) {
+  const requirements = actionRequirements[definition.name];
+  if (requirements) registerSchemaActions(definition.inputSchema, requirements);
+  const handler = definition.handler;
+  definition.handler = (db, input) => {
+    const errors = validateInput(definition.inputSchema, input);
+    if (errors.length) {
+      const action = input?.action;
+      const example = minimalInput(definition.inputSchema, action);
+      const message = errors.join("; ");
+      return toolFailure("protocol", "invalid_input", message, message, {
+        recovery: `${message}; pass ${JSON.stringify(example)}`
+      });
+    }
+    return handler(db, input);
+  };
   return definition;
 }
 function stringSchema(description, options = {}) {
@@ -1243,79 +923,6 @@ function summarizeCount(count, singular, plural = `${singular}s`) {
   return `Found ${count} ${plural}.`;
 }
 
-// src/tools/tool_types.ts
-function withOptionalFields(result, options) {
-  if (options.next && options.next.length > 0) {
-    result.next = options.next;
-  }
-  if (options.warnings && options.warnings.length > 0) {
-    result.warnings = options.warnings;
-  }
-  return result;
-}
-function toolWarning(code, message) {
-  return { code, message };
-}
-function toolSuccess(summary, data, options = {}) {
-  return withOptionalFields(
-    {
-      ok: true,
-      outcome: "success",
-      summary,
-      entities: options.entities ?? [],
-      data
-    },
-    options
-  );
-}
-function toolNoOp(summary, data, options = {}) {
-  return withOptionalFields(
-    {
-      ok: true,
-      outcome: "no_op",
-      summary,
-      entities: options.entities ?? [],
-      data
-    },
-    options
-  );
-}
-function toolNeedsClarification(code, question, missing, options = {}) {
-  return withOptionalFields(
-    {
-      ok: false,
-      outcome: "needs_clarification",
-      summary: question,
-      entities: options.entities ?? [],
-      clarification: {
-        code,
-        question,
-        missing,
-        options: options.options
-      }
-    },
-    options
-  );
-}
-function toolFailure(kind, code, summary, message, options = {}) {
-  return withOptionalFields(
-    {
-      ok: false,
-      outcome: "error",
-      summary,
-      entities: options.entities ?? [],
-      error: {
-        kind,
-        code,
-        message,
-        recovery: options.recovery,
-        details: options.details
-      }
-    },
-    options
-  );
-}
-
 // src/tools/review_questlog_tool.ts
 function hasQuestFilters(filters) {
   return Boolean(
@@ -1346,7 +953,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",
@@ -1414,6 +1021,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) {
@@ -1473,6 +1089,7 @@ var reviewQuestlogTool = defineQuestlogTool({
   inputSchema: objectSchema(
     {
       view: enumSchema("Which operational review surface to return.", [
+        "deliveries",
         "questlines",
         "quests.active",
         "quests.available",
@@ -1831,7 +1448,8 @@ function inspectQuestlogItemToolHandler(db, input) {
               detail: detailLevel === "full" ? detail : toQuestCompactDetail(detail)
             },
             related,
-            detailLevel
+            detailLevel,
+            deliveries: listDeliveries(db, { questId: detail.id })
           },
           { entities }
         );
@@ -1937,6 +1555,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/repeatable_quests/update_repeatable_quest.ts
 function updateRepeatableQuest(db, repeatableQuestId, input) {
   return withTransaction(db, () => {
@@ -2106,95 +1774,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/tools/manage_repeatable_tool.ts
 function manageRepeatableToolHandler(db, input) {
   try {
@@ -3191,7 +2770,7 @@ var rewardWorkTool = defineQuestlogTool({
           name: stringSchema("Reward name."),
           now: integerSchema("Optional update timestamp for the update action.")
         },
-        []
+        ["kind", "name"]
       ),
       rewards: arraySchema(
         objectSchema(
@@ -4018,7 +3597,7 @@ var shapeWorkTool = defineQuestlogTool({
           title: stringSchema("Questline title."),
           description: stringSchema("Optional questline description.")
         },
-        []
+        ["title"]
       ),
       rumorId: integerSchema("Rumor to settle, dismiss, or reopen."),
       dismissedAt: integerSchema("Optional dismissal timestamp."),
@@ -4277,6 +3856,7 @@ var tagWorkTool = defineQuestlogTool({
 
 // src/tools/tool_registry.ts
 var questlogTools = [
+  manageHooksTool,
   searchQuestlogTool,
   reviewQuestlogTool,
   inspectQuestlogItemTool,
@@ -4300,9 +3880,9 @@ var questlogSurfaceTools = questlogTools.map(
     whenNotToUse: tool.whenNotToUse ?? "",
     readOnly: tool.readOnly,
     sideEffects: tool.sideEffects,
-    inputSchema: { ...tool.inputSchema, type: "object" },
+    inputSchema: tool.inputSchema,
     handler: tool.handler
   })
 );
 
-export { getQuestDetail, questlogSurfaceTools, reviewQuestlogTool };
+export { getQuestDetail, questlogSurfaceTools, reviewQuestlogTool, validateInput };