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 5/5 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 5
WORK-481 main
ProjectFiles interface + fs/memory providers The foundation of SPEC-113: one synchronous ProjectFiles interface in @refrakt-md/types, with filesystem and in-memory providers, that replaces the four ad-hoc fs seams. Containment becomes an interface contract, so no consumer re-implements path-safety. Also lands the recordable-read wrapper that ADR-025 names as the one piece of groundwork for future incremental rebuild.
5/5 criteria
WORK-482 main
Migrate sandbox reads to ProjectFiles + close the src traversal gap Move the sandbox example read seam (__sandboxReadFile family + preprocess sandbox hooks) onto the WORK-481 ProjectFiles provider, and route the sandbox src directory join through it so it inherits containment — closing the unguarded examplesDir + '/' + src path-traversal gap.
3/3 criteria
WORK-483 main
snippet / expand / file-ref readers delegate I/O to ProjectFiles Close the main gap in SPEC-113: read-file.ts (and the snippet/expand/file-ref pipelines) call node:fs directly today, bypassing the injectable seam — so tree mode is not actually fs-free for snippets. Delegate the I/O to the WORK-481 provider, keeping line-slicing and diagnostics intact.
3/3 criteria
WORK-484 main
fileRoots + plan scan + loadContentFromTree plumbs; in-memory full-build test Finish the consumer migration and the virtual entry point: scan fileRoots and the plan plugin's configure scan through the provider, expose projectFiles + gitTimestamps on loadContentFromTree, and prove a full site builds from a pure in-memory map.
3/3 criteria
WORK-485 main
Docs — ProjectFiles contract + fetch-then-build materialization Document the ProjectFiles contract and the fetch-then-build materialization pattern for remote hosts, so plugin and adapter authors know the seam and how a hosted renderer feeds it.
2/2 criteria