Saphan StudioDocs
Reference/Command reference

saphan lib

Library utilities

saphan lib

Library utilities

saphan lib

Subcommands

SubcommandWhat it does
saphan lib validateValidate a library tree against its format_version

saphan lib validate

Validate a library tree against its format_version

saphan lib validate <path> [flags]

Validate a library tree — the reference implementation of the manifest format (§5.3). Strict mode: unknown fields are errors.

Plain validate checks format only. With --pin the tree is additionally loaded under §5.1 pin discipline: the checkout must be at the pinned tag or the load refuses with exit 2. --allow-unpinned is the explicit escape hatch; every use writes a durable ledger row (kind pin-bypass, cost 0).

Options

OptionTypeDefaultDescription
--allow-unpinnedboolfalseload despite a missing or failed pin; recorded in the cost ledger
--pinstringunsetgit tag the library checkout must be at (§5.1 pin discipline)

On this page