ID:SPEC-103Status:accepted
data rune — external tabular sources
Name:v0.27.0Status:planning
v0.27.0 — External data & hosted content
Two threads that together let the pipeline ingest real data from outside the content tree and run without a local filesystem. The first feeds charts and sortable tables from actual data files; the second consolidates the remaining ad-hoc fs seams into one injectable interface so a hosted renderer (the GitHub-app product) can build a tenant's repo straight from the API.
Progress 4/4 work items
Relationships
Related 14
ID:SPEC-083Status:draft
Semantic chart data and pluggable renderer providers
ID:SPEC-062Status:draft
Snippet rune
ID:WORK-417Status:done
data rune preprocessor + CSV/TSV adapter + projection core
Priority:highComplexity:complexMilestone:v0.27.0
ID:SPEC-113Status:accepted
ProjectFiles seam — virtual project filesystem for hosted and in-browser builds
ID:WORK-481Status:done
ProjectFiles interface + fs/memory providers
Priority:highComplexity:moderateMilestone:v0.27.0
ID:WORK-482Status:done
Migrate sandbox reads to ProjectFiles + close the src traversal gap
Priority:highComplexity:moderateMilestone:v0.27.0
ID:WORK-483Status:done
snippet / expand / file-ref readers delegate I/O to ProjectFiles
Priority:highComplexity:moderateMilestone:v0.27.0
ID:WORK-484Status:done
fileRoots + plan scan + loadContentFromTree plumbs; in-memory full-build test
Priority:highComplexity:moderateMilestone:v0.27.0
ID:WORK-485Status:done
Docs — ProjectFiles contract + fetch-then-build materialization
Priority:mediumComplexity:simpleMilestone:v0.27.0
ID:WORK-486Status:done
data rune — JSON + NDJSON adapters
Priority:highComplexity:moderateMilestone:v0.27.0
ID:WORK-487Status:done
datatable — data-value-aware sort
Priority:mediumComplexity:simpleMilestone:v0.27.0
ID:WORK-488Status:done
data rune — docs page
Priority:mediumComplexity:simpleMilestone:v0.27.0
ID:ADR-025Status:proposed
Incremental rebuild: dependency-tracked invalidation with the registry as firewall
Date:2026-06-25
Work Items
Done 4
WORK-417 main
data rune preprocessor + CSV/TSV adapter + projection core The tier-1 spine of SPEC-103: a preprocess-time data rune that reads a sandboxed external file and emits a Markdoc table AST node, the CSV/TSV adapter, and the shared projection + typing core (incl. data-value emission) and table emitter that every adapter reuses. JSON/NDJSON adapters (WORK-486), the datatable sort change (WORK-487), SQLite, and remote sources are out of scope. Proves the headline claim — chart and datatable consume the emitted <table> with no structural edits.
6/6 criteria
WORK-486 main
data rune — JSON + NDJSON adapters The JSON-family adapters for SPEC-103, on top of the WORK-417 adapter contract + projection core. JSON is not inherently tabular, so its adapter owns the three knobs CSV doesn't; NDJSON is line-delimited records. Both reduce to the shared { headers, rows } shape and are indistinguishable downstream.
4/4 criteria
WORK-487 main
datatable — data-value-aware sort The one host-side change SPEC-103 takes for typing: extend the datatable sort comparator to prefer a cell's data-value over its textContent, mirroring what chart already does (cell.dataset.value ?? textContent). This is what lets data's numeric typing produce correct sorts of human-formatted numbers (currency, thousands separators, units) — and it equally fixes hand-authored tables, so it is a general improvement, not a data-specific hack.
3/3 criteria
WORK-488 main
data rune — docs page The author-facing documentation for SPEC-103: the data rune with CSV + JSON examples, the chart/datatable composition story, and the build-time-vs-runtime distinction so authors reach for the right layer.
3/3 criteria