@ghostpaw/questlog 0.6.0 → 0.6.1

package/README.md

@@ -260,6 +260,24 @@ The `run_quest` tool refuses to start a quest with unmet unlock prerequisites an
 - **WoW-style markers.** Semantic marker IDs (`attention.available`, `progress.complete`, ...) computed on every read, renderable to any channel.
 - **Colocated tests.** Every non-type module has a colocated `.test.ts` file. The behavior described in docs is backed by executable coverage.
 
+## Performance
+
+Measured with `npm run bench` on Node 24.14.0, Linux, Intel Xeon (shared
+cloud vCPU), 10,000 quests in a file-backed database:
+
+| Operation | p50 | p95 |
+|---|---:|---:|
+| `search_questlog` (tool) | 0.06 ms | 0.07 ms |
+| MCP `tools/call` search, stdio framing included | 0.07 ms | 0.08 ms |
+| `read.searchQuestlog`, one matching quest | 0.07 ms | 0.08 ms |
+| `read.searchQuestlog`, all 10,000 quests matching | 26.6 ms | 41.9 ms |
+| `write.createQuest` | 0.22 ms | 0.69 ms |
+
+The library search returns every match with a highlighted snippet, so a query
+that matches the whole log pays for building all of those rows. Cold start
+(process spawn to first response, median) is about 30 ms for `--version` and
+the MCP server.
+
 ## Package Surface
 
 ```ts

package/dist/cli.js

@@ -4194,8 +4194,7 @@ function searchQuestlog(db, query) {
                   AND blocker.deleted_at IS NULL
                   AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
               ) AS has_blockers
-       FROM quests_fts
-       JOIN quests q ON q.id = quests_fts.rowid
+       FROM quests_fts CROSS JOIN quests q ON q.id = quests_fts.rowid
        WHERE quests_fts MATCH ? AND q.deleted_at IS NULL`
   ).all(trimmed).map((row) => {
     const state = deriveQuestState({
@@ -4227,8 +4226,7 @@ function searchQuestlog(db, query) {
               snippet(rumors_fts, 1, '[', ']', '\u2026', 10) AS snippet,
               r.settled_at,
               r.dismissed_at
-       FROM rumors_fts
-       JOIN rumors r ON r.id = rumors_fts.rowid
+       FROM rumors_fts CROSS JOIN rumors r ON r.id = rumors_fts.rowid
        WHERE rumors_fts MATCH ? AND r.deleted_at IS NULL`
   ).all(trimmed).map((row) => ({
     entityKind: "rumor",
@@ -5233,7 +5231,7 @@ var init_validate_input = __esm({
 var questlogVersion;
 var init_version = __esm({
   "src/version.ts"() {
-    questlogVersion = "0.6.0";
+    questlogVersion = "0.6.1";
   }
 });
 

package/dist/index.cjs

@@ -2056,8 +2056,7 @@ function searchQuestlog(db, query) {
                   AND blocker.deleted_at IS NULL
                   AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
               ) AS has_blockers
-       FROM quests_fts
-       JOIN quests q ON q.id = quests_fts.rowid
+       FROM quests_fts CROSS JOIN quests q ON q.id = quests_fts.rowid
        WHERE quests_fts MATCH ? AND q.deleted_at IS NULL`
   ).all(trimmed).map((row) => {
     const state = deriveQuestState({
@@ -2089,8 +2088,7 @@ function searchQuestlog(db, query) {
               snippet(rumors_fts, 1, '[', ']', '\u2026', 10) AS snippet,
               r.settled_at,
               r.dismissed_at
-       FROM rumors_fts
-       JOIN rumors r ON r.id = rumors_fts.rowid
+       FROM rumors_fts CROSS JOIN rumors r ON r.id = rumors_fts.rowid
        WHERE rumors_fts MATCH ? AND r.deleted_at IS NULL`
   ).all(trimmed).map((row) => ({
     entityKind: "rumor",

package/dist/index.d.cts

@@ -665,6 +665,8 @@ interface QuestlogSearchResult {
 
 /**
  * Full-text search across quest and rumor content.
+ * CROSS JOIN keeps the FTS table as the outer loop; with a plain JOIN SQLite
+ * may walk idx_quests_deleted_at and probe the FTS index once per quest.
  */
 declare function searchQuestlog(db: QuestlogDb, query: string): QuestlogSearchResult[];
 

package/dist/index.d.ts

@@ -665,6 +665,8 @@ interface QuestlogSearchResult {
 
 /**
  * Full-text search across quest and rumor content.
+ * CROSS JOIN keeps the FTS table as the outer loop; with a plain JOIN SQLite
+ * may walk idx_quests_deleted_at and probe the FTS index once per quest.
  */
 declare function searchQuestlog(db: QuestlogDb, query: string): QuestlogSearchResult[];
 

package/dist/index.js

@@ -2054,8 +2054,7 @@ function searchQuestlog(db, query) {
                   AND blocker.deleted_at IS NULL
                   AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
               ) AS has_blockers
-       FROM quests_fts
-       JOIN quests q ON q.id = quests_fts.rowid
+       FROM quests_fts CROSS JOIN quests q ON q.id = quests_fts.rowid
        WHERE quests_fts MATCH ? AND q.deleted_at IS NULL`
   ).all(trimmed).map((row) => {
     const state = deriveQuestState({
@@ -2087,8 +2086,7 @@ function searchQuestlog(db, query) {
               snippet(rumors_fts, 1, '[', ']', '\u2026', 10) AS snippet,
               r.settled_at,
               r.dismissed_at
-       FROM rumors_fts
-       JOIN rumors r ON r.id = rumors_fts.rowid
+       FROM rumors_fts CROSS JOIN rumors r ON r.id = rumors_fts.rowid
        WHERE rumors_fts MATCH ? AND r.deleted_at IS NULL`
   ).all(trimmed).map((row) => ({
     entityKind: "rumor",

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.6.0";
+    questlogVersion = "0.6.1";
   }
 });
 
@@ -4870,8 +4870,7 @@ function searchQuestlog(db, query) {
                   AND blocker.deleted_at IS NULL
                   AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
               ) AS has_blockers
-       FROM quests_fts
-       JOIN quests q ON q.id = quests_fts.rowid
+       FROM quests_fts CROSS JOIN quests q ON q.id = quests_fts.rowid
        WHERE quests_fts MATCH ? AND q.deleted_at IS NULL`
   ).all(trimmed).map((row) => {
     const state = deriveQuestState({
@@ -4903,8 +4902,7 @@ function searchQuestlog(db, query) {
               snippet(rumors_fts, 1, '[', ']', '\u2026', 10) AS snippet,
               r.settled_at,
               r.dismissed_at
-       FROM rumors_fts
-       JOIN rumors r ON r.id = rumors_fts.rowid
+       FROM rumors_fts CROSS JOIN rumors r ON r.id = rumors_fts.rowid
        WHERE rumors_fts MATCH ? AND r.deleted_at IS NULL`
   ).all(trimmed).map((row) => ({
     entityKind: "rumor",

package/dist/mcp.cjs

@@ -386,7 +386,7 @@ async function openQuestlogDb(path) {
 }
 
 // src/version.ts
-var questlogVersion = "0.6.0";
+var questlogVersion = "0.6.1";
 
 // 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.";
@@ -3846,8 +3846,7 @@ function searchQuestlog(db, query) {
                   AND blocker.deleted_at IS NULL
                   AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
               ) AS has_blockers
-       FROM quests_fts
-       JOIN quests q ON q.id = quests_fts.rowid
+       FROM quests_fts CROSS JOIN quests q ON q.id = quests_fts.rowid
        WHERE quests_fts MATCH ? AND q.deleted_at IS NULL`
   ).all(trimmed).map((row) => {
     const state = deriveQuestState({
@@ -3879,8 +3878,7 @@ function searchQuestlog(db, query) {
               snippet(rumors_fts, 1, '[', ']', '\u2026', 10) AS snippet,
               r.settled_at,
               r.dismissed_at
-       FROM rumors_fts
-       JOIN rumors r ON r.id = rumors_fts.rowid
+       FROM rumors_fts CROSS JOIN rumors r ON r.id = rumors_fts.rowid
        WHERE rumors_fts MATCH ? AND r.deleted_at IS NULL`
   ).all(trimmed).map((row) => ({
     entityKind: "rumor",

package/dist/mcp.js

@@ -384,7 +384,7 @@ async function openQuestlogDb(path) {
 }
 
 // src/version.ts
-var questlogVersion = "0.6.0";
+var questlogVersion = "0.6.1";
 
 // 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.";
@@ -3844,8 +3844,7 @@ function searchQuestlog(db, query) {
                   AND blocker.deleted_at IS NULL
                   AND NOT (blocker.resolved_at IS NOT NULL AND blocker.success = 1)
               ) AS has_blockers
-       FROM quests_fts
-       JOIN quests q ON q.id = quests_fts.rowid
+       FROM quests_fts CROSS JOIN quests q ON q.id = quests_fts.rowid
        WHERE quests_fts MATCH ? AND q.deleted_at IS NULL`
   ).all(trimmed).map((row) => {
     const state = deriveQuestState({
@@ -3877,8 +3876,7 @@ function searchQuestlog(db, query) {
               snippet(rumors_fts, 1, '[', ']', '\u2026', 10) AS snippet,
               r.settled_at,
               r.dismissed_at
-       FROM rumors_fts
-       JOIN rumors r ON r.id = rumors_fts.rowid
+       FROM rumors_fts CROSS JOIN rumors r ON r.id = rumors_fts.rowid
        WHERE rumors_fts MATCH ? AND r.deleted_at IS NULL`
   ).all(trimmed).map((row) => ({
     entityKind: "rumor",

package/package.json

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