@caddis/cli 0.4.49 → 0.4.51

package/bundles/antigravity-plugin/skills/flow-studio/templates/engine.html

@@ -198,6 +198,11 @@
   .node .metric-badge i { display:block; height:2px; position:absolute; bottom:0; left:0; background:var(--accent); }
   .node .s.has-spark { padding-right:60px; }
   .node .spark { position:absolute; right:6px; bottom:4px; overflow:visible; }
+  .node svg.bars { position:absolute; left:10px; right:10px; bottom:6px; width:calc(100% - 20px); height:22px; overflow:visible; }
+  .node svg.bars rect { fill:var(--muted); opacity:.6; }
+  .node svg.bars rect.last { fill:var(--accent); opacity:1; }
+  .node svg.bars rect.low, .node svg.bars rect.miss { fill:var(--crit); opacity:1; }
+  .node svg.bars rect[data-hl="true"] { stroke:var(--fg); stroke-width:1.5px; vector-effect:non-scaling-stroke; opacity:1; }
   .node.gateway .metric-badge { position:absolute; right:9px; top:18px; }
   .node.gateway:has(.metric-badge) .gw-title, .node.gateway.has-metrics .gw-title { width:45%; margin-right:42px; }
   .node .spark polyline, .metrics polyline { fill:none; stroke:var(--accent); stroke-width:1.5; }
@@ -326,6 +331,8 @@
       const metric = n.metrics;
       const invalidSeries = metric?.series !== void 0 && (!Array.isArray(metric.series) || metric.series.length > 60 || metric.series.some((v) => !Number.isFinite(v)));
       if (metric !== void 0 && (!metric || !Number.isFinite(metric.value) || metric.max != null && !Number.isFinite(metric.max) || invalidSeries)) add("error", "metric-invalid", w, "Metrics need finite values and at most 60 finite series points.");
