agentic-mermaid 0.1.1 → 0.2.0

package/examples/styles/cupertino-prototype.style.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://agentic-mermaid.dev/schemas/style-spec.schema.json",
+  "formatVersion": 1,
+  "name": "look:cupertino-prototype",
+  "blurb": "Documentation-only Cupertino-inspired prototype exercising public role geometry, shared elevation, and inspect-only constraints; not built in or endorsed.",
+  "colors": {
+    "bg": "#f2f2f7",
+    "fg": "#000000",
+    "line": "#7a7a80",
+    "accent": "#007aff",
+    "muted": "#5f5f64",
+    "surface": "#ffffff",
+    "border": "rgba(60,60,67,0.29)"
+  },
+  "font": "Inter",
+  "stroke": "crisp",
+  "strokeWidth": 1,
+  "intent": "premium",
+  "roles": {
+    "node": {
+      "fontSize": 13,
+      "fontWeight": 600,
+      "paddingX": 24,
+      "paddingY": 12,
+      "cornerRadius": 10,
+      "lineWidth": 1,
+      "fillColor": "#ffffff",
+      "borderColor": "transparent",
+      "textColor": "#000000"
+    },
+    "edge": {
+      "fontSize": 11,
+      "fontWeight": 500,
+      "letterSpacing": 0.07,
+      "lineWidth": 1.5,
+      "bendRadius": 16,
+      "strokeColor": "#7a7a80",
+      "textColor": "#5f5f64"
+    },
+    "group": {
+      "fontSize": 12,
+      "fontWeight": 600,
+      "paddingX": 16,
+      "paddingY": 16,
+      "cornerRadius": 26,
+      "lineWidth": 1,
+      "fillColor": "rgba(120,120,128,0.08)",
+      "headerFillColor": "rgba(120,120,128,0.12)",
+      "borderColor": "transparent",
+      "textColor": "#5f5f64"
+    },
+    "label": {
+      "fontSize": 11,
+      "fontWeight": 500,
+      "letterSpacing": 0.07,
+      "textColor": "#5f5f64"
+    }
+  },
+  "constraints": [
+    { "kind": "contrast", "action": "warn", "minimum": 4.5 },
+    { "kind": "accent-area", "action": "warn", "maxFraction": 0.2 }
+  ]
+}

package/examples/styles/mid-century-report.style.json

