@bitcobblers/wod-wiki-tools 0.53.2204 → 0.54.2205

package/dist/index.d.cts

@@ -1,9 +1,10 @@
-import { WodWikiIRFile, StatementNode, ExecutionLog, LanguagePack } from '@bitcobblers/wod-wiki-engine';
+import { WodWikiIRFile, StatementNode, ExecutionLog, LanguagePack, FeedTree } from '@bitcobblers/wod-wiki-engine';
 import { INowProvider, IEffort } from '@bitcobblers/wod-wiki-lang';
 import { QueryServiceStores, QueryResult, RowsQueryResult, FindQueryResult, PipelineResult } from '@bitcobblers/wod-wiki-wql';
 import { EventRecord, AnalyticsDataPoint, Session, Note, BlockIndexRow, BlockRevision } from '@bitcobblers/wod-wiki-core';
 import { IStorage } from '@bitcobblers/wod-wiki-storage';
 import { Database } from '@bitcobblers/wod-wiki-storage/sql';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 /**
  * Headless Parse Command Runner
@@ -187,17 +188,50 @@ declare function formatQueryOutput(ir: WodWikiIRFile<QueryResult | RowsQueryResu
  *   1 - Runtime error (file missing, bad arguments, execution error)
  *   2 - Parse / Syntax error (invalid Whiteboard Script or malformed WQL)
  *   3 - Pack load error (failed to import or register --pack)
+ *   4 - Destructive confirmation required (missing --yes <targetId>)
  */
 
 interface CliParsedArgs {
-    subcommand?: 'parse' | 'run' | 'query' | 'download' | 'export' | 'import' | 'publish' | 'build' | 'seed' | 'reset' | 'init' | 'db' | 'server' | 'serve' | 'playground' | 'init-feed' | 'skills' | 'help' | 'version';
+    subcommand?: 'parse' | 'run' | 'query' | 'download' | 'export' | 'import' | 'publish' | 'build' | 'seed' | 'reset' | 'init' | 'db' | 'server' | 'serve' | 'playground' | 'init-feed' | 'skills' | 'note' | 'journal' | 'notebook' | 'session' | 'catalog' | 'tag' | 'feed' | 'mcp' | 'tools' | 'doctor' | 'help' | 'version';
     target?: string;
     /** Second positional: the id (download) or file (import) after the kind. */
     target2?: string;
+    /** Third positional for noun-verb commands (e.g. `wod note update <id> <file>`). */
+    target3?: string;
     corpus?: string;
     stdinLog?: boolean;
     stdinFacts?: boolean;
     format: OutputFormat;
+    /** Emit structured JSON envelope on stdout across noun-verb and legacy commands. */
+    json?: boolean;
+    /** Skip database persistence during `wod parse --no-save`. */
+    noSave?: boolean;
+    /** Restrict `wod server` / `wod mcp` to Tier 0 read-only tools. */
+    mcpReadonly?: boolean;
+    /** Validate WQL syntax/schema without executing against data (`wod query --validate-only`). */
+    validateOnly?: boolean;
+    /** Target a running `wod server` HTTP API instead of opening a local DB (`--server <url>`). */
+    serverUrl?: string;
+    /** Explicit Note / Block / Notebook / Date / Filter options for agent noun-verb commands. */
+    noteId?: string;
+    sourceNoteId?: string;
+    blockId?: string;
+    notebook?: string;
+    date?: string;
+    title?: string;
+    description?: string;
+    markdown?: string;
+    search?: string;
+    tag?: string;
+    tags: string[];
+    aliases: string[];
+    setPairs: string[];
+    slug?: string;
+    category?: string;
+    tagType?: string;
+    url?: string;
+    feedId?: string;
+    limit?: number;
     output?: string;
     packs: string[];
     sport?: string;
@@ -401,6 +435,8 @@ interface CliServerOptions {
     port?: string;
     /** Explicit dist directory (flag or PLAYGROUND_DIST); must already exist. */
     dist?: string;
+    /** Restrict `/api/mcp` to Tier 0 read-only tools. */
+    mcpReadonly?: boolean;
     /** Merged CLI environment (process env + .env). */
     env: Record<string, string | undefined>;
 }
@@ -411,4 +447,33 @@ interface CliServerOptions {
  */
 declare function runCliServer(mode: CliServerMode, options: CliServerOptions, writeOut: WriteOut): Promise<void>;
 
-export { type CliDatabaseConfig, type CliDb, type CliParsedArgs, type CliServerMode, type CliServerOptions, type OutputFormat, PackLoadError, type ParseOptions, ParseSyntaxError, type QueryCliOptions, type RunOptions, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, openCliDb, parseCliArgs, readStdin, resolveDatabaseConfig, runCliServer, runExecution, runParse, runQueryCli };
+interface CreateWodMcpServerOptions {
+    storage: IStorage;
+    feedTree?: FeedTree;
+    baseUrl?: string;
+    readonly?: boolean;
+    onMutated?: () => Promise<void> | void;
+}
+/**
+ * Creates a configured official `@modelcontextprotocol/sdk` `McpServer`
+ * exposing all 22 WOD Wiki domain tools (or read-only Tier 0 tools when
+ * `readonly: true`), `wod://*` resources, and guided workout prompts.
+ */
+declare function createWodMcpServer(options: CreateWodMcpServerOptions): McpServer;
+
+interface HandleMcpHttpOptions {
+    db: Database;
+    feedTree: FeedTree;
+    baseUrl: string;
+    readonly?: boolean;
+    authToken?: string;
+}
+/**
+ * Handles Web-Standard Streamable HTTP MCP requests at `/api/mcp`.
+ * Uses stateless per-request `WebStandardStreamableHTTPServerTransport` with
+ * `enableJsonResponse: true` so both official MCP SDK clients and plain HTTP
+ * JSON-RPC clients work out of the box without sticky session requirements.
+ */
+declare function handleMcpHttpRequest(request: Request, options: HandleMcpHttpOptions): Promise<Response>;
+
+export { type CliDatabaseConfig, type CliDb, type CliParsedArgs, type CliServerMode, type CliServerOptions, type CreateWodMcpServerOptions, type HandleMcpHttpOptions, type OutputFormat, PackLoadError, type ParseOptions, ParseSyntaxError, type QueryCliOptions, type RunOptions, WqlSyntaxError, cliMain, createWodMcpServer, formatExecutionOutput, formatParseOutput, formatQueryOutput, handleMcpHttpRequest, loadCliEnvironment, loadLanguagePack, loadQueryData, openCliDb, parseCliArgs, readStdin, resolveDatabaseConfig, runCliServer, runExecution, runParse, runQueryCli };

package/dist/index.d.ts

@@ -1,9 +1,10 @@
-import { WodWikiIRFile, StatementNode, ExecutionLog, LanguagePack } from '@bitcobblers/wod-wiki-engine';
+import { WodWikiIRFile, StatementNode, ExecutionLog, LanguagePack, FeedTree } from '@bitcobblers/wod-wiki-engine';
 import { INowProvider, IEffort } from '@bitcobblers/wod-wiki-lang';
 import { QueryServiceStores, QueryResult, RowsQueryResult, FindQueryResult, PipelineResult } from '@bitcobblers/wod-wiki-wql';
 import { EventRecord, AnalyticsDataPoint, Session, Note, BlockIndexRow, BlockRevision } from '@bitcobblers/wod-wiki-core';
 import { IStorage } from '@bitcobblers/wod-wiki-storage';
 import { Database } from '@bitcobblers/wod-wiki-storage/sql';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 
 /**
  * Headless Parse Command Runner
@@ -187,17 +188,50 @@ declare function formatQueryOutput(ir: WodWikiIRFile<QueryResult | RowsQueryResu
  *   1 - Runtime error (file missing, bad arguments, execution error)
  *   2 - Parse / Syntax error (invalid Whiteboard Script or malformed WQL)
  *   3 - Pack load error (failed to import or register --pack)
+ *   4 - Destructive confirmation required (missing --yes <targetId>)
  */
 
 interface CliParsedArgs {
-    subcommand?: 'parse' | 'run' | 'query' | 'download' | 'export' | 'import' | 'publish' | 'build' | 'seed' | 'reset' | 'init' | 'db' | 'server' | 'serve' | 'playground' | 'init-feed' | 'skills' | 'help' | 'version';
+    subcommand?: 'parse' | 'run' | 'query' | 'download' | 'export' | 'import' | 'publish' | 'build' | 'seed' | 'reset' | 'init' | 'db' | 'server' | 'serve' | 'playground' | 'init-feed' | 'skills' | 'note' | 'journal' | 'notebook' | 'session' | 'catalog' | 'tag' | 'feed' | 'mcp' | 'tools' | 'doctor' | 'help' | 'version';
     target?: string;
     /** Second positional: the id (download) or file (import) after the kind. */
     target2?: string;
+    /** Third positional for noun-verb commands (e.g. `wod note update <id> <file>`). */
+    target3?: string;
     corpus?: string;
     stdinLog?: boolean;
     stdinFacts?: boolean;
     format: OutputFormat;
+    /** Emit structured JSON envelope on stdout across noun-verb and legacy commands. */
+    json?: boolean;
+    /** Skip database persistence during `wod parse --no-save`. */
+    noSave?: boolean;
+    /** Restrict `wod server` / `wod mcp` to Tier 0 read-only tools. */
+    mcpReadonly?: boolean;
+    /** Validate WQL syntax/schema without executing against data (`wod query --validate-only`). */
+    validateOnly?: boolean;
+    /** Target a running `wod server` HTTP API instead of opening a local DB (`--server <url>`). */
+    serverUrl?: string;
+    /** Explicit Note / Block / Notebook / Date / Filter options for agent noun-verb commands. */
+    noteId?: string;
+    sourceNoteId?: string;
+    blockId?: string;
+    notebook?: string;
+    date?: string;
+    title?: string;
+    description?: string;
+    markdown?: string;
+    search?: string;
+    tag?: string;
+    tags: string[];
+    aliases: string[];
+    setPairs: string[];
+    slug?: string;
+    category?: string;
+    tagType?: string;
+    url?: string;
+    feedId?: string;
+    limit?: number;
     output?: string;
     packs: string[];
     sport?: string;
@@ -401,6 +435,8 @@ interface CliServerOptions {
     port?: string;
     /** Explicit dist directory (flag or PLAYGROUND_DIST); must already exist. */
     dist?: string;
+    /** Restrict `/api/mcp` to Tier 0 read-only tools. */
+    mcpReadonly?: boolean;
     /** Merged CLI environment (process env + .env). */
     env: Record<string, string | undefined>;
 }
@@ -411,4 +447,33 @@ interface CliServerOptions {
  */
 declare function runCliServer(mode: CliServerMode, options: CliServerOptions, writeOut: WriteOut): Promise<void>;
 
-export { type CliDatabaseConfig, type CliDb, type CliParsedArgs, type CliServerMode, type CliServerOptions, type OutputFormat, PackLoadError, type ParseOptions, ParseSyntaxError, type QueryCliOptions, type RunOptions, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, openCliDb, parseCliArgs, readStdin, resolveDatabaseConfig, runCliServer, runExecution, runParse, runQueryCli };
+interface CreateWodMcpServerOptions {
+    storage: IStorage;
+    feedTree?: FeedTree;
+    baseUrl?: string;
+    readonly?: boolean;
+    onMutated?: () => Promise<void> | void;
+}
+/**
+ * Creates a configured official `@modelcontextprotocol/sdk` `McpServer`
+ * exposing all 22 WOD Wiki domain tools (or read-only Tier 0 tools when
+ * `readonly: true`), `wod://*` resources, and guided workout prompts.
+ */
+declare function createWodMcpServer(options: CreateWodMcpServerOptions): McpServer;
+
+interface HandleMcpHttpOptions {
+    db: Database;
+    feedTree: FeedTree;
+    baseUrl: string;
+    readonly?: boolean;
+    authToken?: string;
+}
+/**
+ * Handles Web-Standard Streamable HTTP MCP requests at `/api/mcp`.
+ * Uses stateless per-request `WebStandardStreamableHTTPServerTransport` with
+ * `enableJsonResponse: true` so both official MCP SDK clients and plain HTTP
+ * JSON-RPC clients work out of the box without sticky session requirements.
+ */
+declare function handleMcpHttpRequest(request: Request, options: HandleMcpHttpOptions): Promise<Response>;
+
+export { type CliDatabaseConfig, type CliDb, type CliParsedArgs, type CliServerMode, type CliServerOptions, type CreateWodMcpServerOptions, type HandleMcpHttpOptions, type OutputFormat, PackLoadError, type ParseOptions, ParseSyntaxError, type QueryCliOptions, type RunOptions, WqlSyntaxError, cliMain, createWodMcpServer, formatExecutionOutput, formatParseOutput, formatQueryOutput, handleMcpHttpRequest, loadCliEnvironment, loadLanguagePack, loadQueryData, openCliDb, parseCliArgs, readStdin, resolveDatabaseConfig, runCliServer, runExecution, runParse, runQueryCli };

package/dist/index.mjs

@@ -1,10 +1,11 @@
 import { createRequire } from 'module';
-export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli } from './chunk-SLCRIGUR.mjs';
-import './chunk-5NNSHRMZ.mjs';
+export { PackLoadError, ParseSyntaxError, WqlSyntaxError, cliMain, formatExecutionOutput, formatParseOutput, formatQueryOutput, loadCliEnvironment, loadLanguagePack, loadQueryData, parseCliArgs, readStdin, resolveDatabaseConfig, runExecution, runParse, runQueryCli } from './chunk-KXNK4PIB.mjs';
 import './chunk-KGP6STLY.mjs';
-export { runCliServer } from './chunk-LNBKPHEP.mjs';
-import './chunk-2EWCEE6N.mjs';
+export { runCliServer } from './chunk-AS6OJRNH.mjs';
+export { handleMcpHttpRequest } from './chunk-WLCUM7KO.mjs';
+export { createWodMcpServer } from './chunk-ZZVL6UGV.mjs';
 export { openCliDb } from './chunk-FUISPA7A.mjs';
+import './chunk-T7VB7PPO.mjs';
 import './chunk-QUUX6NX2.mjs';
 
 if (typeof globalThis.require === 'undefined') {

package/dist/mcp-D6QARYOG.mjs

@@ -0,0 +1,73 @@
+import { createRequire } from 'module';
+import { createWodMcpServer } from './chunk-ZZVL6UGV.mjs';
+import { openCliDb, NodeFsFeedTree } from './chunk-FUISPA7A.mjs';
+import './chunk-T7VB7PPO.mjs';
+import './chunk-QUUX6NX2.mjs';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ApiStorage } from '@bitcobblers/wod-wiki-storage';
+import { MemoryFeedTree } from '@bitcobblers/wod-wiki-engine';
+
+if (typeof globalThis.require === 'undefined') {
+  try { globalThis.require = createRequire(import.meta.url); } catch {}
+}
+async function runMcpStdio(options) {
+  const logErr = options.writeErr ?? ((msg) => process.stderr.write(`${msg}
+`));
+  let dbHandle;
+  let storage;
+  let feedTree;
+  let baseUrl = "";
+  if (options.serverUrl) {
+    const trimmed = options.serverUrl.replace(/\/+$/, "");
+    const apiBase = trimmed.endsWith("/api") ? trimmed : `${trimmed}/api`;
+    storage = new ApiStorage(apiBase);
+    feedTree = new MemoryFeedTree();
+    baseUrl = trimmed.endsWith("/api") ? trimmed.slice(0, -4) : trimmed;
+  } else {
+    if (!options.database) {
+      logErr("[wod mcp] Error: Missing database configuration");
+      return 1;
+    }
+    dbHandle = await openCliDb(options.database);
+    storage = dbHandle.storage;
+    feedTree = options.database.kind === "sqlite" ? new NodeFsFeedTree(`${options.database.path}.feed`) : new MemoryFeedTree();
+  }
+  const server = createWodMcpServer({
+    storage,
+    feedTree,
+    baseUrl,
+    readonly: options.readonly
+  });
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  return new Promise((resolve) => {
+    let closed = false;
+    const finish = async (code) => {
+      if (closed) return;
+      closed = true;
+      await server.close().catch(() => {
+      });
+      if (dbHandle) {
+        await dbHandle.close().catch(() => {
+        });
+      }
+      resolve(code);
+    };
+    transport.onclose = () => {
+      void finish(0);
+    };
+    transport.onerror = (err) => {
+      logErr(`[wod mcp] Transport error: ${err.message}`);
+    };
+    process.once("SIGINT", () => {
+      void finish(0);
+    });
+    process.once("SIGTERM", () => {
+      void finish(0);
+    });
+  });
+}
+
+export { runMcpStdio };
+//# sourceMappingURL=mcp-D6QARYOG.mjs.map
+//# sourceMappingURL=mcp-D6QARYOG.mjs.map

package/dist/mcp-D6QARYOG.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli/mcp.ts"],"names":[],"mappings":"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","file":"mcp-D6QARYOG.mjs","sourcesContent":["import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { ApiStorage, type IStorage } from '@bitcobblers/wod-wiki-storage';\nimport { MemoryFeedTree, type FeedTree } from '@bitcobblers/wod-wiki-engine';\nimport type { CliDatabaseConfig } from './config';\nimport { openCliDb, type CliDb } from './db';\nimport { NodeFsFeedTree } from './nodeFeedTree';\nimport { createWodMcpServer } from '../mcp/createWodMcpServer';\n\nexport interface RunMcpStdioOptions {\n  database?: CliDatabaseConfig;\n  serverUrl?: string;\n  readonly?: boolean;\n  writeErr?: (text: string) => void;\n}\n\n/**\n * Starts the `wod mcp` stdio server using `@modelcontextprotocol/sdk`'s\n * `StdioServerTransport`. All diagnostic messages go to `stderr` so `stdout`\n * stays strictly reserved for JSON-RPC frames.\n */\nexport async function runMcpStdio(options: RunMcpStdioOptions): Promise<number> {\n  const logErr = options.writeErr ?? ((msg: string) => process.stderr.write(`${msg}\\n`));\n\n  let dbHandle: CliDb | undefined;\n  let storage: IStorage;\n  let feedTree: FeedTree;\n  let baseUrl = '';\n\n  if (options.serverUrl) {\n    const trimmed = options.serverUrl.replace(/\\/+$/, '');\n    const apiBase = trimmed.endsWith('/api') ? trimmed : `${trimmed}/api`;\n    storage = new ApiStorage(apiBase);\n    feedTree = new MemoryFeedTree();\n    baseUrl = trimmed.endsWith('/api') ? trimmed.slice(0, -4) : trimmed;\n  } else {\n    if (!options.database) {\n      logErr('[wod mcp] Error: Missing database configuration');\n      return 1;\n    }\n    dbHandle = await openCliDb(options.database);\n    storage = dbHandle.storage;\n    feedTree =\n      options.database.kind === 'sqlite'\n        ? new NodeFsFeedTree(`${options.database.path}.feed`)\n        : new MemoryFeedTree();\n  }\n\n  const server = createWodMcpServer({\n    storage,\n    feedTree,\n    baseUrl,\n    readonly: options.readonly,\n  });\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n\n  return new Promise<number>((resolve) => {\n    let closed = false;\n    const finish = async (code: number) => {\n      if (closed) return;\n      closed = true;\n      await server.close().catch(() => {});\n      if (dbHandle) {\n        await dbHandle.close().catch(() => {});\n      }\n      resolve(code);\n    };\n\n    transport.onclose = () => {\n      void finish(0);\n    };\n    transport.onerror = (err) => {\n      logErr(`[wod mcp] Transport error: ${err.message}`);\n    };\n    process.once('SIGINT', () => {\n      void finish(0);\n    });\n    process.once('SIGTERM', () => {\n      void finish(0);\n    });\n  });\n}\n"]}

package/dist/{scaffoldFeed-TCRNXYQU.mjs → scaffoldFeed-D55NINVJ.mjs}

@@ -1,5 +1,5 @@
 import { createRequire } from 'module';
-import { VERSION } from './chunk-5NNSHRMZ.mjs';
+import { VERSION } from './chunk-T7VB7PPO.mjs';
 import './chunk-QUUX6NX2.mjs';
 import { mkdirSync, writeFileSync, rmSync } from 'fs';
 import { resolve, join, dirname } from 'path';
@@ -201,5 +201,5 @@ function scaffoldFeed(name, opts = {}) {
 }
 
 export { scaffoldFeed, validateFeedName };
-//# sourceMappingURL=scaffoldFeed-TCRNXYQU.mjs.map
-//# sourceMappingURL=scaffoldFeed-TCRNXYQU.mjs.map
+//# sourceMappingURL=scaffoldFeed-D55NINVJ.mjs.map
+//# sourceMappingURL=scaffoldFeed-D55NINVJ.mjs.map

package/dist/{scaffoldFeed-TCRNXYQU.mjs.map → scaffoldFeed-D55NINVJ.mjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/cli/scaffoldFeed.ts"],"names":[],"mappings":"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","file":"scaffoldFeed-TCRNXYQU.mjs","sourcesContent":["/**\n * `wod init-feed <name>` — scaffold a ready-to-publish WOD Wiki feed\n * repository skeleton (the publisher-repository contract in\n * docs/adrs/0001-feed-seed-data-contract.md): a markdown notebooks example,\n * package.json, GitHub Actions Pages workflow, README. Creates a new\n * directory only; refuses an existing destination without touching it.\n *\n * Lazily imported by cli/runner.ts (dynamic import), so static node:fs/node:path\n * imports stay out of browser bundles.\n */\nimport { mkdirSync, rmSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { VERSION } from '../version';\n\nexport interface ScaffoldFeedResult {\n  /** Absolute path of the created feed root. */\n  dir: string;\n  /** Created files, POSIX-relative to the feed root. */\n  files: string[];\n}\n\n/** npm package name + single-directory-segment validation for `<name>`. */\nexport function validateFeedName(name: string): string {\n  if (name.length === 0 || name === '.' || name === '..') {\n    throw new Error('Feed name must be a single non-empty directory name');\n  }\n  if (name.includes('/') || name.includes('\\\\') || name.includes('\\0')) {\n    throw new Error(`Invalid feed name '${name}': must be a single directory name (no path separators or traversal)`);\n  }\n  if (/^(?:[A-Za-z]:)?[/\\\\]/.test(name)) {\n    throw new Error(`Invalid feed name '${name}': absolute paths are not allowed`);\n  }\n  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {\n    throw new Error(\n      `Invalid feed name '${name}': must be a valid npm package name ` +\n      '(lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)',\n    );\n  }\n  return name;\n}\n\nconst publishWorkflow = (): string => `name: Publish feed\n\n# Compile the feed with the wod CLI and deploy dist/ to GitHub Pages.\n# Requires Pages enabled: repo Settings → Pages → Source: \"GitHub Actions\".\n\non:\n  push:\n    branches: [main]\n  workflow_dispatch:\n\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: pages\n  cancel-in-progress: true\n\njobs:\n  publish:\n    runs-on: ubuntu-latest\n    environment:\n      name: github-pages\n      url: \\${{ steps.deployment.outputs.page_url }}\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          # Full history: seed manifest version stamps derive from git commit count.\n          fetch-depth: 0\n\n      - name: Set up Bun\n        uses: oven-sh/setup-bun@v2\n        with:\n          bun-version: 1.4.x\n\n      - name: Install dependencies\n        run: bun install\n\n      - name: Build seed\n        run: bunx wod build . --output dist\n\n      - uses: actions/configure-pages@v5\n\n      - name: Upload dist\n        uses: actions/upload-pages-artifact@v3\n        with:\n          path: dist\n\n      - id: deployment\n        uses: actions/deploy-pages@v4\n`;\n\nconst feedReadme = (name: string): string => `# ${name}\n\nExample benchmark notebook. Each \\`.md\\` file in this directory becomes part of\nthe \\`example\\` notebook chunk; \\`README.md\\` is the notebook's landing page.\n\nAdd one file per workout:\n\n\\`\\`\\`\\`markdown\n---\ntitle: My workout\ndate: 2026-01-01\n---\n\n# My workout\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n\\`\\`\\`\\`\n\nThe \\`date:\\` frontmatter field sets the workout's chronological placement\n(regardless of filename or directory).\n`;\n\nconst exampleWorkout = (date: string): string => `---\ntitle: Morning session\ndate: ${date}\n---\n\n# Morning session\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n`;\n\nconst repoReadme = (name: string): string => `# ${name}\n\nA [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout feed: plain\nMarkdown workouts compiled to static, version-stamped seed chunks and published\nvia GitHub Pages.\n\n## Develop\n\n\\`\\`\\`sh\nbun install\nbunx wod build . --output dist\n\\`\\`\\`\n\nWorkouts live under \\`markdown/\\` — this scaffold starts with one example\nfeed. Validate everything with \\`bunx wod build\\`: it gates every file on\nthe Whiteboard grammar and corpus layout before writing \\`dist/\\`.\n\n## Publish\n\nPush to GitHub and enable Pages (**Settings → Pages → Source: GitHub\nActions**). The bundled workflow (\\`.github/workflows/publish-feed.yml\\`)\nbuilds the feed on every push to \\`main\\` and deploys \\`dist/\\`.\n\n## Share\n\nOnce published, anyone can subscribe to this feed from a WOD Wiki instance\nat:\n\n\\`\\`\\`\n<app-url>/subscribe?source=<url-encoded published feed URL>\n\\`\\`\\`\n\nFor \\`owner\\`/\\`repo\\` on GitHub Pages the feed URL is the deployed\ndirectory, \\`https://owner.github.io/repo/\\`, e.g.\n\\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\\`.\n`;\n\n/**\n * Scaffold a new feed repository at `<cwd>/<name>`. Throws when the name is\n * invalid or the destination already exists; partial failure removes created files.\n */\nexport function scaffoldFeed(name: string, opts: { cwd?: string } = {}): ScaffoldFeedResult {\n  validateFeedName(name);\n  const dir = resolve(opts.cwd ?? process.cwd(), name);\n  // Atomic acquire: EEXIST is the refusal signal — no exists-check/create race,\n  // and an existing destination is never removed or written.\n  try {\n    mkdirSync(dir);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'EEXIST') {\n      throw new Error(`Refusing to overwrite '${dir}': destination already exists`, { cause: error });\n    }\n    throw error;\n  }\n\n  const date = new Date().toISOString().slice(0, 10);\n  const files: Array<[rel: string, content: string]> = [\n    ['package.json', `${JSON.stringify(\n      {\n        name,\n        version: '0.1.0',\n        private: true,\n        type: 'module',\n        description: `WOD Wiki workout feed: ${name}`,\n        scripts: {\n          build: 'wod build . --output dist',\n        },\n        devDependencies: {\n          '@bitcobblers/wod-wiki-tools': `^${VERSION}`,\n        },\n      },\n      null,\n      2,\n    )}\\n`],\n    ['.gitignore', 'node_modules/\\ndist/\\n'],\n    ['.github/workflows/publish-feed.yml', publishWorkflow()],\n    ['markdown/notebooks/example/README.md', feedReadme(name)],\n    [`markdown/notebooks/example/morning-session.md`, exampleWorkout(date)],\n    ['README.md', repoReadme(name)],\n  ];\n\n  try {\n    for (const [rel, content] of files) {\n      const target = join(dir, rel);\n      mkdirSync(dirname(target), { recursive: true });\n      writeFileSync(target, content, 'utf-8');\n    }\n  } catch (error) {\n    rmSync(dir, { recursive: true, force: true });\n    throw error;\n  }\n  return { dir, files: files.map(([rel]) => rel) };\n}\n"]}
+{"version":3,"sources":["../src/cli/scaffoldFeed.ts"],"names":[],"mappings":"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","file":"scaffoldFeed-D55NINVJ.mjs","sourcesContent":["/**\n * `wod init-feed <name>` — scaffold a ready-to-publish WOD Wiki feed\n * repository skeleton (the publisher-repository contract in\n * docs/adrs/0001-feed-seed-data-contract.md): a markdown notebooks example,\n * package.json, GitHub Actions Pages workflow, README. Creates a new\n * directory only; refuses an existing destination without touching it.\n *\n * Lazily imported by cli/runner.ts (dynamic import), so static node:fs/node:path\n * imports stay out of browser bundles.\n */\nimport { mkdirSync, rmSync, writeFileSync } from 'node:fs';\nimport { dirname, join, resolve } from 'node:path';\nimport { VERSION } from '../version';\n\nexport interface ScaffoldFeedResult {\n  /** Absolute path of the created feed root. */\n  dir: string;\n  /** Created files, POSIX-relative to the feed root. */\n  files: string[];\n}\n\n/** npm package name + single-directory-segment validation for `<name>`. */\nexport function validateFeedName(name: string): string {\n  if (name.length === 0 || name === '.' || name === '..') {\n    throw new Error('Feed name must be a single non-empty directory name');\n  }\n  if (name.includes('/') || name.includes('\\\\') || name.includes('\\0')) {\n    throw new Error(`Invalid feed name '${name}': must be a single directory name (no path separators or traversal)`);\n  }\n  if (/^(?:[A-Za-z]:)?[/\\\\]/.test(name)) {\n    throw new Error(`Invalid feed name '${name}': absolute paths are not allowed`);\n  }\n  if (name.length > 214 || !/^[a-z0-9][a-z0-9._-]*$/.test(name)) {\n    throw new Error(\n      `Invalid feed name '${name}': must be a valid npm package name ` +\n      '(lowercase letters, digits, dots, hyphens, underscores; no leading dot/hyphen)',\n    );\n  }\n  return name;\n}\n\nconst publishWorkflow = (): string => `name: Publish feed\n\n# Compile the feed with the wod CLI and deploy dist/ to GitHub Pages.\n# Requires Pages enabled: repo Settings → Pages → Source: \"GitHub Actions\".\n\non:\n  push:\n    branches: [main]\n  workflow_dispatch:\n\npermissions:\n  contents: read\n  pages: write\n  id-token: write\n\nconcurrency:\n  group: pages\n  cancel-in-progress: true\n\njobs:\n  publish:\n    runs-on: ubuntu-latest\n    environment:\n      name: github-pages\n      url: \\${{ steps.deployment.outputs.page_url }}\n    steps:\n      - uses: actions/checkout@v4\n        with:\n          # Full history: seed manifest version stamps derive from git commit count.\n          fetch-depth: 0\n\n      - name: Set up Bun\n        uses: oven-sh/setup-bun@v2\n        with:\n          bun-version: 1.4.x\n\n      - name: Install dependencies\n        run: bun install\n\n      - name: Build seed\n        run: bunx wod build . --output dist\n\n      - uses: actions/configure-pages@v5\n\n      - name: Upload dist\n        uses: actions/upload-pages-artifact@v3\n        with:\n          path: dist\n\n      - id: deployment\n        uses: actions/deploy-pages@v4\n`;\n\nconst feedReadme = (name: string): string => `# ${name}\n\nExample benchmark notebook. Each \\`.md\\` file in this directory becomes part of\nthe \\`example\\` notebook chunk; \\`README.md\\` is the notebook's landing page.\n\nAdd one file per workout:\n\n\\`\\`\\`\\`markdown\n---\ntitle: My workout\ndate: 2026-01-01\n---\n\n# My workout\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n\\`\\`\\`\\`\n\nThe \\`date:\\` frontmatter field sets the workout's chronological placement\n(regardless of filename or directory).\n`;\n\nconst exampleWorkout = (date: string): string => `---\ntitle: Morning session\ndate: ${date}\n---\n\n# Morning session\n\n\\`\\`\\`time\n(21-15-9)\n  Thrusters @95lb\n  Pull-ups\n\\`\\`\\`\n`;\n\nconst repoReadme = (name: string): string => `# ${name}\n\nA [WOD Wiki](https://github.com/bitcobblers/wod-wiki) workout feed: plain\nMarkdown workouts compiled to static, version-stamped seed chunks and published\nvia GitHub Pages.\n\n## Develop\n\n\\`\\`\\`sh\nbun install\nbunx wod build . --output dist\n\\`\\`\\`\n\nWorkouts live under \\`markdown/\\` — this scaffold starts with one example\nfeed. Validate everything with \\`bunx wod build\\`: it gates every file on\nthe Whiteboard grammar and corpus layout before writing \\`dist/\\`.\n\n## Publish\n\nPush to GitHub and enable Pages (**Settings → Pages → Source: GitHub\nActions**). The bundled workflow (\\`.github/workflows/publish-feed.yml\\`)\nbuilds the feed on every push to \\`main\\` and deploys \\`dist/\\`.\n\n## Share\n\nOnce published, anyone can subscribe to this feed from a WOD Wiki instance\nat:\n\n\\`\\`\\`\n<app-url>/subscribe?source=<url-encoded published feed URL>\n\\`\\`\\`\n\nFor \\`owner\\`/\\`repo\\` on GitHub Pages the feed URL is the deployed\ndirectory, \\`https://owner.github.io/repo/\\`, e.g.\n\\`/subscribe?source=https%3A%2F%2Fowner.github.io%2Frepo%2F\\`.\n`;\n\n/**\n * Scaffold a new feed repository at `<cwd>/<name>`. Throws when the name is\n * invalid or the destination already exists; partial failure removes created files.\n */\nexport function scaffoldFeed(name: string, opts: { cwd?: string } = {}): ScaffoldFeedResult {\n  validateFeedName(name);\n  const dir = resolve(opts.cwd ?? process.cwd(), name);\n  // Atomic acquire: EEXIST is the refusal signal — no exists-check/create race,\n  // and an existing destination is never removed or written.\n  try {\n    mkdirSync(dir);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === 'EEXIST') {\n      throw new Error(`Refusing to overwrite '${dir}': destination already exists`, { cause: error });\n    }\n    throw error;\n  }\n\n  const date = new Date().toISOString().slice(0, 10);\n  const files: Array<[rel: string, content: string]> = [\n    ['package.json', `${JSON.stringify(\n      {\n        name,\n        version: '0.1.0',\n        private: true,\n        type: 'module',\n        description: `WOD Wiki workout feed: ${name}`,\n        scripts: {\n          build: 'wod build . --output dist',\n        },\n        devDependencies: {\n          '@bitcobblers/wod-wiki-tools': `^${VERSION}`,\n        },\n      },\n      null,\n      2,\n    )}\\n`],\n    ['.gitignore', 'node_modules/\\ndist/\\n'],\n    ['.github/workflows/publish-feed.yml', publishWorkflow()],\n    ['markdown/notebooks/example/README.md', feedReadme(name)],\n    [`markdown/notebooks/example/morning-session.md`, exampleWorkout(date)],\n    ['README.md', repoReadme(name)],\n  ];\n\n  try {\n    for (const [rel, content] of files) {\n      const target = join(dir, rel);\n      mkdirSync(dirname(target), { recursive: true });\n      writeFileSync(target, content, 'utf-8');\n    }\n  } catch (error) {\n    rmSync(dir, { recursive: true, force: true });\n    throw error;\n  }\n  return { dir, files: files.map(([rel]) => rel) };\n}\n"]}

package/dist/server/app.cjs

@@ -7,7 +7,11 @@ var stream = require('stream');
 var sql = require('@bitcobblers/wod-wiki-storage/sql');
 var wodWikiStorage = require('@bitcobblers/wod-wiki-storage');
 var wodWikiEngine = require('@bitcobblers/wod-wiki-engine');
+var agent = require('@bitcobblers/wod-wiki-engine/agent');
 require('@bitcobblers/wod-wiki-lang');
+var webStandardStreamableHttp_js = require('@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js');
+var zod = require('zod');
+var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
 
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
@@ -92,6 +96,217 @@ var NodeFsFeedTree = class {
   }
 };
 
+// src/version.ts
+var VERSION = "0.54.2205";
+
+// src/mcp/createWodMcpServer.ts
+function createWodMcpServer(options) {
+  const server = new mcp_js.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 agent.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.AGENT_STATIC_RESOURCES) {
+    server.registerResource(
+      resource.name,
+      resource.uri,
+      {
+        description: resource.description,
+        mimeType: resource.mimeType
+      },
+      async (uri) => {
+        const res = await agent.readAgentResource(uri.toString(), ctx);
+        return {
+          contents: [
+            {
+              uri: res.uri,
+              mimeType: res.mimeType,
+              text: res.text
+            }
+          ]
+        };
+      }
+    );
+  }
+  for (const tmpl of agent.AGENT_RESOURCE_TEMPLATES) {
+    const template = new mcp_js.ResourceTemplate(tmpl.uriTemplate, { list: void 0 });
+    server.registerResource(
+      tmpl.name,
+      template,
+      {
+        description: tmpl.description,
+        mimeType: tmpl.mimeType
+      },
+      async (uri) => {
+        const res = await agent.readAgentResource(uri.toString(), ctx);
+        return {
+          contents: [
+            {
+              uri: res.uri,
+              mimeType: res.mimeType,
+              text: res.text
+            }
+          ]
+        };
+      }
+    );
+  }
+  for (const prompt of agent.AGENT_PROMPTS) {
+    const argsShape = {};
+    for (const arg of prompt.arguments) {
+      argsShape[arg.name] = arg.required ? zod.z.string().describe(arg.description) : zod.z.string().optional().describe(arg.description);
+    }
+    server.registerPrompt(
+      prompt.name,
+      {
+        title: prompt.title,
+        description: prompt.description,
+        argsSchema: argsShape
+      },
+      async (args) => {
+        const rendered = agent.renderAgentPrompt(prompt.name, args);
+        return {
+          description: rendered.description,
+          messages: rendered.messages
+        };
+      }
+    );
+  }
+  return server;
+}
+
+// src/mcp/httpHandler.ts
+var MCP_CORS_HEADERS = {
+  "access-control-allow-origin": "*",
+  "access-control-allow-methods": "GET, POST, DELETE, OPTIONS",
+  "access-control-allow-headers": "Content-Type, Accept, Authorization, Mcp-Session-Id, MCP-Protocol-Version, Last-Event-ID",
+  "access-control-expose-headers": "Mcp-Session-Id, MCP-Protocol-Version"
+};
+function withMcpCors(response) {
+  const headers = new Headers(response.headers);
+  for (const [k, v] of Object.entries(MCP_CORS_HEADERS)) {
+    if (!headers.has(k)) {
+      headers.set(k, v);
+    }
+  }
+  return new Response(response.body, {
+    status: response.status,
+    statusText: response.statusText,
+    headers
+  });
+}
+function normalizeAcceptForPost(request) {
+  if (request.method !== "POST") return request;
+  const accept = request.headers.get("accept") ?? "";
+  if (accept.includes("application/json") && accept.includes("text/event-stream")) {
+    return request;
+  }
+  const headers = new Headers(request.headers);
+  headers.set("accept", "application/json, text/event-stream");
+  return new Request(request, { headers });
+}
+async function handleMcpHttpRequest(request, options) {
+  if (request.method === "OPTIONS") {
+    return new Response(null, { status: 204, headers: MCP_CORS_HEADERS });
+  }
+  const expectedToken = options.authToken ?? process.env.WOD_MCP_TOKEN?.trim();
+  if (expectedToken) {
+    const authHeader = request.headers.get("authorization") ?? "";
+    const bearer = authHeader.startsWith("Bearer ") ? authHeader.slice("Bearer ".length).trim() : "";
+    if (bearer !== expectedToken) {
+      return withMcpCors(
+        new Response(
+          JSON.stringify({
+            jsonrpc: "2.0",
+            error: { code: -32001, message: "Unauthorized: missing or invalid Bearer token" },
+            id: null
+          }),
+          { status: 401, headers: { "content-type": "application/json" } }
+        )
+      );
+    }
+  }
+  const storage = new sql.SqlStorage(options.db);
+  const server = createWodMcpServer({
+    storage,
+    feedTree: options.feedTree,
+    baseUrl: options.baseUrl,
+    readonly: options.readonly ?? process.env.WOD_MCP_READONLY === "1"
+  });
+  const transport = new webStandardStreamableHttp_js.WebStandardStreamableHTTPServerTransport({
+    sessionIdGenerator: void 0,
+    enableJsonResponse: true
+  });
+  await server.connect(transport);
+  try {
+    const normalizedReq = normalizeAcceptForPost(request);
+    const response = await transport.handleRequest(normalizedReq);
+    return withMcpCors(response);
+  } finally {
+    await transport.close().catch(() => {
+    });
+    await server.close().catch(() => {
+    });
+  }
+}
+
 // src/server/app.ts
 var json = (value, status) => new Response(JSON.stringify(value), { status, headers: { "content-type": "application/json" } });
 function streamFile(path) {
@@ -355,10 +570,19 @@ async function servePublishedFeed(feedTree, method, relPath) {
     throw err;
   }
 }
-async function apiRoutes(db, feedTree, req, method, sub, url) {
+async function apiRoutes(db, feedTree, req, method, sub, url, mcpOptions) {
   if (sub === "/health") {
     return json({ ok: true, driver: db.dialect }, 200);
   }
+  if (sub === "/mcp") {
+    return handleMcpHttpRequest(req, {
+      db,
+      feedTree,
+      baseUrl: url.origin,
+      readonly: mcpOptions?.readonly,
+      authToken: mcpOptions?.authToken
+    });
+  }
   if (sub === "/v1/feed/status" && method === "GET") {
     const storage = new sql.SqlStorage(db);
     const status = await wodWikiEngine.checkUnpublishedFeedChanges(storage, feedTree);
@@ -422,7 +646,20 @@ function createHandler(db, options) {
       const method = request.method === "HEAD" ? "GET" : request.method;
       const path = url.pathname;
       if (path === "/api" || path.startsWith("/api/")) {
-        return db ? await apiRoutes(db, feedTree, request, method, path.slice("/api".length) || "/", url) : notFound();
+        return db ? await apiRoutes(
+          db,
+          feedTree,
+          request,
+          request.method === "OPTIONS" ? "OPTIONS" : method,
+          path.slice("/api".length) || "/",
+          url,
+          { readonly: options.mcpReadonly, authToken: options.mcpToken }
+        ) : notFound();
+      }
+      if (db && path === "/.well-known/agent-capabilities.json" && method === "GET") {
+        const res = await staticResponse(distRoot, method, path);
+        if (res.status === 200) return res;
+        return json(agent.exportAgentCapabilitiesManifest(), 200);
       }
       if (db) {
         const feedAsset = isPublishedFeedAssetPath(path);