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

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+## 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,23 @@
-# 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.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.
+
+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.
+
+## Validation status
+
+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.
+
+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).