flowviant 0.79.0 → 0.81.0

package/bin/cli.mjs

@@ -26,7 +26,7 @@
  * running?", which otherwise ends in a pid hunt through `ps`.
  *
  * The daemon: install ONCE with a machine credential, then work entirely from
- * Flowviant. It polls GET /api/v2/fleet/agents, and the roster hands it the
+ * Flowviant. It polls GET /api/fleet/agents, and the roster hands it the
  * project's SESSIONS — the Workbench's tabs. Each session gets one persistent
  * git worktree on its own `session/<id>` branch, held across turns (never reset
  * to base: the branch outlives the tab). A turn spawns the session's CLI with a
@@ -44,7 +44,7 @@
  *
  * Env:
  *   FLOWVIANT_FLEET     the machine credential (or use `flowviant login`).
- *   FLOWVIANT_API_URL   default https://api.flowviant.com/api/v2
+ *   FLOWVIANT_API_URL   default https://api.flowviant.com/api
  *   FLOWVIANT_MCP_URL   default <API_URL>/mcp
  *   FLOWVIANT_FLEET_URL default <API_URL>/fleet/agents
  *   RECONCILE_SECONDS   roster poll cadence (default 10)

package/bin/lib/claudeAuth.mjs

@@ -0,0 +1,164 @@
+/**
+ * WHICH CREDENTIAL THIS MACHINE'S CLI WILL RESOLVE — presence and expiry only,
+ * never a token value, and never a judgement about which one is correct.
+ *
+ * ── THE CONFUSION THIS EXISTS TO END ──
+ *
+ * A turn failed with the CLI's own words relayed verbatim:
+ *
+ *     Failed to authenticate: OAuth session expired and could not be refreshed
+ *
+ * and the operator did the obvious thing — opened a terminal on that same
+ * machine, typed `claude`, and watched it work. Both observations were true at
+ * once, and nothing in the product could explain how, because the one fact that
+ * reconciles them is invisible from a browser: THE DAEMON'S CLI AND YOUR SHELL'S
+ * CLI DO NOT ALWAYS RESOLVE THE SAME CREDENTIAL.
+ *
+ * Two ways they diverge, and this module reports both:
+ *
+ *  · THE ENVIRONMENT. `claude.mjs` spawns the CLI with `{...process.env}` on
+ *    purpose — its header says so: "the CLI's own credentials live in this
+ *    environment, and handing it a curated one signs it out". It also stopped
+ *    deleting ANTHROPIC_API_KEY / ANTHROPIC_AUTH_TOKEN deliberately, because on
+ *    a machine the project leaves running an inherited org key is the POINT.
+ *    The consequence is that an auth variable in the daemon's environment is
+ *    handed to every turn — and `process.env` is a SNAPSHOT taken when the
+ *    daemon started, so a variable exported weeks ago is still in there long
+ *    after it left your shell. A stale one fails in a way a fresh `claude`
+ *    never reproduces.
+ *  · THE HOME. The CLI reads its store from $HOME. A daemon under systemd, a
+ *    different user, or a container has a different one than the shell you
+ *    tested in, so "I am logged in" was measured on the wrong file.
+ *
+ * ── WHAT THIS IS NOT ──
+ *
+ * NOT A POLICY. Flowviant does not pick a credential, does not prefer the
+ * subscription over a key, and does not call either one wrong — `claude.mjs`
+ * settled that: "Which credential is correct, and whether an account may be
+ * shared, is between the operator and the vendor." This reports what is
+ * PRESENT so a person can see the divergence; it never resolves it.
+ *
+ * NOT A PRECEDENCE CLAIM. Which source the CLI actually prefers is the CLI's
+ * own business and it is free to change it. We report that both exist, which is
+ * the fact that explains the symptom, and we do not assert which one won.
+ *
+ * NOT A TOKEN READER. Values never leave — not to the server, not to a log, not
+ * into an error. Presence, the variable's NAME, and the refresh expiry, which
+ * is a date.
+ *
+ * ── THE THREE-STATE RULE, WHICH THIS FILE LIVES OR DIES BY ──
+ *
+ * `source: 'unknown'` is NOT "signed out". Claude Code can keep credentials in
+ * an OS keychain (macOS especially), where a file simply does not exist and
+ * everything is fine. Reporting a confident "no login" for a machine that is
+ * working perfectly is precisely the invented state this product forbids, and
+ * it would be worse than saying nothing. Absent means absent; the surface
+ * renders nothing for it.
+ */
+
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+/**
+ * The variables that can carry auth into the CLI from the environment.
+ *
+ * The first two are the pair `claude.mjs` documents itself as deliberately NOT
+ * deleting, and both appear in childEnv.mjs's allowlist. The third is Claude
+ * Code's own headless/CI token. Names only ever leave this module — a NAME is
+ * what a person greps for, and it is not a secret.
+ */
+export const AUTH_ENV_VARS = ['ANTHROPIC_API_KEY', 'ANTHROPIC_AUTH_TOKEN', 'CLAUDE_CODE_OAUTH_TOKEN'];
+
+/** Claude Code's OAuth store, relative to the HOME the CLI will be handed. */
+const CRED_REL = ['.claude', '.credentials.json'];
+
+/** A stamp that may be seconds or milliseconds, to ISO — or null if it is
+ *  neither. Same tolerance the rest of the daemon applies to numbers it did not
+ *  write: an unreadable stamp is ABSENT, never zero and never "now". */
+function isoFromStamp(v) {
+  const n = Number(v);
+  if (!Number.isFinite(n) || n <= 0) return null;
+  const ms = n > 1e11 ? n : n * 1000;
+  const d = new Date(ms);
+  return Number.isNaN(d.getTime()) ? null : d.toISOString();
+}
+
+/**
+ * What the CLI on this machine will resolve, as far as it can be seen without
+ * spending anything: no process spawned, no request made, no quota touched.
+ * Just this process's own environment and one file's metadata.
+ *
+ * `env` and `home` are parameters rather than reads of `process` so the tests
+ * can drive every branch — and so the caller passes the SAME environment the
+ * child will actually receive, which is the whole point of the report.
+ */
+export function claudeAuthContext({ env = process.env, home = null } = {}) {
+  const HOME = home ?? env.HOME ?? env.USERPROFILE ?? null;
+
+  // Presence, by NAME. An empty or whitespace-only value is not set: an
+  // exported-but-blank variable is a common way to try to UNSET one, and
+  // reporting it as present would send somebody hunting a variable that is
+  // doing nothing.
+  const envVars = AUTH_ENV_VARS.filter((n) => typeof env[n] === 'string' && env[n].trim() !== '');
+
+  let hasFile = false;
+  let refreshExpiresAt = null;
+  let accessExpiresAt = null;
+  let subscriptionType = null;
+  if (HOME) {
+    try {
+      const raw = readFileSync(join(HOME, ...CRED_REL), 'utf8');
+      const oauth = JSON.parse(raw)?.claudeAiOauth;
+      if (oauth && typeof oauth === 'object') {
+        hasFile = true;
+        refreshExpiresAt = isoFromStamp(oauth.refreshTokenExpiresAt);
+        accessExpiresAt = isoFromStamp(oauth.expiresAt);
+        // A plan name is not a secret and it is the one field that tells an
+        // operator WHICH kind of account the machine is spending — the thing
+        // "the machine is shared and so is its CLI login" makes everyone's
+        // business. Anything unexpected is dropped rather than relayed.
+        if (typeof oauth.subscriptionType === 'string' && oauth.subscriptionType.length <= 32) {
+          subscriptionType = oauth.subscriptionType;
+        }
+      }
+    } catch {
+      // Absent, unreadable, or not JSON. All three mean the same thing here:
+      // we cannot see a file, which is NOT the same as there not being a
+      // login. See the three-state rule in this file's header.
+    }
+  }
+
+  /**
+   * THE SOURCE, and the honest thing to say about it.
+   *
+   *   'env'     — at least one auth variable is set. Reported first because it
+   *               is the state that is invisible from a shell and therefore the
+   *               one that misleads; NOT because we know it wins.
+   *   'file'    — no variable, and an OAuth store we could read.
+   *   'unknown' — neither. A keychain machine lives here, and so does a machine
+   *               with no login at all. We cannot tell them apart, so we say
+   *               nothing about which it is.
+   */
+  const source = envVars.length ? 'env' : hasFile ? 'file' : 'unknown';
+
+  return {
+    /** The OS user the daemon runs as — the other half of "which store". */
+    user: env.USER ?? env.LOGNAME ?? env.USERNAME ?? null,
+    home: HOME,
+    source,
+    /** NAMES ONLY. Never a value, never a prefix, never a length. */
+    envVars,
+    /** Is there a login sitting behind the variable that may be shadowing it?
+     *  This — not `source` on its own — is the confusing state, and it is the
+     *  only one the surface is allowed to raise unprompted. */
+    envOverridesLogin: envVars.length > 0 && hasFile,
+    /** The 22-day clock. Null when we cannot see the file, which includes every
+     *  keychain machine, so null must never render as "expired". */
+    refreshExpiresAt,
+    /** The ~12-hour clock. Reported for completeness and deliberately NOT what
+     *  any warning is built from: it lapses constantly and refreshes itself, so
+     *  a note built on it would cry wolf twice a day. */
+    accessExpiresAt,
+    subscriptionType,
+  };
+}

