@ghostpaw/questlog 0.8.0 → 0.9.0

package/README.md

@@ -65,22 +65,26 @@ initialize-based revisions 2025-11-25, 2025-06-18, 2025-03-26 and 2024-11-05.
 
 ## CLI
 
-Install globally for the `ghostpaw-questlog` binary: `npm i -g @ghostpaw/questlog`.
+Install globally for `questlog` (`ghostpaw-questlog` is the same binary): `npm i -g @ghostpaw/questlog`.
 
 ```bash
-ghostpaw-questlog add --title "Review release notes" --tag release --due 2030-01-02
-ghostpaw-questlog list --limit 10
-ghostpaw-questlog search release notes --limit 5
-ghostpaw-questlog show 1
-ghostpaw-questlog done 1 --outcome "Reviewed changes"
-ghostpaw-questlog list --view quests.resolved --json
+questlog add --title "Review release notes" --tag release --due 2030-01-02
+questlog list --limit 10
+questlog search release notes --limit 5
+questlog show 1
+questlog done 1 --outcome "Reviewed changes"
+questlog list --view quests.resolved --json
 ```
 
-`add` accepts repeated `--tag` flags, `--objective` (defaults to the title),
-`--questline <id>`, and `--due` as an ISO date or milliseconds since epoch.
+`add` accepts comma-separated tags (`--tag a,b`) and repeated `--tag` flags, `--objective` (defaults to the title),
+`--questline <id>`, and `--due` as YYYY-MM-DD, DD.MM.YYYY, `today`, `tomorrow`,
+`+3d`, an ISO date-time with timezone, or milliseconds since epoch. Date-only
+values use local end of day.
 `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.
+`search --limit` caps matches in both formats. `show` prints full quest detail.
+Lists show local due dates, overdue markers, and recorded outcomes. Plain JSON
+adds ISO UTC siblings for numeric timestamp fields ending in `At`.
 `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
@@ -91,12 +95,17 @@ or a tool error, 2 for usage errors, and 3 when clarification is needed.
 The `call` command and the per-tool form still reach every tool and parameter:
 
 ```bash
-ghostpaw-questlog tools
-ghostpaw-questlog call capture_rumor '{"title":"Review release notes"}'
-ghostpaw-questlog search_questlog --query "release notes"
+questlog tools
+questlog call capture_rumor '{"title":"Review release notes"}'
+questlog search_questlog --query "release notes"
 ```
 
-`ghostpaw-questlog mcp` starts the stdio server.
+`questlog mcp` starts the stdio server.
+
+The default database is `~/.ghostpaw/questlog.db`. Override it with `--db <path>`
+or `GHOSTPAW_QUESTLOG_DB`; top-level help shows the selected path. New database
+files are reported on stderr. The npm entry requires Node 24+ and exits 2 with
+an installation hint on older Node versions, including for help and version.
 
 ## Agent Skill
 

package/SKILL.md

@@ -7,9 +7,23 @@ compatibility: "Node.js 24 or newer. MCP stdio or ghostpaw-questlog CLI."
 
 # questlog
 
+`questlog` and `ghostpaw-questlog` are the same binary.
+
+- `questlog add --title "..." --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>`
+- `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.
+
+## Appendix: MCP and tool calls
+
 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.
 
-## Calling tools
+### Calling tools
 
 MCP: connect to ghostpaw-questlog, then call a tool by name with its JSON arguments.
 
@@ -17,7 +31,7 @@ CLI: `ghostpaw-questlog call <tool> '<JSON object>'` or `ghostpaw-questlog <tool
 
 Inspect schemas with `ghostpaw-questlog describe <tool>`. Use `--db <path>` to select a database.
 
-## search_questlog
+### search_questlog
 
 Search quests and rumors by text when you need to find an existing item before inspecting or changing it.
 
@@ -34,7 +48,7 @@ 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. |
 
-## review_questlog
+### review_questlog
 
 Review one operational questlog surface such as available quests, open rumors, blocked work, or due repeatable anchors.
 
@@ -50,7 +64,7 @@ Read-only.
 | filters | object | no | Optional filters for supported review surfaces. |
 | now | integer | no | Optional evaluation timestamp for time-sensitive views. |
 
-## inspect_questlog_item
+### inspect_questlog_item
 
 Inspect one specific questlog item in depth and return its richer structured detail and important related refs.
 
@@ -66,7 +80,7 @@ Read-only.
 | detailLevel | string | no | compact, full. How much detail to return. |
 | now | integer | no | Optional evaluation timestamp for time-sensitive detail. |
 