+      const badBars = n.bars !== void 0 && (!Array.isArray(n.bars) || n.bars.length > 120 || n.bars.some((b) => !b || typeof b.key !== "string" || b.value !== null && (typeof b.value !== "number" || !Number.isFinite(b.value) || b.value < 0)));
+      if (badBars) add("error", "bars-invalid", w, "Bars need a list of at most 120 items, each with a string key and a finite, non-negative value or null.");
       if (n.sla !== void 0 && (!Number.isFinite(n.sla) || n.sla <= 0)) add("error", "sla-invalid", w, "SLA must be a positive finite number of seconds.");
     }
     for (const n of nodes) {
@@ -975,6 +982,7 @@
 
   // src/layout.ts
   var DEFAULTS = { pitch: 62, top: 64, gap: 34, padX: 24, visible: () => true };
+  var BARS_EXTRA = 26;
   var LANE_PAD_TOP = 38;
   var LANE_PAD_BOTTOM = 14;
   function computeGeometry(m, opt = {}) {
@@ -988,7 +996,7 @@
     const world = { w: Math.max(1, x - o.gap + o.padX), h: 1 };
     const nodes = {};
     for (const n of m.nodes) {
-      const h = NODE_HEIGHT[n.kind] ?? 54;
+      const h = (NODE_HEIGHT[n.kind] ?? 54) + (n.bars?.length ? BARS_EXTRA : 0);
       if (m.layout === "free") {
         nodes[n.id] = { id: n.id, x: n.x ?? 0, y: n.y ?? 0, w: n.w ?? 190, h: n.h ?? h };
         continue;
@@ -1105,6 +1113,47 @@
     return `<svg class="spark" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" aria-hidden="true"><polyline points="${points}"/></svg>`;
   }
 
+  // src/bars.ts
+  var BAR_UNIT = 4;
+  function barsHtml(bars, height = 22) {
+    if (!bars || bars.length === 0) return "";
+    const width = bars.length * BAR_UNIT;
+    const max = Math.max(1, ...bars.map((b) => b.value ?? 0));
+    const lastWithData = bars.map((b) => b.value !== null).lastIndexOf(true);
+    const rects = bars.map((b, i) => {
+      const x = i * BAR_UNIT;
+      const w = BAR_UNIT - 1;
+      const label = esc(b.label ?? (b.value === null ? `${b.key}: no data` : `${b.key}: ${b.value}`));
+      if (b.value === null) {
+        return `<rect class="miss" data-key="${esc(b.key)}" x="${x}" y="${height - 4}" width="${w}" height="4"><title>${label}</title></rect>`;
+      }
+      const h = Math.max(1, b.value / max * (height - 5));
+      const cls = b.kind === "low" ? "low" : i === lastWithData ? "last" : "";
+      return `<rect${cls ? ` class="${cls}"` : ""} data-key="${esc(b.key)}" x="${x}" y="${height - h}" width="${w}" height="${h}"><title>${label}</title></rect>`;
+    });
+    const first = esc(bars[0].key), last = esc(bars[bars.length - 1].key);
+    return `<svg class="bars" viewBox="0 0 ${width} ${height}" preserveAspectRatio="none" role="img" aria-label="Bars, ${first} to ${last}">${rects.join("")}</svg>`;
+  }
+  function markKey(root, key) {
+    for (const r of Array.from(root.querySelectorAll("rect[data-key]"))) {
+      if (key !== null && r.getAttribute("data-key") === key) r.setAttribute("data-hl", "true");
+      else r.removeAttribute("data-hl");
+    }
+  }
+  function installBars(ctx) {
+    const set = (key) => {
+      if (ctx.hoverKey === key) return;
+      ctx.hoverKey = key;
+      markKey(ctx.els.world, key);
+      ctx.onHoverKey?.(key);
+    };
+    on(ctx, ctx.els.world, "mouseover", (e) => {
+      const bar = e.target?.closest?.("rect[data-key]");
+      set(bar ? bar.getAttribute("data-key") : null);
+    });
+    on(ctx, ctx.els.world, "mouseleave", () => set(null));
+  }
+
   // src/render.ts
   function loopRoute(ctx, fromId, toId, from, to, channel) {
     const detourFor = (end, other) => {
@@ -1141,7 +1190,7 @@
     const arrow = n.kind === "chip" ? '<span aria-hidden="true">\u2191 </span>' : "";
     const lead = showWord ? `<b class="ev st-${cssId(sid)}">${esc(word)}</b> \xB7 ` : "";
     const fold = n.kind === "group" && n.contains?.length ? `<span class="fold">\u25B8 ${n.contains.length}</span>` : "";
-    return `<div class="t"><span class="newdot" title="Added in this view"></span><span class="name">${arrow}${esc(n.title)}</span>${fold}${badge}</div><div class="s${spark ? " has-spark" : ""}" title="${esc(sub)}">${lead}${esc(sub)}</div>${spark}${bar}${improved}${upgrade}`;
+    return `<div class="t"><span class="newdot" title="Added in this view"></span><span class="name">${arrow}${esc(n.title)}</span>${fold}${badge}</div><div class="s${spark ? " has-spark" : ""}" title="${esc(sub)}">${lead}${esc(sub)}</div>${spark}${barsHtml(n.bars)}${bar}${improved}${upgrade}`;
   }
   function build(ctx) {
     const { model, els } = ctx;
@@ -1176,7 +1225,7 @@
     for (const n of model.nodes) {
       const p = ctx.geom.nodes[n.id];
       if (!p) continue;
-      const d = el("div", "node" + (n.kind === "chip" ? " ref" : "") + ((n.colSpan ?? 1) > 1 ? " wide" : ""));
+      const d = el("div", "node" + (n.kind === "chip" ? " ref" : "") + ((n.colSpan ?? 1) > 1 ? " wide" : "") + (n.bars?.length ? " has-bars" : ""));
       d.id = "n_" + n.id;
       d.tabIndex = 0;
       d.setAttribute("role", "button");
@@ -1311,6 +1360,7 @@
         d.style.height = r.h + "px";
       }
     }
+    markKey(ctx.els.world, ctx.hoverKey);
     ctx.fn.buildChrome();
     ctx.fn.trace(ctx.selected);
     ctx.fn.renderInspector();
@@ -2506,6 +2556,8 @@
       root,
       els,
       onSelect: opts.onSelect,
+      onHoverKey: opts.onHoverKey,
+      hoverKey: null,
       notes: opts.notes && opts.notes.length ? opts.notes : model.notes ?? [],
       nodes: new Map(model.nodes.map((n) => [n.id, n])),
       links: model.links,
@@ -2548,6 +2600,7 @@
     style.textContent = stateCss(model.states);
     install(ctx);
     install2(ctx);
+    installBars(ctx);
     install3(ctx);
     install4(ctx);
     install5(ctx);
@@ -2594,6 +2647,10 @@
         ctx.fn.fit(animate);
       },
       select: (id) => ctx.fn.select(id),
+      highlightKey: (key) => {
+        ctx.hoverKey = key;
+        markKey(ctx.els.world, key);
+      },
       selected: () => ctx.selected,
       mode: () => ctx.mode,
       setMode: (id) => ctx.fn.setMode(id),
@@ -2619,7 +2676,7 @@
         const changes = diffModels(ctx.model, prepared);
         const saved = { view: { ...ctx.view }, mode: ctx.mode, selected: ctx.selected, inspectorOpen: els.inspector.classList.contains("open"), query: ctx.query, hops: ctx.hops, filter: ctx.filter, collapsed: new Set(ctx.collapsed), knownGroups: new Set(ctx.model.nodes.filter((n) => n.kind === "group").map((n) => n.id)), playback: playback.playback() };
         api.destroy();
-        const replacement = mount(root, prepared, { notes: opts.notes, onSelect: opts.onSelect, restore: saved });
+        const replacement = mount(root, prepared, { notes: opts.notes, onSelect: opts.onSelect, onHoverKey: opts.onHoverKey, restore: saved });
         notifySelection(saved.selected, replacement.selected(), opts.onSelect);
         Object.assign(api, replacement);
         window.FlowStudio = api;

package/bundles/antigravity-plugin/skills/flow-studio/templates/flow-studio.css

@@ -184,6 +184,11 @@
   .node .metric-badge i { display:block; height:2px; position:absolute; bottom:0; left:0; background:var(--accent); }
   .node .s.has-spark { padding-right:60px; }
   .node .spark { position:absolute; right:6px; bottom:4px; overflow:visible; }
+  .node svg.bars { position:absolute; left:10px; right:10px; bottom:6px; width:calc(100% - 20px); height:22px; overflow:visible; }
+  .node svg.bars rect { fill:var(--muted); opacity:.6; }
+  .node svg.bars rect.last { fill:var(--accent); opacity:1; }
+  .node svg.bars rect.low, .node svg.bars rect.miss { fill:var(--crit); opacity:1; }
+  .node svg.bars rect[data-hl="true"] { stroke:var(--fg); stroke-width:1.5px; vector-effect:non-scaling-stroke; opacity:1; }
   .node.gateway .metric-badge { position:absolute; right:9px; top:18px; }
   .node.gateway:has(.metric-badge) .gw-title, .node.gateway.has-metrics .gw-title { width:45%; margin-right:42px; }
   .node .spark polyline, .metrics polyline { fill:none; stroke:var(--accent); stroke-width:1.5; }

package/bundles/antigravity-plugin/skills/flow-studio/templates/flow-studio.lib.mjs

@@ -69,6 +69,8 @@ function validateModel(input) {
     const metric = n.metrics;
     const invalidSeries = metric?.series !== void 0 && (!Array.isArray(metric.series) || metric.series.length > 60 || metric.series.some((v) => !Number.isFinite(v)));
     if (metric !== void 0 && (!metric || !Number.isFinite(metric.value) || metric.max != null && !Number.isFinite(metric.max) || invalidSeries)) add("error", "metric-invalid", w, "Metrics need finite values and at most 60 finite series points.");
+    const badBars = n.bars !== void 0 && (!Array.isArray(n.bars) || n.bars.length > 120 || n.bars.some((b) => !b || typeof b.key !== "string" || b.value !== null && (typeof b.value !== "number" || !Number.isFinite(b.value) || b.value < 0)));
+    if (badBars) add("error", "bars-invalid", w, "Bars need a list of at most 120 items, each with a string key and a finite, non-negative value or null.");
     if (n.sla !== void 0 && (!Number.isFinite(n.sla) || n.sla <= 0)) add("error", "sla-invalid", w, "SLA must be a positive finite number of seconds.");
   }
   for (const n of nodes) {
@@ -749,6 +751,7 @@ function on(ctx, target, type, fn, opts) {
 
 // src/layout.ts
 var DEFAULTS = { pitch: 62, top: 64, gap: 34, padX: 24, visible: () => true };
+var BARS_EXTRA = 26;
 var LANE_PAD_TOP = 38;
 var LANE_PAD_BOTTOM = 14;
 function computeGeometry(m, opt = {}) {
@@ -762,7 +765,7 @@ function computeGeometry(m, opt = {}) {
   const world = { w: Math.max(1, x - o.gap + o.padX), h: 1 };
   const nodes = {};
   for (const n of m.nodes) {
-    const h = NODE_HEIGHT[n.kind] ?? 54;
+    const h = (NODE_HEIGHT[n.kind] ?? 54) + (n.bars?.length ? BARS_EXTRA : 0);
     if (m.layout === "free") {
       nodes[n.id] = { id: n.id, x: n.x ?? 0, y: n.y ?? 0, w: n.w ?? 190, h: n.h ?? h };
       continue;
@@ -884,6 +887,47 @@ function sparkline(metric, width = 56, height = 12) {
   return `<svg class="spark" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" aria-hidden="true"><polyline points="${points}"/></svg>`;
 }
 
+// src/bars.ts
+var BAR_UNIT = 4;
+function barsHtml(bars, height = 22) {
+  if (!bars || bars.length === 0) return "";
+  const width = bars.length * BAR_UNIT;
+  const max = Math.max(1, ...bars.map((b) => b.value ?? 0));
+  const lastWithData = bars.map((b) => b.value !== null).lastIndexOf(true);
+  const rects = bars.map((b, i) => {
+    const x = i * BAR_UNIT;
+    const w = BAR_UNIT - 1;
+    const label = esc(b.label ?? (b.value === null ? `${b.key}: no data` : `${b.key}: ${b.value}`));
+    if (b.value === null) {
+      return `<rect class="miss" data-key="${esc(b.key)}" x="${x}" y="${height - 4}" width="${w}" height="4"><title>${label}</title></rect>`;
+    }
+    const h = Math.max(1, b.value / max * (height - 5));
+    const cls = b.kind === "low" ? "low" : i === lastWithData ? "last" : "";
+    return `<rect${cls ? ` class="${cls}"` : ""} data-key="${esc(b.key)}" x="${x}" y="${height - h}" width="${w}" height="${h}"><title>${label}</title></rect>`;
+  });
+  const first = esc(bars[0].key), last = esc(bars[bars.length - 1].key);
+  return `<svg class="bars" viewBox="0 0 ${width} ${height}" preserveAspectRatio="none" role="img" aria-label="Bars, ${first} to ${last}">${rects.join("")}</svg>`;
+}
+function markKey(root, key) {
+  for (const r of Array.from(root.querySelectorAll("rect[data-key]"))) {
+    if (key !== null && r.getAttribute("data-key") === key) r.setAttribute("data-hl", "true");
+    else r.removeAttribute("data-hl");
+  }
+}
+function installBars(ctx) {
+  const set = (key) => {
+    if (ctx.hoverKey === key) return;
+    ctx.hoverKey = key;
+    markKey(ctx.els.world, key);
+    ctx.onHoverKey?.(key);
+  };
+  on(ctx, ctx.els.world, "mouseover", (e) => {
+    const bar = e.target?.closest?.("rect[data-key]");
+    set(bar ? bar.getAttribute("data-key") : null);
+  });
+  on(ctx, ctx.els.world, "mouseleave", () => set(null));
+}
+
 // src/render.ts
 function loopRoute(ctx, fromId, toId, from, to, channel) {
   const detourFor = (end, other) => {
@@ -920,7 +964,7 @@ function nodeHtml(ctx, n) {
   const arrow = n.kind === "chip" ? '<span aria-hidden="true">\u2191 </span>' : "";
   const lead = showWord ? `<b class="ev st-${cssId(sid)}">${esc(word)}</b> \xB7 ` : "";
   const fold = n.kind === "group" && n.contains?.length ? `<span class="fold">\u25B8 ${n.contains.length}</span>` : "";
-  return `<div class="t"><span class="newdot" title="Added in this view"></span><span class="name">${arrow}${esc(n.title)}</span>${fold}${badge}</div><div class="s${spark ? " has-spark" : ""}" title="${esc(sub)}">${lead}${esc(sub)}</div>${spark}${bar}${improved}${upgrade}`;
+  return `<div class="t"><span class="newdot" title="Added in this view"></span><span class="name">${arrow}${esc(n.title)}</span>${fold}${badge}</div><div class="s${spark ? " has-spark" : ""}" title="${esc(sub)}">${lead}${esc(sub)}</div>${spark}${barsHtml(n.bars)}${bar}${improved}${upgrade}`;
 }
 function build(ctx) {
   const { model, els } = ctx;
@@ -955,7 +999,7 @@ function build(ctx) {
   for (const n of model.nodes) {
     const p = ctx.geom.nodes[n.id];
     if (!p) continue;
-    const d = el("div", "node" + (n.kind === "chip" ? " ref" : "") + ((n.colSpan ?? 1) > 1 ? " wide" : ""));
+    const d = el("div", "node" + (n.kind === "chip" ? " ref" : "") + ((n.colSpan ?? 1) > 1 ? " wide" : "") + (n.bars?.length ? " has-bars" : ""));
     d.id = "n_" + n.id;
     d.tabIndex = 0;
     d.setAttribute("role", "button");
@@ -1090,6 +1134,7 @@ function paint(ctx, fromSwitch = false) {
       d.style.height = r.h + "px";
     }
   }
+  markKey(ctx.els.world, ctx.hoverKey);
   ctx.fn.buildChrome();
   ctx.fn.trace(ctx.selected);
   ctx.fn.renderInspector();
@@ -2310,6 +2355,8 @@ function mount(root, model, opts = {}) {
     root,
     els,
     onSelect: opts.onSelect,
+    onHoverKey: opts.onHoverKey,
+    hoverKey: null,
     notes: opts.notes && opts.notes.length ? opts.notes : model.notes ?? [],
     nodes: new Map(model.nodes.map((n) => [n.id, n])),
     links: model.links,
@@ -2352,6 +2399,7 @@ function mount(root, model, opts = {}) {
   style.textContent = stateCss(model.states);
   install(ctx);
   install2(ctx);
+  installBars(ctx);
   install3(ctx);
   install4(ctx);
   install5(ctx);
@@ -2398,6 +2446,10 @@ function mount(root, model, opts = {}) {
       ctx.fn.fit(animate);
     },
     select: (id) => ctx.fn.select(id),
+    highlightKey: (key) => {
+      ctx.hoverKey = key;
+      markKey(ctx.els.world, key);
+    },
     selected: () => ctx.selected,
     mode: () => ctx.mode,
     setMode: (id) => ctx.fn.setMode(id),
@@ -2423,7 +2475,7 @@ function mount(root, model, opts = {}) {
       const changes = diffModels(ctx.model, prepared);
       const saved = { view: { ...ctx.view }, mode: ctx.mode, selected: ctx.selected, inspectorOpen: els.inspector.classList.contains("open"), query: ctx.query, hops: ctx.hops, filter: ctx.filter, collapsed: new Set(ctx.collapsed), knownGroups: new Set(ctx.model.nodes.filter((n) => n.kind === "group").map((n) => n.id)), playback: playback.playback() };
       api.destroy();
-      const replacement = mount(root, prepared, { notes: opts.notes, onSelect: opts.onSelect, restore: saved });
+      const replacement = mount(root, prepared, { notes: opts.notes, onSelect: opts.onSelect, onHoverKey: opts.onHoverKey, restore: saved });
       notifySelection(saved.selected, replacement.selected(), opts.onSelect);
       Object.assign(api, replacement);
       window.FlowStudio = api;

package/bundles/antigravity-plugin-extras/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "caddis-extras",
-  "version": "1.3.41",
+  "version": "1.3.42",
   "description": "caddis-extras — the long-tail skills for the Antigravity (agy) caddis plugin; install alongside caddis for the full set."
 }

package/bundles/antigravity-plugin-extras/skills/agent-orchestration/SKILL.md

@@ -649,3 +649,41 @@ The methodology in this document was extracted from a real multi-agent UI-polish
 | Debug | 7 issues catalogued (A–G) | Fix-up plan created |
 
 This end-to-end cycle took **~10 sessions** with full artefact trail and zero rework of fundamental design decisions.
+
+
+---
+
+## agy as an implementer: what was measured (2026-10-08)
+
+A 17-hour run with 14 lanes used agy (Antigravity) as the main implementer. Details: `.caddis/kb/agy-headless-implementer-limits.md` in the caddis source repo. Read the rule first, then the evidence.
+
+**Rule:** send agy only small, exact, mechanical cards, test fixes and CI watching. Send design-fidelity work, cross-file refactors and judgment to Codex or Claude. Give Opus only short contract-sized tasks.
+
+**Why (measured):**
+- On that machine only the Flash models worked. `gemini-3.1-pro-high` failed with "not supported in the selected location".
+- Small exact cards: 112 of 114 passed. A card to port an app shell from screenshots ran 40 minutes and changed one icon file.
+- In `--print` mode agy started the full test suite as a background task and waited for a notification that never came (35 to 40 minutes lost, twice).
+- On narrow gates it invented statuses, counts and names. 11 of 14 lanes needed up to 3 review rounds.
+
+### The agy card template
+
+Every card that goes to agy has these sections. A card without them is not ready.
+
+1. `## Goal`: one sentence, one component or one page.
+2. `## Files`: a bullet list of every file the card may touch. The gate rejects any change outside it.
+3. `## Tests first`: the failing tests to write before the code, and the one targeted command that runs them.
+4. `## Rules for agy` (copy this block as it is):
+   - Edit first. Run foreground commands only.
+   - Never start a background task. Never wait for a notification.
+   - Never run the full test suite. The orchestrator gate runs it.
+   - No invented data: no made-up statuses, counts, names or sign-offs. If a fact is missing, say so in the card result.
+   - No fake controls. Do not remove a feature to make a test pass.
+   - Codes go through the shared formatter.
+5. `## Done when`: the exact observable result, and "report what you changed and what you could not do".
+
+### Orchestrator rules from the same run
+
+- The gate runs the full suite, requires that a NEW commit exists, and stages only source folders.
+- Restore known-noisy files (CRLF snapshot rewrites, screenshots) before checking for changes.
+- Do not let Codex `-s workspace-write` run builds. Files it creates are owned by a sandbox user and can block worktree removal.
+- Do not run `caddis-push` or `caddis update` while any `agy.exe` runs. The release now refuses or skips in that case.

package/bundles/codex/.codex/skills/frontend/flow-studio/SKILL.md

@@ -70,7 +70,9 @@ In either route, derive node and link IDs from immutable business keys. Preserve
 8. **Short titles**: titles fit one line at column width. Long descriptions belong in subtitles or member lists.
 9. **Fixed node dimensions**: node kinds use fixed box sizes so font rendering does not shift layout.
 10. **Reduced motion**: removes all animations while preserving static borders and status glows.
-11. **Thin links, dotted canvas**: links are hairlines (about 0.8 px, with a 6 px arrowhead) and the canvas background is faint dots, not a grid. Both come from tokens (`--edge-w`, `--dot`, ...), so an app can change them with one CSS line; see `references/design-language.md`.
+11. **The lane is the owner**: a lane is the app, team or system that owns its row. Never add a column that repeats the owner (an "Apps" or "Owner" column); it adds a block between the real stages and the pages and says nothing new.
+12. **Draw a shared node once**: when several rows use the same database, job or table, draw one node, centre it on the rows it serves, and link it to each node downstream. A chip (`kind: "chip"` with `ref`) is only for a node that lives in another lane, never a copy inside the same lane.
+13. **Thin links, dotted canvas**: links are hairlines (about 0.8 px, with a 6 px arrowhead) and the canvas background is faint dots, not a grid. Both come from tokens (`--edge-w`, `--dot`, ...), so an app can change them with one CSS line; see `references/design-language.md`.
 
 ## Model summary
 
@@ -80,7 +82,7 @@ columns [{id, title, short?, width, phase?, continues?}]              stages, le
 lanes   [{id, title, badge?, badgeTone?, note?, gap?}]    rows; gap true = dashed amber lane
 states  {id: {word, tone, border, edge, motion, bucket}}  tone: ok|warn|crit|info|muted|accent; bucket: good|neutral|gap
 nodes   [{id, kind, lane?, col?, colSpan?, row?, x?, y?, w?, h?, state, title, subtitle?, members?, weight?,
-          ref?, upgrade?, contains?, collapsed?, stateIn?, visibleIn?, sla?, metrics?}]
+          ref?, upgrade?, contains?, collapsed?, stateIn?, visibleIn?, sla?, metrics?, bars?}]
 links   [{id, from, to, state, kind?, label?, stateIn?, visibleIn?}]   kind: forward | loop-back
 views   [{id, label, default?}]                           first view serves as baseline
 inspector {relations [up to 3], actions [{id, label, dir, staleText}]}

package/bundles/codex/.codex/skills/frontend/flow-studio/model.schema.json

@@ -75,7 +75,10 @@
           "sla": { "type": "number", "exclusiveMinimum": 0, "description": "Target service level agreement in seconds" },
           "metrics": { "type": "object", "required": ["value"], "additionalProperties": false,
             "properties": { "value": { "type": "number" }, "max": { "type": ["number", "null"], "description": "Upper bound for the badge fill bar; null means there is no maximum" }, "unit": { "type": "string" }, "label": { "type": "string" },
-              "series": { "type": "array", "maxItems": 60, "items": { "type": "number" } } } }
+              "series": { "type": "array", "maxItems": 60, "items": { "type": "number" } } } },
+          "bars": { "type": "array", "maxItems": 120, "description": "A small bar chart on the node, one bar per key. A null value is a missing key (a red tick, never zero). Hovering a bar marks the same key on every chart.",
+            "items": { "type": "object", "required": ["key", "value"], "additionalProperties": false,
+              "properties": { "key": { "type": "string" }, "value": { "type": ["number", "null"], "minimum": 0 }, "kind": { "enum": ["low"] }, "label": { "type": "string" } } } }
         }
       }
     },

package/bundles/codex/.codex/skills/frontend/flow-studio/react/FlowStudioView.test.tsx

@@ -7,15 +7,17 @@ const lifecycle = vi.hoisted(() => ({
   alive: 0, updates: [] as Model[], mounts: 0, listenerCount: 0,
   notes: [] as (NoteDef[] | undefined)[],
   onSelect: undefined as ((id: string | null) => void) | undefined,
+  onHoverKey: undefined as ((key: string | null) => void) | undefined,
 }));
 vi.mock('../templates/flow-studio.lib.mjs', () => ({
   SHELL_BODY_HTML: '<div id="viewport"></div>',
-  mount: (_root: ParentNode, _model: Model, options: { notes?: NoteDef[]; onSelect?: (id: string | null) => void }) => {
+  mount: (_root: ParentNode, _model: Model, options: { notes?: NoteDef[]; onSelect?: (id: string | null) => void; onHoverKey?: (key: string | null) => void }) => {
     lifecycle.mounts++;
     lifecycle.alive++;
     lifecycle.listenerCount++;
     lifecycle.notes.push(options.notes);
     lifecycle.onSelect = options.onSelect;
+    lifecycle.onHoverKey = options.onHoverKey;
     return {
       update: (model: Model) => { lifecycle.updates.push(model); return { ok: true, issues: [] }; },
       destroy: () => { lifecycle.alive--; lifecycle.listenerCount--; },
@@ -56,6 +58,21 @@ describe('FlowStudioView', () => {
     expect(globals.flowStudioMount).toBe(previousMount);
   });
 
+  it('forwards the hovered bar key to the latest onHoverKey, without remounting', () => {
+    lifecycle.mounts = 0;
+    const first = vi.fn();
+    const second = vi.fn();
+    const rendered = render(<FlowStudioView model={model} onHoverKey={first} />);
+    lifecycle.onHoverKey?.('2026-09-02');
+    expect(first).toHaveBeenCalledWith('2026-09-02');
+    rendered.rerender(<FlowStudioView model={model} onHoverKey={second} />);
+    expect(lifecycle.mounts).toBe(1);
+    lifecycle.onHoverKey?.(null);
+    expect(second).toHaveBeenCalledWith(null);
+    expect(first).toHaveBeenCalledTimes(1);
+    rendered.unmount();
+  });
+
   it('passes notes at mount and ignores later notes-only changes', () => {
     lifecycle.updates = [];
     lifecycle.notes = [];

package/bundles/codex/.codex/skills/frontend/flow-studio/react/FlowStudioView.tsx

@@ -7,6 +7,8 @@ export interface FlowStudioViewProps {
   /** Read once at mount; later changes to this prop are ignored. For notes that change with the data, put them on `model.notes` — `update` forwards them. */
   notes?: NoteDef[];
   onSelect?: (id: string | null) => void;
+  /** The bar key under the pointer (a node's `bars`), or null when it leaves. The latest function is always called. */
+  onHoverKey?: (key: string | null) => void;
   className?: string;
 }
 
@@ -17,16 +19,18 @@ let mountedViews = 0;
 let previousGlobalMount: typeof mount | undefined;
 
 /** Mounts the finished engine in React. The shell stays outside React's child tree. */
-export function FlowStudioView({ model, notes, onSelect, className }: FlowStudioViewProps) {
+export function FlowStudioView({ model, notes, onSelect, onHoverKey, className }: FlowStudioViewProps) {
   const root = useRef<HTMLDivElement>(null);
   const api = useRef<FlowStudio | null>(null);
   const currentModel = useRef(model);
   const currentNotes = useRef(notes);
   const currentSelect = useRef(onSelect);
+  const currentHoverKey = useRef(onHoverKey);
   const lastModel = useRef<string | null>(null);
   currentModel.current = model;
   currentNotes.current = notes;
   currentSelect.current = onSelect;
+  currentHoverKey.current = onHoverKey;
   const modelJson = JSON.stringify(model);
 
   useEffect(() => {
@@ -36,6 +40,7 @@ export function FlowStudioView({ model, notes, onSelect, className }: FlowStudio
     const instance = mount(container, currentModel.current, {
       notes: currentNotes.current,
       onSelect: id => currentSelect.current?.(id),
+      onHoverKey: key => currentHoverKey.current?.(key),
     });
     if (mountedViews === 0) {
       previousGlobalMount = window.flowStudioMount;

package/bundles/codex/.codex/skills/frontend/flow-studio/react/README.md

@@ -22,7 +22,7 @@ function FlowPage({ state, onRetry, onSelect }: { state: State; onRetry: () => v
 }
 ```
 
-`FlowStudioView` takes a required `model` and optional `notes`, `onSelect`, and `className`. `notes` is read once at mount; later changes to the prop are ignored. For notes that change with the data, put them on the model (`model.notes`) — `update` forwards them. `onSelect` receives a stable node id or `null` when selection clears. The component mounts the engine once, sends changed models to `update`, and destroys its listeners on unmount. React StrictMode's development mount cycle is supported. Several views may be mounted at once; the engine's global mount helper stays available until the last one unmounts.
+`FlowStudioView` takes a required `model` and optional `notes`, `onSelect`, `onHoverKey`, and `className`. `notes` is read once at mount; later changes to the prop are ignored. For notes that change with the data, put them on the model (`model.notes`) — `update` forwards them. `onSelect` receives a stable node id or `null` when selection clears. `onHoverKey` receives the key of the bar under the pointer (see `bars` on a node) or `null`; call `window.FlowStudio?.highlightKey(key)` to mark a key from outside. The component mounts the engine once, sends changed models to `update`, and destroys its listeners on unmount. React StrictMode's development mount cycle is supported. Several views may be mounted at once; the engine's global mount helper stays available until the last one unmounts.
 
 ## Live data contract
 

package/bundles/codex/.codex/skills/frontend/flow-studio/references/model-schema.md

@@ -112,6 +112,7 @@ Nodes represent processing units, cards, gateways, groups, and milestones.
 | `collapsed` | `boolean` | Optional | `true` | When true, group starts collapsed hiding child nodes. |
 | `sla` | `number` | Optional | - | Target service level agreement threshold in seconds. |
 | `metrics` | `object` | Optional | - | Telemetry payload (see metrics table). |
+| `bars` | `array` | Optional | - | A small bar chart on the node, one bar per `key` (see bars table). |
 
 ---
 
@@ -129,6 +130,21 @@ Provides numerical telemetry, health bars, and sparklines.
 
 ---
 
+### `bars` items (under `nodes`)
+
+A bar chart drawn inside the node, for example rows per day. Hovering a bar marks the bars with the same `key` on
+every node, so a reader can ask "was this day bad everywhere?". The host page can follow the hover with the
+`onHoverKey` mount option and drive it with `highlightKey(key)`. At most 120 bars.
+
+| Property | Type | Required? | Default | Description |
+|---|---|---|---|---|
+| `key` | `string` | Required | - | Opaque id of the bar (a date or a step). Equal keys are linked across charts. |
+| `value` | `number` or `null` | Required | - | Bar size (finite, not negative). `null` means no data for that key: a short red tick, never a zero bar. |
+| `kind` | `string` | Optional | - | `"low"` draws the bar in the critical colour. The last bar with data is drawn in the accent colour, unless it is `low`. |
+| `label` | `string` | Optional | - | Tooltip text; defaults to `key: value`. |
+
+---
+
 ## 8. `links` array items
 
 Links represent directional data transit, dependencies, or workflow transitions.

package/bundles/codex/.codex/skills/frontend/flow-studio/references/patterns.md

@@ -21,7 +21,7 @@ You can start from these base states and adjust words to match your domain:
 
 - **Example file:** `examples/lineage.json`
 - **Scenario:** Trace data assets from ingestion sources through storage, pipelines, transformations, to consuming dashboards and applications.
-- **Typical columns:** Source, Host, Database, Pipeline, Tables, Refresher, Views, App, Dashboard.
+- **Typical columns:** Source, Host, Database, Pipeline, Tables, Refresher, Views, Dashboard. Do not add an App or Owner column: the lane is the app (ux-rules 11).
 - **Typical lanes:** Customer Portal, Order Service, Data Warehouse, Reporting Platform. A lane without documentation uses `gap: true`.
 - **Node count guideline:** 15 to 30 nodes.
 - **Recommended inspector relations:**

package/bundles/codex/.codex/skills/frontend/flow-studio/references/ux-rules.md

@@ -1,8 +1,8 @@
 # UX and design rules
 
-The 10 rules ensure flow-studio pages remain readable, informative, accessible, and fast.
+The 12 rules ensure flow-studio pages remain readable, informative, accessible, and fast.
 
-## The 10 rules
+## The 12 rules
 
 ### 1. One screen
 - **Rule statement:** The full flow fits on one screen without requiring panning in the initial default view.
@@ -66,6 +66,20 @@ The 10 rules ensure flow-studio pages remain readable, informative, accessible,
 
 ---
 
+### 11. The lane is the owner
+- **Rule statement:** A lane names the app, team or system that owns its row. No column repeats the owner.
+- **Rationale:** An "Apps" column between the real stages and the pages adds a block that says nothing new. In the estate lineage it sat between the reporting tables and the pages, and the owner asked why it was there (2026-10-09).
+- **Pre-flight checklist question:** Does any column hold one node per lane that only repeats the lane title?
+- **Common mistake & fix:** Adding an "App" column because the pattern list showed one. *Fix:* Remove the column. Link the stage that feeds a page straight to the page; a page that reads no table stands alone.
+
+### 12. Draw a shared node once
+- **Rule statement:** A database, job or table that several rows share is one node, centred on the rows it serves, with a link to each node downstream. A chip is only for a node that lives in another lane.
+- **Rationale:** Copying a shared node into every row hides that it is shared and makes the reader compare copies. In the app lineage page, a database repeated in every source row looked like several databases (2026-10-09).
+- **Pre-flight checklist question:** Does any node id appear as a chip inside the lane that already holds the real node?
+- **Common mistake & fix:** One row per source, each with its own copy of the host, database and job. *Fix:* Draw each distinct node once, place it at the mean position of its rows, move it down if it would touch its neighbour, and de-duplicate links by their two ends.
+
+---
+
 ## Pre-flight checklist for agents
 
 Before presenting a generated flow page, verify:
@@ -77,6 +91,8 @@ Before presenting a generated flow page, verify:
 6. **Accessible names:** Does every button, input, tab, and control have an `aria-label` or visible text?
 7. **Keyboard navigation:** Can a user Tab through controls and press Escape to close the inspector?
 8. **Responsive breakdown:** Does the layout degrade cleanly down to 820x900?
+9. **No owner column:** Does any column only repeat the lane's owner? Remove it (rule 11).
+10. **Shared nodes once:** Is every shared database, job or table drawn once, not copied per row (rule 12)?
 
 ---
 
@@ -88,4 +104,6 @@ Before presenting a generated flow page, verify:
 - **Text spill:** Node labels exceed card width. *Fix:* Use short titles (under 24 characters) and set `subtitle` for auxiliary metadata.
 - **Permanent side panel:** The inspector remains open on load. *Fix:* The inspector must start closed and open only on selection.
 - **Flat visual hierarchy:** Every card looks identical. *Fix:* Vary card kinds (`card`, `group`, `gateway`, `chip`) and state tones (`ok`, `warn`, `crit`, `accent`).
+- **Owner column:** A column of one node per lane that repeats the lane title. *Fix:* Remove it; the lane is the owner.
+- **Copies of a shared node:** The same database or job drawn in every row. *Fix:* Draw it once and link it to each node downstream.
 - **Unlabelled controls:** Icon buttons without text lack screen reader descriptions. *Fix:* Provide descriptive `aria-label` attributes on all buttons.