@ghostpaw/questlog 0.7.0 → 0.8.0

package/README.md

@@ -81,7 +81,7 @@ ghostpaw-questlog list --view quests.resolved --json
 `list` defaults to available quests; `list --help` lists all supported views.
 Its `--limit` caps text output; JSON preserves the full review tool result.
 `search --limit` caps matches in both formats. `show` inspects a quest id.
-`done` requires `--outcome`, the written result stored with the finished quest.
+`done` stores `--outcome` with the finished quest; without it the command asks for one and exits 3.
 
 Plain commands print short text by default. Use `--json` for the full tool result
 and `--compact` for compact JSON. `--db path` works before or after the command.
@@ -110,11 +110,79 @@ npx -y @ghostpaw/questlog skill > SKILL.md
 
 ## Install
 
-```bash
-npm install @ghostpaw/questlog
+The [npm package](https://www.npmjs.com/package/@ghostpaw/questlog) requires Node 24+:
+
+```sh
+npm install -g @ghostpaw/questlog
+npx -y @ghostpaw/questlog --help
+```
+
+As a library dependency: `npm install @ghostpaw/questlog`. It uses the built-in
+`node:sqlite` module, so there are no runtime dependencies.
+
+Standalone binaries are available from [GitHub Releases](https://github.com/GhostPawJS/questlog/releases)
+for linux-x64, linux-arm64, darwin-arm64, darwin-x64 and windows-x64.
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh
+```
+
+```powershell
+irm https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.ps1 | iex
+```
+
+Other release installers:
+
+```sh
+mise use -g github:GhostPawJS/questlog
+ubi --project GhostPawJS/questlog --exe ghostpaw-questlog --in ~/.local/bin
+eget GhostPawJS/questlog
+```
+
+For [aqua](https://aquaproj.github.io/docs/reference/registry-config/), define a
+`github_release` package in `aqua.yaml`:
+
+```yaml
+registries:
+  - name: questlog
+    type: local
+    path: questlog-registry.yaml
+packages:
+  - name: GhostPawJS/questlog@v0.8.0
+    registry: questlog
+```
+
+`questlog-registry.yaml`:
+
+```yaml
+packages:
+  - type: github_release
+    repo_owner: GhostPawJS
+    repo_name: questlog
+    asset: ghostpaw-questlog-{{trimV .Version}}-{{.OS}}-{{.Arch}}.tar.gz
+    format: tar.gz
+    replacements: { amd64: x64 }
+    overrides:
+      - goos: windows
+        asset: ghostpaw-questlog-{{trimV .Version}}-windows-{{.Arch}}.zip
+        format: zip
+    files:
+      - name: ghostpaw-questlog
+```
+
+Install scripts verify SHA256SUMS. To verify a downloaded archive's
+[build attestation](https://cli.github.com/manual/gh_attestation_verify):
+
+```sh
+gh attestation verify <archive> -R GhostPawJS/questlog
 ```
 
-Requires **Node.js 24+** (uses the built-in `node:sqlite` module).
+Set `GHOSTPAW_VERIFY=attestation` for attestation verification in `install.sh`.
+Binaries are unsigned; macOS binaries carry an ad-hoc signature. For a browser
+download on macOS, remove quarantine with
+`xattr -d com.apple.quarantine /path/to/ghostpaw-questlog`.
+Linux binaries require glibc 2.28+; use npx on Alpine.
+See the [binary build workflow](.github/workflows/release-binaries.yml).
 
 ## Quick Start
 

package/dist/cli.js

@@ -13,6 +13,14 @@ var __export = (target, all) => {
     __defProp(target, name, { get: all[name], enumerable: true });
 };
 
+// src/version.ts
+var questlogVersion;
+var init_version = __esm({
+  "src/version.ts"() {
+    questlogVersion = "0.8.0";
+  }
+});
+
 // src/questlines/map_questline_row.ts
 function mapQuestlineRow(row) {
   return {
@@ -3935,6 +3943,16 @@ var init_reward_work_tool = __esm({
 function runQuestToolHandler(db, input) {
   try {
     const current = getQuestDetail(db, input.questId);
+    if (input.action !== "start" && input.action !== "log_effort") {
+      const outcome = input.outcome;
+      if (typeof outcome !== "string") {
+        return toolNeedsClarification(
+          "missing_required_choice",
+          `What outcome should be recorded for quest \`${current.title}\`?`,
+          ["outcome"]
+        );
+      }
+    }
     switch (input.action) {
       case "start": {
         if (current.resolvedAt != null) {
@@ -5173,68 +5191,6 @@ var init_questlog_surface_tools = __esm({
   }
 });
 
-// src/surfaces/surface_types.ts
-function isErrorResult(result) {
-  return typeof result === "object" && result !== null && "ok" in result && result.ok === false;
-}
-var init_surface_types = __esm({
-  "src/surfaces/surface_types.ts"() {
-  }
-});
-
-// 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)}`);
-  if (schema.oneOf && !schema.oneOf.some((branch) => validateInput(branch, input, path).length === 0))
-    errors.push(`${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 ?? [])
-      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;
-}
-var init_validate_input = __esm({
-  "src/surfaces/validate_input.ts"() {
-  }
-});
-
-// src/version.ts
-var questlogVersion;
-var init_version = __esm({
-  "src/version.ts"() {
-    questlogVersion = "0.7.0";
-  }
-});
-
 // src/questlines/init_questline_tables.ts
 function initQuestlineTables(db) {
   db.exec(`
@@ -5685,6 +5641,60 @@ var init_resolve_questlog_db_path = __esm({
   }
 });
 
+// src/surfaces/surface_types.ts
+function isErrorResult(result) {
+  return typeof result === "object" && result !== null && "ok" in result && result.ok === false;
+}
+var init_surface_types = __esm({
+  "src/surfaces/surface_types.ts"() {
+  }
+});
+
+// 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)}`);
+  if (schema.oneOf && !schema.oneOf.some((branch) => validateInput(branch, input, path).length === 0))
+    errors.push(`${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 ?? [])
+      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;
+}
+var init_validate_input = __esm({
+  "src/surfaces/validate_input.ts"() {
+  }
+});
+
 // src/surfaces/mcp_server.ts
 function createMcpServer(options) {
   let initialized = false;
@@ -6995,6 +7005,9 @@ var init_questlog_skill_spec = __esm({
     };
   }
 });
+
+// src/surface/questlog_cli_options.ts
+init_version();
 var CliUsageError = class extends Error {
   exitCode = 2;
 };
@@ -7117,8 +7130,10 @@ function renderQuestlogPlainResult(result, db, values) {
     ].filter((v) => v != null).join(" ").replace(/[\r\n]+/g, " ");
   };
   if (!r.ok)
-    return `${r.summary}
-${r.outcome === "needs_clarification" ? r.clarification.question : r.error.message}
+    return r.outcome === "needs_clarification" ? `${r.clarification.question}
+Missing: ${r.clarification.missing.map((name) => `--${name}`).join(", ")}
+` : `${r.summary}
+${r.error.message}
 `;
   if (r.data.items) {
     const items = values.limit === void 0 ? r.data.items : r.data.items.slice(0, Math.max(0, Number(values.limit)));
@@ -7195,8 +7210,7 @@ function questlogPlainCommands() {
           {
             name: "outcome",
             type: "string",
-            required: true,
-            description: "What the finished quest produced."
+            description: "What the finished quest produced; asked for when omitted."
           }
         ]
       },
@@ -7204,7 +7218,7 @@ function questlogPlainCommands() {
       input: (v) => ({
         action: "finish",
         questId: v.id,
-        outcome: v.outcome
+        ...v.outcome === void 0 ? {} : { outcome: v.outcome }
       }),
       render: renderQuestlogPlainResult
     },
@@ -7240,8 +7254,34 @@ function questlogPlainCommands() {
   }));
 }
 
-// src/cli.ts
+// src/surface/questlog_cli_options.ts
 init_questlog_surface_tools();
+var questlogCliOptions = {
+  bin: "ghostpaw-questlog",
+  version: questlogVersion,
+  description: "Local task and calendar library",
+  tools: questlogSurfaceTools,
+  openContext: async (options) => {
+    const { openQuestlogDb: openQuestlogDb2 } = await Promise.resolve().then(() => (init_open_questlog_db(), open_questlog_db_exports));
+    const { resolveQuestlogDbPath: resolveQuestlogDbPath2 } = await Promise.resolve().then(() => (init_resolve_questlog_db_path(), resolve_questlog_db_path_exports));
+    return openQuestlogDb2(
+      resolveQuestlogDbPath2(options.db === void 0 ? {} : { flag: options.db })
+    );
+  },
+  closeContext: (db) => db.close(),
+  commands: {
+    plain: questlogPlainCommands(),
+    mcp: async (options) => {
+      const { serveQuestlogMcp: serveQuestlogMcp2 } = await Promise.resolve().then(() => (init_serve_questlog_mcp(), serve_questlog_mcp_exports));
+      await serveQuestlogMcp2(options.db === void 0 ? {} : { dbPath: options.db });
+    },
+    skill: async () => {
+      const { renderSkillMarkdown: renderSkillMarkdown2 } = await Promise.resolve().then(() => (init_skill_markdown(), skill_markdown_exports));
+      const { questlogSkillSpec: questlogSkillSpec2 } = await Promise.resolve().then(() => (init_questlog_skill_spec(), questlog_skill_spec_exports));
+      return renderSkillMarkdown2(questlogSkillSpec2);
+    }
+  }
+};
 
 // src/surfaces/cli.ts
 init_surface_types();
@@ -7445,30 +7485,4 @@ ${JSON.stringify(tool.inputSchema, null, 2)}
 }
 
 // src/cli.ts
-init_version();
-process.exitCode = await runToolCli(process.argv.slice(2), {
-  bin: "ghostpaw-questlog",
-  version: questlogVersion,
-  description: "Local task and calendar library",
-  tools: questlogSurfaceTools,
-  openContext: async (options) => {
-    const { openQuestlogDb: openQuestlogDb2 } = await Promise.resolve().then(() => (init_open_questlog_db(), open_questlog_db_exports));
-    const { resolveQuestlogDbPath: resolveQuestlogDbPath2 } = await Promise.resolve().then(() => (init_resolve_questlog_db_path(), resolve_questlog_db_path_exports));
-    return openQuestlogDb2(
-      resolveQuestlogDbPath2(options.db === void 0 ? {} : { flag: options.db })
-    );
-  },
-  closeContext: (db) => db.close(),
-  commands: {
-    plain: questlogPlainCommands(),
-    mcp: async (options) => {
-      const { serveQuestlogMcp: serveQuestlogMcp2 } = await Promise.resolve().then(() => (init_serve_questlog_mcp(), serve_questlog_mcp_exports));
-      await serveQuestlogMcp2(options.db === void 0 ? {} : { dbPath: options.db });
-    },
-    skill: async () => {
-      const { renderSkillMarkdown: renderSkillMarkdown2 } = await Promise.resolve().then(() => (init_skill_markdown(), skill_markdown_exports));
-      const { questlogSkillSpec: questlogSkillSpec2 } = await Promise.resolve().then(() => (init_questlog_skill_spec(), questlog_skill_spec_exports));
-      return renderSkillMarkdown2(questlogSkillSpec2);
-    }
-  }
-});
+process.exitCode = await runToolCli(process.argv.slice(2), questlogCliOptions);

package/dist/index.cjs

@@ -4743,6 +4743,16 @@ var rewardWorkTool = defineQuestlogTool({
 function runQuestToolHandler(db, input) {
   try {
     const current = getQuestDetail(db, input.questId);
+    if (input.action !== "start" && input.action !== "log_effort") {
+      const outcome = input.outcome;
+      if (typeof outcome !== "string") {
+        return toolNeedsClarification(
+          "missing_required_choice",
+          `What outcome should be recorded for quest \`${current.title}\`?`,
+          ["outcome"]
+        );
+      }
+    }
     switch (input.action) {
       case "start": {
         if (current.resolvedAt != null) {

package/dist/index.js

@@ -4741,6 +4741,16 @@ var rewardWorkTool = defineQuestlogTool({
 function runQuestToolHandler(db, input) {
   try {
     const current = getQuestDetail(db, input.questId);
+    if (input.action !== "start" && input.action !== "log_effort") {
+      const outcome = input.outcome;
+      if (typeof outcome !== "string") {
+        return toolNeedsClarification(
+          "missing_required_choice",
+          `What outcome should be recorded for quest \`${current.title}\`?`,
+          ["outcome"]
+        );
+      }
+    }
     switch (input.action) {
       case "start": {
         if (current.resolvedAt != null) {

package/dist/mcp-server.js

@@ -677,7 +677,7 @@ var init_open_questlog_db = __esm({
 var questlogVersion;
 var init_version = __esm({
   "src/version.ts"() {
-    questlogVersion = "0.7.0";
+    questlogVersion = "0.8.0";
   }
 });
 
@@ -4611,6 +4611,16 @@ var init_reward_work_tool = __esm({
 function runQuestToolHandler(db, input) {
   try {
     const current = getQuestDetail(db, input.questId);
+    if (input.action !== "start" && input.action !== "log_effort") {
+      const outcome = input.outcome;
+      if (typeof outcome !== "string") {
+        return toolNeedsClarification(
+          "missing_required_choice",
+          `What outcome should be recorded for quest \`${current.title}\`?`,
+          ["outcome"]
+        );
+      }
+    }
     switch (input.action) {
       case "start": {
         if (current.resolvedAt != null) {

package/dist/mcp.cjs

@@ -386,7 +386,7 @@ async function openQuestlogDb(path) {
 }
 
 // src/version.ts
-var questlogVersion = "0.7.0";
+var questlogVersion = "0.8.0";
 
 // src/surface/questlog_mcp_instructions.ts
 var questlogMcpInstructions = "Questlog manages local tasks, calendar commitments, and recurring work. Search before creating work, inspect before changing it, and keep uncertain work as rumors. Use unlock prerequisites to sequence work. run_quest refuses blocked starts unless force is true. Review commitments and resolve work with an honest outcome.";
@@ -3599,6 +3599,16 @@ var rewardWorkTool = defineQuestlogTool({
 function runQuestToolHandler(db, input) {
   try {
     const current = getQuestDetail(db, input.questId);
+    if (input.action !== "start" && input.action !== "log_effort") {
+      const outcome = input.outcome;
+      if (typeof outcome !== "string") {
+        return toolNeedsClarification(
+          "missing_required_choice",
+          `What outcome should be recorded for quest \`${current.title}\`?`,
+          ["outcome"]
+        );
+      }
+    }
     switch (input.action) {
       case "start": {
         if (current.resolvedAt != null) {

package/dist/mcp.js

@@ -384,7 +384,7 @@ async function openQuestlogDb(path) {
 }
 
 // src/version.ts
-var questlogVersion = "0.7.0";
+var questlogVersion = "0.8.0";
 
 // src/surface/questlog_mcp_instructions.ts
 var questlogMcpInstructions = "Questlog manages local tasks, calendar commitments, and recurring work. Search before creating work, inspect before changing it, and keep uncertain work as rumors. Use unlock prerequisites to sequence work. run_quest refuses blocked starts unless force is true. Review commitments and resolve work with an honest outcome.";
@@ -3597,6 +3597,16 @@ var rewardWorkTool = defineQuestlogTool({
 function runQuestToolHandler(db, input) {
   try {
     const current = getQuestDetail(db, input.questId);
+    if (input.action !== "start" && input.action !== "log_effort") {
+      const outcome = input.outcome;
+      if (typeof outcome !== "string") {
+        return toolNeedsClarification(
+          "missing_required_choice",
+          `What outcome should be recorded for quest \`${current.title}\`?`,
+          ["outcome"]
+        );
+      }
+    }
     switch (input.action) {
       case "start": {
         if (current.resolvedAt != null) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ghostpaw/questlog",
-	"version": "0.7.0",
+	"version": "0.8.0",
 	"description": "Unified task and calendar model for Node.js — SQLite, zero dependencies, with a built-in LLM tool facade",
 	"type": "module",
 	"exports": {
@@ -65,7 +65,10 @@
 		"check:api": "node scripts/guard/api.mjs",
 		"check:consumer": "node scripts/guard/consumer.mjs",
 		"check:startup": "node scripts/guard/startup.mjs",
-		"mcpb": "node scripts/mcpb/build.mjs"
+		"mcpb": "node scripts/mcpb/build.mjs",
+		"sea": "node scripts/sea/build.mjs",
+		"sea:smoke": "node scripts/sea/smoke.mjs",
+		"sea:bench": "node scripts/sea/bench.mjs"
 	},
 	"engines": {
 		"node": ">=24"