@a-company/gnomon 0.0.0-stage → 8.0.2

package/gnomon-mods/.purpose

@@ -0,0 +1,143 @@
+version: "2.0"
+description: >-
+  packages/gnomon-mods - the first-party Gnomon mods (spec §12.1). They run on
+  the same mod-abi:v1 and the same `mod` sandbox profile as any other mod;
+  first-party is a trust tier derived from the packageHash pinned in the
+  kernel's FIRST_PARTY_PACKAGE_HASHES (packages/gnomon/src/kernel/manifest/install.ts),
+  never a wider ABI. Files are LF-pinned (.gitattributes) so the hash is the
+  same on every OS.
+
+components:
+  workshop-mod:
+    description: >-
+      #workshop-mod (spec §11.6, G-WSP-01; §19.1 M1.11 slice 3) -
+      packages/gnomon-mods/workshop: one view `workshop.strip` (slot sidebar,
+      append) with two zones, needs you (one cap per pending card, labelled
+      by the card kind) and working (one cap per session: hat = work type,
+      filled = Claude, outlined = local, tone hue-<0..5> = project
+      (HUES = 6, the feed's projectHue), violet only for a KNOT; bob while
+      turn.partial streams, still otherwise, `working` text pose under
+      reduced motion). S5: every cap is a Text whose `text` is the accessible
+      form and whose `cap` is the closed contracts shape {shape tall|wide|
+      floppy, hue, filled, state needs|working|idle|knot, label} (needs caps
+      carry their session's hue and a `◆ / ✕ / ! / ?` + kind label); the GUI
+      draws the hat and the Layout places the strip. model.mjs is a pure reducer
+      + render (sessions and cards bounded at 256 each); index.mjs speaks
+      mod-abi:v1 directly (no SDK import, so the pinned packageHash never
+      depends on an SDK build) and echoes MOD_ABI_ID. State comes ONLY from
+      the host's projected kernel-event feed (#mod-host feed.ts, granted by
+      the log.read capability), primed at every start with the state in force
+      (#mod-host feedBacklog: live sessions, pending cards, paused mods), so a
+      Workshop started after a session opened still counts it; a host-initiated fixture render may replay
+      input.fixtureEvents, a relayed render never can. Declared effects:
+      none beyond idle read; tier first-party; installs with
+      `gnomon mod install packages/gnomon-mods/workshop` + the root-key card.
+      Fixtures strip.json / strip-reduced.json with golden renders
+      (test/workshop-mod.test.ts, every OS).
+    tags: [mods, first-party, M1.11]
+    oracles: [G-WSP-01]
+
+  ledger-mod:
+    description: >-
+      #ledger-mod - packages/gnomon-mods/ledger, the context and budget
+      meter (mod #1 of the mods arc). Two views: `ledger.strip` (slot
+      composer.footer, append) - one line for the focused session (relay
+      input {hsid}, display only) or all sessions, `182k in · 9k out · 71%
+      cache · $0.42 · ⇣ 2 compactions (190k → 41k)` (in = fresh + cache
+      reads + cache writes; cache = the share read from cache; a local
+      session shows its token total), the budget meter (the over-permit row
+      `n of m`, else the highest budget.ladder rung `n of 100%`) and the
+      alarms (breaker open, permit denied); `ledger.sheet` (slot sidebar,
+      append) - a Table row per session plus the total, meter and alarms.
+      Tones: quiet; warn (amber) at a rung >= 75% or an over-permit row;
+      deny (vermilion) on a breaker or a denied permit; hue-<0..7> ONLY on
+      the cap glyph, never as text. Reduced motion renders the meter as Text
+      (no Progress fill at all). kit:v1 blocks only (Box, Text, Table,
+      Progress). model.mjs is a pure reducer + render (MAX_SESSIONS 256,
+      MAX_DIMENSIONS 32, every number re-clamped by count(), unknown kinds
+      ignored); index.mjs is the #workshop-mod stdio loop verbatim but for
+      the two views (no SDK import, echoes MOD_ABI_ID). State comes ONLY from
+      the #mod-host feed projection v2 (numbers only, granted by log.read);
+      a relayed render never replays fixtureEvents. requires log.read and
+      log.read:usage (Aegis M1: the usage rows reach only that grant),
+      egress none, no tools or commands; tier first-party (packageHash pinned in FIRST_PARTY_PACKAGE_HASHES). Fixtures strip, strip-reduced,
+      over-budget, breaker, compacted with golden renders
+      (test/ledger-mod.test.ts, light and dark); goldens regenerate with
+      `npm run repin:first-party` in packages/gnomon.
+    tags: [mods, first-party]
+  paradigm-context-mod:
+    description: >-
+      #paradigm-context-mod - packages/gnomon-mods/paradigm-context, Paradigm
+      Context (mod #2 of the mods arc). One view `paradigm-context.sheet`
+      (slot sidebar, append), read-only (no Button, no command, no tool): a
+      head with the project swatch (tone hue-<0..7> on the ● mark only, which
+      the GUI draws as the project's ■; the name in ink), a stale line (warn)
+      when the newest decision or lore entry is > STALE_DAYS (14) older than
+      the slice's `at`; a project with no open tasks, decisions or lore
+      shows ONE quiet line (EMPTY_LINE 'nothing yet: no tasks, decisions or
+      lore') instead of the zones; otherwise three zones, each headed by a row: the zone name
+      (Text tone head, the label style) and its {n, of} count as quiet meta
+      (`tasks` `n of m open · k high`, `decisions` `n of m`, `lore` `n of m`;
+      1.1.1, 2026-10-23) - each item a row with a FIXED type prefix
+      (`task` / `task ▲` for high, `decision`, `lore <type>`), the id (a
+      decision's date its own word after it, so the GUI truncates the id and
+      never the date), then the title “quoted” (inner curly quotes flattened), every
+      part tone quiet, so a repo title never supplies a status glyph (Aegis
+      L2) - then the symbols touched as chips (tone chip,
+      mono ink, never a hue), and a skipped line (malformed / refused /
+      secret counts). Titles cut to 80 code points. Its ONLY input is the
+      host-composed `input.paradigm` (#mod-host K1 paradigm-slice:v1 of the
+      focused LIVE session's repo, joined server-side from {focus:{hsid}},
+      K3); model.mjs re-validates and bounds it (ids, dates, tokens, symbol
+      shape, counts). requires paradigm.read:summary only (no log.read, so
+      no feed), egress none (refused with that capability). index.mjs is the
+      #ledger-mod stdio loop minus the feed (no SDK import, echoes
+      MOD_ABI_ID). Fixtures empty, full, full-dark, stale, unfocused with
+      goldens (test/paradigm-context-mod.test.ts, light and dark);
+      regenerate with `npm run repin:first-party`; tier first-party once
+      pinned in FIRST_PARTY_PACKAGE_HASHES (1.1.1 sha256:22bab5bf…, repinned 2026-10-23 for the fitted zone heads and the one-line empty state).
+    tags: [mods, first-party]
+  neurons-mod:
+    description: >-
+      #neurons-mod - packages/gnomon-mods/neurons-brain (the Desk, TD-2026-10-20-812
+      slice S2), mod name `neurons-brain`, because `neurons` is a kernel
+      namespace token (the §9.1 `neurons.event` kind) and the validator refuses
+      it as a mod name. View-less, with no process of its own (no index.mjs; the
+      validator needs none). It declares one provides.mcp server `gnomon-neurons-brain`
+      (generic default `neurons mcp`, a placeholder that is not absolute, so it
+      fails closed until the user sets an absolute command through the
+      per-user override; config {command, args, env [NEURONS_VAULT], the
+      upstream server's own variable}; no personal path is committed), three
+      offers (search-the-brain diverge → neuron_search, capture-a-learning
+      synthesize → source_note, capture-a-decision commit → neuron_write; each
+      offer's contextIn comes from CONTEXT_SOURCES, and the two capture
+      restraints, like the playbook, require showing the exact text and waiting
+      for the human to confirm or edit it, flagging fetched, tool-output or
+      unverified content), and one skill, skills/neurons-desk/SKILL.md, a
+      playbook that falls back to plain suggestions outside Gnomon. Every
+      ```offer example in it resolves to a declared offer (tested). requires egress none,
+      no capability. Fixtures are model replies with one ```offer block, and
+      their goldens come from scripts/offer-golden.mjs (offerBlockOf plus the
+      manifest's offer-spec), with one undeclared-kind negative. Tier
+      first-party (packageHash pinned in FIRST_PARTY_PACKAGE_HASHES); tested
+      in test/neurons-mod.test.ts.
+    tags: [mods, first-party, desk]
+  constellation-mod:
+    description: >-
+      #constellation-mod - packages/gnomon-mods/constellation (the Desk,
+      TD-2026-10-20-812 slice S2). View-less, with no process of its own. It
+      declares one provides.mcp server `gnomon-constellation` (placeholder
+      default `constellation-mcp`, never launched: it is not absolute, so it
+      fails closed until the user sets an absolute node and
+      `<checkout>/mcp/server.ts` through the per-user override; config
+      {command, args, env [CONSTELLATION_NO_AUTOSTART]}), two offers
+      (map-the-idea diverge → apply, contextIn [recent-messages];
+      summarize-the-session synthesize → summarize; the automation offer is
+      deferred to O2 behind a confirmation and a disabled save, Aegis H1), and
+      one skill, skills/constellation-desk/SKILL.md, a playbook that falls back
+      to plain suggestions outside Gnomon. requires egress none, no capability.
+      The L3 "sky" world is not declared yet, because manifest:v1 has no world
+      field. Offer fixtures plus goldens include a two-blocks negative. Tier
+      first-party (packageHash pinned); tested in
+      test/constellation-mod.test.ts.
+    tags: [mods, first-party, desk]

package/gnomon-mods/constellation/README.md

@@ -0,0 +1,27 @@
+# gnomon.constellation (first-party Gnomon mod)
+
+Constellation puts the user's local idea map on the Desk. It has no view and no process of its own. It declares the Constellation MCP server (the kernel names it `gm_gnomon_constellation`), two offers and a playbook skill. Its mod id is `gnomon.constellation` (manifest: 2, publisher `gnomon`, slice S0b); that is what the model writes in an offer block.
+
+- **map-the-idea** (diverge, `apply`): lay the ideas in play out as stars and beams on the active session's map.
+- **summarize-the-session** (synthesize, `summarize`): read the session outline, then save a short written summary.
+
+Each offer's restraint text says when not to offer it. The playbook is `skills/constellation-desk/SKILL.md`. Outside Gnomon it falls back to plain one-sentence suggestions. An automation offer is deferred to O2, where it will sit behind a confirmation and a disabled save.
+
+It requires no capability and lists no egress. The MCP server talks only to the Constellation app on loopback.
+
+A Constellation "sky" world is planned (L3: worlds are first-party only, for now). It is not declared here yet, because manifest:v1 has no world field and its validator refuses unknown keys.
+
+## Install
+
+```
+gnomon mod install packages/gnomon-mods/constellation
+```
+
+Approve the card in the GUI. The manifest's default command, `constellation-mcp`, is a placeholder that is never launched. It is not an absolute path, so the server fails closed until you set a per-user override. The manifest declares `config: {command, args, env: [CONSTELLATION_NO_AUTOSTART]}`. Set the override with `gnomon mod config` (slice S1):
+
+- the command: the absolute path of your node (`which node`), Node 24 or later
+- the args: `<your a-constellation checkout>/mcp/server.ts`
+
+An override command must be an absolute path; a bare `node` is refused. The override belongs to you and is never committed.
+
+The packageHash is pinned in the kernel's first-party list, so editing any file here needs a new pin. Run `npm run repin:first-party` in packages/gnomon; it also regenerates the offer goldens in `fixtures/`.

package/gnomon-mods/constellation/fixtures/map-the-idea.golden.json

@@ -0,0 +1,19 @@
+{
+  "offer": {
+    "mod": "gnomon.constellation",
+    "kind": "map-the-idea",
+    "question": "Want me to map these four options on the Constellation board?"
+  },
+  "body": "There are four ways to split the router: by phase, by mod, by context source, or a hybrid. Each trades latency for clarity differently.",
+  "shown": {
+    "mod": "gnomon.constellation",
+    "kind": "map-the-idea",
+    "phase": "diverge",
+    "title": "Map this on the board",
+    "contextIn": [
+      "recent-messages"
+    ],
+    "question": "Want me to map these four options on the Constellation board?",
+    "handoffTool": "apply"
+  }
+}

package/gnomon-mods/constellation/fixtures/map-the-idea.json

@@ -0,0 +1,3 @@
+{
+  "reply": "There are four ways to split the router: by phase, by mod, by context source, or a hybrid. Each trades latency for clarity differently.\n\n```offer\n{\"mod\":\"gnomon.constellation\",\"kind\":\"map-the-idea\",\"question\":\"Want me to map these four options on the Constellation board?\"}\n```\n"
+}

package/gnomon-mods/constellation/fixtures/summarize-the-session.golden.json

@@ -0,0 +1,20 @@
+{
+  "offer": {
+    "mod": "gnomon.constellation",
+    "kind": "summarize-the-session",
+    "question": "Shall I write the session summary to Constellation?"
+  },
+  "body": "That closes the migration: the schema moved, the backfill ran clean and the old table is gone.",
+  "shown": {
+    "mod": "gnomon.constellation",
+    "kind": "summarize-the-session",
+    "phase": "synthesize",
+    "title": "Write the session summary",
+    "contextIn": [
+      "session-summary",
+      "recent-messages"
+    ],
+    "question": "Shall I write the session summary to Constellation?",
+    "handoffTool": "summarize"
+  }
+}

package/gnomon-mods/constellation/fixtures/summarize-the-session.json

@@ -0,0 +1,3 @@
+{
+  "reply": "That closes the migration: the schema moved, the backfill ran clean and the old table is gone.\n\n```offer\n{\"mod\":\"gnomon.constellation\",\"kind\":\"summarize-the-session\",\"question\":\"Shall I write the session summary to Constellation?\"}\n```\n"
+}

package/gnomon-mods/constellation/fixtures/two-blocks.golden.json

@@ -0,0 +1,4 @@
+{
+  "offer": null,
+  "shown": null
+}

package/gnomon-mods/constellation/fixtures/two-blocks.json

@@ -0,0 +1,3 @@
+{
+  "reply": "Two ideas.\n\n```offer\n{\"mod\":\"gnomon.constellation\",\"kind\":\"map-the-idea\",\"question\":\"Map it?\"}\n```\n\n```offer\n{\"mod\":\"gnomon.constellation\",\"kind\":\"automate-this\",\"question\":\"Automate it?\"}\n```\n"
+}

package/gnomon-mods/constellation/gnomon-manifest.json

@@ -0,0 +1,68 @@
+{
+  "manifest": 2,
+  "kind": "mod",
+  "publisher": "gnomon",
+  "name": "constellation",
+  "version": "1.1.0",
+  "abi": "mod-abi:v1",
+  "description": "Constellation: the idea map as a Desk mod. Offers to map an idea on the board and to summarize the session, through the local Constellation MCP server.",
+  "provides": {
+    "mcp": [
+      {
+        "command": "constellation-mcp",
+        "args": [],
+        "config": {
+          "command": true,
+          "args": true,
+          "env": [
+            "CONSTELLATION_NO_AUTOSTART"
+          ]
+        }
+      }
+    ],
+    "offers": [
+      {
+        "kind": "map-the-idea",
+        "phase": "diverge",
+        "title": "Map this on the board",
+        "summary": "Lay the ideas in play out as stars and beams on the Constellation map of the active session, so the options and their links are visible side by side.",
+        "contextIn": [
+          "recent-messages"
+        ],
+        "resultOut": "map-ops",
+        "reach": "mcp",
+        "handoffTool": "apply",
+        "related": [
+          "summarize-the-session"
+        ],
+        "restraint": "Not for a single linear task, a quick fix or a yes/no question; only when several ideas or options are on the table."
+      },
+      {
+        "kind": "summarize-the-session",
+        "phase": "synthesize",
+        "title": "Write the session summary",
+        "summary": "Read the session outline, then save a short written summary of what changed and what was decided to the Constellation session.",
+        "contextIn": [
+          "session-summary",
+          "recent-messages"
+        ],
+        "resultOut": "session-summary",
+        "reach": "mcp",
+        "handoffTool": "summarize",
+        "related": [
+          "map-the-idea"
+        ],
+        "restraint": "Only at a natural stopping point with real progress; not mid-task and not twice in one stretch of work."
+      }
+    ],
+    "skills": [
+      {
+        "name": "constellation-desk",
+        "path": "skills/constellation-desk/SKILL.md"
+      }
+    ]
+  },
+  "requires": {
+    "egress": "none"
+  }
+}

package/gnomon-mods/constellation/skills/constellation-desk/SKILL.md

@@ -0,0 +1,35 @@
+---
+name: constellation-desk
+description: When to offer the Constellation idea map during a conversation - map ideas on the board and write the session summary. Works inside Gnomon as Desk offers and anywhere else as plain suggestions.
+---
+
+# Constellation on the Desk
+
+Constellation is the user's local idea map: Spaces hold sessions, and each session holds a map of stars and beams. This playbook says when to offer it. It never acts on its own: every step is an offer the human accepts or declines.
+
+## The offers
+
+| Phase | Offer | Tool | Offer it when |
+|---|---|---|---|
+| diverge | `map-the-idea` | `apply` | Several ideas or options are on the table and seeing them side by side would help. Read the map with `get` first. |
+| synthesize | `summarize-the-session` | `summarize` | The work reached a natural stopping point with real progress. Read `summary` (the outline) before writing one. |
+
+## When NOT to offer
+
+- A single linear task, a quick fix, or a yes/no question.
+- Mid-task, or when a summary was already written in this stretch of work.
+- After the human said "not now" to Constellation in this conversation: stay quiet for the rest of it.
+
+## Inside Gnomon
+
+When an offer fits, end that reply with at most one offer block (never more than one per reply across all mods). Name this mod and one of the kinds above, and ask one short question:
+
+```offer
+{"mod": "gnomon.constellation", "kind": "map-the-idea", "question": "Want me to map these options on the Constellation board?"}
+```
+
+The kernel shows it on the Desk. Call the tool only after the human opens it.
+
+## Outside Gnomon
+
+There is no Desk. Make the same offer as one plain sentence at the end of the reply ("I can lay these options out on your Constellation map, want me to?") and call the tool only if the user says yes. If the Constellation MCP server is not connected, mention it once and move on.

package/gnomon-mods/ledger/README.md

@@ -0,0 +1,10 @@
+# ledger (first-party Gnomon mod)
+
+The Ledger is a context and budget meter with two views.
+
+- **ledger.strip** (`composer.footer`): one line for the focused session, for example `182k in · 9k out · 71% cache · $0.42 · ⇣ 2 compactions (190k → 41k)`. It then shows the budget meter as `n of m` and any breaker or denied permit. The cap at the start carries the session's project hue (never as text). The line turns amber at a warning rung or an over-permit row, and vermilion when a breaker opens or a permit is denied. With reduced motion the meter is plain text (no fill element at all).
+- **ledger.sheet** (`sidebar`): one row per session (in, out, cache share, cost, compactions), the total, then the same meter and alarms.
+
+`in` counts every input token (fresh plus cache reads and writes), and `cache` is the share served from the cache. The split and the cost come from Claude's `result.usage`. A local session shows its token total only.
+
+Every number comes from the kernel's numbers-only feed (`#mod-host` projection v2, granted by `log.read`). No text, path or tool input reaches the mod. Install it with `gnomon mod install packages/gnomon-mods/ledger`, then approve the card in the GUI. Its packageHash is pinned in the kernel's first-party list, so editing any file here needs a new pin (`npm run repin:first-party` in packages/gnomon).

package/gnomon-mods/ledger/fixtures/breaker.golden.json

@@ -0,0 +1,28 @@
+{
+  "schemaVersion": "display-block:v1",
+  "type": "Box",
+  "title": "Ledger · this session",
+  "direction": "row",
+  "children": [
+    {
+      "type": "Text",
+      "text": "●",
+      "tone": "hue-2"
+    },
+    {
+      "type": "Text",
+      "text": "182k in · 9k out · 71% cache · $0.42 · ⇣ 2 compactions (190k → 41k)",
+      "tone": "deny"
+    },
+    {
+      "type": "Text",
+      "text": "✕ breaker open · tokens",
+      "tone": "deny"
+    },
+    {
+      "type": "Text",
+      "text": "✕ permit denied · api-billing-path",
+      "tone": "deny"
+    }
+  ]
+}

package/gnomon-mods/ledger/fixtures/breaker.json

@@ -0,0 +1,80 @@
+{
+  "view": "ledger.strip",
+  "input": {
+    "fixtureEvents": [
+      {
+        "kind": "session.open",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "backend": "claude",
+          "project": 2
+        }
+      },
+      {
+        "kind": "turn.usage",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokens": 40000
+        }
+      },
+      {
+        "kind": "turn.result",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokens": 0,
+          "tokensIn": 12000,
+          "tokensOut": 4000,
+          "cacheRead": 90000,
+          "cacheWrite": 8000,
+          "costMicros": 210000
+        }
+      },
+      {
+        "kind": "session.compacted",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokensBefore": 180000,
+          "tokensAfter": 52000
+        }
+      },
+      {
+        "kind": "turn.result",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokens": 0,
+          "tokensIn": 15000,
+          "tokensOut": 5000,
+          "cacheRead": 39000,
+          "cacheWrite": 18000,
+          "costMicros": 210000
+        }
+      },
+      {
+        "kind": "session.compacted",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokensBefore": 190000,
+          "tokensAfter": 41000
+        }
+      },
+      {
+        "kind": "budget.breaker.open",
+        "payload": {
+          "dimension": "tokens"
+        }
+      },
+      {
+        "kind": "permit.deny",
+        "payload": {
+          "dimension": "api-billing-path"
+        }
+      }
+    ],
+    "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA"
+  },
+  "width": 80,
+  "prefs": {
+    "motion": "full",
+    "theme": "day"
+  }
+}

