@ghostpaw/questlog 0.6.2 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +47 -11
- package/dist/cli.js +2922 -2650
- package/dist/mcp-server.js +1 -1
- package/dist/mcp.cjs +1 -1
- package/dist/mcp.js +1 -1
- package/package.json +8 -3
package/README.md
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
|
+
<a href="https://questlog.ghostpaw.dev/"><img src="https://raw.githubusercontent.com/GhostPawJS/questlog/main/.github/social-preview.png" alt="GhostPaw questlog: Your agent said it was done. Was it?" width="100%"></a>
|
|
2
|
+
|
|
1
3
|
# @ghostpaw/questlog
|
|
2
4
|
|
|
3
|
-
[](https://www.npmjs.com/package/@ghostpaw/questlog)
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
5
|
+
[](https://www.npmjs.com/package/@ghostpaw/questlog) [](https://github.com/GhostPawJS/questlog/actions/workflows/ci.yml) [](https://questlog.ghostpaw.dev/) [](package.json) [](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.GhostPawJS%2Fquestlog/versions/latest) [](https://nodejs.org) [](LICENSE)
|
|
6
|
+
|
|
7
|
+
**Agent tasks as quests that finish only with a written outcome.**
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
npm install @ghostpaw/questlog
|
|
11
|
+
```
|
|
10
12
|
|
|
11
13
|
A unified task and calendar model for Node.js, built on SQLite.
|
|
12
14
|
|
|
@@ -63,13 +65,37 @@ initialize-based revisions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05.
|
|
|
63
65
|
|
|
64
66
|
## CLI
|
|
65
67
|
|
|
68
|
+
Install globally for the `ghostpaw-questlog` binary: `npm i -g @ghostpaw/questlog`.
|
|
69
|
+
|
|
66
70
|
```bash
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
71
|
+
ghostpaw-questlog add --title "Review release notes" --tag release --due 2030-01-02
|
|
72
|
+
ghostpaw-questlog list --limit 10
|
|
73
|
+
ghostpaw-questlog search release notes --limit 5
|
|
74
|
+
ghostpaw-questlog show 1
|
|
75
|
+
ghostpaw-questlog done 1 --outcome "Reviewed changes"
|
|
76
|
+
ghostpaw-questlog list --view quests.resolved --json
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
`add` accepts repeated `--tag` flags, `--objective` (defaults to the title),
|
|
80
|
+
`--questline <id>`, and `--due` as an ISO date or milliseconds since epoch.
|
|
81
|
+
`list` defaults to available quests; `list --help` lists all supported views.
|
|
82
|
+
Its `--limit` caps text output; JSON preserves the full review tool result.
|
|
83
|
+
`search --limit` caps matches in both formats. `show` inspects a quest id.
|
|
84
|
+
`done` requires `--outcome`, the written result stored with the finished quest.
|
|
85
|
+
|
|
86
|
+
Plain commands print short text by default. Use `--json` for the full tool result
|
|
87
|
+
and `--compact` for compact JSON. `--db path` works before or after the command.
|
|
88
|
+
Each command accepts `--help`. Exit codes are 0 for success, 1 for invalid input
|
|
89
|
+
or a tool error, 2 for usage errors, and 3 when clarification is needed.
|
|
90
|
+
|
|
91
|
+
The `call` command and the per-tool form still reach every tool and parameter:
|
|
92
|
+
|
|
93
|
+
```bash
|
|
94
|
+
ghostpaw-questlog tools
|
|
95
|
+
ghostpaw-questlog call capture_rumor '{"title":"Review release notes"}'
|
|
96
|
+
ghostpaw-questlog search_questlog --query "release notes"
|
|
70
97
|
```
|
|
71
98
|
|
|
72
|
-
Install globally for the `ghostpaw-questlog` binary: `npm i -g @ghostpaw/questlog`.
|
|
73
99
|
`ghostpaw-questlog mcp` starts the stdio server.
|
|
74
100
|
|
|
75
101
|
## Agent Skill
|
|
@@ -124,6 +150,16 @@ const dueSoon = read.listDueSoonQuests(db, 7 * 24 * 60 * 60 * 1000);
|
|
|
124
150
|
const results = read.searchQuestlog(db, 'vendor');
|
|
125
151
|
```
|
|
126
152
|
|
|
153
|
+
## Docs
|
|
154
|
+
|
|
155
|
+
The live demo runs the library in your browser against an in-memory SQLite database. Each view below opens a different part of it:
|
|
156
|
+
|
|
157
|
+
- [Dashboard](https://questlog.ghostpaw.dev/docs/): open, available, overdue and pending work
|
|
158
|
+
- [Intake](https://questlog.ghostpaw.dev/docs/#/intake): capture rumors and triage them into quests
|
|
159
|
+
- [Quests](https://questlog.ghostpaw.dev/docs/#/quests): start, block and finish quests with an outcome
|
|
160
|
+
- [Planning](https://questlog.ghostpaw.dev/docs/#/planning): questlines and scheduling
|
|
161
|
+
- [Search](https://questlog.ghostpaw.dev/docs/#/search): full-text search across the log
|
|
162
|
+
|
|
127
163
|
## The Model
|
|
128
164
|
|
|
129
165
|
Seven concepts, strict separation of concerns:
|