@markdy/cli 0.8.20 → 0.8.22

package/README.md

@@ -35,16 +35,20 @@ npx markdy render examples/showcase/bullet-reveal.markdy --out examples/xscene.h
 ## Commands
 
 ```bash
-markdy                 # launch a local browser playground on http://127.0.0.1:4242
-markdy lint scene.markdy
-markdy fmt scene.markdy
-markdy fmt scene.markdy --write
-markdy render scene.markdy --out dist/scene.html
-markdy explain scene.markdy
-markdy new explainer demo.markdy
-markdy docs
-markdy ai
-markdy check-all .
+markdy                                   # launch a local browser playground on http://127.0.0.1:4242
+markdy lint scene.markdy                 # syntax validation
+markdy lint scene.markdy --arch-rules    # run Well-Architected governance & cycle rules
+markdy fmt scene.markdy --write          # format MarkdyScript file
+markdy import flow.mmd --out scene.markdy # import Mermaid, draw.io, Compose, K8s, or Terraform
+markdy diff v1.markdy v2.markdy          # semantic AST diff summary table
+markdy diff v1.markdy v2.markdy --evolution # generate animated migration scene
+markdy share scene.markdy                # create compressed playground link
+markdy render scene.markdy --out dist/scene.html # export self-contained HTML preview
+markdy explain scene.markdy              # display AST structure and stats
+markdy new demo.markdy                   # scaffold fresh starter scene
+markdy docs                              # display docs and tutorial links
+markdy ai                                # generate prompt context for LLMs
+markdy check-all . --arch-rules          # batch lint entire workspace
 ```
 
 ## Notes

package/dist/index.js

@@ -1,7 +1,13 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { parse } from "@markdy/core";
+import {
+  parse,
+  validateArchitecture,
+  resolveArchitectureConfig,
+  diffDiagramASTs,
+  compressMarkdyToUrlHash
+} from "@markdy/core";
 import { createRequire } from "module";
 import { basename, dirname, extname, join, resolve, sep } from "path";
 import { fileURLToPath, pathToFileURL } from "url";
