@intentius/chant 0.11.0 → 0.12.1

package/dist/cli/handlers/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/graph.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../../src/cli/handlers/graph.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnE"}

package/dist/cli/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAe9E;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA6IpD"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAKA,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAe9E;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAiJpD"}

package/dist/cli/registry.d.ts

@@ -64,6 +64,11 @@ export interface ParsedArgs {
     up?: boolean;
     /** `chant graph --lens blast:<node> --down` — include downstream dependents */
     down?: boolean;
+    /** `chant graph --format layout --node-sizes <json|-|@file>` — painter-measured
+     * node footprints `{id:{w,h}}` so the layout spaces for real card sizes (#509). */
+    nodeSizes?: string;
+    /** `chant graph --format layout --layout-engine dagre|graphviz` (default dagre). */
+    layoutEngine?: string;
     /** `chant lifecycle affected --base <ref>` — base git ref to diff against */
     base?: string;
     /** `chant lifecycle affected --head <ref>` — head git ref (default: working tree) */

package/dist/cli/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"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"}

package/dist/graph-ir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-ir.d.ts","sourceRoot":"","sources":["../src/graph-ir.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,cAAc,CAAC;AAK7D;;;;;;;;GAQG;AAEH,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iCAAiC;AACjC,MAAM,WAAW,MAAM;IACrB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,KAAK,CAAC;IACZ,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,gFAAgF;AAChF,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC;CAClB;AAyID;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACjC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAmDT"}
+{"version":3,"file":"graph-ir.d.ts","sourceRoot":"","sources":["../src/graph-ir.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,UAAU,EAAgB,MAAM,cAAc,CAAC;AAK7D;;;;;;;;GAQG;AAEH,iFAAiF;AACjF,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iCAAiC;AACjC,MAAM,WAAW,MAAM;IACrB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mCAAmC;IACnC,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,yCAAyC;IACzC,IAAI,EAAE,KAAK,CAAC;IACZ,8EAA8E;IAC9E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,QAAQ;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACpC;AAED,gFAAgF;AAChF,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,QAAQ,CAAC;CAClB;AA6ID;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,EACjC,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAmDT"}

package/dist/graph-layout.d.ts

@@ -1,39 +1,87 @@
+import type { GraphIR } from "./graph-ir.js";
 /**
  * Layout-position export — node coordinates a custom painter consumes (the
- * rackattack pattern: Graphviz lays out, the painter draws). Graphviz is used
- * for LAYOUT ONLY; its rendering is discarded. See issue #497 / epic #492.
+ * rackattack pattern: an engine lays out, the painter draws). The engine is used
+ * for LAYOUT ONLY; any rendering it can do is discarded. See issue #497 / epic
+ * #492, and #509 for the size-aware redesign.
  *
- * The {@link LayoutEngine} interface exists so a pure-JS engine (elkjs/dagre)
- * can drop in later for a zero-native-dependency path — closing the install gap
- * so a painter can run without `dot`.
+ * The engine takes an **engine-neutral {@link LayoutInput}** — sized nodes plus
+ * edges — not a DOT string, so the painter's real node sizes drive spacing
+ * (without sizes a layout engine packs for tiny default boxes and big cards
+ * collide). Two engines implement it:
+ *
+ * - {@link DagreLayout} (default) — pure JS, size-aware, **no native dependency**.
+ * - {@link GraphvizLayout} — opt-in; shells `dot`. Honours `groups` as clusters.
+ *
+ * Coordinate convention (both engines): **y grows up, origin bottom-left**, as
+ * `dot -Tjson` reports. A painter flips y to read top-to-bottom.
  */
-/** A laid-out position in the engine's coordinate space. */
+/** A laid-out position in the engine's coordinate space (y-up). */
 export interface Point {
     x: number;
     y: number;
 }
-/** Node positions plus the overall canvas size a painter needs. */
+/** Node positions plus the overall canvas size a painter needs. Centres are
+ * y-up (origin bottom-left). `w`/`h` echo the footprint the engine laid out
+ * with, so a painter can route edges to card borders rather than centres. */
 export interface Layout {
     /** Canvas width in the engine's coordinate space. */
     width: number;
     /** Canvas height in the engine's coordinate space. */
     height: number;
-    /** Each node's centre position, ordered by id for deterministic output. */
+    /** Each node's centre position (+ footprint), ordered by id for determinism. */
     nodes: Array<{
         id: string;
+        w?: number;
+        h?: number;
     } & Point>;
 }
-/** Turns DOT into node positions. The painter consumes the result; it never
- * asks the engine to paint. */
+/** A node's painted footprint, in layout units (≈ px / points). */
+export interface NodeSize {
+    w: number;
+    h: number;
+}
+/** Engine-neutral layout input: sized nodes + edges (+ optional groups). */
+export interface LayoutInput {
+    nodes: Array<{
+        id: string;
+    } & NodeSize>;
+    edges: Array<{
+        from: string;
+        to: string;
+    }>;
+    /** Group name → member ids, for cluster-aware engines (graphviz subgraphs). */
+    groups?: Record<string, string[]>;
+}
+/** Turns sized nodes + edges into node positions. The painter consumes the
+ * result; it never asks the engine to paint. */
 export interface LayoutEngine {
     readonly name: string;
-    layout(dot: string): Promise<Layout>;
+    layout(input: LayoutInput): Promise<Layout>;
+}
+/** Graphviz's default node box, in layout units — the fallback for a node the
+ * painter didn't measure, so a size-less call still lays out as it always did. */
+export declare const DEFAULT_NODE_SIZE: NodeSize;
+/** Build engine input from an IR and a painter-measured size map (id → {w,h}).
+ * Nodes absent from the map fall back to {@link DEFAULT_NODE_SIZE}. Pure. */
+export declare function toLayoutInput(ir: GraphIR, sizes?: Record<string, NodeSize>): LayoutInput;
+/**
+ * Layout via dagre — pure JS, size-aware, no native dependency. The default.
+ * Fed nodes/edges in id order so the result is deterministic. dagre's space is
+ * y-down; we flip to y-up so the {@link Layout} contract matches Graphviz.
+ */
+export declare class DagreLayout implements LayoutEngine {
+    readonly name = "dagre";
+    layout(input: LayoutInput): Promise<Layout>;
 }
-/** Layout via `dot -Tjson`. Requires Graphviz (`brew install graphviz`). */
+/** Layout via `dot -Tjson`. Opt-in; requires Graphviz (`brew install graphviz`).
+ * Lays out with real node sizes (`fixedsize`) and honours `groups` as clusters. */
 export declare class GraphvizLayout implements LayoutEngine {
     readonly name = "graphviz";
-    layout(dot: string): Promise<Layout>;
+    layout(input: LayoutInput): Promise<Layout>;
 }
+/** Resolve a layout engine by name. Defaults to dagre (no native dependency). */
+export declare function getLayoutEngine(name?: string): LayoutEngine;
 /** Parse `dot -Tjson` output into a {@link Layout}. Pure; exported for testing. */
 export declare function parseDotJson(json: string): Layout;
 //# sourceMappingURL=graph-layout.d.ts.map

package/dist/graph-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph-layout.d.ts","sourceRoot":"","sources":["../src/graph-layout.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,mEAAmE;AACnE,MAAM,WAAW,MAAM;IACrB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC,CAAC;CACtC;AAED;+BAC+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,4EAA4E;AAC5E,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,cAAc;IAErB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAG3C;AAsCD,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBjD"}
+{"version":3,"file":"graph-layout.d.ts","sourceRoot":"","sources":["../src/graph-layout.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AAEH,mEAAmE;AACnE,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;6EAE6E;AAC7E,MAAM,WAAW,MAAM;IACrB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK,CAAC,CAAC;CAC9D;AAED,mEAAmE;AACnE,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,QAAQ,CAAC,CAAC;IACxC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CACnC;AAED;gDACgD;AAChD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;kFACkF;AAClF,eAAO,MAAM,iBAAiB,EAAE,QAA2B,CAAC;AAM5D;6EAC6E;AAC7E,wBAAgB,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAM,GAAG,WAAW,CAM5F;AAiBD;;;;GAIG;AACH,qBAAa,WAAY,YAAW,YAAY;IAC9C,QAAQ,CAAC,IAAI,WAAW;IAElB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CA0BlD;AAED;mFACmF;AACnF,qBAAa,cAAe,YAAW,YAAY;IACjD,QAAQ,CAAC,IAAI,cAAc;IAErB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CAGlD;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,YAAY,CAM3D;AA0ED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBjD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentius/chant",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "description": "Declarative infrastructure-as-code toolkit — TypeScript on Node.js",
   "license": "Apache-2.0",
   "homepage": "https://intentius.io/chant",
@@ -65,6 +65,7 @@
     "prepack": "npm run build"
   },
   "dependencies": {
+    "@dagrejs/dagre": "^3.0.0",
     "fflate": "^0.8.2",
     "picomatch": "^4.0.3",
     "tsx": "^4.0.0",

package/src/cli/handlers/graph.test.ts

@@ -18,14 +18,12 @@ vi.mock("../commands/lint", () => ({
   lintCommand: () => lintMock(),
 }));
 
-// Avoid shelling out to graphviz in tests; the format dispatch is what matters.
+// Avoid running a real layout engine in tests; the format dispatch + size/engine
+// plumbing is what matters here (engines have their own unit tests).
 const layoutMock = vi.fn();
 vi.mock("../../graph-layout", () => ({
-  GraphvizLayout: class {
-    layout() {
-      return layoutMock();
-    }
-  },
+  toLayoutInput: (ir: { nodes: { id: string }[] }, sizes: unknown) => ({ ir, sizes }),
+  getLayoutEngine: (name?: string) => ({ name: name ?? "dagre", layout: (input: unknown) => layoutMock(input) }),
 }));
 
 const { runGraph } = await import("./graph");

package/src/cli/handlers/graph.ts

@@ -7,8 +7,9 @@ import { applyDetail, type DetailLevel } from "../../graph-detail";
 import { applyLens, parseLens } from "../../graph-lens";
 import { toMermaid } from "../../graph-mermaid";
 import { toDot } from "../../graph-dot";
-import { GraphvizLayout } from "../../graph-layout";
+import { getLayoutEngine, toLayoutInput, type NodeSize } from "../../graph-layout";
 import { lintCommand } from "../commands/lint";
+import { readFileSync } from "node:fs";
 import { formatError, formatWarning, formatBold } from "../format";
 import type { CommandContext } from "../registry";
 
@@ -30,9 +31,11 @@ export async function runGraph(ctx: CommandContext): Promise<number> {
 /**
  * `chant graph --format ir|mermaid|dot|layout` — build the graph IR (honouring
  * `--detail`) and emit it as JSON, a Mermaid flowchart, Graphviz DOT, or node
- * positions from a layout engine. Lint-gated: the IR represents valid infra, so
- * we refuse to emit for source that does not pass lint. Non-zero on discovery
- * errors, or on a missing `dot` for `--format layout`.
+ * positions from a layout engine. `layout` takes optional painter-measured
+ * `--node-sizes` so spacing fits real node footprints, and defaults to the dagre
+ * engine (no native dependency); `--layout-engine graphviz` opts into `dot`.
+ * Lint-gated: the IR represents valid infra, so we refuse to emit for source that
+ * does not pass lint. Non-zero on discovery errors or a layout-engine failure.
  */
 async function runGraphView(
   ctx: CommandContext,
@@ -86,7 +89,9 @@ async function runGraphView(
       return 0;
     case "layout":
       try {
-        const layout = await new GraphvizLayout().layout(toDot(ir));
+        const sizes = readNodeSizes(ctx.args.nodeSizes);
+        const engine = getLayoutEngine(ctx.args.layoutEngine);
+        const layout = await engine.layout(toLayoutInput(ir, sizes));
         console.log(JSON.stringify(layout, null, 2));
         return 0;
       } catch (err) {
@@ -100,6 +105,40 @@ async function runGraphView(
   }
 }
 
+/**
+ * Resolve the `--node-sizes` value into a `{ id: {w, h} }` map. The spec is one
+ * of: inline JSON, `-` (read JSON from stdin, to dodge arg-length limits), or
+ * `@path` (read from a file). Empty/absent → no sizes (engine uses defaults).
+ * Throws on malformed JSON so a typo fails loudly rather than mis-laying out.
+ */
+function readNodeSizes(spec?: string): Record<string, NodeSize> {
+  if (!spec) return {};
+  let raw: string;
+  if (spec === "-") raw = readFileSync(0, "utf8");
+  else if (spec.startsWith("@")) raw = readFileSync(spec.slice(1), "utf8");
+  else raw = spec;
+  raw = raw.trim();
+  if (!raw) return {};
+
+  let parsed: unknown;
+  try {
+    parsed = JSON.parse(raw);
+  } catch (err) {
+    throw new Error(`--node-sizes is not valid JSON: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (typeof parsed !== "object" || parsed === null) {
+    throw new Error("--node-sizes must be a JSON object mapping node id → {w, h}");
+  }
+  const out: Record<string, NodeSize> = {};
+  for (const [id, val] of Object.entries(parsed as Record<string, unknown>)) {
+    const v = val as { w?: unknown; h?: unknown };
+    if (typeof v?.w === "number" && typeof v?.h === "number" && v.w > 0 && v.h > 0) {
+      out[id] = { w: v.w, h: v.h };
+    }
+  }
+  return out;
+}
+
 async function runOpGraph(): Promise<number> {
   const { ops, errors } = await discoverOps();
   for (const err of errors) console.error(formatError({ message: err }));

package/src/cli/main.ts

@@ -134,6 +134,10 @@ export function parseArgs(args: string[]): ParsedArgs {
       result.up = true;
     } else if (arg === "--down") {
       result.down = true;
+    } else if (arg === "--node-sizes") {
+      result.nodeSizes = args[++i];
+    } else if (arg === "--layout-engine") {
+      result.layoutEngine = args[++i];
     } else if (arg === "--base") {
       result.base = args[++i];
     } else if (arg === "--head") {
@@ -200,8 +204,10 @@ Ops:
 
   graph                 Show Op dependency graph (--stacks for cross-stack order,
                         --format ir|mermaid|dot|layout for the lint-gated graph IR,
-                        a Mermaid flowchart, Graphviz DOT, or node positions
-                        (layout needs graphviz);
+                        a Mermaid flowchart, Graphviz DOT, or node positions;
+                        layout uses dagre by default (no native dep) — pass
+                        --node-sizes <json|-|@file> for size-aware spacing,
+                        --layout-engine graphviz to use dot instead;
                         --detail 0..3: stacks|composites|declarables|attributes;
                         --lens lexicon:<n>|stack:<n>|blast:<node> (--up/--down))
 

package/src/cli/registry.ts

@@ -65,6 +65,11 @@ export interface ParsedArgs {
   up?: boolean;
   /** `chant graph --lens blast:<node> --down` — include downstream dependents */
   down?: boolean;
+  /** `chant graph --format layout --node-sizes <json|-|@file>` — painter-measured
+   * node footprints `{id:{w,h}}` so the layout spaces for real card sizes (#509). */
+  nodeSizes?: string;
+  /** `chant graph --format layout --layout-engine dagre|graphviz` (default dagre). */
+  layoutEngine?: string;
   /** `chant lifecycle affected --base <ref>` — base git ref to diff against */
   base?: string;
   /** `chant lifecycle affected --head <ref>` — head git ref (default: working tree) */

package/src/graph-ir.test.ts

@@ -42,6 +42,30 @@ describe("buildGraphIr", () => {
     });
   });
 
+  test("treats a foreign AttrRef (different @intentius/chant copy) as a ref, not an opaque intrinsic (#511)", () => {
+    // A lexicon built against a *separate* copy of chant produces AttrRefs that
+    // fail `instanceof AttrRef` here but carry the global-symbol brand + shape.
+    // (This is the pinhole install scenario; before #511 it flattened to
+    // `{$intrinsic}` with no edge.)
+    const vpc = decl({ lexicon: "aws", entityType: "Vpc" });
+    const foreignRef = {
+      [Symbol.for("chant.intrinsic")]: true,
+      parent: new WeakRef(vpc),
+      attribute: "VpcId",
+      _setLogicalName() {}, // shape utils.isAttrRefLike duck-types on
+      getLogicalName: () => undefined, // resolves via object identity in the reverse map
+    };
+    const sg = decl({ lexicon: "aws", entityType: "SecurityGroup", props: { VpcId: foreignRef } });
+    const entities = new Map<string, Declarable>([
+      ["vpc", vpc],
+      ["sg", sg],
+    ]);
+
+    const ir = buildGraphIr(entities);
+    expect(ir.edges).toEqual([{ from: "sg", to: "vpc", kind: "ref", viaAttr: "VpcId" }]);
+    expect(ir.nodes.find((n) => n.id === "sg")!.attrs).toEqual({ VpcId: { $ref: "vpc.VpcId" } });
+  });
+
   test("excludes property-kind declarables and keeps resources", () => {
     const resource = decl({ lexicon: "k8s", entityType: "Deployment" });
     const prop = decl({ lexicon: "k8s", entityType: "Probe", kind: "property" as const });

package/src/graph-ir.ts

@@ -1,5 +1,6 @@
 import { relative, isAbsolute } from "node:path";
 import { AttrRef } from "./attrref";
+import { isAttrRefLike } from "./utils";
 import { type Declarable, isDeclarable } from "./declarable";
 import { isLexiconOutput } from "./lexicon-output";
 import { getProvenance } from "./provenance";
@@ -113,7 +114,11 @@ function project(value: unknown, seen: Set<unknown>, reverse: Map<object, string
   if (t === "string" || t === "number" || t === "boolean") return value;
   if (t !== "object") return undefined; // functions, symbols, undefined
 
-  if (value instanceof AttrRef) {
+  // Duck-type, not `instanceof`: a lexicon built against a different copy of
+  // `@intentius/chant` produces AttrRefs that fail `instanceof AttrRef` but carry
+  // the same shape. Without this, a real cross-resource reference falls through to
+  // the intrinsic branch below and is silently flattened to `{$intrinsic}` (#511).
+  if (isAttrRefLike(value)) {
     const to = refTarget(value, reverse);
     return { $ref: to ? `${to}.${value.attribute}` : value.attribute } satisfies AttrRefEnvelope;
   }
@@ -192,7 +197,7 @@ function collectEdges(
   const seen = new Set<unknown>();
   const visit = (value: unknown, viaAttr: string): void => {
     if (value === null || typeof value !== "object") return;
-    if (value instanceof AttrRef) {
+    if (isAttrRefLike(value)) {
       const to = refTarget(value, reverse);
       if (to && to !== from && nodeIds.has(to)) {
         edges.push({ from, to, kind: "ref", viaAttr });

package/src/graph-layout.test.ts

@@ -0,0 +1,131 @@
+import { describe, it, expect } from "vitest";
+import {
+  toLayoutInput,
+  DagreLayout,
+  GraphvizLayout,
+  getLayoutEngine,
+  parseDotJson,
+  DEFAULT_NODE_SIZE,
+  type LayoutInput,
+} from "./graph-layout";
+import type { GraphIR } from "./graph-ir";
+
+const ir: GraphIR = {
+  nodes: [
+    { id: "vpc", kind: "Vpc", lexicon: "aws", attrs: {} },
+    { id: "subnet", kind: "Subnet", lexicon: "aws", attrs: {} },
+  ],
+  edges: [{ from: "subnet", to: "vpc", kind: "ref", viaAttr: "VpcId" }],
+  groups: { byLexicon: { aws: ["vpc", "subnet"] } },
+};
+
+describe("toLayoutInput", () => {
+  it("maps IR nodes/edges and carries groups", () => {
+    const input = toLayoutInput(ir, { vpc: { w: 180, h: 60 }, subnet: { w: 180, h: 76 } });
+    expect(input.nodes).toEqual([
+      { id: "vpc", w: 180, h: 60 },
+      { id: "subnet", w: 180, h: 76 },
+    ]);
+    expect(input.edges).toEqual([{ from: "subnet", to: "vpc" }]);
+    expect(input.groups).toEqual({ aws: ["vpc", "subnet"] });
+  });
+
+  it("falls back to the default box for unmeasured nodes", () => {
+    const input = toLayoutInput(ir);
+    expect(input.nodes.every((n) => n.w === DEFAULT_NODE_SIZE.w && n.h === DEFAULT_NODE_SIZE.h)).toBe(true);
+  });
+});
+
+describe("getLayoutEngine", () => {
+  it("defaults to dagre (no native dependency)", () => {
+    expect(getLayoutEngine().name).toBe("dagre");
+    expect(getLayoutEngine("dagre").name).toBe("dagre");
+  });
+  it("returns graphviz on request", () => {
+    expect(getLayoutEngine("graphviz").name).toBe("graphviz");
+  });
+  it("throws on an unknown engine", () => {
+    expect(() => getLayoutEngine("elk")).toThrow(/unknown layout engine/i);
+  });
+});
+
+describe("DagreLayout", () => {
+  const input: LayoutInput = {
+    nodes: [
+      { id: "vpc", w: 180, h: 60 },
+      { id: "subnetA", w: 180, h: 76 },
+      { id: "subnetB", w: 180, h: 76 },
+    ],
+    edges: [
+      { from: "subnetA", to: "vpc" },
+      { from: "subnetB", to: "vpc" },
+    ],
+  };
+
+  it("lays out with no native dependency and echoes sizes", async () => {
+    const layout = await new DagreLayout().layout(input);
+    expect(layout.nodes.map((n) => n.id)).toEqual(["subnetA", "subnetB", "vpc"]);
+    expect(layout.width).toBeGreaterThan(0);
+    expect(layout.nodes.find((n) => n.id === "vpc")).toMatchObject({ w: 180, h: 60 });
+  });
+
+  it("spaces sized cards so none overlap", async () => {
+    const layout = await new DagreLayout().layout(input);
+    const r = layout.nodes.map((n) => ({
+      id: n.id,
+      x0: n.x - (n.w ?? 0) / 2,
+      x1: n.x + (n.w ?? 0) / 2,
+      y0: n.y - (n.h ?? 0) / 2,
+      y1: n.y + (n.h ?? 0) / 2,
+    }));
+    for (let i = 0; i < r.length; i++) {
+      for (let j = i + 1; j < r.length; j++) {
+        const xOverlap = Math.min(r[i].x1, r[j].x1) - Math.max(r[i].x0, r[j].x0);
+        const yOverlap = Math.min(r[i].y1, r[j].y1) - Math.max(r[i].y0, r[j].y0);
+        expect(xOverlap > 0 && yOverlap > 0).toBe(false);
+      }
+    }
+  });
+
+  it("emits y-up coordinates matching graphviz (edge from drawn above to)", async () => {
+    // Edges are subnet → vpc (consumer → producer). rankdir=TB draws the tail
+    // above the head, so subnets sit above vpc — same as `dot`. In y-up space
+    // that means subnets have the larger y. (Verified against GraphvizLayout.)
+    const layout = await new DagreLayout().layout(input);
+    const vpc = layout.nodes.find((n) => n.id === "vpc")!;
+    const subnetA = layout.nodes.find((n) => n.id === "subnetA")!;
+    expect(subnetA.y).toBeGreaterThan(vpc.y);
+  });
+
+  it("is deterministic", async () => {
+    const a = await new DagreLayout().layout(input);
+    const b = await new DagreLayout().layout(input);
+    expect(a).toEqual(b);
+  });
+});
+
+describe("parseDotJson", () => {
+  it("reads bounds, positions, and echoes node size in points", () => {
+    const json = JSON.stringify({
+      bb: "0,0,200,100",
+      objects: [
+        { name: "b", pos: "50,80", width: "2.5", height: "0.5" },
+        { name: "a", pos: "50,20" },
+      ],
+    });
+    const layout = parseDotJson(json);
+    expect(layout).toMatchObject({ width: 200, height: 100 });
+    expect(layout.nodes.map((n) => n.id)).toEqual(["a", "b"]); // sorted
+    expect(layout.nodes.find((n) => n.id === "b")).toMatchObject({ x: 50, y: 80, w: 180, h: 36 });
+  });
+
+  it("rejects zero bounds", () => {
+    expect(() => parseDotJson(JSON.stringify({ bb: "0,0,0,0", objects: [] }))).toThrow(/zero graph bounds/);
+  });
+});
+
+describe("GraphvizLayout", () => {
+  it("exposes the graphviz engine name", () => {
+    expect(new GraphvizLayout().name).toBe("graphviz");
+  });
+});