@unified-product-graph/mcp-server 0.6.1 → 0.6.3

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to `@unified-product-graph/mcp-server` are documented in this file. Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [0.6.3] - 2026-05-27
+
+### 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".
+
+## [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.
+
+## [0.6.1] - 2026-05-26
+
+### Changed
+
+- Metadata only: `UPG_VERSION` aligned to 0.6.1 and `repository` repointed to the public `unified-product-graph/tools` mirror. No runtime changes.
+
 ## [0.6.0] - 2026-05-22
 
 Aligned with `@unified-product-graph/core@0.6.0` launch train.

package/TOOLS.md

@@ -1922,7 +1922,7 @@ JSON: `{ patterns: string[], total: number }`
 
 ### `list_frameworks`
 
-List canonical `UPGFramework` definitions (several hundred records spanning strategy, discovery, prioritisation, design, growth, engineering, and reflection classics). Paginated (default 50, max 200). Cursor is opaque: pass `next_cursor` from a previous response. Optional `category` is exact-match against `UPGFramework.category` and applies before pagination.
+List the canonical `UPGFramework` definitions — the 34 curated, famous product frameworks that anchor the public catalog (spanning strategy, discovery, prioritisation, design, growth, engineering, and reflection classics). Paginated (default 50, max 200). Cursor is opaque: pass `next_cursor` from a previous response. Optional `category` is exact-match against `UPGFramework.category` and applies before pagination.
 
 **Atomicity:** `atomic (read-only)`
 
@@ -2507,6 +2507,31 @@ pure spec-shape check; `skip_drift: true` for catalog-only.
   "_hash": "sha256-abc123"
 }
 
+// Run a full graph health check — schema drift + anti-pattern violations
+// Input:
+{}
+// Output (truncated):
+{
+  "valid": false,
+  "summary": {
+    "entity_drift": 2,
+    "edge_drift": 0,
+    "property_drift": 1,
+    "anti_pattern_violations_high": 1,
+    "anti_pattern_violations_medium": 2,
+    "anti_pattern_violations_low": 0,
+    "spec_version": "0.4.0",
+    "scope": "all"
+  },
+  "entity_drift": [
+    { "id": "pain_01", "type": "pain_point", "title": "Slow onboarding", "suggested_migration": { "kind": "rename", "to": "need" } }
+  ],
+  "anti_pattern_violations": [
+    { "anti_pattern_id": "features-without-hypotheses", "severity": "high", "remediation": "Add hypothesis_claim nodes linked to features via feature_tests_hypothesis" }
+  ],
+  "_hash": "sha256-abc123"
+}
+
 **See also:** `migrate_type`, `migrate_properties`, `rename_edge_type`, `get_anti_pattern_violations_for`, `list_anti_patterns`, `list_type_migrations`, `list_edge_migrations`, `inspect`