@deleted-ai/deleted 0.1.272 → 0.1.279

package/README.md

@@ -11,13 +11,17 @@ On install (or first run), the package extracts the bundled linux-arm64 release
 binary (or downloads from GitHub Releases when authenticated). No kernel source
 ships in this package.
 
+Author docs ship with the binary under `share/docs/` (for example
+`build-a-box.md`, `harness-runtime.md`, `install-deleted.md`). `deleted init`
+prints the local path — no private GitHub login required.
+
 ## Requirements
 
 - Node.js `^22.19 || >=24`
 - Linux arm64
 
 Other platforms print a clear error and defer to the tarball install path
-([`docs/install-deleted.md`](../../docs/install-deleted.md)).
+(`share/docs/install-deleted.md` in a linux-arm64 release).
 
 ## Monorepo / CI
 

package/lib/install.js

@@ -7,9 +7,11 @@ import { assertSupportedPlatform } from './platform.js';
 import { readManifest, releaseDownloadUrl, tarballFileName } from './manifest.js';
 import {
   cacheRoot,
+  cacheMatchesManifest,
   isInstalled,
   nativeBinaryPath,
   packageRoot,
+  writeInstallStamp,
 } from './paths.js';
 
 const ZERO_SHA256 =
@@ -185,9 +187,12 @@ export function ensureInstalled() {
   assertSupportedPlatform();
   const manifest = readManifest();
   const destDir = cacheRoot(manifest.version);
-  if (isInstalled(destDir)) {
+  if (isInstalled(destDir) && cacheMatchesManifest(destDir, manifest)) {
     return destDir;
   }
+  if (fs.existsSync(destDir)) {
+    fs.rmSync(destDir, { recursive: true, force: true });
+  }
   fs.mkdirSync(path.dirname(destDir), { recursive: true });
   installFromRelease(manifest, destDir);
   if (!isInstalled(destDir)) {
@@ -195,5 +200,6 @@ export function ensureInstalled() {
       `install incomplete: expected ${nativeBinaryPath(destDir)} and starter harness`,
     );
   }
+  writeInstallStamp(destDir, manifest);
   return destDir;
 }

package/lib/paths.js

@@ -22,6 +22,43 @@ export function nativeBinaryPath(cacheDir) {
   return path.join(cacheDir, 'bin', 'deleted');
 }
 
+/** @param {string} cacheDir */
+export function installStampPath(cacheDir) {
+  return path.join(cacheDir, '.install-stamp.json');
+}
+
+/** @param {string} cacheDir */
+export function readInstallStamp(cacheDir) {
+  try {
+    return JSON.parse(fs.readFileSync(installStampPath(cacheDir), 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/** @param {string} cacheDir @param {object} manifest */
+export function writeInstallStamp(cacheDir, manifest) {
+  const stamp = {
+    version: manifest.version,
+    gitSha: manifest.gitSha,
+    tarballSha256: manifest.tarballSha256,
+  };
+  fs.writeFileSync(installStampPath(cacheDir), `${JSON.stringify(stamp)}\n`);
+}
+
+/** @param {string} cacheDir @param {object} manifest */
+export function cacheMatchesManifest(cacheDir, manifest) {
+  const stamp = readInstallStamp(cacheDir);
+  if (!stamp) {
+    return false;
+  }
+  return (
+    stamp.version === manifest.version &&
+    stamp.gitSha === manifest.gitSha &&
+    stamp.tarballSha256 === manifest.tarballSha256
+  );
+}
+
 /** @param {string} cacheDir */
 export function isInstalled(cacheDir) {
   const binary = nativeBinaryPath(cacheDir);

package/lib/platform.js

@@ -12,8 +12,9 @@ export function unsupportedPlatformMessage() {
   return [
     '@deleted-ai/deleted: Linux arm64 only (Deleted AI v0 support floor).',
     `Your platform: ${platform} ${arch}.`,
-    'Deferred platforms (macOS, Windows, linux-x64): use the tarball from',
-    'https://github.com/cdlconsultants/deleted-ai/blob/main/docs/install-deleted.md',
+    'macOS, Windows, and linux-x64 are deferred — this package will not run here.',
+    'On a Linux arm64 host, install with npx @deleted-ai/deleted or the',
+    'linux-arm64 release tarball; author docs are then at share/docs/.',
   ].join('\n');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deleted-ai/deleted",
-  "version": "0.1.272",
+  "version": "0.1.279",
   "description": "Deleted AI CLI wrapper — downloads the linux-arm64 native binary on install",
   "license": "UNLICENSED",
   "type": "module",

package/release-manifest.json

@@ -1,7 +1,7 @@
 {
-  "version": "0.1.272",
-  "gitSha": "1f657c0",
-  "tarballSha256": "cd78c142b011ed4eb7332d9f5ba360b95a65f3698e66f8a4cc7e6d94cf2fc03b",
+  "version": "0.1.279",
+  "gitSha": "120571c",
+  "tarballSha256": "659080b2e182b0f2d6722fd62363ab8435db3a2b5a5f05ebe87d61dae505ad8f",
   "repo": "cdlconsultants/deleted-ai",
   "tarballPrefix": "deleted-linux-arm64",
   "releaseTagPrefix": "npm-v"