Skip to content

docs: ADR 0013 + CONTEXT.md — Preview becomes a split-pane workspace - #941

Merged
jeonghun-jj-lee merged 1 commit into
mainfrom
docs/preview-workspace-adr-0013
Sep 10, 2026
Merged

jeonghun-jj-lee merged 1 commit into
mainfrom
docs/preview-workspace-adr-0013

Conversation

@jeonghun-jj-lee

Copy link
Copy Markdown
Contributor

Summary

Documentation-only PR: pins down the design-of-record for #940 (Preview workspace — multi-file tabs, breadcrumb navigation, and split panes) in the repo's durable records ahead of implementation, per the established convention (ADR 0006, ADR 0009).

  • ADR 0013 — the decision to retire Preview's single-file companion model (Preview as sidebar companion — reactive file viewer driven by Sidebar and Chat #931) in favor of a multi-document workspace, the three approaches considered, and the accepted costs (most notably: the workspace state must survive outer-tab switching, which the current single-file SessionPreviewTab does not).
  • CONTEXT.mdPreview and Sidebar glossary entries updated to describe the workspace model (inner tabs, breadcrumb, recursive split panes) instead of the single-file companion viewer.

Source

Design-of-record: #940

Preview redefines from a single-file companion viewer into a multi-document
workspace: inner file tabs, breadcrumb sibling navigation, and recursive
edge-drop split panes. Design-of-record: #940.

- ADR 0013 documents the decision and the three approaches considered
- CONTEXT.md Preview + Sidebar entries updated to the workspace definition
@jeonghun-jj-lee jeonghun-jj-lee added the documentation Improvements or additions to documentation label Sep 9, 2026
@coderabbitai

coderabbitai Bot commented Sep 9, 2026

Copy link
Copy Markdown

Important

  • 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: e94ba4ca-6887-43c7-8fa0-b8e4797090a6


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

jeonghun-jj-lee added a commit that referenced this pull request Sep 9, 2026
Blurring either Developer Tools path field re-sends BOTH current path
values (sendUpdate() always includes both), and the dev-tools-update
handler unconditionally ran a real 'bun run build' + an unconfirmed
'workbench.action.reloadWindow' whenever the amicode path was valid and
non-empty — so even an unrelated edit to the opencode field, or just
re-blurring an unchanged value, silently rebuilt and reloaded the whole
window.

Committing a path is now validate-only for both fields: opencode still
swaps the binary + restarts just the server (lightweight, non-disruptive,
left as-is), and amicode now only checks the path looks like a real repo.
Clearing the amicode path to empty still clears any devAssetRoot override
— that's removing a setting, not building one. Building is now
exclusively an explicit action via the existing 'Rebuild Locally' /
'Rebuild from Main' buttons (a separate dev-tools-rebuild message,
already self-sufficient and unaffected by this change).

TDD: added a test asserting a valid amicodePath commit produces exactly
one synchronous status reply with no building/reloadNeeded and no
devAssetRoot config write. Confirmed RED against the old code (it
eagerly posts building:true before any real build attempt completes,
which is what the interim message the test caught was). Applied the fix,
confirmed GREEN (41/41). Side benefit: this also fixes a latent issue in
the existing tilde-expansion tests, which incidentally spawned a real,
doomed 'bun run build' child process against a fake temp repo before this
fix.
@jeonghun-jj-lee
jeonghun-jj-lee merged commit 68ffcd9 into main Sep 10, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant