@bitcobblers/wod-wiki-tools 0.53.2204 → 0.54.2205

package/dist/bin/wod.mjs

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 import { createRequire } from 'module';
-import { cliMain } from '../chunk-SLCRIGUR.mjs';
-import '../chunk-5NNSHRMZ.mjs';
+import { cliMain } from '../chunk-KXNK4PIB.mjs';
 import '../chunk-KGP6STLY.mjs';
 import '../chunk-FUISPA7A.mjs';
+import '../chunk-T7VB7PPO.mjs';
 import '../chunk-QUUX6NX2.mjs';
 
 if (typeof globalThis.require === 'undefined') {

package/dist/{chunk-LNBKPHEP.mjs → chunk-AS6OJRNH.mjs}

@@ -1,5 +1,5 @@
 import { createRequire } from 'module';
-import { createHandler } from './chunk-2EWCEE6N.mjs';
+import { createHandler } from './chunk-WLCUM7KO.mjs';
 import { openCliDb, nodePath, nodeFs } from './chunk-FUISPA7A.mjs';
 import http from 'http';
 import { Readable } from 'stream';
@@ -129,7 +129,12 @@ async function runCliServer(mode, options, writeOut) {
   try {
     const dist = resolveDist(mode, options);
     const feedDir = mode === "server" && options.database?.kind === "sqlite" ? `${options.database.path}.feed` : void 0;
-    const handler = createHandler(db?.db ?? null, { playgroundDist: dist, feedDir });
+    const handler = createHandler(db?.db ?? null, {
+      playgroundDist: dist,
+      feedDir,
+      mcpReadonly: options.mcpReadonly === true || options.env.WOD_MCP_READONLY === "1",
+      mcpToken: options.env.WOD_MCP_TOKEN?.trim()
+    });
     server = await startHttpServer(handler, host, port);
     if (mode === "server") {
       writeOut(`wod server: http://${host}:${port} \u2014 ${dbLabel} \xB7 dist ${dist}`);
@@ -162,5 +167,5 @@ async function runCliServer(mode, options, writeOut) {
 }
 
 export { runCliServer };
-//# sourceMappingURL=chunk-LNBKPHEP.mjs.map
-//# sourceMappingURL=chunk-LNBKPHEP.mjs.map
+//# sourceMappingURL=chunk-AS6OJRNH.mjs.map
+//# sourceMappingURL=chunk-AS6OJRNH.mjs.map

package/dist/chunk-AS6OJRNH.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/server.ts"],"names":["dist"],"mappings":"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","file":"chunk-AS6OJRNH.mjs","sourcesContent":["/**\n * server.ts — `wod server` (alias `serve`) / `wod playground` (Bun-only front\n * door).\n *\n * Serves the packaged engine stack: the shared fetch handler shipped in this\n * package (the same code the Docker image serves) plus the frontend build\n * packaged under the engine's dist/web/ — no repository checkout, no runtime\n * build.\n *\n * server      probes the configured database first (never creates schema —\n *             that's `wod init`), then serves API + SPA.\n * playground  serves the browser-storage SPA build and never opens a database\n *             (every /api request answers 404).\n *\n * Retains the event loop until SIGINT/SIGTERM; shutdown drains in-flight\n * requests before closing the database.\n */\n\nimport http from 'node:http';\nimport { Readable } from 'node:stream';\nimport { openCliDb, nodeFs, nodePath } from './db';\nimport type { CliDatabaseConfig } from './config';\nimport type { CliDb } from './db';\nimport { createHandler } from '../server/app';\ntype WriteOut = (text: string) => void;\n\nexport type CliServerMode = 'server' | 'playground';\n\nexport interface CliServerOptions {\n  /** Resolved database configuration. REQUIRED for 'server'; ignored — never\n   * opened or validated — for 'playground'. */\n  database?: CliDatabaseConfig;\n  host?: string;\n  port?: string;\n  /** Explicit dist directory (flag or PLAYGROUND_DIST); must already exist. */\n  dist?: string;\n  /** Restrict `/api/mcp` to Tier 0 read-only tools. */\n  mcpReadonly?: boolean;\n  /** Merged CLI environment (process env + .env). */\n  env: Record<string, string | undefined>;\n}\n\ninterface HttpServerLike {\n  stop(): Promise<void>;\n}\n\nfunction withResolvers<T>() {\n  let resolve!: (value: T | PromiseLike<T>) => void;\n  let reject!: (reason?: unknown) => void;\n  const promise = new Promise<T>((res, rej) => {\n    resolve = res;\n    reject = rej;\n  });\n  return { promise, resolve, reject };\n}\n\nfunction startHttpServer(\n  handler: (request: Request) => Promise<Response>,\n  host: string,\n  port: number,\n): Promise<HttpServerLike> {\n  const b = (globalThis as { Bun?: { serve(opts: { port: number; hostname: string; fetch: (req: Request) => Promise<Response> }): { stop(): Promise<void> } } }).Bun;\n  if (b?.serve) {\n    const s = b.serve({ port, hostname: host, fetch: handler });\n    return Promise.resolve({ stop: () => s.stop() });\n  }\n\n  // ponytail: node:http adapter streams Web Request/Response in pure Node (v18+) without express/fastify dependencies\n  const { promise, resolve, reject } = withResolvers<HttpServerLike>();\n  const server = http.createServer(async (req, res) => {\n    try {\n      const url = new URL(req.url || '/', `http://${req.headers.host || `${host}:${port}`}`);\n      const hasBody = req.method !== 'GET' && req.method !== 'HEAD';\n      const webReq = new Request(url, {\n        method: req.method,\n        headers: req.headers as Record<string, string>,\n        body: hasBody ? (Readable.toWeb(req) as unknown as BodyInit) : null,\n        ...(hasBody ? { duplex: 'half' } : {}),\n      } as RequestInit);\n      const webRes = await handler(webReq);\n      res.writeHead(webRes.status, Object.fromEntries(webRes.headers.entries()));\n      if (webRes.body) {\n        Readable.fromWeb(webRes.body as any).pipe(res);\n      } else {\n        res.end();\n      }\n    } catch {\n      res.statusCode = 500;\n      res.end('internal server error');\n    }\n  });\n\n  server.once('error', reject);\n  server.listen(port, host, () => {\n    resolve({\n      stop: () => {\n        const close = withResolvers<void>();\n        server.close(() => close.resolve());\n        return close.promise;\n      },\n    });\n  });\n  return promise;\n}\n\n/**\n * This module's directory, robust across shipped layouts: ESM via\n * import.meta.url (works under node and Bun; esbuild shims it in CJS too) and\n * Bun's import.meta.dir. ESM code splitting may relocate this module to a\n * chunk at dist/ root, so never assume dist/cli.\n */\nfunction moduleDir(): string {\n  const p = nodePath();\n  const meta: { dir?: unknown; url?: unknown } = import.meta; // Bun adds `dir`; the TS lib knows neither.\n  if (typeof meta.dir === 'string') return p.resolve(meta.dir);\n  if (typeof meta.url === 'string' && meta.url.startsWith('file:')) {\n    return p.resolve(p.dirname(decodeURIComponent(new URL('.', meta.url).pathname)));\n  }\n  throw new Error('wod server/playground: cannot determine the installed engine module directory');\n}\n\n/**\n * The installed engine package root: nearest enclosing package.json belonging\n * to this package, walking up from the executing module (dist/cli, a split\n * chunk at dist/ root, dist/bin, or src/cli in a checkout).\n */\nfunction engineRoot(): string {\n  const p = nodePath();\n  const fs = nodeFs();\n  for (let dir = moduleDir(); ; dir = p.dirname(dir)) {\n    try {\n      if (JSON.parse(fs.readFileSync(p.resolve(dir, 'package.json'), 'utf8')).name === '@bitcobblers/wod-wiki-tools') return dir;\n    } catch { /* no manifest here — keep walking */ }\n    const parent = p.dirname(dir);\n    if (parent === dir) break;\n  }\n  throw new Error('wod server/playground: cannot locate the installed @bitcobblers/wod-wiki-tools package');\n}\n\n/**\n * Resolve the frontend dist directory. The packaged default lives inside the\n * installed engine module (dist/web/server or dist/web/playground); an\n * explicit --dist/PLAYGROUND_DIST is cwd-relative and must already contain a\n * built SPA (index.html). Nothing is built at runtime.\n */\nfunction resolveDist(mode: CliServerMode, options: CliServerOptions): string {\n  const p = nodePath();\n  const explicit = options.dist?.trim() || options.env.PLAYGROUND_DIST?.trim() || undefined;\n  if (explicit) {\n    const dist = p.resolve(explicit); // cwd-relative override\n    if (!nodeFs().existsSync(p.resolve(dist, 'index.html'))) {\n      throw new Error(\n        `wod ${mode}: no built frontend (index.html) at ${dist} — --dist/PLAYGROUND_DIST must `\n        + 'point at an already-built directory (the CLI never builds frontends at runtime)',\n      );\n    }\n    return dist;\n  }\n  const dist = p.resolve(engineRoot(), 'dist', 'web', mode === 'playground' ? 'playground' : 'server');\n  if (!nodeFs().existsSync(p.resolve(dist, 'index.html'))) {\n    throw new Error(\n      `wod ${mode}: packaged frontend missing — expected ${dist}/index.html. `\n      + 'Reinstall @bitcobblers/wod-wiki-tools (bun add @bitcobblers/wod-wiki-tools), '\n      + 'or rebuild the release assets from a checkout (bun run build:cli) and reinstall the package.',\n    );\n  }\n  return dist;\n}\n\n/** Validate bind address first: flag > HOST/PORT env > loopback:3000. */\nfunction resolveBind(mode: CliServerMode, options: CliServerOptions): { host: string; port: number } {\n  const host = options.host?.trim() || options.env.HOST?.trim() || '127.0.0.1';\n  const rawPort = options.port?.trim() || options.env.PORT?.trim() || '3000';\n  const port = Number(rawPort);\n  if (!Number.isInteger(port) || port < 1 || port > 65535) {\n    throw new Error(`wod ${mode}: invalid port ${JSON.stringify(rawPort)} (need integer 1..65535)`);\n  }\n  return { host, port };\n}\n\n/**\n * Start the shared server for `wod server` / `wod playground`. Throws on any\n * startup failure; on success it never returns until SIGINT/SIGTERM (drain,\n * close database, exit 0).\n */\nexport async function runCliServer(\n  mode: CliServerMode,\n  options: CliServerOptions,\n  writeOut: WriteOut,\n): Promise<void> {\n  const { host, port } = resolveBind(mode, options); // Validate bind before opening anything.\n\n  // Server probes the database BEFORE binding a socket: a missing/uninitialized\n  // database refuses with `wod init` guidance.\n  let db: CliDb | undefined;\n  let dbLabel = 'no database';\n  if (mode === 'server') {\n    const database = options.database; // hoisted so the guard's narrowing sticks\n    if (!database) {\n      throw new Error('wod server: no database configuration resolved — this is a runner bug (expected resolveDatabaseConfig output)');\n    }\n    try {\n      db = await openCliDb(database, { initialize: false });\n    } catch (e) {\n      const message = e instanceof Error ? e.message : String(e);\n      throw new Error(`wod server: database not ready — run \\`wod init\\` first. ${message}`, { cause: e });\n    }\n    dbLabel = db.path;\n  }\n\n  let server: HttpServerLike;\n  try {\n    const dist = resolveDist(mode, options);\n    // Bundled server handler; persist self-hosted published feed next to local SQLite DB when applicable\n    const feedDir =\n      mode === 'server' && options.database?.kind === 'sqlite'\n        ? `${options.database.path}.feed`\n        : undefined;\n    const handler = createHandler(db?.db ?? null, {\n      playgroundDist: dist,\n      feedDir,\n      mcpReadonly: options.mcpReadonly === true || options.env.WOD_MCP_READONLY === '1',\n      mcpToken: options.env.WOD_MCP_TOKEN?.trim(),\n    });\n    server = await startHttpServer(handler, host, port);\n    if (mode === 'server') {\n      writeOut(`wod server: http://${host}:${port} — ${dbLabel} · dist ${dist}`);\n    } else {\n      writeOut(`wod playground: http://${host}:${port} — in-browser storage (no database) · dist ${dist}`);\n    }\n  } catch (e) {\n    if (db) await db.close(); // never leak the probe connection when startup fails\n    throw e;\n  }\n\n  let closing = false;\n  const shutdown = async (): Promise<void> => {\n    if (closing) process.exit(0); // second signal forces the exit\n    closing = true;\n    try {\n      await server.stop();\n    } finally {\n      if (db) await db.close();\n      process.exit(0);\n    }\n  };\n  process.on('SIGINT', () => { void shutdown(); });\n  process.on('SIGTERM', () => { void shutdown(); });\n\n  // Park until a signal handler exits the process.\n  await new Promise<never>(() => {});\n}\n"]}

package/dist/{chunk-SLCRIGUR.mjs → chunk-KXNK4PIB.mjs}

@@ -1,7 +1,7 @@
 import { createRequire } from 'module';
-import { VERSION } from './chunk-5NNSHRMZ.mjs';
 import { writeBuildReport } from './chunk-KGP6STLY.mjs';
 import { nodePath, openCliDb, nodeFs, sqliteIndexStore, sqliteEffortStore, sqliteBlockStore, sqliteNoteStore, sqliteEventStore, getNoteBundle, getSessionBundle, getEffortBySlug, getEquipmentBySlug, listTagsByType, uuid5, CLI_UUID_NAMESPACE, NodeFsFeedTree, stableNoteId, randomId, nodeCrypto } from './chunk-FUISPA7A.mjs';
+import { VERSION } from './chunk-T7VB7PPO.mjs';
 import { __require } from './chunk-QUUX6NX2.mjs';
 import { createParser, frozenNow, createCompiler, createMockClock, RuntimeStack, EventBus, ScriptRuntime, createAnalyticsEngineForBlock, StartSessionAction, NextEvent, toStoredOutputStatement, bundledEfforts, parseEffortFile, parseEquipmentFile, createReferenceIndex, parseScript, extractStatementRefs } from '@bitcobblers/wod-wiki-lang';
 import { buildStatementTree, createIRFile, registerLanguagePack, extractNoteIdentity, extractTypedTags, composeNoteMarkdown, serializeNoteBundleToJsonl, sessionToCsv, effortToMarkdown, equipmentToMarkdown, equipmentToCsv, csvToEquipmentLabels, ingestPortableFilesIntoStorage, csvToSessionRows, isIRFile, inMemoryEventStore, publishFeedFromStorage, assertSeedManifest, seedMetaKey, SEED_SCHEMA, emptySeedMeta, CANVAS_CHUNK_ID, assertSeedRows, seedNoteId, applySeedChunk } from '@bitcobblers/wod-wiki-engine';
@@ -2024,7 +2024,23 @@ var VALUE_FLAGS = [
   ["--env-file", "envFile"],
   ["--host", "host"],
   ["--port", "port"],
-  ["--dist", "dist"]
+  ["--dist", "dist"],
+  ["--server", "serverUrl"],
+  ["--note", "noteId"],
+  ["--source-note", "sourceNoteId"],
+  ["--block", "blockId"],
+  ["--notebook", "notebook"],
+  ["--date", "date"],
+  ["--title", "title"],
+  ["--description", "description"],
+  ["--markdown", "markdown"],
+  ["--search", "search"],
+  ["--tag", "tag"],
+  ["--slug", "slug"],
+  ["--category", "category"],
+  ["--type", "tagType"],
+  ["--url", "url"],
+  ["--feed-id", "feedId"]
 ];
 function readValueFlag(args, i, flag) {
   const inline = args[i].startsWith(`${flag}=`);
@@ -2041,7 +2057,10 @@ function parseCliArgs(args) {
   const result = {
     format: "json",
     packs: [],
-    sources: []
+    sources: [],
+    tags: [],
+    aliases: [],
+    setPairs: []
   };
   const valueArgs = result;
   let i = 0;
@@ -2149,8 +2168,50 @@ function parseCliArgs(args) {
       const v = Number(arg.slice("--seed-version=".length));
       if (Number.isSafeInteger(v) && v >= 0) result.seedVersion = v;
       i++;
+    } else if (arg === "--json") {
+      result.json = true;
+      result.format = "json";
+      i++;
+    } else if (arg === "--no-save") {
+      result.noSave = true;
+      i++;
+    } else if (arg === "--mcp-readonly" || arg === "--readonly") {
+      result.mcpReadonly = true;
+      i++;
+    } else if (arg === "--validate-only") {
+      result.validateOnly = true;
+      i++;
+    } else if (arg === "--limit") {
+      const v = Number(args[++i]);
+      if (Number.isSafeInteger(v) && v > 0) result.limit = v;
+      i++;
+    } else if (arg.startsWith("--limit=")) {
+      const v = Number(arg.slice("--limit=".length));
+      if (Number.isSafeInteger(v) && v > 0) result.limit = v;
+      i++;
+    } else if (arg === "--tags") {
+      const raw = args[++i] ?? "";
+      result.tags.push(...raw.split(",").map((t) => t.trim()).filter(Boolean));
+      i++;
+    } else if (arg.startsWith("--tags=")) {
+      result.tags.push(...arg.slice("--tags=".length).split(",").map((t) => t.trim()).filter(Boolean));
+      i++;
+    } else if (arg === "--alias") {
+      const raw = args[++i];
+      if (raw) result.aliases.push(raw);
+      i++;
+    } else if (arg.startsWith("--alias=")) {
+      result.aliases.push(arg.slice("--alias=".length));
+      i++;
+    } else if (arg === "--set") {
+      const raw = args[++i];
+      if (raw) result.setPairs.push(raw);
+      i++;
+    } else if (arg.startsWith("--set=")) {
+      result.setPairs.push(arg.slice("--set=".length));
+      i++;
     } else if (!result.subcommand) {
-      if (arg === "parse" || arg === "run" || arg === "query" || arg === "download" || arg === "export" || arg === "import" || arg === "publish" || arg === "build" || arg === "seed" || arg === "reset" || arg === "init" || arg === "db" || arg === "server" || arg === "serve" || arg === "playground" || arg === "init-feed" || arg === "skills" || arg === "help" || arg === "version") {
+      if (arg === "parse" || arg === "run" || arg === "query" || arg === "download" || arg === "export" || arg === "import" || arg === "publish" || arg === "build" || arg === "seed" || arg === "reset" || arg === "init" || arg === "db" || arg === "server" || arg === "serve" || arg === "playground" || arg === "init-feed" || arg === "skills" || arg === "note" || arg === "journal" || arg === "notebook" || arg === "session" || arg === "catalog" || arg === "tag" || arg === "feed" || arg === "mcp" || arg === "tools" || arg === "doctor" || arg === "help" || arg === "version") {
         result.subcommand = arg;
       } else {
         result.target = arg;
@@ -2162,6 +2223,9 @@ function parseCliArgs(args) {
     } else if (!result.target2) {
       result.target2 = arg;
       i++;
+    } else if (!result.target3) {
+      result.target3 = arg;
+      i++;
     } else {
       i++;
     }
@@ -2272,9 +2336,22 @@ DB OPTIONS (for 'wod db'):
                       actions; credentials are never printed to stdout
 
   wod server [options]
-                      Serve the app (HTTP API + packaged frontend; alias: serve)
+                      Serve the app (HTTP API + /api/mcp + packaged frontend; alias: serve)
   wod playground [options]
-                      Serve the local playground (browser IndexedDB build)
+                      Serve the local playground (browser IndexedDB build + WebMCP)
+  wod mcp [--readonly] [--server <url>]
+                      Start the official MCP server over stdio for Claude/Cursor/Codex
+
+AGENT NOUN-VERB COMMANDS (all support --json and --server <url>):
+  wod note <list|get|create|update|clone|delete> [args]
+  wod journal <day|add> [date] [options]
+  wod notebook <list|save|delete> [slug] [options]
+  wod session <list|get|run|delete> [id] [options]
+  wod catalog <lookup|get|upsert> [effort|equipment|tag|tag-type] [name]
+  wod tag <list|upsert> [label] [--type <tagType>]
+  wod feed <list|status|subscribe|sync|unsubscribe|publish> [options]
+  wod tools <list|manifest> [--json]
+  wod doctor [--json]
 
 SUBCOMMANDS:
   parse <file | ->    Parse Whiteboard Script, create a note in the database
@@ -2405,6 +2482,7 @@ EXIT CODES:
   1 - General / Runtime error
   2 - Parse / Syntax error
   3 - Language Pack load error
+  4 - Destructive confirmation required (pass --yes <targetId>)
 `;
 }
 function printUsage(writer) {
@@ -2474,7 +2552,7 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         writeErr("[wod init-feed] Error: Missing feed name (a single new directory name)");
         return 1;
       }
-      const { scaffoldFeed } = await import('./scaffoldFeed-TCRNXYQU.mjs');
+      const { scaffoldFeed } = await import('./scaffoldFeed-D55NINVJ.mjs');
       try {
         const result = scaffoldFeed(parsed.target);
         writeOut(`[wod init-feed] Created ${result.dir} (${result.files.length} files)`);
@@ -2538,22 +2616,32 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
       }
       const noteSource = cliNoteSource(source, parsed.target, parsed.sport);
       const ir = runParse(source, { sport: parsed.sport, sourceLabel: `cli:wod parse ${parsed.target}` });
-      const identity = extractNoteIdentity(source);
-      const tags = extractTypedTags(source);
-      const db = await openCliDb(cliDb());
-      try {
-        const persisted = await persistNote(db, {
-          source: noteSource,
-          sourceLabel: parsed.target,
-          noteId: identity?.noteId,
-          title: identity?.title,
-          tags
-        });
-        writeOut(
-          `[wod parse] note ${persisted.noteId}${persisted.created ? "" : " (updated)"} \u2014 ${persisted.blocks} blocks, ${persisted.efforts} efforts${persisted.tags > 0 ? `, ${persisted.tags} tags` : ""} \u2192 ${db.path}`
-        );
-      } finally {
-        await db.close();
+      if (!parsed.noSave) {
+        const identity = extractNoteIdentity(source);
+        const tags = extractTypedTags(source);
+        const db = await openCliDb(cliDb());
+        try {
+          const persisted = await persistNote(db, {
+            source: noteSource,
+            sourceLabel: parsed.target,
+            noteId: identity?.noteId,
+            title: identity?.title,
+            tags
+          });
+          if (!parsed.json) {
+            writeOut(
+              `[wod parse] note ${persisted.noteId}${persisted.created ? "" : " (updated)"} \u2014 ${persisted.blocks} blocks, ${persisted.efforts} efforts${persisted.tags > 0 ? `, ${persisted.tags} tags` : ""} \u2192 ${db.path}`
+            );
+          } else if (!parsed.output) {
+            deliverOutput(JSON.stringify({ ok: true, persisted, ir }, null, 2));
+          }
+        } finally {
+          await db.close();
+        }
+      } else if (parsed.json && !parsed.output) {
+        deliverOutput(formatParseOutput(ir, "json", true));
+      } else if (!parsed.output) {
+        writeOut(`[wod parse] valid Whiteboard Script (--no-save)`);
       }
       if (parsed.output) {
         const pretty = Boolean(process.stdout.isTTY);
@@ -2563,8 +2651,18 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
       return 0;
     }
     if (parsed.subcommand === "run") {
+      if (parsed.noteId && !parsed.target) {
+        const { runAgentNounVerbCommand } = await import('./agentCommands-AMMASJPH.mjs');
+        return runAgentNounVerbCommand({
+          parsed: { ...parsed, subcommand: "session", target: "run", target2: parsed.noteId },
+          resolveDbConfig: cliDb,
+          readStdin: getStdin,
+          writeOut,
+          writeErr
+        });
+      }
       if (!parsed.target) {
-        writeErr('[wod run] Error: Missing input file or "-" for stdin');
+        writeErr('[wod run] Error: Missing input file, "-" for stdin, or --note <noteId>');
         return 1;
       }
       let source;
@@ -2620,6 +2718,18 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         writeErr("[wod query] Error: Missing WQL query argument");
         return 1;
       }
+      if (parsed.validateOnly) {
+        const { wodValidateWqlTool } = await import('@bitcobblers/wod-wiki-engine/agent');
+        const validation = await wodValidateWqlTool.execute({ query: parsed.target }, {
+          storage: void 0
+        });
+        if (parsed.json || parsed.format === "json") {
+          deliverOutput(JSON.stringify(validation, null, 2));
+        } else {
+          writeOut(validation.valid ? `[wod query] valid (${validation.family ?? "wql"})` : `[wod query] invalid: ${validation.error}`);
+        }
+        return validation.valid ? 0 : 2;
+      }
       const useDb = !parsed.corpus && !parsed.stdinLog && !parsed.stdinFacts;
       let stdinLogContent;
       let stdinFactsContent;
@@ -2947,10 +3057,20 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
         );
         return 1;
       }
+      if (parsed.yes !== void 0 && parsed.yes !== "RESET") {
+        writeErr("[wod reset] Invalid --yes value (expected: --yes RESET)");
+        return 4;
+      }
       const target = config.path;
       if (nodeFs().existsSync(target)) {
         nodeFs().unlinkSync(target);
-        writeOut(`[wod reset] removed ${target}`);
+        if (parsed.json) {
+          writeOut(JSON.stringify({ ok: true, removed: true, path: target }, null, 2));
+        } else {
+          writeOut(`[wod reset] removed ${target}`);
+        }
+      } else if (parsed.json) {
+        writeOut(JSON.stringify({ ok: true, removed: false, path: target }, null, 2));
       } else {
         writeOut(`[wod reset] nothing to reset \u2014 ${target} does not exist`);
       }
@@ -2989,15 +3109,35 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
     }
     if (parsed.subcommand === "server" || parsed.subcommand === "serve" || parsed.subcommand === "playground") {
       const mode = parsed.subcommand === "playground" ? "playground" : "server";
-      const { runCliServer } = await import('./server-SHNWCIIM.mjs');
+      const { runCliServer } = await import('./server-2GTVPJDA.mjs');
       const options = { env: cliEnv() };
       if (mode === "server") options.database = cliDb();
       if (parsed.host !== void 0) options.host = parsed.host;
       if (parsed.port !== void 0) options.port = parsed.port;
       if (parsed.dist !== void 0) options.dist = parsed.dist;
+      if (parsed.mcpReadonly === true) options.mcpReadonly = true;
       await runCliServer(mode, options, writeOut);
       return 0;
     }
+    if (parsed.subcommand === "mcp") {
+      const { runMcpStdio } = await import('./mcp-D6QARYOG.mjs');
+      return runMcpStdio({
+        database: parsed.serverUrl ? void 0 : cliDb(),
+        serverUrl: parsed.serverUrl,
+        readonly: parsed.mcpReadonly === true || cliEnv().WOD_MCP_READONLY === "1",
+        writeErr
+      });
+    }
+    if (parsed.subcommand === "note" || parsed.subcommand === "journal" || parsed.subcommand === "notebook" || parsed.subcommand === "session" || parsed.subcommand === "catalog" || parsed.subcommand === "tag" || parsed.subcommand === "feed" || parsed.subcommand === "tools" || parsed.subcommand === "doctor") {
+      const { runAgentNounVerbCommand } = await import('./agentCommands-AMMASJPH.mjs');
+      return runAgentNounVerbCommand({
+        parsed,
+        resolveDbConfig: cliDb,
+        readStdin: getStdin,
+        writeOut,
+        writeErr
+      });
+    }
     writeErr(`[wod] Unknown subcommand "${parsed.subcommand}"`);
     return 1;
   } catch (error) {
@@ -3015,5 +3155,5 @@ async function cliMain(argv = process.argv.slice(2), io = {}) {
 }
 
 export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli };
-//# sourceMappingURL=chunk-SLCRIGUR.mjs.map
-//# sourceMappingURL=chunk-SLCRIGUR.mjs.map
+//# sourceMappingURL=chunk-KXNK4PIB.mjs.map
+//# sourceMappingURL=chunk-KXNK4PIB.mjs.map