Check Command

zetl check validates the vault and reports issues across both the Link Graph and concepts/Spindle Lisp content.

(given dead-link-detection)
(given orphan-detection)
(given spl-diagnostics)
(given drift-detection)

Usage

zetl -d ./my-vault check
zetl check --dead-links --fail-on error    # CI mode
zetl check --spl                           # SPL diagnostics only
zetl check --drift                         # detect SPL grounding drift

Issue types

Dead links

A wikilink that points to a page that doesn’t exist. For example, [[Plugin System]] would be a dead link if there’s no Plugin System.md file.

Orphan pages

Pages with no incoming links — nothing in the vault references them. These may be forgotten drafts or entry points that need a wikilink from somewhere.

Syntax errors

Malformed wikilinks like unclosed brackets.

SPL diagnostics

Parse errors, duplicate rule labels, undefined references, and unreachable literals in concepts/Spindle Lisp blocks. Enabled with --spl.

Drift detection

SPL blocks whose surrounding prose has changed since the theory was last built, potentially invalidating the grounding of facts. Enabled with --drift. See Drift Detection and Merkle Tree.

Flags

Without any filter flag, all issue types are reported.

CI integration

Use --fail-on error to exit non-zero when issues are found:

zetl -d ./my-vault check --dead-links --fail-on error

See also: CLI Reference, Drift Detection, Blocks Command, Reason Commands