package/gnomon-mods/ledger/fixtures/compacted.golden.json

@@ -0,0 +1,42 @@
+{
+  "schemaVersion": "display-block:v1",
+  "type": "Box",
+  "title": "Ledger",
+  "direction": "column",
+  "children": [
+    {
+      "type": "Table",
+      "columns": [
+        "session",
+        "in",
+        "out",
+        "cache",
+        "cost",
+        "⇣ compactions"
+      ],
+      "rows": [
+        [
+          "…ZZZZZA",
+          "182k",
+          "9k",
+          "71%",
+          "$0.42",
+          "2 (190k → 41k)"
+        ],
+        [
+          "…ZZZZZB (ended)",
+          "33k",
+          "-",
+          "-",
+          "-",
+          "1 (31k → 6k)"
+        ]
+      ]
+    },
+    {
+      "type": "Text",
+      "text": "total · 182k in · 9k out · 71% cache · 33k local · $0.42 · ⇣ 3 compactions (31k → 6k)",
+      "tone": "quiet"
+    }
+  ]
+}

package/gnomon-mods/ledger/fixtures/compacted.json

@@ -0,0 +1,103 @@
+{
+  "view": "ledger.sheet",
+  "input": {
+    "fixtureEvents": [
+      {
+        "kind": "session.open",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "backend": "claude",
+          "project": 2
+        }
+      },
+      {
+        "kind": "turn.usage",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokens": 40000
+        }
+      },
+      {
+        "kind": "turn.result",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokens": 0,
+          "tokensIn": 12000,
+          "tokensOut": 4000,
+          "cacheRead": 90000,
+          "cacheWrite": 8000,
+          "costMicros": 210000
+        }
+      },
+      {
+        "kind": "session.compacted",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokensBefore": 180000,
+          "tokensAfter": 52000
+        }
+      },
+      {
+        "kind": "turn.result",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokens": 0,
+          "tokensIn": 15000,
+          "tokensOut": 5000,
+          "cacheRead": 39000,
+          "cacheWrite": 18000,
+          "costMicros": 210000
+        }
+      },
+      {
+        "kind": "session.compacted",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZA",
+          "tokensBefore": 190000,
+          "tokensAfter": 41000
+        }
+      },
+      {
+        "kind": "session.open",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZB",
+          "backend": "local",
+          "project": 5
+        }
+      },
+      {
+        "kind": "turn.usage",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZB",
+          "tokens": 30000
+        }
+      },
+      {
+        "kind": "turn.result",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZB",
+          "tokens": 2500
+        }
+      },
+      {
+        "kind": "session.compacted",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZB",
+          "tokensBefore": 31000,
+          "tokensAfter": 6000
+        }
+      },
+      {
+        "kind": "session.exited",
+        "payload": {
+          "hsid": "hsid:v1:01HZZZZZZZZZZZZZZZZZZZZZZB"
+        }
+      }
+    ]
+  },
+  "width": 80,
+  "prefs": {
+    "motion": "full",
+    "theme": "day"
+  }
+}

package/gnomon-mods/ledger/fixtures/over-budget.golden.json

@@ -0,0 +1,24 @@
+{
+  "schemaVersion": "display-block:v1",
+  "type": "Box",
+  "title": "Ledger · this session",
+  "direction": "row",
+  "children": [
+    {
+      "type": "Text",
+      "text": "●",
+      "tone": "hue-2"
+    },
+    {
+      "type": "Text",
+      "text": "182k in · 9k out · 71% cache · $0.42 · ⇣ 2 compactions (190k → 41k)",
+      "tone": "warn"
+    },
+    {
+      "type": "Progress",
+      "value": 150000,
+      "max": 150000,
+      "label": "tokens 182k of 150k (permit)"
+    }
+  ]
+}