diff --git a/specs/coauthoring-native-surfaces.md b/specs/coauthoring-native-surfaces.md index a3f8f6f..ef6b8e7 100644 --- a/specs/coauthoring-native-surfaces.md +++ b/specs/coauthoring-native-surfaces.md @@ -329,7 +329,7 @@ Scenario: PUC-7 — enter (and leave) coediting mode (realizes INV-10) When I run "Coedit this Document with Claude" (command, editor title, or context menu) Then this document gains the Cowriting source-control entry, the annotation toggle, and machine-edit/comment-response behavior And my other markdown documents are unaffected - And running "Stop Coediting" removes those surfaces (the saved sidecar is kept for next time) + And running "Stop editing with Claude" (context menu) removes those surfaces (the saved sidecar is kept for next time) ``` ```gherkin @@ -348,7 +348,8 @@ panel to wireframe. Described in text (source of truth): - **Entering coediting.** A **"Coedit this Document with Claude"** command (command palette, editor title menu, and editor/explorer context menu, markdown-gated) - turns the active document into a coedited document; a **"Stop Coediting"** command + turns the active document into a coedited document; a **"Stop editing with Claude"** + command — in the same command palette **and the editor/explorer context menu** — reverses it. A subtle status-bar item ("✦ Coediting") indicates when the active document is in coediting mode. Until a document is entered, **none** of the surfaces below attach to it (INV-10). @@ -676,9 +677,10 @@ sequenceDiagram - **Implementation:** gated on `isCoediting` (INV-10) — inert otherwise. The turn runs with live progress (PUC-5). The reply is a machine `Comment`; an accepted - offer never edits the document directly, only proposes (INV-5). Whether *every* - comment fires a turn or only an explicit "Ask Claude" affordance on the thread is - open (§13-Q6). + offer never edits the document directly, only proposes (INV-5). **While the + document is in coediting mode, every new comment fires a turn (D10)** — the opt-in + mode is the control, so there is no per-comment gate; "Stop editing with Claude" + is the off switch. #### PUC-5 — live machine progress @@ -878,8 +880,7 @@ a bug reaches us as a tracker issue. | Q2 | Per-change Keep/Undo: how far can the stable API go before falling back to per-hunk CodeLens? | Ben | PUC-2 build (last surface) | | Q3 | One "Cowriting" SourceControl vs. QuickDiff-only (no full SCM viewlet entry) — how much SCM presence is wanted | Ben | PUC-1 build | | Q4 | Does any need genuinely require a webview the native surfaces can't serve (INV-3 escape hatch)? | Ben | Per-surface build | -| Q5 | Authorship (human vs. machine) cannot live in the native diff (INV-11, verified). Which surface carries it — the annotated preview only, or **also** a decoration-based track-changes editor pane? | Ben | PUC-3 build / whether a track-changes editor is in scope | -| Q6 | Comment auto-response: should it run automatically on every new comment, or only when the writer's comment is phrased as a request / via an explicit "Ask Claude" affordance on the thread? | Ben | PUC-8 build | +| Q5 | Authorship (human vs. machine) cannot live in the native diff (INV-11, verified). Which surface carries it — the annotated preview only, a preview **plus** in-editor authorship decorations, or an **owned author-colored track-changes view** that replaces the native diff for review? | Ben | PUC-3 build / authorship-surface scope | **Resolved** @@ -894,6 +895,7 @@ a bug reaches us as a tracker issue. | D7 | Coediting is opt-in per document | A document enters coediting via "Coedit this Document with Claude"; every surface gates on the active coediting set (INV-10), so other markdown files are never hijacked | 2026-06-27 | | D8 | Comments can summon the machine | On a coedited doc, a comment fires a turn that replies in-thread + offers an edit → pending proposal (BUC-5, INV-5); inert on non-coedited docs | 2026-06-27 | | D9 | Native diff is author-blind | Verified the diff editor has no per-author color API; authorship lives in the preview (and optionally a decoration track-changes editor), not the native diff (INV-11) | 2026-06-27 | +| D10 | Comment trigger | While a document is in coediting mode, **every** new comment summons the machine (no per-comment gate); coediting mode is the control, "Stop editing with Claude" the off switch | 2026-06-27 | ## 14. Glossary & References