From 9d28566ea0504e1c1d57c40803f7b8a4f8771b73 Mon Sep 17 00:00:00 2001 From: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com> Date: Fri, 20 Nov 2026 00:43:31 +0000 Subject: [PATCH 1/3] Draw which agents Chock wires and how strongly each holds (RD-9) agents.json is derived from SURFACE_AGENTS, in_agent_grade, agentseam's matrix and the plugin warnings data by the same command that refreshes the README blocks. agents.mjs lays it out; render.mjs writes v2/agents.png (README palette) and v2/agents-site.png (site palette). Tests fail when the code moves an agent without the picture, when text overflows a card, or when the two renders differ. Signed-off-by: Jothi Mani Rajendran <250249270+jothimani-rajendran@users.noreply.github.com> --- changelog.d/agents-picture.md | 2 + docs/adapters/README.md | 6 + docs/assets/readme/agents.json | 275 ++++++++++++++++++++++++++ docs/assets/readme/agents.mjs | 76 +++++++ docs/assets/readme/agents_data.py | 142 +++++++++++++ docs/assets/readme/derive.py | 5 +- docs/assets/readme/render.mjs | 4 +- docs/assets/readme/v2/agents-site.png | Bin 0 -> 710280 bytes docs/assets/readme/v2/agents.png | Bin 0 -> 707917 bytes tests/test_readme_agents.py | 126 ++++++++++++ 10 files changed, 634 insertions(+), 2 deletions(-) create mode 100644 changelog.d/agents-picture.md create mode 100644 docs/assets/readme/agents.json create mode 100644 docs/assets/readme/agents.mjs create mode 100644 docs/assets/readme/agents_data.py create mode 100644 docs/assets/readme/v2/agents-site.png create mode 100644 docs/assets/readme/v2/agents.png create mode 100644 tests/test_readme_agents.py diff --git a/changelog.d/agents-picture.md b/changelog.d/agents-picture.md new file mode 100644 index 00000000..06fa43df --- /dev/null +++ b/changelog.d/agents-picture.md @@ -0,0 +1,2 @@ +- A picture of which agents Chock wires and how strongly each holds (`docs/assets/readme/v2/agents.png`, plus a + site-palette copy), derived into `agents.json` from the code; linked from `docs/adapters/README.md`. diff --git a/docs/adapters/README.md b/docs/adapters/README.md index 38fbf40d..dd5e7781 100644 --- a/docs/adapters/README.md +++ b/docs/adapters/README.md @@ -2,6 +2,12 @@ Adapters map the agent-agnostic Chock core to agent-specific surfaces. +## Which agents, and how strongly + +

One card per agent: every agent gets a CI check, a git hook and an AGENTS.md rule; the agent's own hook, where there is one, can block but fails open (Cursor can be set to fail closed); the one-plugin route is tested live, untested or absent.

