# Session 0036.0 — Transcript

> App: vscode-cowriting-plugin
> Start: 2026-06-12T11-01 (PST)
> End: 2026-06-12T12-18 (PST)
> Type: brainstorming
> Status: **FINALIZED**

## Launch prompt

`/goal next` — resume the next recorded goal. Memory (session 0035) recorded
**Next /goal = design #43**: write the Solution Design for Feature #43 (F11) —
the preview toolbar as the primary interaction surface (adaptive Ask-Claude +
Pin-baseline buttons).

## Summary

A brainstorming session that produced and graduated the **F11 Solution Design**
for Feature `#43`: making the F10 rendered-review preview's header toolbar the
**primary interaction surface**. Beside the existing annotations on/off checkbox,
the toolbar gains a **Pin baseline** button and a **single adaptive "Ask Claude…"
button** (Edit Selection when text is selected in the preview / Edit Document
otherwise), plus a minimal right-click → Open Review Preview gateway.

The session opened by classifying `/goal next` → brainstorming, claiming session
ID **0036** (`--type brainstorming`), and verifying a clean pushed `main`. It then
oriented from the #43 issue (read via the Gitea API) and the F10 interactive-review
spec (the architecture F11 extends), and dispatched an Explore agent to produce a
precise code map of the preview webview, the markdown-it render path, the F4 edit
seam, `pinDiffBaseline`, and the #41/#42 menu state.

## Pre-state

- `main` clean and pushed; no in-flight sessions (0035 finalized).
- F10 (`#29`) shipped: clean editor + rendered preview as the single review
  surface (annotations on/off; ✓/✗ on F4 proposals). `#31` shipped: proposals
  rendered inline at their resolved anchor.
- `cowriting.pinDiffBaseline` registered but `when:false` (orphaned since `#34`).
- Whole-document editing did not exist; "Edit Selection" was an editor
  context-menu item only.

## Turn-by-turn arc

1. **Classify + claim.** `/goal next` → resume "design #43" → brainstorming.
   Claimed ID 0036; resolved app facts (content repo present; roadmap = this repo;
   no BDD corpus); confirmed clean baseline.
2. **Orient.** Read issue `#43` (Gitea API, P1/feature), the F10 spec
   (`coauthoring-interactive-review.md`), and prior content-repo specs/plans. Ran
   an Explore agent → code map: `trackChangesPreview.ts` (webview + annotations
   toggle round-trip), `trackChangesModel.ts` (markdown-it; `splitBlocksWithRanges`
   → `BlockWithRange` char offsets; **no** source-line mapping in rendered HTML),
   `extension.ts editSelection` + `proposalController.propose` + F4 `applyAgentEdit`
   seam, `diffViewController.pinDiffBaseline` (`when:false`), and the absence of
   #41/#42 menu entries.
3. **Surface the forks.** Identified the central design risk — mapping a *rendered
   preview* selection back to a *source markdown range* — and three load-bearing
   forks. Asked the operator (AskUserQuestion) with recommendations.
4. **Forks locked** (all recommended options chosen): (1) **block-level**
   selection→source mapping via `data-src` block attributes; (2) document edit
   **diffed into per-hunk F4 proposals**; (3) **#43 lands a minimal right-click
   gateway**.
5. **Present design + write spec.** Presented the consolidated F11 design
   (INV-35/36/37, message bus, slices, testing). Wrote
   `docs/superpowers/specs/2026-06-12-f11-preview-toolbar-interaction-surface.md`;
   self-reviewed; verified reused seams exist (`DiffViewController.pin(document)`,
   `isAuthorable(scheme)`). Committed to `main` (`b2de25f`; rebased over the
   0036 placeholder push), matching the F9 direct-`design(...)`-commit precedent.
6. **Finalize.** Submitted the spec to the content repo `specs/` (graduated,
   `855acec`); updated memory; published this transcript.

## Cut state (final)

- **Spec graduated:** `specs/2026-06-12-f11-preview-toolbar-interaction-surface.md`
  in `vscode-cowriting-plugin-content` (`855acec`); code-repo working copy at
  `docs/superpowers/specs/` (`b2de25f` on `main`).
- `main` clean and pushed. No open PRs (Gitea host — no `gh` PR flow).
- Memory: added `f11-preview-toolbar-spec-graduated.md` + MEMORY.md pointer.

## Operator plate (decisions & deferrals)

- **Three forks** locked interactively (spec §6.7) — see Summary.
- **Autonomous low-confidence calls (spec §9, all low-risk):** host `showInputBox`
  for the instruction (keeps LLM/secrets out of the sealed webview); Pin targets
  the previewed document via `DiffViewController.pin` (not `activeTextEditor`); new
  `cowriting.editDocument` command for #42 reuse; `cowriting.pinDiffBaseline`
  unhidden (`when: editorLangId == markdown`).
- **Deferred (spec §9):** char-precise sub-block selection mapping; richer #41/#42
  menu sets; scroll-sync (#32); large-rewrite hunk capping; repo rename (#35).

## Deferred decisions

The autonomous calls above (spec §9) were surfaced at closeout: instruction-prompt
location, Pin target, the new `editDocument` command, and unhiding the pin command.
All are low-risk and reversible; none changed the persisted model. No other
low-confidence calls.

## Next-session prompt

```
/goal plan-and-execute #43 (F11), per specs/2026-06-12-f11-preview-toolbar-interaction-surface.md
```

Start with **SLICE-1** (Pin baseline button + unhide `cowriting.pinDiffBaseline`)
— the immediate win that homes the orphaned command. Read
`f11-preview-toolbar-spec-graduated.md` and the graduated spec's §6/§7 first.