@diffexai/diffex 0.2.1 → 0.2.2

package/distribution-files.json

@@ -1,5 +1,5 @@
 {
-  "sourceCommit": "f2a661684af35fe6e9a3209c6f9720144e1fd423",
+  "sourceCommit": "dbe80a9dfe730c776a99be1ea9c439fe6b3cc023",
   "algorithm": "sha256",
   "files": [
     {
@@ -212,11 +212,11 @@
     },
     {
       "path": "dist/config.d.ts",
-      "sha256": "d6524457bfa03ad6d309db76878a78b15b08e79413277c15175b3297c8e52977"
+      "sha256": "80ac9e0240538f6687de4f57f15f6eb8a9b91a775cc5f5bc3e622b2cbdb0fdea"
     },
     {
       "path": "dist/config.js",
-      "sha256": "716aedbf5cc2829da6ce73c29ef592165802454652cb9d3c820a832a2cbea9e3"
+      "sha256": "40a190d6ff17ea594b7821fdd01514cbbc40b11afb065f3fd8618eed5f08b3c6"
     },
     {
       "path": "dist/core/account-auth-storage.d.ts",
@@ -644,7 +644,7 @@
     },
     {
       "path": "dist/core/prompt-templates.js",
-      "sha256": "f8588ceb9db41c5b7e09916a1f140878546c2a615d42987558f2818fa40b296b"
+      "sha256": "b85c46f913a73ee6f91ee10ad24565487f20b64f4fd327821c01ad20abb4d8de"
     },
     {
       "path": "dist/core/provider-attribution.d.ts",
@@ -828,7 +828,7 @@
     },
     {
       "path": "dist/core/system-prompt.js",
-      "sha256": "3672bec049bb1f3df749c0893c6f41000028fa34227cce469bfd9036ab17b6bd"
+      "sha256": "1c848d3dcf8bba0f631962b364eb78b25054aae26eb7185fedbfc8412c6293af"
     },
     {
       "path": "dist/core/telemetry.d.ts",
@@ -1988,27 +1988,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/distribution-components.json",
-      "sha256": "71b0901531f95dafee515729146016eb7e387ebd067ec764e6ebee5d4e121a36"
+      "sha256": "2b7c398597eac8939d8f3f5d4f852993ff55d6b1d3ab13ad17adab43d6501337"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/distribution-files.json",
-      "sha256": "a8ab47f1851ae411d0d28e7849c843d0df6e4bae8ed6503c4bdbd01ba9b94958"
+      "sha256": "697ae4435e3c8e51498ded1eaa533e3b3a90f3d681ce370d95ab659942d84599"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/LICENSE",
       "sha256": "35a4476d361a333186451f77937c9a070027ab3a83e3661fad4ccca8ac2b0a99"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-agent-core/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/package.json",
-      "sha256": "cdced68a704adc1888b1fc44dbe0515715b96f976cec044cec853141da1d2764"
+      "sha256": "c0e99f6f683f3502f0e0f2428ae908647ce5e715b18dc006c7cd1cf28c172ff4"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/api/anthropic-messages.d.ts",
@@ -2684,7 +2680,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/.manifest.json",
-      "sha256": "2b5e284976eac0be4991a7e55382bb7cb3323940f8519be330b6b29927e465e0"
+      "sha256": "a4a35601c160a11bfa75d83eebbeba2cbe0e995edb945a0ae4174546c2d40dfb"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/amazon-bedrock.json",
@@ -2792,7 +2788,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/openrouter.json",
-      "sha256": "14f7cd6992411e94e60e61b200b3aaad6d4371b60d11da6f1546db96cd2c1fbe"
+      "sha256": "54df34bb4328e36b52560e2979bc9da3dcf0501093bd3c82cbbb3d7227eb48bd"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/qwen-token-plan-cn.json",
@@ -2812,7 +2808,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/vercel-ai-gateway.json",
-      "sha256": "e6e9eb2c2da25c85d428dab15765c5c539d73003a7acd432b238c86c5a398121"
+      "sha256": "f9ff06709a675af6723ee6983bf55143d21e1d24b52cd35b16e95834574c6667"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/xai.json",
@@ -3556,27 +3552,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/distribution-components.json",
-      "sha256": "c97478a3621ba61008b85740af492bf59544725ddb089f75aaff7df6a69c1508"
+      "sha256": "d341df8514aa0a75f1da23d5c4fff76f8f022466babad294c53ee23427090a97"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/distribution-files.json",
-      "sha256": "a3530567f07c8c6a441a7e5c6176f846304613680a9f9b7dd786a95e173e07cf"
+      "sha256": "039f86fe62b7a1549d94297690f9ccc1b471e1022d7cdade5bd69a65b8f449a5"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/LICENSE",
       "sha256": "35a4476d361a333186451f77937c9a070027ab3a83e3661fad4ccca8ac2b0a99"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-ai/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/package.json",
-      "sha256": "d9621bac4eebd476af495422c85b6525a801310e3468b3c6d60d39108ab79c13"
+      "sha256": "995f91deb3dff8777dfc629d530718b4508ec6a0bb102dd7ac6f71037e94a19f"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/dist/client.d.ts",
@@ -3676,27 +3668,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/distribution-components.json",
-      "sha256": "bf1f74465b67e7bd111a5f38e419586aeb754853ded3b4a0782774d6359874b1"
+      "sha256": "d53d6a3cd94e01f02e63275b582ab07edbd0c47b77badc8721257814bbcf8750"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/distribution-files.json",
-      "sha256": "6d342e688f45cb2f240812ca8f59d16420e00a76bd90f3fafea47a22b3988804"
+      "sha256": "e283a8adb7d4d15bdcacdbd4472c7e02119f496990bcaefc477e75f0b7d42b3a"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/LICENSE",
       "sha256": "35a4476d361a333186451f77937c9a070027ab3a83e3661fad4ccca8ac2b0a99"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-client/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/package.json",
-      "sha256": "0f2932f24ff7041e00abf09ba169b1620a7b2c738ab4f4a71512ceda4c2c1519"
+      "sha256": "1aa82b42caabccbd4acce3354c64bb5164c253234611ddbf3c0488955e07215b"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/dist/index.d.ts",
@@ -3708,27 +3696,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/distribution-components.json",
-      "sha256": "3b8188af3fab862bc686f6908c544399bf9c37360e78bcd30e70b4e0254a1068"
+      "sha256": "ad9310f1110d6dcfdf0bdfcae7e1771a5dfc541f39027285f5f7921863acc3d9"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/distribution-files.json",
-      "sha256": "55edd0a2954c45cbf12aff791e4ba5c8f037072bf40087f605cd8ce562cf2c9d"
+      "sha256": "ce4c775db70f7a373ec49d1787fb755bb482bdb859f3f2da4eb45755dca8dff6"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/LICENSE",
       "sha256": "35a4476d361a333186451f77937c9a070027ab3a83e3661fad4ccca8ac2b0a99"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-harness-state/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/package.json",
-      "sha256": "a2fd31f702b1277d7f75ce64dd59f15ca507b18e302dcdee8f5cf760a383e0b4"
+      "sha256": "7e223bbb91c107ef1181246c560bbc48f53adca5728a3b51befa0191b5e1af6d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/dist/cbor/decoder.d.ts",
@@ -3796,27 +3780,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/distribution-components.json",
-      "sha256": "46686075070e30a0de4325197220eeb25d8e33a813410bc43eac55d962ad2935"
+      "sha256": "c93a990ed75c2a31059b49d51c92e71784dfc9de92071a8cdf109aa1ef4b25ab"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/distribution-files.json",
-      "sha256": "5ccc4cbd5d95c3814b219aad9aa1bce059ae2cff63ffb2504ff924df91d837b2"
+      "sha256": "dd47fd5c20d8f54d398823bd0c9909c959528940ee161f191b5b1cec58eede89"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/LICENSE",
       "sha256": "35a4476d361a333186451f77937c9a070027ab3a83e3661fad4ccca8ac2b0a99"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-protocol/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/package.json",
-      "sha256": "32dbe80fe4124c154774da0ef035a5284f0d3a35c3661115cef883cc84ad96e1"
+      "sha256": "6d14f124f22cf5031538e66ec215304e716ecce01d4e5e1aef9899b057c09b77"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/dist/index.d.ts",
@@ -3868,27 +3848,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/distribution-components.json",
-      "sha256": "2fbe9af183c9712f7c373c4bc7fe87381ace17499c9d4490668197c9a9d7b982"
+      "sha256": "18de9d95f312884223e4981a08cba0e7042259309f3fe2371e77fe81c63e94d8"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/distribution-files.json",
-      "sha256": "b50253eaf34ccb7af5fc691f3a1f82d68866e833953b0754c38a29948cfe1691"
+      "sha256": "143fb292dbcd1451c630c38785a1f0c51cb2d83ccf912b803acb4060480a8407"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/LICENSE",
       "sha256": "35a4476d361a333186451f77937c9a070027ab3a83e3661fad4ccca8ac2b0a99"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-telemetry/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/package.json",
-      "sha256": "cfe29808e29fe3a588bb668a5902427c613ae034fa72ec5df836881e9241d9e8"
+      "sha256": "358c9c496e8697e4a01e6a591faa73b10559beed6ef2910ee35175eacbde162e"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/dist/autocomplete.d.ts",
@@ -4204,11 +4180,11 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/distribution-components.json",
-      "sha256": "e8c8eb8afab61df551d5edff8bd55ae92e72c44a27a190961981a08e075d67d5"
+      "sha256": "7a2a182a78c4eb0c24bf47aab558601482e2f7adecfcac380cf715446ee0c30d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/distribution-files.json",
-      "sha256": "d72f92d7640452729e9279d87f04a0bd64da6584d06ac35178a50be3c0887e0b"
+      "sha256": "39098e6768aba929ab003cd40350819d10f4e2499695645496d00987fa23df96"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/LICENSE",
@@ -4230,17 +4206,13 @@
       "path": "dist/node_modules/@diffexai/diffex-tui/native/win32/prebuilds/win32-x64/win32-console-mode.node",
       "sha256": "e40df72050ed02d451dee887b2e2a7408d7de27c5f483af8c489801bb3ae098d"
     },
-    {
-      "path": "dist/node_modules/@diffexai/diffex-tui/NOTICE",
-      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
-    },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/package.json",
-      "sha256": "cd23216d3cb3a5a09a1a43d0fbc010d6b7bdcbd11c8e0e6c8eda0d7de59bf2e4"
+      "sha256": "1292583d437cc28f7136c0b70ac67fc99c91fe02dbc78da705e5e1c2ac811c8f"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/THIRD-PARTY-NOTICES.txt",
-      "sha256": "26a9889ffbcd21dbef5db453156ec85dc469580be6be9ee82800e0244e0f8b76"
+      "sha256": "8871426fbd5907b1bf5c4e462c5c5c4f0d89fc3f3d527d0ab3a18f67d5da2f4d"
     },
     {
       "path": "dist/package-manager-cli.d.ts",

package/docs/installation.md

@@ -0,0 +1,118 @@
+# Install, update, and remove Diffex
+
+Diffex is distributed through npmjs.org as `@diffexai/diffex`.
+Use Node.js 22.19.0 or newer and npm on macOS or Linux, on arm64 or x64.
+Windows, Android/Termux, standalone binaries, and additional installation channels are not accepted release targets.
+The hosted runtime image is for the cloud service.
+
+## Install and verify
+
+```sh
+node --version
+npm --version
+npm install -g --ignore-scripts --registry=https://registry.npmjs.org @diffexai/diffex
+diffex --version
+diffex --help
+diffex --list-models
+```
+
+Only the CLI package is needed; its internal Diffex modules are included.
+`--ignore-scripts` disables dependency installation scripts.
+Npm verifies downloaded package bytes against registry integrity metadata.
+For a reproducible installation, replace the package argument with `@diffexai/diffex@<verified-version>`, using an exact version you have checked on npmjs.org.
+
+The executable directory is `$(npm prefix -g)/bin` on supported platforms.
+If `diffex` is not found, add that directory to your shell's PATH:
+
+```sh
+export PATH="$(npm prefix -g)/bin:$PATH"
+command -v diffex
+diffex --version
+```
+
+Persist the PATH setting in your shell configuration if necessary.
+Use a Node version manager or a user-writable npm prefix when the global directory is not writable.
+Changing Node installations can change the npm prefix; check `command -v diffex` after switching.
+
+Start `diffex` in your project directory, use `/login` to configure your provider, and send a short prompt.
+See [Quickstart](quickstart.md) and [Providers](providers.md) for authentication and execution.
+
+## Upgrade
+
+```sh
+diffex update --self
+diffex --version
+```
+
+Self-update validates the response from `https://api.diffex.ai/api/latest-version` and installs exactly `@diffexai/diffex@<verified-version>` using the detected package manager.
+It rejects malformed metadata, foreign package names, redirects, and unavailable discovery before starting installation.
+`--force` permits reinstalling a verified release; it does not bypass identity checks.
+The discovery service can report no generally announced release even when a bootstrap package exists on npm.
+
+To install a reviewed npm version directly, including when discovery has no release:
+
+```sh
+npm install -g --ignore-scripts --registry=https://registry.npmjs.org '@diffexai/diffex@<verified-version>'
+diffex --version
+```
+
+Replace `<verified-version>` before running the command.
+Use your original npm prefix if it differs from the active default.
+Legacy clients that still trust Pi cannot migrate just by contacting the Diffex endpoint.
+Install the canonical package directly with the command above, then verify `command -v diffex` and `diffex --version`.
+
+## Recover an interrupted installation
+
+Npm owns replacement of an npm installation.
+If an update was interrupted or `diffex` no longer starts, repeat the pinned npm install command with the same verified version and prefix, then check `diffex --version` and `diffex --help`.
+Do not remove your user-data directory to repair an executable installation.
+Npm can begin filesystem replacement before a download finishes.
+If retrying reports `ENOTEMPTY` while renaming to a `.diffex-...` backup, move that reported backup directory aside.
+If npm instead reports `ENOTEMPTY` while removing a dependency inside `$(npm root -g)/@diffexai/diffex`, move that complete CLI installation directory aside.
+This preserves the partially installed package and lets npm install into an empty destination.
+Use a separate backup directory and retry:
+
+```sh
+DIFFEX_RECOVERY_FROM='/exact/affected/CLI/installation/or/backup'
+DIFFEX_RECOVERY_DIR="$(mktemp -d)"
+mv "$DIFFEX_RECOVERY_FROM" "$DIFFEX_RECOVERY_DIR/"
+npm install -g --ignore-scripts --registry=https://registry.npmjs.org '@diffexai/diffex@<verified-version>'
+diffex --version
+diffex --help
+```
+
+Replace both placeholders with the affected Diffex installation or backup path and the verified version.
+Move only the `@diffexai/diffex` package directory or its reported `.diffex-...` backup, preserving it until the repaired installation works.
+Do not move the global prefix, its shared `node_modules`, or another package.
+This procedure does not move or delete your settings or sessions.
+
+## Remove
+
+```sh
+npm uninstall -g --ignore-scripts @diffexai/diffex
+command -v diffex
+```
+
+Use the npm prefix that installed the executable.
+The final command should find no executable unless another installation remains on PATH.
+If your shell caches command locations, open a new terminal or refresh its command cache.
+
+Removal retains settings, credentials, sessions, installed extensions, and harness data under `~/.diffex/agent/`, or the directory selected by `DIFFEX_CODING_AGENT_DIR`.
+Project `.diffex` directories and any separately configured session directory are also retained.
+Keep this data for reinstallation; delete it separately only if you intend to erase it.
+
+## Bun package installations
+
+The same npm package can also be installed by Bun while running on Node:
+
+```sh
+bun install -g --ignore-scripts @diffexai/diffex
+diffex --version
+diffex update --self
+bun uninstall -g @diffexai/diffex
+```
+
+Use `bun pm bin -g` to locate Bun's global executable directory and add it to PATH.
+Pin direct upgrades to the reviewed `@diffexai/diffex@<verified-version>` in the install command.
+Use the manager that owns the installation for repair and removal.
+User data follows the same retention policy.

package/docs/quickstart.md

@@ -4,33 +4,15 @@ This page gets you from install to a useful first Diffex session.
 
 ## Install
 
-Diffex is distributed as an npm package:
+Use Node.js 22.19.0 or newer on macOS or Linux, on arm64 or x64.
+Install the canonical package from npmjs.org:
 
 ```bash
-npm install -g --ignore-scripts @diffexai/diffex
+npm install -g --ignore-scripts --registry=https://registry.npmjs.org @diffexai/diffex
+diffex --version
 ```
 
-`--ignore-scripts` disables dependency lifecycle scripts during install. Diffex does not require install scripts for normal npm installs.
-
-### Uninstall
-
-Use the package manager that installed Diffex:
-
-```bash
-# npm
-npm uninstall -g @diffexai/diffex
-
-# pnpm
-pnpm remove -g @diffexai/diffex
-
-# Yarn
-yarn global remove @diffexai/diffex
-
-# Bun
-bun uninstall -g @diffexai/diffex
-```
-
-Uninstalling Diffex leaves settings, credentials, sessions, and installed Diffex packages in `~/.diffex/agent/`.
+See [Installation](installation.md) for PATH setup, pinned versions, updates, recovery, removal, and retained user data.
 
 Then start Diffex in the project directory you want it to work on:
 
@@ -175,4 +157,5 @@ Use `--mode json` for JSON event output or `--mode rpc` for process integration.
 - [Keybindings](keybindings.md) - shortcuts and customization.
 - [Diffex Packages](packages.md) - install shared extensions, skills, prompts, and themes.
 
-Platform notes: [Windows](windows.md), [Termux](termux.md), [tmux](tmux.md), [Terminal setup](terminal-setup.md), [Shell aliases](shell-aliases.md).
+Terminal notes: [tmux](tmux.md), [Terminal setup](terminal-setup.md), [Shell aliases](shell-aliases.md).
+Windows and Android/Termux are not accepted release targets.

package/npm-shrinkwrap.json

@@ -1,12 +1,12 @@
 {
 	"name": "@diffexai/diffex",
-	"version": "0.2.1",
+	"version": "0.2.2",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@diffexai/diffex",
-			"version": "0.2.1",
+			"version": "0.2.2",
 			"license": "Apache-2.0",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diffexai/diffex",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Coding agent CLI with read, bash, edit, write, update_plan tools and session management",
   "type": "module",
   "imports": {
@@ -8,7 +8,8 @@
     "#harness-trace": "./dist/vendor/harness-trace/index.js"
   },
   "diffexConfig": {
-    "configDir": ".diffex"
+    "configDir": ".diffex",
+    "production": true
   },
   "bin": {
     "diffex": "dist/cli.js"
@@ -30,11 +31,40 @@
   },
   "files": [
     "dist",
-    "docs",
+    "docs/compaction.md",
+    "docs/containerization.md",
+    "docs/custom-provider.md",
+    "docs/environment-variables.md",
+    "docs/evolution.md",
+    "docs/extensions.md",
+    "docs/installation.md",
+    "docs/json.md",
+    "docs/keybindings.md",
+    "docs/llama-cpp.md",
+    "docs/models.md",
+    "docs/packages.md",
+    "docs/prompt-templates.md",
+    "docs/providers.md",
+    "docs/quickstart.md",
+    "docs/rpc.md",
+    "docs/sdk.md",
+    "docs/security.md",
+    "docs/session-format.md",
+    "docs/sessions.md",
+    "docs/settings.md",
+    "docs/shell-aliases.md",
+    "docs/skills.md",
+    "docs/terminal-setup.md",
+    "docs/themes.md",
+    "docs/tmux.md",
+    "docs/tui.md",
+    "docs/usage.md",
+    "docs/images/interactive-mode.png",
+    "docs/images/tree-view.png",
+    "README.md",
     "CHANGELOG.md",
     "npm-shrinkwrap.json",
     "LICENSE",
-    "NOTICE",
     "THIRD-PARTY-NOTICES.txt",
     "distribution-components.json",
     "distribution-files.json",
@@ -91,12 +121,8 @@
   ],
   "author": "Mario Zechner",
   "license": "Apache-2.0",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/diffexai/diffex.git",
-    "directory": "packages/coding-agent"
-  },
   "engines": {
     "node": ">=22.19.0"
-  }
+  },
+  "homepage": "https://diffex.ai/"
 }