+ +The picture is derived from the code by `python docs/assets/readme/derive.py readme`, so a change to an agent moves it. + ## Agent-specific entry points Most agents read `AGENTS.md` directly and get **no wrapper file at all** — Cursor, Codex, diff --git a/docs/assets/readme/agents.json b/docs/assets/readme/agents.json new file mode 100644 index 00000000..d45a248b --- /dev/null +++ b/docs/assets/readme/agents.json @@ -0,0 +1,275 @@ +{ + "source": { + "file": "SURFACE_AGENTS, in_agent_grade, agentseam matrix, plugin warnings", + "commit": "b4fa4f77985d3d1638c2c98bfc605ad632558891" + }, + "title": "Which agents, and how strongly Chock holds in each", + "columns": [ + { + "id": "ci", + "label": "CI check", + "hard": true + }, + { + "id": "git", + "label": "Git hook", + "hard": true + }, + { + "id": "hook", + "label": "Agent's own hook", + "hard": false + }, + { + "id": "plugin", + "label": "One plugin", + "hard": false + }, + { + "id": "rule", + "label": "AGENTS.md rule", + "hard": false + } + ], + "counts": { + "agents": 20, + "own_hook": 15, + "plugin_tested": 8, + "plugin_untested": 3 + }, + "summary": "All 20 get a CI check, a git hook and an AGENTS.md rule. 15 also get their own hook. As one plugin: 8 tested live, 3 untested.", + "groups": { + "tested live": "Plugin tested live", + "untested": "Plugin untested", + "": "No plugin" + }, + "legend_title": "How to read it", + "legend": [ + "Filled diamond: always refuses. Hollow: depends on the agent, or only advice the agent reads.", + "Fails open: if the agent's hook dies, the action goes ahead. The git hook and CI check still run.", + "Tested live: the plugin ran in that client. Untested: it is built, but has not run there." + ], + "footer": "Read from chock at b4fa4f7 with agentseam 0.4.1. Grades are capped by their evidence.", + "rows": [ + { + "id": "antigravity", + "name": "Antigravity CLI", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "claude", + "name": "Claude Code", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "codex", + "name": "Codex", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "copilot", + "name": "Copilot", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "cursor", + "name": "Cursor", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "enforceable", + "hook": "can block, can be set to fail closed", + "matrix_pre_tool": "enforceable", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "devin", + "name": "Devin", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "goose", + "name": "goose", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "grok", + "name": "Grok", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "tested live", + "rule": "advice the agent reads" + }, + { + "id": "factory-droid", + "name": "Factory Droid", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "untested", + "rule": "advice the agent reads" + }, + { + "id": "kimi-code", + "name": "Kimi Code", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "none", + "hook": "", + "matrix_pre_tool": "best-effort", + "plugin": "untested", + "rule": "advice the agent reads" + }, + { + "id": "openhands", + "name": "OpenHands", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "untested", + "rule": "advice the agent reads" + }, + { + "id": "aider", + "name": "Aider", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "none", + "hook": "", + "matrix_pre_tool": "none", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "cline", + "name": "Cline", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "none", + "hook": "", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "gemini", + "name": "Gemini", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "junie", + "name": "Junie", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "none", + "hook": "", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "mistral-vibe", + "name": "Mistral Vibe", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "replit", + "name": "Replit", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "none", + "hook": "", + "matrix_pre_tool": "none", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "tabnine", + "name": "Tabnine", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "vscode", + "name": "VS Code", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + }, + { + "id": "windsurf", + "name": "Windsurf", + "ci": "refuses", + "git": "refuses at commit", + "hook_grade": "best-effort", + "hook": "can block, fails open", + "matrix_pre_tool": "best-effort", + "plugin": "", + "rule": "advice the agent reads" + } + ] +} diff --git a/docs/assets/readme/agents.mjs b/docs/assets/readme/agents.mjs new file mode 100644 index 00000000..5d569fc9 --- /dev/null +++ b/docs/assets/readme/agents.mjs @@ -0,0 +1,76 @@ +// The README "which agents" picture: one card per agent, one chip per way Chock holds. Every word and count comes from agents.json (agents_data.py); positions are computed here, and `layout` reports every shape so a test can check nothing overlaps. +import { DEFAULT_PALETTE, SITE_PALETTE } from './where-chock-sits.mjs'; + +const PAD = 12, CG = 6, RG = 6, GAP = 4, PER = 6.2, CH = 16, MAXLINES = 2; +const COLS = { name: 120, ci: 78, git: 134, hook: 196, plugin: 94, rule: 158 }; +const lines = (text, width) => Math.max(1, Math.ceil((text.length * PER + 22) / width)); + +export const layout = (W) => { + const shapes = [], cells = [], bad = []; + const add = (id, x, y, w, h) => shapes.push({ id, x, y, w, h }); + const ids = ['name', ...W.columns.map((c) => c.id)]; + const xs = {}; let x = PAD; + ids.forEach((id) => { xs[id] = x; x += COLS[id] + CG; }); + const head = { y: 20 * Math.ceil((W.summary.length * 7) / 840) + 22 }; + let y = head.y + 26, last = null; + const groups = []; + W.rows.forEach((r) => { + if (r.plugin !== last) { + if (last !== null) y += 8; + const n = W.rows.filter((q) => q.plugin === r.plugin).length; + groups.push({ text: `${W.groups[r.plugin]} (${n})`, y }); + add(`group-${groups.length}`, 6, y, 300, 14); + y += 22; last = r.plugin; + } + const n = Math.max(1, ...W.columns.map((c) => (r[c.id] ? lines(r[c.id], COLS[c.id]) : 1))); + if (n > MAXLINES) bad.push([r.id, 'too many lines']); + const h = 12 + n * CH + (n > 1 ? 2 : 0); + add(`row-${r.id}`, 0, y, 840, h); + if (lines(r.name, COLS.name) > 1) bad.push([r.id, 'name-text']); + W.columns.forEach((c) => { if (r[c.id]) cells.push({ r, c, x: xs[c.id] - 2, y: y + 4, w: COLS[c.id] + 4, h: h - 8, lines: lines(r[c.id], COLS[c.id]) }); }); + r.y = y; r.h = h; + y += h + RG; + }); + const lg = y + 14; + const Ht = lg + 22 * (1 + W.legend.length) + 34; + return { shapes, cells, groups, xs, head, legendTop: lg, Ht, bad }; +}; + +// Row cards closer than their gap, cells too tall for their lines, text that does not fit a column. +export const crowded = (L) => { + const bad = [...L.bad], near = (a, b) => a.x < b.x + b.w + 2 && b.x < a.x + a.w + 2 && a.y < b.y + b.h + 2 && b.y < a.y + a.h + 2; + L.shapes.forEach((a, i) => L.shapes.slice(i + 1).forEach((b) => { if (near(a, b)) bad.push([a.id, b.id]); })); + L.cells.forEach((c, i) => L.cells.slice(i + 1).forEach((d) => { if (near({ ...c, x: c.x + 2, w: c.w - 4 }, { ...d, x: d.x + 2, w: d.w - 4 })) bad.push([c.r.id + c.c.id, d.r.id + d.c.id]); })); + L.cells.forEach((c) => { if (c.lines > MAXLINES) bad.push([c.r.id + c.c.id, 'cell-text']); }); + return bad; +}; + +export const where = (page, W, palette = DEFAULT_PALETTE) => { + const L = layout(W), bad = crowded(L); + if (bad.length) throw new Error(`figure shapes too close: ${JSON.stringify(bad)}`); + const { ink: INK, soft: SOFT, line: LINE, paper: PAPER, accent: ACCENT, grey: GREY, chip: CHIP, hollow: HOLLOW, fill: FILL } = palette; + const esc = (s) => s.replace(/&/g, '&').replace(/ `
${inner}
`; + const diamond = (x, y, hard, s = 10) => abs(x - s / 2, y - s / 2, s, s, `transform:rotate(45deg);box-sizing:border-box;border:2px solid ${hard ? ACCENT : GREY};background:${hard ? ACCENT : PAPER}`, ''); + const kinds = [...new Set(W.rows.map((r) => r.plugin))], tones = [FILL.context, FILL.subagents, FILL.tools]; + const fill = Object.fromEntries(kinds.map((k, i) => [k, tones[i]])); + const rows = W.rows.map((r) => abs(0, r.y, 840, r.h, `box-sizing:border-box;background:${fill[r.plugin]};border:1.5px solid ${LINE};border-radius:12px`, + abs(L.xs.name, 0, COLS.name, r.h, `display:flex;align-items:center;font-size:14px;font-weight:700;line-height:18px;color:${INK};white-space:nowrap`, esc(r.name)))).join(''); + const chip = (k) => abs(k.x, k.y, k.w, k.h, `box-sizing:border-box;display:flex;align-items:center;gap:4px;padding:0 5px;border-radius:${k.lines > 1 ? 10 : 999}px;background:${CHIP};font-size:12px;line-height:${CH}px;font-weight:600;color:${k.c.hard ? ACCENT : INK}`, + `${diamond(5, 5, k.c.hard)}${esc(k.r[k.c.id])}`); + const heads = W.columns.map((c) => abs(L.xs[c.id] + 4, L.head.y, COLS[c.id], 18, `font-size:12px;font-weight:700;letter-spacing:.04em;line-height:18px;color:${SOFT};white-space:nowrap`, esc(c.label))).join(''); + const groups = L.groups.map((g) => abs(6, g.y, 400, 14, `font-size:12px;font-weight:700;letter-spacing:.06em;text-transform:uppercase;color:${SOFT};white-space:nowrap`, esc(g.text))).join(''); + const legend = W.legend.map((t, i) => abs(0, L.legendTop + 22 + i * 22, 840, 18, `font-size:13px;font-weight:600;color:${SOFT};white-space:nowrap`, esc(t))).join(''); + const total = L.Ht; + return page(`
+
${esc(W.title)}
+
+${abs(0, 0, 840, L.head.y - 8, `font-size:14px;line-height:20px;color:${SOFT}`, esc(W.summary))} +${heads}${groups}${rows}${L.cells.map(chip).join('')} +
${esc(W.legend_title)}
+${legend} +
${esc(W.footer)}
+
`); +}; + +export { DEFAULT_PALETTE, SITE_PALETTE }; diff --git a/docs/assets/readme/agents_data.py b/docs/assets/readme/agents_data.py new file mode 100644 index 00000000..06b18abc --- /dev/null +++ b/docs/assets/readme/agents_data.py @@ -0,0 +1,142 @@ +"""Derive agents.json, the data behind the "Which agents, and how strongly Chock holds in each" picture. + +Every row, count and grade is read from chock's code: SURFACE_AGENTS, in_agent_grade, agentseam's matrix and +the plugin warnings data. Only display names and the plain words for a grade are written here. +""" + +from __future__ import annotations + +import json +import subprocess +from pathlib import Path + +HERE = Path(__file__).resolve().parent +OUT = HERE / "agents.json" +ROOT = HERE.parents[2] +NAMES = { + "aider": "Aider", + "antigravity": "Antigravity CLI", + "claude": "Claude Code", + "cline": "Cline", + "codex": "Codex", + "copilot": "Copilot", + "cursor": "Cursor", + "devin": "Devin", + "factory-droid": "Factory Droid", + "gemini": "Gemini", + "goose": "goose", + "grok": "Grok", + "junie": "Junie", + "kimi-code": "Kimi Code", + "mistral-vibe": "Mistral Vibe", + "openhands": "OpenHands", + "replit": "Replit", + "tabnine": "Tabnine", + "vscode": "VS Code", + "windsurf": "Windsurf", +} +PLUGIN_AGENT = {"claude-code": "claude"} +GRADE_WORDS = { + "enforced": "blocks, verified to fail closed", + "enforceable": "can block, can be set to fail closed", + "fail-to-ask": "can block, asks a person when it cannot decide", + "best-effort": "can block, fails open", + "detect": "sees it after the fact", + "none": "", +} +WORDS = { + "title": "Which agents, and how strongly Chock holds in each", + "columns": [ + ["ci", "CI check", True], + ["git", "Git hook", True], + ["hook", "Agent's own hook", False], + ["plugin", "One plugin", False], + ["rule", "AGENTS.md rule", False], + ], + "groups": {"tested live": "Plugin tested live", "untested": "Plugin untested", "": "No plugin"}, + "ci": "refuses", + "git": "refuses at commit", + "rule": "advice the agent reads", + "plugin": {"tested": "tested live", "untested": "untested"}, + "summary": "All __AGENTS__ get a CI check, a git hook and an AGENTS.md rule. __NATIVE__ also get their own hook. " + "As one plugin: __TESTED__ tested live, __UNTESTED__ untested.", + "legend_title": "How to read it", + "legend": [ + "Filled diamond: always refuses. Hollow: depends on the agent, or only advice the agent reads.", + "Fails open: if the agent's hook dies, the action goes ahead. The git hook and CI check still run.", + "Tested live: the plugin ran in that client. Untested: it is built, but has not run there.", + ], + "footer": "Read from chock at __COMMIT__ with agentseam __SEAM__. Grades are capped by their evidence.", +} + + +def _commit() -> str: + done = subprocess.run(["git", "rev-parse", "HEAD"], cwd=ROOT, capture_output=True, text=True, check=True) # noqa: S607 + return done.stdout.strip() + + +def derive(commit: str) -> dict: + """The picture's data, read from the code as it is now.""" + import agentseam # noqa: PLC0415 -- chock and agentseam are needed only to derive + from agentseam import matrix # noqa: PLC0415 + + import chock.install # noqa: PLC0415 + from chock.compile.levels import in_agent_grade # noqa: PLC0415 + from chock.compile.surfaces import SURFACE_AGENTS, Surface # noqa: PLC0415 + from chock.vendors import CHOCK_AGENT # noqa: PLC0415 + + data_dir = Path(chock.install.__file__).parent / "data" + clients = json.loads((data_dir / "install.json").read_text(encoding="utf-8"))["clients"] + rules = json.loads((data_dir / "warnings.json").read_text(encoding="utf-8"))["rules"] + untested = {c for r in rules if r["kind"] == "client" and r["says"].startswith("Untested:") for c in r["clients"]} + plugin = {PLUGIN_AGENT.get(cid, cid): "untested" if cid in untested else "tested" for cid in clients} + rows = [] + for agent, surfaces in SURFACE_AGENTS.items(): + own = next((s for s in (Surface.PRE_TOOL_USE, Surface.AGENT_HOOKS) if s in surfaces), None) + grade = in_agent_grade(agent, own.value).level if own else "none" + rows.append( + { + "id": agent, + "name": NAMES[agent], + "ci": WORDS["ci"] if Surface.CI_GATE in surfaces else "", + "git": WORDS["git"] if Surface.GIT_HOOK in surfaces else "", + "hook_grade": grade, + "hook": GRADE_WORDS[grade], + "matrix_pre_tool": matrix.enforcement_level(CHOCK_AGENT[agent], "pre_tool"), + "plugin": WORDS["plugin"].get(plugin.get(agent, ""), ""), + "rule": WORDS["rule"] if Surface.AMBIENT_RULE in surfaces else "", + } + ) + order = {"tested live": 0, "untested": 1, "": 2} + rows.sort(key=lambda r: (order[r["plugin"]], r["name"].lower())) + count = lambda key, value: sum(1 for r in rows if r[key] == value) # noqa: E731 + counts = { + "agents": len(rows), + "own_hook": sum(1 for r in rows if r["hook_grade"] != "none"), + "plugin_tested": count("plugin", "tested live"), + "plugin_untested": count("plugin", "untested"), + } + summary = WORDS["summary"] + for key, value in (("AGENTS", counts["agents"]), ("NATIVE", counts["own_hook"])): + summary = summary.replace(f"__{key}__", str(value)) + summary = summary.replace("__TESTED__", str(counts["plugin_tested"])).replace( + "__UNTESTED__", str(counts["plugin_untested"]) + ) + footer = WORDS["footer"].replace("__COMMIT__", commit[:7]).replace("__SEAM__", agentseam.__version__) + return { + "source": {"file": "SURFACE_AGENTS, in_agent_grade, agentseam matrix, plugin warnings", "commit": commit}, + "title": WORDS["title"], + "columns": [{"id": i, "label": label, "hard": hard} for i, label, hard in WORDS["columns"]], + "counts": counts, + "summary": summary, + "groups": WORDS["groups"], + "legend_title": WORDS["legend_title"], + "legend": WORDS["legend"], + "footer": footer, + "rows": rows, + } + + +def write() -> None: + """Rewrite agents.json at the current commit.""" + OUT.write_text(json.dumps(derive(_commit()), indent=2) + "\n", encoding="utf-8") diff --git a/docs/assets/readme/derive.py b/docs/assets/readme/derive.py index ff4414a6..fd124cd7 100644 --- a/docs/assets/readme/derive.py +++ b/docs/assets/readme/derive.py @@ -4,7 +4,7 @@ derive.py catalog derive.py agentseam derive.py repos (the public repo list, from repos.json) -derive.py readme (README.md's derive blocks, from data.json and chock's install and witness data) +derive.py readme (README.md's derive blocks, from data.json and chock's install and witness data, and agents.json) """ from __future__ import annotations @@ -237,6 +237,9 @@ def main(argv: list[str]) -> None: data.update(derive_agentseam(Path(argv[1]), argv[2])) elif argv[0] == "readme": README.write_text(render_readme(README.read_text(encoding="utf-8"), data), encoding="utf-8") + import agents_data # noqa: PLC0415 -- the picture's data, refreshed by the same command + + agents_data.write() return else: data.update(derive_repos()) diff --git a/docs/assets/readme/render.mjs b/docs/assets/readme/render.mjs index 29702131..352697b0 100644 --- a/docs/assets/readme/render.mjs +++ b/docs/assets/readme/render.mjs @@ -6,6 +6,7 @@ import { fileURLToPath } from 'node:url'; import path from 'node:path'; import { where, SITE_PALETTE } from './where-chock-sits.mjs'; import { where as sessionPath } from './session-path.mjs'; +import { where as agentsPicture } from './agents.mjs'; const HERE = path.dirname(fileURLToPath(import.meta.url)); const OUT = process.env.OUT_DIR || HERE; @@ -219,10 +220,11 @@ ${grid(3, 16, [[A.grades.enforced, 'matrix cells graded “enforced”: const FIGURE = JSON.parse(readFileSync(path.join(HERE, 'where-chock-sits.json'), 'utf8')); const WHERE = where(page, FIGURE), WHERE_SITE = where(page, FIGURE, SITE_PALETTE), SESSION_PATH = sessionPath(page, FIGURE); +const AGENTS = JSON.parse(readFileSync(path.join(HERE, 'agents.json'), 'utf8')), AGENTS_PNG = agentsPicture(page, AGENTS), AGENTS_SITE = agentsPicture(page, AGENTS, SITE_PALETTE); const ALL_NEW = { layers: LAYERS, quickstart: QUICKSTART, matrix: MATRIX, catalog: CATALOG, family: FAMILY, honest: HONEST }; // README v2 panels go under v2/; the titled refusal, roles and contribute PNGs at the old paths stay frozen until RW-7b. -const V2 = { 'v2/refusal': REFUSAL, 'v2/roles': ROLES, 'v2/contribute': CONTRIBUTE, 'v2/where-chock-sits': WHERE, 'v2/where-chock-sits-site': WHERE_SITE, 'v2/session-path': SESSION_PATH }; +const V2 = { 'v2/refusal': REFUSAL, 'v2/roles': ROLES, 'v2/contribute': CONTRIBUTE, 'v2/where-chock-sits': WHERE, 'v2/where-chock-sits-site': WHERE_SITE, 'v2/session-path': SESSION_PATH, 'v2/agents': AGENTS_PNG, 'v2/agents-site': AGENTS_SITE }; // 1280x640 social preview banners: the same specs as the covers, laid out for the fixed canvas. const social = ({ repo, title, sub, chips, right }) => `