@ghostpaw/questlog 0.1.0 → 0.2.0

package/README.md

@@ -1,5 +1,12 @@
 # @ghostpaw/questlog
 
+[![npm](https://img.shields.io/npm/v/@ghostpaw/questlog)](https://www.npmjs.com/package/@ghostpaw/questlog)
+[![node](https://img.shields.io/node/v/@ghostpaw/questlog)](https://nodejs.org)
+[![license](https://img.shields.io/npm/l/@ghostpaw/questlog)](LICENSE)
+[![dependencies](https://img.shields.io/badge/dependencies-0-brightgreen)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org)
+[![Live Demo](https://img.shields.io/badge/demo-live-06d6a0?style=flat&logo=github)](https://ghostpawjs.github.io/questlog)
+
 A unified task and calendar model for Node.js, built on SQLite.
 
 Questlog treats tasks, events, deadlines, recurring commitments, and loose intake as one coherent data model instead of separate systems. It ships as a single prebundled blob with zero runtime dependencies, designed for two audiences at once: human developers working directly in code, and LLM agents operating through a structured tool facade.

package/dist/index.cjs

@@ -3754,6 +3754,7 @@ var manageRepeatableTool = defineQuestlogTool({
   },
   outputDescription: "Returns the changed repeatable quest, due anchor preview items, or spawned quest details for the selected recurrence action. Empty previews and empty spawns return structured success or no-op results, and repeatable hiding is now intentionally routed through `retire_work`.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4021,6 +4022,7 @@ var organizeWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated questline detail or target quest detail after grouping or dependency changes. Repeated equivalent changes return structured no-op results.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4163,6 +4165,7 @@ var planQuestTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated quest detail after objective or planning changes. If the requested planning state is already present, the tool returns a structured no-op result.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4746,6 +4749,7 @@ var rewardWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated or claimed reward when one concrete reward changes, or a structured success result for repeatable future template replacement. Already-claimed rewards return a structured no-op for claim and an error for invalid update or remove attempts.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4999,6 +5003,7 @@ var runQuestTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated quest detail after the selected lifecycle action, plus purpose-shaped primary, updated, and created refs when follow-up work is spawned. Safe repeated starts return structured no-op results.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -5409,6 +5414,7 @@ var shapeWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the changed or created rumor, quest, questline, or created quest set for the selected shape-work action, plus purpose-shaped primary and created or updated refs. Repeated safe actions return structured no-op results, and rumor settlement can ask for missing structure instead of failing.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -5695,6 +5701,7 @@ var tagWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the normalized final tag set for the target after the selected tag action. Repeated equivalent changes return structured no-op results.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {

package/dist/index.d.cts

@@ -1,9 +1,21 @@
-import { DatabaseSync } from 'node:sqlite';
-
+interface QuestlogRunResult {
+    lastInsertRowid: number | bigint;
+    changes?: number | bigint | undefined;
+}
+interface QuestlogStatement {
+    run(...params: unknown[]): QuestlogRunResult;
+    get<TRecord = Record<string, unknown>>(...params: unknown[]): TRecord | undefined;
+    all<TRecord = Record<string, unknown>>(...params: unknown[]): TRecord[];
+}
 /**
  * SQLite dependency injected into every questlog operation.
+ * Node.js `DatabaseSync` satisfies this interface directly.
  */
-type QuestlogDb = DatabaseSync;
+type QuestlogDb = {
+    exec(sql: string): void;
+    prepare(sql: string): QuestlogStatement;
+    close(): void;
+};
 
 /**
  * Creates the full standalone questlog schema, including FTS and indexing.

package/dist/index.d.ts

@@ -1,9 +1,21 @@
-import { DatabaseSync } from 'node:sqlite';
-
+interface QuestlogRunResult {
+    lastInsertRowid: number | bigint;
+    changes?: number | bigint | undefined;
+}
+interface QuestlogStatement {
+    run(...params: unknown[]): QuestlogRunResult;
+    get<TRecord = Record<string, unknown>>(...params: unknown[]): TRecord | undefined;
+    all<TRecord = Record<string, unknown>>(...params: unknown[]): TRecord[];
+}
 /**
  * SQLite dependency injected into every questlog operation.
+ * Node.js `DatabaseSync` satisfies this interface directly.
  */
-type QuestlogDb = DatabaseSync;
+type QuestlogDb = {
+    exec(sql: string): void;
+    prepare(sql: string): QuestlogStatement;
+    close(): void;
+};
 
 /**
  * Creates the full standalone questlog schema, including FTS and indexing.

package/dist/index.js

@@ -3752,6 +3752,7 @@ var manageRepeatableTool = defineQuestlogTool({
   },
   outputDescription: "Returns the changed repeatable quest, due anchor preview items, or spawned quest details for the selected recurrence action. Empty previews and empty spawns return structured success or no-op results, and repeatable hiding is now intentionally routed through `retire_work`.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4019,6 +4020,7 @@ var organizeWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated questline detail or target quest detail after grouping or dependency changes. Repeated equivalent changes return structured no-op results.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4161,6 +4163,7 @@ var planQuestTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated quest detail after objective or planning changes. If the requested planning state is already present, the tool returns a structured no-op result.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4744,6 +4747,7 @@ var rewardWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated or claimed reward when one concrete reward changes, or a structured success result for repeatable future template replacement. Already-claimed rewards return a structured no-op for claim and an error for invalid update or remove attempts.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -4997,6 +5001,7 @@ var runQuestTool = defineQuestlogTool({
   },
   outputDescription: "Returns the updated quest detail after the selected lifecycle action, plus purpose-shaped primary, updated, and created refs when follow-up work is spawned. Safe repeated starts return structured no-op results.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -5407,6 +5412,7 @@ var shapeWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the changed or created rumor, quest, questline, or created quest set for the selected shape-work action, plus purpose-shaped primary and created or updated refs. Repeated safe actions return structured no-op results, and rumor settlement can ask for missing structure instead of failing.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {
@@ -5693,6 +5699,7 @@ var tagWorkTool = defineQuestlogTool({
   },
   outputDescription: "Returns the normalized final tag set for the target after the selected tag action. Repeated equivalent changes return structured no-op results.",
   inputSchema: {
+    type: "object",
     oneOf: [
       objectSchema(
         {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@ghostpaw/questlog",
-	"version": "0.1.0",
+	"version": "0.2.0",
 	"description": "Unified task and calendar model for Node.js — SQLite, zero dependencies, with a built-in LLM tool facade",
 	"type": "module",
 	"exports": {
@@ -32,6 +32,9 @@
 		"typecheck": "tsc --noEmit",
 		"check": "biome check && tsc --noEmit",
 		"clean": "rm -rf dist",
+		"demo:build": "node scripts/build_demo.mjs",
+		"demo:watch": "node scripts/build_demo.mjs --watch",
+		"demo:serve": "npm run demo:build && node scripts/serve_demo.mjs",
 		"prepublishOnly": "npm run check && npm run build",
 		"release:patch": "npm version patch && git push && git push --tags",
 		"release:minor": "npm version minor && git push && git push --tags",
@@ -84,6 +87,9 @@
 	"devDependencies": {
 		"@biomejs/biome": "2.4.4",
 		"@types/node": "^25.3.0",
+		"esbuild": "^0.27.4",
+		"preact": "^10.29.0",
+		"sql.js-fts5": "^1.4.0",
 		"tsup": "^8.0.0",
 		"typescript": "^5.9.3"
 	}