release: v0.22.0 (#714)

tps-flint · claude · web-flow · commit bce6b27a0826 · 2026-07-13T16:45:17.000-07:00
* changelog: promote Unreleased to v0.22.0 — REM slice 2 headline, upgrade notes, gap-audit sections Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * release: v0.22.0 — align all workspace packages * release: fix two release-PR gate blind spots docs-freshness changelog-unreleased: an empty [Unreleased] is correct on a release commit — content was promoted to the ## [X.Y.Z] section matching package.json's version with no v-tag yet. flair-bench TOOL_VERSION: bump to 0.22.0 alongside the lockstep package bump (its version-sync test enforces this; scripts/release.sh doesn't know about source-level constants). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * release: docs-freshness — static regex for the version-section probe CodeQL flagged building a RegExp from package.json-sourced data on #714 (js/regex-injection). Match the section header with a static pattern and compare the captured version string instead. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/bun.lock b/bun.lock
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "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",
   "license": "Apache-2.0",
diff --git a/packages/flair-bench/package.json b/packages/flair-bench/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair-bench",
-  "version": "0.1.0",
+  "version": "0.22.0",
   "description": "Standalone embedding recall benchmark for flair — run real recall numbers (p@3/MRR) against any GGUF embedding model, batch-compare, get a host-aware recommendation, and share redacted results. No flair install required.",
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/flair-bench/src/version.ts b/packages/flair-bench/src/version.ts
@@ -5,4 +5,4 @@
  * attribute edge cases in a published dist/ build. test/version-sync.test.ts
  * asserts this stays equal to package.json's "version" field.
  */
-export const TOOL_VERSION = "0.1.0";
+export const TOOL_VERSION = "0.22.0";
diff --git a/packages/flair-client/package.json b/packages/flair-client/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair-client",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Lightweight client for Flair — identity, memory, and soul for AI agents. Zero heavy dependencies.",
   "type": "module",
   "main": "dist/index.js",
diff --git a/packages/flair-mcp/package.json b/packages/flair-mcp/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/flair-mcp",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "MCP server for Flair — persistent memory for Claude Code, Cursor, and any MCP client.",
   "type": "module",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.27.1",
-    "@tpsdev-ai/flair-client": "0.21.0",
+    "@tpsdev-ai/flair-client": "0.22.0",
     "zod": "4.3.6"
   },
   "license": "Apache-2.0",
diff --git a/packages/langgraph-flair/package.json b/packages/langgraph-flair/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/langgraph-flair",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "LangGraph BaseStore adapter backed by Flair — durable agent memory with crypto-pinned identity, federation, and cross-orchestrator portability.",
   "type": "module",
   "main": "dist/index.js",
@@ -36,7 +36,7 @@
   },
   "license": "Apache-2.0",
   "dependencies": {
-    "@tpsdev-ai/flair-client": "0.21.0"
+    "@tpsdev-ai/flair-client": "0.22.0"
   },
   "peerDependencies": {
     "@langchain/langgraph-checkpoint": ">=0.0.10"
diff --git a/packages/n8n-nodes-flair/package.json b/packages/n8n-nodes-flair/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/n8n-nodes-flair",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "n8n community node — use Flair as your AI Agent's memory backend. Includes FlairChatMemory (Memory port) and FlairSearch (Tool port).",
   "type": "commonjs",
   "main": "dist/index.js",
@@ -48,7 +48,7 @@
     "langchain"
   ],
   "dependencies": {
-    "@tpsdev-ai/flair-client": "0.21.0",
+    "@tpsdev-ai/flair-client": "0.22.0",
     "zod": "3.25.76"
   },
   "peerDependencies": {
diff --git a/packages/openclaw-flair/package.json b/packages/openclaw-flair/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/openclaw-flair",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "OpenClaw memory plugin for Flair — agent identity and semantic memory",
   "type": "module",
   "main": "./dist/index.js",
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@sinclair/typebox": "0.34.48",
-    "@tpsdev-ai/flair-client": "0.21.0"
+    "@tpsdev-ai/flair-client": "0.22.0"
   },
   "devDependencies": {
     "typescript": "5.9.3"
diff --git a/packages/pi-flair/package.json b/packages/pi-flair/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@tpsdev-ai/pi-flair",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "description": "Flair memory extension for pi — persistent memory access from within pi sessions",
   "type": "module",
   "main": "dist/index.js",
@@ -21,7 +21,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@tpsdev-ai/flair-client": "0.21.0",
+    "@tpsdev-ai/flair-client": "0.22.0",
     "@sinclair/typebox": "0.34.48"
   },
   "license": "Apache-2.0",
diff --git a/scripts/docs-freshness-check.mjs b/scripts/docs-freshness-check.mjs
@@ -257,6 +257,27 @@ defineCheck("changelog-unreleased", () => {
     return [];
   }
 
+  // Release-PR exception: an empty [Unreleased] is correct when its content was
+  // just PROMOTED to a `## [X.Y.Z]` section for the release being cut — the
+  // CHANGELOG carries a section matching package.json's current version while
+  // no v<version> tag exists yet, so the since-tag work is recorded there.
+  if (!hasContent) {
+    try {
+      const pkgVersion = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8")).version;
+      // Static regex + captured-group comparison — never build a RegExp from
+      // file-sourced data (CodeQL js/regex-injection, caught on this PR).
+      const hasVersionSection = lines.some((l) => {
+        const m = /^##\s+\[([^\]]+)\]/.exec(l);
+        return m !== null && m[1] === pkgVersion;
+      });
+      const tagExists = execFileSync("git", ["tag", "-l", `v${pkgVersion}`],
+        { cwd: ROOT, stdio: ["ignore", "pipe", "ignore"] }).toString().trim().length > 0;
+      if (hasVersionSection && !tagExists) return [];
+    } catch {
+      // package.json unreadable or git unavailable — fall through to the normal rule.
+    }
+  }
+
   if (commitsSinceTag !== null && commitsSinceTag > 0 && !hasContent) {
     return [{
       file: "CHANGELOG.md", line: start + 1,

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@tpsdev-ai/flair",`
`3`		`- "version": "0.21.0",`
	`3`	`+ "version": "0.22.0",`
`4`	`4`	`"description": "Identity, memory, and soul for AI agents. Cryptographic identity (Ed25519), semantic memory with local embeddings, and persistent personality — all in a single process.",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"license": "Apache-2.0",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@tpsdev-ai/flair-bench",`
`3`		`- "version": "0.1.0",`
	`3`	`+ "version": "0.22.0",`
`4`	`4`	`"description": "Standalone embedding recall benchmark for flair — run real recall numbers (p@3/MRR) against any GGUF embedding model, batch-compare, get a host-aware recommendation, and share redacted results. No flair install required.",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "dist/index.js",`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "@tpsdev-ai/flair-client",`
`3`		`- "version": "0.21.0",`
	`3`	`+ "version": "0.22.0",`
`4`	`4`	`"description": "Lightweight client for Flair — identity, memory, and soul for AI agents. Zero heavy dependencies.",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"main": "dist/index.js",`