@bitcobblers/wod-wiki-tools 0.53.2204 → 0.55.2206

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-76CB4MGO.mjs';
 import '../chunk-KGP6STLY.mjs';
 import '../chunk-FUISPA7A.mjs';
+import '../chunk-WKU3MRQI.mjs';
 import '../chunk-QUUX6NX2.mjs';
 
 if (typeof globalThis.require === 'undefined') {

package/dist/chunk-67JAEWEF.mjs

@@ -0,0 +1,144 @@
+import { createRequire } from 'module';
+import { VERSION } from './chunk-WKU3MRQI.mjs';
+import { z } from 'zod';
+import { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { DOMAIN_AGENT_TOOLS, AGENT_STATIC_RESOURCES, readAgentResource, AGENT_RESOURCE_TEMPLATES, AGENT_PROMPTS, renderAgentPrompt } from '@bitcobblers/wod-wiki-engine/agent';
+
+if (typeof globalThis.require === 'undefined') {
+  try { globalThis.require = createRequire(import.meta.url); } catch {}
+}
+function createWodMcpServer(options) {
+  const server = new McpServer(
+    {
+      name: "wod-wiki",
+      version: VERSION
+    },
+    {
+      capabilities: {
+        tools: {},
+        resources: {},
+        prompts: {}
+      }
+    }
+  );
+  const ctx = {
+    storage: options.storage,
+    feedTree: options.feedTree,
+    baseUrl: options.baseUrl,
+    onMutated: options.onMutated
+    // Over MCP HTTP/stdio, explicit confirm="<targetId>" inside tool arguments
+    // satisfies Tier 2 confirmation; when omitted, requireAgentConfirmation throws
+    // an actionable error instructing the caller to pass confirm="<targetId>".
+  };
+  for (const spec of DOMAIN_AGENT_TOOLS) {
+    if (options.readonly && spec.tier !== 0) {
+      continue;
+    }
+    server.registerTool(
+      spec.name,
+      {
+        title: spec.title,
+        description: spec.description,
+        inputSchema: spec.inputSchema,
+        annotations: spec.annotations
+      },
+      async (args) => {
+        try {
+          const parsed = spec.inputSchema.parse(args ?? {});
+          const result = await spec.execute(parsed, ctx);
+          return {
+            content: [
+              {
+                type: "text",
+                text: JSON.stringify(result, null, 2)
+              }
+            ],
+            structuredContent: result
+          };
+        } catch (err) {
+          const message = err instanceof Error ? err.message : String(err);
+          return {
+            isError: true,
+            content: [
+              {
+                type: "text",
+                text: message
+              }
+            ]
+          };
+        }
+      }
+    );
+  }
+  for (const resource of AGENT_STATIC_RESOURCES) {
+    server.registerResource(
+      resource.name,
+      resource.uri,
+      {
+        description: resource.description,
+        mimeType: resource.mimeType
+      },
+      async (uri) => {
+        const res = await readAgentResource(uri.toString(), ctx);
+        return {
+          contents: [
+            {
+              uri: res.uri,
+              mimeType: res.mimeType,
+              text: res.text
+            }
+          ]
+        };
+      }
+    );
+  }
+  for (const tmpl of AGENT_RESOURCE_TEMPLATES) {
+    const template = new ResourceTemplate(tmpl.uriTemplate, { list: void 0 });
+    server.registerResource(
+      tmpl.name,
+      template,
+      {
+        description: tmpl.description,
+        mimeType: tmpl.mimeType
+      },
+      async (uri) => {
+        const res = await readAgentResource(uri.toString(), ctx);
+        return {
+          contents: [
+            {
+              uri: res.uri,
+              mimeType: res.mimeType,
+              text: res.text
+            }
+          ]
+        };
+      }
+    );
+  }
+  for (const prompt of AGENT_PROMPTS) {
+    const argsShape = {};
+    for (const arg of prompt.arguments) {
+      argsShape[arg.name] = arg.required ? z.string().describe(arg.description) : z.string().optional().describe(arg.description);
+    }
+    server.registerPrompt(
+      prompt.name,
+      {
+        title: prompt.title,
+        description: prompt.description,
+        argsSchema: argsShape
+      },
+      async (args) => {
+        const rendered = renderAgentPrompt(prompt.name, args);
+        return {
+          description: rendered.description,
+          messages: rendered.messages
+        };
+      }
+    );
+  }
+  return server;
+}
+
+export { createWodMcpServer };
+//# sourceMappingURL=chunk-67JAEWEF.mjs.map
+//# sourceMappingURL=chunk-67JAEWEF.mjs.map

package/dist/chunk-67JAEWEF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp/createWodMcpServer.ts"],"names":[],"mappings":"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","file":"chunk-67JAEWEF.mjs","sourcesContent":["import { z } from 'zod';\nimport { McpServer, ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { IStorage } from '@bitcobblers/wod-wiki-storage';\nimport type { FeedTree } from '@bitcobblers/wod-wiki-engine';\nimport {\n  AGENT_PROMPTS,\n  AGENT_RESOURCE_TEMPLATES,\n  AGENT_STATIC_RESOURCES,\n  DOMAIN_AGENT_TOOLS,\n  readAgentResource,\n  renderAgentPrompt,\n  type AgentDomainContext,\n} from '@bitcobblers/wod-wiki-engine/agent';\nimport { VERSION } from '../version';\n\nexport interface CreateWodMcpServerOptions {\n  storage: IStorage;\n  feedTree?: FeedTree;\n  baseUrl?: string;\n  readonly?: boolean;\n  onMutated?: () => Promise<void> | void;\n}\n\n/**\n * Creates a configured official `@modelcontextprotocol/sdk` `McpServer`\n * exposing all 22 WOD Wiki domain tools (or read-only Tier 0 tools when\n * `readonly: true`), `wod://*` resources, and guided workout prompts.\n */\nexport function createWodMcpServer(options: CreateWodMcpServerOptions): McpServer {\n  const server = new McpServer(\n    {\n      name: 'wod-wiki',\n      version: VERSION,\n    },\n    {\n      capabilities: {\n        tools: {},\n        resources: {},\n        prompts: {},\n      },\n    },\n  );\n\n  const ctx: AgentDomainContext = {\n    storage: options.storage,\n    feedTree: options.feedTree,\n    baseUrl: options.baseUrl,\n    onMutated: options.onMutated,\n    // Over MCP HTTP/stdio, explicit confirm=\"<targetId>\" inside tool arguments\n    // satisfies Tier 2 confirmation; when omitted, requireAgentConfirmation throws\n    // an actionable error instructing the caller to pass confirm=\"<targetId>\".\n  };\n\n  for (const spec of DOMAIN_AGENT_TOOLS) {\n    if (options.readonly && spec.tier !== 0) {\n      continue;\n    }\n\n    server.registerTool(\n      spec.name,\n      {\n        title: spec.title,\n        description: spec.description,\n        inputSchema: spec.inputSchema,\n        annotations: spec.annotations,\n      },\n      async (args: unknown) => {\n        try {\n          const parsed = spec.inputSchema.parse(args ?? {});\n          const result = await spec.execute(parsed, ctx);\n          return {\n            content: [\n              {\n                type: 'text' as const,\n                text: JSON.stringify(result, null, 2),\n              },\n            ],\n            structuredContent: result as Record<string, unknown>,\n          };\n        } catch (err) {\n          const message = err instanceof Error ? err.message : String(err);\n          return {\n            isError: true,\n            content: [\n              {\n                type: 'text' as const,\n                text: message,\n              },\n            ],\n          };\n        }\n      },\n    );\n  }\n\n  for (const resource of AGENT_STATIC_RESOURCES) {\n    server.registerResource(\n      resource.name,\n      resource.uri,\n      {\n        description: resource.description,\n        mimeType: resource.mimeType,\n      },\n      async (uri) => {\n        const res = await readAgentResource(uri.toString(), ctx);\n        return {\n          contents: [\n            {\n              uri: res.uri,\n              mimeType: res.mimeType,\n              text: res.text,\n            },\n          ],\n        };\n      },\n    );\n  }\n\n  for (const tmpl of AGENT_RESOURCE_TEMPLATES) {\n    const template = new ResourceTemplate(tmpl.uriTemplate, { list: undefined });\n    server.registerResource(\n      tmpl.name,\n      template,\n      {\n        description: tmpl.description,\n        mimeType: tmpl.mimeType,\n      },\n      async (uri) => {\n        const res = await readAgentResource(uri.toString(), ctx);\n        return {\n          contents: [\n            {\n              uri: res.uri,\n              mimeType: res.mimeType,\n              text: res.text,\n            },\n          ],\n        };\n      },\n    );\n  }\n\n  for (const prompt of AGENT_PROMPTS) {\n    const argsShape: Record<string, z.ZodType> = {};\n    for (const arg of prompt.arguments) {\n      argsShape[arg.name] = arg.required\n        ? z.string().describe(arg.description)\n        : z.string().optional().describe(arg.description);\n    }\n\n    server.registerPrompt(\n      prompt.name,\n      {\n        title: prompt.title,\n        description: prompt.description,\n        argsSchema: argsShape,\n      },\n      async (args) => {\n        const rendered = renderAgentPrompt(prompt.name, args as Record<string, string | undefined>);\n        return {\n          description: rendered.description,\n          messages: rendered.messages,\n        };\n      },\n    );\n  }\n\n  return server;\n}\n"]}

package/dist/{chunk-SLCRIGUR.mjs → chunk-76CB4MGO.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-WKU3MRQI.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-MC4UX4CO.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-O6WPIGLW.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-HQJMA7BU.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-XCK6B5JA.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-O6WPIGLW.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-76CB4MGO.mjs.map
+//# sourceMappingURL=chunk-76CB4MGO.mjs.map