@nowline/cli 0.5.0 → 0.6.0

package/man/nowline.1

@@ -10,6 +10,7 @@
 .Op Fl o Ar path
 .Op Fl t Ar theme
 .Op Fl -now Ar date
+.Op Fl -timezone Ar zone
 .Op Ar options
 .Ar input
 .Nm
@@ -182,13 +183,50 @@ Default: inferred from extension; standard input defaults to
 .Sy light | dark .
 .It Fl -now Ar date
 .Sq Now
-anchor for the now-line and date math, in
+anchor for the now-line and date math.
+Accepts a bare
 .Pa YYYY-MM-DD
-form.
-Default: today (the OS calendar date in UTC).
+(floating; zone-independent) or a full ISO\~8601 instant such as
+.Pa 2026-06-04T23:00:00Z
+or
+.Pa 2026-06-05T06:00:00+07:00
+(an embedded Z or \(pmHH:MM offset overrides
+.Fl -timezone ) .
+A bare date or an instant without an offset is floating: the written date
+part is used and
+.Fl -timezone
+is ignored.
+Default: today's civil date in the host zone (or
+.Fl -timezone
+if given).
 Pass
 .Fl -now Sq -
 to suppress the now-line entirely.
+.It Fl -timezone Ar zone
+Timezone used for the clock-based
+.Dq today
+default; only consulted when
+.Fl -now
+is omitted.
+Accepted forms:
+.Bl -tag -width "America/Los_Angeles" -compact
+.It Sy local
+Host/viewer zone (default when the flag is absent).
+.It Sy UTC
+UTC.
+.It Sy Z , +00:00
+Zero-offset shorthand (equivalent to
+.Sy UTC ) .
+.It Sy \(pmHH , \(pmHH:MM , \(pmHHMM
+Fixed offset (DST-naive; documented caveat).
+.It Sy America/Los_Angeles
+Any valid IANA timezone name.
+.El
+Ambiguous abbreviations such as
+.Sy PST
+and
+.Sy IST
+are rejected with a clear error.
 .It Fl -locale Ar bcp47
 BCP-47 language tag for the operator's CLI message output (validator
 diagnostics on standard error,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nowline/cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Nowline command-line interface — validate, convert, init",
   "license": "Apache-2.0",
   "engines": {
@@ -32,24 +32,28 @@
   "dependencies": {
     "@babel/code-frame": "^7.29.0",
     "@clack/prompts": "^1.4.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
     "chalk": "^5.6.2",
     "citty": "^0.2.2",
     "consola": "^3.4.2",
     "js-yaml": "^4.1.1",
     "langium": "~4.2.4",
-    "@nowline/config": "0.5.0",
-    "@nowline/export-core": "0.5.0",
-    "@nowline/core": "0.5.0",
-    "@nowline/export-html": "0.5.0",
-    "@nowline/export-mermaid": "0.5.0",
-    "@nowline/export-pdf": "0.5.0",
-    "@nowline/export-msproj": "0.5.0",
-    "@nowline/export-png": "0.5.0",
-    "@nowline/export-xlsx": "0.5.0",
-    "@nowline/layout": "0.5.0",
-    "@nowline/renderer": "0.5.0"
+    "@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"
   },
   "devDependencies": {
+    "@resvg/resvg-wasm": "^2.6.2",
     "@types/babel__code-frame": "^7.27.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.9.1",
@@ -60,6 +64,7 @@
     "bundle-templates": "node scripts/bundle-templates.mjs",
     "prebuild": "node scripts/bundle-templates.mjs",
     "build": "tsc -b tsconfig.json",
+    "postbuild": "node scripts/copy-wasm.mjs",
     "watch": "tsc -b tsconfig.json --watch",
     "pretest": "node scripts/bundle-templates.mjs",
     "test": "vitest run",

package/scripts/bun-entry.mjs

@@ -0,0 +1,25 @@
+#!/usr/bin/env bun
+// Bun-only entry point for `bun build --compile`.
+//
+// `import ... with { type: 'file' }` is the ONLY pattern Bun's static
+// analyzer recognises for embedding binary assets in a standalone binary.
+// `Bun.file(new URL(..., import.meta.url))` is NOT tracked by the bundler
+// and leaves the asset out of the embedded VFS.
+//
+// This shim:
+//   1. Imports resvg.wasm via the recognised pattern, yielding a VFS path.
+//   2. Stashes that path in globalThis so loadWasm() (in dist/index.js) can
+//      read it with Bun.file() at runtime.
+//   3. Delegates immediately to dist/index.js (the normal Node entry).
+//
+// compile.mjs passes this file as the bun --compile entry instead of
+// dist/index.js directly.
+
+// @ts-expect-error — Bun-specific import assertion; not valid Node.js/TypeScript.
+import resvgWasmPath from '../dist/resvg.wasm' with { type: 'file' };
+
+// Make the VFS path available to loadWasm() in dist/commands/render.js.
+globalThis.__RESVG_WASM_PATH__ = resvgWasmPath;
+
+// Run the CLI.
+await import('../dist/index.js');

package/scripts/compile.mjs

@@ -25,9 +25,9 @@ const packageRoot = path.resolve(__dirname, '..');
 // Tight by design: a breach should trigger the conversation called out in
 // `specs/cli-distribution.md` "Size budget", not be silently absorbed.
 //
-// Last measured (bun 1.3.13) using --target on macOS-arm64:
-//   darwin-arm64=70  darwin-x64=75  linux-arm64=107  linux-x64=107
-//   windows-arm64=119  windows-x64=122
+// Last measured (bun 1.3.14, @resvg/resvg-wasm, no native .node) on macOS-arm64:
+//   darwin-arm64=67  darwin-x64=~72  linux-arm64=~104  linux-x64=~104
+//   windows-arm64=~116  windows-x64=~119
 const ALL_TARGETS = [
     { id: 'bun-darwin-arm64', suffix: 'macos-arm64', maxMb: 80 },
     { id: 'bun-darwin-x64', suffix: 'macos-x64', maxMb: 85 },
@@ -80,10 +80,15 @@ function main() {
         }
     }
 
-    const entry = path.join(packageRoot, 'dist', 'index.js');
-    if (!safeStat(entry)) {
+    // Use the bun-entry shim as the compile entry point so Bun's static
+    // analyzer sees the `import ... with { type: 'file' }` declaration that
+    // embeds resvg.wasm in the binary.  The shim sets __RESVG_WASM_PATH__
+    // and then delegates to dist/index.js.
+    const entry = path.join(packageRoot, 'scripts', 'bun-entry.mjs');
+    const distEntry = path.join(packageRoot, 'dist', 'index.js');
+    if (!safeStat(distEntry)) {
         console.error(
-            `error: expected ${path.relative(packageRoot, entry)} to exist; run \`pnpm build\` first.`,
+            `error: expected ${path.relative(packageRoot, distEntry)} to exist; run \`pnpm build\` first.`,
         );
         process.exit(1);
     }

package/scripts/copy-wasm.mjs

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+// Copy @resvg/resvg-wasm/index_bg.wasm → dist/resvg.wasm so the CLI can
+// locate it at runtime (both uncompiled Node and bun --compile, which embeds
+// files referenced via new URL('./resvg.wasm', import.meta.url)).
+//
+// Runs as the `postbuild` step, after tsc has created dist/.
+
+import { copyFile, mkdir } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const packageRoot = resolve(__dirname, '..');
+
+const req = createRequire(import.meta.url);
+const wasmEntry = req.resolve('@resvg/resvg-wasm');
+const wasmSrc = resolve(dirname(wasmEntry), 'index_bg.wasm');
+const wasmDest = resolve(packageRoot, 'dist', 'resvg.wasm');
+
+await mkdir(resolve(packageRoot, 'dist'), { recursive: true });
+await copyFile(wasmSrc, wasmDest);
+console.log(`copied resvg.wasm → dist/resvg.wasm`);

package/src/cli/args.ts

@@ -1,7 +1,7 @@
 import { type ParseArgsConfig, parseArgs } from 'node:util';
 import { CliError, ExitCode } from '../io/exit-codes.js';
 
-export type ModeKind = 'render' | 'serve' | 'init' | 'help' | 'version';
+export type ModeKind = 'render' | 'serve' | 'init' | 'mcp' | 'help' | 'version';
 
 export interface ParsedArgs {
     /** Resolved mode after dispatch (mutual-exclusivity already checked). */
@@ -23,9 +23,16 @@ export interface ParsedArgs {
     /** Now-line date string from `--now`. Undefined means "use the actual
      *  current date" (the default). The literal value `"-"` means
      *  "suppress the now-line entirely" (mirrors the Unix-`-` convention
-     *  used elsewhere in the CLI). Otherwise expected as YYYY-MM-DD;
-     *  parsed downstream by resolveNowArg. */
+     *  used elsewhere in the CLI). Accepts YYYY-MM-DD (floating) or a
+     *  full ISO 8601 instant with Z/offset; parsed downstream by resolveToday. */
     now?: string;
+    /**
+     * IANA timezone name, ISO 8601 offset, `"UTC"`, `"Z"`, or `"local"`.
+     * Governs which civil date is "today" when `--now` is omitted.
+     * Defaults to the host's local zone when absent.
+     * Ignored when `--now` carries an explicit date or embedded offset.
+     */
+    timezone?: string;
     noLinks: boolean;
     scale?: string;
     strict: boolean;
@@ -39,6 +46,12 @@ export interface ParsedArgs {
     fontSans?: string;
     fontMono?: string;
     headless: boolean;
+    /**
+     * Opt in to the platform font probe for raster/PDF export. Off by default
+     * (bundled-first): exports use the bundled DejaVu pair on every OS so the
+     * output is identical cross-platform and matches the live preview.
+     */
+    useSystemFonts: boolean;
     start?: string;
 
     /**
@@ -59,6 +72,9 @@ export interface ParsedArgs {
 
     // Init
     template?: string;
+
+    // MCP
+    root?: string;
 }
 
 /**
@@ -78,6 +94,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
             strict: false,
             open: false,
             headless: false,
+            useSystemFonts: false,
         };
     }
 
@@ -97,6 +114,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
 
             serve: { type: 'boolean' },
             init: { type: 'boolean' },
+            mcp: { type: 'boolean' },
             'dry-run': { type: 'boolean', short: 'n' },
 
             theme: { type: 'string', short: 't' },
@@ -105,6 +123,9 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
             // suppress the now-line entirely (Unix-`-` sentinel; same idea
             // as `-o -` for stdout).
             now: { type: 'string' },
+            // `--timezone` controls which civil date is "today" when --now is
+            // omitted. Accepts IANA names, ISO offsets, "UTC", "Z", or "local".
+            timezone: { type: 'string' },
             'no-links': { type: 'boolean' },
             scale: { type: 'string', short: 's' },
             strict: { type: 'boolean' },
@@ -119,6 +140,9 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
 
             template: { type: 'string' },
 
+            // MCP
+            root: { type: 'string' },
+
             // Format-specific (m2c)
             'page-size': { type: 'string' },
             orientation: { type: 'string' },
@@ -126,6 +150,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
             'font-sans': { type: 'string' },
             'font-mono': { type: 'string' },
             headless: { type: 'boolean' },
+            'use-system-fonts': { type: 'boolean' },
             start: { type: 'string' },
 
             // Localization (m-loc-b)
@@ -153,6 +178,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
             strict: false,
             open: false,
             headless: false,
+            useSystemFonts: false,
         };
     }
     if (values.version === true) {
@@ -164,6 +190,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
             strict: false,
             open: false,
             headless: false,
+            useSystemFonts: false,
         };
     }
 
@@ -177,6 +204,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
     const modes: ModeKind[] = [];
     if (values.serve === true) modes.push('serve');
     if (values.init === true) modes.push('init');
+    if (values.mcp === true) modes.push('mcp');
     if (modes.length > 1) {
         throw new CliError(
             ExitCode.InputError,
@@ -187,7 +215,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
     const dryRun = values['dry-run'] === true;
     const mode: ModeKind = modes[0] ?? 'render';
 
-    if (dryRun && (mode === 'serve' || mode === 'init')) {
+    if (dryRun && (mode === 'serve' || mode === 'init' || mode === 'mcp')) {
         throw new CliError(
             ExitCode.InputError,
             `nowline: --dry-run cannot be combined with --${mode}.`,
@@ -215,6 +243,7 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
         inputFormat: stringOrUndefined(values['input-format']),
         theme: stringOrUndefined(values.theme),
         now: stringOrUndefined(values.now),
+        timezone: stringOrUndefined(values.timezone),
         noLinks: values['no-links'] === true,
         scale: stringOrUndefined(values.scale),
         strict: values.strict === true,
@@ -231,8 +260,10 @@ export function parseArgv(argv: readonly string[]): ParsedArgs {
         fontSans: stringOrUndefined(values['font-sans']),
         fontMono: stringOrUndefined(values['font-mono']),
         headless: values.headless === true,
+        useSystemFonts: values['use-system-fonts'] === true,
         start: stringOrUndefined(values.start),
         locale: stringOrUndefined(values.locale),
+        root: stringOrUndefined(values.root),
     };
 }
 

package/src/cli/help.ts

@@ -31,14 +31,33 @@ MODE FLAGS (mutually exclusive)
                           rendered output to disk on each rebuild.
       --init [<name>]     Scaffold a starter .nowline file in cwd. Positional
                           becomes project name; .nowline appended if missing.
+      --mcp               Start a Model Context Protocol (MCP) stdio server
+                          exposing validate, render, export, and file tools.
+                          Shares the same @nowline/mcp server code as
+                          \`npx @nowline/mcp\`.
   -n, --dry-run           Run the full pipeline (parse + validate + layout +
                           format) but skip the write step. Subsumes the old
                           'validate' verb. Exit 0 on success, 1 on errors.
 
 RENDER OPTIONS
   -t, --theme <name>      light | dark | grayscale (greyscale alias)
-      --now <YYYY-MM-DD>  Date for the now-line. Default: today.
-                          Use --now - to suppress the now-line.
+      --now <date>        Date for the now-line. Default: today (local civil date).
+                          Accepts YYYY-MM-DD (floating date, zone-independent) or a
+                          full ISO 8601 instant: YYYY-MM-DDTHH:MM:SSZ or with a
+                          ±HH:MM offset. A bare date or ISO date without an offset is
+                          treated as floating (written date part used, --timezone
+                          ignored). An embedded Z or ±offset overrides --timezone.
+                          Use --now - to suppress the now-line entirely.
+      --timezone <zone>   Timezone for the clock-based "today" default.
+                          Only consulted when --now is omitted; ignored when --now
+                          carries an explicit date or embedded ISO offset.
+                          Accepted forms:
+                            local          — host/viewer zone (default)
+                            UTC            — UTC
+                            Z, +00:00      — zero-offset shorthand (= UTC)
+                            ±HH, ±HH:MM, ±HHMM  — fixed offset (DST-naive)
+                            America/Los_Angeles   — IANA timezone name
+                          Ambiguous abbreviations (PST, IST, CET) are rejected.
       --no-links          Omit link icons from rendered items.
   -s, --scale <n>         Raster scale factor (PNG only; default 1).
       --strict            Promote asset / sanitizer warnings to errors.
@@ -52,11 +71,30 @@ RENDER OPTIONS
                           wins for content. Falls back to LC_ALL /
                           LC_MESSAGES / LANG, then en-US.
 
+FONT OPTIONS (png, pdf)
+                          Raster/PDF export is bundled-first: by default it
+                          renders with the bundled DejaVu pair on every OS, so
+                          output is identical cross-platform and matches the
+                          live preview.
+      --font-sans <ref>   Override the sans font: a .ttf/.otf/.ttc path or a
+                          known alias. A variable font is not rasterizable and
+                          is replaced by bundled DejaVu (error under --strict).
+      --font-mono <ref>   Override the mono font (path or alias; same rules).
+      --use-system-fonts  Opt in to the platform font probe; the first static
+                          installed font wins (variable fonts skipped), bundled
+                          if none. Output then varies by machine.
+      --headless          Force the bundled DejaVu pair, ignoring system fonts
+                          and --use-system-fonts. Implied in CI without a TTY.
+
 SERVE OPTIONS
   -p, --port <n>          Port (default: 4318).
       --host <host>       Bind address (default: 127.0.0.1).
       --open              Open the browser on start.
 
+MCP OPTIONS
+      --root <dir>        Allowed-root directory for file tools (default: cwd).
+                          File paths are resolved and restricted to this root.
+
 LOGGING (mutually exclusive)
   -v, --verbose           Print extra diagnostics to stderr.
   -q, --quiet             Suppress non-error stderr.
@@ -75,6 +113,8 @@ EXAMPLES
   nowline roadmap.nowline --dry-run         # validate-only
   nowline roadmap.nowline --serve -p 8080   # live preview
   nowline --init my-project                 # scaffold ./my-project.nowline
+  nowline --mcp                             # start MCP stdio server in cwd
+  nowline --mcp --root ./roadmaps           # MCP server with custom root
 
 EXIT CODES
   0  Success

package/src/commands/mcp.ts

@@ -0,0 +1,21 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.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.
+ */
+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;
+    });
+}