Technical details

1. Find. A source returns findings. Each quotes the note exactly, names a kind (Voice, Clarity, Line, Cuts or Mechanics), says whether it's a cut, a rewrite or only a note, and says why. A quote that occurs more than once carries a few words of context.
2. Check. The quote has to be in the note. A cut may only remove words. A quote found only in code, a link or frontmatter is dropped. Each drop is logged with its reason (not-found, ambiguous, adds-words, protected, …), never fixed quietly.
3. Save. One file per note and source, stamped with a hash of the text the source saw. An open note reloads when its files change, so a script or another tool can write findings too.
4. Place. All of a pass's quotes are found in the note in one go. Where two sources overlap, the stronger one shows; the coach wins over the local checks.
5. Decide. Apply is one CodeMirror transaction, so one undo takes it back. A mark whose words changed since is refused. A fix that touches a number, a name, a quote or a kept term carries a warning, and Apply all skips it.

{
  "note": "Drafts/Walden in winter.md",
  "source": "habits",
  "noteHash": "…",
  "findings": [{
    "id": "h-3", "category": "cuts", "kind": "cut", "tag": "issue",
    "quote": "really just", "suggestion": "",
    "why": "Softeners from your profile", "pass": "softeners"
  }]
}

Nothing changes by itself. An accepted proposal is one line in the right section of your profile; a turn-down is saved in settings. A skipped proposal isn't asked again. A host can switch profile writes off and get accepted proposals as JSON lines instead.

this.ctx = await startEditor(this, {
  pluginId: 'my-editor',
  categories: [...DEFAULT_CATEGORIES, { id: 'series', label: 'Series', color: '#14b8a6', defaultMode: 'a', order: 6 }],
  dataDir: '.my-editor',
  coach: { prompt: MY_PROMPT, maxSteps: 12, role: { tier: 'careful', ceilingUsd: 0.25 } },
  notePolicy: (note, fm) => (fm.status === 'published' ? { apply: false } : {}),
});