Skip to content

Releases

Context-Heavy Diagrams 0.12.0

Pre-release

Choose a tag to compare

@github-actions github-actions released this 18 Nov 22:31
c3fffa5

Added

  • Icon packs. Install a set of icons (a cloud vendor's, your company's) once per machine with View → Icon packs, then pick from it in any diagram. A pack is a folder of SVG files; the app ships none of its own besides Tabler. The picker has a section per pack and subset, with search. Icons follow the text colour in both themes, and colours a pack fixes are kept. A diagram that uses a pack this machine lacks says which one, and what to do about it, in the Diagnostics panel. The SVG, PNG and draw.io exports draw them. The format of a pack is in docs/icon-packs.md. (ADR 0188)
  • Tabler is an installable pack. The app asks on the first start whether to install it, and the manager can do it later. Existing diagrams that use the built-in icons are unchanged.
  • An icon added one at a time goes into the pack Misc icons. Adding an icon from the picker, the legend or when relinking a missing one no longer copies it into the diagram's assets folder; it is kept once per machine. Existing diagrams with icons in assets still show them.

File format

  • A new icon source, "installed" (pack and path), and a top-level iconPacks list the application writes on save, documented in docs/file-format.md. A version without them draws no icon there.

Changed

  • Edge points move with the elements. When both ends of an edge move by the same amount, as when a container is dragged, a selection is moved, nudged or aligned, or an assistant moves a container, the edge's bend points move too, so a loop drawn round an element stays round it. An edge with only one end moved keeps its points, unless Ctrl (Cmd) is held as the drag starts: then the points nearer the dragged element than the other end come along. Nothing in the file changes. (ADR 0189, ADR 0190)
  • Right-angled edges: every segment can be dragged, and no more spikes. A step or smooth step edge now has a handle on each straight segment, including the ones next to its two elements. Drag the line of a straight edge and it leaves each element by a short stub and runs along where you drag it, so a connection between two facing elements goes round both in one drag. A single point no longer makes the route go up and straight back down; the edge leaves and arrives by the side it is attached to. A point added with Add point here now lies on the line, and right-clicking close to a point offers Remove point. Right-click an edge for Reset route, which removes its points and the label's slide along it. Nothing in the file changes; an edge whose route used to run back into its own element is drawn differently. (ADR 0191)
  • The command-line export (chd export) draws the Tabler icons but leaves out icons from other installed packs, with a note.

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.

Linux and macOS

A Linux AppImage and deb and a macOS DMG are attached when their builds succeed. They have not been tested on real hardware: CI checks that the program is built and that chd --version runs, and nothing more. Please report what you find. The macOS app is not notarised: open it with right-click, Open, or under System Settings, Privacy & Security, Open Anyway. Their SHA-256 are in SHA256SUMS-linux and SHA256SUMS-macos.

Source code

This installer is built from the source at https://github.com/NoobsDeSroobs/context-heavy-diagrams/tree/v0.12.0 (GPL-3.0-or-later). The licence and the third-party notices are installed next to the program, as LICENSE.txt and THIRD-PARTY-NOTICES.md.

Context-Heavy Diagrams 0.11.1

Pre-release

Choose a tag to compare

@github-actions github-actions released this 17 Nov 17:54
45f5deb

Fixed

  • A connection point that was drawn but could not be connected, and edges lost when points were removed. Raising the number of points on a side of a diagram that was opened again could give the new point the id of one it already had, so one of the two could not be used, and the edge went to the other. Lowering the number to one moved the edges of the point that was removed next to a point that was removed too, and they were lost. A new point now has an id nobody else on the element has, and every edge goes to a point that is left. A diagram already saved with two points of one id keeps them.

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.

Linux and macOS

A Linux AppImage and deb and a macOS DMG are attached when their builds succeed. They have not been tested on real hardware: CI checks that the program is built and that chd --version runs, and nothing more. Please report what you find. The macOS app is not notarised: open it with right-click, Open, or under System Settings, Privacy & Security, Open Anyway. Their SHA-256 are in SHA256SUMS-linux and SHA256SUMS-macos.

Source code

This installer is built from the source at https://github.com/NoobsDeSroobs/context-heavy-diagrams/tree/v0.11.1 (GPL-3.0-or-later). The licence and the third-party notices are installed next to the program, as LICENSE.txt and THIRD-PARTY-NOTICES.md.

Context-Heavy Diagrams 0.10.0

