@kylewadegrove/cutline-mcp-cli-staging 0.6.0 → 0.7.0

package/dist/servers/cutline-server.js

@@ -1827,19 +1827,57 @@ async function extractConstraintsFromDoc(docId, text, generateFn, options = {})
   return convertExtractedToNodes(docId, extracted, options);
 }
 
+// ../mcp/dist/mcp/src/context-graph/types.js
+var ENTITY_TYPES = [
+  "feature",
+  "component",
+  "data_type",
+  "cause",
+  "requirement"
+];
+var EDGE_TYPES = [
+  "REQUIRES",
+  // Feature -> Component|Requirement
+  "HANDLES",
+  // Component -> DataType
+  "GOVERNED_BY",
+  // DataType -> Constraint
+  "BOUNDED_BY",
+  // Component|Feature -> Constraint
+  "DEPENDS_ON",
+  // Component -> Component
+  "CAUSES"
+  // Cause -> Feature
+];
+function isEntityType(value) {
+  return ENTITY_TYPES.includes(value);
+}
+function isEdgeType(value) {
+  return EDGE_TYPES.includes(value);
+}
+function normalizeEntityType(value, fallback = "component") {
+  return isEntityType(value) ? value : fallback;
+}
+function normalizeEdgeType(value, fallback = "DEPENDS_ON") {
+  return isEdgeType(value) ? value : fallback;
+}
+
 // ../mcp/dist/mcp/src/adapters/requirements-adapter.js
 var EXTRACTION_SYSTEM_PROMPT2 = `You are a requirements graph extractor. Given product requirements (PRD, user stories, specs), extract a structured graph of entities, relationships, and non-functional requirements.
 
 Extract three things:
 
 1. **Entities** \u2014 the nouns of the system:
+   - "cause": Why a behavior/guardrail is needed (risk source, incident class, business driver)
    - "feature": User-facing capabilities (e.g., "Document Upload", "User Authentication")
+   - "requirement": Verifiable obligations that must hold (functional or non-functional)
    - "component": Technical building blocks (e.g., "API Gateway", "User Database", "S3 Storage")
    - "data_type": Data categories with compliance implications (e.g., "PII", "Financial Document", "Session Token")
    Give each entity a concise name, type, optional description, and aliases (alternate names).
 
 2. **Relationships** between entities:
-   - REQUIRES: Feature -> Component (e.g., "Document Upload" REQUIRES "S3 Storage")
+   - CAUSES: Cause -> Feature (e.g., "Credential stuffing risk" CAUSES "Adaptive login controls")
+   - REQUIRES: Feature -> Requirement or Feature -> Component
    - HANDLES: Component -> DataType (e.g., "User Database" HANDLES "PII")
    - DEPENDS_ON: Component -> Component (e.g., "API Gateway" DEPENDS_ON "Auth Service")
 
@@ -1860,7 +1898,7 @@ var EXTRACTION_SCHEMA2 = {
         type: "object",
         properties: {
           name: { type: "string" },
-          type: { type: "string", enum: ["feature", "component", "data_type"] },
+          type: { type: "string", enum: ["feature", "component", "data_type", "cause", "requirement"] },
           description: { type: "string" },
           aliases: { type: "array", items: { type: "string" } }
         },
@@ -1874,7 +1912,7 @@ var EXTRACTION_SCHEMA2 = {
         properties: {
           source_name: { type: "string" },
           target_name: { type: "string" },
-          relationship: { type: "string", enum: ["REQUIRES", "HANDLES", "DEPENDS_ON"] }
+          relationship: { type: "string", enum: ["CAUSES", "REQUIRES", "HANDLES", "DEPENDS_ON"] }
         },
         required: ["source_name", "target_name", "relationship"]
       }
@@ -1968,7 +2006,7 @@ function buildGraph(sourceId, extracted, existing = []) {
     resolved.set(ext.name.toLowerCase(), id);
     return {
       id,
-      type: ext.type,
+      type: normalizeEntityType(ext.type, "component"),
       name: ext.name,
       aliases: ext.aliases ?? [],
       description: ext.description,
@@ -1994,10 +2032,10 @@ function buildGraph(sourceId, extracted, existing = []) {
     edges.push({
       id: `${sourceId}_edge_${slugify(rel.source_name)}_${rel.relationship}_${slugify(rel.target_name)}`,
       source_id: srcId,
-      source_type: srcEntity?.type ?? "component",
+      source_type: normalizeEntityType(srcEntity?.type ?? "component", "component"),
       target_id: tgtId,
-      target_type: tgtEntity?.type ?? "component",
-      edge_type: rel.relationship
+      target_type: normalizeEntityType(tgtEntity?.type ?? "component", "component"),
+      edge_type: normalizeEdgeType(rel.relationship, "DEPENDS_ON")
     });
   }
   const constraints = [];
@@ -2033,10 +2071,10 @@ function buildGraph(sourceId, extracted, existing = []) {
       edges.push({
         id: `${sourceId}_nfr_edge_${i}_${slugify(targetName)}`,
         source_id: targetId,
-        source_type: targetEntity?.type ?? "component",
+        source_type: normalizeEntityType(targetEntity?.type ?? "component", "component"),
         target_id: constraintId,
         target_type: "constraint",
-        edge_type: nfr.relationship
+        edge_type: normalizeEdgeType(nfr.relationship, "BOUNDED_BY")
       });
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kylewadegrove/cutline-mcp-cli-staging",
-    "version": "0.6.0",
+    "version": "0.7.0",
     "description": "CLI and MCP servers for Cutline — authenticate, then run constraint-aware MCP servers in Cursor or any MCP client.",
     "type": "module",
     "main": "dist/index.js",