Skip to content

v0.13.0-dev.7

v0.13.0-dev.7: Convert ASCII diagrams to Mermaid in the Supabase docs (#780)
@wmadden-electric wmadden-electric tagged this 10 Jun 13:34 
## Linked issue

n/a — docs maintenance across the Supabase integration
(`projects/supabase-integration/` + constituents). Converts ASCII
diagrams to Mermaid per author preference.

## At a glance

The umbrella dependency graph is now Mermaid instead of ASCII
box-drawing:

```mermaid
flowchart TD
  foundation["target-extensible-ir (TML-2459)"]
  control["control-policy (TML-2493)"]
  rls["postgres-rls (TML-2501)"]
  rtl["runtime-target-layer (TML-2502)"]
  ext["extension-supabase (integration / launch)"]
  foundation --> control
  control --> rls
  control --> rtl
  rls -.->|"proof dependency"| rtl
  rls --> ext
  rtl --> ext
```

(Abridged — the full graph also includes `cross-contract-refs`,
`explicit-namespace-dsl`, and the TML-2605 edge.)

## Decision

Doc-only. Replace the ASCII box-drawing / arrow diagrams in the Supabase
docs with Mermaid, following the repo's `mermaid-compat` rule (short
ASCII node labels, no backticks/arrows/ellipses inside labels, detail
moved to surrounding Markdown).

Scope decision: **diagrams only.** Directory-tree listings (`├──
package.json …`) and `//────` comment separators are left untouched —
Mermaid has no good representation for a file tree, and converting would
be a regression.

## What changed

| File | Diagram → Mermaid |
|---|---|
| `supabase-integration/README.md` | Dependency graph → `flowchart TD`.
The runtime-target-layer→postgres-rls proof dependency is drawn as a
**dashed** edge (it's a proof-only dependency, not a build one). |
| `extension-supabase/spec.md` | Two runtime class-hierarchy diagrams →
`classDiagram`; origins moved to a Markdown legend. |
| `runtime-target-layer/spec.md` | "Today" and "after this project"
class hierarchies → `classDiagram`; the `createRuntime` note + layer
origins moved to Markdown. |
| `runtime-target-layer/specs/adr-runtime-target-layer.md` |
`RuntimeCore` → `SqlRuntimeImpl` / `MongoRuntimeImpl` hierarchy →
`classDiagram`. |
| `explicit-namespace-dsl/spec.md` | TML-2605 → TML-2550 prerequisite
flow → `flowchart TD`; the bullet detail moved to a Markdown list. |

## Reviewer notes

- Pure docs; no source or behaviour change. Worth a glance in GitHub's
Mermaid preview to confirm all five render.
- Labels are quoted and ASCII-only (parentheses/slashes are inside
quotes) to stay within the stricter GitHub Mermaid renderer.

## Testing performed

n/a — documentation only. Verified no diagram arrows (`↑ ▼ ▲ ► ◄`)
remain in the Supabase docs and that directory trees were preserved.

## Skill update

n/a — internal docs only; no user-facing surface change.

## Checklist

- [x] All commits are signed off (`git commit -s`).
- [x] I read CONTRIBUTING.md and the change is scoped to one logical
concern.
- [x] Tests are updated (n/a — doc-only).
- [ ] The PR title is in `TML-NNNN: <title>` form — n/a: docs
maintenance with no single Linear ticket.
- [x] The **Skill update** section is filled in (n/a — internal only).

Signed-off-by: Will Madden <madden@prisma.io>
Co-authored-by: Will Madden <madden@prisma.io>
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Assets 2
Loading