brief updates

brief updates [options] [command]

brief updates sync [options] [path]

brief updates help [command]

Record page update times#

Brief stores updatedAt and contentHash together in each translation's frontmatter. The compiler hashes the parsed page body and warns when the saved checkpoint is missing or stale. After editing content, preview and apply the update before publishing:

brief updates sync --dry-run
brief updates sync
brief check

With no path, sync covers all pages, including drafts and every translation. Only changed or incomplete checkpoints receive the current time; already-current pages keep their dates. The command uses one UTC timestamp for the batch. There is no need to pass --all.

To synchronize one page, pass its path relative to the documentation root. Add --locale to select one translation:

brief updates sync docs/v0/reference/cli/updates
brief updates sync docs/v0/reference/cli/updates --locale en

Use --date for a calendar date at midnight UTC, or --time for an ISO timestamp with an explicit timezone. These options are mutually exclusive and apply only to checkpoints that need updating:

brief updates sync --date 2026-10-11
brief updates sync docs/v0/reference/cli/updates --locale en --time 2026-10-11T14:30:00+01:00

The compiler hashes the page AST, so frontmatter-only edits and source formatting that leaves the AST unchanged do not require synchronization. Body changes, including rewritten links, do. Sync maintains the timestamp and hash together; do not calculate or edit hashes manually.

Builds, watchers, and brief check never advance update times. Filesystem modification times are not publication dates. Existing updatedAt values remain visible until synchronization; pages without one omit the date. When migrating existing content, use --date or --time to establish a known historical checkpoint, or omit them to record the current time.