Skip to main content
After canonic ingest writes reviewable diffs, use review for an interactive, item-by-item pass, or apply to batch-apply everything still pending, for example after editing diffs by hand.

canonic review

Interactively review pending proposals one by one, in numeric order.
For each pending proposal you’re shown the diff and prompted:
  • freeze writes the file and sets meta.frozen: true: a subsequent canonic ingest flags any conflicting evidence instead of editing the fact, regardless of tier.
  • curate writes the file and sets meta.provenance: human_curated: the only way a fact gets promoted out of inferred. A curated fact is protected from future inferred evidence the same way any other human_curated fact is (see provenance tiers), but unlike freeze it isn’t an unconditional lock: equally-or-more-authoritative future evidence can still propose an edit.
Resumable: quitting or crashing mid-review picks back up at the first still-pending item on the next invocation.

canonic apply

Batch-apply all pending proposals from a run directory.
Proposals already in a terminal state (accepted / rejected / frozen / curated), or whose diff file was deleted, are silently skipped. No git interaction. Applied files appear as unstaged changes in your working tree. canonic apply doesn’t expose freeze or curate: every applied proposal resolves to accepted. Use canonic review for either.