@compn3rd/pi-web-code-review 0.1.1 → 0.2.0

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## 0.2.0
+
+### Added
+
+- Switchable **Workbench** and **Focus** layouts in the panel’s **Review settings**, with browser-local layout and code-wrap preferences.
+- Workbench file navigation and saved-feedback rail; Focus inline feedback, file switcher and collapsible review summary. Layout changes preserve the active file, range and draft.
+- Phone file/notes sheets, touch-sized controls, wrapped code, numeric range disclosure, and responsive source/comparison controls.
+- Production-bundle Chromium checks and dark/light desktop/phone screenshots. Regression coverage increases from 84 to 99 tests.
+
+### Changed
+
+- Require PI WEB **>=1.202610.6** and migrate the browser entry to API **v5**.
+- Opt into public `stylesheet-integration` v1 with host shared UI primitives and theme-aware, component-scoped CSS. Server API v3 and read-only Git operations are unchanged.
+- Compact source selection and move path/help/range details behind disclosures. Keep saved comments and unsaved drafts distinct; attaching still does not send.
+- Update Vite/Vitest development dependencies to patched versions; dependency audit is clean.
+- Exclude design-study source and prototype assets from the published package; ship production screenshots and user documentation.
+
+### Validation and limits
+
+- Typecheck, lint, 99 tests, builds, unpacked/packed artifact smoke checks, and production-bundle browser checks pass.
+- Chromium checks cover both layouts at 360/390/430px, dark/light palettes, wrapping, dialogs, draft preservation, range editing and mocked attachment.
+- Live-host shared styling, real phone keyboards and end-to-end send/remote acceptance remain follow-up checks. No daemon restart or installation is part of release preparation.
+- Comment schema, IndexedDB data and composer acceptance semantics are unchanged; no comment migration is required.
+
+## 0.1.2 — 2026-10-16
+
+### Changed
+
+- Open and focus comment editors directly beneath the selected code line, inside the file viewer, instead of below the entire file.
+- Use a full-width header with saved-comment and unsaved-draft status, and move **Attach review to composer** to the header.
+- Place file navigation beside the viewer on wide panels and stack it above the viewer on narrow panels.
+- Highlight the active file and improve empty states, keyboard hints, focus indicators, and source-control layout.
+- Keep changed-snapshot drafts accessible outside the code view without losing their text or allowing an invalid save.
+
+### Validation and compatibility
+
+- Add regression tests for inline editor placement, focus, header action placement, active-file state, and changed-snapshot draft preservation (84 tests total).
+- Capture browser-rendered before/after screenshots with the same sample file and draft; these are standalone previews, not live-host acceptance tests.
+- No host API, storage format, or server behavior changes. Requirements remain PI WEB `>=1.202610.3` and Node.js `>=22.19.0`.
+- Live-host acceptance and remote-machine testing remain outstanding; see [compatibility results](docs/compatibility.md).
+
 ## 0.1.1 — 2026-10-15
 
 Package: **`@compn3rd/pi-web-code-review`** (public npm scope).

package/README.md

@@ -4,20 +4,39 @@ A standalone Review tab for workspace files, staged/unstaged Git changes, and ac
 
 ## Requirements and installation
 
-Patch release: **0.1.1**. Requires **PI WEB >=1.202610.3**, Node.js **>=22.19.0**, and Git for staged/unstaged and revision-comparison review. Compatibility checks were performed against PI WEB `1.202610.3`; later releases are allowed but have not been independently tested.
+Version **0.2.0** requires **PI WEB >=1.202610.6**, Node.js **>=22.19.0**, and Git for staged/unstaged and revision-comparison review. Tested against PI WEB `1.202610.6`; later releases have not been independently verified.
 
 Install `npm:@compn3rd/pi-web-code-review` through **Settings → Pi packages** on the target machine, then enable **Code Review** in **Settings → PI WEB plugins**. For local builds and manual installation, see the [usage guide](docs/usage.md).
 
 This package includes a server plugin: restart the target session daemon when safe, then reload the browser. Restarting interrupts active sessions and terminals; do it from outside the sessions that daemon hosts. Install the package on each remote machine where you want to review files.
 
+## Two review layouts
+
+Open **Review settings** in the panel header to choose:
+
+- **Workbench** — persistent file navigation, code viewer, and saved-feedback rail on wide panels. On phones, files and notes open in sheets.
+- **Focus** — a wide code view with inline feedback, a file switcher, and a collapsible saved-review summary.
+
+The layout and **Wrap code** preference are saved for this browser, across workspaces. Switching layouts preserves the current file, line range, and unsaved draft. Unsaved drafts are not persisted across browser reloads or workspace changes.
+
+![Workbench layout](docs/screenshots/0.2.0/workbench-desktop.png)
+
+[Focus layout](docs/screenshots/0.2.0/focus-desktop.png) · [Phone Workbench](docs/screenshots/0.2.0/workbench-phone.png) · [Phone Focus](docs/screenshots/0.2.0/focus-phone.png) · [Phone settings](docs/screenshots/0.2.0/phone-settings.png)
+
+Screenshots render the production bundle with sample backend data, not a live PI WEB host. Phone captures use Chromium at phone viewport sizes, not real devices.
+
 ## Review workflow
 
-Open the **Review** tab, choose workspace files, staged/unstaged changes, or **Compare revisions**, and save line-range comments. Compare `main...HEAD` for branch work since its merge base, or `HEAD~3..HEAD` for accumulated work between commits. Comparison comments retain frozen commit IDs. Select a ready conversation and choose **Attach review to composer** to stage a removable **Review (N)** chip. Send it with a message or by itself. Removing the chip preserves saved comments; server acceptance clears only unchanged submitted comments.
+Choose **Files**, **Unstaged**, **Staged**, or **Compare**. Compare `main...HEAD` for branch work since its merge base, or `HEAD~3..HEAD` for accumulated work between commits. Comparison comments retain frozen commit IDs.
+
+Click or tap a line number to open an inline comment editor. Shift-click extends the range; on phones, expand **Line range** to edit the coordinates. Save your comments, select a ready conversation, and choose **Attach review to composer**. This stages a removable **Review (N)** chip; it does not send a message or include unsaved drafts. Removing the chip preserves saved comments. Server acceptance clears only unchanged submitted comments.
+
+## Validation
 
-## Validation status
+Typechecking, lint, **99 tests**, builds, and unpacked/packed artifact smoke checks pass. Production-bundle Chromium checks cover dark/light palettes, phone widths **360/390/430px**, wrapping, settings, draft preservation, sheets, keyboard modality, range editing and mocked composer attachment. `npm audit` reports no known vulnerabilities in the resolved dependency tree.
 
-Typechecking, all 82 tests, builds, and unpacked/packed artifact smoke checks passed against PI WEB `1.202610.3`. Full automated verification passes; live-host acceptance testing is pending. Publication is enabled for the scoped patch release; these remaining checks are follow-up work, not claims of completed validation.
+Live-host shared styling, real phone keyboards, remote-machine behavior and end-to-end send acceptance remain follow-up validation; they are not claimed as completed.
 
-See the [composer design](docs/composer-design.md), [usage guide](docs/usage.md), [development guide](docs/development.md), and [compatibility results](docs/compatibility.md).
+See the [usage guide](docs/usage.md), [development guide](docs/development.md), [compatibility results](docs/compatibility.md), and [composer design](docs/composer-design.md).
 
 Adapted from the Code Review UI branch and PI WEB's MIT-licensed plugin examples; see [LICENSE](LICENSE).