@diffexai/diffex 0.2.1 → 0.2.3

package/distribution-files.json

@@ -1,7 +1,11 @@
 {
-  "sourceCommit": "f2a661684af35fe6e9a3209c6f9720144e1fd423",
+  "sourceCommit": "a9a2beea7798edd34c62e836d73a0d50b6260950",
   "algorithm": "sha256",
   "files": [
+    {
+      "path": "dist/AGENTS.md",
+      "sha256": "46803080d679da46dfe9a35a32bc608317e410c2cc1b35e2cdc76351fccb5049"
+    },
     {
       "path": "dist/bun/cli.d.ts",
       "sha256": "43e818adf60173644896298637f47b01d5819b17eda46eaa32d0c7d64724d012"
@@ -178,6 +182,14 @@
       "path": "dist/cli/session-picker.js",
       "sha256": "c4483745ad76b1b57a1bd2534e255d2296ea1f066dd3b79cc4b3eebe7d5af21e"
     },
+    {
+      "path": "dist/cli/session-selection.d.ts",
+      "sha256": "0cc8244c9115386a0003325d237d6aee8de3962c69de4cca80ddfeb420e75f5d"
+    },
+    {
+      "path": "dist/cli/session-selection.js",
+      "sha256": "86db8d22d585b7ed66125c89c374276cca828876578b535741cd27265099e4ba"
+    },
     {
       "path": "dist/cli/startup-ui.d.ts",
       "sha256": "5b0127f90c18df60ba0b8f2164c77030fc15bbca83c76a92bfb111efa2055005"
@@ -212,11 +224,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",
@@ -454,6 +466,14 @@
       "path": "dist/core/export-html/vendor/marked.min.js",
       "sha256": "d5487edc7258b404bfa74c393d74a6393155f02517bd5e7e77cd64f8187f39a0"
     },
+    {
+      "path": "dist/core/extensions/factory.d.ts",
+      "sha256": "e84445577b098b077c7d42321226c3eaf9ba856f3279c31f2d85ad1668d92b27"
+    },
+    {
+      "path": "dist/core/extensions/factory.js",
+      "sha256": "cee9ad8be90aa74ce72e44887412889715e9102dd70e5eb680b2745b0eab5888"
+    },
     {
       "path": "dist/core/extensions/index.d.ts",
       "sha256": "2cf2e172af3588982853495d907549c8f81a64264174604df71041108f423619"
@@ -464,11 +484,11 @@
     },
     {
       "path": "dist/core/extensions/loader.d.ts",
-      "sha256": "23b8ccf83cabfb5b5a54eaf226bcecc8fdcf5d2e3d8759fb547f808b42cf6a06"
+      "sha256": "cf1a657c20d54065e0ab55db90f59f383ed6191842deb3131b66e40e7b0005f3"
     },
     {
       "path": "dist/core/extensions/loader.js",
-      "sha256": "7aaf941fcdd2027446a58a16f4d79d97f5e96b247da813f9e5bf9ebfb21b287c"
+      "sha256": "6188c57ea0857a666296a747a0f8ebf974baa1eb096f15cf7ea39f90dabd8c37"
     },
     {
       "path": "dist/core/extensions/runner.d.ts",
@@ -644,7 +664,7 @@
     },
     {
       "path": "dist/core/prompt-templates.js",
-      "sha256": "f8588ceb9db41c5b7e09916a1f140878546c2a615d42987558f2818fa40b296b"
+      "sha256": "b85c46f913a73ee6f91ee10ad24565487f20b64f4fd327821c01ad20abb4d8de"
     },
     {
       "path": "dist/core/provider-attribution.d.ts",
@@ -692,7 +712,7 @@
     },
     {
       "path": "dist/core/resource-loader.js",
-      "sha256": "7176588bbf816795e30ffc9343f948b09c299b4338941a14a2c2e901a8eaaa23"
+      "sha256": "2d21d01b80e8348e5284e35424e6a7a426a23a3ee94e7da0e04f4984f960e3da"
     },
     {
       "path": "dist/core/runtime-credentials.d.ts",
@@ -828,7 +848,7 @@
     },
     {
       "path": "dist/core/system-prompt.js",
-      "sha256": "3672bec049bb1f3df749c0893c6f41000028fa34227cce469bfd9036ab17b6bd"
+      "sha256": "1c848d3dcf8bba0f631962b364eb78b25054aae26eb7185fedbfc8412c6293af"
     },
     {
       "path": "dist/core/telemetry.d.ts",
@@ -956,7 +976,7 @@
     },
     {
       "path": "dist/core/tools/subagents.js",
-      "sha256": "2619f16e0b7cfa100c0682cd5f9ab4f6dafd970d62c56816aacd23c0177f3933"
+      "sha256": "b7cad3a8547da3dc7c8195198b23fa3e891b206471584f4bd73847c77dae687e"
     },
     {
       "path": "dist/core/tools/tool-definition-wrapper.d.ts",
@@ -1068,7 +1088,7 @@
     },
     {
       "path": "dist/main.js",
-      "sha256": "955a43eeb37d06b05cc84ebaa03e877fb0e4791313c6ab72d9689a50029c2a1d"
+      "sha256": "d4260056f42d72787855e01df3838399e9fd54b44442e3fd25fa02abf2ab513a"
     },
     {
       "path": "dist/migrations.d.ts",
@@ -1988,27 +2008,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/distribution-components.json",
-      "sha256": "71b0901531f95dafee515729146016eb7e387ebd067ec764e6ebee5d4e121a36"
+      "sha256": "23e8b3e819552ab1683f4e44e0b795610b5f2fb6351b4ea4662e7f93486b32f8"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-agent-core/distribution-files.json",
-      "sha256": "a8ab47f1851ae411d0d28e7849c843d0df6e4bae8ed6503c4bdbd01ba9b94958"
+      "sha256": "a0855896203a6ff8c27eacb48c39cde9291ee235db806fa30bda8c6edd133c8c"
     },
     {
       "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": "71341c2812ef7aad91de1d58d80e0fa3462b05614997197e9f2866f0611a8a70"
     },
     {
       "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",
@@ -2440,11 +2456,11 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/image-models.generated.d.ts",
-      "sha256": "e2f721b32afe98dddbe67635807aed051d51bffa767785a8e1710853366a03e6"
+      "sha256": "2e2e697782ca8dbd0ea6f7405c590ad1c04674f8d1906ea55bcd1997490dab49"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/image-models.generated.js",
-      "sha256": "5b97efcca10f14b18d8298c3d131bc334cb0026150f2d41f1eef0743a8ce65fc"
+      "sha256": "55d20a1525eddacfdefdffe15f04c3dfe20864cb5630dd6dff98851e5eb5cd0d"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/image-models.js",
@@ -2684,7 +2700,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/.manifest.json",
-      "sha256": "2b5e284976eac0be4991a7e55382bb7cb3323940f8519be330b6b29927e465e0"
+      "sha256": "4786d8d79b58eb3741266c39807f9489b7ad8593d350f5da94cdccb0f97e8c58"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/amazon-bedrock.json",
@@ -2748,7 +2764,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/kimi-coding.json",
-      "sha256": "ba42a26a69e5cb2122c0b384ba572efae93f42239ad86f26c2b7320a14aa75a1"
+      "sha256": "9da7ea8e9eb8df5d8f73acc25d3da5b41164f522c0f09b45265b4bf104743ac1"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/minimax-cn.json",
@@ -2772,7 +2788,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/nvidia.json",
-      "sha256": "d9fbf18e811fcf04521c3dad7bd8a31c6716938611de392548319acc560c1e0c"
+      "sha256": "7459d845fd752fb70a9be5a28be44dc5e2873fbd788e9c931d3200731db42ba9"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/openai-codex.json",
@@ -2792,11 +2808,11 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/openrouter.json",
-      "sha256": "14f7cd6992411e94e60e61b200b3aaad6d4371b60d11da6f1546db96cd2c1fbe"
+      "sha256": "64bd70583cd0db09283381b3e7cc10e8750ddcf8b168b6edc64540efe77070e6"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/qwen-token-plan-cn.json",
-      "sha256": "e62dde34edb603376a1dc60b2a74a9c2605b9e81d81df55cc259796c45aa4793"
+      "sha256": "b18db950e464e8ea7fd5ef073ac2fe8445d28cf35a7dc2927ae366ac9dc6c8dc"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/qwen-token-plan-individual.json",
@@ -2812,7 +2828,7 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/vercel-ai-gateway.json",
-      "sha256": "e6e9eb2c2da25c85d428dab15765c5c539d73003a7acd432b238c86c5a398121"
+      "sha256": "66d7477cdca2297252ad79531f11a1bf60b755f2f19fc051180042c9f6d5e40e"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/dist/providers/data/xai.json",
@@ -3556,27 +3572,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/distribution-components.json",
-      "sha256": "c97478a3621ba61008b85740af492bf59544725ddb089f75aaff7df6a69c1508"
+      "sha256": "c56100b24d5e05d66b5bf85947633ebb90b24bb687a35cf55cac2aa5d4af7535"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-ai/distribution-files.json",
-      "sha256": "a3530567f07c8c6a441a7e5c6176f846304613680a9f9b7dd786a95e173e07cf"
+      "sha256": "488839af6f09f36d72999303a56c5d453e4203339f6d16b73676659ca1c443d8"
     },
     {
       "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": "dbd43e2eda79acf96eed38ad3e23d0561eb49f39e3857763ad5e185dabac705d"
     },
     {
       "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 +3688,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/distribution-components.json",
-      "sha256": "bf1f74465b67e7bd111a5f38e419586aeb754853ded3b4a0782774d6359874b1"
+      "sha256": "acf017c608edd57d92996609ae9b44dd226aee5864b35266f0798db030d289a6"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-client/distribution-files.json",
-      "sha256": "6d342e688f45cb2f240812ca8f59d16420e00a76bd90f3fafea47a22b3988804"
+      "sha256": "4ed015ab5ba91cad79080ed265602614dc4de68a6e152f10a0fd72fb1751da2c"
     },
     {
       "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": "ad729910a444016cc2e9f5d37ec7cdb36826e12025cf522a6a4181b3d84978ae"
     },
     {
       "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 +3716,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/distribution-components.json",
-      "sha256": "3b8188af3fab862bc686f6908c544399bf9c37360e78bcd30e70b4e0254a1068"
+      "sha256": "716baba65927c93e5e9901c1dabe5c48da13935c48197a6fa3f0d32bd3a064de"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-harness-state/distribution-files.json",
-      "sha256": "55edd0a2954c45cbf12aff791e4ba5c8f037072bf40087f605cd8ce562cf2c9d"
+      "sha256": "8d2b3e724517ce871b3579c7f5a2378e2060af80a76f5af071bc5d5aed1e870e"
     },
     {
       "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": "758b5da2262fc4ac9d17747e44cdca068fd2a2a22d88f69bd4f51e544a281920"
     },
     {
       "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 +3800,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/distribution-components.json",
-      "sha256": "46686075070e30a0de4325197220eeb25d8e33a813410bc43eac55d962ad2935"
+      "sha256": "f0b6997a5700803d141de6f44c28285737223ae01c7c2017c26ad5abf7e8283e"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-protocol/distribution-files.json",
-      "sha256": "5ccc4cbd5d95c3814b219aad9aa1bce059ae2cff63ffb2504ff924df91d837b2"
+      "sha256": "295ebd7de4e99ddafc975ba23bd4d8e55ecd7ad68fd5e246c524ee3f81203bc9"
     },
     {
       "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": "e2b751b823f42b0c11d4c8890c0d92b6cad32398c38a20a4796f59469de36122"
     },
     {
       "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 +3868,23 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/distribution-components.json",
-      "sha256": "2fbe9af183c9712f7c373c4bc7fe87381ace17499c9d4490668197c9a9d7b982"
+      "sha256": "a99dde9ba03c8f62130ead771ca9f31b480b8437ddf451c44dec2069257c4a9b"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-telemetry/distribution-files.json",
-      "sha256": "b50253eaf34ccb7af5fc691f3a1f82d68866e833953b0754c38a29948cfe1691"
+      "sha256": "b963a6a2121aadf67f0df1f0b21cbab2d7fc933f4e44a88750375ce73d4f2059"
     },
     {
       "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": "ce2d06c525e082984d277456896b7aa18b94c19c18cb0233ce4190fce665c3ee"
     },
     {
       "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 +4200,11 @@
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/distribution-components.json",
-      "sha256": "e8c8eb8afab61df551d5edff8bd55ae92e72c44a27a190961981a08e075d67d5"
+      "sha256": "c5e587f5ccd1b3057c6ddc46d12303c02d5d8ed21092e51a644e6b64de773585"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/distribution-files.json",
-      "sha256": "d72f92d7640452729e9279d87f04a0bd64da6584d06ac35178a50be3c0887e0b"
+      "sha256": "7a426f2846ae0fd5d567578f8af83ce8f156e8f8fe74240ab292757c6c158dc1"
     },
     {
       "path": "dist/node_modules/@diffexai/diffex-tui/LICENSE",
@@ -4230,17 +4226,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": "baad042242a3139246b749ce8dd0574344706df2f90541942ccdd29f465f81b6"
     },
     {
       "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/docs/usage.md

@@ -222,15 +222,21 @@ The selected collaboration mode is restored independently for the active interac
 
 ## Context Files
 
-Diffex loads `AGENTS.md` or `CLAUDE.md` at startup from:
+Diffex loads context files at startup in this order:
 
+- the bundled `dist/AGENTS.md` for default instructions in production installations
 - `~/.diffex/agent/AGENTS.md` for global instructions
-- parent directories, walking up from the current working directory
+- parent directories, from the outermost directory toward the current working directory
 - the current directory
 
-If a directory contains `AGENTS.override.md`, Diffex loads it instead of `AGENTS.md` or `CLAUDE.md` from that directory. Context files from other directories still layer normally.
+The bundled defaults are loaded from the installed package without creating or overwriting user or project files.
+Use global and project instructions to customize these defaults.
 
-Use context files for project conventions, commands, safety rules, and preferences. Disable loading with `--no-context-files` or `-nc`.
+If a user or project directory contains `AGENTS.override.md`, Diffex loads it instead of `AGENTS.md` or `CLAUDE.md` from that directory.
+Context files from other directories still layer normally.
+
+Use context files for project conventions, commands, safety rules, and preferences.
+Disable all context loading, including the bundled defaults, with `--no-context-files` or `-nc`.
 
 ### System Prompt Files
 

package/npm-shrinkwrap.json

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