@unified-product-graph/mcp-server 0.7.3 → 0.7.5

package/CHANGELOG.md

@@ -6,13 +6,13 @@ All notable changes to `@unified-product-graph/mcp-server` are documented in thi
 
 ### Changed
 
-- **`list_frameworks` / `get_framework` now serve the 34 canonical frameworks**, not the full 216-record research library. They previously imported `UPG_FRAMEWORKS` from the internal `@unified-product-graph/frameworks` package; they now source it from `@unified-product-graph/core`'s canonical surface — matching `cloud-server`, the published `core` export, and the public catalog on unifiedproductgraph.org. Research frameworks remain internal and are promoted into the canonical set incrementally as each is reviewed. `get_framework` for a non-canonical id now returns "Unknown framework id".
+- **`list_frameworks` / `get_framework` now serve the 34 canonical frameworks**, not the full 216-record research library. They previously imported `UPG_FRAMEWORKS` from the internal `@unified-product-graph/frameworks` package; they now source it from `@unified-product-graph/core`'s canonical surface, matching `cloud-server`, the published `core` export, and the public catalog on unifiedproductgraph.org. Research frameworks remain internal and are promoted into the canonical set incrementally as each is reviewed. `get_framework` for a non-canonical id now returns "Unknown framework id".
 
 ## [0.6.2] - 2026-05-26
 
 ### Fixed
 
-- **Server failed to start when launched through a symlinked path** — which broke the primary install path `claude mcp add upg -- npx @unified-product-graph/mcp-server`, npx `.bin` shims, global installs, and macOS `/tmp`. The entrypoint guard compared `process.argv[1]` (literal invocation path) to `import.meta.url` (symlink-resolved by the ESM loader) as raw strings; when they diverged the server exited 0 with no output, which MCP clients report as "Failed to connect." The guard now compares realpaths. Added a regression test that spawns the built binary through a symlink.
+- **Server failed to start when launched through a symlinked path**, which broke the primary install path `claude mcp add upg -- npx @unified-product-graph/mcp-server`, npx `.bin` shims, global installs, and macOS `/tmp`. The entrypoint guard compared `process.argv[1]` (literal invocation path) to `import.meta.url` (symlink-resolved by the ESM loader) as raw strings; when they diverged the server exited 0 with no output, which MCP clients report as "Failed to connect." The guard now compares realpaths. Added a regression test that spawns the built binary through a symlink.
 
 ## [0.6.1] - 2026-05-26
 

package/README.md

@@ -2,7 +2,7 @@
 
 A local [Model Context Protocol](https://modelcontextprotocol.io) server that reads and writes `.upg` files. The `.upg` file is a portable JSON document holding your product graph: entities (personas, features, hypotheses, OKRs) and the relationships between them.
 
-The server exposes 90 tools. They cover graph reads and writes plus introspection of everything `@unified-product-graph/core` ships — entity types, edges, frameworks, regions, playbooks, lenses, anti-patterns, benchmarks.
+The server exposes 90 tools. They cover graph reads and writes plus introspection of everything `@unified-product-graph/core` ships: entity types, edges, frameworks, regions, playbooks, lenses, anti-patterns, benchmarks.
 
 See [CHANGELOG.md](./CHANGELOG.md) for the release history.
 
@@ -52,10 +52,10 @@ If no `.upg` file exists, the server creates a blank `product.upg`. Use `create_
 
 The server picks the `.upg` file to load in this order:
 
-1. `--file` flag — use that file directly
-2. `.upg/workspace.json` — load the default product from a workspace
-3. `*.upg` files in cwd — first alphabetically
-4. Otherwise — create a blank `product.upg`
+1. `--file` flag: use that file directly
+2. `.upg/workspace.json`: load the default product from a workspace
+3. `*.upg` files in cwd: first alphabetically
+4. Otherwise: create a blank `product.upg`
 
 ## Conceptual Surface
 
@@ -73,7 +73,7 @@ UPG ships five collaborating primitives. The MCP server exposes all five.
 
 ## MCP Tools
 
-90 tools across nine domains. Full reference: [TOOLS.md](./TOOLS.md) — generated from `src/tools/*.ts` and shipped on npm.
+90 tools across nine domains. Full reference: [TOOLS.md](./TOOLS.md), generated from `src/tools/*.ts` and shipped on npm.
 
 | Domain | Count | What it covers |
 |---|---|---|
@@ -116,7 +116,7 @@ Every canonical export from `@unified-product-graph/core` is reachable from the
 - **Entity meta:** `list_entity_types`, `get_entity_meta` (immutable type_id, maturity tier, since-version, replacements)
 - **Domains:** `list_domains` (with `with_guide_only` toggle), `get_domain_guide`
 - **Anti-patterns:** `list_anti_patterns`, `get_anti_pattern` (machine-evaluable conditions, remediation, severity, applicable stages)
-- **Benchmarks:** `list_benchmarks({ kind })` — count / relationship / ratio / domain-activation catalogs (data behind `get_graph_digest` health logic)
+- **Benchmarks:** `list_benchmarks({ kind })`: count / relationship / ratio / domain-activation catalogs (data behind `get_graph_digest` health logic)
 - **Product stages:** `list_product_stages` (canonical 9-stage journey)
 - **Spec version:** `get_spec_version` (UPG version + counts)
 
@@ -153,9 +153,9 @@ The install script supports six AI coding tools: Claude Code, Cursor, Codex CLI,
 
 ## Companion Docs
 
-- **[TOOLS.md](./TOOLS.md)** — source-of-truth tool reference (auto-generated)
-- **[CHANGELOG.md](./CHANGELOG.md)** — release history
-- **[unifiedproductgraph.org](https://unifiedproductgraph.org)** — the UPG specification and conceptual model
+- **[TOOLS.md](./TOOLS.md)**: source-of-truth tool reference (auto-generated)
+- **[CHANGELOG.md](./CHANGELOG.md)**: release history
+- **[unifiedproductgraph.org](https://unifiedproductgraph.org)**: the UPG specification and conceptual model
 
 ## Spec
 
@@ -163,4 +163,4 @@ The Unified Product Graph format is documented at [unifiedproductgraph.org](http
 
 ## License
 
-MIT — see [LICENSE](./LICENSE).
+MIT; see [LICENSE](./LICENSE).