Release 0.7.4 — mermaid output and Markout 0.12.0 (#305)

* Add mermaid output workflow and feature entry

New workflow doc covers standalone and embedded mermaid modes
for type hierarchy, library reference, and package dependency
graphs. Add feature entry for --mermaid flag.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Bump version to 0.7.4

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: richlander

docs/workflows/features.md

@@ -46,6 +46,7 @@
 | Tips system | 935a39b | 0.2.x | Contextual suggestions on stderr |
 | `-T` tips verbosity | 0c679e4 | 0.2.x | Control tip output level |
 | Redesigned tips UI | 381efa2 | 0.3.x | Single header with aligned entries |
+| `--mermaid` output | b88427d | 0.7.x | Mermaid diagram output for depends (standalone and embedded) |
 
 ## Type and Member Inspection
 

docs/workflows/output/mermaid-output.md

@@ -0,0 +1,215 @@
+---
+id: mermaid-output
+description: Mermaid diagram output for dependency graphs — standalone and embedded in markdown
+commands: [depends, --mermaid, --markdown]
+areas: [mermaid, output, diagrams, depends, visualization]
+---
+
+# Mermaid Output
+
+> The `--mermaid` flag produces Mermaid diagram syntax for dependency graphs. Two modes: standalone (`--mermaid`) for piping to `mmdc` or other tools, and embedded (`--markdown --mermaid`) for rendering in GitHub, VS Code, or any Markdown viewer.
+
+## Preconditions
+
+Isolated session with cached packages.
+
+```bash
+export DOTNET_INSPECT_ISOLATED=mermaid-output
+```
+
+```bash
+dotnet-inspect cache clear
+```
+
+Prime the cache:
+
+```bash
+dotnet-inspect System.CommandLine@2.0.3 -v:q
+```
+
+## 1. Standalone mermaid for type hierarchy
+
+> Goal: Get a mermaid graph of a type's inheritance tree, suitable for piping to `mmdc` or embedding in documentation.
+
+### 1a. Simple class hierarchy
+
+```prompt
+Show the Stream type hierarchy as a mermaid diagram.
+```
+
+```bash
+dotnet-inspect depends Stream --mermaid
+```
+
+```expect
+graph TD
+n0["System.MarshalByRefObject"]
+n1["System.IAsyncDisposable"]
+n2["System.IDisposable"]
+```
+
+```expect-not
+#
+```
+
+### 1b. Deep interface hierarchy
+
+```prompt
+Show the INumber interface hierarchy as a mermaid graph.
+```
+
+```bash
+dotnet-inspect depends 'INumber<TSelf>' --mermaid
+```
+
+```expect
+graph TD
+n0["System.IComparable"]
+-->
+```
+
+### 1c. NuGet package type
+
+```bash
+dotnet-inspect depends Command --package System.CommandLine --mermaid
+```
+
+```expect
+graph TD
+n0["System.CommandLine.Symbol"]
+n1["System.Collections.IEnumerable"]
+```
+
+## 2. Embedded mermaid in markdown
+
+> Goal: Get mermaid diagrams inside a markdown document — renders directly in GitHub and VS Code.
+
+### 2a. Simple class
+
+```prompt
+Show Stream dependencies as markdown with a mermaid diagram.
+```
+
+```bash
+dotnet-inspect depends Stream --markdown --mermaid
+```
+
+```expect
+# System.IO.Stream
+```mermaid
+graph TD
+```
+
+### 2b. Deep hierarchy
+
+```bash
+dotnet-inspect depends 'INumber<TSelf>' --markdown --mermaid -n 10
+```
+
+```expect
+# INumber<TSelf>
+```mermaid
+graph TD
+```
+
+## 3. Library reference graphs
+
+> Goal: Visualize assembly reference dependencies for a platform library.
+
+### 3a. Standalone mermaid
+
+```prompt
+Show what System.Text.Json depends on as a mermaid diagram.
+```
+
+```bash
+dotnet-inspect depends --library System.Text.Json --mermaid -n 10
+```
+
+```expect
+graph TD
+n0["System.Collections
+-->
+```
+
+### 3b. Embedded in markdown
+
+```bash
+dotnet-inspect depends --library System.Text.Json --markdown --mermaid -n 10
+```
+
+```expect
+# System.Text.Json
+```mermaid
+graph TD
+```
+
+## 4. Package dependency graphs
+
+> Goal: Visualize NuGet package dependencies as a diagram.
+
+```prompt
+What does the Markout package depend on?
+```
+
+```bash
+dotnet-inspect depends --package Markout --mermaid
+```
+
+```expect
+graph TD
+n0["MarkdownTable.Formatting
+```
+
+## 5. Default output unchanged
+
+> Goal: Verify that `depends` without `--mermaid` still produces the standard tree output.
+
+```bash
+dotnet-inspect depends Stream
+```
+
+```expect
+System.IO.Stream
+├─ System.MarshalByRefObject
+├─ System.IAsyncDisposable
+└─ System.IDisposable
+```
+
+```expect-not
+graph TD
+```
+
+## 6. Mermaid with other flags
+
+> Goal: Verify `--mermaid` works alongside other output flags.
+
+### 6a. JSON takes precedence over mermaid
+
+```bash
+dotnet-inspect depends Stream --mermaid --json
+```
+
+```expect
+[
+{
+"type_name"
+```
+
+```expect-not
+graph TD
+```
+
+### 6b. Environment variable
+
+```setup
+export DOTNET_INSPECT_FORMAT=mermaid
+```
+
+```bash
+dotnet-inspect depends Stream
+```
+
+```expect
+graph TD
+```

src/dotnet-inspect/dotnet-inspect.csproj

@@ -21,7 +21,7 @@
     <Authors>Richard Lander</Authors>
     <PackAsTool>true</PackAsTool>
     <ToolCommandName>dotnet-inspect</ToolCommandName>
-    <VersionPrefix>0.7.3</VersionPrefix>
+    <VersionPrefix>0.7.4</VersionPrefix>
     <PackageId>dotnet-inspect</PackageId>
     <Description>A CLI tool for inspecting .NET assemblies and NuGet packages</Description>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>