@unified-product-graph/cloud-server 0.9.10 → 0.9.11

package/dist/index.js

@@ -2387,7 +2387,20 @@ var getSpecVersion = () => {
         entity_count: UPG_ENTITY_COUNT,
         edge_count: UPG_EDGE_COUNT,
         domain_count: UPG_DOMAIN_COUNT,
-        region_count: UPG_REGION_COUNT
+        region_count: UPG_REGION_COUNT,
+        anti_patterns: {
+          total: UPG_ANTI_PATTERNS.length,
+          // Anti-patterns introduced in a tracked version (the `since` field
+          // landed in 0.9.11). Lets a consumer see which validators are newer
+          // than the version a graph was authored under, so a spec upgrade
+          // doesn't silently flip a clean graph invalid with no heads-up
+          // (batch-6 #36). Baseline patterns (no `since`) predate the tracking.
+          versioned: UPG_ANTI_PATTERNS.filter((p) => p.since).map((p) => ({
+            id: p.id,
+            severity: p.severity,
+            since: p.since
+          }))
+        }
       },
       null,
       2
@@ -2714,6 +2727,45 @@ var getLifecycle = (args) => {
   }
   return text(JSON.stringify(lifecycle, null, 2));
 };
+var listStatusValues = (args) => {
+  const entityType = args.entity_type;
+  if (!entityType) return textError("Missing required parameter: entity_type");
+  const lifecycle = UPG_LIFECYCLES.find((l) => l.entity_type === entityType);
+  if (!lifecycle) {
+    const free = UPG_LIFECYCLE_FREE_TYPES.has(entityType);
+    const planned = UPG_LIFECYCLE_PLANNED_TYPES.has(entityType);
+    return text(
+      JSON.stringify(
+        {
+          entity_type: entityType,
+          lifecycle_free: free,
+          values: [],
+          note: free ? `${entityType} is lifecycle-free: status is not state-machine-validated (a static type with no phase progression).` : planned ? `${entityType} has a lifecycle planned but not yet authored in this spec version.` : `No lifecycle defined for entity type: ${entityType}.`
+        },
+        null,
+        2
+      )
+    );
+  }
+  const terminal = new Set(lifecycle.terminal_phases);
+  return text(
+    JSON.stringify(
+      {
+        entity_type: entityType,
+        lifecycle_free: false,
+        initial_status: lifecycle.initial_phase,
+        terminal_statuses: lifecycle.terminal_phases,
+        values: lifecycle.phases.map((p) => ({
+          status: p.id,
+          label: p.label,
+          terminal: terminal.has(p.id)
+        }))
+      },
+      null,
+      2
+    )
+  );
+};
 var listScales = () => {
   const scales = Object.values(UPG_SCALES);
   return text(JSON.stringify({ scales, total: scales.length }, null, 2));
@@ -4722,6 +4774,17 @@ var TOOL_DEFINITIONS = [
       required: ["entity_type"]
     }
   },
+  {
+    name: "list_status_values",
+    description: "List the valid `status` values an entity type can hold: the pre-flight lookup so you no longer learn the set only from a rejected write. For a lifecycle type, returns each phase as `{ status, label, terminal }` plus `initial_status` and `terminal_statuses`; for a lifecycle-free type, returns `lifecycle_free: true` with empty `values`. The focused, low-token sibling of `get_lifecycle`.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        entity_type: { type: "string", description: 'Canonical entity type name (e.g. "feature", "key_result", "need").' }
+      },
+      required: ["entity_type"]
+    }
+  },
   {
     name: "list_scales",
     description: "List every spec-defined assessment scale from UPG_SCALES: the canonical vocabulary for UPGAssessment values. Each scale carries id, label, description, min, max, steps, and per-point labels plus descriptions. Non-paginated. External scale_extensions are graph-instance\u2013scoped and stay out of this surface.",
@@ -5228,6 +5291,7 @@ var HANDLERS = {
   list_split_migrations: listSplitMigrations,
   list_lifecycles: listLifecycles,
   get_lifecycle: getLifecycle,
+  list_status_values: listStatusValues,
   list_scales: listScales,
   get_scale: getScale,
   list_framework_categories: listFrameworkCategories,