-## capture_rumor
+### capture_rumor
 
 Capture uncertain incoming work as a rumor so it can be triaged later without prematurely turning it into committed execution.
 
@@ -82,7 +96,7 @@ 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. |
 
-## shape_work
+### 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.
 
@@ -107,7 +121,7 @@ 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. |
 
-## plan_quest
+### plan_quest
 
 Refine a quest by revising its objective before actual start or by changing its temporal planning fields.
 
@@ -130,7 +144,7 @@ Writes: writes_state.
 | estimateSeconds | integer | no | Optional active-effort estimate in seconds. |
 | now | integer | no | Optional update timestamp. |
 
-## run_quest
+### run_quest
 
 Run quest lifecycle actions such as starting, logging effort, finishing, abandoning, or abandoning and spawning follow-up quests atomically.
 
@@ -152,7 +166,7 @@ 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. |
 
-## organize_work
+### organize_work
 
 Organize grouping and dependency structure by updating questlines or changing hard unlock prerequisites between concrete quests.
 
@@ -176,7 +190,7 @@ Writes: writes_state.
 | fromQuestIds | array | no | Full prerequisite quest id set. |
 | now | integer | no | Optional timestamp. |
 
-## manage_repeatable
+### manage_repeatable
 
 Manage recurring work definitions by creating, updating, previewing, spawning, or archiving repeatable quests.
 
@@ -205,7 +219,7 @@ Writes: writes_state.
 | archivedAt | integer | no | Optional archive timestamp. |
 | now | integer | no | Evaluation or update timestamp. |
 
-## tag_work
+### tag_work
 
 Classify work by adding, removing, or replacing tags on quests and by replacing the future tag template set on repeatable quests.
 
@@ -222,7 +236,7 @@ Writes: writes_state.
 | tagNames | array | yes | Tag names to add, remove, or replace. |
 | now | integer | no | Optional timestamp for the tag mutation. |
 
-## reward_work
+### reward_work
 
 Manage rewards by adding, updating, removing, or claiming quest rewards, or by replacing future reward templates on repeatable quests.
 
@@ -241,7 +255,7 @@ Writes: writes_state.
 | claimedAt | integer | no | Optional claim timestamp. |
 | now | integer | no | Optional timestamp for removal or template replacement. |
 
-## retire_work
+### retire_work
 
 Hide an item from normal active operation without rewriting history by soft-deleting a rumor, quest, questline, or repeatable quest.
 
@@ -257,7 +271,7 @@ Writes: writes_state.
 | target | object | yes | The target to hide. |
 | deletedAt | integer | no | Optional timestamp to record when the item became hidden. |
 
