Skip to content

Commit b29dfce

Browse files
authored
fix(plugins): prefer PostgreSQL and use canonical viz identity (#351)
* fix(plugins): prefer PostgreSQL and rename viz package * fix(plugins): preserve viz publication migration * docs(plugins): use canonical companion identities * fix(plugins): pin final viz migration head * fix(plugins): advance viz pin after CI correction * fix(plugins): pin merged viz publication
1 parent e75b71a commit b29dfce

20 files changed

Lines changed: 346 additions & 53 deletions

‎.claude-plugin/marketplace.json‎

Lines changed: 25 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -5,14 +5,14 @@
55
"email": "[email protected]"
66
},
77
"metadata": {
8-
"description": "The Cortex family of Claude Code plugins: home of hypermnesia-mcp (the persistent-memory server formerly named cortex, renamed in v4.15.0 over a directory name collision), zetetic-team-subagents, and cortex-viz. The marketplace name stays cortex-plugins: it is the brand-level umbrella, while hypermnesia-mcp is one package inside it.",
8+
"description": "The Cortex family of Claude Code plugins: home of hypermnesia-mcp (the persistent-memory server formerly named cortex, renamed in v4.15.0 over a directory name collision), zetetic-team-subagents, and hypermnesia-mcp-viz. The marketplace name stays cortex-plugins: it is the brand-level umbrella, while hypermnesia-mcp is one package inside it.",
99
"version": "4.17.2"
1010
},
1111
"plugins": [
1212
{
1313
"name": "hypermnesia-mcp",
1414
"source": "./",
15-
"description": "Cortex — persistent memory and cognitive profiling for Claude Code (renamed from the 'cortex' plugin in v4.15.0 to match the PyPI/MCP-registry identity hypermnesia-mcp) — thermodynamic memory with heat/decay, intent-aware retrieval, biological plasticity, codebase intelligence, and cognitive profiling. 50 MCP tools (53 with the optional automatised-pipeline + prd-spec-generator integrations) with enriched schemas (visualization extracted to the standalone cortex-viz MCP). PostgreSQL + pgvector in CLI mode; automatic SQLite fallback in Cowork/sandboxed mode. v3.17.0 — autonomous per-project wiki: SessionStart auto-spawns a 6-hour consolidate cycle; a headless `claude -p` worker drains the curation-gap queue, calls codebase-intelligence MCP tools to ground each section in the real call graph, and authors missing anchor pages (architecture / services / api / data-flow / operations / decisions / PRD) per project from the source tree. 15 canonical scopes × 13 file sections; per-project dashboards under `wiki/_dashboards/`. Mermaid diagrams have a 🔍 lens with zoom + pan. Workflow graph with caller-qualified CALLS chains rendering full method-to-method dependencies (native tree-sitter, no AP required). Side panel humanized for non-technical users. Ingests codebase analysis (ai-automatised-pipeline) and PRDs (prd-spec-generator) into wiki + memory + knowledge graph. Docker image available.",
15+
"description": "Cortex — persistent memory and cognitive profiling for Claude Code (renamed from the 'cortex' plugin in v4.15.0 to match the PyPI/MCP-registry identity hypermnesia-mcp) — thermodynamic memory with heat/decay, intent-aware retrieval, biological plasticity, codebase intelligence, and cognitive profiling. 50 MCP tools (53 with the optional automatised-pipeline + ai-architect-mcp-spec integrations) with enriched schemas (visualization extracted to the standalone Hypermnesia MCP Viz server). PostgreSQL + pgvector in CLI mode; automatic SQLite fallback in Cowork/sandboxed mode. v3.17.0 — autonomous per-project wiki: SessionStart auto-spawns a 6-hour consolidate cycle; a headless `claude -p` worker drains the curation-gap queue, calls codebase-intelligence MCP tools to ground each section in the real call graph, and authors missing anchor pages (architecture / services / api / data-flow / operations / decisions / PRD) per project from the source tree. 15 canonical scopes × 13 file sections; per-project dashboards under `wiki/_dashboards/`. Mermaid diagrams have a 🔍 lens with zoom + pan. Workflow graph with caller-qualified CALLS chains rendering full method-to-method dependencies (native tree-sitter, no AP required). Side panel humanized for non-technical users. Ingests codebase analysis (ai-automatised-pipeline) and PRDs (ai-architect-mcp-spec) into wiki + memory + knowledge graph. Docker image available.",
1616
"version": "4.17.2",
1717
"author": {
1818
"name": "Clement Deust",
@@ -58,13 +58,14 @@
5858
"category": "productivity"
5959
},
6060
{
61-
"name": "cortex-viz",
61+
"name": "hypermnesia-mcp-viz",
6262
"source": {
6363
"source": "github",
64-
"repo": "cdeust/cortex-viz"
64+
"repo": "cdeust/cortex-viz",
65+
"sha": "1c1940e278979f35cdecea6146d7fb5f749907e9"
6566
},
66-
"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, a consolidation kanban, and a curated knowledge/wiki browser. Read-only bridge over Cortex's shared PostgreSQL store and the ~/.claude artifacts; it renders, it never remembers. Restores the open_visualization / get_methodology_graph / query_workflow_graph tools removed from Cortex 3.21.0; launch with /cortex-visualize.",
67-
"version": "2.8.0",
67+
"description": "Canonical Claude Code publication for the standalone Hypermnesia MCP Viz server — a live neural-graph galaxy of every project, file, symbol, memory, discussion and wiki page, plus a per-session execution trace, a consolidation kanban, and a curated knowledge/wiki browser. Read-only bridge over Cortex's shared PostgreSQL store and the ~/.claude artifacts; it renders, it never remembers. Restores the open_visualization and get_methodology_graph tools removed from Cortex; launch with /cortex-visualize.",
68+
"version": "3.0.0",
6869
"author": {
6970
"name": "Clement Deust",
7071
"email": "[email protected]"
@@ -82,6 +83,24 @@
8283
],
8384
"category": "productivity"
8485
},
86+
{
87+
"name": "cortex-viz",
88+
"source": "./plugins/cortex-viz-deprecated",
89+
"description": "DEPRECATED — renamed to hypermnesia-mcp-viz in v3.0.0. This frozen, nonfunctional migration shim has no MCP server or tools; it only announces the replacement at session start. Uninstall cortex-viz@cortex-plugins, refresh this marketplace, then install hypermnesia-mcp-viz@cortex-plugins. The repository remains cdeust/cortex-viz; only the marketplace plugin identity changed.",
90+
"version": "2.8.0",
91+
"author": {
92+
"name": "Clement Deust",
93+
"email": "[email protected]"
94+
},
95+
"homepage": "https://github.com/cdeust/cortex-viz",
96+
"repository": "https://github.com/cdeust/cortex-viz",
97+
"license": "MIT",
98+
"keywords": [
99+
"deprecated",
100+
"visualization"
101+
],
102+
"category": "productivity"
103+
},
85104
{
86105
"name": "zetetic-team-subagents",
87106
"source": {

‎.github/workflows/ci.yml‎

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -207,6 +207,23 @@ jobs:
207207
# silently fall back. Raise the floor when coverage rises.
208208
run: pytest --cov=mcp_server --cov-report=xml --cov-report=term-missing --cov-fail-under=82
209209

210+
# Match the primary Claude and additive Codex client identities against
211+
# a real, explicitly configured PostgreSQL instance. Explicit targets
212+
# cannot fall back, so successful memory_stats calls prove PostgreSQL
213+
# was selected for both host contracts.
214+
- name: Verify Claude and Codex PostgreSQL-first MCP contracts
215+
if: matrix.python-version == '3.12'
216+
env:
217+
CORTEX_RUNTIME: cowork
218+
HF_HUB_OFFLINE: "1"
219+
TRANSFORMERS_OFFLINE: "1"
220+
CORTEX_RERANKER_OFFLINE: "1"
221+
run: >-
222+
python scripts/verify_mcp_hosts.py
223+
--clients claude-code codex-cli --profiles lean
224+
--storage-selection auto
225+
-- hypermnesia-mcp
226+
210227
# The advertised test count is the one claim the static gate cannot check
211228
# without collecting the suite, so it is checked in the job that already
212229
# has the suite installed. `--collect-only` re-collects (~seconds) rather
@@ -432,20 +449,25 @@ jobs:
432449
"$cli_bin/codex" plugin list --json \
433450
| python -c 'import json,sys; d=json.load(sys.stdin); p=[x for x in d.get("installed",[]) if x.get("pluginId")=="hypermnesia-mcp-codex@cortex-codex-plugins"]; assert len(p)==1, p; assert p[0]["installed"] and p[0]["enabled"]'
434451
"$cli_bin/codex" mcp list --json \
435-
| python -c 'import json,sys; ss=[s for s in json.load(sys.stdin) if s.get("name")=="cortex"]; assert len(ss)==1, ss; s=ss[0]; assert s["startup_timeout_sec"]==180.0, s; assert s["transport"]["command"]=="uvx", s'
452+
| python -c 'import json,sys; ss=[s for s in json.load(sys.stdin) if s.get("name")=="cortex"]; assert len(ss)==1, ss; s=ss[0]; assert s["startup_timeout_sec"]==180.0, s; assert s["transport"]["command"]=="uvx", s; assert s["transport"]["env"]["CORTEX_RUNTIME"]=="cowork", s'
436453
mapfile -t plugin_command < <(
437454
python -c 'import json; s=json.load(open("plugins/hypermnesia-mcp-codex/.mcp.json"))["mcpServers"]["cortex"]; print(s["command"]); print(*s["args"], sep="\n")'
438455
)
439456
plugin_timeout="$(
440457
python -c 'import json; print(json.load(open("plugins/hypermnesia-mcp-codex/.mcp.json"))["mcpServers"]["cortex"]["startup_timeout_sec"])'
441458
)"
459+
plugin_runtime="$(
460+
python -c 'import json; print(json.load(open("plugins/hypermnesia-mcp-codex/.mcp.json"))["mcpServers"]["cortex"]["env"]["CORTEX_RUNTIME"])'
461+
)"
462+
CORTEX_RUNTIME="$plugin_runtime" \
442463
UV_CACHE_DIR="$RUNNER_TEMP/cortex-codex-cold-uv-cache" \
443464
UV_TOOL_DIR="$RUNNER_TEMP/cortex-codex-cold-uv-tools" \
444465
PYTHONPATH="$GITHUB_WORKSPACE" \
445466
python scripts/verify_mcp_hosts.py \
446467
--timeout "$plugin_timeout" --clients codex-cli --profiles lean \
447468
--command-includes-profile \
448469
--allow-bootstrap-network \
470+
--storage-selection auto \
449471
-- "${plugin_command[@]}"
450472
451473
test-windows:

‎.mcpbignore‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,7 @@ commands/
5555
skills/
5656
plugins/hypermnesia-mcp-codex/
5757
plugins/cortex-deprecated/
58+
plugins/cortex-viz-deprecated/
5859
scripts/
5960
docker/
6061
Dockerfile

‎CHANGELOG.md‎

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -14,8 +14,26 @@ adheres to [Semantic Versioning](https://semver.org/).
1414
exact 10-tool `lean` profile. Its 180-second startup ceiling is backed by a
1515
clean-cache `uvx` lifecycle measured at 110.46 seconds locally (macOS 26.5.1
1616
arm64, uv 0.8.19) and 23.87 seconds on `ubuntu-latest` CI. This is additive:
17-
Claude Code remains the primary integration and keeps its complete profile,
18-
lifecycle hooks, custom agent, marketplace, and installation path unchanged.
17+
Claude Code remains the primary integration and keeps its primary plugin
18+
manifest, complete profile, lifecycle hooks, custom agent, and installation
19+
path unchanged. Its shared marketplace catalog changes only for the
20+
visualization-plugin migration described below.
21+
- **Breaking visualization-plugin publication rename, with migration shim.**
22+
The canonical Claude Code publication is
23+
`hypermnesia-mcp-viz@cortex-plugins` 3.0.0, sourced from the unchanged
24+
`cdeust/cortex-viz` repository at exact commit
25+
`1c1940e278979f35cdecea6146d7fb5f749907e9`. Existing installs must uninstall
26+
`cortex-viz@cortex-plugins`, refresh `cortex-plugins`, and install
27+
`hypermnesia-mcp-viz@cortex-plugins`. The former identity remains as a
28+
frozen 2.8.0 migration shim that only prints those instructions; it
29+
registers no MCP server or tools. Claude's composed tool names also change:
30+
`mcp__plugin_cortex-viz_cortex-viz__open_visualization` becomes
31+
`mcp__plugin_hypermnesia-mcp-viz_hypermnesia-mcp-viz__open_visualization`,
32+
and `mcp__plugin_cortex-viz_cortex-viz__get_methodology_graph` becomes
33+
`mcp__plugin_hypermnesia-mcp-viz_hypermnesia-mcp-viz__get_methodology_graph`.
34+
Current companion tables, MCP examples, and API/module documentation now use
35+
`hypermnesia-mcp-viz` and `ai-architect-mcp-spec`; retired names remain only
36+
in explicit migration or historical material.
1937
- **Hook-free MCP protocol and host-configuration gates.** CI now starts the
2038
installed production stdio entry point under representative Claude, Gemini,
2139
and Codex client identities, completes the MCP lifecycle for both the full

0 commit comments

Comments
 (0)