@compn3rd/pi-web-code-review 0.0.0-stage → 0.1.2

package/CHANGELOG.md

@@ -0,0 +1,47 @@
+# Changelog
+
+## 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).
+
+### Added
+
+- **Compare revisions** source for reviewing accumulated changes across commits or branches, with editable base/target revisions.
+- Merge-base (`A...B`) branch review and direct (`A..B`) commit-tree comparisons, defaulting to `main` → `HEAD`.
+- Frozen commit endpoints in file requests, saved comments, and feedback labels; editing reopens the original comparison even after branch tips move.
+- Real-Git coverage for divergent branches, dirty-index/worktree exclusion, moving refs, and direct multi-commit comparisons, plus browser cancellation and comment-restoration tests.
+
+### Changed
+
+- Distribute under the `@compn3rd` scope instead of the unscoped package name. Install with `npm:@compn3rd/pi-web-code-review` in PI WEB's Pi packages settings.
+- Use a theme-aware magnifying glass icon for the Review panel.
+- Update the supported PI WEB minimum to `1.202610.3`, matching the published composer-chip API.
+- Resolve all 38 typed lint findings while retaining asynchronous disposal and attachment-ownership guards.
+- Normalize non-Error storage mutation failures to Errors with the original exception retained as the cause.
+- Strengthen test fixtures and add coverage for the panel icon and non-Error mutation failures.
+
+### Compatibility and validation
+
+- Requires PI WEB `>=1.202610.3` and Node.js `>=22.19.0`.
+- Plugin ID, review storage keys, and IndexedDB database name remain unchanged; no review data migration is introduced by the npm scope change.
+- Automated verification covers typechecking, lint, 82 tests, browser/server builds, and unpacked/packed artifact smoke checks.
+- Live-host send/acceptance and remote-machine acceptance testing remain pending; see [compatibility results](docs/compatibility.md).
+
+Installation and live-host acceptance testing are separate from publication. This release does not install the plugin into a running host or restart its daemon.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Federico Jaramillo Martinez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,31 @@
-# Temporary Holding Version
+# Code Review for PI WEB
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A standalone Review tab for workspace files, staged/unstaged Git changes, and accumulated branch/commit comparisons. Save line-range comments, then attach a removable review chip to the selected conversation. No host patches or prompt-text insertion are required.
+
+## Requirements and installation
+
+Patch release: **0.1.2**. 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.
+
+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.
+
+## 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.
+
+## Redesigned review panel
+
+Click a line number to open a focused comment editor directly beneath that line. The file sidebar sits beside the viewer on wide panels and stacks above it on narrow panels. Saved-comment and draft counts appear in the full-width header alongside **Attach review to composer**; only saved comments are attached.
+
+![Redesigned review panel](docs/screenshots/review-after.png)
+
+Standalone browser preview with sample content, not a live-host screenshot. [Before redesign](docs/screenshots/review-before.png).
+
+## Validation status
+
+Typechecking, all 84 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.
+
+See the [composer design](docs/composer-design.md), [usage guide](docs/usage.md), [development guide](docs/development.md), and [compatibility results](docs/compatibility.md).
+
+Adapted from the Code Review UI branch and PI WEB's MIT-licensed plugin examples; see [LICENSE](LICENSE).