package/bin/lib/config.mjs

@@ -41,7 +41,28 @@ function argFlag(name) {
   return i >= 0 ? process.argv[i + 1] : undefined;
 }
 
-const API_BASE = process.env.FLOWVIANT_API_URL || 'https://api.flowviant.com/api/v2';
+/**
+ * THE SERVER'S API ROOT.
+ *
+ * `/api`, not `/api/v2`. The server collapsed its two prefixes into one
+ * namespace on 2026-09-08 — they had held DISJOINT resources and neither was
+ * ever a version of the other, so there was nothing to choose between.
+ *
+ * ── DEPLOY ORDER IS NOW LOAD-BEARING FOR THIS LINE ──
+ *
+ * A daemon on this version calls `/api/fleet/agents`. An older SERVER does not
+ * serve that path, so publishing this release before the server that answers it
+ * 404s the roster poll for anyone who updates. The order in the app repo's
+ * ARCHITECTURE.md already says it and now it matters: deploy `flowviant-api`
+ * FIRST, publish this SECOND. The same applies to a rollback — rolling the
+ * server back past that merge strands every daemon at this version or newer.
+ *
+ * The other direction is safe and needs nothing: the server keeps `/api/v2` as
+ * an alias onto the same router precisely because every daemon published before
+ * this one has that string baked in and cannot be upgraded by a deploy. That
+ * alias retires when the app's `DAEMON_MIN_VERSION` clears this release.
+ */
+const API_BASE = process.env.FLOWVIANT_API_URL || 'https://api.flowviant.com/api';
 export const MCP_URL = process.env.FLOWVIANT_MCP_URL || `${API_BASE}/mcp`;
 export const FLEET_URL = process.env.FLOWVIANT_FLEET_URL || `${API_BASE}/fleet/agents`;
 // Push channel: the daemon holds this WebSocket open and the server nudges it

