@ghostpaw/questlog 0.9.0 → 0.9.2

package/README.md

@@ -7,7 +7,7 @@
 **Agent tasks as quests that finish only with a written outcome.**
 
 ```bash
-npm install @ghostpaw/questlog
+curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh
 ```
 
 A unified task and calendar model for Node.js, built on SQLite.
@@ -16,14 +16,15 @@ Questlog treats tasks, events, deadlines, recurring commitments, and loose intak
 
 ## MCP server
 
-Every client below starts the same stdio server: `npx -y @ghostpaw/questlog mcp`.
+Every client below starts the same stdio server: `ghostpaw-questlog mcp`.
+For npm-based environments, use `npx -y @ghostpaw/questlog mcp` (Node 24+).
 Data lives in `~/.ghostpaw/questlog.db` unless the `GHOSTPAW_QUESTLOG_DB`
 environment variable (absolute path) or `--db <path>` says otherwise.
 
 **Claude Code**
 
 ```bash
-claude mcp add ghostpaw-questlog -- npx -y @ghostpaw/questlog mcp
+claude mcp add ghostpaw-questlog -- ghostpaw-questlog mcp
 ```
 
 or as a plugin, which also installs the skill:
@@ -37,8 +38,8 @@ or as a plugin, which also installs the skill:
 
 ```toml
 [mcp_servers.ghostpaw-questlog]
-command = "npx"
-args = ["-y", "@ghostpaw/questlog", "mcp"]
+command = "ghostpaw-questlog"
+args = ["mcp"]
 ```
 
 **Cursor** (`.cursor/mcp.json`), **Claude Desktop** (`claude_desktop_config.json`)
@@ -48,8 +49,8 @@ or a project `.mcp.json`:
 {
   "mcpServers": {
     "ghostpaw-questlog": {
-      "command": "npx",
-      "args": ["-y", "@ghostpaw/questlog", "mcp"]
+      "command": "ghostpaw-questlog",
+      "args": ["mcp"]
     }
   }
 }
@@ -65,10 +66,10 @@ initialize-based revisions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05.
 
 ## CLI
 
