@unified-product-graph/cloud-server 0.8.5 → 0.8.6

package/dist/tools-manifest.json

@@ -1,13 +1,14 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/cloud-server",
-  "package_version": "0.8.5",
-  "tool_count": 91,
+  "package_version": "0.8.6",
+  "tool_count": 93,
   "domains": [
     "products",
     "context",
     "nodes",
     "edges",
+    "frameworks",
     "areas",
     "schema",
     "collaboration",
@@ -1009,6 +1010,100 @@
       "return_shape": "{ from, to, affected: number, dry_run: boolean }",
       "atomicity": "atomic-with-rollback (write path)"
     },
+    {
+      "name": "apply_framework",
+      "description": "Apply a framework (MoSCoW, RICE, Kano, ...) to a set of entities in a product: creates a framework_exercise node and an `includes` edge to each entity. The per-entity result is recorded on the edge via score_entity, never on the entity node, so the same entity can sit in many exercises and any entity type can be scored. Returns { exercise_id, exercise, included, warnings }.",
+      "domain": "frameworks",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "Required. Product the exercise belongs to."
+          },
+          "framework_id": {
+            "type": "string",
+            "description": "Required. UPGFramework.id (e.g. \"moscow\", \"rice-scoring\")."
+          },
+          "title": {
+            "type": "string",
+            "description": "Human label for the exercise (default \"<Framework> exercise\")."
+          },
+          "entity_ids": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Entities to pull into the exercise (any type)."
+          },
+          "status": {
+            "type": "string",
+            "description": "Lifecycle phase: draft | active | archived (default draft)."
+          }
+        },
+        "required": [
+          "product_id",
+          "framework_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing product_id/framework_id or an unknown framework_id."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "score_entity"
+      ],
+      "source": "src/tools/frameworks.ts:27",
+      "symbol": "applyFramework",
+      "returns": "JSON: `{ exercise_id, exercise, included: [{ edge_id, entity_id }], warnings }`.",
+      "return_shape": "{ exercise_id, exercise, included: [{ edge_id, entity_id }], warnings }",
+      "atomicity": "per-write atomic; the exercise node and each includes edge commit\nindependently (a target that cannot be included is reported in `warnings`)."
+    },
+    {
+      "name": "score_entity",
+      "description": "Record a framework's result for one entity on the exercise's includes edge (a MoSCoW bucket, a RICE score, a canvas slot). Auto-includes the entity if not already in scope. Merges into existing edge properties unless replace is set. The product is resolved from the exercise node. Returns { edge, warnings }.",
+      "domain": "frameworks",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "exercise_id": {
+            "type": "string",
+            "description": "Required. The framework_exercise id."
+          },
+          "entity_id": {
+            "type": "string",
+            "description": "Required. The entity being scored."
+          },
+          "values": {
+            "type": "object",
+            "description": "Required. The result as { input: value }, e.g. { \"moscow\": \"must\" } or { \"reach\": 800, \"impact\": 3 }."
+          },
+          "replace": {
+            "type": "boolean",
+            "description": "Replace the edge properties instead of merging (default false)."
+          }
+        },
+        "required": [
+          "exercise_id",
+          "entity_id",
+          "values"
+        ]
+      },
+      "throws": [
+        "textError when the exercise/entity is missing or the node is not a\nframework_exercise."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "apply_framework"
+      ],
+      "source": "src/tools/frameworks.ts:97",
+      "symbol": "scoreEntity",
+      "returns": "JSON: `{ edge, warnings }`.",
+      "return_shape": "{ edge, warnings }",
+      "atomicity": "atomic-with-rollback (single edge upsert)."
+    },
     {
       "name": "create_area",
       "description": "Create a new product area node (type 'area') in a product. Product areas are top-level organisational units within a product.",

package/migrations/005_edge_properties.sql

@@ -0,0 +1,14 @@
+-- 005_edge_properties.sql
+--
+-- Framework-exercise parity (UPG 0.8.6): edges may now carry a structured
+-- payload. The local `.upg` format gained gated edge `properties` in 0.8.4
+-- (the `framework_exercise_includes_node` edge records a framework's per-entity
+-- result on the edge, not the node). This brings the Postgres-backed cloud
+-- store to parity by adding a dedicated `properties` JSONB column, distinct from
+-- the server-managed `metadata` column.
+--
+-- Additive + idempotent: safe to run on an existing deployment. Existing edges
+-- get a NULL payload (read back as "no properties").
+
+ALTER TABLE upg.edges
+  ADD COLUMN IF NOT EXISTS properties JSONB;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unified-product-graph/cloud-server",
-  "version": "0.8.5",
+  "version": "0.8.6",
   "description": "Postgres-backed MCP server for the Unified Product Graph, self-hostable, open source",
   "license": "MIT",
   "author": "The Product Creator <hello@theproductcreator.com>",