Skip to main content

Module tracking

Module tracking 

Source
Expand description

The tracking registry: the parsed, bounded shape of a perishable-facts file.

The registry is <root>/reference/tracking.yaml: one YAML document, schema_version: 1, a tracked array. This module owns the versioned shape and the bounds that must hold before any semantic read, because the file is repository-controlled input a gate parses on every commit. What a path resolves to on disk, and whether an entry is overdue against a clock, is services::tracking’s business.

Structs§

Entry
One tracked perishable source.
Registry
A parsed registry.
Source
An upstream Git derivation an entry pins.

Enums§

TrackingError
Why a registry cannot be accepted.

Constants§

SCHEMA_VERSION
The schema version this binary reads.

Functions§

is_object_id
True for a full 40- (SHA-1) or 64-character (SHA-256) hex object ID.
parse
Parse and bound a registry, then confirm the version and the source formats. Path existence and freshness are the service’s checks.