@@ -1,6 +1,7 @@
 {
   "$schema": "https://agentic-mermaid.dev/schemas/style-spec.schema.json",
-  "name": "mid-century-report",
+  "formatVersion": 1,
+  "name": "look:mid-century-report",
   "blurb": "Mid-century report palette: cream paper, teal panels, mustard accent, and compact sans labels.",
   "colors": {
     "bg": "#f4ead8",
@@ -14,6 +15,5 @@
   "font": "DejaVu Sans",
   "stroke": "crisp",
   "strokeWidth": 1.6,
-  "fill": "solid",
   "intent": "premium"
 }

package/examples/styles/star-chart-atlas.style.json

@@ -1,6 +1,7 @@
 {
   "$schema": "https://agentic-mermaid.dev/schemas/style-spec.schema.json",
-  "name": "star-chart-atlas",
+  "formatVersion": 1,
+  "name": "look:star-chart-atlas",
   "blurb": "Celestial atlas treatment: dark sky, faint grid, pale-gold labels, and quiet rough linework.",
   "colors": {
     "bg": "#0b1026",

package/examples/styles/transit-route-map.style.json

@@ -1,6 +1,7 @@
 {
   "$schema": "https://agentic-mermaid.dev/schemas/style-spec.schema.json",
-  "name": "transit-route-map",
+  "formatVersion": 1,
+  "name": "look:transit-route-map",
   "blurb": "Transit-map inspired palette: white map stock, red route line, and blue transfer accent.",
   "colors": {
     "bg": "#fbfbf8",
@@ -14,6 +15,5 @@
   "font": "DejaVu Sans",
   "stroke": "crisp",
   "strokeWidth": 4,
-  "fill": "none",
   "intent": "premium"
 }

package/examples/styles/vercel-inspired-prototype.mmd

@@ -0,0 +1,6 @@
+xychart-beta
+  title "Edge delivery"
+  x-axis [Build, Preview, Deploy, Observe]
+  y-axis "Requests" 0 --> 100
+  bar [45, 68, 82, 94]
+  line [40, 62, 80, 91]

package/examples/styles/vercel-inspired-prototype.style.json

@@ -0,0 +1,87 @@
+{
+  "$schema": "https://agentic-mermaid.dev/schemas/style-spec.schema.json",
+  "formatVersion": 1,
+  "name": "look:vercel-inspired-prototype",
+  "blurb": "Documentation-only Vercel-inspired prototype exercising public role styles, semantic XYChart bindings, and inspect-only constraints; not built in or endorsed.",
+  "colors": {
+    "bg": "#0a0a0a",
+    "fg": "#ededed",
+    "line": "#565656",
+    "accent": "#0070f3",
+    "muted": "#a1a1a1",
+    "surface": "#111111",
+    "border": "#2e2e2e"
+  },
+  "font": "Inter",
+  "stroke": "crisp",
+  "strokeWidth": 1,
+  "intent": "premium",
+  "roles": {
+    "node": {
+      "fontSize": 13,
+      "fontWeight": 500,
+      "paddingX": 20,
+      "paddingY": 11,
+      "cornerRadius": 6,
+      "lineWidth": 1,
+      "fillColor": "#111111",
+      "borderColor": "#2e2e2e",
+      "textColor": "#ededed"
+    },
+    "edge": {
+      "fontSize": 11,
+      "fontWeight": 400,
+      "lineWidth": 1,
+      "bendRadius": 8,
+      "strokeColor": "#565656",
+      "textColor": "#a1a1a1"
+    },
+    "group": {
+      "fontSize": 12,
+      "fontWeight": 500,
+      "letterSpacing": 0.1,
+      "paddingX": 16,
+      "paddingY": 16,
+      "cornerRadius": 8,
+      "lineWidth": 1,
+      "fillColor": "rgba(255,255,255,0.04)",
+      "headerFillColor": "rgba(255,255,255,0.06)",
+      "borderColor": "#2e2e2e",
+      "textColor": "#a1a1a1"
+    },
+    "label": {
+      "fontSize": 11,
+      "fontWeight": 400,
+      "textColor": "#a1a1a1"
+    },
+    "bar": {
+      "fillColor": "#2e2e2e",
+      "borderColor": "#565656",
+      "lineWidth": 1
+    },
+    "series": {
+      "strokeColor": "#565656",
+      "lineWidth": 1
+    }
+  },
+  "semanticSlots": {
+    "primary-series": {
+      "fillColor": "#ededed",
+      "borderColor": "#ededed",
+      "strokeColor": "#ededed",
+      "lineWidth": 1
+    },
+    "accent-series": {
+      "strokeColor": "#0070f3",
+      "lineWidth": 2
+    }
+  },
+  "bindings": [
+    { "channel": "category", "value": "bar-0", "slot": "primary-series", "role": "bar" },
+    { "channel": "category", "value": "line-0", "slot": "accent-series", "role": "series" }
+  ],
+  "constraints": [
+    { "kind": "contrast", "action": "warn", "minimum": 4.5 },
+    { "kind": "accent-area", "action": "warn", "maxFraction": 0.28 }
+  ]
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-mermaid",
   "mcpName": "io.github.adewale/agentic-mermaid",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "license": "MIT",
   "description": "Agentic Mermaid: render, verify, and safely edit Mermaid diagrams as ASCII, PNG, SVG, or structured agent workflows — with composable styles (hand-drawn, excalidraw, watercolor, or your own as JSON).",
   "type": "module",
@@ -10,16 +10,19 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "bun": "./src/index.ts",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
     "./agent": {
       "types": "./dist/agent.d.ts",
-      "bun": "./src/agent/index.ts",
       "import": "./dist/agent.js",
       "default": "./dist/agent.js"
     },
+    "./agent/core": {
+      "types": "./dist/agent-core.d.ts",
+      "import": "./dist/agent-core.js",
+      "default": "./dist/agent-core.js"
+    },
     "./style-spec.schema.json": "./docs/schemas/style-spec.schema.json",
     "./package.json": "./package.json"
   },
@@ -29,7 +32,7 @@
     "agentic-mermaid-mcp": "dist/agentic-mermaid-mcp.js"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "publishConfig": {
     "access": "public",
@@ -66,6 +69,9 @@
     "quadrant-chart",
     "gantt-chart",
     "state-diagram",
+    "mindmap",
+    "git-graph",
+    "radar-chart",
     "visualization",
     "theming",
     "styles",
@@ -77,43 +83,47 @@
   ],
   "author": "Adewale",
   "files": [
-    "src/",
     "dist/",
     "assets/fonts/",
     "assets/hero.png",
-    "docs/",
+    "docs/*.md",
+    "docs/schemas/style-spec.schema.json",
     "examples/styles/",
     "skills/",
-    "skill-evals/",
-    "examples/agent-loop.ts",
-    "examples/mcp-vs-cli-complex-diagrams.ts",
-    "examples/agent-improve-auth-flow.ts",
+    "AGENT_NATIVE.md",
     "Instructions_for_agents.md",
     "server.json",
-    "AGENT_NATIVE.md",
     "CHANGELOG.md",
-    "TODO.md",
     "SECURITY.md",
-    "llms.txt",
     "LICENSE",
+    "LICENSES/",
+    "THIRD_PARTY_NOTICES.md",
     "README.md",
-    "!dist/**/*.map",
-    "!src/**/__tests__/**",
-    "!src/**/*.test.ts",
-    "!docs/pr-assets/**"
+    "!dist/**/*.map"
   ],
   "scripts": {
-    "test": "bun test --coverage src/__tests__/",
-    "test:browser": "cd e2e && bun test . --timeout 600000",
+    "test": "bun test --coverage --timeout 30000 src/__tests__/",
+    "typecheck": "bun run typecheck:core && bun run typecheck:repo",
+    "typecheck:core": "tsc --noEmit -p tsconfig.json",
+    "typecheck:repo": "tsc --noEmit -p tsconfig.repo.json",
+    "quality:check": "bun run scripts/ci/quality-gates.ts",
+    "evidence:check": "bun run scripts/ci/quality-gates.ts --evidence-only",
+    "format": "biome format --write .",
+    "format:changed": "biome format --write --changed",
+    "test:browser": "bun run e2e/run-browser-contracts.ts",
     "editor": "bun run scripts/site/editor.ts",
     "dev": "bun run website:dev",
     "bench": "bun run eval/benchmark/sample-bench.ts",
+    "benchmark:palette": "bun run eval/palette-performance/run.ts --record",
+    "benchmark:palette:check": "bun run eval/palette-performance/run.ts --check",
     "harvest:upstream": "bun run eval/mermaid-upstream-suite-bench/harvest.ts",
     "harvest:upstream:refresh-check": "bun run eval/mermaid-upstream-suite-bench/refresh-check.ts",
     "build": "tsup",
     "build:binary": "bun build ./bin/am.ts --compile --outfile dist/am",
     "website": "bun run website/build.ts",
     "website:check": "bun run website/build.ts --check",
+    "website:payload:write": "bun run scripts/site/website-payload-report.ts --write",
+    "website:payload:check": "bun run scripts/site/website-payload-report.ts --check",
     "website:dev": "cd website && WRANGLER_SEND_METRICS=false npx --yes wrangler@latest dev --port 9095 --ip 127.0.0.1",
     "deploy": "bun run website && cd website && WRANGLER_SEND_METRICS=false npx --yes wrangler@latest deploy",
     "prepublishOnly": "npm run build",
@@ -121,55 +131,85 @@
     "goldens:ascii:check": "bun run scripts/update-ascii-goldens.ts --check",
     "hero": "bun run scripts/site/hero.ts",
     "hero:check": "bun run scripts/site/hero.ts --check",
-    "site": "bun run website",
-    "site:check": "bun run website:check",
     "style:audit": "bun test src/__tests__/style-role-audit.test.ts",
     "sketch:check": "bun test scripts/sketch-prototype/styles.test.ts && bun run scripts/sketch-prototype/contrast-audit.ts",
     "characterization:check": "bun run scripts/characterization/contact-sheet.ts --check && bun run scripts/characterization/contact-sheet-families.ts --check && bun run scripts/characterization/visual-quality.ts --check",
-    "mutation-test": "npx stryker run",
-    "mutation-test:incremental": "npx stryker run stryker.incremental.config.json",
-    "mutation-test:characterization": "npx stryker run stryker.characterization.config.json",
-    "mutation-test:ascii": "npx stryker run stryker.ascii.config.json",
-    "mutation-test:families": "npx stryker run stryker.families.config.json",
-    "mutation-test:routes": "npx stryker run stryker.routes.config.json",
-    "mutation-test:routes:certs": "npx stryker run stryker.route-certificates.config.json",
-    "mutation-test:routes:subgraph": "npx stryker run stryker.subgraph-routing.config.json",
-    "mutation-test:links": "npx stryker run stryker.link-grammar.config.json",
-    "mutation-test:state": "npx stryker run stryker.state.config.json",
-    "mutation-test:sequence": "npx stryker run stryker.sequence.config.json",
-    "mutation-test:timeline": "npx stryker run stryker.timeline.config.json",
-    "mutation-test:class": "npx stryker run stryker.class.config.json",
-    "mutation-test:er": "npx stryker run stryker.er.config.json",
-    "mutation-test:journey": "npx stryker run stryker.journey.config.json",
-    "mutation-test:pie": "npx stryker run stryker.pie.config.json",
-    "mutation-test:quadrant": "npx stryker run stryker.quadrant.config.json",
+    "agent-doc-artifacts": "bun run scripts/generate-agent-doc-artifacts.ts",
+    "agent-doc-artifacts:check": "bun run scripts/generate-agent-doc-artifacts.ts --check",
+    "section-a-report": "bun run scripts/generate-section-a-capability-report.ts",
+    "section-a-report:check": "bun run scripts/generate-section-a-capability-report.ts --check",
+    "section-b-report": "bun run scripts/generate-section-b-capability-report.ts",
+    "section-b-report:check": "bun run scripts/generate-section-b-capability-report.ts --check",
+    "render-options-docs": "bun run scripts/generate-render-options-docs.ts",
+    "render-options-docs:check": "bun run scripts/generate-render-options-docs.ts --check",
+    "style-spec-artifacts": "bun run scripts/generate-style-spec-artifacts.ts",
+    "style-spec-artifacts:check": "bun run scripts/generate-style-spec-artifacts.ts --check",
+    "upstream-manifest": "bun run scripts/generate-upstream-mermaid-manifest.ts",
+    "upstream-manifest:check": "bun run scripts/generate-upstream-mermaid-manifest.ts --check",
+    "mutation-test": "bun run scripts/quality/mutation-profile.ts",
     "sabotage:routes": "bun run eval/sabotage/route-regressions.ts",
-    "mutation-test:gantt": "npx stryker run stryker.gantt.config.json",
-    "lint": "bun test src/__tests__/agent-substrate-lint.test.ts src/__tests__/test-quality-lint.test.ts",
+    "test:family-elevation-reverts": "bun run scripts/quality/family-elevation-revert-probes.ts",
+    "lint": "bun run lint:biome && bun run lint:contracts",
+    "lint:biome": "biome lint .",
+    "lint:contracts": "bun test src/__tests__/agent-substrate-lint.test.ts src/__tests__/test-quality-lint.test.ts",
     "eval:agent-live": "bun run eval/agent-usage/live.ts",
     "eval:agent-subagent": "bun run eval/agent-usage/capture-subagent-prompt-eval.ts",
+    "eval:degenerate-routes": "bun run eval/degenerate-etn/enumerate.ts",
     "rubric:visual": "bun run eval/visual-rubric/run.ts",
     "contact:sheet": "bun run eval/visual-rubric/contact-sheet.ts",
+    "contact:sheet:test-portfolio": "bun run scripts/pr-assets/test-portfolio-contact-sheet.ts",
+    "contact:sheet:test-portfolio:review": "bun run scripts/ci/test-portfolio-visual-review.ts",
+    "gallery:custom-styles": "bun run scripts/docs/custom-style-cookbook.ts",
+    "gallery:custom-styles:check": "bun run scripts/docs/custom-style-cookbook.ts --check",
+    "gallery:linkrank-feedback-packing": "bun run scripts/pr-assets/linkrank-feedback-packing-evidence.ts",
+    "gallery:linkrank-feedback-packing:check": "bun run scripts/pr-assets/linkrank-feedback-packing-evidence.ts --check",
+    "gallery:mindmap-gitgraph": "bun run scripts/pr-assets/mindmap-gitgraph-content-gallery.ts",
+    "gallery:mindmap-gitgraph:check": "bun run scripts/pr-assets/mindmap-gitgraph-content-gallery.ts --check",
+    "gallery:mermaid-docs": "bun run scripts/pr-assets/mermaid-doc-showcase-gallery.ts",
+    "gallery:mermaid-docs:check": "bun run scripts/pr-assets/mermaid-doc-showcase-gallery.ts --check",
+    "gallery:style-switch": "bun run scripts/pr-assets/style-switch-contact-sheet.ts",
+    "gallery:style-switch:check": "bun run scripts/pr-assets/style-switch-contact-sheet.ts --check",
+    "gallery:pie-highlight": "bun run scripts/pr-assets/pie-highlightslice-evidence.ts",
+    "gallery:pie-highlight:check": "bun run scripts/pr-assets/pie-highlightslice-evidence.ts --check",
+    "gallery:palette-rollout:baseline": "bun run scripts/pr-assets/palette-rollout-evidence.ts --record-baseline",
+    "gallery:palette-rollout": "bun run scripts/pr-assets/palette-rollout-evidence.ts",
+    "gallery:palette-rollout:check": "bun run scripts/pr-assets/palette-rollout-evidence.ts --check",
+    "gallery:palette-harmony": "bun run scripts/pr-assets/palette-harmony-experiment.ts",
+    "gallery:palette-harmony:check": "bun run scripts/pr-assets/palette-harmony-experiment.ts --check",
+    "gallery:section-b": "bun run scripts/pr-assets/section-b-brand-evidence.ts",
+    "gallery:section-b:check": "bun run scripts/pr-assets/section-b-brand-evidence.ts --check",
     "track": "bun run eval/heuristic-tracker/run.ts",
-    "audit:ugly": "bun run eval/ugly-detector/audit.ts"
+    "audit:ugly": "bun run eval/ugly-detector/audit.ts",
+    "audit:dependencies": "bun audit --audit-level=high"
   },
   "dependencies": {
     "@resvg/resvg-js": "2.6.2",
-    "perfect-freehand": "1.2.3",
-    "roughjs": "4.6.6",
+    "acorn": "8.16.0",
     "elkjs": "^0.11.0",
     "entities": "^7.0.1",
-    "mermaid-ast": "0.8.2",
-    "yaml": "^2.8.2"
+    "yaml": "^2.8.3"
+  },
+  "overrides": {
+    "brace-expansion": "5.0.7",
+    "esbuild": "0.28.1",
+    "fast-uri": "3.1.4",
+    "lodash-es": "4.18.1",
+    "picomatch": "4.0.5",
+    "qs": "6.15.3"
   },
   "devDependencies": {
+    "@biomejs/biome": "2.5.5",
+    "@modelcontextprotocol/sdk": "1.29.0",
     "@resvg/resvg-wasm": "2.6.2",
     "@stryker-mutator/core": "^9.6.1",
     "@types/bun": "^1.3.9",
     "beautiful-mermaid": "1.1.3",
     "fast-check": "^4.6.0",
     "mermaid": "11.16.0",
+    "mermaid-ast": "0.8.2",
     "playwright": "^1.58.2",
+    "perfect-freehand": "1.2.3",
+    "roughjs": "4.6.6",
     "shiki": "^3.19.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",

package/server.json

@@ -7,13 +7,13 @@
     "url": "https://github.com/adewale/agentic-mermaid",
     "source": "github"
   },
-  "version": "0.1.1",
+  "version": "0.2.0",
   "websiteUrl": "https://agentic-mermaid.dev/",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "agentic-mermaid",
-      "version": "0.1.1",
+      "version": "0.2.0",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {

package/skills/agentic-mermaid-diagram-workflow/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: agentic-mermaid-diagram-workflow
-description: Agent-agnostic skill for authoring and editing Mermaid diagrams with structured verification, typed mutation, round-trip serialization, and SVG, PNG, ASCII, Unicode, and JSON layout outputs. Structured mutation for all twelve renderable families (flowchart, state, sequence, timeline, class, ER, journey, architecture, xychart, pie, quadrant, gantt); source-level parse-and-render only for opaque fallbacks (unmodeled syntax).
+description: Agent-agnostic skill for authoring and editing Mermaid diagrams with structured verification, typed mutation, round-trip serialization, and graphical, terminal, and layout outputs. The live capability registry identifies renderable and mutable families; unmodeled syntax remains source-preserved.
 ---
 
 # Agentic Mermaid — diagram workflow
@@ -12,40 +12,20 @@ An agent-agnostic typed editing surface for Mermaid. New diagrams can be authore
 - `agentic-mermaid-mcp` connected → **Code Mode** (`references/code-mode.md`). Multi-step edits in one round-trip.
 - Can run JS/TS with imports → **library** (`agentic-mermaid/agent`). Same SDK.
 - Shell only → **CLI** (`references/cli.md`).
-- No local install, network only → **hosted MCP** at `https://agentic-mermaid.dev/mcp` (stateless streamable HTTP JSON-RPC; the `execute` Code Mode tool plus `render_svg`/`render_ascii`/`render_png`/`verify`/`describe` and the declarative `mutate` (edit a `source`) / `build` (author from a `family`) tools — prefer `mutate`/`build` for structured edits; 64KB input caps).
-
-## Capability matrix
-
-| Family | parse | verify | render | mutate | serialize |
-|---|---|---|---|---|---|
-| Flowchart | ✓ | full (Tier 1+2) | ✓ | 6 ops | structured |
-| **State (modeled subset)** | ✓ | full (Tier 1+2) | ✓ | **8 ops** | structured |
-| State (`<<fork>>`/`<<choice>>`/notes/`--`/`classDef`, unmodeled) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| Sequence (simple) | ✓ | structural | ✓ | 5 ops | structured |
-| Sequence (notes/alt/loop/…) | ✓ | structural | ✓ | **5 ops** | structured-with-segments |
-| Sequence (un-segmentable, e.g. unbalanced `end`) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| Timeline (simple) | ✓ | structural | ✓ | 10 ops | structured |
-| Timeline (unmodeled syntax) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **Class (simple)** | ✓ | structural | ✓ | **10 ops** | structured |
-| Class (unmodeled syntax) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **ER (simple)** | ✓ | structural | ✓ | **7 ops** | structured |
-| ER (unmodeled syntax) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **Journey (simple)** | ✓ | structural | ✓ | **10 ops** | structured |
-| Journey (accTitle/accDescr, unmodeled) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **Architecture (modeled subset)** | ✓ | structural | ✓ | **10 ops** | structured |
-| Architecture (`{group}` boundary, accTitle/accDescr) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **XY chart (modeled subset)** | ✓ | structural | ✓ | **8 ops** | structured |
-| XY chart (quoted text, `;` lines, accTitle/accDescr) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **Pie (simple)** | ✓ | structural | ✓ | **7 ops** | structured |
-| Pie (accTitle/accDescr, malformed entries) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **Quadrant (modeled subset)** | ✓ | structural | ✓ | **7 ops** | structured |
-| Quadrant (styling `classDef`/`:::`, out-of-range coords) | ✓ | structural | ✓ | — (opaque) | verbatim |
-| **Gantt (modeled subset)** | ✓ | structural + schedule | ✓ | **9 ops** | structured-with-segments |
-| Gantt (duplicate ids / unclosed `accDescr`) | ✓ | structural | ✓ | — (opaque) | verbatim |
+- No local install, network only → **hosted MCP** at `https://agentic-mermaid.dev/mcp` (stateless streamable HTTP JSON-RPC; `execute` Code Mode, `describe_sdk` for one family's mutation schema on demand, `render_svg`/`render_ascii`/`render_png`/`verify`/`describe`, and the declarative `mutate` (edit a `source`) / `build` (author from a `family`) tools — prefer `mutate`/`build` for structured edits; 64KB input caps).
+
+## Capability discovery
+
+Run `am capabilities --json` (or call the equivalent SDK capability API) before
+choosing a family or mutation. Its registry-derived family entries expose the
+current narrower, operation schema, edit policy, output support, and minimal
+source example; the generated Section A matrix supplies explicit native,
+source-preserved, diagnosed, and absent states. This skill intentionally does
+not maintain a second family or operation table.
 
 Any diagram with constructs we don't model falls back to an **opaque** body: it still parses, renders, verifies, and round-trips losslessly — it just isn't offered for structured mutation (the narrower returns null). The parser never silently drops anything.
 
-State diagrams own a dedicated body (BUILD-19): narrow them with `asState` and apply state-shaped ops (`add_state`, `remove_state`, `rename_state`, `set_state_label`, `add_transition`, `remove_transition`, `set_transition_label`, `make_composite`). `asFlowchart` returns null on a state diagram. The modeled subset is simple states, transitions, `[*]` start/end pseudostates, composite blocks, and `direction`; anything else (`<<fork>>`/`<<choice>>`/`<<join>>`, history states, concurrency `--`, notes, `classDef`/`class`/`:::` styling) keeps the whole body opaque and round-trips verbatim.
+State diagrams own a dedicated body: `asState` models states/transitions, `[*]`, composites, stereotypes/history, concurrency regions, notes, bare declarations, and class/inline paint. `asFlowchart` returns null on a state diagram.
 
 Gantt diagrams are segment-preserving: `asGantt` keeps title/section/task ops live while calendar directives (`dateFormat`, `axisFormat`, `excludes`, `includes`, `weekend`, `weekday`, `todayMarker`, `tickInterval`, `inclusiveEndDates`, `topAxis`), `click` lines, comments, and accessibility lines ride along verbatim. Gantt rendering is deterministic and never reads the wall clock; pass `ganttToday` when rendering if a `todayMarker` should be visible.
 
@@ -53,10 +33,11 @@ Gantt diagrams are segment-preserving: `asGantt` keeps title/section/task ops li
 
 ## Workflow
 
-For new diagrams, author Mermaid source directly, then `parseMermaid` / `verifyMermaid` / render. For existing modeled diagrams:
+For new diagrams, author Mermaid source directly, then `parseRegisteredMermaid` / `verifyMermaid` / render. For existing modeled diagrams:
 
-1. `parseMermaid(source)` → `ValidDiagram`.
-2. `asFlowchart(d)` / `asState(d)` / `asSequence(d)` / `asTimeline(d)` / `asClass(d)` / `asEr(d)` / `asJourney(d)` / `asArchitecture(d)` / `asXyChart(d)` / `asPie(d)` / `asQuadrant(d)` / `asGantt(d)` to narrow before mutating.
+1. `parseRegisteredMermaid(source)` → `ValidDiagram`.
+2. Use the family entry's advertised narrower (for example `asFlowchart(d)` or
+   `asState(d)`) before mutating.
 3. `mutate(d, op)` (typed per family).
 4. `verifyMermaid(d)` — structured warnings; inspect `ok` / `warnings` / `layout`.
 5. On `!ok`, revert to the previous `ValidDiagram`, try another op.
@@ -67,7 +48,7 @@ Do not regenerate or concatenate source to edit an existing structured diagram w
 Minimal existing-flowchart pattern:
 
 ```ts
-const parsed = parseMermaid(source)
+const parsed = parseRegisteredMermaid(source)
 if (!parsed.ok) return { phase: 'parse', errors: parsed.error }
 let cur = asFlowchart(parsed.value)
 if (!cur) return { phase: 'narrow', family: parsed.value.kind }

package/skills/agentic-mermaid-diagram-workflow/references/cli.md

@@ -3,7 +3,7 @@
 Agentic Mermaid outputs SVG, PNG, ASCII, Unicode, and JSON layout through the CLI.
 
 ```text
-am render <file|-> --format svg|ascii|unicode|json
+am render <file|-> --format svg|ascii|unicode|layout
 am render <file> --format png --output file.png  # one-shot only; no watch/multi-input
 am preview <file|-> [--output preview.html] [--open] [--json] [--security strict]  # strict standalone HTML
 am verify <file|->            structured JSON warnings (exit 3 if not ok)
@@ -22,10 +22,9 @@ am --agent-instructions       canonical agent guide
 am <cmd> --help               per-command help
 ```
 
-`am verify` always emits JSON. `am mutate` dispatches by family across
-flowchart, state, sequence, timeline, class, ER, journey, architecture,
-xychart, pie, quadrant, and gantt; opaque fallback bodies return a structured
-`UNSUPPORTED_FAMILY` error. `am mutate` verifies before emitting source; verify
+`am verify` always emits JSON. `am mutate` dispatches across the live mutable
+family roster reported by `am capabilities --json`; opaque fallback bodies
+return a structured `UNSUPPORTED_FAMILY` error. `am mutate` verifies before emitting source; verify
 failure exits 3 and omits `source`. Use direct Mermaid source authoring plus
 `am verify`/`am render` for brand-new diagrams; reserve `am mutate` for
 existing structured diagrams. `am parse | am serialize` round-trips through JSON.