@tpsdev-ai/flair 0.25.1 → 0.25.3

package/README.md

@@ -126,11 +126,11 @@ Every agent has an Ed25519 key pair. Requests are signed with `agentId:timestamp
 Memories are automatically embedded on write using [nomic-embed-text](https://huggingface.co/nomic-ai/nomic-embed-text-v1.5-GGUF) (768 dimensions). Search by meaning:
 
 ```bash
-# Write a memory
-flair memory write "Harper v5 sandbox blocks node:module but process.dlopen works"
+# Write a memory (--agent is your registered agent id)
+flair memory add --agent myagent "Harper v5 sandbox blocks node:module but process.dlopen works"
 
 # Find it later by concept, not exact words
-flair memory search "native addon loading in sandboxed runtimes"
+flair memory search --agent myagent "native addon loading in sandboxed runtimes"
 # → [0.67] Harper v5 sandbox blocks node:module but process.dlopen works
 ```
 

package/dist/cli.js

@@ -12,8 +12,8 @@ import { create as tarCreate, extract as tarExtract, list as tarList } from "tar
 import { keystore } from "./keystore.js";
 import { deploy as deployToFabric, validateOptions as validateDeployOptions, buildTargetUrl as buildDeployUrl } from "./deploy.js";
 import { fabricUpgrade } from "./fabric-upgrade.js";
-import { checkVersion, formatVersionNudge } from "./version-check.js";
-import { checkServerHandshake, formatHandshakeNudge } from "./version-handshake.js";
+import { checkVersion, formatVersionNudge, primeVersionCheckCache, FLAIR_PKG_NAME } from "./version-check.js";
+import { checkServerHandshake, formatHandshakeNudge, invalidateHandshakeCache } from "./version-handshake.js";
 import { probeInstance } from "./probe.js";
 import { sweepFleet, renderFleetSweepTable, FLEET_EXIT_OK, } from "./fleet-verify.js";
 import { markStale, sortOldestVersionFirst } from "./fleet-presence.js";
@@ -8053,6 +8053,12 @@ program
                 continue;
             const data = await res.json();
             const latest = data.version ?? "unknown";
+            if (name === FLAIR_PKG_NAME && latest !== "unknown") {
+                try {
+                    primeVersionCheckCache(latest);
+                }
+                catch { /* best-effort */ }
+            }
             const installed = probe();
             let status;
             if (installed === null) {
@@ -8722,6 +8728,15 @@ async function startFlairProcess(port) {
 async function restartFlair(port) {
     await stopFlairProcess(port);
     await startFlairProcess(port);
+    // Bust the version-handshake cache so the next preAction nudge re-fetches
+    // the LIVE version instead of the pre-restart cached one (the false
+    // "server is running <old>" users hit for up to 60s post-upgrade+restart).
+    // Same (rootPath, serverUrl) key the preAction hook computes (~line 2189)
+    // — must match exactly, or this busts the wrong cache file.
+    try {
+        invalidateHandshakeCache(process.env.ROOTPATH ?? defaultDataDir(), `http://127.0.0.1:${port}`);
+    }
+    catch { /* best-effort — never fail a restart over cache cleanup */ }
 }
 program
     .command("restart")
@@ -12752,6 +12767,14 @@ program
 // its Node-version check passes. The shim imports this module, so import.meta.main
 // is false there — without this explicit entry point the CLI would load but never run.
 async function runCli() {
+    // A bare `flair` (no command) is a help request, not a usage error — show
+    // help and exit 0, rather than commander's default (help + exit 1). Flags
+    // like -h/--help/-v have argv beyond the binary and fall through to
+    // commander, which already exits 0 for them.
+    if (process.argv.length <= 2) {
+        program.outputHelp();
+        process.exit(0);
+    }
     await program.parseAsync();
 }
 // Run CLI directly when this file is the entry point — covers `node dist/cli.js`,

package/dist/version-check.js

@@ -116,6 +116,19 @@ export async function checkVersion(installed, injected = {}) {
     }
     return { installed, latest: null, source: "unavailable" };
 }
+/**
+ * Primes the version-check cache with an already-known `latest` — e.g. right
+ * after `flair upgrade` fetches the true latest fresh via its own direct
+ * registry call, so the NEXT `checkVersion` (from `flair status`/`doctor`)
+ * reflects it immediately instead of serving a stale cached value for up to
+ * `DEFAULT_TTL_MS`. Reuses `writeCacheFile`, which is already best-effort/
+ * never-throws — a failed cache write must never surface as a command error.
+ */
+export function primeVersionCheckCache(latest, injected = {}) {
+    const cachePath = injected.cachePath ?? DEFAULT_CACHE_PATH;
+    const now = injected.now ?? (() => Date.now());
+    writeCacheFile(cachePath, { latest, checkedAt: now() });
+}
 const NO_GAP = { severity: "none", majorBehind: false, releasesBehind: 0 };
 /**
  * Classify how far `installed` is behind `latest` using major.minor.patch

package/dist/version-handshake.js

@@ -14,7 +14,7 @@
  * ROOTPATH, or a --target-switched remote), and a mismatch cached for one
  * must never bleed into a nudge about a different one.
  */
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { dirname, join } from "node:path";
 import { homedir } from "node:os";
@@ -110,6 +110,25 @@ export async function checkServerHandshake(cliVersion, rootPath, serverUrl, inje
     }
     return { cliVersion, runningVersion: null, mismatch: false, source: "unavailable" };
 }
+/**
+ * Deletes the cached running-version entry for a given (rootPath, serverUrl)
+ * pair — e.g. after `flair restart`/`flair upgrade` bounces the server, so
+ * the NEXT `checkServerHandshake` call re-fetches the live version instead
+ * of returning the pre-restart one for up to `DEFAULT_HANDSHAKE_TTL_MS`.
+ * Best-effort, like the rest of this module: a failed cache delete (missing
+ * file, permissions, read-only $HOME) must never surface as an error.
+ */
+export function invalidateHandshakeCache(rootPath, serverUrl, injected = {}) {
+    const cacheDir = injected.cacheDir ?? DEFAULT_HANDSHAKE_CACHE_DIR;
+    try {
+        const path = cacheFilePath(cacheDir, rootPath, serverUrl);
+        if (existsSync(path))
+            rmSync(path);
+    }
+    catch {
+        // Best-effort — a failed cache delete must never surface as an error.
+    }
+}
 /**
  * The one-line stderr nudge, or null when there's nothing worth printing
  * (no mismatch, or nothing to compare against). Exact wording per the spec:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "packageManager": "bun@1.3.10",
   "description": "Identity, memory, and soul for AI agents. Cryptographic identity (Ed25519), semantic memory with local embeddings, and persistent personality — all in a single process.",
   "type": "module",