gasp-standard-mcp 1.2.1 → 1.3.1

package/README.md

@@ -1,6 +1,6 @@
 # gasp-standard-mcp
 
-MCP server for the [GASP Standard](https://gaspwiki.com) — the Generally Accepted SaaS Performance standard for metric definitions, formulas, benchmarks, and relationships.
+MCP server for the [GASP Standard](https://gaspwiki.com) — the Generally Accepted SaaS Principles standard for metric definitions, formulas, benchmarks, and relationships.
 
 Works with Claude Code, Claude Desktop, or any [MCP](https://modelcontextprotocol.io/)-compatible client.
 
@@ -42,10 +42,10 @@ Restart your MCP client after adding the config.
 
 ## Data
 
-- 299 metrics across 13 departments
-- 79 glossary definitions
+- 300 metrics across 13 departments
+- 80 glossary definitions
 - 22 relationship nodes, 34 edges
-- 75 data requirements with field types, grain, and example SQL
+- 78 data requirements with field types, grain, and example SQL
 - Sources: the canonical [GASP Standard](https://gaspwiki.com) files
 
 ## Examples

package/build/index.js

@@ -94,6 +94,41 @@ server.tool("lookup_metric", "Look up a GASP Standard metric by name or abbrevia
     if (metric.aliases.length > 0) {
         parts.push(`\n**Aliases:** ${metric.aliases.join(", ")}`);
     }
+    // Dual-lens content
+    if (metric.dualLens) {
+        const dl = metric.dualLens;
+        parts.push("\n## Dual-Lens: Operating / Market Forms");
+        parts.push(`\n### Operating Form: ${dl.operating.label}`);
+        if (dl.operating.description)
+            parts.push(dl.operating.description);
+        if (dl.operating.celSource)
+            parts.push(`**CEL Source:** ${dl.operating.celSource}`);
+        if (dl.operating.atlInclusion)
+            parts.push(`**ATL Inclusion:** ${dl.operating.atlInclusion}`);
+        if (dl.operating.formula)
+            parts.push("```\n" + dl.operating.formula + "\n```");
+        if (dl.operating.insight)
+            parts.push(`**What it tells you:** ${dl.operating.insight}`);
+        parts.push(`\n### Market Form: ${dl.market.label}`);
+        if (dl.market.description)
+            parts.push(dl.market.description);
+        if (dl.market.celSource)
+            parts.push(`**CEL Source:** ${dl.market.celSource}`);
+        if (dl.market.atlInclusion)
+            parts.push(`**ATL Inclusion:** ${dl.market.atlInclusion}`);
+        if (dl.market.formula)
+            parts.push("```\n" + dl.market.formula + "\n```");
+        if (dl.market.insight)
+            parts.push(`**What it tells you:** ${dl.market.insight}`);
+        parts.push("\n### Bridge");
+        if (dl.bridge.reconciliation)
+            parts.push("**Reconciliation:**\n```\n" + dl.bridge.reconciliation + "\n```");
+        if (dl.bridge.diagnostic)
+            parts.push(`**Diagnostic:** ${dl.bridge.diagnostic}`);
+    }
+    if (metric.dualLensNote) {
+        parts.push(`\n## Dual-Lens Note\n\n${metric.dualLensNote}`);
+    }
     // Swap EOM → GASP branding
     const text = parts.join("\n").replace(/\bEOM Standard\b/g, "GASP Standard");
     return { content: [{ type: "text", text }] };

package/build/parser.js

@@ -132,6 +132,7 @@ function parseSectionFields(name, slug, raw, department, category, aliases) {
     const formulas = extractFormulas(raw);
     const commonMistakes = extractListField(raw, "Common mistakes");
     const sources = extractSources(raw);
+    const { dualLens, dualLensNote } = parseDualLens(raw);
     return {
         name,
         slug,
@@ -147,6 +148,8 @@ function parseSectionFields(name, slug, raw, department, category, aliases) {
         rawMarkdown: `### ${name}\n\n${raw}`,
         signalType: "operational",
         signalTypeSecondary: null,
+        dualLens,
+        dualLensNote,
     };
 }
 /** Extract a **FieldName:** value from markdown */
@@ -203,6 +206,112 @@ function extractSources(text) {
     }
     return sources;
 }
+/**
+ * Extract a field value from a dual-lens subsection.
+ * Terminates at next bold field (**X), code fence, or #### heading — not at \n\n.
+ */
+function extractSubsectionField(text, fieldName) {
+    const fence = "\\`\\`\\`";
+    const pattern = new RegExp("\\*\\*" + fieldName + ":\\*\\*\\s*([\\s\\S]*?)(?=\\n\\*\\*[A-Z]|\\n" + fence + "|\\n####|$)", "");
+    const match = text.match(pattern);
+    return match ? match[1].trim() : "";
+}
+/** Extract the first code block from text */
+function extractFirstCodeBlock(text) {
+    const fence = "```";
+    const regex = new RegExp(fence + "\\n?([\\s\\S]*?)" + fence);
+    const match = text.match(regex);
+    return match ? match[1].trim() : null;
+}
+/**
+ * Parse dual-lens content from a metric's raw markdown.
+ * Returns { dualLens, dualLensNote }.
+ *
+ * Pattern 1 — Standard O/M: #### Operating Form: ... / #### Market Form: ... / #### Bridge:
+ * Pattern 2 — Shared Churn:  #### Dual-Lens: ... with **Operating Form:** / **Market Form:** bold labels
+ * Pattern 3 — Note only:     #### Dual-Lens Note
+ */
+function parseDualLens(raw) {
+    // --- Pattern 3: Note only ---
+    const noteHeadingMatch = raw.match(/#### Dual-Lens Note\s*\n([\s\S]*?)(?=\n---|\n####|\n###|$)/);
+    if (noteHeadingMatch) {
+        const noteText = noteHeadingMatch[1].trim();
+        return { dualLens: null, dualLensNote: noteText || null };
+    }
+    // --- Pattern 1: Standard O/M ---
+    const opHeadingMatch = raw.match(/#### Operating Form:\s*(.+)/);
+    if (opHeadingMatch) {
+        // Split into Operating, Market, Bridge sections
+        const opStart = raw.indexOf(opHeadingMatch[0]);
+        const mktMatch = raw.match(/#### Market Form:\s*(.+)/);
+        const bridgeMatch = raw.match(/#### Bridge:/);
+        if (!mktMatch || !bridgeMatch) {
+            return { dualLens: null, dualLensNote: null };
+        }
+        const mktStart = raw.indexOf(mktMatch[0]);
+        const bridgeStart = raw.indexOf(bridgeMatch[0]);
+        const opSection = raw.substring(opStart + opHeadingMatch[0].length, mktStart).trim();
+        const mktSection = raw.substring(mktStart + mktMatch[0].length, bridgeStart).trim();
+        const bridgeSection = raw.substring(bridgeStart + bridgeMatch[0].length).trim();
+        const operating = parseStandardForm(opHeadingMatch[1].trim(), opSection);
+        const market = parseStandardForm(mktMatch[1].trim(), mktSection);
+        const bridge = parseBridgeSection(bridgeSection);
+        return { dualLens: { operating, market, bridge }, dualLensNote: null };
+    }
+    // --- Pattern 2: Shared Churn ---
+    const dualLensHeadingMatch = raw.match(/#### Dual-Lens:/);
+    if (dualLensHeadingMatch) {
+        const dlStart = raw.indexOf(dualLensHeadingMatch[0]);
+        const dlSection = raw.substring(dlStart + dualLensHeadingMatch[0].length).trim();
+        // Split on bold Operating Form / Market Form / Bridge labels
+        const opBoldMatch = dlSection.match(/\*\*Operating Form:\s*([^*]+)\*\*/);
+        const mktBoldMatch = dlSection.match(/\*\*Market Form:\s*([^*]+)\*\*/);
+        const bridgeBoldMatch = dlSection.match(/\*\*Bridge:\*\*/);
+        if (!opBoldMatch || !mktBoldMatch || !bridgeBoldMatch) {
+            return { dualLens: null, dualLensNote: null };
+        }
+        const opBoldStart = dlSection.indexOf(opBoldMatch[0]);
+        const mktBoldStart = dlSection.indexOf(mktBoldMatch[0]);
+        const bridgeBoldStart = dlSection.indexOf(bridgeBoldMatch[0]);
+        const opText = dlSection.substring(opBoldStart + opBoldMatch[0].length, mktBoldStart).trim();
+        const mktText = dlSection.substring(mktBoldStart + mktBoldMatch[0].length, bridgeBoldStart).trim();
+        const bridgeText = dlSection.substring(bridgeBoldStart + bridgeBoldMatch[0].length).trim();
+        const operating = parseSharedForm(opBoldMatch[1].trim(), opText);
+        const market = parseSharedForm(mktBoldMatch[1].trim(), mktText);
+        const bridge = {
+            reconciliation: null,
+            diagnostic: bridgeText,
+        };
+        return { dualLens: { operating, market, bridge }, dualLensNote: null };
+    }
+    return { dualLens: null, dualLensNote: null };
+}
+/** Parse an Operating/Market form from a Standard O/M section (Pattern 1) */
+function parseStandardForm(label, section) {
+    // Description = text before the first **bold** field
+    const firstBoldIdx = section.search(/\*\*[A-Z]/);
+    const description = firstBoldIdx > 0 ? section.substring(0, firstBoldIdx).trim() : "";
+    const celSource = extractSubsectionField(section, "CEL Source");
+    const atlInclusion = extractSubsectionField(section, "ATL Inclusion(?:[^:]*)?");
+    const formula = extractFirstCodeBlock(section);
+    const insight = extractSubsectionField(section, "What it tells you");
+    return { label, description, celSource, atlInclusion, formula, insight };
+}
+/** Parse an Operating/Market form from a Shared Churn section (Pattern 2) */
+function parseSharedForm(label, section) {
+    // Description = text before the first **bold** field
+    const firstBoldIdx = section.search(/\*\*[A-Z]/);
+    const description = firstBoldIdx > 0 ? section.substring(0, firstBoldIdx).trim() : "";
+    const celSource = extractSubsectionField(section, "CEL Source");
+    const insight = extractSubsectionField(section, "What it tells you");
+    return { label, description, celSource, atlInclusion: "", formula: null, insight };
+}
+/** Parse a Bridge section */
+function parseBridgeSection(section) {
+    const reconciliation = extractFirstCodeBlock(section);
+    const diagnostic = extractSubsectionField(section, "Diagnostic");
+    return { reconciliation, diagnostic };
+}
 /**
  * Parse definitions.md into Definition objects.
  * Each ### heading is a term.