Pre-release

Choose a tag to compare

@github-actions github-actions released this 15 Nov 20:55
80454a9

Added

  • Edges that attach by themselves. Drop a connection on the dashed target that appears in the middle of an element, or right-click an edge and choose Attach automatically, and that end of the edge picks the side of its element that faces the other one, and a point on it, and follows as you move the elements. Fix to current points makes it fixed again; an edge dropped on a point stays where it is. An edge with no connection point saved in the file now attaches this way too, where it used to leave by the top. Assistants can use "auto" as a handle in connect and set_edge_handles. (ADR 0178)
  • File → Show in Folder shows the open diagram's file in the system's file manager (Explorer, Finder, or the desktop's own on Linux).

Changed

  • Connection points slide a little to straighten edges. Where two facing elements are almost in line, each end of the edge between them moves up to 10 px along its side so the edge runs straight; further out of line, the edge bends as before. Nothing is stored, so a person's and an assistant's diagram behave alike. (ADR 0176)
  • Assistants can route edges. A new route_edges operation (in edit_diagram and chd edit) gives edges a right-angled route through the free space round the elements they do not join, with a lane of their own where there is room; without ids it takes the edges the layout check reports. It also puts each routed edge on a connection point of its own on the side facing its other end, in order along the side and evenly spaced as in the app (connectionPoints: "keep" leaves them), and places no element. (ADR 0174, ADR 0177)
  • An assistant's connection points look like yours. add_connection_point now spreads a side's points evenly, as the app does; its offset only says where in the order the new point goes. (ADR 0175)
  • set_edge_handles moves an edge to another connection point of the same two elements, keeping its id, label, tags and style (edit_diagram, chd edit).
  • An assistant that builds with edit_diagram reads less and is told less. A one-page build topic (get_format_spec, chd spec build) replaces the core rules and three references (about 78 KB) for that way of working, an edit answers with the layout problems that involve what it touched and a count of the rest, answers carry new ids and changed fields instead of the whole element, and inspect_diagram (chd ask inspect) takes issues_only, ids and container. The server also says which build it is. (ADR 0171, ADR 0172)
  • The layout check flags an edge label on a container's wall (including one squeezed outside a container that has room) and one that covers a container's own title, and list_files says when folders below its depth limit were left out. (ADR 0161)
  • The Claude Desktop extension leaves out what a repository's .gitignore names (build output, dependencies) when it lists and searches files, and says which folders it left out; list_files answers with 100 files a page and no modified time. (ADR 0173)

File format

  • No new field. An edge end with no connection point named is now drawn on the side facing the other element, where it was drawn at the first point (the top); the rule is in docs/file-format.md. Files from 0.9.0 open as before, and a file made here opens in 0.9.0 with those ends at the top.

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.

Linux and macOS

A Linux AppImage and deb and a macOS DMG are attached when their builds succeed. They have not been tested on real hardware: CI checks that the program is built and that chd --version runs, and nothing more. Please report what you find. The macOS app is not notarised: open it with right-click, Open, or under System Settings, Privacy & Security, Open Anyway. Their SHA-256 are in SHA256SUMS-linux and SHA256SUMS-macos.

Source code

This installer is built from the source at https://github.com/NoobsDeSroobs/context-heavy-diagrams/tree/v0.10.0 (GPL-3.0-or-later). The licence and the third-party notices are installed next to the program, as LICENSE.txt and THIRD-PARTY-NOTICES.md.

Context-Heavy Diagrams 0.9.0

Pre-release

Choose a tag to compare

@github-actions github-actions released this 10 Nov 10:07
ca87247

Added

  • Create many elements from a pasted table. Right-click the Entity or Container button and paste a table with a header row, copied from a spreadsheet or comma-separated. The column named Name is the label, Description becomes the note (a file each, written on save), Domain, Group or Container names the group (kept as a tag for now, elements are not put into containers yet), and every other column becomes a tag. Rows with the same name merge into one element; a preview shows what each column will be and lets you change it. A value a required tag does not allow is left at its default and listed. A paste of one label per line works as before. (ADR 0168)

  • Export to draw.io. File → Export → draw.io… and chd export --format drawio (or an output ending in .drawio) write a diagram as a draw.io / diagrams.net file, so it can be opened and edited there. Containers and what is inside them, connections with their attachment points and waypoints, labels, colours, fonts, arrowheads (crow's feet included), icons and tags (as draw.io data) come across. What draw.io has no place for or can only approximate (the legend, notes, the threat matrix, the exact path of a curved or stepped connection) is listed after the export, so nothing is lost silently. It is a one-way copy: edits made in draw.io do not come back. (ADR 0167)

  • Slide a connection's label along its line by holding Alt and dragging the label. It follows the line round bends and curves, and the Position slider in the Label section of the properties panel shows the result. One undo step per drag. (ADR 0164)

  • A highlight can have no colour, to leave an element out. Press ∅ beside a highlight's colour (or give an assistant's set_highlight the colour transparent) and elements with that value, typically N/A, keep their own look when the highlight is switched on, so a system boundary no longer takes the colour of the entities inside it. It has no legend row. An older version of the app draws such an element's border invisible. (ADR 0163)

  • Linux and macOS downloads: each release now also carries a Linux AppImage and deb and a macOS DMG (Apple Silicon and Intel). They have not been tested on real hardware, are labelled so, and the macOS app is not notarised. Reports are welcome. (ADR 0166)

Changed

  • The licence and the third-party notices are installed next to the program (LICENSE.txt, THIRD-PARTY-NOTICES.md; in the app's Resources folder on macOS), and a release's notes link to the source it was built from. The release is now checked by installing the installer silently and running chd --version before it is published. (ADR 0165)

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.

Linux and macOS

A Linux AppImage and deb and a macOS DMG are attached when their builds succeed. They have not been tested on real hardware: CI checks that the program is built and that chd --version runs, and nothing more. Please report what you find. The macOS app is not notarised: open it with right-click, Open, or under System Settings, Privacy & Security, Open Anyway. Their SHA-256 are in SHA256SUMS-linux and SHA256SUMS-macos.

Source code

This installer is built from the source at https://github.com/NoobsDeSroobs/context-heavy-diagrams/tree/v0.9.0 (GPL-3.0-or-later). The licence and the third-party notices are installed next to the program, as LICENSE.txt and THIRD-PARTY-NOTICES.md.

Context-Heavy Diagrams 0.8.0

Pre-release

Choose a tag to compare

@github-actions github-actions released this 09 Nov 08:19
47585ab

Added

  • The Windows installer can put chd on your PATH. A new checkbox on its options page, Add the chd command to your PATH (unticked by default), adds the app's bin folder to your user PATH so chd works by name in a new terminal; uninstalling takes exactly that entry out again, and a PATH it cannot read safely is left alone. (ADR 0162)
  • An assistant is told when an edge is drawn across an element, when edges cross, and when an edge label sits on an element, another edge or another label. The answers of edit_diagram, inspect_diagram, chd edit and chd ask inspect judge each edge on the path that is drawn (curves, bend points and routing style included, not a straight line), so an assistant that cannot look at its diagram can still find and fix these. (ADR 0161)
  • Save As asks what to copy. It opens a dialog with a path (set by the system's save picker) and three switches: Notes, Images and custom icons, and Linked diagrams, recursively, with the same settings, each with how many files it covers. What is ticked is copied into a folder named after the new diagram (Copy.chd and Copy/); what is not ticked, and anything that cannot be copied (missing, or outside the diagram's folder), is removed from the copy and listed, and the original is never changed. Linked diagrams keep their place relative to the original and are each copied once, with their own notes and images. The name and the folder must both be free, so nothing is ever replaced. (ADR 0160)
  • One notice when files change outside the app. If the diagram or a note you have open or edited was changed by another editor, git or an assistant, a single notice lists the files, says which of them you have unsaved edits to, and offers Review changes, Reload (only those files, asking first if edits would be lost) and Ignore. Before, the diagram and the open note had separate notices, and an unedited open note was refreshed without saying so. (ADR 0159)
  • Unsaved note text is no longer lost when its element is deleted. It is kept and listed in Diagnostics (and counted in the View menu), with Copy text and Discard; undoing the deletion brings it back.
  • The side panels can be made wider or narrower. Drag the left edge of the panel on the right (notes, diagnostics, changes, layers, preferences), use the arrow keys on it, or double-click it for the default width; the width is kept for next time and is the same for every panel. The list in the review window has the same handle (its width lasts while that window is open). (ADR 0158)
  • The minimap can be hidden. A small button on its corner and View → Minimap switch it off and on, and the choice is kept. (ADR 0158)
  • Help → Glossary… explains the terms the app uses (diagram metamodel, edge direction set, notes, layers, the three kinds of settings and more), with a filter box. It is written once, in docs/architecture/glossary.md, and the app shows the plain part of each term. (ADR 0157)
  • The MCP server can be used from any app that supports MCP servers, not only Claude Desktop, and on Linux too. AI → Install the MCP server for → Other apps: copy server settings… asks for a folder and whether existing files may be changed (off by default), and copies the settings to paste into the app. The server is also started by the new chd mcp <folder>. Claude Desktop keeps its one-click install under the same submenu. (ADR 0110, ADR 0138)
  • The size of the Ctrl-hover card can be set under Preferences: its width and the height beyond which it is trimmed (it was fixed at 340 by 260 pixels, which is still the default). A longer note shows more of its text on a bigger card. (ADR 0156)
  • Holding Ctrl (Cmd on a Mac) over an element now names its icons in the card, one per corner (top left: server), so an icon can be read and not only recognised. Tags and icons are on lines of their own, named and colour-coded (required tags violet and first, other tags sky blue, icons fuchsia), so a tag and an icon are not taken for each other. An element whose only content is icons gets the card too. (ADR 0155)
  • The window title and the Notes panel now show unsaved changes. The title reads <file name> — Context-Heavy Diagrams, with a dot in front while the diagram or one of its notes is not on disk (it used to say only the app's name). The Notes panel shows Unsaved beside the note's name while its edits are only in memory, and Saved once the file has them. A note is still written when the diagram is saved, not when the panel closes. (ADR 0154)
  • Drag a number field's label to change its value in the properties panel and the Preferences panel (stroke width, font size, opacity, animation speed and the rest): drag sideways, one step per pixel, Shift for fine and Ctrl for coarse. The cursor hides and the drag carries on past the window edge; one drag is one undo step, and a plain click still focuses the box for typing. (ADR 0152)
  • A reference for the chd command line (docs/cli-reference.md): every command, its options and exit codes, how to get chd on a machine, and worked examples with their output, including checking a draft or a committed version through a pipe. A test fails when a command, an option or an edit operation is missing from it.

Changed

  • The menus are grouped. A line now separates the kinds of entry in File, Edit, View and Help. New is a submenu (Diagram, Diagram metamodel…) and so is Export (PNG…, SVG…); the shortcuts are the same. The command palette lists them as New: Diagram and Export: PNG…, and now also lists the entries of View → Changes, which it missed. (ADR 0157)
  • The AI menu is organised by what you want to do: Copy AI instructions, Set up a folder for AI agents… (it was Enable AI assistance in a folder…; it writes AGENTS.md, which most agents read, and CLAUDE.md with a skill, which Claude Code reads) and Install the MCP server for, with the Claude Desktop install as one entry in it.
  • A change in how an element looks is now a change in a review, when the look carries meaning: fill, border colour, width and opacity, line style, markers, an edge's colour, width and animation, and icons. Such an element is coloured fuchsia as Restyled, with the old and new value in the hover card, and every changed line one under the other in the list with a chip beside each colour ("line style: solid → dotted"), its own count and its own heading in chd diff; an edge keeps its own look and gets a glow instead of being recoloured. Font, text alignment, label position and routing are still only marked with the paint brush. In chd diff --json each field has a category and a look has before and after, counts has restyled, and the old restyled count is now cosmeticLook; --exit-code exits 1 for a restyle alone. (ADR 0153)
  • The properties panel opens Fill, Border and Metadata, and starts with Font, Transform, Connection points and References closed, since those are the ones used least. A section you open or close stays that way for the rest of the session, as before.
  • chd help edit now lists every operation chd edit takes, with its fields. Before, it sent you to the Claude Desktop extension's tool for them. The extension and the command line print the same text. (ADR 0150)

Fixed

  • Save As no longer leaves the copy pointing at the original's files. Notes you never opened stayed in the old folder while the new diagram still referred to them, so editing one changed the other; images and linked diagrams were not carried either. See Save As asks what to copy.

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.

Context-Heavy Diagrams 0.7.0

Pre-release

Choose a tag to compare

@github-actions github-actions released this 07 Nov 01:21
0796b70

Added

  • An assistant can build a diagram step by step in Claude Desktop, without a shell. The extension has three new tools: edit_diagram applies a list of operations (add an entity, container, text or line, connect, move, resize, restyle, nest, remove) and answers with what each made and what is wrong with the layout so far; inspect_diagram lists the elements as they stand; room_for_label says how much space two connected elements need for an edge label. The assistant decides all placement. The operations also set tags (on elements, edges and the diagram), required tags, highlights and legend entries, links to other diagrams and notes, and remove deletes an element or an edge. It can also bend an edge through routing points and link a new drill-down diagram, which goes in the folder named after its parent as the editor does. Icons and the security matrix are not covered yet. The command line has the same through chd edit (the operations as JSON on standard input or --ops, and --base <fingerprint> to change a file that exists) and chd ask inspect / chd ask room, with the same answers; an assistant with a shell no longer needs the extension to build a diagram, and a pipeline can build one reproducibly. (ADR 0150) Its answers are short (an element's id and, after a move or an add, its place and size), problems of one kind are collapsed into one line with their number, and the layout check also finds a label that does not fit its box. (ADR 0148)

Changed

  • The Claude Desktop extension can search the text of its files without a shell. search_files finds lines as grep does (plain text or a regular expression, ignoring case, a glob, a subfolder, context lines, a cap), in plain Node on every system. list_files can show the folders one level at a time with their number of files, take a glob and page through a long list, and read_file can read a range of lines. list_files says when folders below its twelve levels were left out. The skill and AGENTS.md now tell an assistant that has these tools to build with edit_diagram instead of writing the JSON. (ADR 0149)
  • The Claude Desktop extension can read any file in its folder, not only a list of text types: source code, PDFs, pictures, spreadsheets. Text comes over as text, pictures as images and other binary files as attachments; what Claude can make of an attachment depends on the client. Executables, installers, archives, disk images, video and audio stay blocked, and writing is unchanged. list_files can be narrowed to one subfolder. (ADR 0110)

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.

Context-Heavy Diagrams 0.6.0

Pre-release

Choose a tag to compare

@github-actions github-actions released this 06 Nov 00:11
a2071cf

Added

  • The Claude Desktop extension can check a diagram against a diagram metamodel and show what changed. check_diagram applies a built-in metamodel or a .chdmeta file in the folder, and diff_diagrams compares two diagrams in the folder, with the same results as chd check and chd diff. The conformance topic of get_format_spec explains the checks. The command line stays what a build pipeline relies on. (ADR 0138)
  • The extension can compare a diagram with its last commit in git, and write diagram metamodels. diff_diagrams takes a revision as chd diff --rev does, which makes git show the only program the extension starts; the install dialog says so, and that history can bring back content since removed. create_file and update_file also write .chdmeta files, validated first and with the same stale-edit check as a diagram. (ADR 0142, ADR 0143)
  • A diagram metamodel can be validated on its own. chd validate rules/house.chdmeta and the extension's validate_metamodel list every way the file breaks the format, without applying it to a diagram. The skill's guide for writing a metamodel now says what to ask for and what the format cannot express. (ADR 0143)
  • A draft can be checked and compared before it is written. chd check - and chd diff <file> - read the diagram from standard input, and the extension's check_diagram and diff_diagrams take it as content / new_content / old_content. Notes are not compared for a draft. (ADR 0145)
  • The validator warns when an edge label does not fit in the gap between the two elements, with the line and arrowhead still showing either side of it. chd validate and the extension's validate_diagram say which edge, how many pixels it has and about how many it needs. The layout guide the assistants read now gives the room two elements joined by an edge need (it contradicted itself: 20 px between related elements, 100 to 160 px for a label). The warning is a minimum; the guide's figures are the target. Diagnostics lists the same edges under Layout; click one to select the edge and frame the two elements. (ADR 0146)

Changed

  • A conformance profile is now called a diagram metamodel: the complete set of rules one kind of diagram or architecture follows, of which a diagram is checked against exactly one. The file is <name>.chdmeta, the option is chd check --metamodel, the Diagnostics panel, the File menu and Preferences say metamodel, and --json names it metamodelName (it was profileName). Your .chdprofile.json files, --profile, and the folder you chose in Preferences keep working. (ADR 0144, format)

File format

  • A diagram metamodel carries metamodelVersion where a profile carried profileVersion. Both are read; a file with both is refused, and new files use the new key. The diagram format (.chd) is unchanged. (docs/metamodel-format.md)

Installing

The installer is not signed yet. Windows shows "Windows protected your PC": choose More info, then Run anyway. The SHA-256 of the installer is in SHA256SUMS.