@diagrammo/dgmo 0.8.4 → 0.8.6

package/.claude/commands/dgmo.md

@@ -98,6 +98,7 @@ For **examples** of real diagrams, call `mcp__dgmo__get_examples("<type>")` —
    - "states" / "lifecycle" / "transitions" → `state`
    - "org" / "team" / "hierarchy" → `org`
    - "roadmap" / "project status" → `initiative-status` or `gantt`
+   - "boxes" / "nodes and edges" / "general diagram" → `boxes-and-lines`
    - "compare" / "metrics" / "data" → `bar`, `line`, `pie`, etc.
    - If genuinely ambiguous, suggest your best guess with a one-line rationale.
 2. **Get syntax + examples** — call `mcp__dgmo__get_language_reference("<type>")` and `mcp__dgmo__get_examples("<type>")`.
@@ -257,6 +258,7 @@ Key options:
 | `sitemap` | Website / app navigation structure |
 | `infra` | Infrastructure traffic flow with rps computation |
 | `gantt` | Project scheduling with dependencies |
+| `boxes-and-lines` | General-purpose node-edge diagrams with groups and tags |
 
 ## Key Syntax Patterns
 
@@ -379,6 +381,304 @@ API
   latency-ms 45
 ```
 
+### slope
+
+```
+slope Fleet Strength
+
+period 1715 1725
+
+Blackbeard 40 4
+Roberts 12 52
+Anne Bonny (red) 8 15
+```
+
+- `period` directive required before data rows (one-line or indented block for multi-token labels)
+- Data rows: `Label value1 value2` — space-separated, no colons
+- Right-scan: parser takes numeric values from the right, everything left is the label
+- Color annotations: `Label (color) value1 value2`
+
+### timeline
+
+```
+timeline Product Roadmap
+sort tag:Team
+
+tag Team alias t
+  Engineering(blue)
+  Design(purple)
+
+era 2024-01 -> 2024-06 Phase 1
+marker 2024-03 Beta Launch
+
+2024-01->2024-03 Core API | t: Engineering
+2024-02->2024-05 UX Research | t: Design
+2024-06 GA Release | t: Engineering
+```
+
+- Dates: `YYYY`, `YYYY-MM`, `YYYY-MM-DD`. Ranges: `start->end`. Durations: `start->6m`, `->2w`, `->30d`
+- Uncertain end: `2024-03?`. Point events: single date, no range
+- `era start -> end Label` — background band. `marker date Label` — vertical line
+- `## Group(color)` headers for manual grouping, or `tag` + `sort tag:Name` for swimlanes
+- Pipe metadata: `| tagalias: Value`
+
+### gantt
+
+```
+gantt Sprint Plan
+start 2024-01-15
+today-marker 2024-03-01
+critical-path
+dependencies
+
+10bd Design | 80%
+parallel
+  [Backend]
+    15bd API Layer
+    5bd? Auth Module
+      -> Frontend.Integration | offset: -3bd
+  [Frontend]
+    10bd Components
+    5bd Integration
+5bd QA Testing
+0d Release
+```
+
+- `start YYYY-MM-DD` — project start date (required)
+- Duration: `10bd Task Name` (business days). Uncertain: `5bd?`. Milestone: `0d`
+- `parallel` block for concurrent tracks. `[Group]` for named sections
+- Progress: `| 80%` or trailing `80%`
+- Dependencies: `-> Target.Task` or `-blocks-> Target.Task`. `offset: -3bd` for overlap
+- `today-marker`, `critical-path`, `dependencies` — top-level directives
+- Tags + eras + markers same as timeline
+
+### c4
+
+```
+c4 Banking System
+
+Customer is a person
+  description: A customer of the bank
+
+Banking is a system
+  description: Online banking portal
+  containers
+    WebApp is a container | tech: React
+    API is a container | tech: Node.js
+    DB is a container is a database | tech: PostgreSQL
+
+Email is a system
+  description: External email service
+
+Customer -Uses-> Banking
+Banking -Sends emails [SMTP]-> Email
+```
+
+- Elements: `Name is a person|system|container|component`
+- Metadata (pipe-delimited): `| description: text, tech: stack`
+- Indented `description:` also works (no pipe needed)
+- Sections: `containers` (inside system), `components` (inside container), `deployment`
+- Deployment: `NodeName is a cloud|database|cache|queue`
+- Arrows: sync `-label [tech]->`, async `~label [tech]~>`, bidirectional `<->`, `<~>`
+
+### class
+
+```
+class Type Hierarchy
+
+Drawable [interface]
+  + draw(): void
+
+Shape implements Drawable [abstract]
+  # x: number
+  + area(): number
+  count: number {static}
+
+Circle extends Shape
+  - radius: number
+
+Color [enum]
+  Red
+  Green
+  Blue
+
+Canvas
+  *-- Shape : contains
+  ..> Logger : uses
+```
+
+- Modifiers: `[abstract]`, `[interface]`, `[enum]`
+- Inheritance: `Child extends Parent`, `Child implements Interface`
+- Visibility: `+` public, `#` protected, `-` private. Static: `{static}`
+- Relationships: `A *-- B` (composition), `A o-- B` (aggregation), `A --|> B` (inheritance), `A ..|> B` (implementation), `A ..> B` (dependency), `A -> B` (association)
+- Optional label: `A *-- B : description`
+
+### initiative-status
+
+```
+initiative-status Q2 Roadmap
+
+[Identity]
+  Auth Service | done
+  SSO Integration | doing
+    -> Auth Service | done
+  MFA Rollout | blocked
+    -> SSO Integration | doing
+
+[Payments]
+  Payment Gateway | doing
+  Billing UI | todo
+    -> Payment Gateway | doing
+
+Auth Service -> Payment Gateway: validates | done
+```
+
+- Status values: `done`, `doing`, `todo`, `blocked`, `na`
+- Dependencies: `-> Target | status` (indented) or `Source -> Target: label | status`
+- Groups: `[Group Name]` with indented items
+- Tags supported for phase/team coloring
+
+### venn
+
+```
+venn Full-Stack Skills
+
+Frontend(blue) alias fe
+Backend(green) alias be
+DevOps(orange) alias de
+
+fe + be Web Systems
+be + de Platform Ops
+fe + be + de Full Stack
+```
+
+- Sets: `Name(color) alias id` — declares a circle
+- Overlaps: `id + id Label` — names the intersection region
+- Option: `values on` to show sizes. Sized form: `id(color): 120 "Label"`
+
+### quadrant
+
+```
+quadrant Feature Priorities
+
+x-label Low Effort, High Effort
+y-label Low Impact, High Impact
+
+top-left Quick Wins(green)
+top-right Major Projects
+bottom-left Fill-ins
+bottom-right Avoid(red)
+
+Dark Mode (blue) 0.25, 0.85
+API v2 0.8, 0.9
+Fix Typos 0.1, 0.15
+```
+
+- Axis labels: `x-label Low, High` and `y-label Low, High`
+- Quadrant labels: `top-left`, `top-right`, `bottom-left`, `bottom-right`
+- Data: `Label (color) x, y` where x,y are 0–1
+
+### sankey / chord
+
+```
+// sankey — flow diagram
+sankey Budget Allocation
+
+Revenue (green)
+  Costs: 600
+  Profit (blue): 400
+
+// arrow syntax also works
+Revenue -> Marketing: 200
+
+// chord — same syntax, circular layout
+chord Team Collaboration
+Engineering -> Design 85
+Design -> Product 68
+```
+
+- Indented syntax: parent → child with `Target: weight`
+- Arrow syntax: `Source -> Target: weight` (sankey) or `Source -> Target weight` (chord)
+- Node colors: `Name (color)`. Link colors: `Target: 600 (red)`
+
+### state
+
+```
+state Order Lifecycle
+direction LR
+
+[*] -> Pending -submit-> Validating
+
+Validating
+  -approved-> Processing
+  -rejected-> Cancelled(red)
+
+## Fulfillment(blue)
+  Processing -ship-> Shipped
+  Shipped -delivered-> Done
+
+Cancelled -> [*]
+Done -> [*]
+```
+
+- `[*]` — start/end pseudostate (filled circle)
+- Transitions: `A -> B`, `A -label-> B`, `A -(color)-> B`
+- Chains: `A -> B -> C` on one line
+- Indented transitions use parent as source
+- Groups: `## GroupName(color)` with indented states
+- Options: `direction LR` (left-right) or `TB` (top-bottom, default)
+
+### scatter
+
+```
+scatter Funding vs Revenue
+x-label Funding ($M)
+y-label Revenue ($M)
+
+[SaaS](blue)
+  Acme 12, 8.5
+  DataSync 5.2, 3.1
+
+[Fintech](green)
+  PayFlow 45, 32
+  LendTech 18, 12.5
+```
+
+- Data: `Label x, y` or `Label x, y, size` (bubble chart)
+- Groups: `[Category](color)` headers
+- Options: `labels on`, `xlabel`, `ylabel`, `sizelabel`
+
+### boxes-and-lines
+
+```
+boxes-and-lines Architecture
+
+tag Team t Backend(blue), Frontend(green), Platform(purple)
+active-tag Team
+direction LR
+
+API Gateway | t: Backend
+  -routes-> AuthService
+  -queries-> DB
+
+AuthService | t: Backend
+DB | t: Platform
+
+[Cloud]
+  API Gateway
+  AuthService
+
+Redis <-syncs-> DB | t: Platform
+```
+
+- Nodes: explicit `Name | metadata` or implicit from edges
+- Edges: `A -label-> B` (directed), `A <-label-> B` (bidirectional)
+- Indented edges use parent as source: `Parent` then `  -label-> Target`
+- Groups: `[Name]` with indented children (max 2 levels deep)
+- Tags: `tag Name alias Value1(color), Value2(color)` + `active-tag Name` + `hide alias:value`
+- Options: `direction LR` (left-right) or `TB` (top-bottom, default)
+- Shape inference: names containing DB/database → cylinder, Cache/Redis → diamond, Queue → hexagon, etc.
+
 ## Anti-Patterns
 
 ```

package/.cursorrules

@@ -103,9 +103,27 @@ API
 
 Properties: `cache-hit`, `firewall-block`, `ratelimit-rps`, `max-rps`, `instances` (N or N-M), `latency-ms`, `cb-error-threshold`. Groups: `[Name]` with children. Roles are inferred from behavior.
 
-## All 32 chart types
+### Boxes and lines
+```
+boxes-and-lines Architecture
+tag Team t Backend(blue), Frontend(green)
+active-tag Team
+direction LR
+
+API Gateway | t: Backend
+  -routes-> AuthService
+  -queries-> DB
+
+[Cloud]
+  API Gateway
+  AuthService
+```
+
+Nodes: implicit from edges or explicit with `| metadata`. Edges: `A -label-> B`, `A <-label-> B` (bidi). Groups: `[Name]` with indented children (max 2 levels). Tags: `tag Name alias values`, `active-tag`, `hide`. Options: `direction LR|TB`.
+
+## All 34 chart types
 
-bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt
+bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt, boxes-and-lines
 
 ## Common patterns
 

package/.github/copilot-instructions.md

@@ -107,9 +107,27 @@ API
 
 Properties: `cache-hit`, `firewall-block`, `ratelimit-rps`, `max-rps`, `instances` (N or N-M), `latency-ms`, `cb-error-threshold`. Groups: `[Name]` with children. Roles are inferred from behavior.
 
-## All 32 chart types
+### Boxes and lines
+```
+boxes-and-lines Architecture
+tag Team t Backend(blue), Frontend(green)
+active-tag Team
+direction LR
+
+API Gateway | t: Backend
+  -routes-> AuthService
+  -queries-> DB
+
+[Cloud]
+  API Gateway
+  AuthService
+```
+
+Nodes: implicit from edges or explicit with `| metadata`. Edges: `A -label-> B`, `A <-label-> B` (bidi). Groups: `[Name]` with indented children (max 2 levels). Tags: `tag Name alias values`, `active-tag`, `hide`. Options: `direction LR|TB`.
+
+## All 34 chart types
 
-bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt
+bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt, boxes-and-lines
 
 ## Common patterns
 

package/.windsurfrules

@@ -103,9 +103,27 @@ API
 
 Properties: `cache-hit`, `firewall-block`, `ratelimit-rps`, `max-rps`, `instances` (N or N-M), `latency-ms`, `cb-error-threshold`. Groups: `[Name]` with children. Roles are inferred from behavior.
 
-## All 32 chart types
+### Boxes and lines
+```
+boxes-and-lines Architecture
+tag Team t Backend(blue), Frontend(green)
+active-tag Team
+direction LR
+
+API Gateway | t: Backend
+  -routes-> AuthService
+  -queries-> DB
+
+[Cloud]
+  API Gateway
+  AuthService
+```
+
+Nodes: implicit from edges or explicit with `| metadata`. Edges: `A -label-> B`, `A <-label-> B` (bidi). Groups: `[Name]` with indented children (max 2 levels). Tags: `tag Name alias values`, `active-tag`, `hide`. Options: `direction LR|TB`.
+
+## All 34 chart types
 
-bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt
+bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt, boxes-and-lines
 
 ## Common patterns
 

package/AGENTS.md

@@ -19,7 +19,7 @@ When the `dgmo` MCP server is configured, use these tools directly:
 - `render_diagram` — renders to PNG or SVG, returns file path
 - `share_diagram` — creates a shareable diagrammo.app URL
 - `open_in_app` — opens diagram in Diagrammo desktop app (macOS)
-- `list_chart_types` — lists all 32 supported chart types with descriptions
+- `list_chart_types` — lists all 34 supported chart types with descriptions
 - `get_language_reference` — fetches full syntax for any chart type (call this before generating an unfamiliar chart type)
 - `generate_report` — renders multiple diagrams into an HTML report with table of contents
 
@@ -113,9 +113,29 @@ API
   latency-ms: 45
 ```
 
-## All 32 chart types
+## All 34 chart types
 
-bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra
+bar, line, multi-line, area, pie, doughnut, radar, polar-area, bar-stacked, scatter, sankey, chord, function, heatmap, funnel, slope, wordcloud, arc, timeline, venn, quadrant, sequence, flowchart, state, class, er, org, kanban, c4, initiative-status, sitemap, infra, gantt, boxes-and-lines
+
+### Boxes and lines
+```
+boxes-and-lines Architecture
+
+tag Team t Backend(blue), Frontend(green)
+active-tag Team
+direction LR
+
+API Gateway | t: Backend
+  -routes-> AuthService
+  -queries-> DB
+
+AuthService | t: Backend
+DB | t: Backend
+
+[Cloud]
+  API Gateway
+  AuthService
+```
 
 ## Common patterns