Expand description
nomograph-workflow — shared layer between claim-substrate tools.
Extracted from duplicated adapter code in synthesist and lattice
(both tools wrapped nomograph_claim::Store with near-identical
thin adapters). Consolidated here so:
Store(the adapter) is a single source of truth. Whennomograph_claim::Storeevolves, synthesist and lattice pick up the change through one file, not two.- The
phasestate machine (workflow phases) has a clear owner. Future tools (seer) can callworkflow::phase::check_phaseto enforce the same rules synthesist does. - v1 legacy detection lives in one place; every tool that reads a project directory picks up the same prescriptive migration error.
§What belongs here
Things that MORE THAN ONE nomograph tool needs, AND that are tied to the claim substrate’s conventions. In practice:
- The
<repo_root>/claims/discovery walk (same for every tool) - The
user:local:<user>[:session]asserter convention - Schema validation at the append boundary
- The phase state machine (synthesist + future seer)
- Legacy-v1 detection
- Cross-tool helpers:
parse_tree_spec,today,json_out
§What does NOT belong here
- Per-tool CLI handlers (stay in synthesist / lattice)
- Tool-specific claim types (Campaign, etc. — still just appended
through
Store::appendwith aClaimType)
Re-exports§
pub use helpers::json_out;pub use helpers::parse_tree_spec;pub use helpers::today;pub use legacy::find_legacy_v1_db;pub use legacy::legacy_migration_error;pub use phase::Phase;pub use phase::check_phase;pub use store::CLAIMS_DIR;pub use store::Store;