wiki audit

record that pages were checked against the code

Contents

1Usage
2Arguments
3Output
4Exit codes
5References

wiki audit records today as the day each page it names was last checked against the code, beside the page's date in UPDATED.toml.^[1] The page itself is not touched, so the day it was updated stays where it is.^[1] Which pages a review audits is described on Review prompt.

Usage

At least one page is named, by its path under pages, with or without .md.^[2]

wiki audit [-h] [--root ROOT] [--wiki WIKI] PAGE [PAGE ...]
wiki audit refunds index.md

Arguments

Argument	Meaning
`PAGE`	a page's path under `pages`, such as `checks/budgets`, with or without `.md`; one or more^[2]

Output

It prints one line for each page it recorded, with the day it ran.^[1]

wiki: refunds audited 14 September 2026
wiki: index audited 14 September 2026

Each page's footer then says when it was last audited, after the day it was last updated, or says never.^[3] An edit keeps the audit date, and a user build leaves it out.^[3] A page that says goals = false cites nothing, so it is never audited and its footer carries no audit date.^[3]

Exit codes

Every page is checked before any is recorded, so a refused audit records nothing.^[4]

Code	Condition	Message
`0`	every page is recorded^[4]	`wiki: refunds audited 14 September 2026`
`1`	a page does not exist^[4]	`wiki: there is no page nope.md to audit; name a page by its path under pages, such as checks/budgets`
`1`	a page says `goals = false`^[4]	`wiki: goals.md says goals = false, so it cites nothing and has nothing to audit; leave it out`
`1`	a page has changed since its date was recorded^[4]	wiki: refunds.md has changed since its date was recorded; run `wiki build`, then audit it again
`2`	no page is named^[4]	`wiki audit: error: the following arguments are required: PAGE`
`2`	an option it does not know^[4]	`wiki: error: unrecognized arguments: --unknown`
`2`	there is no wiki where it was pointed^[5]	`wiki: no wiki at nowhere`

References

src/builder/build.py — audit() writes audited for each page through write_dates(), and returns the line run() in src/builder/cli.py prints.
src/builder/cli.py — main() gives audit the positional pages, one or more, shown as PAGE; src/builder/build.py — audit() drops a trailing .md.
src/builder/build.py — render_page() adds Last audited after Last updated, with never when there is none; write_site() keeps audited when a page's date moves, and passes none to a user build or to a page whose front matter says goals = false.
src/builder/build.py — audit() checks that every page exists, does not say goals = false, and matches its recorded digest before write_dates(), raising WikiError; src/builder/cli.py — main() returns 1 for it, and argparse exits 2 when no page is named or an option it does not know is given.
src/builder/cli.py — main() prints no wiki at and the path, and returns 2, when the wiki folder does not exist.

Last updated 14 September 2026Last audited 14 September 2026343 wordsabout 2 minutes to read5 sources cited0 claims with no source