chore: bump version to 5.12.1 — Codex MCP integration, PRIVACY.md, CI publish fix

jovanSAPFIONEER · jovanSAPFIONEER · commit 344fb17362e8 · 2026-06-17T22:22:36.000+02:00
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Network-AI — a multi-agent coordination layer for Claude Code: shared blackboard state, permission gating, federated budgets, and audit queries over MCP.",
-    "version": "5.12.0"
+    "version": "5.12.1"
   },
   "plugins": [
     {
       "name": "network-ai",
       "source": "./",
       "description": "Gives Claude Code a multi-agent coordination layer over MCP — an atomic shared blackboard (locked propose/validate/commit), permission gating with HMAC/Ed25519-signed tokens, federated token-budget tracking, and append-only audit-log queries. Backed by an orchestrator with 29 framework adapters (LangChain, AutoGen, CrewAI, and more).",
-      "version": "5.12.0",
+      "version": "5.12.1",
       "author": {
         "name": "OpenClaw Community",
         "url": "https://github.com/Jovancoding/Network-AI"
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
@@ -1,7 +1,7 @@
 {
   "name": "network-ai",
   "description": "Gives Claude Code a multi-agent coordination layer over MCP — an atomic shared blackboard (locked propose/validate/commit), permission gating with HMAC/Ed25519-signed tokens, federated token-budget tracking, and append-only audit-log queries. Backed by an orchestrator with 29 framework adapters (LangChain, AutoGen, CrewAI, and more).",
-  "version": "5.12.0",
+  "version": "5.12.1",
   "author": {
     "name": "OpenClaw Community",
     "url": "https://github.com/Jovancoding/Network-AI"
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -2,7 +2,7 @@
 
 ## Project Overview
 
-Network-AI is a TypeScript/Node.js multi-agent orchestrator — shared state, guardrails, budgets, and cross-framework coordination (v5.12.0). 3,269 tests across 33 suites.
+Network-AI is a TypeScript/Node.js multi-agent orchestrator — shared state, guardrails, budgets, and cross-framework coordination (v5.12.1). 3,269 tests across 33 suites.
 
 ## Architecture
 
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
@@ -1,6 +1,6 @@
 # Architecture
 
-Network-AI v5.12.0 — TypeScript/Node.js multi-agent orchestrator with 29 adapters, 3,269 tests, 72+ modules.
+Network-AI v5.12.1 — TypeScript/Node.js multi-agent orchestrator with 29 adapters, 3,269 tests, 72+ modules.
 
 ## The Multi-Agent Race Condition Problem
 
diff --git a/AUDIT_LOG_SCHEMA.md b/AUDIT_LOG_SCHEMA.md
@@ -1,4 +1,4 @@
-# Audit Log Schema — Network-AI v5.12.0
+# Audit Log Schema — Network-AI v5.12.1
 
 Network-AI writes a JSONL audit trail during permission management and swarm execution. This document describes every field and event type.
 
diff --git a/BENCHMARKS.md b/BENCHMARKS.md
@@ -1,6 +1,6 @@
 # Benchmarks & Performance
 
-> Performance data for Network-AI v5.12.0 deployments. Your swarm is only as fast as the backend it calls — this page helps you choose the right setup.
+> Performance data for Network-AI v5.12.1 deployments. Your swarm is only as fast as the backend it calls — this page helps you choose the right setup.
 
 ## BlackboardValidator Throughput
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,21 @@ All notable changes to Network-AI will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.12.1] - 2026-06-17
+
+### Added
+- **OpenAI Codex integration** — project-scoped `.codex/config.toml` registers the Network-AI MCP server (stdio) for the Codex CLI and IDE extension. One-command install: `codex mcp add network-ai -- npx -y -p network-ai network-ai-server --stdio`. New "Use with OpenAI Codex" section in README and a Codex block in QUICKSTART.
+- **`PRIVACY.md`** — explicit privacy policy: no data collection, no telemetry (opt-in BYOT only), no call-home; all state stored in local files the operator controls.
+
+### Fixed
+- **CI npm publish race** — the publish job now serializes per tag ref (`concurrency`) and treats a 403 as success when the version already exists on the registry, eliminating the E403 that occurred when two tag runs published the same version concurrently.
+- **`package.json` metadata** — removed the leading `./` from the four `bin` paths and set `repository.url` to the `git+https://…` form to silence npm publish warnings.
+
+### Changed
+- Version bump 5.12.0 → 5.12.1 across `package.json`, `skill.json`, `openapi.yaml`, the README release badge, the Claude Code plugin manifests, and documentation headers (ARCHITECTURE, BENCHMARKS, AUDIT_LOG_SCHEMA, INTEGRATION_GUIDE, references/adapter-system, SKILL, CLAUDE, CODEX, copilot-instructions).
+- Corrected stale test counts in `CLAUDE.md`, `CODEX.md`, and `CONTRIBUTING.md` to **3,269 tests across 33 suites**.
+- Sharper Claude Code plugin descriptions in `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json`.
+
 ## [5.12.0] - 2026-06-17
 
 ### Added
diff --git a/CLAUDE.md b/CLAUDE.md
@@ -4,14 +4,14 @@ This file is read automatically by Claude Code when working in this repository.
 
 ## Project Overview
 
-Network-AI is a TypeScript/Node.js multi-agent orchestrator — shared state, guardrails, budgets, and cross-framework coordination. Version 5.12.0.
+Network-AI is a TypeScript/Node.js multi-agent orchestrator — shared state, guardrails, budgets, and cross-framework coordination. Version 5.12.1.
 
 ## Build & Test Commands
 
 ```bash
 npm install                   # Install dependencies
 npx tsc --noEmit              # Type-check (zero errors expected)
-npm run test:all              # Run all 3,148 tests across 31 suites
+npm run test:all              # Run all 3,269 tests across 33 suites
 npm test                      # Core orchestrator tests only
 npm run test:security         # Security module tests
 npm run test:adapters         # All 29 adapter tests
diff --git a/CODEX.md b/CODEX.md
@@ -4,14 +4,14 @@ This file is read automatically by OpenAI Codex CLI when working in this reposit
 
 ## Project Overview
 
-Network-AI is a TypeScript/Node.js multi-agent orchestrator — shared state, guardrails, budgets, and cross-framework coordination. Version 5.12.0.
+Network-AI is a TypeScript/Node.js multi-agent orchestrator — shared state, guardrails, budgets, and cross-framework coordination. Version 5.12.1.
 
 ## Build & Test Commands
 
 ```bash
 npm install                   # Install dependencies
 npx tsc --noEmit              # Type-check (zero errors expected)
-npm run test:all              # Run all 3,148 tests across 31 suites
+npm run test:all              # Run all 3,269 tests across 33 suites
 npm test                      # Core orchestrator tests only
 npm run test:security         # Security module tests
 npm run test:adapters         # All 29 adapter tests
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -41,7 +41,7 @@ Unsolicited PRs without a linked, approved issue will be closed.
 2. Implement your change with tests
 3. Run the full test suite:
    ```bash
-   npm run test:all   # 3211 tests across 32 suites
+   npm run test:all   # 3,269 tests across 33 suites
    npx tsc --noEmit
    ```
 4. Open a PR referencing the approved issue
diff --git a/INTEGRATION_GUIDE.md b/INTEGRATION_GUIDE.md
@@ -564,4 +564,4 @@ Run these before declaring the integration production-ready:
 
 ---
 
-*Network-AI v5.12.0 · MIT License · https://github.com/Jovancoding/Network-AI*
+*Network-AI v5.12.1 · MIT License · https://github.com/Jovancoding/Network-AI*
diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@
 [![Website](https://img.shields.io/badge/website-network--ai.org-4b9df2?style=flat&logo=web&logoColor=white)](https://network-ai.org/)
 [![CI](https://github.com/Jovancoding/Network-AI/actions/workflows/ci.yml/badge.svg)](https://github.com/Jovancoding/Network-AI/actions/workflows/ci.yml)
 [![CodeQL](https://github.com/Jovancoding/Network-AI/actions/workflows/codeql.yml/badge.svg)](https://github.com/Jovancoding/Network-AI/actions/workflows/codeql.yml)
-[![Release](https://img.shields.io/badge/release-v5.12.0-blue.svg)](https://github.com/Jovancoding/Network-AI/releases)
+[![Release](https://img.shields.io/badge/release-v5.12.1-blue.svg)](https://github.com/Jovancoding/Network-AI/releases)
 [![npm](https://img.shields.io/npm/dw/network-ai.svg?label=npm%20downloads)](https://www.npmjs.com/package/network-ai)
 [![Tests](https://img.shields.io/badge/tests-3269%20passing-brightgreen.svg)](#testing)
 [![Adapters](https://img.shields.io/badge/frameworks-29%20supported-blueviolet.svg)](#adapter-system)
@@ -554,6 +554,8 @@ npm run test:phase12      # Context Throttler, Partition Planner, Coverage Gate,
 ## Use with Claude, ChatGPT & Codex
 
 > Using **Claude Code** (the CLI)? See [Use as a Claude Code Plugin](#use-as-a-claude-code-plugin) — one command installs every tool.
+>
+> Using **OpenAI Codex** (CLI or IDE)? See [Use with OpenAI Codex](#use-with-openai-codex) — add the MCP server with a single `codex mcp add`.
 
 Three integration files are included in the repo root:
 
diff --git a/SKILL.md b/SKILL.md
@@ -755,7 +755,7 @@ The following findings are drawn from the **MAESTRO Agent Security Threat** fram
 
 | Control | How Network-AI addresses it |
 |---|---|
-| **Exact version pinning** | npm `package.json` uses exact `"version": "5.12.0"` — no semver range specifiers; `clawhub install network-ai` pins to a specific published version |
+| **Exact version pinning** | npm `package.json` uses exact `"version": "5.12.1"` — no semver range specifiers; `clawhub install network-ai` pins to a specific published version |
 | **Zero transitive dependency drift** | All bundled Python scripts use Python stdlib only — `pip install` is never required; there are no third-party packages to drift, be compromised upstream, or introduce CVEs |
 | **Signed, tagged releases** | Every release is committed with a signed Git tag (`v5.7.x`); commit hash is verifiable against CHANGELOG.md; GitHub releases link tag → diff → changelog entry |
 | **Supply chain monitoring** | npm package continuously scored by Socket.dev (score A); any new dependency or permission change triggers an alert |
diff --git a/openapi.yaml b/openapi.yaml
@@ -6,7 +6,7 @@ info:
     blackboard coordination, parallel agent spawning, and permission gating
     via AuthGuardian. Requires the companion MCP server:
     `npm install -g network-ai && npx network-ai-server --port 3001`
-  version: 5.12.0
+  version: 5.12.1
   license:
     name: MIT
     url: https://github.com/Jovancoding/Network-AI/blob/main/LICENSE
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "network-ai",
-  "version": "5.12.0",
+  "version": "5.12.1",
   "description": "AI agent orchestration framework for TypeScript/Node.js - 29 adapters (LangChain, AutoGen, CrewAI, OpenAI Assistants, LlamaIndex, Semantic Kernel, Haystack, DSPy, Agno, MCP, OpenClaw, A2A, Codex, MiniMax, NemoClaw, APS, Copilot, LangGraph, Anthropic Computer Use, OpenAI Agents SDK, Vertex AI, Pydantic AI, Browser Agent, Hermes, Orchestrator, RLM + streaming variants). Built-in CLI, security, swarm intelligence, real-time streaming, and agentic workflow patterns.",
   "homepage": "https://network-ai.org",
   "main": "dist/index.js",
@@ -144,4 +144,3 @@
     "commander": "^15.0.0"
   }
 }
-
diff --git a/references/adapter-system.md b/references/adapter-system.md
@@ -2,7 +2,7 @@
 
 ## Overview
 
-The SwarmOrchestrator uses an **adapter pattern** to work with any agent framework. Instead of being locked to one system, you bring your own agents — from any framework — and the orchestrator handles coordination, shared state, permissions, and parallel execution. As of v5.12.0, 29 adapters are included.
+The SwarmOrchestrator uses an **adapter pattern** to work with any agent framework. Instead of being locked to one system, you bring your own agents — from any framework — and the orchestrator handles coordination, shared state, permissions, and parallel execution. As of v5.12.1, 29 adapters are included.
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
diff --git a/skill.json b/skill.json
@@ -1,6 +1,6 @@
 {
   "name": "SwarmOrchestrator",
-  "version": "5.12.0",
+  "version": "5.12.1",
   "description": "Local Python orchestration skill: multi-agent workflows via shared blackboard file, permission gating, token budget scripts, and persistent project context. The bundled Python scripts make no network calls and have zero third-party dependencies. The parent repository also contains a TypeScript engine (not included in this skill bundle). Workflow delegations via the host platform's sessions_send may invoke external model APIs.",
   "author": "Network-AI Community",
   "homepage": "https://network-ai.org",

Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "network-ai",`
`3`	`3`	`"description": "Gives Claude Code a multi-agent coordination layer over MCP — an atomic shared blackboard (locked propose/validate/commit), permission gating with HMAC/Ed25519-signed tokens, federated token-budget tracking, and append-only audit-log queries. Backed by an orchestrator with 29 framework adapters (LangChain, AutoGen, CrewAI, and more).",`
`4`		`- "version": "5.12.0",`
	`4`	`+ "version": "5.12.1",`
`5`	`5`	`"author": {`
`6`	`6`	`"name": "OpenClaw Community",`
`7`	`7`	`"url": "https://github.com/Jovancoding/Network-AI"`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Audit Log Schema — Network-AI v5.12.0`
	`1`	`+# Audit Log Schema — Network-AI v5.12.1`
`2`	`2`
`3`	`3`	`Network-AI writes a JSONL audit trail during permission management and swarm execution. This document describes every field and event type.`
`4`	`4`