@companion-ai/feynman 0.5.7 → 0.5.8

package/RELEASES.md

@@ -6,6 +6,11 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.8 - 2026-09-26
+
+- `FEYNMAN_HOME=~` or `~/path` now means your home folder. Unexpanded `~` (common in `.env` files, Docker `ENV`, and Windows shells) created a literal `~` folder in the current directory.
+- Starting two Feynman sessions at the same moment no longer crashes one of them with "Subagent config changed during settings normalization". The second start keeps the subagent config the first one wrote.
+
 ## v0.5.7 - 2026-09-26
 
 - When Feynman runs as a package inside another Pi setup, an extension error no longer appears on every turn ("Cannot set properties of undefined (setting 'current_date')") if another extension or the host leaves the system-prompt sections unset (#298, thanks @Oscar-Williams in #300).

package/dist/config/paths.js

@@ -1,8 +1,15 @@
 import { mkdirSync } from "node:fs";
 import { homedir } from "node:os";
-import { resolve } from "node:path";
+import { join, resolve } from "node:path";
+// Like Pi's own agent-dir variable: a leading ~ in FEYNMAN_HOME (unexpanded in
+// .env files, Docker ENV, or Windows shells) means the home folder.
+export function expandHomePath(path, home = homedir()) {
+    if (path === "~")
+        return home;
+    return /^~[\\/]/.test(path) ? join(home, path.slice(2)) : path;
+}
 export function getFeynmanHome() {
-    return resolve(process.env.FEYNMAN_HOME ?? homedir(), ".feynman");
+    return resolve(expandHomePath(process.env.FEYNMAN_HOME ?? homedir()), ".feynman");
 }
 export function getFeynmanAgentDir(home = getFeynmanHome()) {
     return resolve(home, "agent");

package/dist/pi/settings.js

@@ -180,15 +180,20 @@ export async function ensureFeynmanSettings(settingsPath, bundledSettingsPath, a
             settings.defaultModel = preferredModel.id;
         }
     }
-    if (subagentDefaults) {
-        const current = existsSync(subagentDefaults.path) ? readFileSync(subagentDefaults.path, "utf8") : undefined;
-        if (current !== subagentDefaults.original) {
-            throw new Error(`Subagent config changed during settings normalization: ${subagentDefaults.path}. Retry without overwriting it.`);
-        }
+    // If another process wrote the subagent config while models were being
+    // discovered, keep its version instead of overwriting it or failing startup.
+    const subagentCurrent = subagentDefaults && existsSync(subagentDefaults.path) ? readFileSync(subagentDefaults.path, "utf8") : undefined;
+    if (subagentDefaults && subagentCurrent === subagentDefaults.original) {
         mkdirSync(dirname(subagentDefaults.path), { recursive: true });
-        writeFileSync(subagentDefaults.path, subagentDefaults.content, {
-            encoding: "utf8", mode: 0o600, flag: subagentDefaults.original === undefined ? "wx" : "w",
-        });
+        try {
+            writeFileSync(subagentDefaults.path, subagentDefaults.content, {
+                encoding: "utf8", mode: 0o600, flag: subagentDefaults.original === undefined ? "wx" : "w",
+            });
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
     }
     const content = JSON.stringify(settings, null, 2) + "\n";
     if (content === existing?.source)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "Research-first CLI agent built on Pi and alphaXiv",
   "license": "MIT",
   "type": "module",