@restregular/dsh-powerup 0.0.0-stage → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RestRegular
+
+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,104 @@
-# Temporary Holding Version
+# Power-Up
 
-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.
+Small, opt-in upgrades for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness).
+The first upgrade is a **right-click action menu in the Trajectory view**.
+
+## Install
+
+```bash
+dsh plugin --profile web add @restregular/dsh-powerup
+```
+
+Then open a session, switch to **Trajectory**, and right-click a record row.
+
+## What it does
+
+Right-click a trajectory record:
+
+- **Copy content** — copy the full text of the record.
+- **Copy as quote** — produce a Markdown blockquote with the record kind.
+- **Quote in composer** — insert that quote into the current input box.
+- **Open record details** — open the host's record inspector.
+- **Fork from here** — fork the session at that record (inclusive).
+- **Copy session ID**.
+
+Right-click empty space in the ledger:
+
+- **Export trajectory JSON** — save the current trajectory snapshot.
+- **Copy session ID**.
+- **Open the Power-Up page** — the sidebar control panel.
+
+The sidebar **Power-Up** page turns the menu on or off and lists the available
+actions. The setting is stored in the browser.
+
+### Menu keys
+
+`↑` / `↓` move, `Home` / `End` jump, `Enter` runs, `Esc` closes.
+
+## Update a plugin
+
+Open the built-in **Plugins** page. Every third-party card under **Installed
+plugins** gains a small update icon in its action area. Clicking it opens the
+update dialog:
+
+1. The dialog reads the package's published versions from the same registry the
+   **Add plugin** dialog uses — the remembered choice, or the Host's configured
+   registry, with npmmirror as a configured fallback. Type a version or pick one
+   from the dropdown.
+2. Confirming removes the installed copy, checks the new spec the way **Add
+   plugin** does, and installs the selected version without enabling it.
+3. The dialog then asks whether to enable the new version.
+4. After enabling, it asks whether to restart DSH. On the desktop app the
+   `lib/restart-helper.cjs` helper relaunches the exact executable after the old
+   Host exits; under `dsh web` the dialog explains that the terminal owns the
+   process.
+
+Power-Up does not update itself through this button: removing the plugin would
+unload the dialog mid-flow. Use **Add plugin** with the new package version.
+
+## Design notes
+
+- **Theme-safe by construction.** Every surface, border, text color, hover and
+  switch state uses the host's `--dsw-alias-*` tokens. The switch follows the
+  host convention (`--dsw-alias-border-l3` / `--dsw-alias-switch-thumb` off,
+  `--dsw-alias-brand-primary` + `--dsw-alias-label-primary-foreground` on), so
+  it stays readable in both light and dark themes. The only literal colors live
+  inside the plugin's brand SVG artwork.
+- **Two icons, two jobs.** `icon.svg` is the 256px brand tile shown by the
+  Plugin Manager. The sidebar uses the same double-chevron mark as a 16-grid,
+  `fill:none`, `stroke:currentColor` line drawing, but without the tile frame:
+  the mark gets the full grid, so the chevrons and the amber baseline never
+  collide with a border. The reference line artwork is
+  `design/sidebar-icon.svg`; the runtime copy lives in `client.js`.
+- **No imports from Harness Client packages.** The menu is plain React + CSS and
+  observes the trajectory package's own `data-*` contracts. If those attributes
+  change, row-specific actions degrade gracefully; session-level actions in the
+  empty ledger area keep working.
+- **The update entry uses the built-in page's contracts.** The Plugins page has
+  no per-card slot, so the overlay injects one button into every
+  `[data-plugin-group="bundles"] [data-plugin-package]` card and re-asserts it
+  after React renders. Version listing is a plain registry `GET`; removal and
+  installation use the same `remote.pluginManager` calls as **Add plugin**. Only
+  the process restart needs Host code: a loopback-only
+  `/dsh-powerup/api/restart` route.
+- **The dialog mirrors the host modal.** The backdrop is
+  `--dsw-alias-bg-mask-1` with the shared mask blur, the surface is
+  `--dsw-alias-bg-layer-2` with `--dsw-radius-panel` and
+  `--dsw-elevation-prominent`, and the primary button uses
+  `--dsw-alias-button-primary-fill` / `-hover`, so the dialog follows both
+  themes instead of inventing its own palette. The registry picker and version
+  list are custom controls built from `--dsw-alias-*` tokens.
+
+## Development
+
+```bash
+node test/smoke.mjs
+```
+
+The smoke test loads the real Client module with React/browser doubles, applies
+it to a fake slot context, and checks registrations, icons, helpers, theme
+tokens, and the manifest.
+
+## License
+
+MIT © RestRegular