Read-only demo. Approve, reject, deploy, and iteration actions are disabled. Self-host from GitHub.
MetricCards v1
A row of headline numbers with deltas. Use when the workflow output is a small set of KPIs the operator scans every morning.
demand-prediction · labour
Forecast accuracy
91.2%
5.4 pts vs baseline
SKU coverage
2,184
· no change · 30d
Stockout exposure
$84k
21% week-over-week
Markdown risk
$12k
8% week-over-week
Input shape
{ label, value, unit?, delta?: { value, direction, scope } }[]
Best for
Glanceable dashboards · 2–6 KPIs · operator opens, scans, moves on
Avoid when
More than 8 metrics (use TableView) or single value with deep drill (use chart)
TimeSeriesChart v1
Line chart with optional baseline reference. The canonical "is the workflow getting better" view.
all workflows
Forecast accuracy · last 30 days
↑ 5.4 pts vs baseline · 4 improvements
85%87%88%90%92%D1D6D10D14D18D22D26D29D30baseline 85.8%Forecast accuracy: 85.8 @ D1Forecast accuracy: 85.6 @ D6Forecast accuracy: 87.4 @ D10Forecast accuracy: 87.6 @ D14Forecast accuracy: 89.3 @ D18Forecast accuracy: 89.5 @ D22Forecast accuracy: 90.7 @ D26Forecast accuracy: 91 @ D29Forecast accuracy: 91.2 @ D30
Forecast accuracyBaseline
Input shape
{ series: { name, points: [{ t, value }] }[], baseline?, baseline_label?, annotations? }
Best for
Lift over time · before/after improvement story · demo hero chart
Avoid when
Comparing categorical values (use TableView) or single point-in-time state (use MetricCards)
TableView v1
Sortable table for row-shaped output. Heavy use in supply chain and labour where the operator works through a list.
demand-prediction · labour
SKUs at risk · region: Pacific NW4 of 1,847 · sorted by exposure
SKUDescriptionForecastOn-handExposureRisk
BOOT-W42Winter trail boot, men's1,847312$48kHigh
BOOT-W41Winter trail boot, women's1,422280$22kMed
JKT-D08Down jacket, unisex911198$11kMed
GLV-T03Touchscreen glove540120$3kLow
Input shape
{ columns: { key, label, type, format? }[], rows: object[], title?, summary? }
Best for
Operator triage · "show me the things that need attention, ranked"
Avoid when
Fewer than 3 rows (use cards) · narrative output (use ConversationView)
AlertList v1
Vertically-stacked list of severity-marked items. Inbox and "things fired since last check" view.
all workflows
Stockout forecast: BOOT-W42 will hit 0 in 6 days
Region Pacific NW · revenue exposure $48k · fired 14 min ago
Promotional uplift underweighted on bundled SKUs
9 traces clustered · proposal generating · fired 1h ago
Supplier lead time drifted +2 days for 12-week SKUs
Awaiting more signal · 6 traces · fired 4h ago
Input shape
{ severity: "high"|"medium"|"low", title, meta, action_url? }[]
Best for
Inbox · monitor signals · anything time-ordered with severity
Avoid when
Items have no inherent priority (use TableView)
KanbanBoard v1
Cards across stage columns. Ticket-like flows where operators move items through states.
support · labour
New
3
Refund eligibility · #4821
Annual subscription, 47 days in
chat · 2m
policy
Order status · #4820
Where is my package, no tracking
email · 4m
Drafted
2
Account merge · #4815
Two accounts, same email
chat · 12m
review
Plan change · #4812
Downgrade from team to solo
email · 18m
Sent
14
Order confirmation · #4809
Replied 6 minutes ago
chat · 25m
resolved
Tracking link · #4807
Replied 12 minutes ago
email · 31m
Escalated
1
Refund dispute · #4798
Customer not satisfied with policy
chat · 1h
tier-2
Input shape
{ columns: { key, label, count }[], cards: { id, column_key, title, body, meta, tags? }[] }
Best for
Ticket triage · ops queues with clear stages · agent + human shared workspace
Avoid when
No stage transitions (use TableView or AlertList)
ScheduleGrid v1
2-D resource × time grid with cell-level status. Shift schedules, content calendars, capacity boards, on-call rotations.
labour · capacity-planning
Mon
May 4
Tue
May 5
Wed
May 6
Thu
May 7
Fri
May 8
Morning06–14
22
target 22
✓ ok
19
target 22
−3 short
22
target 22
✓ ok
26
target 26
cert gap
22
target 22
✓ ok
Afternoon14–22
26
target 26
✓ ok
26
target 26
✓ ok
26
target 26
✓ ok
26
target 26
✓ ok
26
target 26
✓ ok
Input shape
{ rows: { key, label }[], cols: { key, label, sub? }[], cells: { row_key, col_key, value, target?, status, tag? }[] }
Best for
Shift schedules · capacity boards · content calendars · anything resource × time
Avoid when
Time isn't an axis (use TableView) · single-day view (use AlertList)
ConversationView v1
Threaded chat-style render with citation chips. Whenever the workflow output is a reply to a person.
support · order-intake
C
Hi — I'd like to cancel my annual plan and get a refund for the unused months.
Customer · 12:04
A
I can help cancel your plan. On refunds — our annual plan is non-refundable after the first 30 days, but I can stop it from auto-renewing. Want me to do that?1
Agent · 12:04 · 1 citation
C
OK please stop auto-renew. When does it actually end?
Customer · 12:05
A
Done — auto-renew is off. Your current term ends 2026-08-14. You'll keep full access until then.12
Agent · 12:05 · 2 citations
Input shape
{ messages: { role: "agent"|"user"|"system", text, ts?, author?, citations? }[] }
Best for
Customer support · sales chat · any agent-to-human dialogue with grounding
Avoid when
Output is structured (use TableView)
SideBySideView v1
Two panels rendered next to each other for comparison. Proposal review, before/after diffs, prose-vs-source.
improvement-review · contract
Current skill · v3
when forecasting: load 36mo history. detect anomalies as >2 stdev from prior-year. emit forecast.run with {accuracy, exposure}.
Proposed · v4
when forecasting: load 36mo history. detect anomalies as >2 stdev from prior-year. also flag seasonal-cluster drift >15% vs prior-year same- week (catches winter footwear case). emit forecast.run with {accuracy, exposure}.
Input shape
{ left: { title, body, format?, highlights? }, right: { title, body, format?, highlights? } }
Best for
Proposal diffs · before/after improvement view · contract drafting
Avoid when
No comparison anchor exists (use a single panel)
DocumentReader v1
Long-form document with inline annotations and a comment gutter. The legal / contract review hero.
contract
§14.3 · Successor and Assigns

Either party may assign its rights or delegate its duties under this Agreement, in whole or in part, to any successor entity arising from a merger, acquisition, or sale of substantially all of its assets, without the consent of the other party, provided that such successor expressly assumes all obligations hereunder.

For all other assignments, the prior written consent of the non-assigning party shall be required, which consent shall not be unreasonably withheld, conditioned, or delayed.

Any purported assignment in violation of this Section shall be null and void.

Annotations · 2
Successor carve-out
Confidence 0.62 — broader than precedent. Suggest narrowing to "controlling interest acquisition."
Consent standard
Standard "not unreasonably withheld" language present. ✓
Input shape
{ section_label?, blocks: { kind, text, spans? }[], annotations: { id, severity, title, body }[] }
Best for
Contract review · policy drafting · any reviewer-with-document workflow
Avoid when
Document is short (under 200 words) — use SideBySideView
Need a view that isn't here?
We deliberately keep the set small — every view multiplies the surface area to keep stable across themes, eval, and accessibility. If you have a workflow that doesn't fit one of the nine, file it at packages/trace-format/SPEC.md with a sketch.