Core concepts
These concepts describe deterministic polishing. AI rewrites instead return operation status, text and usage; they do not invent this engine’s score or explanations.
Draft
The text you send. GenPolish never edits it in place: a polish produces a new text and leaves the draft alone, which is what makes rejecting a change free.
Change
One edit, with the span it replaces, the replacement, a category and a rationale. A change whose after is null is reported without a proposal: the two structural categories can see a problem that only a rewrite fixes, and inventing that rewrite is not the engine’s job.
Diff
The same result expressed as ordered tokens. del is removed, ins is added, chg is rewritten in place. The three colours in the editor mean exactly those three things and nothing else.
Revision
A stored polish, numbered from 1. Revisions appear only when you pass save: true. Restoring an earlier revision creates a new one rather than deleting anything.
Human score
How machine-like the writing reads, from 0 to 100. It is not a detector verdict and it is not sold as one: a high score means the text no longer carries the habits this taxonomy names.