@companion-ai/feynman 0.5.50 → 0.5.51

package/RELEASES.md

@@ -6,6 +6,11 @@ GitHub release notes are generated from the matching `## vX.Y.Z` section in this
 
 ## Unreleased
 
+## v0.5.51 - 2026-10-19
+
+- **A damaged `auth.json` says so.** When `~/.feynman/agent/auth.json` isn't valid JSON, for example after a hand edit, every command used to print only `Expected property name or '}' in JSON`. Feynman now names the file and says to fix it, or move it aside and sign in again with `feynman setup`.
+- `feynman --update` points to `feynman update`, and `feynman model setup` points to `feynman model login`.
+
 ## v0.5.50 - 2026-10-18
 
 - **pi-subagents 0.79.1.**

package/dist/cli.js

@@ -44,6 +44,7 @@ const UNKNOWN_OPTION_HINTS = {
     "--json": "feynman --mode json",
     "--work-dir": "feynman --cwd <dir>",
     "--path": "feynman --cwd <dir>",
+    "--update": "feynman update",
 };
 // Removed commands fail instead of falling through to a chat prompt.
 const REMOVED_COMMANDS = new Set(["jobs", "paper", "rank", "serve", "watch"]);
@@ -231,7 +232,11 @@ async function handleModelCommand(subcommand, args, feynmanSettingsPath, feynman
         }
         return;
     }
-    const setHint = /[/:]/.test(subcommand) ? `Did you mean \`feynman model set ${subcommand}\`? ` : "";
+    const setHint = /[/:]/.test(subcommand)
+        ? `Did you mean \`feynman model set ${subcommand}\`? `
+        : subcommand === "setup"
+            ? "To sign in, run `feynman model login`. "
+            : "";
     throw new Error(`Unknown model command: ${subcommand}\n${setHint}Run \`feynman model help\` to see model commands.`);
 }
 async function handleUpdateCommand(piOptions, feynmanVersion, source) {

package/dist/index.js

@@ -1,3 +1,5 @@
+import { resolve } from "node:path";
+import { getFeynmanAgentDir } from "./config/paths.js";
 import { ensureSupportedNodeVersion } from "./system/node-version.js";
 async function run() {
     ensureSupportedNodeVersion();
@@ -6,7 +8,17 @@ async function run() {
     const { main } = await import("./cli.js");
     await main();
 }
+// Pi throws a bare JSON.parse error for a malformed auth.json, which names no file.
+function describeFatalError(error) {
+    if (!(error instanceof Error))
+        return String(error);
+    if (error instanceof SyntaxError && error.stack?.includes("auth-storage")) {
+        const authPath = resolve(getFeynmanAgentDir(), "auth.json");
+        return `${authPath} is not valid JSON (${error.message}).\nFix the file, or move it aside and sign in again with \`feynman setup\`.`;
+    }
+    return error.message;
+}
 run().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
+    console.error(describeFatalError(error));
     process.exitCode = 1;
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@companion-ai/feynman",
-  "version": "0.5.50",
+  "version": "0.5.51",
   "description": "The open source AI research agent.",
   "license": "MIT",
   "type": "module",