prime-agent-dsh 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -10,6 +10,19 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 
 - Added production-oriented installation, support, contribution, conduct, roadmap, and release documentation.
 
+## 0.2.2 - 2026-09-22
+
+### Added
+
+- Added `/dsh help` for concise command and behavior guidance.
+
+## 0.2.1 - 2026-09-22
+
+### Changed
+
+- Made npm installation the primary getting-started path after the verified v0.2.0 publication.
+- Updated GitHub Actions to Node 24-based action runtimes.
+
 ## 0.2.0 - 2026-09-21
 
 ### Added

package/README.md

@@ -6,7 +6,7 @@
 
 A context sidecar for Prime Agent. It turns the active Prime branch into a searchable, rebuildable DeepSeek Harness (DSH) projection, exposes bounded context tools in Python, and reports provider cache use. Prime remains the only agent loop and the only session authority.
 
-> **Not published to npm.** Install from this GitHub repository or a local checkout. The pinned DeepSeek Harness `0.1.6-alpha.2` dependencies are also developer previews.
+> The pinned DeepSeek Harness `0.1.6-alpha.2` dependencies are developer previews. Review the security and compatibility notes before deployment.
 
 ## Why use it?
 
@@ -21,14 +21,10 @@ A context sidecar for Prime Agent. It turns the active Prime branch into a searc
 Requirements, source installation, verification, upgrades, removal, and troubleshooting are in **[Getting started](docs/getting-started.md)**.
 
 ```bash
-git clone https://github.com/moreWax/prime-agent-dsh.git
-cd prime-agent-dsh
-npm install
-npm run release:check
-prime-agent package install "$PWD"
+prime-agent package install npm:prime-agent-dsh
 ```
 
-Restart Prime Agent after installation. Then run `/dsh` and try `dsh_context.current()` in IPython.
+Restart Prime Agent after installation. Then run `/dsh` and try `dsh_context.current()` in IPython. Source and project-local installation instructions are in the getting-started guide.
 
 ## Architecture invariants
 
@@ -52,11 +48,11 @@ The package does not ship a DSH `AgentLoop`, provider wrapper, ACP delegation pa
 | Native RLM inheritance | Available | Bounded untrusted evidence through Prime 0.9.5 lifecycle hooks. |
 | Explicit parent-to-child grants | Available | Bounded, read-only, expiring capabilities. |
 | Provider cache metrics | Available when reported | No cache hit is inferred if the provider omits usage fields. |
-| `/dsh` display toggle | Available | Changes widget visibility only; indexing continues. |
+| `/dsh` display toggle and help | Available | `/dsh`, `/dsh on`, `/dsh off`, `/dsh help`; indexing continues. |
 | Shadow telemetry | Optional | Diagnostic only; never changes provider context. |
 | DSH-driven compaction | Not included | Prime alone decides and performs compaction. |
 | DSH agent loop or tools | Not included | Would create a second execution authority. |
-| npm installation | Not available | Source installation only for this release. |
+| npm installation | Available | `prime-agent package install npm:prime-agent-dsh` |
 
 ## Python API at a glance
 
