Create timeline draft
create_timelineTurn a structured brief into a timeline draft by defining acts, axes, filters, and relations, producing interactive filterable timelines.
Instructions
Create a timeline draft from the build brief (Flow 2 §B–§I). brief:
{title, subject?, timeline_id?, columns?: 3|5, node_noun?, period_noun?,
accent?, entity_axis_label?, entity_axis_singular?,
acts: [{label, short?, color?}] (2-7),
mode?: 'linear'|'outline' — 'linear' (default) flows nodes through the
bands in sequence; 'outline' makes them concepts that CONTAIN one
another, one family per band, structure carried by node parent,
§D-Outline,
axes?: [{label, singular, hide_nav?: bool, values:[{id,name,...}]}] (≤2;
hide_nav drops the axis from the nav bar, drawer and legend but KEEPS its
card chips and detail pages, and labels those chips with the value name —
right for a large uncapped axis such as a course's cases),
filters?: [{id, label,
source: 'entity'|'axis1'|'axis2'|'acts'|'coverage'|'depth'|'custom',
values?: [{id,name}] (custom source only, 2-10),
replace_nav?: bool}] (≤2; 'coverage' = auto Solid/Thin from node density;
'depth' = auto Level 1/2/3+ from the containment structure),
relations?: [{key,label?,color?}] ('spine' = neutral main thread; other
relations get distinct palette colors when color is omitted, so their
lines stay tellable apart from the spine. Each label is user-visible: it
appears in the on-page line key (desktop nav + mobile drawer) next to a
swatch of its line color, for every relation a connection actually uses —
so keep labels short, e.g. 'Overrules'),
chip_filters?: bool (default true: the Filter toggle gets a section for
every kind of sub-chip cards carry — entities, each axis — and picking
chips dims the cards without them),
line_filter?: bool (a "Lines" section in the Filter toggle that isolates
one relation's lines; default true, set false for a story whose lines
just follow characters),
overview_html?, owner_name?, owner_email?}.
Filters add canvas filter chips that dim non-matching nodes (they never
navigate). Derived sources (entity/axis1/axis2/acts) mirror that
dimension's values and assign nodes automatically; 'custom' declares its
own values and each node picks one via its filters map in add_nodes.
replace_nav makes a mirrored axis1/axis2 filter-only — nav chips, drawer
section, legend dot, and per-node card chips are all suppressed (no
reachable detail pages) — recommended when that axis has no authored
detail sections. On source 'entity' it only swaps the nav chips.
period_noun names the horizontal bands on the homepage tile ("Unit",
"Act", "Era", …); omit it and the label is derived from the project kind
(studying→Unit, writing→Act, research→Phase, default Unit).
Entities are set separately via set_entities. Returns validation warnings.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brief | Yes | ||
| project_id | Yes |