@ghostpaw/questlog 0.9.2 → 0.10.1

package/dist/{chunk-3B6FMHZU.js → chunk-ZHTX64KD.js}

@@ -2,6 +2,29 @@
 import { mkdirSync } from 'node:fs';
 import { dirname } from 'node:path';
 
+// 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(`
@@ -350,6 +373,7 @@ function initQuestlogTables(db) {
   initTagTables(db);
   initQuestSearch(db);
   initRumorSearch(db);
+  initHookTables(db);
 }
 
 // src/surface/open_questlog_db.ts

package/dist/cli.js

@@ -13,5 +13,5 @@ function checkNodeVersion(version, stderr) {
 if (!checkNodeVersion(process.versions.node, process.stderr)) {
   process.exitCode = 2;
 } else {
-  await import('./cli_main-XNZP4TY2.js');
+  await import('./cli_main-7AIEZV75.js');
 }

package/dist/{cli_main-XNZP4TY2.js → cli_main-7AIEZV75.js}

@@ -1,10 +1,12 @@
 #!/usr/bin/env node
-import { isErrorResult, questlogVersion, resolveQuestlogDbPath } from './chunk-DKH623HU.js';
-import { questlogSkills } from './chunk-6KTQK3ZE.js';
-import { reviewQuestlogTool, validateInput, getQuestDetail, questlogSurfaceTools } from './chunk-UTUQPSGO.js';
+import { CliUsageError, renderCliHelp, parseCliArgs } from './chunk-GVD6A3RR.js';
+import { isErrorResult, resolveQuestlogDbPath } from './chunk-IL2QRKZL.js';
+import { questlogSkills } from './chunk-D2W5MYNO.js';
+import { reviewQuestlogTool, validateInput, getQuestDetail, questlogSurfaceTools } from './chunk-55JAQORX.js';
+import { listDeliveries, questlogVersion } from './chunk-N7V7VUI5.js';
 import { minimalInput } from './chunk-QYSIJ2YN.js';
 import { isSea } from 'node:sea';
-import { readFileSync, existsSync } from 'node:fs';
+import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 
 var npmEntry = false;
@@ -15,7 +17,8 @@ function cliVersion(version, {
   sea = isSea,
   npm = npmEntry,
   platform = process.platform,
-  arch = process.arch
+  arch = process.arch,
+  args = []
 } = {}) {
   let binary = false;
   try {
@@ -23,111 +26,12 @@ function cliVersion(version, {
   } catch {
   }
   const target = `${platform === "win32" ? "windows" : platform}-${arch}`;
+  const variant = binary ? "binary" : npm ? "npm" : "library";
+  if (args.includes("--json"))
+    return JSON.stringify({ name: "questlog", version, variant, target });
+  if (args.includes("--short")) return version;
   return `questlog ${version} (${binary ? `binary, ${target}` : npm ? "npm" : "library"})`;
 }
-var CliUsageError = class extends Error {
-  exitCode = 2;
-};
-var keyOf = (name) => name.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-function parseCliArgs(argv, spec) {
-  const values = {};
-  const positions = [];
-  const flags = spec.flags ?? [];
-  const convert = (raw, arg) => {
-    let value = raw;
-    if (raw.startsWith("@")) {
-      try {
-        value = readFileSync(raw.slice(1), "utf8");
-      } catch {
-        throw new CliUsageError(`Cannot read value file: ${raw.slice(1)}`);
-      }
-    }
-    let result = value;
-    if (arg.type === "number" || arg.type === "integer") {
-      result = Number(value);
-      if (!value.trim() || !Number.isFinite(result) || arg.type === "integer" && !Number.isInteger(result))
-        throw new CliUsageError(`Expected ${arg.type} for ${arg.name}: ${value}`);
-    } else if (arg.type === "boolean") {
-      if (!["true", "false"].includes(value))
-        throw new CliUsageError(`Expected boolean for ${arg.name}`);
-      result = value === "true";
-    } else if (arg.type === "json") {
-      try {
-        result = JSON.parse(value);
-      } catch {
-        throw new CliUsageError(`Invalid JSON for ${arg.name}`);
-      }
-    }
-    if (arg.enum && !arg.enum.includes(result))
-      throw new CliUsageError(`${arg.name} must be one of: ${arg.enum.join(", ")}`);
-    return result;
-  };
-  let ended = false;
-  for (let i = 0; i < argv.length; i++) {
-    const token = argv[i];
-    if (!ended && token === "--") {
-      ended = true;
-      continue;
-    }
-    if (ended || token === "-" || !token.startsWith("-")) {
-      positions.push(token);
-      continue;
-    }
-    const [flag, inline] = token.split(/=(.*)/s);
-    const negative = flag?.startsWith("--no-");
-    const name = flag?.replace(/^--?/, "").replace(/^no-/, "");
-    const arg = flags.find(
-      (entry) => entry.name === name || keyOf(entry.name) === name || entry.short === name
-    );
-    if (!arg) {
-      const prefix = (name ?? "").slice(0, 3);
-      const suggestion = prefix ? flags.find((entry) => entry.name.startsWith(prefix)) : void 0;
-      throw new CliUsageError(
-        `Unknown flag: ${flag}${suggestion ? `; did you mean --${suggestion.name}?` : ""}`
-      );
-    }
-    if (negative && arg.type !== "boolean")
-      throw new CliUsageError(`--no-${arg.name} requires a boolean flag`);
-    let raw = inline;
-    if (arg.type === "boolean" && raw === void 0) raw = negative ? "false" : "true";
-    if (raw === void 0) {
-      const next = argv[i + 1];
-      if (next === void 0 || /^--[a-z]/i.test(next))
-        throw new CliUsageError(`Missing value: --${arg.name}`);
-      raw = next;
-      i++;
-    }
-    const key = keyOf(arg.name);
-    if (arg.type === "array") {
-      const item = convert(raw, { ...arg, type: arg.itemType ?? "string" });
-      values[key] = [...values[key] ?? [], item];
-    } else values[key] = convert(raw, arg);
-  }
-  let index = 0;
-  for (const arg of spec.positionals ?? []) {
-    if (index >= positions.length) continue;
-    values[keyOf(arg.name)] = arg.variadic ? positions.slice(index).map((value) => convert(value, { ...arg, type: arg.itemType ?? arg.type })) : convert(positions[index], arg);
-    index = arg.variadic ? positions.length : index + 1;
-  }
-  if (index < positions.length)
-    throw new CliUsageError(`Unexpected positional: ${positions[index]}`);
-  for (const arg of [...flags, ...spec.positionals ?? []]) {
-    if (arg.required && values[keyOf(arg.name)] === void 0)
-      throw new CliUsageError(`Missing required argument: ${arg.name}`);
-  }
-  return values;
-}
-function renderCliHelp(spec) {
-  const describe = (arg) => `${arg.type}${arg.enum ? ` (${arg.enum.join("|")})` : ""}${arg.required ? " required" : ""}  ${arg.description ?? ""}`;
-  return `Usage: ${spec.command} ${(spec.positionals ?? []).map((arg) => `<${arg.name}${arg.variadic ? "..." : ""}>`).join(" ")} [flags]
-${spec.description ?? ""}
-
-Positionals:
-${(spec.positionals ?? []).map((arg) => `  ${arg.name}  ${describe(arg)}`).join("\n")}
-Flags:
-${(spec.flags ?? []).map((arg) => `  --${arg.name}${arg.short ? `, -${arg.short}` : ""}  ${describe(arg)}`).join("\n")}
-`;
-}
 
 // src/surface/plain_dates.ts
 function parsePlainDue(raw, now = Date.now()) {
@@ -210,6 +114,8 @@ function renderQuestlogPlainResult(result, db, values) {
 Missing: ${r.clarification.missing.map((name) => `--${name}`).join(", ")}
 ` : `${r.summary}
 ${r.error.message}
+`;
+  if (r.data.deliveries && !r.data.item) return `${JSON.stringify(r.data.deliveries, null, 2)}
 `;
   if (r.data.items) {
     const items = values.limit === void 0 ? r.data.items : r.data.items.slice(0, Math.max(0, Number(values.limit)));
@@ -235,6 +141,11 @@ ${r.error.message}
       ]);
     if (detail.outcome != null) fields.push(["outcome", detail.outcome]);
     if (detail.questlineId != null) fields.push(["questline", detail.questlineId]);
+    for (const delivery of listDeliveries(db, { questId: detail.id }))
+      fields.push([
+        "delivery",
+        `${delivery.id} target ${delivery.targetId} ${delivery.status} attempts ${delivery.attempts}`
+      ]);
     const width = Math.max(...fields.map(([label]) => label.length));
     return `${fields.map(([label, value]) => `${label.padEnd(width)}: ${String(value).replace(/[\r\n]+/g, " ")}`).join("\n")}
 `;
@@ -258,6 +169,34 @@ function questlogPlainCommands() {
   const id = { name: "id", type: "integer", required: true };
   const views = reviewQuestlogTool.inputSchema.properties?.view?.enum ?? [];
   const commands = [
+    {
+      spec: {
+        command: "tick",
+        description: "Detect events and deliver outbound webhooks once.",
+        flags: [{ name: "dry-run", type: "boolean" }]
+      },
+      tool: "manage_hooks",
+      input: (v) => ({ action: "tick", dry_run: v.dryRun ?? false }),
+      render: (r, _db, values) => {
+        const result = r;
+        if (!result.ok || !result.data) return `${result.summary}
+`;
+        const d = result.data;
+        return `${d.events.length} events found; ${d.sent} deliveries sent, ${d.queued} queued, ${d.retrying} retrying, ${d.failed} failed.
+${values.dryRun ? `${JSON.stringify({ events: d.events, batches: d.batches }, null, 2)}
+` : ""}`;
+      }
+    },
+    {
+      spec: {
+        command: "review",
+        description: "Review an operational view.",
+        positionals: [{ name: "view", type: "string", required: true, enum: views }]
+      },
+      tool: "review_questlog",
+      input: (v) => ({ view: v.view }),
+      render: renderQuestlogPlainResult
+    },
     {
       spec: {
         command: "add",
@@ -370,13 +309,13 @@ function selectedDbPath(options) {
 var questlogCliOptions = {
   bin: "ghostpaw-questlog",
   version: questlogVersion,
-  versionLine: () => cliVersion(questlogVersion),
+  versionLine: (args) => cliVersion(questlogVersion, { args }),
   description: "Local task and calendar library",
   tools: questlogSurfaceTools,
   describeDb: (options) => `Database: ${selectedDbPath(options)}
 Use --db <path> or GHOSTPAW_QUESTLOG_DB to override the default ~/.ghostpaw/questlog.db.`,
   openContext: async (options) => {
-    const { openQuestlogDb } = await import('./open_questlog_db-SH3DAU4C.js');
+    const { openQuestlogDb } = await import('./open_questlog_db-LAEH7UDM.js');
     const path = selectedDbPath(options);
     const created = path !== ":memory:" && !existsSync(path);
     const db = await openQuestlogDb(path);
@@ -386,15 +325,24 @@ Use --db <path> or GHOSTPAW_QUESTLOG_DB to override the default ~/.ghostpaw/ques
   },
   closeContext: (db) => db.close(),
   commands: {
+    names: ["hook", "watch"],
+    run: async (command, args, options, io) => {
+      if (command !== "hook" && command !== "watch") return void 0;
+      const { runHookCommand } = await import('./run_hook_command-C42BQC36.js');
+      return runHookCommand(command, args, io, async () => {
+        const { openQuestlogDb } = await import('./open_questlog_db-LAEH7UDM.js');
+        return openQuestlogDb(selectedDbPath(options));
+      });
+    },
     plain: questlogPlainCommands(),
     guides: questlogSkills,
     mcp: async (options) => {
-      const { serveQuestlogMcp } = await import('./serve_questlog_mcp-KFUYJB2P.js');
+      const { serveQuestlogMcp } = await import('./serve_questlog_mcp-W3R63HW4.js');
       await serveQuestlogMcp(options.db === void 0 ? {} : { dbPath: options.db });
     },
     skill: async () => {
       const { renderSkillMarkdown } = await import('./skill_markdown-HXYQ3K6U.js');
-      const { questlogSkillSpec } = await import('./questlog_skill_spec-EM6DGGVN.js');
+      const { questlogSkillSpec } = await import('./questlog_skill_spec-HEW2B6EB.js');
       return renderSkillMarkdown(questlogSkillSpec);
     }
   }
@@ -463,6 +411,12 @@ async function runToolCli(argv, options) {
       i--;
     }
   }
+  const versionArgs = args.filter((arg) => arg !== "--short" && arg !== "--json");
+  if (versionArgs[0] === "--version" || versionArgs[0] === "-v") {
+    stdout.write(`${options.versionLine?.(args) ?? options.version}
+`);
+    return 0;
+  }
   const ctxOptions = db === void 0 ? {} : { db };
   const command = args.shift() ?? "help";
   const normalize = (name2) => name2.replace(/[-_]/g, "").toLowerCase();
@@ -472,8 +426,14 @@ async function runToolCli(argv, options) {
 ${options.description}
 
 Usage: ${options.bin} [--db path] <command>
-Commands: ${options.commands?.plain?.map((entry) => entry.spec.command).join(", ") ?? ""}${options.commands?.plain?.length ? ", " : ""}tools [--json], describe <tool>, call <tool> [JSON|-], <tool> --parameter value, mcp, skill
+Commands: ${[
+        ...options.commands?.plain?.map((entry) => entry.spec.command) ?? [],
+        ...options.commands?.names ?? []
+      ].map((name2) => `${name2}, `).join(
+        ""
+      )}tools [--json], describe <tool>, call <tool> [JSON|-], <tool> --parameter value, mcp, skill
 Options: --help, --version, --compact, --db <path>
+Version formats: --version --short, --version --json
 ${options.describeDb ? `${options.describeDb(ctxOptions)}
 ` : ""}
 ${options.tools.map((tool2) => `${tool2.name}  ${tool2.description}`).join("\n")}
@@ -481,11 +441,6 @@ ${options.tools.map((tool2) => `${tool2.name}  ${tool2.description}`).join("\n")
     );
     return 0;
   }
-  if (["--version", "-v"].includes(command)) {
-    stdout.write(`${options.versionLine?.() ?? options.version}
-`);
-    return 0;
-  }
   if (command === "tools") {
     stdout.write(
       args.includes("--json") ? `${JSON.stringify(
@@ -527,6 +482,12 @@ ${options.tools.map((tool2) => `${tool2.name}  ${tool2.description}`).join("\n")
     await options.commands.mcp(ctxOptions);
     return 0;
   }
+  const custom = await options.commands?.run?.(command, args, ctxOptions, {
+    stdin,
+    stdout,
+    stderr
+  });
+  if (custom !== void 0) return custom;
   const plain = options.commands?.plain?.find((entry) => entry.spec.command === command);
   let plainValues = {};
   if (plain) {
@@ -556,6 +517,7 @@ ${options.tools.map((tool2) => `${tool2.name}  ${tool2.description}`).join("\n")
     if (command === "call" || command === "describe") return fail(`Unknown tool: ${name ?? ""}`);
     const suggestion = suggestCommand(command, [
       ...options.commands?.plain?.map((entry) => entry.spec.command) ?? [],
+      ...options.commands?.names ?? [],
       "help",
       "tools",
       "describe",