xingbiao 0.9.0

星表 (Xingbiao) — Tianheng's shared declared-workspace-data substrate: reads `cargo metadata --no-deps` and looks up packages and their crate-root source files, the tabulated catalog every observation dimension references before it observes. serde_json-only, below all dimensions like 璇璣 — a single source of truth so the static and semantic dimensions read the workspace through one reader instead of two drifting twins.
Documentation

星表 / 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_fail and try_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 inline std::fs::canonicalize in each dimension, and its reasons name these primitives as where that resolution goes instead (for 漏刻, try_visit alone).
  • 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.