gasp-standard-mcp 1.4.0 → 1.5.0

package/README.md

@@ -46,11 +46,13 @@ Restart your MCP client after adding the config.
 
 - 300 metrics across 13 departments
 - 80 glossary definitions
-- 76 relationship nodes (60 metrics + 11 entities + 5 concepts), 149 edges
+- 76 relationship nodes (60 metrics + 11 entities + 5 concepts), 157 edges
 - 15 entity-to-entity business model edges (OWNS, GRANTS, CONVERTS_TO, GENERATES, etc.)
 - 78 data requirements with field types, grain, and example SQL
-- 11 business entities, 5 business concepts, 22 source categories, 197 canonical fields
+- 11 business entities, 5 business concepts, 22 source categories, 198 canonical fields
+- 60 structured formulas with decomposed inputs (metric refs + field refs)
 - 60 temporal mappings (grain, frequency, period for every metric node)
+- CEL `change_nature` field for revenue quality analysis (Adjusted NRR/GRR)
 - Sources: the canonical [GASP Standard](https://gaspwiki.com) files
 
 ## Examples

package/build/index.js

@@ -148,6 +148,16 @@ server.tool("lookup_metric", "Look up a GASP Standard metric by name or abbrevia
     if (metric.dualLensNote) {
         parts.push(`\n## Dual-Lens Note\n\n${metric.dualLensNote}`);
     }
+    // Adjusted variant from structured formulas (e.g. NRR, GRR)
+    const sfMap = data.ontology?.structuredFormulas;
+    if (sfMap) {
+        const nodeId = metric.slug.replace(/-/g, '_');
+        const sf = sfMap[nodeId]
+            || Object.entries(sfMap).find(([k]) => k !== 'description' && nodeId.startsWith(k + '_'))?.[1];
+        if (sf && typeof sf === 'object' && 'adjustedVariant' in sf) {
+            parts.push(`\n## Adjusted Variant\n\n${sf.adjustedVariant}`);
+        }
+    }
     // Swap EOM → GASP branding
     const text = parts.join("\n").replace(/\bEOM Standard\b/g, "GASP Standard");
     return { content: [{ type: "text", text }] };
@@ -240,6 +250,35 @@ server.tool("get_formula", "Get the formula(s) for a GASP Standard metric. Retur
         }
         parts.push("```\n" + metric.formulas[i] + "\n```\n");
     }
+    // Append structured formula references if available
+    const formulas = data.ontology?.structuredFormulas;
+    const nodeId = metric.slug.replace(/-/g, '_');
+    // Match: exact node ID, or slug starts with a formula key (e.g. "arr_annual_recurring_revenue" starts with "arr")
+    let structured = formulas?.[nodeId];
+    if (!structured && formulas) {
+        for (const [key, val] of Object.entries(formulas)) {
+            if (key !== 'description' && nodeId.startsWith(key + '_')) {
+                structured = val;
+                break;
+            }
+        }
+    }
+    if (structured) {
+        if (structured.inputs && structured.inputs.length > 0) {
+            parts.push("## Inputs (metric dependencies)");
+            for (const input of structured.inputs) {
+                const inputNode = data.nodes.find(n => n.id === input.ref);
+                const label = inputNode?.label || input.ref;
+                parts.push(`- **${label}** (${input.role})`);
+            }
+            parts.push("");
+        }
+        if (structured.fields && structured.fields.length > 0) {
+            parts.push("## Required fields");
+            parts.push(structured.fields.map(f => `\`${f}\``).join(", "));
+            parts.push("");
+        }
+    }
     const text = parts.join("\n").replace(/\bEOM Standard\b/g, "GASP Standard");
     return { content: [{ type: "text", text }] };
 });

package/build/loader.js

@@ -117,6 +117,7 @@ export function loadStandard() {
             entityMappings: ontRaw.entityMappings || {},
             concepts: ontRaw.concepts || [],
             entityRelationships: ontRaw.entityRelationships || undefined,
+            structuredFormulas: ontRaw.structuredFormulas || undefined,
         };
     }
     catch {