chore(release): 3.1.1 — build-breaking corrective, align version surfaces

.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Hypermnesia MCP Viz — the read-only visualization companion for Cortex",
-    "version": "3.1.0"
+    "version": "3.1.1"
   },
   "plugins": [
     {
       "name": "hypermnesia-mcp-viz",
       "source": "./",
       "description": "Live memory galaxy, methodology map, workflow graph, wiki browser, and execution trace over the shared Cortex store.",
-      "version": "3.1.0",
+      "version": "3.1.1",
       "author": {
         "name": "Clement Deust",
         "email": "admin@ai-architect.tools"

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hypermnesia-mcp-viz",
   "description": "Standalone visualization MCP for Cortex — a live neural-graph galaxy of every project, file, symbol, memory, discussion and wiki page, plus a per-session execution trace. Read-only bridge over Cortex's shared PostgreSQL and the ~/.claude artifacts.",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "author": {
     "name": "Clement Deust",
     "email": "admin@ai-architect.tools"

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "hypermnesia-mcp-viz",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Read-only visualization and graph MCP for Cortex, packaged for Codex.",
   "author": {
     "name": "Clement Deust",

CHANGELOG.md

@@ -5,6 +5,11 @@ Releases before 2.7.0 were recorded as `chore(release)` / `release:` commits in
 
 ## [Unreleased]
 
+## [3.1.1] - 2026-08-10
+
+**Upgrade urgency: build-breaking.** 3.1.0 cannot build a graph at all —
+install this release instead.
+
 ### Added
 - `publish-registry` job in `Release.yaml`: RELEASING.md step 5 (publishing
   `server.json` to the official MCP Registry) is now automated, running
@@ -13,6 +18,25 @@ Releases before 2.7.0 were recorded as `chore(release)` / `release:` commits in
   `workflow_dispatch` recovery path repairs a stale registry entry for an
   already-tagged release without re-publishing the package.
 
+### Fixed
+- The graph builder crashed on its first statement and `/api/graph/progress`
+  never left `starting` (#134). Commit `45d4a80` (published in 3.1.0) deleted
+  `graph_event_stream`'s module-level `emit`/`close`/`reset` forwarders on
+  the premise that nothing in this repository's history called them; they
+  had four callers (`graph_build_run.py`'s `reset()`/`emit()`/finally-`close()`
+  and `graph_build_merge.py`'s `emit()`), all binding the module once and
+  calling its functions for the lifetime of a build. Restored all three
+  forwarders, with `emit` now forwarding the `event_meta` parameter it had
+  been silently dropping — that drift was the commit's real defect and the
+  reason to fix the forwarder, not delete it.
+- A failing end-of-stream terminator was silently swallowed (#135).
+  `graph_build_run.py`'s `finally` block sent the stream-closing call inside
+  `except Exception: pass`, so a failure there produced no log line and no
+  counter — which is exactly why #134's `AttributeError` on this same call
+  reached a release unnoticed. The exception's type and message are now
+  reported to stderr before the lock releases; it is still never re-raised,
+  since a failure here must not mask the build outcome being unwound.
+
 ## [3.1.0] - 2026-08-10
 
 **Upgrading from 2.8.0:** this release carries a breaking distribution-identity

README.md

@@ -12,7 +12,7 @@
   <img src="https://img.shields.io/badge/MCP-Codex_%C2%B7_Gemini_%C2%B7_Claude-blue.svg" alt="Cross-platform MCP for Codex, Gemini CLI, and Claude Code">
   <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License">
   <img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="Python 3.10+">
-  <img src="https://img.shields.io/badge/version-3.1.0-brightgreen.svg" alt="Version 3.1.0">
+  <img src="https://img.shields.io/badge/version-3.1.1-brightgreen.svg" alt="Version 3.1.1">
   <a href="https://www.bestpractices.dev/projects/13846"><img src="https://www.bestpractices.dev/projects/13846/badge" alt="OpenSSF Best Practices"></a>
 </p>
 

cortex_viz/identity.py

@@ -7,4 +7,4 @@
 
 DISTRIBUTION_NAME = "hypermnesia-mcp-viz"
 MCP_REGISTRY_ID = "io.github.cdeust/hypermnesia-mcp-viz"
-VERSION = "3.1.0"
+VERSION = "3.1.1"

docs/ROADMAP.md

@@ -8,7 +8,7 @@ Anything with an issue number is tracked; anything without one is an intention.
 
 ## Where the project is
 
-Current version **3.1.0**. All six views (Graph, Brain, Trace, Knowledge, Wiki,
+Current version **3.1.1**. All six views (Graph, Brain, Trace, Knowledge, Wiki,
 Board) are bridged to live data. The galaxy builds end to end at 75k+ nodes and
 the 3D brain streams the full graph into a cortical mesh. Trace works with no
 database at all. The supply-chain wave ([#37](https://github.com/cdeust/cortex-viz/issues/37))

gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hypermnesia-mcp-viz",
-  "version": "3.1.0",
+  "version": "3.1.1",
   "description": "Read-only visualization and graph MCP for Cortex, packaged for Gemini CLI.",
   "mcpServers": {
     "hypermnesia-mcp-viz": {

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "hypermnesia-mcp-viz"
-version = "3.1.0"
+version = "3.1.1"
 description = "Visualization and graph MCP server for Cortex — neural graph, methodology map, workflow graph, and trace UI extracted from the Cortex memory engine"
 readme = "README.md"
 license = "MIT"

server.json

@@ -6,13 +6,13 @@
     "url": "https://github.com/cdeust/cortex-viz",
     "source": "github"
   },
-  "version": "3.1.0",
+  "version": "3.1.1",
   "websiteUrl": "https://ai-architect.tools/cortex",
   "packages": [
     {
       "registryType": "pypi",
       "identifier": "hypermnesia-mcp-viz",
-      "version": "3.1.0",
+      "version": "3.1.1",
       "runtimeHint": "python",
       "transport": {
         "type": "stdio"