@@ -99,7 +95,7 @@ For grants and API rules, see [Getting started](docs/getting-started.md#use-the-
 
 ## Project status
 
-`0.2.0` is a developer preview. The Prime integration, storage formats, and Python API may change before a stable release. The test suite covers the documented core paths, but this package is not a security boundary against another process running as the same OS user.
+`0.2.2` is a developer preview. The Prime integration, storage formats, and Python API may change before a stable release. The test suite covers the documented core paths, but this package is not a security boundary against another process running as the same OS user.
 
 The current runtime target is Prime Agent `0.9.5` or newer (`@earendil-works/pi-coding-agent >=0.86.1`). See the [roadmap](ROADMAP.md) for direction rather than release promises.
 

package/docs/getting-started.md

@@ -1,6 +1,6 @@
 # Getting started
 
-This guide installs `prime-agent-dsh` from source. Version 0.2.0 is **not published to npm**.
+This guide covers npm, GitHub, local, and project-scoped installation for `prime-agent-dsh` 0.2.2.
 
 ## Requirements
 
@@ -21,6 +21,20 @@ git --version
 
 The package declares `@earendil-works/pi-coding-agent >=0.86.1` and related Prime packages as peer dependencies. `npm install` installs the pinned DSH runtime dependencies and development tools.
 
+## Install from npm
+
+```bash
+prime-agent package install npm:prime-agent-dsh
+```
+
+Restart Prime Agent after installation, then continue with [Restart and verify](#restart-and-verify).
+
+Update an npm installation with:
+
+```bash
+prime-agent package update npm:prime-agent-dsh
+```
+
 ## Install from GitHub
 
 Clone the repository, validate the exact checkout, and register that checkout with Prime:
@@ -33,7 +47,7 @@ npm run release:check
 prime-agent package install "$PWD"
 ```
 
-Use a tagged release or reviewed commit when one is available. The default branch can contain unreleased work. Do not use `npm install -g prime-agent-dsh` or `npm install prime-agent-dsh`; no npm package is published for this release.
+Use a tagged release or reviewed commit when one is available. The default branch can contain unreleased work. Use Prime's package command rather than installing the package globally with npm.
 
 ## Install for one project
 
@@ -92,11 +106,13 @@ Cache rates can remain `—` when the provider does not report enough usage data
 /dsh
 /dsh on
 /dsh off
+/dsh help
 ```
 
 - `/dsh` toggles the native cache-rate text and reports the resulting state.
 - `/dsh on` shows it.
 - `/dsh off` hides it.
+- `/dsh help` lists the available controls and explains that indexing remains active.
 
 The command controls display only. Projection, indexing, and provider cache measurement continue while the display is hidden. A typical provider-reported value is:
 
@@ -171,7 +187,7 @@ prime-agent package install "$PWD"
 
 If the package was registered locally, run the last command from the target project with `--local` and the absolute checkout path. Restart Prime afterward. `prime-agent package update [source]` exists for package sources that Prime can update, but a manual checkout update makes the reviewed revision explicit.
 
-No manual data migration is required for 0.2.0. On first publication, it removes legacy rebuildable snapshot layouts and prunes old derived generations under the writer lock. It does not change Prime JSONL, user artifacts, grants, or inheritance data.
+No manual data migration is required for 0.2.x. On first publication, it removes legacy rebuildable snapshot layouts and prunes old derived generations under the writer lock. It does not change Prime JSONL, user artifacts, grants, or inheritance data.
 
 ## Uninstall
 

package/extensions/index.ts

@@ -38,7 +38,7 @@ function recentSiblingSession(ctx: ExtensionContext): { id: string; ageMinutes:
   }
 }
 
-export const DSH_VERSION = "0.2.0";
+export const DSH_VERSION = "0.2.2";
 const CACHE_STATUS_KEY = "prime-agent-dsh-cache";
 const CACHE_WIDGET_KEY = "prime-agent-dsh-cache-widget";
 const INSTALLS_KEY = Symbol.for("prime-agent-dsh.installs.v1");
@@ -137,15 +137,26 @@ export default function deepSeekHarnessExtension(pi: ExtensionAPI): void {
   });
 
   pi.registerCommand("dsh", {
-    description: "Toggle DSH cache-rate text and report the resulting state",
+    description: "Toggle DSH cache-rate text, set visibility, or show help",
     handler: async (args, ctx) => {
       await Promise.resolve();
       const action = args.trim().toLowerCase();
+      if (action === "help") {
+        ctx.ui.notify([
+          "DSH commands:",
+          "/dsh — toggle cache-rate text and report the resulting state",
+          "/dsh on — show cache-rate text",
+          "/dsh off — hide cache-rate text",
+          "/dsh help — show this help",
+          "Display controls do not disable indexing or provider cache measurement.",
+        ].join("\n"), "info");
+        return;
+      }
       if (action === "") showCacheDisplay = !showCacheDisplay;
       else if (action === "on") showCacheDisplay = true;
       else if (action === "off") showCacheDisplay = false;
       else {
-        ctx.ui.notify("Usage: /dsh [on|off]", "warning");
+        ctx.ui.notify("Usage: /dsh [on|off|help]", "warning");
         return;
       }
       refreshCacheDisplay(ctx);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prime-agent-dsh",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "DeepSeek Harness context sidecar and Python context objects for Prime Agent.",
   "keywords": [
     "prime-agent",

package/scripts/package-smoke.mjs

@@ -84,7 +84,7 @@ try {
 
   const installed = join(project, "node_modules", "prime-agent-dsh");
   const manifest = JSON.parse(await readFile(join(installed, "package.json"), "utf8"));
-  assert.equal(manifest.version, "0.2.0", "packed plugin version is stale");
+  assert.equal(manifest.version, "0.2.2", "packed plugin version is stale");
   assert.deepEqual(manifest.repository, { type: "git", url: `git+${repositoryUrl}.git` });
   assert.equal(manifest.homepage, `${repositoryUrl}#readme`);
   assert.deepEqual(manifest.bugs, { url: `${repositoryUrl}/issues` });