@nowline/cli 0.6.0 → 0.8.0

package/dist/convert/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/convert/schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/convert/schema.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,OAAO,EAEH,sBAAsB,EAItB,eAAe,GAClB,MAAM,eAAe,CAAC"}

package/dist/generated/version.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.6.0";
+export declare const CLI_VERSION = "0.8.0";
 export interface CliBuild {
     /** Short git SHA at build time, or empty when not in a git checkout. */
     readonly sha: string;

package/dist/generated/version.js

@@ -1,7 +1,7 @@
 // Auto-generated by scripts/bundle-templates.mjs. Do not edit by hand.
-export const CLI_VERSION = "0.6.0";
+export const CLI_VERSION = "0.8.0";
 export const CLI_BUILD = {
-    "sha": "e2e4d9d",
+    "sha": "871752d",
     "isRelease": true,
     "isDirty": false
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nowline/cli",
-  "version": "0.6.0",
-  "description": "Nowline command-line interface — validate, convert, init",
+  "version": "0.8.0",
+  "description": "Command-line tool to check, convert, and create Nowline roadmaps.",
   "license": "Apache-2.0",
   "engines": {
     "node": ">=22",
@@ -38,19 +38,19 @@
     "consola": "^3.4.2",
     "js-yaml": "^4.1.1",
     "langium": "~4.2.4",
-    "@nowline/config": "0.6.0",
-    "@nowline/export": "0.6.0",
-    "@nowline/mcp": "0.6.0",
-    "@nowline/export-html": "0.6.0",
-    "@nowline/core": "0.6.0",
-    "@nowline/export-core": "0.6.0",
-    "@nowline/export-mermaid": "0.6.0",
-    "@nowline/export-pdf": "0.6.0",
-    "@nowline/export-png": "0.6.0",
-    "@nowline/export-xlsx": "0.6.0",
-    "@nowline/renderer": "0.6.0",
-    "@nowline/export-msproj": "0.6.0",
-    "@nowline/layout": "0.6.0"
+    "@nowline/config": "0.8.0",
+    "@nowline/core": "0.8.0",
+    "@nowline/mcp": "0.8.0",
+    "@nowline/export": "0.8.0",
+    "@nowline/export-core": "0.8.0",
+    "@nowline/export-html": "0.8.0",
+    "@nowline/export-msproj": "0.8.0",
+    "@nowline/export-png": "0.8.0",
+    "@nowline/export-pdf": "0.8.0",
+    "@nowline/export-mermaid": "0.8.0",
+    "@nowline/layout": "0.8.0",
+    "@nowline/export-xlsx": "0.8.0",
+    "@nowline/renderer": "0.8.0"
   },
   "devDependencies": {
     "@resvg/resvg-wasm": "^2.6.2",

package/src/commands/mcp.ts

@@ -1,21 +1,58 @@
+import { createServer } from 'node:http';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
 import { createMcpServer } from '@nowline/mcp/server';
 import type { ParsedArgs } from '../cli/args.js';
 
 /**
  * `nowline --mcp` handler.
  *
- * Starts a Model Context Protocol stdio server sharing the same @nowline/mcp
- * server factory as `npx @nowline/mcp`. Runs until the process receives
- * SIGINT/SIGTERM or the client closes stdin.
+ * Starts a Model Context Protocol server sharing the same @nowline/mcp
+ * server factory as `npx @nowline/mcp`.
+ *
+ * Transport selection:
+ *   stdio (default)  — when --port is absent.
+ *   Streamable HTTP  — when --port <N> is supplied; listens on localhost:<N>.
+ *
+ * Runs until the process receives SIGINT/SIGTERM or the client closes stdin.
  */
 export async function mcpHandler({ args }: { args: ParsedArgs }): Promise<void> {
     const root = args.root ?? process.cwd();
     const server = createMcpServer({ allowedRoot: root });
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    // Keep alive: the transport closes when stdin closes or the process is signalled.
-    await new Promise<void>((resolve) => {
-        transport.onclose = resolve;
-    });
+
+    const portStr = args.port;
+    if (portStr !== undefined) {
+        const port = parseInt(portStr, 10);
+        if (!Number.isFinite(port) || port < 1 || port > 65535) {
+            throw new Error(
+                `nowline: --port must be a number between 1 and 65535 (got ${portStr}).`,
+            );
+        }
+
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+        });
+        await server.connect(transport);
+
+        const httpServer = createServer(async (req, res) => {
+            await transport.handleRequest(req, res);
+        });
+
+        await new Promise<void>((resolve) => {
+            httpServer.listen(port, '127.0.0.1', () => {
+                process.stderr.write(
+                    `nowline: MCP Streamable HTTP listening on http://127.0.0.1:${port}\n`,
+                );
+            });
+            httpServer.on('close', resolve);
+            process.on('SIGINT', () => httpServer.close());
+            process.on('SIGTERM', () => httpServer.close());
+        });
+    } else {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        await new Promise<void>((resolve) => {
+            transport.onclose = resolve;
+        });
+    }
 }

package/src/convert/parse-json.ts

@@ -1,57 +1,2 @@
-import { CliError, ExitCode } from '../io/exit-codes.js';
-import { type JsonAstNode, NOWLINE_SCHEMA_VERSION, type NowlineDocument } from './schema.js';
-
-export interface ParseJsonResult {
-    document: NowlineDocument;
-    ast: JsonAstNode;
-}
-
-export function parseNowlineJson(text: string, filePath: string): ParseJsonResult {
-    let parsed: unknown;
-    try {
-        parsed = JSON.parse(text);
-    } catch (err) {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `${filePath}: invalid JSON — ${err instanceof Error ? err.message : String(err)}`,
-        );
-    }
-    const doc = parsed;
-    if (!isRecord(doc)) {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `${filePath}: JSON root must be an object with $nowlineSchema and ast.`,
-        );
-    }
-    const schema = doc.$nowlineSchema;
-    if (typeof schema !== 'string') {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `${filePath}: missing "$nowlineSchema" at document root.`,
-        );
-    }
-    if (schema !== NOWLINE_SCHEMA_VERSION) {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `${filePath}: unsupported $nowlineSchema "${schema}" (this CLI supports "${NOWLINE_SCHEMA_VERSION}").`,
-        );
-    }
-    const ast = doc.ast;
-    if (!isRecord(ast) || typeof ast.$type !== 'string') {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `${filePath}: document.ast must be an object with a "$type" field.`,
-        );
-    }
-    if (ast.$type !== 'NowlineFile') {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `${filePath}: document.ast.$type must be "NowlineFile" (got "${String(ast.$type)}").`,
-        );
-    }
-    return { document: doc as unknown as NowlineDocument, ast: ast as unknown as JsonAstNode };
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-    return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
+// Re-exported from @nowline/core. Kept here for backwards compatibility.
+export { type ParseJsonResult, parseNowlineJson } from '@nowline/core';