package/bin/lib/fleet.mjs

@@ -1,6 +1,6 @@
 /**
  * Fleet daemon. Install ONCE with a fleet credential; manage everything from
- * Flowviant. The daemon polls GET /api/v2/fleet/agents, reconciles one persistent
+ * Flowviant. The daemon polls GET /api/fleet/agents, reconciles one persistent
  * git worktree + worker loop per roster agent, rotates each worker's short-lived
  * MCP token, and only spawns Claude when the server says an agent has work.
  */
@@ -85,6 +85,7 @@ import {
 import { createWorkManager } from './work.mjs';
 import { scanLocalSessions, ourConversationIds } from './localSessions.mjs';
 import { repoState } from './repoState.mjs';
+import { claudeAuthContext } from './claudeAuth.mjs';
 
 async function fetchRoster(
   haveIds,
@@ -327,7 +328,29 @@ async function maybeReportRepoState({ repoRoot, baseRef }) {
     // time, so the value here is always current.
     const state = repoState(repoRoot, baseRef);
     if (!state) return; // not readable — say nothing rather than say "none"
-    payload = JSON.stringify(state);
+    /**
+     * WHICH CREDENTIAL THIS MACHINE'S CLI RESOLVES, on the same beat.
+     *
+     * It rides this report rather than getting an endpoint of its own because
+     * it is the same KIND of fact — something only the machine can see, pushed
+     * because a pull client can never be asked — and it inherits this
+     * function's three economies for free: scanned once a minute, deduped
+     * against the last ACCEPTED payload, and silent forever once an older
+     * server 404s.
+     *
+     * The dedup keeps it cheap: `claudeAuthContext` is presence plus two dates,
+     * so the string is stable across scans and only moves when something about
+     * the credential actually moves. It DOES move when the CLI refreshes its
+     * access token — that stamp is carried for diagnostics — which costs a
+     * write roughly twice a day and is the whole of the extra traffic. The
+     * WARNING is built on the 22-day refresh clock instead, so a note never
+     * fires on the ~12h cycle.
+     *
+     * NO VERSION FLOOR, and none is possible to need: this is a daemon→server
+     * report, and an older SERVER strips the unknown key in its zod parse and
+     * stores the rest exactly as before.
+     */
+    payload = JSON.stringify({ ...state, auth: claudeAuthContext() });
   } catch {
     return; // a readout must never throw into the poll loop
   }

package/bin/lib/vault.mjs

@@ -6,7 +6,7 @@
  * private `git init` so every pass is versioned locally for free — the user's
  * repository is never touched.
  *
- * Sync protocol (POST /api/v2/fleet/wiki-vault, fleet-token auth): only files
+ * Sync protocol (POST /api/fleet/wiki-vault, fleet-token auth): only files
  * whose sha256 changed since the last successful sync are uploaded, chunked;
  * the LAST request carries the finalize.manifest of a completed full sweep so
  * the server prunes pages the sweep no longer has. The last-synced hashes live

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "flowviant",
-  "version": "0.79.0",
-  "description": "Run your own coding CLIs as build agents for Flowviant — Claude Code, Codex or Antigravity, on your own credentials. Holds your sessions, keeps a worktree per tab, and ships branches on your word.",
+  "version": "0.81.0",
+  "description": "Run your own coding CLIs as build agents for Flowviant \u2014 Claude Code, Codex or Antigravity, on your own credentials. Holds your sessions, keeps a worktree per tab, and ships branches on your word.",
   "type": "module",
   "bin": {
     "flowviant": "bin/cli.mjs"