benstull/vscode-cowriting-plugin
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases Wiki Activity

F9: authorship view in the rendered preview #27

Merged
benstull merged 9 commits from f9-authorship-preview into main 2026-06-11 21:40:58 +00:00
Conversation 0 Commits 9 Files Changed 12
+1457 -23
benstull commented 2026-06-11 21:40:49 +00:00
Owner
Copy Link
Copy Source

Adds an Authorship mode to the F7 rendered preview, surfaced as friction during F8 testing ("the preview doesn't show the Claude-composed annotations"). Design: docs/superpowers/specs/2026-06-11-authorship-preview-design.md. Session 0026.

What changes

The preview header gains a [ Track changes | Authorship ] toggle (per-panel, default Track changes — unchanged). Authorship mode re-renders the current document with each span colored by its F3 author — Claude (blue) vs you (green), inline and char-precise — with a header legend. Because it reads F3 attribution directly (not the F6 baseline), Claude's contributions stay visible even after the baseline absorbs a landing (INV-18). Code/mermaid fences get a block-level author badge (atomic, INV-27).

How

  • trackChangesModel.ts: splitBlocksWithRanges (block source offsets) + pure renderAuthorship(currentText, spans) — PUA sentinel injection through markdown-it, post-processed to <span class="cw-by-claude|cw-by-human">; fences atomic.
  • AttributionController.spansFor(document) — maps live F3 spans to authorship spans (resolves the URI-vs-keyOf key mismatch).
  • trackChangesPreview.ts: per-panel mode + setMode message + render branch; extension.ts reorders the F7 controller after attribution.
  • media/: segmented toggle, legend, .cw-by-* CSS.
  • model.ts/store.ts/mergeArtifacts.ts/diffViewController.ts/baselineStore.ts untouched; track-changes mode behavior unchanged.

Invariants

INV-26 (authorship is baseline-independent), INV-27 (fences atomic), INV-28 (pure renderAuthorship).

Tests

  • Unit (vitest): 161 passing (+ splitBlocksWithRanges, renderAuthorship incl. adjacency / atomic-fence / sentinel-leak / determinism).
  • Host E2E (no LLM): 37 with-workspace (incl. new F9 authorship suite) + 5 no-workspace; all F2–F8 regressions green.

Docs: docs/MANUAL-SMOKE-F9.md, README F9 section. Plan: docs/superpowers/plans/2026-06-11-f9-authorship-preview.md.

🤖 Generated with Claude Code

Adds an **Authorship** mode to the F7 rendered preview, surfaced as friction during F8 testing ("the preview doesn't show the Claude-composed annotations"). Design: `docs/superpowers/specs/2026-06-11-authorship-preview-design.md`. Session 0026. ## What changes The preview header gains a `[ Track changes | Authorship ]` toggle (per-panel, default **Track changes** — unchanged). **Authorship** mode re-renders the *current* document with each span colored by its F3 author — Claude (blue) vs you (green), **inline and char-precise** — with a header legend. Because it reads F3 attribution directly (not the F6 baseline), Claude's contributions stay visible even after the baseline absorbs a landing (INV-18). Code/mermaid fences get a block-level author badge (atomic, INV-27). ## How - `trackChangesModel.ts`: `splitBlocksWithRanges` (block source offsets) + pure `renderAuthorship(currentText, spans)` — PUA sentinel injection through markdown-it, post-processed to `<span class="cw-by-claude|cw-by-human">`; fences atomic. - `AttributionController.spansFor(document)` — maps live F3 spans to authorship spans (resolves the URI-vs-keyOf key mismatch). - `trackChangesPreview.ts`: per-panel mode + `setMode` message + render branch; `extension.ts` reorders the F7 controller after attribution. - `media/`: segmented toggle, legend, `.cw-by-*` CSS. - **`model.ts`/`store.ts`/`mergeArtifacts.ts`/`diffViewController.ts`/`baselineStore.ts` untouched**; track-changes mode behavior unchanged. ## Invariants INV-26 (authorship is baseline-independent), INV-27 (fences atomic), INV-28 (pure `renderAuthorship`). ## Tests - Unit (vitest): **161 passing** (+ `splitBlocksWithRanges`, `renderAuthorship` incl. adjacency / atomic-fence / sentinel-leak / determinism). - Host E2E (no LLM): **37** with-workspace (incl. new F9 authorship suite) + **5** no-workspace; all F2–F8 regressions green. Docs: `docs/MANUAL-SMOKE-F9.md`, README F9 section. Plan: `docs/superpowers/plans/2026-06-11-f9-authorship-preview.md`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
benstull added 9 commits 2026-06-11 21:40:49 +00:00
design(f9): authorship view in the rendered preview 8fa83f68c8 
F7 gains an Authorship mode (segmented header toggle) that renders the current doc
with each span colored by its F3 author (Claude blue / human green), inline and
char-precise via PUA sentinel injection; code/mermaid fences get a block-level
author badge. Baseline-independent (INV-26), reads AttributionController.spansFor.
INV-26..28. Surfaced as friction during F8 testing.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
plan(f9): authorship preview implementation plan (7 TDD tasks) 0eaca37d5e 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
feat(f9): splitBlocksWithRanges — block offsets aligned to the source 82d7c52983 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
feat(f9): renderAuthorship — inline author spans + atomic fence badges (INV-26/27/28) 95eaf78891 
PUA sentinel injection through markdown-it; adjacent-span ordering handled;
code/mermaid fences atomic with a block-level author badge.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
feat(f9): AttributionController.spansFor — authorship spans for the preview a84d72e69b 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
feat(f9): preview gains authorship mode + attribution dep + setMode wiring 399e3c5f70 
Per-panel mode (default changes); refresh branches to renderAuthorship reading
AttributionController.spansFor; webview setMode message; extension.ts reorders the
F7 controller after attribution. getMode/setMode test seams.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
feat(f9): webview segmented mode toggle + authorship legend + author CSS e0118bb835 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
test(f9): host E2E — authorship mode marks Claude's landed span 4212d90055 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
docs(f9): manual smoke + README authorship-mode note 001adee34f 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
benstull merged commit 96be1dd070 into main 2026-06-11 21:40:58 +00:00
benstull deleted branch f9-authorship-preview 2026-06-11 21:40:58 +00:00
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
priority/P0
Priority: highest — drop everything
 priority/P1
Priority: high
 priority/P2
Priority: medium
 priority/P3
Priority: low / someday
 type/bug
A defect in shipped behavior
 type/epic
Type: a large body of work spanning many features
 type/feature
Type: a deliverable capability under an epic
 type/story
Type: a user story — the smallest valuable increment
 type/task
Type: a concrete unit of work under a story
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
benstull
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: benstull/vscode-cowriting-plugin#27
Delete Branch "f9-authorship-preview"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?