facult 2.8.6 → 2.8.7

package/README.md

@@ -703,7 +703,8 @@ Under machine-local Facult state:
 - `.../autosync/services/*.json` (autosync service configs)
 - `.../autosync/state/*.json` (autosync runtime state)
 - `.../autosync/logs/*` (autosync service logs)
-- `runtime/<version>/<platform-arch>/...` under the machine-local cache root (npm launcher binary cache)
+- `cache/runtime/<version>/<platform-arch>/...` under the macOS machine-local state root, or `runtime/<version>/<platform-arch>/...` under `FACULT_CACHE_DIR`/XDG cache roots on other platforms (npm launcher binary cache)
+  - if that cache root is unavailable, the npm launcher falls back to a temp-dir runtime cache before using the bundled source fallback
 
 ### Config reference
 

package/bin/fclt.cjs

@@ -45,7 +45,7 @@ function localCacheRoot(home) {
     return path.resolve(override);
   }
   if (process.platform === "darwin") {
-    return path.join(home, "Library", "Caches", "fclt");
+    return path.join(localStateRoot(home), "cache");
   }
   const xdg = String(process.env.XDG_CACHE_HOME || "").trim();
   return xdg
@@ -67,7 +67,7 @@ async function main() {
   }
 
   const home = os.homedir();
-  const cacheRoot = path.join(localCacheRoot(home), "runtime");
+  const cacheRoot = await runtimeCacheRoot(home);
   const installDir = path.join(
     cacheRoot,
     version,
@@ -174,6 +174,22 @@ async function main() {
   process.exit(1);
 }
 
+async function runtimeCacheRoot(home) {
+  const primary = path.join(localCacheRoot(home), "runtime");
+  try {
+    await fsp.mkdir(primary, { recursive: true });
+    return primary;
+  } catch {
+    const fallback = path.join(os.tmpdir(), "fclt", "runtime-cache");
+    try {
+      await fsp.mkdir(fallback, { recursive: true });
+      return fallback;
+    } catch {
+      return primary;
+    }
+  }
+}
+
 async function canUseSourceFallback(sourceEntry) {
   if (!(await fileExists(sourceEntry))) {
     return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "facult",
-  "version": "2.8.6",
+  "version": "2.8.7",
   "description": "Manage canonical AI capabilities, sync surfaces, and evolution state.",
   "type": "module",
   "license": "MIT",

package/src/paths.ts

@@ -114,7 +114,7 @@ export function facultLocalCacheRoot(home: string = defaultHomeDir()): string {
     return resolvePath(override, home);
   }
   if (process.platform === "darwin") {
-    return join(home, "Library", "Caches", "fclt");
+    return join(facultLocalStateRoot(home), "cache");
   }
   const xdg = process.env.XDG_CACHE_HOME?.trim();
   return xdg