-Install globally for `questlog` (`ghostpaw-questlog` is the same binary): `npm i -g @ghostpaw/questlog`.
+Install the [release binary](#install) for `ghostpaw-questlog` (`questlog` is an alias).
 
 ```bash
-questlog add --title "Review release notes" --tag release --due 2030-01-02
+questlog add "Review release notes" --tag release --due 2030-01-02
 questlog list --limit 10
 questlog search release notes --limit 5
 questlog show 1
@@ -114,32 +115,58 @@ an installation hint on older Node versions, including for help and version.
 Copy `skills/questlog/` into your agent's skills folder, or print it:
 
 ```bash
-npx -y @ghostpaw/questlog skill > SKILL.md
+ghostpaw-questlog skill > SKILL.md
 ```
 
 ## Install
 
-The [npm package](https://www.npmjs.com/package/@ghostpaw/questlog) requires Node 24+:
+### Release binary (default)
+
+Each line downloads the latest release asset, checks it against the release’s SHA256SUMS and installs it on the PATH (~/.local/bin on Linux/macOS; the Windows script adds its folder to the user PATH).
+
+linux-x64:
 
 ```sh
-npm install -g @ghostpaw/questlog
-npx -y @ghostpaw/questlog --help
+curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh -s -- --target linux-x64 && export PATH="$HOME/.local/bin:$PATH"
+```
+
+linux-arm64:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh -s -- --target linux-arm64 && export PATH="$HOME/.local/bin:$PATH"
 ```
 
-As a library dependency: `npm install @ghostpaw/questlog`. It uses the built-in
-`node:sqlite` module, so there are no runtime dependencies.
+darwin-arm64:
 
-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 -s -- --target darwin-arm64 && export PATH="$HOME/.local/bin:$PATH"
+```
+
+darwin-x64:
 
 ```sh
-curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh
+curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh -s -- --target darwin-x64 && export PATH="$HOME/.local/bin:$PATH"
 ```
 
+windows-x64 (PowerShell):
+
 ```powershell
 irm https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.ps1 | iex
 ```
 
+```text
+$ ghostpaw-questlog --version
+questlog 0.9.2 (binary, linux-x64)
+```
+
+Standalone binaries are available from [GitHub Releases](https://github.com/GhostPawJS/questlog/releases).
+
+A session with the 0.9.1 linux-x64 binary against a fresh database:
+
+![questlog 0.9.1: --version, three add calls, list, search, done with an outcome, and show](https://raw.githubusercontent.com/GhostPawJS/questlog/main/docs/assets/cli.png)
+
+The same session as an [animated GIF](https://raw.githubusercontent.com/GhostPawJS/questlog/main/docs/assets/cli.gif).
+
 Other release installers:
 
 ```sh
@@ -193,6 +220,27 @@ download on macOS, remove quarantine with
 Linux binaries require glibc 2.28+; use npx on Alpine.
 See the [binary build workflow](.github/workflows/release-binaries.yml).
 
+### npx / npm (for npm-based environments)
+
+The [npm package](https://www.npmjs.com/package/@ghostpaw/questlog) requires Node 24+:
+
+```sh
+npx -y @ghostpaw/questlog --help
+npm install -g @ghostpaw/questlog
+```
+
+### Library (for harnesses embedding it in code)
+
+```sh
+npm install @ghostpaw/questlog
+```
+
+```ts
+import { initQuestlogTables, read, write } from '@ghostpaw/questlog';
+```
+
+See [library usage](#quick-start). The library uses built-in `node:sqlite` with zero runtime dependencies.
+
 ## Quick Start
 
 ```ts

package/SKILL.md

@@ -1,15 +1,34 @@
 ---
 name: questlog
-description: "Manage local tasks, calendar commitments, and recurring work. Use when planning, executing, reviewing, or organizing work."
+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"
-compatibility: "Node.js 24 or newer. MCP stdio or ghostpaw-questlog CLI."
+compatibility: "Release binary ghostpaw-questlog (no runtime needed); MCP stdio via ghostpaw-questlog mcp."
 ---
 
 # questlog
 
+## Install
+
+Linux/macOS:
+
+```sh
+curl -fsSL https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.sh | sh
+```
+
+Installs `~/.local/bin/ghostpaw-questlog` after checking SHA256SUMS.
+
+Windows x64 (PowerShell):
+
+```powershell
+irm https://raw.githubusercontent.com/GhostPawJS/questlog/main/install.ps1 | iex
+```
+
+Run tools as `ghostpaw-questlog ...`; use `~/.local/bin/ghostpaw-questlog` if it is not on PATH.
+
 `questlog` and `ghostpaw-questlog` are the same binary.
 
-- `questlog add --title "..." --tag a,b --due tomorrow`
+- `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>`
@@ -27,7 +46,7 @@ Questlog manages local tasks, calendar commitments, and recurring work. Search b
 
 MCP: connect to ghostpaw-questlog, then call a tool by name with its JSON arguments.
 
-CLI: `ghostpaw-questlog call <tool> '<JSON object>'` or `ghostpaw-questlog <tool> --parameter value` (without a global install: `npx -y @ghostpaw/questlog <tool> ...`).
+CLI: `ghostpaw-questlog call <tool> '<JSON object>'` or `ghostpaw-questlog <tool> --parameter value`.
 
 Inspect schemas with `ghostpaw-questlog describe <tool>`. Use `--db <path>` to select a database.
 
@@ -48,6 +67,10 @@ Read-only.
 | kinds | array | no | Optional entity kinds to search. |
 | mode | string | no | browse, identify_one. Whether to browse results normally or ask for clarification when several matches are found. |
 
+```sh
+ghostpaw-questlog call search_questlog '{"query":"release"}'
+```
+
 ### review_questlog
 
 Review one operational questlog surface such as available quests, open rumors, blocked work, or due repeatable anchors.
@@ -62,8 +85,16 @@ Read-only.
 | --- | --- | --- | --- |
 | 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. |
 | 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. |
+| filters.includeDeleted | boolean | no | Whether deleted quests should be included in quest views. |
+| filters.dayAt | integer | no | UTC timestamp within the day to review for scheduled-for-day. |
 | now | integer | no | Optional evaluation timestamp for time-sensitive views. |
 
+```sh
+ghostpaw-questlog call review_questlog '{"view":"questlines"}'
+```
+
 ### inspect_questlog_item
 
 Inspect one specific questlog item in depth and return its richer structured detail and important related refs.
@@ -77,9 +108,15 @@ Read-only.
 | Parameter | Type | Required | Values / description |
 | --- | --- | --- | --- |
 | target | object | yes | The specific item to inspect. |
+| target.kind | string | yes | quest, questline, repeatable_quest, rumor. The kind of item to inspect. |
+| target.id | integer | yes | The numeric id of the item to inspect. |
 | detailLevel | string | no | compact, full. How much detail to return. |
 | now | integer | no | Optional evaluation timestamp for time-sensitive detail. |
 
+```sh
+ghostpaw-questlog call inspect_questlog_item '{"target":{"kind":"quest","id":1}}'
+```
+
 ### capture_rumor
 
 Capture uncertain incoming work as a rumor so it can be triaged later without prematurely turning it into committed execution.
@@ -96,6 +133,10 @@ Writes: writes_state.
 | details | string | no | Optional supporting context that explains why the rumor might matter. |
 | now | integer | no | Optional creation timestamp for the rumor. |
 
+```sh
+ghostpaw-questlog call capture_rumor '{"title":"Review release notes"}'
+```
+
 ### shape_work
 
 Create a quest (with timing, tags, and objective in one call), create a questline, settle a rumor into concrete work, or manage quest-questline membership. Use create_quest for clear commitments — include tags and timing directly to avoid follow-up calls.
@@ -112,7 +153,11 @@ Writes: writes_state.
 | questId | integer | no | Quest to attach or detach. |
 | questlineId | integer | no | Questline that should receive the quest. |
 | quest | object | no |  |
+| quest.title | string | yes | Title for the new quest. |
+| quest.objective | string | yes | Objective for the new quest. |
 | questline | object | no |  |
+| 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. |
@@ -121,6 +166,12 @@ Writes: writes_state.
 | title | string | no | New title for the update_rumor action. |
 | details | string | no | New or enriched context text for the update_rumor action. |
 
+```sh
+ghostpaw-questlog call shape_work '{"action":"attach_quest_to_questline","questId":1,"questlineId":1}'
+ghostpaw-questlog call shape_work '{"action":"create_quest","quest":{"title":"Review release notes","objective":"Check changes against the release"}}'
+ghostpaw-questlog call shape_work '{"action":"create_questline","questline":{"title":"Review release notes"}}'
+```
+
 ### plan_quest
 
 Refine a quest by revising its objective before actual start or by changing its temporal planning fields.
@@ -144,6 +195,11 @@ Writes: writes_state.
 | estimateSeconds | integer | no | Optional active-effort estimate in seconds. |
 | now | integer | no | Optional update timestamp. |
 
+```sh
+ghostpaw-questlog call plan_quest '{"action":"revise_objective","questId":1,"objective":"Check changes against the release"}'
+ghostpaw-questlog call plan_quest '{"action":"set_time","questId":1}'
+```
+
 ### run_quest
 
 Run quest lifecycle actions such as starting, logging effort, finishing, abandoning, or abandoning and spawning follow-up quests atomically.
@@ -166,6 +222,12 @@ Writes: writes_state.
 | 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. |
 
+```sh
+ghostpaw-questlog call run_quest '{"action":"start","questId":1}'
+ghostpaw-questlog call run_quest '{"action":"log_effort","questId":1,"effortSeconds":1}'
+ghostpaw-questlog call run_quest '{"action":"finish","questId":1,"outcome":"release"}'
+```
+
 ### organize_work
 
 Organize grouping and dependency structure by updating questlines or changing hard unlock prerequisites between concrete quests.
@@ -190,6 +252,12 @@ Writes: writes_state.
 | fromQuestIds | array | no | Full prerequisite quest id set. |
 | now | integer | no | Optional timestamp. |
 
+```sh
+ghostpaw-questlog call organize_work '{"action":"add_unlock","fromQuestId":1,"toQuestId":2}'
+ghostpaw-questlog call organize_work '{"action":"archive_questline","questlineId":1}'
+ghostpaw-questlog call organize_work '{"action":"remove_unlock","fromQuestId":1,"toQuestId":2}'
+```
+
 ### manage_repeatable
 
 Manage recurring work definitions by creating, updating, previewing, spawning, or archiving repeatable quests.
@@ -205,6 +273,10 @@ 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.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. |
+| repeatableQuest.anchorAt | integer | yes | Recurrence anchor timestamp. |
 | title | string | no | Optional new title for the update action. |
 | objective | string | no | Optional new objective for the update action. |
 | questlineId | integer | no | Optional new questline id. |
@@ -219,6 +291,12 @@ Writes: writes_state.
 | archivedAt | integer | no | Optional archive timestamp. |
 | now | integer | no | Evaluation or update timestamp. |
 
+```sh
+ghostpaw-questlog call manage_repeatable '{"action":"archive","repeatableQuestId":1}'
+ghostpaw-questlog call manage_repeatable '{"action":"create","repeatableQuest":{"title":"Review release notes","objective":"Check changes against the release","rrule":"FREQ=WEEKLY","anchorAt":1800000000000}}'
+ghostpaw-questlog call manage_repeatable '{"action":"preview_due"}'
+```
+
 ### tag_work
 
 Classify work by adding, removing, or replacing tags on quests and by replacing the future tag template set on repeatable quests.
@@ -233,9 +311,17 @@ Writes: writes_state.
 | --- | --- | --- | --- |
 | action | string | yes | add, remove, replace. Action to perform. |
 | target | object | yes |  |
+| 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. |
 | now | integer | no | Optional timestamp for the tag mutation. |
 
+```sh
+ghostpaw-questlog call tag_work '{"action":"add","target":{"id":1,"kind":"quest"},"tagNames":["release"]}'
+ghostpaw-questlog call tag_work '{"action":"remove","target":{"id":1,"kind":"quest"},"tagNames":["release"]}'
+ghostpaw-questlog call tag_work '{"action":"replace","target":{"id":1,"kind":"quest"},"tagNames":["release"]}'
+```
+
 ### reward_work
 
 Manage rewards by adding, updating, removing, or claiming quest rewards, or by replacing future reward templates on repeatable quests.
@@ -250,11 +336,22 @@ Writes: writes_state.
 | --- | --- | --- | --- |
 | action | string | yes | add, claim, remove, replace_repeatable_template, update. Action to perform. |
 | target | object | yes |  |
+| target.id | integer | yes | Target entity id. |
+| target.kind | string | yes | quest, reward, repeatable_quest. Target kind. |
 | reward | object | no |  |
+| 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. |
 | claimedAt | integer | no | Optional claim timestamp. |
 | now | integer | no | Optional timestamp for removal or template replacement. |
 
+```sh
+ghostpaw-questlog call reward_work '{"action":"add","target":{"id":1,"kind":"quest"},"reward":{"kind":"release","name":"release"}}'
+ghostpaw-questlog call reward_work '{"action":"claim","target":{"id":1,"kind":"quest"}}'
+ghostpaw-questlog call reward_work '{"action":"remove","target":{"id":1,"kind":"quest"}}'
+```
+
 ### retire_work
 
 Hide an item from normal active operation without rewriting history by soft-deleting a rumor, quest, questline, or repeatable quest.
@@ -269,35 +366,41 @@ Writes: writes_state.
 | --- | --- | --- | --- |
 | action | string | yes | hide. The retirement action to perform. |
 | target | object | yes | The target to hide. |
+| target.kind | string | yes | quest, questline, repeatable_quest, rumor. The kind of item to hide. |
+| target.id | integer | yes | The numeric id of the item to hide. |
 | deletedAt | integer | no | Optional timestamp to record when the item became hidden. |
 
+```sh
+ghostpaw-questlog call retire_work '{"action":"hide","target":{"kind":"quest","id":1}}'
+```
+
 ### Workflow guides
 
-- [archive-delete-and-prune](skills/questlog/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.
-- [choose-work-shape](skills/questlog/references/choose-work-shape.md): Choose the right structure for new work by separating uncertainty, one-shot execution, multi-step arcs, and recurring patterns.
-- [clarify-ambiguous-requests](skills/questlog/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.
-- [close-work-and-claim-outcomes](skills/questlog/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.
-- [create-concrete-quest](skills/questlog/references/create-concrete-quest.md): Create real, bounded executable quests only when the objective is concrete enough to execute without interpretive guesswork.
-- [detect-slips-and-staleness](skills/questlog/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.
-- [escalate-and-unblock](skills/questlog/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.
-- [frame-initiative-questline](skills/questlog/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.
-- [handle-exceptions-and-weird-cases](skills/questlog/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.
-- [intake-triage](skills/questlog/references/intake-triage.md): Triage new asks, ideas, and vague incoming work into the right next step without prematurely committing execution structure.
-- [maintain-clear-ownership](skills/questlog/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.
-- [manage-approvals-and-promises](skills/questlog/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.
-- [plan-successor-work](skills/questlog/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.
-- [plan-time-correctly](skills/questlog/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.
-- [prioritize-across-streams](skills/questlog/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.
-- [protect-capacity-and-focus](skills/questlog/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.
-- [recover-from-modeling-mistakes](skills/questlog/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.
-- [report-status-and-manage-expectations](skills/questlog/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.
-- [revise-or-reshape-commitment](skills/questlog/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.
-- [run-operational-review](skills/questlog/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.
-- [run-recurring-rhythms](skills/questlog/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.
-- [search-and-retrieve-context](skills/questlog/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.
-- [sequence-with-unlocks](skills/questlog/references/sequence-with-unlocks.md): Model hard sequencing with unlocks between concrete quests so blocked and available work stay truthful and reviewable.
-- [settle-rumor-into-structure](skills/questlog/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.
-- [tag-and-filter-portfolios](skills/questlog/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 archive-delete-and-prune` ([archive-delete-and-prune](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/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](skills/questlog/references/tag-and-filter-portfolios.md)): Use tags for cross-cutting classification and portfolio filtering without confusing tags for status, timing, or dependency modeling.
 
 ### Principles
 
@@ -305,3 +408,7 @@ Writes: writes_state.
 - Read before you prescribe.
 - Protect history when reality changes.
 - Close the last mile, not just the main work.
+
+## Without the binary
+
+Use `npx -y @ghostpaw/questlog ...` in npm-based environments (Node 24+). Harnesses that embed it in code can import `@ghostpaw/questlog` as a library.

package/dist/{questlog_skill_spec-JLZH3JL2.js → chunk-6KTQK3ZE.js}

@@ -1,7 +1,4 @@
 #!/usr/bin/env node
-import { questlogMcpInstructions } from './chunk-SVWAEAKC.js';
-import { reviewQuestlogTool, questlogSurfaceTools } from './chunk-3Y5F3SMB.js';
-
 // src/skills/skill_types.ts
 function defineQuestlogSkill(skill) {
   return skill;
@@ -756,52 +753,4 @@ var questlogSkills = [
   tagAndFilterPortfoliosSkill
 ];
 
-// src/soul.ts
-var questlogSoulTraits = [
-  {
-    principle: "Store the least committed truth first.",
-    provenance: "The worst downstream errors usually start upstream: vague asks are turned into quests, soft ideas become fake deadlines, and half-understood work is treated as fully shaped. Using rumors and clarification before commitment keeps uncertainty where it belongs."
-  },
-  {
-    principle: "Read before you prescribe.",
-    provenance: "Many management mistakes are category mistakes: blocked work gets treated as available, missed schedule as overdue, or resolved work as fully closed when follow-through still remains. Reading the derived state first prevents confident but wrong interventions."
-  },
-  {
-    principle: "Protect history when reality changes.",
-    provenance: "Once execution starts, rewriting a quest into a different commitment destroys the meaning of the record. Honest finishes, abandonments, and follow-up quests preserve what actually happened and keep later review, planning, and reporting trustworthy."
-  },
-  {
-    principle: "Close the last mile, not just the main work.",
-    provenance: "Operational debt often hides in almost-done states: work finished but not claimed, reported, handed off, reviewed, or retired. Treating closure as a real phase prevents stale rewards, lingering initiatives, and misleading progress signals."
-  }
-];
-
-// src/surface/questlog_skill_spec.ts
-var questlogSkillSpec = {
-  name: "questlog",
-  cheatSheet: [
-    "`questlog` and `ghostpaw-questlog` are the same binary.",
-    "",
-    '- `questlog add --title "..." --tag a,b --due tomorrow`',
-    `- \`questlog list [--view <view>]\`: ${reviewQuestlogTool.inputSchema.properties?.view?.enum?.join(", ")}.`,
-    '- `questlog done <id> --outcome "..."`',
-    "- `questlog search <words>`",
-    "- `questlog show <id>`",
-    "- Use `--json` on any plain command.",
-    "- Exit codes: 0 ok / 1 error / 2 usage / 3 needs input.",
-    "- Database: `~/.ghostpaw/questlog.db`; override with `--db` or `GHOSTPAW_QUESTLOG_DB`.",
-    "- Use one database per agent or project."
-  ].join("\n"),
-  description: "Manage local tasks, calendar commitments, and recurring work. Use when planning, executing, reviewing, or organizing work.",
-  license: "MIT",
-  compatibility: "Node.js 24 or newer. MCP stdio or ghostpaw-questlog CLI.",
-  bin: "ghostpaw-questlog",
-  packageName: "@ghostpaw/questlog",
-  server: "ghostpaw-questlog",
-  about: questlogMcpInstructions,
-  tools: questlogSurfaceTools,
-  workflows: questlogSkills,
-  principles: questlogSoulTraits.map((trait) => trait.principle)
-};
-
-export { questlogSkillSpec };
+export { questlogSkills };

package/dist/chunk-DKH623HU.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+function resolveQuestlogDbPath(options = {}) {
+  return options.flag ?? ((options.env ?? process.env).GHOSTPAW_QUESTLOG_DB || join(homedir(), ".ghostpaw", "questlog.db"));
+}
+
+// src/version.ts
+var questlogVersion = "0.9.2";
+
+// src/surfaces/surface_types.ts
+function isErrorResult(result) {
+  return typeof result === "object" && result !== null && "ok" in result && result.ok === false;
+}
+
+export { isErrorResult, questlogVersion, resolveQuestlogDbPath };

package/dist/chunk-QYSIJ2YN.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// src/surfaces/schema_actions.ts
+var requirements = /* @__PURE__ */ new WeakMap();
+function registerSchemaActions(schema, actions) {
+  requirements.set(schema, actions);
+}
+function requiredForAction(schema, action) {
+  return requirements.get(schema)?.[String(action)] ?? [];
+}
+
+// src/surfaces/schema_examples.ts
+function minimalInput(schema, action, name = "") {
+  const constant = "const" in schema ? schema.const : void 0;
+  if (constant !== void 0) return constant;
+  if (schema.enum)
+    return action !== void 0 && schema.enum.includes(action) ? action : schema.enum[0];
+  const branch = schema.oneOf?.[0];
+  if (schema.type === "object" || schema.properties) {
+    action ??= schema.properties?.action?.enum?.[0];
+    const properties = { ...schema.properties, ...branch?.properties };
+    return Object.fromEntries(
+      [
+        .../* @__PURE__ */ new Set([
+          ...schema.required ?? [],
+          ...requiredForAction(schema, action),
+          ...schema.properties?.outcome && ["finish", "abandon", "abandon_and_spawn_followups"].includes(String(action)) ? ["outcome"] : [],
+          ...branch?.required ?? []
+        ])
+      ].map((key) => [
+        key,
+        minimalInput(properties[key] ?? {}, key === "action" ? action : void 0, key)
+      ])
+    );
+  }
+  if (branch) return minimalInput(branch, action, name);
+  if (schema.type === "array") return [minimalInput(schema.items ?? {}, void 0, name)];
+  if (schema.type === "integer" || schema.type === "number")
+    return name === "anchorAt" ? 18e11 : name === "toQuestId" ? 2 : 1;
+  if (schema.type === "boolean") return false;
+  if (schema.type === "null") return null;
+  if (name === "rrule") return "FREQ=WEEKLY";
+  if (name === "title") return "Review release notes";
+  if (name === "objective") return "Check changes against the release";
+  return "release";
+}
+
+export { minimalInput, registerSchemaActions, requiredForAction };