package/src/convert/printer.ts

@@ -1,376 +1,2 @@
-import { CliError, ExitCode } from '../io/exit-codes.js';
-import type { JsonAstNode } from './schema.js';
-
-// Keyed-property canonical order. Keys not in this list sort alphabetically after.
-const KEY_ORDER = [
-    'date',
-    'effort',
-    'on',
-    'size',
-    'duration',
-    'status',
-    'owner',
-    'after',
-    'before',
-    'remaining',
-    'labels',
-    'style',
-    'link',
-    'author',
-    'start',
-    'scale',
-    'calendar',
-    'header-position',
-    'timeline-position',
-    'minor-grid',
-];
-
-const INDENT = '  ';
-
-export interface PrintOptions {
-    indent?: string;
-}
-
-export function printNowlineFile(ast: JsonAstNode, options: PrintOptions = {}): string {
-    const printer = new Printer(options.indent ?? INDENT);
-    printer.file(ast);
-    return printer.toString();
-}
-
-class Printer {
-    private readonly lines: string[] = [];
-
-    constructor(private readonly indent: string) {}
-
-    toString(): string {
-        const text = this.lines.join('\n');
-        return text.endsWith('\n') ? text : `${text}\n`;
-    }
-
-    file(file: JsonAstNode): void {
-        assertType(file, 'NowlineFile');
-        const directive = file.directive as JsonAstNode | undefined;
-        if (directive) {
-            const props = asArray(directive.properties);
-            const tail = props.length > 0 ? ` ${props.map(renderProperty).join(' ')}` : '';
-            this.line(0, `nowline ${getString(directive, 'version')}${tail}`);
-            this.blank();
-        }
-        for (const inc of asArray(file.includes)) {
-            this.include(inc);
-        }
-        if (asArray(file.includes).length > 0) this.blank();
-        if (file.hasConfig) {
-            this.line(0, 'config');
-            this.blank();
-            for (const entry of asArray(file.configEntries)) {
-                this.configEntry(entry);
-                this.blank();
-            }
-        }
-        if (file.roadmapDecl) {
-            this.roadmap(file.roadmapDecl as JsonAstNode);
-            this.blank();
-        }
-        for (const entry of asArray(file.roadmapEntries)) {
-            this.roadmapEntry(entry, 0);
-        }
-    }
-
-    include(inc: JsonAstNode): void {
-        assertType(inc, 'IncludeDeclaration');
-        const path = getString(inc, 'path');
-        const options = asArray(inc.options)
-            .map((o) => `${getString(o, 'key')}:${getString(o, 'value')}`)
-            .join(' ');
-        const tail = options ? ` ${options}` : '';
-        this.line(0, `include ${JSON.stringify(path)}${tail}`);
-    }
-
-    configEntry(entry: JsonAstNode): void {
-        switch (entry.$type) {
-            case 'ScaleBlock':
-                return this.blockDecl('scale', asArray(entry.properties));
-            case 'CalendarBlock':
-                return this.blockDecl('calendar', asArray(entry.properties));
-            case 'StyleDeclaration':
-                return this.styleDecl(entry);
-            case 'DefaultDeclaration':
-                return this.defaultDecl(entry);
-            default:
-                throw new CliError(
-                    ExitCode.ValidationError,
-                    `Unknown config entry type: ${String(entry.$type)}`,
-                );
-        }
-    }
-
-    blockDecl(keyword: string, properties: JsonAstNode[]): void {
-        this.line(0, keyword);
-        for (const p of properties) {
-            this.line(1, renderBlockProperty(p));
-        }
-    }
-
-    styleDecl(entry: JsonAstNode): void {
-        assertType(entry, 'StyleDeclaration');
-        const header = declarationHeader('style', entry, []);
-        this.line(0, header);
-        for (const p of asArray(entry.properties)) {
-            this.line(1, renderBlockProperty(p));
-        }
-    }
-
-    defaultDecl(entry: JsonAstNode): void {
-        assertType(entry, 'DefaultDeclaration');
-        const entityType = getString(entry, 'entityType');
-        const props = renderProperties(asArray(entry.properties));
-        const tail = props ? ` ${props}` : '';
-        this.line(0, `default ${entityType}${tail}`);
-    }
-
-    roadmap(decl: JsonAstNode): void {
-        assertType(decl, 'RoadmapDeclaration');
-        this.line(0, declarationHeader('roadmap', decl, asArray(decl.properties)));
-    }
-
-    roadmapEntry(entry: JsonAstNode, depth: number): void {
-        switch (entry.$type) {
-            case 'PersonDeclaration':
-                return this.simpleEntity('person', entry, depth);
-            case 'TeamDeclaration':
-                return this.team(entry, depth);
-            case 'AnchorDeclaration':
-                return this.simpleEntity('anchor', entry, depth);
-            case 'SizeDeclaration':
-                return this.simpleEntity('size', entry, depth);
-            case 'StatusDeclaration':
-                return this.simpleEntity('status', entry, depth);
-            case 'LabelDeclaration':
-                return this.simpleEntity('label', entry, depth);
-            case 'MilestoneDeclaration':
-                return this.simpleEntity('milestone', entry, depth);
-            case 'FootnoteDeclaration':
-                return this.simpleEntity('footnote', entry, depth);
-            case 'SwimlaneDeclaration':
-                return this.swimlane(entry, depth);
-            default:
-                throw new CliError(
-                    ExitCode.ValidationError,
-                    `Unknown roadmap entry type: ${String(entry.$type)}`,
-                );
-        }
-    }
-
-    simpleEntity(keyword: string, entry: JsonAstNode, depth: number): void {
-        this.line(depth, declarationHeader(keyword, entry, asArray(entry.properties)));
-        this.maybeDescription(entry, depth + 1);
-    }
-
-    team(entry: JsonAstNode, depth: number): void {
-        this.line(depth, declarationHeader('team', entry, asArray(entry.properties)));
-        for (const child of asArray(entry.content)) {
-            this.teamContent(child, depth + 1);
-        }
-    }
-
-    teamContent(node: JsonAstNode, depth: number): void {
-        if (node.$type === 'PersonMemberRef') {
-            this.line(depth, `person ${getString(node, 'ref')}`);
-            return;
-        }
-        if (node.$type === 'TeamDeclaration') {
-            return this.team(node, depth);
-        }
-        if (node.$type === 'PersonDeclaration') {
-            return this.simpleEntity('person', node, depth);
-        }
-        if (node.$type === 'DescriptionDirective') {
-            return this.descriptionDirective(node, depth);
-        }
-        throw new CliError(
-            ExitCode.ValidationError,
-            `Unknown team content type: ${String(node.$type)}`,
-        );
-    }
-
-    swimlane(entry: JsonAstNode, depth: number): void {
-        this.line(depth, declarationHeader('swimlane', entry, asArray(entry.properties)));
-        for (const child of asArray(entry.content)) {
-            this.swimlaneContent(child, depth + 1);
-        }
-    }
-
-    swimlaneContent(node: JsonAstNode, depth: number): void {
-        switch (node.$type) {
-            case 'ItemDeclaration':
-                this.simpleEntity('item', node, depth);
-                return;
-            case 'ParallelBlock':
-                this.parallelBlock(node, depth);
-                return;
-            case 'GroupBlock':
-                this.groupBlock(node, depth);
-                return;
-            case 'DescriptionDirective':
-                this.descriptionDirective(node, depth);
-                return;
-            default:
-                throw new CliError(
-                    ExitCode.ValidationError,
-                    `Unknown swimlane content type: ${String(node.$type)}`,
-                );
-        }
-    }
-
-    parallelBlock(entry: JsonAstNode, depth: number): void {
-        this.line(depth, declarationHeader('parallel', entry, asArray(entry.properties)));
-        for (const child of asArray(entry.content)) {
-            this.swimlaneContent(child, depth + 1);
-        }
-    }
-
-    groupBlock(entry: JsonAstNode, depth: number): void {
-        this.line(depth, declarationHeader('group', entry, asArray(entry.properties)));
-        for (const child of asArray(entry.content)) {
-            this.swimlaneContent(child, depth + 1);
-        }
-    }
-
-    descriptionDirective(node: JsonAstNode, depth: number): void {
-        assertType(node, 'DescriptionDirective');
-        this.line(depth, `description ${JSON.stringify(getString(node, 'text'))}`);
-    }
-
-    maybeDescription(entry: JsonAstNode, depth: number): void {
-        const desc = entry.description as JsonAstNode | undefined;
-        if (desc) this.descriptionDirective(desc, depth);
-    }
-
-    private line(depth: number, text: string): void {
-        this.lines.push(this.indent.repeat(depth) + text);
-    }
-
-    private blank(): void {
-        if (this.lines.length === 0) return;
-        if (this.lines[this.lines.length - 1] === '') return;
-        this.lines.push('');
-    }
-}
-
-function declarationHeader(keyword: string, entry: JsonAstNode, properties: JsonAstNode[]): string {
-    const id = entry.name as string | undefined;
-    const title = entry.title as string | undefined;
-    const parts = [keyword];
-    if (id) parts.push(id);
-    if (title) parts.push(JSON.stringify(title));
-    const props = renderProperties(properties);
-    if (props) parts.push(props);
-    return parts.join(' ');
-}
-
-function renderProperties(properties: JsonAstNode[]): string {
-    return orderProperties(properties).map(renderProperty).join(' ');
-}
-
-function orderProperties(properties: JsonAstNode[]): JsonAstNode[] {
-    const indexOf = new Map(KEY_ORDER.map((k, i) => [k, i] as const));
-    return [...properties].sort((a, b) => {
-        const ak = normalizeKey(getString(a, 'key'));
-        const bk = normalizeKey(getString(b, 'key'));
-        const ai = indexOf.get(ak);
-        const bi = indexOf.get(bk);
-        if (ai !== undefined && bi !== undefined) return ai - bi;
-        if (ai !== undefined) return -1;
-        if (bi !== undefined) return 1;
-        return ak.localeCompare(bk);
-    });
-}
-
-function renderProperty(prop: JsonAstNode): string {
-    const key = normalizeKey(getString(prop, 'key'));
-    const values = asStringArray(prop.values);
-    const value = prop.value as string | undefined;
-    if (values.length >= 2) {
-        return `${key}:[${values.map(formatAtom).join(', ')}]`;
-    }
-    if (values.length === 1) {
-        return `${key}:${formatAtom(values[0])}`;
-    }
-    if (value !== undefined && value !== '') {
-        return `${key}:${formatAtom(value)}`;
-    }
-    return `${key}:`;
-}
-
-// Block-style property (one per line, rendered as `key: value`). Used inside
-// indented blocks like `scale`, `calendar`, and `style`. Uses formatAtom so
-// that quoted / template strings such as `label: "W{n}"` survive a round-trip.
-function renderBlockProperty(prop: JsonAstNode): string {
-    const key = normalizeKey(getString(prop, 'key'));
-    const values = asStringArray(prop.values);
-    const value = prop.value as string | undefined;
-    if (values.length >= 2) {
-        return `${key}: [${values.map(formatAtom).join(', ')}]`;
-    }
-    if (values.length === 1) {
-        return `${key}: ${formatAtom(values[0])}`;
-    }
-    if (value !== undefined && value !== '') {
-        return `${key}: ${formatAtom(value)}`;
-    }
-    return `${key}:`;
-}
-
-function normalizeKey(key: string): string {
-    return key.endsWith(':') ? key.slice(0, -1) : key;
-}
-
-const URL_RE = /^https?:\/\//;
-const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
-const DURATION_RE = /^\d+(?:\.\d+)?[dwmqy]$/;
-const PERCENTAGE_RE = /^\d+%$/;
-const HEX_COLOR_RE = /^#[0-9a-fA-F]{3,8}$/;
-const INTEGER_RE = /^\d+$/;
-const ID_RE = /^[a-zA-Z_][a-zA-Z0-9_-]*$/;
-
-function formatAtom(atom: string): string {
-    if (
-        URL_RE.test(atom) ||
-        DATE_RE.test(atom) ||
-        DURATION_RE.test(atom) ||
-        PERCENTAGE_RE.test(atom) ||
-        HEX_COLOR_RE.test(atom) ||
-        INTEGER_RE.test(atom) ||
-        ID_RE.test(atom)
-    ) {
-        return atom;
-    }
-    // Already-quoted string survives a round trip through JSON.stringify by re-quoting once.
-    if (atom.startsWith('"') && atom.endsWith('"')) return atom;
-    return JSON.stringify(atom);
-}
-
-function asArray(value: unknown): JsonAstNode[] {
-    if (Array.isArray(value)) return value as JsonAstNode[];
-    return [];
-}
-
-function asStringArray(value: unknown): string[] {
-    if (!Array.isArray(value)) return [];
-    return value.filter((v): v is string => typeof v === 'string');
-}
-
-function getString(node: JsonAstNode | Record<string, unknown>, key: string): string {
-    const value = (node as Record<string, unknown>)[key];
-    return typeof value === 'string' ? value : '';
-}
-
-function assertType(node: JsonAstNode, expected: string): void {
-    if (node.$type !== expected) {
-        throw new CliError(
-            ExitCode.ValidationError,
-            `Expected $type "${expected}", got "${String(node.$type)}"`,
-        );
-    }
-}
+// Re-exported from @nowline/core. Kept here for backwards compatibility.
+export { type PrintOptions, printNowlineFile } from '@nowline/core';