@ghostpaw/questlog 0.9.2 → 0.11.0

package/dist/open_questlog_db-6NS6BVBC.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export { openQuestlogDb } from './chunk-IA2GVCZS.js';

package/dist/{questlog_skill_spec-EM6DGGVN.js → questlog_skill_spec-ILTCTRYS.js}

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
+import { questlogSkills } from './chunk-I2AMIXGP.js';
 import { questlogMcpInstructions } from './chunk-SVWAEAKC.js';
-import { questlogSkills } from './chunk-6KTQK3ZE.js';
-import { reviewQuestlogTool, questlogSurfaceTools } from './chunk-UTUQPSGO.js';
+import { reviewQuestlogTool, questlogSurfaceTools } from './chunk-KOWIVBG6.js';
+import './chunk-RBGQK5WP.js';
+import './chunk-D6EGZCT7.js';
+import './chunk-NBCCA6AX.js';
 import './chunk-QYSIJ2YN.js';
 
 // src/soul.ts
@@ -49,15 +52,20 @@ var questlogSkillSpec = {
     "`questlog` and `ghostpaw-questlog` are the same binary.",
     "",
     "- `questlog search <words>` before `add` to avoid duplicates.",
-    '- `ghostpaw-questlog add "..." --tag a,b --due tomorrow`',
+    '- `ghostpaw-questlog add "Write the report" --tag work --due tomorrow`',
     `- \`questlog list [--view <view>]\`: ${reviewQuestlogTool.inputSchema.properties?.view?.enum?.join(", ")}.`,
-    '- `questlog done <id> --outcome "..."`',
-    "- `questlog search <words>`",
-    "- `questlog show <id>`",
+    '- `questlog done 12 --outcome "Report sent"`',
+    '- `questlog search "release"`',
+    "- `questlog show 12`",
+    "- `questlog list --view quests.available`",
     "- Use `--json` on any plain command.",
-    "- Exit codes: 0 ok / 1 error / 2 usage / 3 needs input.",
+    "- Exit codes: 0 ok / 1 error / 2 usage / 3 needs input or hook target not found.",
     "- Database: `~/.ghostpaw/questlog.db`; override with `--db` or `GHOSTPAW_QUESTLOG_DB`.",
-    "- Use one database per agent or project."
+    "- Use one database per project.",
+    "- `questlog --version` prints the installed version.",
+    "- `questlog skill --short` prints this compact cheat sheet.",
+    "- `questlog skill --list` lists guides; `questlog skill webhooks` reads one.",
+    "- Webhooks: `questlog hook add <url>`, `questlog tick --dry-run`, `questlog watch`. Read `questlog skill webhooks` for events, signing, verification, and cron setup."
   ].join("\n"),
   description: "Use the release binary ghostpaw-questlog to manage local tasks, calendar commitments, and recurring work. Use when planning, executing, reviewing, or organizing work.",
   license: "MIT",

