@nowline/mcp 0.8.6 → 0.9.0

package/dist/ui/payload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/ui/payload.ts"],"names":[],"mappings":"AAQA,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,GAC5D,cAAc,GAAG,SAAS,CAc5B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,cAAc,GAAG,SAAS,CAS5B"}
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../src/ui/payload.ts"],"names":[],"mappings":"AAQA,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;CAClD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,GAC5D,cAAc,GAAG,SAAS,CAc5B;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAC1C,cAAc,GAAG,SAAS,CAc5B;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGlD"}

package/dist/ui/payload.js

@@ -38,12 +38,35 @@ export function parsePreviewFromContent(content) {
 export function parsePreviewFromArguments(args) {
     if (!args || typeof args.source !== 'string')
         return undefined;
+    // A `timezone` without a `now` names a date only the server can resolve;
+    // wait for the result payload, which carries it.
+    if (typeof args.timezone === 'string' && typeof args.now !== 'string')
+        return undefined;
     return {
         source: args.source,
         theme: typeof args.theme === 'string' ? args.theme : undefined,
         now: typeof args.now === 'string' ? args.now : undefined,
         width: typeof args.width === 'number' ? args.width : undefined,
+        nonWorking: args.nonWorking === 'hide' || args.nonWorking === 'show' ? args.nonWorking : undefined,
         locale: 'en-US',
     };
 }
+/**
+ * The shell's non-working dropdown value for a payload. A payload with no
+ * `nonWorking` maps to `'file'` (no override), so the file's own key applies;
+ * anything other than `hide` or `show` is treated as unset.
+ */
+export function toNonWorkingOverride(nonWorking) {
+    return nonWorking === 'hide' || nonWorking === 'show' ? nonWorking : 'file';
+}
+/**
+ * The shell's now-line value for a payload's `now`. Omitted means today; `-`
+ * (the CLI's `--now -` sentinel, also accepted by the `render` tool) hides the
+ * now-line; a date passes through.
+ */
+export function toNowOverride(now) {
+    if (now === '-')
+        return 'hide';
+    return typeof now === 'string' && now.length > 0 ? now : 'today';
+}
 //# sourceMappingURL=payload.js.map

package/dist/ui/payload.js.map

@@ -1 +1 @@
-{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/ui/payload.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,sEAAsE;AACtE,gDAAgD;AAehD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACnC,OAA2D;IAE3D,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,SAAS;QACnD,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;YACxD,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzE,OAAO,MAAM,CAAC;YAClB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACrC,IAAyC;IAEzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/D,OAAO;QACH,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC9D,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QACxD,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC9D,MAAM,EAAE,OAAO;KAClB,CAAC;AACN,CAAC"}
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../src/ui/payload.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,sEAAsE;AACtE,gDAAgD;AAiBhD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACnC,OAA2D;IAE3D,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,SAAS;QACnD,IAAI,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;YACxD,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzE,OAAO,MAAM,CAAC;YAClB,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACL,qBAAqB;QACzB,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB,CACrC,IAAyC;IAEzC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/D,yEAAyE;IACzE,iDAAiD;IACjD,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxF,OAAO;QACH,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC9D,GAAG,EAAE,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QACxD,KAAK,EAAE,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAC9D,UAAU,EACN,IAAI,CAAC,UAAU,KAAK,MAAM,IAAI,IAAI,CAAC,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QAC1F,MAAM,EAAE,OAAO;KAClB,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAmB;IACpD,OAAO,UAAU,KAAK,MAAM,IAAI,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAY;IACtC,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,MAAM,CAAC;IAC/B,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;AACrE,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nowline/mcp",
   "mcpName": "io.nowline/nowline",
-  "version": "0.8.6",
+  "version": "0.9.0",
   "description": "Nowline MCP server — lets AI agents create, edit, and render your roadmaps.",
   "license": "Apache-2.0",
   "engines": {
@@ -22,6 +22,10 @@
     "./server": {
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js"
+    },
+    "./http": {
+      "types": "./dist/http.d.ts",
+      "import": "./dist/http.js"
     }
   },
   "files": [
@@ -30,26 +34,27 @@
   ],
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^2.0.3",
-    "@modelcontextprotocol/node": "^2.1.0",
-    "@modelcontextprotocol/server": "^2.2.0",
-    "@nowline/browser": "0.8.6",
-    "@nowline/core": "0.8.6",
-    "@nowline/export": "0.8.6",
-    "@nowline/export-core": "0.8.6",
-    "@nowline/layout": "0.8.6",
-    "@nowline/preview": "0.8.6",
-    "@nowline/preview-shell": "0.8.6",
-    "@nowline/share-link": "0.8.6",
+    "@modelcontextprotocol/node": "^2.1.1",
+    "@modelcontextprotocol/server": "^2.3.1",
+    "@nowline/browser": "0.9.0",
+    "@nowline/config": "0.9.0",
+    "@nowline/core": "0.9.0",
+    "@nowline/export": "0.9.0",
+    "@nowline/export-core": "0.9.0",
+    "@nowline/layout": "0.9.0",
+    "@nowline/preview": "0.9.0",
+    "@nowline/preview-shell": "0.9.0",
+    "@nowline/share-link": "0.9.0",
     "@resvg/resvg-wasm": "^2.6.2",
     "langium": "~4.4.0",
-    "zod": "^4.6.5"
+    "zod": "^4.6.7"
   },
   "devDependencies": {
-    "@modelcontextprotocol/client": "^2.2.0",
-    "@modelcontextprotocol/inspector": "2.8.0",
-    "@types/node": "^26.6.3",
+    "@modelcontextprotocol/client": "^2.3.1",
+    "@modelcontextprotocol/inspector": "2.12.0",
+    "@types/node": "^26.6.5",
     "esbuild": "^0.28.2",
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.5"
   },
   "scripts": {
     "prebuild": "node scripts/bundle-resources.mjs && node scripts/bundle-ui.mjs",

package/src/capabilities.ts

@@ -1,7 +1,9 @@
+import { THEME_NAMES } from '@nowline/layout';
+
 // Aggregated server capabilities. Used by the `capabilities` tool and the
 // individual `list-*` projection tools. Values are hardcoded to their stable
 // registry sources and must be kept in sync with:
-//   - themes: @nowline/layout/src/themes/index.ts (ThemeName)
+//   - themes: THEME_NAMES, imported from @nowline/layout
 //   - icons: @nowline/renderer/src/svg/icons.ts (CAPACITY_ICON_SVG keys)
 //   - locales: @nowline/core/src/i18n (message bundle files)
 //   - formats: @nowline/export ExportFormat union
@@ -16,7 +18,7 @@ export interface ServerCapabilities {
 }
 
 export const CAPABILITIES: ServerCapabilities = {
-    themes: ['light', 'dark', 'grayscale'],
+    themes: THEME_NAMES,
     // Built-in `capacity-icon:` vocabulary (CAPACITY_ICON_SVG keys).
     icons: ['person', 'people', 'points', 'time'],
     locales: ['en', 'fr', 'fr-CA', 'fr-FR'],

package/src/diagnostics.ts

@@ -4,11 +4,20 @@ import {
     collectDocumentDiagnostics,
     createNowlineServices,
     extractSuggestion,
+    inferCodeFromMessage,
+    isRoutedResolveDiagnostic,
     type NowlineFile,
+    type ResolveDiagnostic,
     resolveDiagnosticCode,
-    resolveIncludes,
 } from '@nowline/core';
-import { collectLayoutInsights, type LayoutInsight, layoutRoadmap } from '@nowline/layout';
+import {
+    type HostEnv,
+    type RenderInputs,
+    type StagedRoadmap,
+    type StageResult,
+    stageForExport,
+} from '@nowline/export';
+import { collectLayoutInsights, type LayoutInsight } from '@nowline/layout';
 import { URI } from 'langium';
 
 export interface McpDiagnostic {
@@ -91,6 +100,50 @@ export function collectMcpDiagnostics(
     return out;
 }
 
+/**
+ * A routed include-resolver diagnostic (a wave rule, specs/waves.md §6.1, or
+ * an included file's NL.E0302) as an MCP diagnostic: its stable code, the
+ * file it points into and a 1-based line and column, the validator's for the
+ * same finding when the diagnostic carries a range (column 1 otherwise).
+ * WV8, the one uncoded wave rule, is labelled like the validator's copy. An
+ * included file's syntax error takes its position from the lexer or parser.
+ */
+export function resolveDiagnosticToMcp(diag: ResolveDiagnostic): McpDiagnostic {
+    // An included file's syntax error, labelled like the root file's own.
+    if (diag.syntax) {
+        const column =
+            diag.syntax.origin === 'lexer'
+                ? diag.syntax.error.column
+                : diag.syntax.error.token?.startColumn;
+        return {
+            file: diag.sourcePath,
+            line: (diag.line ?? 0) + 1,
+            // An error at end of input has no position (NaN).
+            column: column !== undefined && Number.isFinite(column) ? column : 1,
+            severity: 'error',
+            code: diag.syntax.origin === 'lexer' ? 'lexing-error' : 'parsing-error',
+            message: diag.message,
+        };
+    }
+    const suggestion = extractSuggestion(diag.message);
+    return {
+        file: diag.sourcePath,
+        line: (diag.range?.start.line ?? diag.line ?? 0) + 1,
+        column: (diag.range?.start.character ?? 0) + 1,
+        severity: diag.severity,
+        code: diag.code ?? inferCodeFromMessage(diag.message),
+        message: diag.message,
+        ...(suggestion === undefined ? {} : { suggestion }),
+    };
+}
+
+/** The routed diagnostics among `diagnostics`, as MCP diagnostics. */
+export function routedResolveDiagnosticsToMcp(
+    diagnostics: readonly ResolveDiagnostic[],
+): McpDiagnostic[] {
+    return diagnostics.filter(isRoutedResolveDiagnostic).map(resolveDiagnosticToMcp);
+}
+
 export function diagnosticsErrorResponse(filePath: string, diagnostics: McpDiagnostic[]) {
     return {
         content: [
@@ -103,6 +156,19 @@ export function diagnosticsErrorResponse(filePath: string, diagnostics: McpDiagn
     };
 }
 
+/**
+ * The error response when include resolution reports a routed (wave-rule)
+ * error: the validator's diagnostics (warnings only, since `doc` validated)
+ * followed by `routed`.
+ */
+export function includeDiagnosticsResponse(
+    doc: Awaited<ReturnType<typeof buildDocument>>,
+    filePath: string,
+    routed: McpDiagnostic[],
+) {
+    return diagnosticsErrorResponse(filePath, [...collectMcpDiagnostics(doc, filePath), ...routed]);
+}
+
 export async function diagnosticsErrorBlock(
     source: string,
     filePath: string,
@@ -118,47 +184,41 @@ export async function diagnosticsErrorBlock(
     return { ok: true, doc };
 }
 
-export interface LayoutInsightInputs {
-    source: string;
-    filePath: string;
-    today?: Date;
-    theme?: 'light' | 'dark' | 'grayscale';
-    width?: number;
-    locale?: string;
-    readFile?: (absPath: string) => Promise<string>;
-    /** Pre-built document to reuse instead of re-parsing `source`. The
-     *  caller is responsible for passing a doc parsed from the same
-     *  `source` (e.g. the one from `diagnosticsErrorBlock`). */
-    doc?: Awaited<ReturnType<typeof buildDocument>>;
+/**
+ * Stage a validated document once for a tool call: the render, the export,
+ * the insights and the routed include diagnostics all read this one result.
+ * `doc` is the document `diagnosticsErrorBlock` (or `validate`) already built
+ * from `source`, so nothing is parsed again.
+ */
+export function stageMcpRoadmap(
+    doc: Awaited<ReturnType<typeof buildDocument>>,
+    source: string,
+    inputs: RenderInputs,
+    host: HostEnv,
+): Promise<StageResult> {
+    return stageForExport(source, inputs, host, { document: doc, services: getMcpServices() });
 }
 
-export async function collectMcpLayoutInsights(inputs: LayoutInsightInputs): Promise<McpInsight[]> {
-    const doc = inputs.doc ?? (await buildDocument(inputs.source));
-    const diagnostics = collectMcpDiagnostics(doc, inputs.filePath);
-    if (diagnostics.some((d) => d.severity === 'error')) {
-        return [];
-    }
-
-    const services = getMcpServices();
-    const file = doc.parseResult.value;
-    const resolved = await resolveIncludes(file, inputs.filePath, {
-        services: services.Nowline,
-        readFile: inputs.readFile,
-    });
-    if (resolved.diagnostics.some((d) => d.severity === 'error')) {
-        return [];
+/**
+ * The routed (wave-rule) include diagnostics a stage reports, as MCP
+ * diagnostics, errors included. An uncoded include error takes precedence and
+ * hides them, as does a validator error (specs/waves.md §6.1).
+ */
+export function stageRoutedDiagnostics(stage: StageResult): McpDiagnostic[] {
+    if (stage.kind === 'staged' || (stage.kind === 'include-error' && !stage.legacy)) {
+        return stage.routed.map(resolveDiagnosticToMcp);
     }
+    return [];
+}
 
-    const layout = layoutRoadmap(file, resolved, {
-        today: inputs.today,
-        theme: inputs.theme ?? 'light',
-        width: inputs.width,
-        locale: inputs.locale ?? 'en-US',
-    });
-
-    return collectLayoutInsights(layout, {
-        today: inputs.today,
-        locale: inputs.locale ?? 'en-US',
+/**
+ * Layout insights read from a staged roadmap's model: the layout the render
+ * draws, logo included, so the insights describe the same header and chart.
+ */
+export function layoutInsightsFromStage(stage: StagedRoadmap): McpInsight[] {
+    return collectLayoutInsights(stage.model, {
+        today: stage.layout.today,
+        locale: stage.layout.locale ?? 'en-US',
     }).map(layoutInsightToMcp);
 }