@@ -140,6 +146,13 @@ function formatValue(value) {
 var DEFAULT_PORT = 4242;
 var MARKDY_EXT = ".markdy";
 var PACKAGE_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+var compatModulePromise = null;
+function loadCompatModule() {
+  if (!compatModulePromise) {
+    compatModulePromise = import("@markdy/compat");
+  }
+  return compatModulePromise;
+}
 async function runCli(argv, io = defaultIo(), runtime = defaultRuntime()) {
   const parsed = parseArgv(argv);
   if (hasFlag(parsed, "help")) {
@@ -159,6 +172,12 @@ async function runCli(argv, io = defaultIo(), runtime = defaultRuntime()) {
       return renderCommand(parsed, io, runtime);
     case "explain":
       return explainCommand(parsed, io);
+    case "import":
+      return importCommand(parsed, io);
+    case "diff":
+      return diffCommand(parsed, io);
+    case "share":
+      return shareCommand(parsed, io);
     case "new":
       return newCommand(parsed, io);
     case "docs":
@@ -181,14 +200,50 @@ async function lintCommand(parsed, io) {
     return { exitCode: 1 };
   }
   const strict = hasFlag(parsed, "strict");
+  const checkArchRules = hasFlag(parsed, "arch-rules");
+  const configPath = getStringFlag(parsed, "config");
   const cache = /* @__PURE__ */ new Map();
   let warningCount = 0;
   let errorCount = 0;
+  let customRules;
+  if (configPath) {
+    try {
+      const raw = await readFile(resolve(process.cwd(), configPath), "utf-8");
+      const json = JSON.parse(raw);
+      customRules = resolveArchitectureConfig(json);
+    } catch (err) {
+      io.stderr(`markdy lint: failed to read config "${configPath}": ${err.message}`);
+      return { exitCode: 1 };
+    }
+  } else {
+    for (const defaultName of [".markdyrc.json", "markdy.config.json", ".markdyrc"]) {
+      try {
+        const candidate = resolve(process.cwd(), defaultName);
+        const raw = await readFile(candidate, "utf-8");
+        const json = JSON.parse(raw);
+        customRules = resolveArchitectureConfig(json);
+        break;
+      } catch {
+      }
+    }
+  }
   for (const file of files) {
     try {
       const scene = await loadSceneFromFile(file, cache);
       io.stdout(`OK   ${file}`);
       warningCount += printWarnings(scene.ast.diagnostics, file, io);
+      if (checkArchRules || customRules) {
+        const violations = validateArchitecture(scene.ast, customRules);
+        for (const v of violations) {
+          if (v.severity === "error") {
+            errorCount++;
+            io.stderr(`ARCH_FAIL ${file}:${v.line ?? 1} [${v.ruleName}] ${v.message}`);
+          } else {
+            warningCount++;
+            io.stderr(`ARCH_WARN ${file}:${v.line ?? 1} [${v.ruleName}] ${v.message}`);
+          }
+        }
+      }
     } catch (error) {
       errorCount++;
       io.stderr(`FAIL ${file}`);
@@ -310,6 +365,89 @@ async function newCommand(parsed, io) {
   io.stdout(`Created ${resolvedTarget}`);
   return { exitCode: 0 };
 }
+async function importCommand(parsed, io) {
+  const inputFile = parsed.positionals[0];
+  if (!inputFile) {
+    io.stderr("markdy import: expected an input file (e.g. diagram.mmd, docker-compose.yml, manifests.yaml, terraform.tfstate)");
+    return { exitCode: 1 };
+  }
+  const content = await readFile(resolve(inputFile), "utf8").catch((err) => {
+    io.stderr(`markdy import: failed to read ${inputFile}: ${describeError(err)}`);
+    return null;
+  });
+  if (content === null) return { exitCode: 1 };
+  const formatFlag = getStringFlag(parsed, "from")?.toLowerCase();
+  const ext = extname(inputFile).toLowerCase();
+  const title = basename(inputFile, extname(inputFile));
+  const compat = await loadCompatModule().catch((err) => {
+    io.stderr(`markdy import: failed to load @markdy/compat: ${describeError(err)}`);
+    return null;
+  });
+  if (!compat) return { exitCode: 1 };
+  let markdyCode;
+  if (formatFlag === "mermaid" || ext === ".mmd" || ext === ".mermaid") {
+    markdyCode = compat.transpileMermaidToMarkdy(content, title).code;
+  } else if (formatFlag === "compose" || (ext === ".yml" || ext === ".yaml") && (inputFile.includes("compose") || content.includes("services:"))) {
+    markdyCode = compat.transpileDockerComposeToMarkdy(content, title);
+  } else if (formatFlag === "k8s" || content.includes("apiVersion:") && content.includes("kind:")) {
+    markdyCode = compat.transpileKubernetesManifestsToMarkdy(content, title);
+  } else if (formatFlag === "terraform" || ext === ".tfstate" || (content.includes("terraform_version") || content.includes('"resources":'))) {
+    markdyCode = compat.transpileTerraformStateToMarkdy(content, title);
+  } else if (formatFlag === "drawio" || ext === ".drawio" || ext === ".xml" && content.includes("<mxCell")) {
+    markdyCode = compat.transpileDrawioToMarkdy(content, title).code;
+  } else {
+    markdyCode = compat.transpileMermaidToMarkdy(content, title).code;
+  }
+  const outPath = getStringFlag(parsed, "out");
+  if (outPath) {
+    const resolvedOut = resolve(outPath);
+    await writeFile(resolvedOut, markdyCode, "utf8");
+    io.stdout(`Wrote ${resolvedOut}`);
+  } else {
+    io.stdout(markdyCode);
+  }
+  return { exitCode: 0 };
+}
+async function diffCommand(parsed, io) {
+  const file1 = parsed.positionals[0];
+  const file2 = parsed.positionals[1];
+  if (!file1 || !file2) {
+    io.stderr("markdy diff: expected two .markdy files to compare (e.g. markdy diff before.markdy after.markdy)");
+    return { exitCode: 1 };
+  }
+  const scene1 = await loadSceneFromFile(file1).catch((err) => {
+    io.stderr(`markdy diff: ${describeError(err)}`);
+    return null;
+  });
+  const scene2 = await loadSceneFromFile(file2).catch((err) => {
+    io.stderr(`markdy diff: ${describeError(err)}`);
+    return null;
+  });
+  if (!scene1 || !scene2) return { exitCode: 1 };
+  const diffResult = diffDiagramASTs(scene1.ast, scene2.ast);
+  if (hasFlag(parsed, "evolution")) {
+    io.stdout(diffResult.evolutionMarkdyScript);
+    return { exitCode: 0 };
+  }
+  io.stdout(diffResult.summaryMarkdown);
+  return { exitCode: 0 };
+}
+async function shareCommand(parsed, io) {
+  const file = parsed.positionals[0];
+  if (!file) {
+    io.stderr("markdy share: expected a .markdy input file");
+    return { exitCode: 1 };
+  }
+  const scene = await loadSceneFromFile(file).catch((err) => {
+    io.stderr(`markdy share: ${describeError(err)}`);
+    return null;
+  });
+  if (!scene) return { exitCode: 1 };
+  const hash = await compressMarkdyToUrlHash(scene.source);
+  const shareUrl = `https://markdy.com/playground/#code=${hash}`;
+  io.stdout(shareUrl);
+  return { exitCode: 0 };
+}
 async function docsCommand(parsed, io, runtime) {
   const docsUrl = "https://markdy.com";
   const links = [
@@ -692,14 +830,17 @@ function helpText() {
     "",
     "Usage:",
     "  markdy",
-    "  markdy lint <file-or-dir> [--strict]",
+    "  markdy lint <file-or-dir> [--strict] [--arch-rules]",
     "  markdy fmt <file-or-dir> [--write | --check]",
     "  markdy render <file.markdy> [--out file.html] [--port 4242] [--no-open]",
     "  markdy explain <file.markdy> [--json]",
+    "  markdy import <file> [--from compose|k8s|terraform|mermaid] [--out scene.markdy]",
+    "  markdy diff <before.markdy> <after.markdy> [--evolution]",
+    "  markdy share <file.markdy>",
     "  markdy new [target.markdy] [--force]",
     "  markdy docs [--open]",
     "  markdy ai [--open]",
-    "  markdy check-all [dir] [--strict]"
+    "  markdy check-all [dir] [--strict] [--arch-rules]"
   ].join("\n");
 }
 function parseArgv(argv) {
@@ -758,7 +899,7 @@ function parseArgv(argv) {
   return { command, positionals, flags };
 }
 function expectsValue(flag) {
-  return flag === "out" || flag === "port";
+  return flag === "out" || flag === "port" || flag === "config";
 }
 function hasFlag(parsed, name) {
   return parsed.flags.get(name) === true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markdy/cli",
-  "version": "0.8.20",
+  "version": "0.8.22",
   "description": "First-party CLI for diagram-native MarkdyScript diagrams: lint, format, explain, render, and preview.",
   "license": "MIT",
   "type": "module",
@@ -42,9 +42,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@markdy/core": "0.8.20",
-    "@markdy/renderer-dom": "0.8.20",
-    "@markdy/stdlib-systems": "0.8.20"
+    "@markdy/compat": "0.8.22",
+    "@markdy/renderer-dom": "0.8.22",
+    "@markdy/stdlib-systems": "0.8.22",
+    "@markdy/core": "0.8.22"
   },
   "devDependencies": {
     "@types/node": "^25.9.5",