星表 / xingbiao
眾儀所稽,一表為宗。 — What every instrument consults, one catalogue as its source.
The shared declared-workspace-data substrate of Tianheng — the reader below the 三儀.
星表 (the star catalogue) reads cargo metadata --no-deps and looks up packages and their
crate-root source files: the tabulated register of declared workspace data every observation
dimension references before it observes. It spawns cargo and parses its JSON — **serde_json
- std only, no
syn**.
It sits below the 三儀, like 璇璣 (the reaction model): a dimension depends on it one-way (downward), so the static (圭表) and semantic (渾儀) dimensions, and 漏刻's CI face, read the workspace through one reader instead of hand-copied twins that drift apart. It is not 璇璣 — 璇璣 is the measure-only reaction model that renders no verdict, whereas 星表 does IO and observes.
Its public items serve roles such as these, and its rustdoc is the list of the items:
- Workspace metadata — running
cargo metadata --no-deps, finding a member by package name, and resolving each package's compiled crate roots and source directories, telling "no target reported" apart from "targets, none of them compiled" so every dimension agrees on which roots are judgeable. - Path identity —
canonicalize_or_failandtry_visit, the canonicalization and cycle/dedup guard primitives, so a path that cannot be resolved is an error rather than a silent skip. Tianheng's own law forbids an inlinestd::fs::canonicalizein each dimension, and its reasons name these primitives as where that resolution goes instead (for 漏刻,try_visitalone). - Filesystem answers — asking whether a path is a regular file or a directory, with being unable to tell kept apart from absence.
The charter is a criterion rather than an enumeration: a fact belongs here when every dimension must agree on it before observing, and it is a fact about the tree rather than a reading of what the tree contains.
Consumed as a library within the Tianheng workspace; it is not a standalone tool.
License
Licensed under either of Apache-2.0 or MIT, at your option.