@nowline/mcp 0.6.0 → 0.8.0

package/dist/generated/ui-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-bundle.js","sourceRoot":"","sources":["../../src/generated/ui-bundle.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,EAAE;AACF,qEAAqE;AACrE,8CAA8C;AAC9C,EAAE;AACF,mFAAmF;AAEnF,yEAAyE;AACzE,MAAM,CAAC,MAAM,SAAS,GAAW,o64lCAAo64lC,CAAC;AAEt84lC,gFAAgF;AAChF,MAAM,CAAC,MAAM,YAAY,GAAW,0x5lCAA0x5lC,CAAC"}

package/dist/index.js

@@ -1,25 +1,53 @@
 #!/usr/bin/env node
 // @nowline/mcp — entry point for `npx @nowline/mcp`.
 //
-// Parses the optional --root flag, creates the MCP server, and connects it to
-// the stdio transport.  The server module (createMcpServer) is shared with
-// the CLI's `--mcp` flag (packages/cli/src/commands/mcp-host.ts).
+// Parses --root, --port, and --version flags, creates the MCP server, and
+// connects it to the appropriate transport:
+//   stdio  (default)                  standard MCP stdio transport
+//   http   (--port <N>)               Streamable HTTP transport on localhost:<N>
 //
 // Usage:
-//   npx @nowline/mcp [--root <path>] [--version]
+//   npx @nowline/mcp [--root <path>] [--port <N>] [--version]
 //