-## Workflow guides
+### 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.
@@ -285,7 +299,7 @@ Writes: writes_state.
 - [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.
 
-## Principles
+### Principles
 
 - Store the least committed truth first.
 - Read before you prescribe.

package/dist/chunk-3B6FMHZU.js

@@ -0,0 +1,384 @@
+#!/usr/bin/env node
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+// src/questlines/init_questline_tables.ts
+function initQuestlineTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS questlines (
+      id              INTEGER PRIMARY KEY,
+      source_rumor_id INTEGER REFERENCES rumors(id),
+      title           TEXT    NOT NULL,
+      description     TEXT,
+      starts_at       INTEGER,
+      due_at          INTEGER,
+      created_at      INTEGER NOT NULL,
+      updated_at      INTEGER NOT NULL,
+      archived_at     INTEGER,
+      deleted_at      INTEGER,
+      CHECK(length(trim(title)) > 0),
+      CHECK(due_at IS NULL OR starts_at IS NULL OR due_at >= starts_at)
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_questlines_due_at ON questlines(due_at)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_questlines_deleted_at ON questlines(deleted_at)");
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_questlines_source_rumor_id ON questlines(source_rumor_id) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_questlines_created_at_active ON questlines(created_at DESC, id DESC) WHERE deleted_at IS NULL"
+  );
+}
+
+// src/quests/init_quest_search.ts
+function initQuestSearch(db) {
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS quests_fts USING fts5(
+      title,
+      objective,
+      outcome,
+      content=quests,
+      content_rowid=id
+    )
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS quests_fts_insert
+    AFTER INSERT ON quests
+    WHEN new.deleted_at IS NULL
+    BEGIN
+      INSERT INTO quests_fts(rowid, title, objective, outcome)
+      VALUES (new.id, new.title, new.objective, COALESCE(new.outcome, ''));
+    END
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS quests_fts_update
+    AFTER UPDATE OF title, objective, outcome, deleted_at ON quests
+    BEGIN
+      INSERT INTO quests_fts(quests_fts, rowid, title, objective, outcome)
+      VALUES ('delete', old.id, old.title, old.objective, COALESCE(old.outcome, ''));
+      INSERT INTO quests_fts(rowid, title, objective, outcome)
+      SELECT new.id, new.title, new.objective, COALESCE(new.outcome, '')
+      WHERE new.deleted_at IS NULL;
+    END
+  `);
+}
+
+// src/quests/init_quest_tables.ts
+function initQuestTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS quests (
+      id                         INTEGER PRIMARY KEY,
+      questline_id               INTEGER REFERENCES questlines(id),
+      source_rumor_id            INTEGER REFERENCES rumors(id),
+      spawned_by_quest_id        INTEGER REFERENCES quests(id),
+      spawned_from_repeatable_id INTEGER REFERENCES repeatable_quests(id),
+      spawned_for_at             INTEGER,
+      title                      TEXT    NOT NULL,
+      objective                  TEXT    NOT NULL,
+      outcome                    TEXT,
+      created_at                 INTEGER NOT NULL,
+      updated_at                 INTEGER NOT NULL,
+      started_at                 INTEGER,
+      resolved_at                INTEGER,
+      success                    INTEGER CHECK(success IN (0, 1) OR success IS NULL),
+      effort_seconds             INTEGER NOT NULL DEFAULT 0 CHECK(effort_seconds >= 0),
+      estimate_seconds           INTEGER CHECK(estimate_seconds IS NULL OR estimate_seconds >= 0),
+      not_before_at              INTEGER,
+      due_at                     INTEGER,
+      scheduled_start_at         INTEGER,
+      scheduled_end_at           INTEGER,
+      all_day                    INTEGER NOT NULL DEFAULT 0 CHECK(all_day IN (0, 1)),
+      deleted_at                 INTEGER,
+      CHECK(length(trim(title)) > 0),
+      CHECK(length(trim(objective)) > 0),
+      CHECK(
+        (resolved_at IS NULL AND success IS NULL AND outcome IS NULL)
+        OR (resolved_at IS NOT NULL AND success IS NOT NULL AND outcome IS NOT NULL)
+      ),
+      CHECK(started_at IS NULL OR started_at >= created_at),
+      CHECK(resolved_at IS NULL OR resolved_at >= created_at),
+      CHECK(resolved_at IS NULL OR started_at IS NULL OR resolved_at >= started_at),
+      CHECK(scheduled_end_at IS NULL OR scheduled_start_at IS NOT NULL),
+      CHECK(scheduled_end_at IS NULL OR scheduled_end_at >= scheduled_start_at),
+      CHECK(not_before_at IS NULL OR due_at IS NULL OR not_before_at <= due_at),
+      CHECK(
+        (spawned_from_repeatable_id IS NULL AND spawned_for_at IS NULL)
+        OR (spawned_from_repeatable_id IS NOT NULL AND spawned_for_at IS NOT NULL)
+      )
+    )
+  `);
+  db.exec("CREATE INDEX IF NOT EXISTS idx_quests_deleted_at ON quests(deleted_at)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_quests_questline_id ON quests(questline_id)");
+  db.exec("CREATE INDEX IF NOT EXISTS idx_quests_source_rumor_id ON quests(source_rumor_id)");
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_spawned_by_quest_id ON quests(spawned_by_quest_id)"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_repeatable_anchor ON quests(spawned_from_repeatable_id, spawned_for_at)"
+  );
+  db.exec(
+    "CREATE UNIQUE INDEX IF NOT EXISTS idx_quests_repeatable_anchor_unique ON quests(spawned_from_repeatable_id, spawned_for_at) WHERE spawned_from_repeatable_id IS NOT NULL AND spawned_for_at IS NOT NULL AND deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_due_at ON quests(due_at) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_not_before_at ON quests(not_before_at) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_scheduled_window ON quests(scheduled_start_at, scheduled_end_at) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_lifecycle ON quests(started_at, resolved_at, success) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quests_created_at_active ON quests(created_at DESC, id DESC) WHERE deleted_at IS NULL"
+  );
+}
+
+// src/repeatable_quests/init_repeatable_quest_tables.ts
+function initRepeatableQuestTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS repeatable_quests (
+      id                             INTEGER PRIMARY KEY,
+      questline_id                   INTEGER REFERENCES questlines(id),
+      title                          TEXT    NOT NULL,
+      objective                      TEXT    NOT NULL,
+      rrule                          TEXT    NOT NULL,
+      anchor_at                      INTEGER NOT NULL,
+      not_before_offset_seconds      INTEGER,
+      due_offset_seconds             INTEGER,
+      scheduled_start_offset_seconds INTEGER,
+      scheduled_end_offset_seconds   INTEGER,
+      all_day                        INTEGER NOT NULL DEFAULT 0 CHECK(all_day IN (0, 1)),
+      estimate_seconds               INTEGER CHECK(estimate_seconds IS NULL OR estimate_seconds >= 0),
+      created_at                     INTEGER NOT NULL,
+      updated_at                     INTEGER NOT NULL,
+      archived_at                    INTEGER,
+      deleted_at                     INTEGER,
+      CHECK(length(trim(title)) > 0),
+      CHECK(length(trim(objective)) > 0),
+      CHECK(scheduled_end_offset_seconds IS NULL OR scheduled_start_offset_seconds IS NOT NULL),
+      CHECK(
+        scheduled_end_offset_seconds IS NULL
+        OR scheduled_end_offset_seconds >= scheduled_start_offset_seconds
+      )
+    )
+  `);
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_repeatable_quests_deleted_at ON repeatable_quests(deleted_at)"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_repeatable_quests_archived_at ON repeatable_quests(archived_at)"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_repeatable_quests_active_anchor ON repeatable_quests(anchor_at) WHERE deleted_at IS NULL AND archived_at IS NULL"
+  );
+}
+
+// src/rewards/init_reward_tables.ts
+function initRewardTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS quest_rewards (
+      id          INTEGER PRIMARY KEY,
+      quest_id    INTEGER NOT NULL REFERENCES quests(id),
+      kind        TEXT    NOT NULL,
+      name        TEXT    NOT NULL,
+      description TEXT,
+      quantity    REAL CHECK(quantity IS NULL OR quantity >= 0),
+      created_at  INTEGER NOT NULL,
+      claimed_at  INTEGER,
+      deleted_at  INTEGER,
+      CHECK(length(trim(kind)) > 0),
+      CHECK(length(trim(name)) > 0)
+    )
+  `);
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quest_rewards_quest_id ON quest_rewards(quest_id) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quest_rewards_claimed_at ON quest_rewards(claimed_at) WHERE deleted_at IS NULL"
+  );
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS repeatable_quest_rewards (
+      id                  INTEGER PRIMARY KEY,
+      repeatable_quest_id INTEGER NOT NULL REFERENCES repeatable_quests(id),
+      kind                TEXT    NOT NULL,
+      name                TEXT    NOT NULL,
+      description         TEXT,
+      quantity            REAL CHECK(quantity IS NULL OR quantity >= 0),
+      created_at          INTEGER NOT NULL,
+      deleted_at          INTEGER,
+      CHECK(length(trim(kind)) > 0),
+      CHECK(length(trim(name)) > 0)
+    )
+  `);
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_repeatable_quest_rewards_repeatable_quest_id ON repeatable_quest_rewards(repeatable_quest_id) WHERE deleted_at IS NULL"
+  );
+}
+
+// src/rumors/init_rumor_search.ts
+function initRumorSearch(db) {
+  db.exec(`
+    CREATE VIRTUAL TABLE IF NOT EXISTS rumors_fts USING fts5(
+      title,
+      details,
+      content=rumors,
+      content_rowid=id
+    )
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS rumors_fts_insert
+    AFTER INSERT ON rumors
+    WHEN new.deleted_at IS NULL
+    BEGIN
+      INSERT INTO rumors_fts(rowid, title, details)
+      VALUES (new.id, new.title, COALESCE(new.details, ''));
+    END
+  `);
+  db.exec(`
+    CREATE TRIGGER IF NOT EXISTS rumors_fts_update
+    AFTER UPDATE OF title, details, deleted_at ON rumors
+    BEGIN
+      INSERT INTO rumors_fts(rumors_fts, rowid, title, details)
+      VALUES ('delete', old.id, old.title, COALESCE(old.details, ''));
+      INSERT INTO rumors_fts(rowid, title, details)
+      SELECT new.id, new.title, COALESCE(new.details, '')
+      WHERE new.deleted_at IS NULL;
+    END
+  `);
+}
+
+// src/rumors/init_rumor_tables.ts
+function initRumorTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS rumors (
+      id            INTEGER PRIMARY KEY,
+      title         TEXT    NOT NULL,
+      details       TEXT,
+      created_at    INTEGER NOT NULL,
+      updated_at    INTEGER NOT NULL,
+      settled_at    INTEGER,
+      dismissed_at  INTEGER,
+      deleted_at    INTEGER,
+      CHECK(length(trim(title)) > 0),
+      CHECK(settled_at IS NULL OR dismissed_at IS NULL)
+    )
+  `);
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_rumors_open ON rumors(settled_at, dismissed_at, deleted_at)"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_rumors_created_at_active ON rumors(created_at DESC, id DESC) WHERE deleted_at IS NULL"
+  );
+}
+
+// src/tags/init_tag_tables.ts
+function initTagTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS tags (
+      id              INTEGER PRIMARY KEY,
+      name            TEXT    NOT NULL,
+      normalized_name TEXT    NOT NULL,
+      created_at      INTEGER NOT NULL,
+      deleted_at      INTEGER,
+      CHECK(length(trim(name)) > 0),
+      CHECK(length(trim(normalized_name)) > 0)
+    )
+  `);
+  db.exec(
+    "CREATE UNIQUE INDEX IF NOT EXISTS idx_tags_normalized_name_unique ON tags(normalized_name) WHERE deleted_at IS NULL"
+  );
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS quest_tags (
+      quest_id    INTEGER NOT NULL REFERENCES quests(id),
+      tag_id      INTEGER NOT NULL REFERENCES tags(id),
+      created_at  INTEGER NOT NULL,
+      deleted_at  INTEGER,
+      PRIMARY KEY (quest_id, tag_id, created_at)
+    )
+  `);
+  db.exec(
+    "CREATE UNIQUE INDEX IF NOT EXISTS idx_quest_tags_unique ON quest_tags(quest_id, tag_id) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quest_tags_tag_id ON quest_tags(tag_id) WHERE deleted_at IS NULL"
+  );
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS repeatable_quest_tags (
+      repeatable_quest_id INTEGER NOT NULL REFERENCES repeatable_quests(id),
+      tag_id              INTEGER NOT NULL REFERENCES tags(id),
+      created_at          INTEGER NOT NULL,
+      deleted_at          INTEGER,
+      PRIMARY KEY (repeatable_quest_id, tag_id, created_at)
+    )
+  `);
+  db.exec(
+    "CREATE UNIQUE INDEX IF NOT EXISTS idx_repeatable_quest_tags_unique ON repeatable_quest_tags(repeatable_quest_id, tag_id) WHERE deleted_at IS NULL"
+  );
+}
+
+// src/unlocks/init_unlock_tables.ts
+function initUnlockTables(db) {
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS quest_unlocks (
+      id            INTEGER PRIMARY KEY,
+      from_quest_id INTEGER NOT NULL REFERENCES quests(id),
+      to_quest_id   INTEGER NOT NULL REFERENCES quests(id),
+      created_at    INTEGER NOT NULL,
+      deleted_at    INTEGER,
+      CHECK(from_quest_id <> to_quest_id)
+    )
+  `);
+  db.exec(
+    "CREATE UNIQUE INDEX IF NOT EXISTS idx_quest_unlocks_pair_unique ON quest_unlocks(from_quest_id, to_quest_id) WHERE deleted_at IS NULL"
+  );
+  db.exec(
+    "CREATE INDEX IF NOT EXISTS idx_quest_unlocks_to_quest_id ON quest_unlocks(to_quest_id) WHERE deleted_at IS NULL"
+  );
+}
+
+// src/init_questlog_tables.ts
+function initQuestlogTables(db) {
+  initRumorTables(db);
+  initQuestlineTables(db);
+  initRepeatableQuestTables(db);
+  initQuestTables(db);
+  initUnlockTables(db);
+  initRewardTables(db);
+  initTagTables(db);
+  initQuestSearch(db);
+  initRumorSearch(db);
+}
+
+// src/surface/open_questlog_db.ts
+async function openQuestlogDb(path) {
+  const original = process.emitWarning;
+  process.emitWarning = ((warning, ...args) => {
+    const type = typeof args[0] === "string" ? args[0] : typeof args[0] === "object" && args[0] !== null && "type" in args[0] ? args[0].type : warning instanceof Error ? warning.name : void 0;
+    const message = warning instanceof Error ? warning.message : warning;
+    if (type === "ExperimentalWarning" && message.startsWith("SQLite is an experimental feature"))
+      return;
+    Reflect.apply(original, process, [warning, ...args]);
+  });
+  let sqlite;
+  try {
+    sqlite = await import('node:sqlite');
+  } finally {
+    process.emitWarning = original;
+  }
+  if (path !== ":memory:") mkdirSync(dirname(path), { recursive: true });
+  const db = new sqlite.DatabaseSync(path);
+  try {
+    db.exec("PRAGMA journal_mode=WAL; PRAGMA busy_timeout=5000;");
+    const context = db;
+    initQuestlogTables(context);
+    return context;
+  } catch (error) {
+    db.close();
+    throw error;
+  }
+}
+
+export { openQuestlogDb };