package/dist/run_hook_command-BOENYNDT.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+import { parseCliArgs } from './chunk-GVD6A3RR.js';
+import { textOutput } from './chunk-QK3H2AL5.js';
+import { watchQuestlog, testHook, removeHook, hookLabel, withTransaction, addHook } from './chunk-RBGQK5WP.js';
+import './chunk-D6EGZCT7.js';
+import { listHooks } from './chunk-NBCCA6AX.js';
+
+// src/hooks/hook_headers.ts
+function parseHookHeaders(lines) {
+  const headers = /* @__PURE__ */ Object.create(null);
+  for (const line of lines) {
+    const colon = line.indexOf(":");
+    const name = line.slice(0, colon).trim().toLowerCase();
+    if (colon < 1 || !/^[!#$%&'*+.^_`|~0-9a-z-]+$/.test(name))
+      throw new Error("Invalid header name; use Name: value");
+    if (["host", "content-length", "content-type"].includes(name) || name.startsWith("x-questlog-"))
+      throw new Error(`Reserved header name: ${name}`);
+    const value = line.slice(colon + 1).trim();
+    if (/[\r\n\0]/.test(value)) throw new Error("Invalid header value");
+    headers[name] = value;
+  }
+  return headers;
+}
+
+// src/surface/run_hook_command.ts
+async function runHookCommand(command, args, io, open) {
+  let db;
+  try {
+    if (args.includes("--help") || args.includes("-h")) {
+      io.stdout.write(
+        'questlog hook add <url> [--tag name] [--events types] [--min-gap seconds] [--secret-stdin] [--header "Name: value"] [--header-stdin] [--json]\nquestlog hook list|remove <id>|test <id>|label [name]\nquestlog watch [--interval seconds] [--json]\n'
+      );
+      return 0;
+    }
+    const action = command === "watch" ? "watch" : args.shift();
+    if (!["add", "list", "remove", "test", "label", "watch"].includes(action ?? ""))
+      throw new Error("Expected hook add, list, remove, test, or label");
+    const values = parseCliArgs(args, {
+      command,
+      flags: [
+        { name: "json", type: "boolean" },
+        ...action === "add" ? [
+          { name: "tag", type: "string" },
+          { name: "events", type: "string" },
+          { name: "min-gap", type: "integer" },
+          { name: "secret-stdin", type: "boolean" },
+          { name: "header", type: "array" },
+          { name: "header-stdin", type: "boolean" }
+        ] : action === "watch" ? [{ name: "interval", type: "number" }] : []
+      ],
+      positionals: action === "add" ? [{ name: "url", type: "string", required: true }] : ["remove", "test"].includes(action ?? "") ? [{ name: "id", type: "integer", required: true }] : action === "label" ? [{ name: "name", type: "string" }] : []
+    });
+    if (action === "watch" && values.interval !== void 0 && Number(values.interval) < 5)
+      throw new Error(`--interval ${values.interval} is below the minimum of 5 seconds`);
+    db = await open();
+    let result;
+    switch (action) {
+      case "add": {
+        let secret;
+        if (values.secretStdin && values.headerStdin)
+          throw new Error("Use --secret-stdin and --header-stdin separately");
+        const headerLines = values.header ?? [];
+        if (values.headerStdin) {
+          let raw = "";
+          for await (const chunk of io.stdin) raw += String(chunk);
+          headerLines.push(...raw.split(/\r?\n/).filter(Boolean));
+        }
+        const headers = parseHookHeaders(headerLines);
+        if (values.secretStdin) {
+          secret = "";
+          for await (const chunk of io.stdin) secret += String(chunk);
+          secret = secret.replace(/\r?\n$/, "");
+        }
+        result = withTransaction(db, () => {
+          const created = addHook(db, {
+            url: String(values.url),
+            ...values.tag === void 0 ? {} : { tag: String(values.tag) },
+            ...values.events === void 0 ? {} : { events: String(values.events).split(",") },
+            ...values.minGap === void 0 ? {} : { minGap: Number(values.minGap) },
+            ...secret === void 0 ? {} : { secret }
+          });
+          db.prepare("UPDATE hook_targets SET headers = ? WHERE id = ?").run(JSON.stringify(headers), created.id);
+          return created;
+        });
+        break;
+      }
+      case "list":
+        result = listHooks(db);
+        break;
+      case "label":
+        result = { label: hookLabel(db, values.name) };
+        break;
+      case "remove":
+        if (!listHooks(db).some((hook) => hook.id === Number(values.id))) {
+          io.stderr.write(`Hook ${values.id} not found
+`);
+          return 3;
+        }
+        removeHook(db, Number(values.id));
+        result = { removed: Number(values.id) };
+        break;
+      case "test":
+        if (!listHooks(db).some((hook) => hook.id === Number(values.id))) {
+          io.stderr.write(`Hook ${values.id} not found
+`);
+          return 3;
+        }
+        result = await testHook(db, Number(values.id));
+        break;
+      case "watch": {
+        const controller = new AbortController();
+        const stop = () => controller.abort();
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
+        try {
+          await watchQuestlog(db, {
+            signal: controller.signal,
+            interval: Number(values.interval ?? 60),
+            onTick: (tick) => io.stdout.write(
+              values.json ? `${JSON.stringify(tick)}
+` : `${tick.events.length} events; ${tick.sent} sent, ${tick.queued} queued, ${tick.retrying} retrying, ${tick.failed} failed
+`
+            )
+          });
+        } finally {
+          process.off("SIGINT", stop);
+          process.off("SIGTERM", stop);
+        }
+        return 0;
+      }
+    }
+    io.stdout.write(
+      values.json ? `${JSON.stringify(result, null, 2)}
+` : action === "add" ? `Created hook ${result.id}
+Secret (shown once): ${result.secret}
+` : `${textOutput(result)}
+`
+    );
+    return 0;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : "";
+    const safe = /^(unsupported scheme |URL userinfo |unknown event |--interval |Invalid header |Reserved header |Use --secret-stdin|Expected |Min gap |Unknown event |Hook )/.test(
+      message
+    );
+    io.stderr.write(
+      `${safe ? message : "Invalid webhook command or unavailable target. Run questlog hook --help."}
+`
+    );
+    return 2;
+  } finally {
+    db?.close();
+  }
+}
+
+export { runHookCommand };

package/dist/{serve_questlog_mcp-KFUYJB2P.js → serve_questlog_mcp-X524X34F.js}

@@ -1,8 +1,11 @@
 #!/usr/bin/env node
-import { openQuestlogDb } from './chunk-3B6FMHZU.js';
 import { questlogMcpInstructions } from './chunk-SVWAEAKC.js';
-import { isErrorResult, questlogVersion, resolveQuestlogDbPath } from './chunk-DKH623HU.js';
-import { validateInput, questlogSurfaceTools } from './chunk-UTUQPSGO.js';
+import { isErrorResult, resolveQuestlogDbPath } from './chunk-IL2QRKZL.js';
+import { validateInput, questlogSurfaceTools } from './chunk-KOWIVBG6.js';
+import { openQuestlogDb } from './chunk-IA2GVCZS.js';
+import { questlogVersion } from './chunk-RBGQK5WP.js';
+import './chunk-D6EGZCT7.js';
+import './chunk-NBCCA6AX.js';
 import { minimalInput } from './chunk-QYSIJ2YN.js';
 
 // src/surfaces/mcp_server.ts

package/dist/{skill_markdown-HXYQ3K6U.js → skill_markdown-EGKYZ3W2.js}

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
+import { schemaRows } from './chunk-7KTRNXTU.js';
 import { minimalInput } from './chunk-QYSIJ2YN.js';
 
 // src/surfaces/skill_markdown.ts
-function renderSkillMarkdown(spec, { referencesBase = "references" } = {}) {
+function renderSkillMarkdown(spec, { referencesBase: _referencesBase = "references" } = {}) {
   if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(spec.name) || spec.name.length > 64)
     throw new Error("Invalid skill name");
   if (!spec.description.trim() || spec.description.length > 1024 || !spec.description.includes("Use when"))
@@ -48,24 +49,7 @@ function renderSkillMarkdown(spec, { referencesBase = "references" } = {}) {
       "| Parameter | Type | Required | Values / description |",
       "| --- | --- | --- | --- |"
     );
-    const rows = (schema, prefix = "") => {
-      const properties = { ...schema.properties };
-      const required = new Set(schema.required);
-      for (const branch of schema.oneOf ?? []) {
-        for (const [key, value] of Object.entries(branch.properties ?? {}))
-          properties[key] ??= value;
-        for (const key of branch.required ?? []) required.add(key);
-      }
-      for (const [name, property] of Object.entries(properties)) {
-        if (prefix && Object.keys(properties).length > 8 && !required.has(name)) continue;
-        const path = `${prefix}${name}`;
-        lines.push(
-          `| ${path} | ${property.type ?? property.oneOf?.map((branch) => branch.type).join(" / ") ?? "any"} | ${required.has(name) ? "yes" : "no"} | ${((property.enum ? `${property.enum.join(", ")}. ` : "") + (property.description ?? "")).replaceAll("|", "\\|").replaceAll("\n", " ")} |`
-        );
-        if (property.properties || property.oneOf) rows(property, `${path}.`);
-      }
-    };
-    rows(tool.inputSchema);
+    lines.push(...schemaRows(tool.inputSchema).map((row) => `| ${row} |`));
     lines.push("", "```sh");
     for (const action of tool.inputSchema.properties?.action?.enum?.slice(0, 3) ?? [void 0]) {
       lines.push(
@@ -79,7 +63,7 @@ function renderSkillMarkdown(spec, { referencesBase = "references" } = {}) {
     "## Workflow guides",
     "",
     ...spec.workflows.map(
-      (workflow) => `- \`${spec.bin} skill ${workflow.name}\` ([${workflow.name}](${referencesBase}/${workflow.name}.md)): ${workflow.description}`
+      (workflow) => `- \`${spec.bin} skill ${workflow.name}\`: ${workflow.description}`
     ),
     "",
     "## Principles",

package/dist/text_output-X7F3K23Q.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export { textOutput } from './chunk-QK3H2AL5.js';

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ghostpaw/questlog",
-	"version": "0.9.2",
+	"version": "0.11.0",
 	"description": "Unified task and calendar model for Node.js — SQLite, zero dependencies, with a built-in LLM tool facade",
 	"type": "module",
 	"exports": {

package/skills/questlog/SKILL.md

@@ -28,15 +28,20 @@ Run tools as `ghostpaw-questlog ...`; use `~/.local/bin/ghostpaw-questlog` if it
 `questlog` and `ghostpaw-questlog` are the same binary.
 
 - `questlog search <words>` before `add` to avoid duplicates.
-- `ghostpaw-questlog add "..." --tag a,b --due tomorrow`
-- `questlog list [--view <view>]`: questlines, quests.active, quests.available, quests.blocked, quests.deferred, quests.due_soon, quests.in_progress, quests.missed_scheduled, quests.open, quests.overdue, quests.resolved, quests.scheduled_for_day, quests.scheduled_now, repeatables.due_anchors, rumors.
-- `questlog done <id> --outcome "..."`
-- `questlog search <words>`
-- `questlog show <id>`
+- `ghostpaw-questlog add "Write the report" --tag work --due tomorrow`
+- `questlog list [--view <view>]`: deliveries, questlines, quests.active, quests.available, quests.blocked, quests.deferred, quests.due_soon, quests.in_progress, quests.missed_scheduled, quests.open, quests.overdue, quests.resolved, quests.scheduled_for_day, quests.scheduled_now, repeatables.due_anchors, rumors.
+- `questlog done 12 --outcome "Report sent"`
+- `questlog search "release"`
+- `questlog show 12`
+- `questlog list --view quests.available`
 - Use `--json` on any plain command.
-- Exit codes: 0 ok / 1 error / 2 usage / 3 needs input.
+- Exit codes: 0 ok / 1 error / 2 usage / 3 needs input or hook target not found.
 - Database: `~/.ghostpaw/questlog.db`; override with `--db` or `GHOSTPAW_QUESTLOG_DB`.
-- Use one database per agent or project.
+- Use one database per project.
+- `questlog --version` prints the installed version.
+- `questlog skill --short` prints this compact cheat sheet.
+- `questlog skill --list` lists guides; `questlog skill webhooks` reads one.
+- Webhooks: `questlog hook add <url>`, `questlog tick --dry-run`, `questlog watch`. Read `questlog skill webhooks` for events, signing, verification, and cron setup.
 
 ## Appendix: MCP and tool calls
 
@@ -50,6 +55,28 @@ CLI: `ghostpaw-questlog call <tool> '<JSON object>'` or `ghostpaw-questlog <tool
 
 Inspect schemas with `ghostpaw-questlog describe <tool>`. Use `--db <path>` to select a database.
 
+### manage_hooks
+
+List or remove outbound webhook targets, run a tick, or inspect pending and failed deliveries.
+
+Use when: Use to operate configured outbound webhooks. Add and test targets with the CLI.
+
+Not for: Use quest tools to change work itself.
+
+Writes: writes_state.
+
+| Parameter | Type | Required | Values / description |
+| --- | --- | --- | --- |
+| action | string | yes | list, remove, tick, deliveries. Operation. |
+| id | integer | no | Target id. |
+| dry_run | boolean | no | Preview only. |
+
+```sh
+ghostpaw-questlog call manage_hooks '{"action":"list"}'
+ghostpaw-questlog call manage_hooks '{"action":"remove","id":1}'
+ghostpaw-questlog call manage_hooks '{"action":"tick"}'
+```
+
 ### search_questlog
 
 Search quests and rumors by text when you need to find an existing item before inspecting or changing it.
@@ -83,7 +110,7 @@ Read-only.
 
 | Parameter | Type | Required | Values / description |
 | --- | --- | --- | --- |
-| view | string | yes | questlines, quests.active, quests.available, quests.blocked, quests.deferred, quests.due_soon, quests.in_progress, quests.missed_scheduled, quests.open, quests.overdue, quests.resolved, quests.scheduled_for_day, quests.scheduled_now, repeatables.due_anchors, rumors. Which operational review surface to return. |
+| view | string | yes | deliveries, questlines, quests.active, quests.available, quests.blocked, quests.deferred, quests.due_soon, quests.in_progress, quests.missed_scheduled, quests.open, quests.overdue, quests.resolved, quests.scheduled_for_day, quests.scheduled_now, repeatables.due_anchors, rumors. Which operational review surface to return. |
 | filters | object | no | Optional filters for supported review surfaces. |
 | filters.questlineId | integer | no | Optional questline id used by quest views. |
 | filters.tagNames | array | no | Optional tag names used by quest views. |
@@ -92,7 +119,7 @@ Read-only.
 | now | integer | no | Optional evaluation timestamp for time-sensitive views. |
 
 ```sh
-ghostpaw-questlog call review_questlog '{"view":"questlines"}'
+ghostpaw-questlog call review_questlog '{"view":"deliveries"}'
 ```
 
 ### inspect_questlog_item
@@ -152,16 +179,39 @@ Writes: writes_state.
 | action | string | yes | attach_quest_to_questline, create_quest, create_questline, detach_quest_from_questline, dismiss_rumor, reopen_rumor, settle_rumor, update_rumor. Action to perform. |
 | questId | integer | no | Quest to attach or detach. |
 | questlineId | integer | no | Questline that should receive the quest. |
-| quest | object | no |  |
+| quest | object | no | Object: title (required), objective (required), questlineId, tags, rewards, dueAt, notBeforeAt, scheduledStartAt, scheduledEndAt, allDay, estimateSeconds |
 | quest.title | string | yes | Title for the new quest. |
 | quest.objective | string | yes | Objective for the new quest. |
-| questline | object | no |  |
+| quest.questlineId | integer | no | Optional questline to place the quest in. |
+| quest.tags | array | no | Optional tags to apply at creation. |
+| quest.rewards | array | no | Optional rewards to attach at creation. |
+| quest.rewards[].kind | string | yes | Reward kind. |
+| quest.rewards[].name | string | yes | Reward name. |
+| quest.dueAt | integer | no | Optional latest acceptable completion timestamp. |
+| quest.notBeforeAt | integer | no | Optional earliest actionable timestamp. |
+| quest.scheduledStartAt | integer | no | Optional planned schedule window start. |
+| quest.scheduledEndAt | integer | no | Optional planned schedule window end. |
+| quest.allDay | boolean | no | Whether the scheduled window is all-day. |
+| quest.estimateSeconds | integer | no | Optional active-effort estimate in seconds. |
+| questline | object | no | Object: title (required), description |
 | questline.title | string | yes | Questline title. |
 | questline.description | string | no | Optional questline description. |
 | rumorId | integer | no | Rumor to settle, dismiss, or reopen. |
 | dismissedAt | integer | no | Optional dismissal timestamp. |
 | settledAt | integer | no | Optional settlement timestamp. |
 | quests | array | no | Quests to create during rumor settlement. Include timing and tags directly. |
+| quests[].title | string | yes | Title for a created quest. |
+| quests[].objective | string | yes | Objective for a created quest. |
+| quests[].tags | array | no | Optional tags to apply at creation. |
+| quests[].rewards | array | no | Optional rewards to attach at creation. |
+| quests[].rewards[].kind | string | yes | Reward kind. |
+| quests[].rewards[].name | string | yes | Reward name. |
+| quests[].dueAt | integer | no | Optional latest acceptable completion timestamp. |
+| quests[].notBeforeAt | integer | no | Optional earliest actionable timestamp. |
+| quests[].scheduledStartAt | integer | no | Optional planned schedule window start. |
+| quests[].scheduledEndAt | integer | no | Optional planned schedule window end. |
+| quests[].allDay | boolean | no | Whether the scheduled window is all-day. |
+| quests[].estimateSeconds | integer | no | Optional active-effort estimate in seconds. |
 | now | integer | no | Optional timestamp for membership, reopen, or rumor update. |
 | title | string | no | New title for the update_rumor action. |
 | details | string | no | New or enriched context text for the update_rumor action. |
@@ -221,6 +271,8 @@ Writes: writes_state.
 | outcome | string | no | Terminal outcome text. Required for finish, abandon, and abandon_and_spawn_followups. |
 | resolvedAt | integer | no | Optional resolved timestamp for finish or abandon actions. |
 | followups | array | no | Follow-up quests to create atomically. Required for abandon_and_spawn_followups. |
+| followups[].title | string | yes | Title for a follow-up quest. |
+| followups[].objective | string | yes | Objective for a follow-up quest. |
 
 ```sh
 ghostpaw-questlog call run_quest '{"action":"start","questId":1}'
@@ -272,7 +324,7 @@ Writes: writes_state.
 | --- | --- | --- | --- |
 | action | string | yes | archive, create, preview_due, spawn_due, update. Action to perform. |
 | repeatableQuestId | integer | no | Repeatable quest to archive or update. |
-| repeatableQuest | object | no |  |
+| repeatableQuest | object | no | Object: title (required), objective (required), rrule (required), anchorAt (required) |
 | repeatableQuest.title | string | yes | Title for the new repeatable quest. |
 | repeatableQuest.objective | string | yes | Objective for the new repeatable quest. |
 | repeatableQuest.rrule | string | yes | RRULE describing recurrence. |
@@ -310,7 +362,7 @@ Writes: writes_state.
 | Parameter | Type | Required | Values / description |
 | --- | --- | --- | --- |
 | action | string | yes | add, remove, replace. Action to perform. |
-| target | object | yes |  |
+| target | object | yes | Object: id (required), kind (required) |
 | target.id | integer | yes | Target entity id. |
 | target.kind | string | yes | quest, repeatable_quest. Target kind. |
 | tagNames | array | yes | Tag names to add, remove, or replace. |
@@ -335,14 +387,16 @@ Writes: writes_state.
 | Parameter | Type | Required | Values / description |
 | --- | --- | --- | --- |
 | action | string | yes | add, claim, remove, replace_repeatable_template, update. Action to perform. |
-| target | object | yes |  |
+| target | object | yes | Object: id (required), kind (required) |
 | target.id | integer | yes | Target entity id. |
 | target.kind | string | yes | quest, reward, repeatable_quest. Target kind. |
-| reward | object | no |  |
+| reward | object | no | Object: kind (required), name (required), now |
 | reward.kind | string | yes | Reward kind. |
 | reward.name | string | yes | Reward name. |
 | reward.now | integer | no | Optional update timestamp for the update action. |
 | rewards | array | no | Full future reward template set. Required for replace_repeatable_template. |
+| rewards[].kind | string | yes | Reward kind. |
+| rewards[].name | string | yes | Reward name. |
 | claimedAt | integer | no | Optional claim timestamp. |
 | now | integer | no | Optional timestamp for removal or template replacement. |
 
@@ -376,31 +430,32 @@ ghostpaw-questlog call retire_work '{"action":"hide","target":{"kind":"quest","i
 
 ### Workflow guides
 
-- `ghostpaw-questlog skill archive-delete-and-prune` ([archive-delete-and-prune](references/archive-delete-and-prune.md)): Choose the right retirement action for each kind of work so history stays honest and hiding does not get confused with archival or terminal execution truth.
-- `ghostpaw-questlog skill choose-work-shape` ([choose-work-shape](references/choose-work-shape.md)): Choose the right structure for new work by separating uncertainty, one-shot execution, multi-step arcs, and recurring patterns.
-- `ghostpaw-questlog skill clarify-ambiguous-requests` ([clarify-ambiguous-requests](references/clarify-ambiguous-requests.md)): Treat ambiguity as a real state, capture uncertainty honestly, and only commit work structure once the next executable shape is clear.
-- `ghostpaw-questlog skill close-work-and-claim-outcomes` ([close-work-and-claim-outcomes](references/close-work-and-claim-outcomes.md)): Close work with the correct terminal lifecycle action, then handle any concrete reward claim as a separate explicit step.
-- `ghostpaw-questlog skill create-concrete-quest` ([create-concrete-quest](references/create-concrete-quest.md)): Create real, bounded executable quests only when the objective is concrete enough to execute without interpretive guesswork.
-- `ghostpaw-questlog skill detect-slips-and-staleness` ([detect-slips-and-staleness](references/detect-slips-and-staleness.md)): Detect work that is slipping or going stale by reading overdue, deferred, in-progress, and related operational views before choosing one recovery move.
-- `ghostpaw-questlog skill escalate-and-unblock` ([escalate-and-unblock](references/escalate-and-unblock.md)): Diagnose blockers honestly, then remove or realign hard gates when the model is wrong instead of treating every delay as generic escalation theater.
-- `ghostpaw-questlog skill frame-initiative-questline` ([frame-initiative-questline](references/frame-initiative-questline.md)): Use questlines for shared initiative context, then attach concrete quests and maintain the structure without confusing one quest with one arc.
-- `ghostpaw-questlog skill handle-exceptions-and-weird-cases` ([handle-exceptions-and-weird-cases](references/handle-exceptions-and-weird-cases.md)): Handle weird cases by diagnosing the actual tool outcome, routing into clarification or recovery when needed, and refusing to fake a clean normal-state story.
-- `ghostpaw-questlog skill intake-triage` ([intake-triage](references/intake-triage.md)): Triage new asks, ideas, and vague incoming work into the right next step without prematurely committing execution structure.
-- `ghostpaw-questlog skill maintain-clear-ownership` ([maintain-clear-ownership](references/maintain-clear-ownership.md)): Keep ownership explicit through quest content and classification because Questlog does not provide a separate assignee field or ownership tool.
-- `ghostpaw-questlog skill manage-approvals-and-promises` ([manage-approvals-and-promises](references/manage-approvals-and-promises.md)): Treat approvals and commitments as modeled work with timing and dependencies instead of burying them as vague narrative promises.
-- `ghostpaw-questlog skill plan-successor-work` ([plan-successor-work](references/plan-successor-work.md)): Create explicit successor work after closure by spawning follow-ups or shaping new work, while keeping uncertain next steps in intake instead of faking certainty.
-- `ghostpaw-questlog skill plan-time-correctly` ([plan-time-correctly](references/plan-time-correctly.md)): Use quest planning fields honestly so availability, due pressure, and schedule intent stay meaningful instead of getting collapsed into one generic date.
-- `ghostpaw-questlog skill prioritize-across-streams` ([prioritize-across-streams](references/prioritize-across-streams.md)): Prioritize across competing work streams by reading real candidate sets, distinguishing available from blocked work, and then reflecting the choice in planning.
-- `ghostpaw-questlog skill protect-capacity-and-focus` ([protect-capacity-and-focus](references/protect-capacity-and-focus.md)): Protect capacity and focus by reading the real in-progress and scheduled-now load, then using planning to rebalance instead of silently overcommitting.
-- `ghostpaw-questlog skill recover-from-modeling-mistakes` ([recover-from-modeling-mistakes](references/recover-from-modeling-mistakes.md)): Recover from modeling mistakes by diagnosing the exact current state first, then applying the smallest honest corrective tool instead of rewriting history blindly.
-- `ghostpaw-questlog skill report-status-and-manage-expectations` ([report-status-and-manage-expectations](references/report-status-and-manage-expectations.md)): Build status reporting from the real questlog state, separating available, blocked, in-progress, slipping, and resolved work without relying on memory.
-- `ghostpaw-questlog skill revise-or-reshape-commitment` ([revise-or-reshape-commitment](references/revise-or-reshape-commitment.md)): Revise a quest objective before execution starts, but reshape commitments honestly with lifecycle tools once real execution history exists.
-- `ghostpaw-questlog skill run-operational-review` ([run-operational-review](references/run-operational-review.md)): Drive daily or weekly operational review from structured list views, then move from diagnosis into actual planning or execution changes.
-- `ghostpaw-questlog skill run-recurring-rhythms` ([run-recurring-rhythms](references/run-recurring-rhythms.md)): Model recurring work as repeatable definitions that spawn fresh concrete quests over time instead of living forever as one immortal task.
-- `ghostpaw-questlog skill search-and-retrieve-context` ([search-and-retrieve-context](references/search-and-retrieve-context.md)): Find relevant questlog context quickly, then switch from discovery to exact inspection without confusing free-text search with structured review surfaces.
-- `ghostpaw-questlog skill sequence-with-unlocks` ([sequence-with-unlocks](references/sequence-with-unlocks.md)): Model hard sequencing with unlocks between concrete quests so blocked and available work stay truthful and reviewable.
-- `ghostpaw-questlog skill settle-rumor-into-structure` ([settle-rumor-into-structure](references/settle-rumor-into-structure.md)): Turn a ready rumor into committed quest or questline structure without losing provenance or pretending vague intake is settled.
-- `ghostpaw-questlog skill tag-and-filter-portfolios` ([tag-and-filter-portfolios](references/tag-and-filter-portfolios.md)): Use tags for cross-cutting classification and portfolio filtering without confusing tags for status, timing, or dependency modeling.
+- `ghostpaw-questlog skill webhooks`: Configure signed outbound event webhooks and verify deliveries.
+- `ghostpaw-questlog skill archive-delete-and-prune`: Choose the right retirement action for each kind of work so history stays honest and hiding does not get confused with archival or terminal execution truth.
+- `ghostpaw-questlog skill choose-work-shape`: Choose the right structure for new work by separating uncertainty, one-shot execution, multi-step arcs, and recurring patterns.
+- `ghostpaw-questlog skill clarify-ambiguous-requests`: Treat ambiguity as a real state, capture uncertainty honestly, and only commit work structure once the next executable shape is clear.
+- `ghostpaw-questlog skill close-work-and-claim-outcomes`: Close work with the correct terminal lifecycle action, then handle any concrete reward claim as a separate explicit step.
+- `ghostpaw-questlog skill create-concrete-quest`: Create real, bounded executable quests only when the objective is concrete enough to execute without interpretive guesswork.
+- `ghostpaw-questlog skill detect-slips-and-staleness`: Detect work that is slipping or going stale by reading overdue, deferred, in-progress, and related operational views before choosing one recovery move.
+- `ghostpaw-questlog skill escalate-and-unblock`: Diagnose blockers honestly, then remove or realign hard gates when the model is wrong instead of treating every delay as generic escalation theater.
+- `ghostpaw-questlog skill frame-initiative-questline`: Use questlines for shared initiative context, then attach concrete quests and maintain the structure without confusing one quest with one arc.
+- `ghostpaw-questlog skill handle-exceptions-and-weird-cases`: Handle weird cases by diagnosing the actual tool outcome, routing into clarification or recovery when needed, and refusing to fake a clean normal-state story.
+- `ghostpaw-questlog skill intake-triage`: Triage new asks, ideas, and vague incoming work into the right next step without prematurely committing execution structure.
+- `ghostpaw-questlog skill maintain-clear-ownership`: Keep ownership explicit through quest content and classification because Questlog does not provide a separate assignee field or ownership tool.
+- `ghostpaw-questlog skill manage-approvals-and-promises`: Treat approvals and commitments as modeled work with timing and dependencies instead of burying them as vague narrative promises.
+- `ghostpaw-questlog skill plan-successor-work`: Create explicit successor work after closure by spawning follow-ups or shaping new work, while keeping uncertain next steps in intake instead of faking certainty.
+- `ghostpaw-questlog skill plan-time-correctly`: Use quest planning fields honestly so availability, due pressure, and schedule intent stay meaningful instead of getting collapsed into one generic date.
+- `ghostpaw-questlog skill prioritize-across-streams`: Prioritize across competing work streams by reading real candidate sets, distinguishing available from blocked work, and then reflecting the choice in planning.
+- `ghostpaw-questlog skill protect-capacity-and-focus`: Protect capacity and focus by reading the real in-progress and scheduled-now load, then using planning to rebalance instead of silently overcommitting.
+- `ghostpaw-questlog skill recover-from-modeling-mistakes`: Recover from modeling mistakes by diagnosing the exact current state first, then applying the smallest honest corrective tool instead of rewriting history blindly.
+- `ghostpaw-questlog skill report-status-and-manage-expectations`: Build status reporting from the real questlog state, separating available, blocked, in-progress, slipping, and resolved work without relying on memory.
+- `ghostpaw-questlog skill revise-or-reshape-commitment`: Revise a quest objective before execution starts, but reshape commitments honestly with lifecycle tools once real execution history exists.
+- `ghostpaw-questlog skill run-operational-review`: Drive daily or weekly operational review from structured list views, then move from diagnosis into actual planning or execution changes.
+- `ghostpaw-questlog skill run-recurring-rhythms`: Model recurring work as repeatable definitions that spawn fresh concrete quests over time instead of living forever as one immortal task.
+- `ghostpaw-questlog skill search-and-retrieve-context`: Find relevant questlog context quickly, then switch from discovery to exact inspection without confusing free-text search with structured review surfaces.
+- `ghostpaw-questlog skill sequence-with-unlocks`: Model hard sequencing with unlocks between concrete quests so blocked and available work stay truthful and reviewable.
+- `ghostpaw-questlog skill settle-rumor-into-structure`: Turn a ready rumor into committed quest or questline structure without losing provenance or pretending vague intake is settled.
+- `ghostpaw-questlog skill tag-and-filter-portfolios`: Use tags for cross-cutting classification and portfolio filtering without confusing tags for status, timing, or dependency modeling.
 
 ### Principles
 

package/skills/questlog/references/webhooks.md

@@ -0,0 +1,94 @@
+# Webhooks
+
+Use `questlog` to configure opt-in outbound automation. No server or scheduler is added.
+No targets means no network calls. `manage_hooks` supports list, remove, tick with
+`dry_run`, and deliveries; add/test are CLI-only. `review_questlog` view `deliveries`
+and `questlog show <id>` expose pending/failed deliveries.
+
+```sh
+questlog hook add https://example.org/wake --min-gap 60
+questlog hook add https://example.org/team --tag work --events quest.due,quest.overdue --secret-stdin
+questlog hook label work
+questlog hook list
+questlog tick --dry-run
+questlog tick
+questlog watch --interval 60
+questlog hook test 1
+questlog review deliveries
+questlog show 12
+questlog hook remove 1
+```
+
+`hook add` prints its random 32-byte signing secret once, also as `secret` in `--json`.
+Save it securely. `--secret-stdin` supplies one via stdin; there is no secret flag.
+Secrets and custom header values are stored in the DB. New POSIX DB/WAL/SHM files use 0600 and created directories use 0700; existing DB modes are preserved. Windows uses existing access controls.
+Use repeatable `--header "Name: value"` or `--header-stdin` (one line per header, avoiding shell history). Headers are sent on every delivery and test; output shows names with `***` values. HTTP token names are required; host, content-length, content-type, and x-questlog-* are reserved. Change headers by removing and adding the hook again. Use --header-stdin and --secret-stdin separately. URL userinfo is rejected; use a custom header or query key.
+`questlog show d_…` displays delivery status, attempts, HTTP status, next attempt, redacted target URL and event ids. Text is the default; --json prints JSON. Missing hook remove/test targets exit 3; missing quests/deliveries exit 1. hook label names the database.
+List output redacts userinfo/query strings. Removal deletes the target and deliveries.
+Default scope is the database; `--tag` matches quest tags, never rumors.
+`--events` defaults to all types. The DB label defaults to the filename without its
+path/extension (`questlog` in memory); set it to a name suitable for disclosure.
+
+```cron
+* * * * * questlog tick
+```
+
+Cron's PATH may need `$HOME/.local/bin/questlog tick --db /path/to/quests.db`.
+Watch defaults to 60 seconds (minimum 5); SIGINT/SIGTERM finishes the current tick.
+Tick exits 0 even when deliveries need retries. Dry-run records nothing and sends nothing.
+
+Events are detected from the model at tick time:
+
+- `quest.due`: an unresolved, undeleted quest reaches its effective due time (own `due_at`, otherwise its undeleted questline's due time).
+- `quest.overdue`: that effective deadline is strictly earlier than now and the quest remains unresolved.
+- `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.
+- `repeatable.spawned`: a concrete repeatable instance was created; occurrence time is its creation time. Tick first materializes due anchors through the existing spawn operation.
+- `rumor.captured`: an undeleted rumor was created; occurrence time is its creation time, even if subsequently settled or dismissed.
+
+Persistent event keys contain type, entity ids, and occurrence time. Restarts and repeated
+ticks do not repeat occurrences. Removed transitions between ticks cannot be reconstructed.
+Only occurrences at/after target creation are assigned; tags are evaluated at assignment.
+Tick materializes due repeatables using the existing spawn path, including during preview
+with rollback. Batches contain only ids, event types, timestamps, and the DB label:
+
+```json
+{"type":"questlog.events","db":"work","deliveryId":"d_…","sentAt":"2026-10-28T10:00:00.000Z","events":[{"id":"e_…","type":"quest.due","questId":12,"occurredAt":"2026-10-28T09:59:00.000Z"}]}
+```
+
+Headers are `content-type: application/json`, `user-agent: questlog/<version>`,
+`x-questlog-delivery: <deliveryId>`, `x-questlog-timestamp: <unix seconds>`, and
+`x-questlog-signature: sha256=<hex HMAC-SHA256(secret, timestamp + "." + rawBody)>`.
+No titles, objectives, details, or tag text are sent. `hook test` sends a logged `hook.test`
+event immediately, ignoring the min gap. Add and test are CLI-only in the tool facade;
+`manage_hooks` supports list, remove, tick (with `dry_run`), and deliveries.
+
+2xx delivers. Timeout is 5 seconds. Failures retry after 30 s, 1 m, 2 m, 4 m, doubling
+to 1 h plus <1 s jitter, subject to the target's min gap. Eight failures mark failed.
+Retries keep the delivery id/events; new events queue behind them. Keep the last 500
+delivered log entries per target and all pending/failed entries. Transactional claims
+lease work for two minutes. A crash after receipt may retry: dedupe at the receiver.
+
+### Verifying a delivery
+
+Compute HMAC-SHA256 over `timestamp + "." + rawBody` with the secret and compare in constant
+time. Reject timestamps older than 5 minutes (and timestamps too far in the future), then
+dedupe on `x-questlog-delivery`. Use durable deduplication storage in a production receiver.
+This 15-line Node example uses an in-memory set:
+
+```js
+import { createHmac, timingSafeEqual } from 'node:crypto';
+import { createServer } from 'node:http';
+const secret = process.env.WEBHOOK_SECRET, seen = new Set();
+createServer(async (req, res) => {
+  const chunks = []; for await (const chunk of req) chunks.push(chunk);
+  const rawBody = Buffer.concat(chunks), h = req.headers;
+  const timestamp = h['x-questlog-timestamp'], id = h['x-questlog-delivery'];
+  const age = Date.now() / 1000 - Number(timestamp);
+  const expected = createHmac('sha256', secret).update(timestamp + '.').update(rawBody).digest();
+  const signature = String(h['x-questlog-signature'] || '');
+  const actual = Buffer.from(signature.slice(7), 'hex');
+  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; }
+  if (!seen.has(id)) { seen.add(id); console.log(JSON.parse(rawBody)); }
+  res.writeHead(204).end();
+}).listen(8080, '127.0.0.1');
+```

package/dist/open_questlog_db-SH3DAU4C.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export { openQuestlogDb } from './chunk-3B6FMHZU.js';