@tpsdev-ai/flair 0.51.2 → 0.53.0

package/README.md

@@ -44,7 +44,10 @@ Step 5 finds the memory you never keyword-matched:
   ( 2026-07-28 · standard · 100% )
 ```
 
-That trailing figure is a rank score, normalized so the top hit is always near 100% — ordering, not confidence.
+By default, that percentage displays semantic similarity with a small keyword-match
+boost. Hybrid search combines semantic and lexical ranks to order results, so the
+first result need not have the highest percentage or be near 100%. The percentage
+is not a probability that the memory answers your question correctly.
 
 `flair init` installs and starts Harper, creates the agent's Ed25519 keypair, verifies semantic search actually works, wires every MCP client it detects (Claude Code, Cursor, Codex CLI, Gemini CLI), and runs a smoke test. Restart your MCP client afterwards, then ask the agent *"what do you remember about me?"*
 
@@ -104,6 +107,8 @@ flair upgrade --check   # show the plan across flair, flair-mcp and the openclaw
 flair upgrade           # apply it; the instance restarts automatically
 ```
 
+A plain extracted tree (`npm pack` + systemd, not `npm install -g`)? `flair upgrade` detects it, or pass `--tree <dir>`. See [docs/upgrade.md](docs/upgrade.md#plain-tree--npm-pack-install).
+
 Deployed to a Harper Fabric cluster instead of running locally? Use `flair upgrade --target <fabric-url>`.
 
 ## What it looks like
@@ -166,7 +171,7 @@ See **[DESIGN.md](DESIGN.md)** for the invariants behind the three primitives
 | Feature | What it does |
 |---|---|
 | **Semantic memory** | Auto-embedded on write. Search by meaning, not keywords. |
-| **Tiered durability** | `permanent` (delete rejected) / `persistent` / `standard` (default) / `ephemeral` (24h TTL). |
+| **Tiered durability** | `permanent` (retained until explicitly deleted by its owner or an admin) / `persistent` / `standard` (default) / `ephemeral` (24h TTL). |
 | **Temporal validity** | `validFrom` / `validTo` bounds. Expired memories drop out of search and bootstrap automatically. |
 | **Trust-graded recall** | Opt-in per-result evidence: provenance, usage signal, freshness, supersession. Confidence bands (`strong`/`moderate`/`breadcrumb`) and first-class **abstention** when nothing clears the floor. |
 | **Relationship graph** | Entity-to-entity triples with temporal bounds, queryable alongside semantic memory. |
@@ -253,7 +258,7 @@ Any agent that can run a shell command can use Flair directly.
 ```bash
 flair memory add --agent mybot "learned something important"
 flair search --agent mybot "that important thing"
-flair soul set --agent mybot --key role --value "Security reviewer"
+flair soul set --agent mybot --key role --value "Security reviewer" --admin-pass-file ~/.flair/admin-pass
 flair bootstrap --agent mybot --max-tokens 4000        # cold-start: soul + relevant memories
 flair backup --admin-pass-file ~/.flair/admin-pass     # logical JSON export
 flair restore ./backup.json --admin-pass-file ~/.flair/admin-pass
@@ -279,7 +284,7 @@ const flair = new FlairClient({
 await flair.memory.write('Harper v5 sandbox blocks bare imports')
 const results = await flair.memory.search('native module loading')
 const ctx = await flair.bootstrap({ maxTokens: 4000 })
-await flair.soul.set('role', 'Security reviewer')
+await flair.soul.get('role')
 ```
 
 No Harper, no embeddings — just HTTP and auth. Full API in the [client README](packages/flair-client/README.md).
@@ -298,7 +303,7 @@ curl -H "Authorization: TPS-Ed25519 mybot:$TS:$NONCE:$SIG" \
   -d '{"id": "mybot-123", "agentId": "mybot", "content": "...", "durability": "standard"}'
 ```
 
-Sign `agentId:timestamp:nonce:METHOD:/path` with the agent's private key. Protocol in [SECURITY.md](SECURITY.md).
+Sign `agentId:timestamp:nonce:METHOD:/path` with the agent's private key. Protocol in [SECURITY.md](SECURITY.md). Consolidated endpoint, auth-per-resource, and schema catalog: **[docs/api-reference.md](docs/api-reference.md)**.
 
 ### Embedded in a Harper app (in-process)
 

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
-  "version": "0.51.2",
-  "commit": "b796f758ddbeaee6e203bb5c0ad576338f872642",
-  "builtAt": "2026-09-03T01:00:42.325Z",
+  "version": "0.53.0",
+  "commit": "3a238b4a3ce3fce8cf64fcb83bd3203096ebae3a",
+  "builtAt": "2026-09-10T17:58:16.549Z",
   "builder": "tsc"
 }