gasp-standard-mcp 1.4.0 → 1.6.0

package/README.md

@@ -45,12 +45,15 @@ Restart your MCP client after adding the config.
 ## Data
 
 - 300 metrics across 13 departments
-- 80 glossary definitions
-- 76 relationship nodes (60 metrics + 11 entities + 5 concepts), 149 edges
+- 92 glossary definitions (80 SaaS domain + 12 GASP framework)
+- 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)
+- Access control classifications for every graph metric (sensitivity tier + access scope)
+- CEL `change_nature` field for revenue quality analysis (Adjusted NRR/GRR)
 - Sources: the canonical [GASP Standard](https://gaspwiki.com) files
 
 ## Examples
@@ -61,6 +64,8 @@ Once installed, ask your AI assistant:
 - "How do I calculate CAC Payback?"
 - "What drives ARR?"
 - "How does Customer relate to Subscription?"
+- "What sensitivity tier is CAC classified as?"
+- "What does confidential mean in GASP?"
 - "List all marketing metrics"
 - "What data do I need to implement ARR tracking?"
 - "Search for churn"

package/build/index.js

@@ -148,6 +148,29 @@ 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}`);
+        }
+    }
+    // Access control classification (if available)
+    const acMap = data.ontology?.accessControl?.classifications;
+    if (acMap) {
+        const nodeId = metric.slug.replace(/-/g, '_');
+        const ac = acMap[nodeId]
+            || Object.entries(acMap).find(([k]) => nodeId.startsWith(k + '_'))?.[1];
+        if (ac) {
+            parts.push(`\n## Recommended Access Control\n` +
+                `- **Sensitivity:** ${ac.sensitivityTier} (https://gaspwiki.com/v1/definitions/sensitivity-tier)\n` +
+                `- **Scope:** ${ac.accessScope} (https://gaspwiki.com/v1/definitions/access-scope)\n` +
+                `See https://gaspwiki.com/v1/governance for policy patterns (Cedar, OPA, warehouse RLS).`);
+        }
+    }
     // Swap EOM → GASP branding
     const text = parts.join("\n").replace(/\bEOM Standard\b/g, "GASP Standard");
     return { content: [{ type: "text", text }] };
@@ -240,6 +263,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,8 @@ export function loadStandard() {
             entityMappings: ontRaw.entityMappings || {},
             concepts: ontRaw.concepts || [],
             entityRelationships: ontRaw.entityRelationships || undefined,
+            structuredFormulas: ontRaw.structuredFormulas || undefined,
+            accessControl: ontRaw.accessControl || undefined,
         };
     }
     catch {