package/release/distribution-manifest.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "version": "0.2.1",
+  "version": "0.2.2",
   "source": {
     "repository": "diffexai/diffex",
-    "commit": "f2a661684af35fe6e9a3209c6f9720144e1fd423",
+    "commit": "dbe80a9dfe730c776a99be1ea9c439fe6b3cc023",
     "visibility": "private"
   },
   "disclosurePolicy": {
@@ -43,7 +43,7 @@
       "HTML export templates and their reviewed marked/highlight.js bundles",
       "runtime theme and model JSON",
       "SQLite migration SQL",
-      "documentation including inline examples",
+      "user-facing documentation explicitly listed in scripts/distribution-docs.json",
       "Diffex-owned TUI native prebuilds using system APIs"
     ],
     "publicHosting": "npmjs",
@@ -63,13 +63,14 @@
       "protocol",
       "telemetry",
       "tui"
-    ]
+    ],
+    "developmentDocumentation": "exclude from all distribution artifacts, including bootstrap and hosted runtime; keep private development records in the source repository"
   },
   "packages": [
     {
       "name": "@diffexai/diffex",
-      "version": "0.2.1",
-      "tarball": "https://registry.npmjs.org/@diffexai/diffex/-/diffex-0.2.1.tgz"
+      "version": "0.2.2",
+      "tarball": "https://registry.npmjs.org/@diffexai/diffex/-/diffex-0.2.2.tgz"
     }
   ],
   "binaryPlatforms": [],

