12. The review loop

Pin comments on the served site, work through them from the CLI, and hand off rounds with the review handshake.

Before you start: Render targets

wcl wdoc serve <file> --comment injects a review client into every page: click any rendered block to pin a note on it. Comments land in a comments.wcl sidecar beside the document — keyed by page and locator — and never trigger a rebuild, so reviewing stays non-destructive.

From the CLI, wcl wdoc comments . lists every open note and comments . resolve <id> closes one. For human⇄agent rounds, the agent runs wcl wdoc review <file>: it blocks until the reviewer clicks "Send to agent" in the comment toolbar, then prints that round's comments for the agent to work through.

§ 1Exercise: Run one review round

Serve with --comment, pin a note on any block in the browser, list it from the CLI, then resolve it.

wcl wdoc serve docs.wcl --comment &
# click a block in the browser and leave a note, then:
wcl wdoc comments .
wcl wdoc comments . resolve <id>