-// Spec: specs/mcp.md.  Plan: export_determinism s8 + s10.
+// Spec: specs/mcp.md.
+import { readFileSync } from 'node:fs';
+import { createServer } from 'node:http';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { createMcpServer } from './server.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function readPkgVersion() {
+    try {
+        const raw = readFileSync(resolve(__dirname, '../package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const PKG_VERSION = readPkgVersion();
 function parseArgs(argv) {
     const args = argv.slice(2);
     let root;
+    let port;
     let help = false;
     let version = false;
     for (let i = 0; i < args.length; i++) {
         if (args[i] === '--root' && i + 1 < args.length) {
             root = args[++i];
         }
+        else if (args[i] === '--port' && i + 1 < args.length) {
+            const n = parseInt(args[++i], 10);
+            if (!Number.isFinite(n) || n < 1 || n > 65535) {
+                process.stderr.write(`nowline-mcp: --port must be a number between 1 and 65535\n`);
+                process.exit(1);
+            }
+            port = n;
+        }
         else if (args[i] === '-h' || args[i] === '--help') {
             help = true;
         }
@@ -27,28 +55,51 @@ function parseArgs(argv) {
             version = true;
         }
     }
-    return { root, help, version };
+    return { root, port, help, version };
 }
-const { root, help, version } = parseArgs(process.argv);
+const { root, port, help, version } = parseArgs(process.argv);
 if (version) {
-    process.stdout.write('0.5.1\n');
+    process.stdout.write(`${PKG_VERSION}\n`);
     process.exit(0);
 }
 if (help) {
     process.stdout.write([
         'Usage: npx @nowline/mcp [options]',
         '',
-        'Start the Nowline MCP server (stdio transport).',
+        'Start the Nowline MCP server.',
         '',
         'Options:',
         '  --root <path>   Allowed root for file operations. Defaults to cwd.',
+        '  --port <N>      Listen on localhost:<N> using Streamable HTTP transport.',
+        '                  When omitted, uses stdio transport (default).',
         '  --version, -v   Print version and exit.',
         '  --help, -h      Show this help.',
         '',
     ].join('\n'));
     process.exit(0);
 }
-const server = createMcpServer({ allowedRoot: root });
-const transport = new StdioServerTransport();
-await server.connect(transport);
+const server = createMcpServer({ allowedRoot: root, version: PKG_VERSION });
+if (port !== undefined) {
+    // Streamable HTTP transport — stateless (no session management).
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: undefined,
+    });
+    await server.connect(transport);
+    const httpServer = createServer(async (req, res) => {
+        await transport.handleRequest(req, res);
+    });
+    httpServer.listen(port, '127.0.0.1', () => {
+        process.stderr.write(`nowline-mcp: Streamable HTTP listening on http://127.0.0.1:${port}\n`);
+    });
+    await new Promise((resolve) => {
+        httpServer.on('close', resolve);
+        process.on('SIGINT', () => httpServer.close());
+        process.on('SIGTERM', () => httpServer.close());
+    });
+}
+else {
+    // Default: stdio transport.
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,qDAAqD;AACrD,EAAE;AACF,8EAA8E;AAC9E,2EAA2E;AAC3E,kEAAkE;AAClE,EAAE;AACF,SAAS;AACT,iDAAiD;AACjD,EAAE;AACF,0DAA0D;AAE1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,SAAS,SAAS,CAAC,IAAc;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,IAAwB,CAAC;IAC7B,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAClD,IAAI,GAAG,IAAI,CAAC;QAChB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrD,OAAO,GAAG,IAAI,CAAC;QACnB,CAAC;IACL,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAExD,IAAI,OAAO,EAAE,CAAC;IACV,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,IAAI,IAAI,EAAE,CAAC;IACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAChB;QACI,mCAAmC;QACnC,EAAE;QACF,iDAAiD;QACjD,EAAE;QACF,UAAU;QACV,sEAAsE;QACtE,2CAA2C;QAC3C,mCAAmC;QACnC,EAAE;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CACf,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/prompts.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerPrompts(server: McpServer): void;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqKvD"}

package/dist/prompts.js

@@ -0,0 +1,143 @@
+// MCP prompt registrations for @nowline/mcp.
+// Wired into the server via registerPrompts(server).
+import { z } from 'zod';
+export function registerPrompts(server) {
+    // ---- create-roadmap ----------------------------------------------------
+    server.registerPrompt('create-roadmap', {
+        description: 'Generate a new .nowline roadmap from a plain-English description. Composes the DSL reference and example files so the LLM has full context.',
+        argsSchema: {
+            description: z
+                .string()
+                .describe('Plain-English description of the roadmap you want to create (teams, timeline, key milestones, etc.).'),
+        },
+    }, ({ description }) => ({
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'resource',
+                    resource: {
+                        uri: 'nowline://reference',
+                        mimeType: 'text/plain',
+                        text: '',
+                    },
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'resource',
+                    resource: {
+                        uri: 'nowline://examples',
+                        mimeType: 'text/plain',
+                        text: '',
+                    },
+                },
+            },
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Using the Nowline DSL reference and examples above, generate a complete, valid .nowline roadmap file for the following description:\n\n${description}\n\nReturn only the .nowline source text with no additional explanation.`,
+                },
+            },
+        ],
+    }));
+    // ---- fix-diagnostics ----------------------------------------------------
+    server.registerPrompt('fix-diagnostics', {
+        description: 'Fix validation errors in a .nowline file. Describe the validate→fix→re-validate loop keyed on NL.E#### diagnostic codes.',
+        argsSchema: {
+            source: z
+                .string()
+                .describe('The .nowline source text that contains validation errors.'),
+            diagnostics: z
+                .string()
+                .optional()
+                .describe('JSON array of diagnostic objects from the validate tool. Omit to let the LLM call validate itself.'),
+        },
+    }, ({ source, diagnostics }) => {
+        const diagSection = diagnostics
+            ? `\n\nDiagnostics (JSON):\n\`\`\`json\n${diagnostics}\n\`\`\``
+            : '\n\nFirst call the `validate` tool on the source to get the current diagnostics.';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'resource',
+                        resource: {
+                            uri: 'nowline://reference',
+                            mimeType: 'text/plain',
+                            text: '',
+                        },
+                    },
+                },
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Fix all validation errors in the following .nowline source. Each diagnostic code (NL.E####) identifies the exact rule violation — consult the DSL reference above to understand the rule and apply the correct fix. After fixing, call the \`validate\` tool to confirm there are no remaining errors.${diagSection}\n\nSource:\n\`\`\`nowline\n${source}\n\`\`\`\n\nReturn the corrected .nowline source text.`,
+                    },
+                },
+            ],
+        };
+    });
+    // ---- convert-to-nowline -------------------------------------------------
+    server.registerPrompt('convert-to-nowline', {
+        description: 'Convert a gantt/timeline from another format (Mermaid gantt, MS Project, Excel, Google Sheets, CSV) into Nowline DSL. Uses the conversion guide resource for format-specific rules.',
+        argsSchema: {
+            source: z
+                .string()
+                .describe('The source content to convert (paste the raw text/CSV/XML here).'),
+            from: z
+                .enum([
+                'mermaid-gantt',
+                'ms-project',
+                'xlsx',
+                'gsheets-timeline',
+                'csv',
+                'auto',
+            ])
+                .optional()
+                .describe('Source format hint. Use "auto" (default) to let the LLM detect the format.'),
+        },
+    }, ({ source, from }) => {
+        const formatHint = from && from !== 'auto'
+            ? `The source format is: **${from}**.`
+            : 'Detect the source format automatically from the content.';
+        return {
+            messages: [
+                {
+                    role: 'user',
+                    content: {
+                        type: 'resource',
+                        resource: {
+                            uri: 'nowline://conversions',
+                            mimeType: 'text/plain',
+                            text: '',
+                        },
+                    },
+                },
+                {
+                    role: 'user',
+                    content: {
+                        type: 'resource',
+                        resource: {
+                            uri: 'nowline://reference',
+                            mimeType: 'text/plain',
+                            text: '',
+                        },
+                    },
+                },
+                {
+                    role: 'user',
+                    content: {
+                        type: 'text',
+                        text: `Using the conversion guide and the Nowline DSL reference above, convert the following source content into a valid .nowline roadmap.\n\n${formatHint}\n\nSource content:\n\`\`\`\n${source}\n\`\`\`\n\nReturn only the .nowline source text. After generating it, call the \`validate\` tool to confirm there are no errors.`,
+                    },
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"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"}

package/dist/reference-cheatsheet.d.ts

@@ -0,0 +1,2 @@
+export declare const REFERENCE_CHEATSHEET = "# Nowline DSL \u2014 condensed reference\n\nEvery file starts with `nowline v1` on line 1.\n\n## Roadmap directive\n\n```\nroadmap <id> \"<title>\" start:YYYY-MM-DD scale:2w\n```\n\nCommon keys: `start:`, `scale:`, `length:`, `locale:`, `theme:`, `author:`, `calendar:`.\n\n## Swimlanes and items\n\n```\nswimlane <id> \"<title>\"\n  item <id> \"<title>\" duration:3w\n```\n\nEntity types: `swimlane`, `group`, `parallel`, `item`, `milestone`, `anchor`.\n\nItems need `duration:` or `size:`. Use 2-space indentation under parents.\n\n## Item properties\n\n`duration:` (or `size:`), `status:`, `remaining:`, `owner:`, `after:`, `before:`, `labels:`, `link:`, `style:`.\n\nThere is NO `progress:` or `color:` key. Show completion with `status:` + `remaining:`; set visuals with a `style:` reference (see full reference).\n\n## Progress & status\n\n```\nitem api \"API redesign\" duration:4w status:in-progress remaining:40%\n```\n\n`status:` values: `planned`, `in-progress` (alias `active`), `done` (alias `completed`), `at-risk`, `blocked`, or a custom `status` you declare earlier.\n\n`remaining:` is the work *left*, written as a percent (`40%`) or an effort literal (`1w`). So an item that is 60% complete is `remaining:40%`. Omit `remaining:` for a fully open or fully done bar.\n\n## Config / includes (before roadmap)\n\n`config` blocks, `include \"path.nowline\"` \u2014 see full reference for ordering rules.\n\nCall `reference` with `format: \"full\"` for the complete man page, or `examples` for sample files.\n";
+//# sourceMappingURL=reference-cheatsheet.d.ts.map

package/dist/reference-cheatsheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-cheatsheet.d.ts","sourceRoot":"","sources":["../src/reference-cheatsheet.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,oBAAoB,s/CA4ChC,CAAC"}

package/dist/reference-cheatsheet.js

@@ -0,0 +1,47 @@
+// Condensed DSL reference for the MCP `reference` discovery tool (format: condensed).
+export const REFERENCE_CHEATSHEET = `# Nowline DSL — condensed reference
+
+Every file starts with \`nowline v1\` on line 1.
+
+## Roadmap directive
+
+\`\`\`
+roadmap <id> "<title>" start:YYYY-MM-DD scale:2w
+\`\`\`
+
+Common keys: \`start:\`, \`scale:\`, \`length:\`, \`locale:\`, \`theme:\`, \`author:\`, \`calendar:\`.
+
+## Swimlanes and items
+
+\`\`\`
+swimlane <id> "<title>"
+  item <id> "<title>" duration:3w
+\`\`\`
+
+Entity types: \`swimlane\`, \`group\`, \`parallel\`, \`item\`, \`milestone\`, \`anchor\`.
+
+Items need \`duration:\` or \`size:\`. Use 2-space indentation under parents.
+
+## Item properties
+
+\`duration:\` (or \`size:\`), \`status:\`, \`remaining:\`, \`owner:\`, \`after:\`, \`before:\`, \`labels:\`, \`link:\`, \`style:\`.
+
+There is NO \`progress:\` or \`color:\` key. Show completion with \`status:\` + \`remaining:\`; set visuals with a \`style:\` reference (see full reference).
+
+## Progress & status
+
+\`\`\`
+item api "API redesign" duration:4w status:in-progress remaining:40%
+\`\`\`
+
+\`status:\` values: \`planned\`, \`in-progress\` (alias \`active\`), \`done\` (alias \`completed\`), \`at-risk\`, \`blocked\`, or a custom \`status\` you declare earlier.
+
+\`remaining:\` is the work *left*, written as a percent (\`40%\`) or an effort literal (\`1w\`). So an item that is 60% complete is \`remaining:40%\`. Omit \`remaining:\` for a fully open or fully done bar.
+
+## Config / includes (before roadmap)
+
+\`config\` blocks, \`include "path.nowline"\` — see full reference for ordering rules.
+
+Call \`reference\` with \`format: "full"\` for the complete man page, or \`examples\` for sample files.
+`;
+//# sourceMappingURL=reference-cheatsheet.js.map

package/dist/reference-cheatsheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-cheatsheet.js","sourceRoot":"","sources":["../src/reference-cheatsheet.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CnC,CAAC"}

package/dist/schema-vocab.d.ts

@@ -0,0 +1,6 @@
+export declare const SCHEMA_VOCABULARY: {
+    readonly directiveKeys: readonly ["locale", "author", "start", "scale", "length", "calendar", "logo", "logo-size"];
+    readonly entityTypes: readonly ["swimlane", "item", "parallel", "group", "person", "team", "anchor", "label", "size", "status", "milestone", "footnote"];
+    readonly itemPropertyKeys: readonly ["status", "owner", "after", "before", "size", "duration", "remaining", "capacity", "labels", "link", "style", "description"];
+};
+//# sourceMappingURL=schema-vocab.d.ts.map

package/dist/schema-vocab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-vocab.d.ts","sourceRoot":"","sources":["../src/schema-vocab.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,iBAAiB;;;;CA8CpB,CAAC"}

package/dist/schema-vocab.js

@@ -0,0 +1,55 @@
+// Structured key vocabulary for the MCP `schema` discovery tool.
+//
+// This is the one place whose whole job is to give agents ACCURATE DSL
+// keys so they stop hallucinating. Every key below is a real DSL token
+// (verified against specs/dsl.md and the man page) — render/CLI options
+// like `theme` or `now` are deliberately excluded because they are not
+// part of the `.nowline` source language.
+export const SCHEMA_VOCABULARY = {
+    // Keys valid on the `nowline` directive line (`locale`) and the
+    // `roadmap` declaration line. NOT render/CLI options (`theme`, `now`).
+    directiveKeys: [
+        'locale',
+        'author',
+        'start',
+        'scale',
+        'length',
+        'calendar',
+        'logo',
+        'logo-size',
+    ],
+    // Roadmap-section keywords — the declarable entity types.
+    entityTypes: [
+        'swimlane',
+        'item',
+        'parallel',
+        'group',
+        'person',
+        'team',
+        'anchor',
+        'label',
+        'size',
+        'status',
+        'milestone',
+        'footnote',
+    ],
+    // Properties valid on `item` declarations: item-specific keys plus the
+    // universal properties (`labels`, `link`, `style`, `description`).
+    // Visual treatment is a single `style:` reference — raw color/style
+    // props (`bg`, `fg`, `text`, ...) live in `style`/`default` config blocks.
+    itemPropertyKeys: [
+        'status',
+        'owner',
+        'after',
+        'before',
+        'size',
+        'duration',
+        'remaining',
+        'capacity',
+        'labels',
+        'link',
+        'style',
+        'description',
+    ],
+};
+//# sourceMappingURL=schema-vocab.js.map

package/dist/schema-vocab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-vocab.js","sourceRoot":"","sources":["../src/schema-vocab.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AACvE,wEAAwE;AACxE,uEAAuE;AACvE,0CAA0C;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC7B,gEAAgE;IAChE,uEAAuE;IACvE,aAAa,EAAE;QACX,QAAQ;QACR,QAAQ;QACR,OAAO;QACP,OAAO;QACP,QAAQ;QACR,UAAU;QACV,MAAM;QACN,WAAW;KACd;IACD,0DAA0D;IAC1D,WAAW,EAAE;QACT,UAAU;QACV,MAAM;QACN,UAAU;QACV,OAAO;QACP,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,OAAO;QACP,MAAM;QACN,QAAQ;QACR,WAAW;QACX,UAAU;KACb;IACD,uEAAuE;IACvE,mEAAmE;IACnE,oEAAoE;IACpE,2EAA2E;IAC3E,gBAAgB,EAAE;QACd,QAAQ;QACR,OAAO;QACP,OAAO;QACP,QAAQ;QACR,MAAM;QACN,UAAU;QACV,WAAW;QACX,UAAU;QACV,QAAQ;QACR,MAAM;QACN,OAAO;QACP,aAAa;KAChB;CACK,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+export declare const DiagnosticSchema: z.ZodObject<{
+    file: z.ZodString;
+    line: z.ZodNumber;
+    column: z.ZodNumber;
+    severity: z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        info: "info";
+    }>;
+    code: z.ZodString;
+    message: z.ZodString;
+    suggestion: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const InsightSchema: z.ZodObject<{
+    severity: z.ZodEnum<{
+        warning: "warning";
+        info: "info";
+    }>;
+    code: z.ZodString;
+    message: z.ZodString;
+    entityId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ValidateOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    diagnostics: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    insights: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            warning: "warning";
+            info: "info";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        entityId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ReadOutputSchema: z.ZodObject<{
+    path: z.ZodString;
+    source: z.ZodString;
+}, z.core.$strip>;
+export declare const CreateOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    path: z.ZodString;
+    diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const UpdateOutputSchema: z.ZodObject<{
+    ok: z.ZodBoolean;
+    path: z.ZodString;
+    diagnostics: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        line: z.ZodNumber;
+        column: z.ZodNumber;
+        severity: z.ZodEnum<{
+            error: "error";
+            warning: "warning";
+            info: "info";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        suggestion: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const DeleteOutputSchema: z.ZodObject<{
+    path: z.ZodString;
+}, z.core.$strip>;
+export declare const ListOutputSchema: z.ZodObject<{
+    paths: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const RenderOutputSchema: z.ZodObject<{
+    format: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    shareUrl: z.ZodOptional<z.ZodString>;
+    insights: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        severity: z.ZodEnum<{
+            warning: "warning";
+            info: "info";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+        entityId: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export declare const ExportOutputSchema: z.ZodObject<{
+    format: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    bytes: z.ZodOptional<z.ZodNumber>;
+    shareUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const ConvertOutputSchema: z.ZodObject<{
+    to: z.ZodEnum<{
+        json: "json";
+        nowline: "nowline";
+    }>;
+    result: z.ZodString;
+}, z.core.$strip>;
+export declare const CapabilitiesOutputSchema: z.ZodObject<{
+    themes: z.ZodArray<z.ZodString>;
+    icons: z.ZodArray<z.ZodString>;
+    locales: z.ZodArray<z.ZodString>;
+    formats: z.ZodArray<z.ZodString>;
+    templates: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const ListItemsOutputSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export declare const ReferenceOutputSchema: z.ZodObject<{
+    format: z.ZodEnum<{
+        condensed: "condensed";
+        full: "full";
+    }>;
+    text: z.ZodString;
+}, z.core.$strip>;
+export declare const ExamplesOutputSchema: z.ZodObject<{
+    names: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    name: z.ZodOptional<z.ZodString>;
+    source: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SchemaOutputSchema: z.ZodObject<{
+    directiveKeys: z.ZodArray<z.ZodString>;
+    entityTypes: z.ZodArray<z.ZodString>;
+    itemPropertyKeys: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;iBAQ3B,CAAC;AAEH,eAAO,MAAM,aAAa;;;;;;;;iBAKxB,CAAC;AAIH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;iBAG3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;iBAI7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;iBAE7B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;iBAE3B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;iBAO7B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;iBAK7B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;iBAG9B,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;iBAMnC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;iBAEhC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAGhC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC"}