Skip to main content

Module clean

org_gdocs

Module clean 

Source
Expand description

Q3 — the clean command: archive the comments the operator marked DONE.

Once a DONE comment has been resolved in Google (by push), its TODO heading is dead weight in the org file. clean cuts those subtrees out of ** Active Comments (P6 crate::comments_meta::clean_section) and rewrites the file, leaving every non-DONE heading and the entire body untouched.

This is a pure, offline transform — no network, no clock. Guarantees:

  • Selective. Only DONE comment subtrees are removed; TODO headings (including operator notes and clocking) are preserved verbatim (A3).
  • DI-2 — the body is sacrosanct. The body is reproduced byte-for-byte; clean rewrites only the machine region, and when nothing is DONE it is a strict no-op on the whole file.

Structs§

CleanOutcome
The result of a clean: how many comments were archived and the new content.

Functions§

clean
Archive every DONE comment in content, returning the rewritten file.
envelope
Build the success envelope for a completed clean (A5).