package/release/install-package-lock.json

@@ -1,14 +1,14 @@
 {
 	"name": "@diffexai/diffex-coding-agent-install",
-	"version": "0.2.1",
+	"version": "0.2.2",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "@diffexai/diffex-coding-agent-install",
-			"version": "0.2.1",
+			"version": "0.2.2",
 			"dependencies": {
-				"@diffexai/diffex": "0.2.1"
+				"@diffexai/diffex": "0.2.2"
 			},
 			"engines": {
 				"node": ">=22.19.0"
@@ -450,8 +450,8 @@
 			}
 		},
 		"node_modules/@diffexai/diffex": {
-			"version": "0.2.1",
-			"resolved": "https://registry.npmjs.org/@diffexai/diffex/-/diffex-0.2.1.tgz",
+			"version": "0.2.2",
+			"resolved": "https://registry.npmjs.org/@diffexai/diffex/-/diffex-0.2.2.tgz",
 			"license": "Apache-2.0",
 			"dependencies": {
 				"@anthropic-ai/sdk": "0.91.1",

package/release/install-package.json

@@ -1,10 +1,10 @@
 {
 	"name": "@diffexai/diffex-coding-agent-install",
-	"version": "0.2.1",
+	"version": "0.2.2",
 	"private": true,
 	"description": "Lockfile root used by the Diffex installer and updater.",
 	"dependencies": {
-		"@diffexai/diffex": "0.2.1"
+		"@diffexai/diffex": "0.2.2"
 	},
 	"overrides": {
 		"protobufjs": "7.6.5",

package/NOTICE

@@ -1,6 +0,0 @@
-Diffex
-Copyright 2026 Luntraa, Inc.
-
-Where this distribution contains Pi Agent Harness-derived portions,
-those portions retain their MIT terms and copyright notice in LICENSE.
-The Apache-2.0 package declaration does not replace third-party terms.

package/dist/node_modules/@diffexai/diffex-agent-core/NOTICE

@@ -1,6 +0,0 @@
-Diffex
-Copyright 2026 Luntraa, Inc.
-
-Where this distribution contains Pi Agent Harness-derived portions,
-those portions retain their MIT terms and copyright notice in LICENSE.
-The Apache-2.0 package declaration does not replace third-party terms.

package/dist/node_modules/@diffexai/diffex-ai/NOTICE

@@ -1,6 +0,0 @@
-Diffex
-Copyright 2026 Luntraa, Inc.
-
-Where this distribution contains Pi Agent Harness-derived portions,
-those portions retain their MIT terms and copyright notice in LICENSE.
-The Apache-2.0 package declaration does not replace third-party terms.

package/dist/node_modules/@diffexai/diffex-client/NOTICE

@@ -1,6 +0,0 @@
-Diffex
-Copyright 2026 Luntraa, Inc.
-
-Where this distribution contains Pi Agent Harness-derived portions,
-those portions retain their MIT terms and copyright notice in LICENSE.
-The Apache-2.0 package declaration does not replace third-party terms.