Skip to main content
Check due ledger entries. This fetches source pages and saves local observations and activity. Use --all only when you intend to ignore due times.

​
Example

Checks due entries in the current ledger and prints JSONL observations. It saves changed observations and check activity.

​
Options

  • --filter TEXT
  • --all ignores due times
  • --json
  • --fail-on-unknown
  • --concurrency N defaults to 6
  • --timeout MILLISECONDS defaults to 20000
  • --host-delay MILLISECONDS defaults to 2000. Numeric defaults may be set in config.defaults.

​
Exit status

0 when no expected placement is conclusively absent; 1 when an expected placement is observed absent with complete evidence. Unknown is nonfailing by default; --fail-on-unknown returns 1 for an unknown result in text or JSON output. Usage, configuration and malformed-ledger errors return 2.

​
What happens

Checks selected source pages with the local verifier. Records changed observations and per-entry activity; repeated identical observations do not append another row. JSON output is JSONL, one observation per line. In JSON mode, empty/not-due/filter results leave stdout empty and send a notice to stderr; text mode prints that notice on stdout. Malformed ledger rows refuse before fetching or changing customer records.
Read configuration and file ownership for environment variables, compatibility aliases and writer locks. Read local file contracts for artifact fields. Browse the CLI index for related commands.
Check the selected environment and workspace access before calling hosted operations. See capability status.