Deploy Liftoscript MCP validator

- Minimal Lezer-based validator for Liftoscript
- Supports both planner and expression validation
- MCP server endpoint for Claude integration
- Includes JavaScript parsers and Gradio interface

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

README.md

@@ -1,12 +1,59 @@
 ---
-title: Liftosaur Mcp
-emoji: ⚡
+title: Liftoscript MCP Validator
+emoji: 💪
 colorFrom: blue
 colorTo: purple
 sdk: gradio
-sdk_version: 5.35.0
+sdk_version: 5.0.0
 app_file: app.py
 pinned: false
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Liftoscript MCP Validator
+
+A Model Context Protocol (MCP) server that validates [Liftoscript](https://www.liftosaur.com/docs/docs/liftoscript) workout programs.
+
+## Features
+
+- ✅ Validates both **Planner syntax** (Week/Day format) and **Liftoscript expressions**
+- 🚀 Lightweight Lezer-based parser
+- 🤖 MCP integration for Claude Desktop
+- 📍 Detailed error messages with line/column information
+
+## MCP Configuration
+
+Add this to your Claude Desktop config:
+
+```json
+{
+  "mcpServers": {
+    "liftoscript": {
+      "command": "npx",
+      "args": ["mcp-remote", "https://davanstrien-liftosaur-mcp.hf.space/gradio_api/mcp/sse"]
+    }
+  }
+}
+```
+
+## Example Usage
+
+### Planner Format
+```
+# Week 1
+## Day 1
+Squat / 3x5 / progress: lp(5lb)
+Bench Press / 3x8
+```
+
+### Liftoscript Expression
+```javascript
+if (completedReps >= reps) {
+  state.weight += 5lb
+}
+```
+
+## Resources
+
+- [Liftoscript Documentation](https://www.liftosaur.com/docs/docs/liftoscript)
+- [Liftosaur App](https://www.liftosaur.com/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)

app.py

@@ -0,0 +1,301 @@
+import gradio as gr
+import subprocess
+import json
+import os
+from typing import Dict, Any
+
+def setup_parser():
+    """Setup the minimal parser - just needs npm install."""
+    try:
+        # Check if Node.js is available
+        result = subprocess.run(['node', '--version'], capture_output=True, text=True)
+        if result.returncode != 0:
+            return False, "Node.js not found. Please ensure Node.js is installed."
+        
+        # Check if dependencies are installed
+        if not os.path.exists('node_modules/@lezer/lr'):
+            print("Installing dependencies...")
+            install_result = subprocess.run(
+                ['npm', 'install'],
+                capture_output=True,
+                text=True,
+                timeout=60
+            )
+            if install_result.returncode != 0:
+                return False, f"Failed to install dependencies: {install_result.stderr}"
+        
+        # Check if parser files exist
+        required_files = ['minimal-validator.js', 'liftoscript-parser.js', 'planner-parser.js']
+        missing_files = [f for f in required_files if not os.path.exists(f)]
+        
+        if missing_files:
+            return False, f"Missing required files: {', '.join(missing_files)}"
+        
+        # Test the validator
+        test_result = subprocess.run(
+            ['node', 'minimal-validator.js', 'state.weight = 100lb', '--json'],
+            capture_output=True,
+            text=True,
+            timeout=5
+        )
+        
+        if test_result.returncode != 0:
+            return False, "Validator test failed"
+        
+        return True, "Parser ready (minimal Lezer-based validator)"
+        
+    except Exception as e:
+        return False, f"Setup error: {str(e)}"
+
+def validate_liftoscript(script: str) -> Dict[str, Any]:
+    """
+    Validate a Liftoscript program using the minimal Lezer-based parser.
+    
+    This tool validates Liftoscript workout programs and returns detailed error information
+    if the syntax is invalid. It supports both planner format (Week/Day/Exercise) and 
+    pure Liftoscript expressions.
+    
+    Args:
+        script: The Liftoscript code to validate (either planner format or expression)
+        
+    Returns:
+        Validation result dictionary with keys:
+        - valid (bool): Whether the script is syntactically valid
+        - error (str|None): Error message if invalid
+        - line (int|None): Line number of error
+        - column (int|None): Column number of error
+        - type (str|None): Detected script type ('planner' or 'liftoscript')
+    """
+    if not script or not script.strip():
+        return {
+            "valid": False,
+            "error": "Empty script provided",
+            "line": None,
+            "column": None,
+            "type": None
+        }
+    
+    try:
+        # Use the minimal parser wrapper
+        wrapper = 'parser-wrapper-minimal.js' if os.path.exists('parser-wrapper-minimal.js') else 'minimal-validator.js'
+        
+        # Call the validator
+        result = subprocess.run(
+            ['node', wrapper, '-'] if wrapper == 'parser-wrapper-minimal.js' else ['node', wrapper, '-', '--json'],
+            input=script,
+            capture_output=True,
+            text=True,
+            timeout=10
+        )
+        
+        if result.returncode != 0 and not result.stdout:
+            return {
+                "valid": False,
+                "error": f"Validator error: {result.stderr}",
+                "line": None,
+                "column": None,
+                "type": None
+            }
+        
+        # Parse JSON response
+        try:
+            validation_result = json.loads(result.stdout)
+            
+            # Handle both formats (wrapper and direct)
+            if 'errors' in validation_result:
+                # Wrapper format
+                if validation_result.get('errors') and len(validation_result['errors']) > 0:
+                    first_error = validation_result['errors'][0]
+                    return {
+                        "valid": False,
+                        "error": first_error.get('message', 'Unknown error'),
+                        "line": first_error.get('line'),
+                        "column": first_error.get('column'),
+                        "type": validation_result.get('type')
+                    }
+                else:
+                    return {
+                        "valid": True,
+                        "error": None,
+                        "line": None,
+                        "column": None,
+                        "type": validation_result.get('type', 'unknown')
+                    }
+            else:
+                # Direct format
+                if validation_result.get('valid'):
+                    return {
+                        "valid": True,
+                        "error": None,
+                        "line": None,
+                        "column": None,
+                        "type": validation_result.get('type', 'unknown')
+                    }
+                else:
+                    error = validation_result.get('error', {})
+                    return {
+                        "valid": False,
+                        "error": error.get('message', 'Unknown error'),
+                        "line": error.get('line'),
+                        "column": error.get('column'),
+                        "type": error.get('type')
+                    }
+            
+        except json.JSONDecodeError:
+            return {
+                "valid": False,
+                "error": "Invalid parser response",
+                "line": None,
+                "column": None,
+                "type": None
+            }
+            
+    except subprocess.TimeoutExpired:
+        return {
+            "valid": False,
+            "error": "Parser timeout - script too complex",
+            "line": None,
+            "column": None,
+            "type": None
+        }
+    except Exception as e:
+        return {
+            "valid": False,
+            "error": f"Validation error: {str(e)}",
+            "line": None,
+            "column": None,
+            "type": None
+        }
+
+# Create Gradio interface
+with gr.Blocks(title="Liftoscript Validator MCP Server") as app:
+    gr.Markdown("""
+    # 💪 Liftoscript Validator MCP Server
+    
+    This tool validates [Liftoscript](https://www.liftosaur.com/docs/docs/liftoscript) workout programs using a **minimal Lezer-based parser** extracted from the Liftosaur repository.
+    
+    ## 🚀 Lightweight Implementation
+    
+    This proof-of-concept uses only:
+    - The compiled Lezer parsers (no grammar compilation needed)
+    - Basic syntax validation (no semantic analysis)
+    - Zero dependencies on the full Liftosaur codebase
+    
+    ## ✅ Features:
+    - Validates both **Planner syntax** (Week/Day format) and **Liftoscript expressions**
+    - Automatic detection of script type
+    - Detailed error messages with line/column information
+    - Lightweight and fast (no heavy builds required)
+    
+    ## 📦 MCP Server Configuration
+    
+    Add to your `claude_desktop_config.json`:
+    ```json
+    {
+      "mcpServers": {
+        "liftoscript": {
+          "command": "npx",
+          "args": ["mcp-remote", "https://davanstrien-liftosaur-mcp.hf.space/gradio_api/mcp/sse"]
+        }
+      }
+    }
+    ```
+    """)
+    
+    # Check parser setup
+    parser_ready, setup_message = setup_parser()
+    
+    with gr.Row():
+        with gr.Column():
+            if parser_ready:
+                gr.Markdown(f"**✅ Parser Status**: {setup_message}")
+            else:
+                gr.Markdown(f"**⚠️ Parser Status**: {setup_message}")
+    
+    with gr.Row():
+        with gr.Column():
+            script_input = gr.Textbox(
+                label="Liftoscript Code",
+                placeholder="""Enter either Planner format:
+
+# Week 1
+## Day 1
+Squat / 3x5 / progress: lp(5lb)
+Bench Press / 3x8 @8
+
+Or pure Liftoscript expressions:
+
+if (completedReps >= reps) {
+  state.weight = state.weight + 5lb
+}""",
+                lines=15
+            )
+            validate_btn = gr.Button("Validate", variant="primary", interactive=parser_ready)
+        
+        with gr.Column():
+            validation_output = gr.JSON(label="Validation Result")
+            
+            gr.Markdown("""
+            ### 📝 Example Scripts
+            
+            Click any example below to test:
+            """)
+            
+            gr.Examples(
+                examples=[
+                    # Planner examples
+                    ["# Week 1\n## Day 1\nSquat / 3x5 / progress: lp(5lb)\nBench Press / 3x8"],
+                    ["Deadlift / 1x5 / warmup: 1x5 135lb, 1x3 225lb, 1x1 315lb"],
+                    ["Bench Press / 3x8-12 @8 / progress: dp"],
+                    
+                    # Liftoscript examples
+                    ["state.weight = 100lb"],
+                    ["if (completedReps >= reps) { state.weight += 5lb }"],
+                    ["for (r in completedReps) {\n  if (r < reps[index]) {\n    state.weight -= 5%\n  }\n}"],
+                    
+                    # Invalid examples (for testing)
+                    ["// Missing closing brace\nif (true) { state.weight = 100lb"],
+                    ["// Invalid format\nSquat 3x5"],
+                ],
+                inputs=script_input,
+                label="Example Scripts"
+            )
+    
+    validate_btn.click(
+        fn=validate_liftoscript,
+        inputs=script_input,
+        outputs=validation_output
+    )
+    
+    gr.Markdown("""
+    ---
+    
+    ## 🎯 Value Proposition
+    
+    This minimal validator demonstrates that:
+    1. **Syntax validation** can be separated from full program evaluation
+    2. The Lezer parsers can be used **independently** 
+    3. A standalone parser package would enable many tools and integrations
+    
+    ## 🤝 For Liftosaur Maintainers
+    
+    This PoC shows demand for a standalone parser package. Benefits:
+    - Enable third-party tools (editors, linters, formatters)
+    - Support AI assistants like Claude via MCP
+    - Grow the Liftoscript ecosystem
+    - Minimal maintenance burden (just the parser, not the full runtime)
+    
+    ## 📚 Resources
+    - [Liftoscript Documentation](https://www.liftosaur.com/docs/docs/liftoscript)
+    - [Liftosaur App](https://www.liftosaur.com/)
+    - [GitHub Repository](https://github.com/astashov/liftosaur)
+    - [Model Context Protocol](https://modelcontextprotocol.io/)
+    """)
+
+# Launch with MCP server enabled
+if __name__ == "__main__":
+    app.launch(
+        mcp_server=True,
+        server_name="0.0.0.0",
+        share=False
+    )

liftoscript-parser.js

@@ -0,0 +1,27 @@
+// Liftoscript parser - compiled from Lezer grammar
+// This is a standalone version extracted from Liftosaur
+const { LRParser } = require("@lezer/lr");
+
+const spec_Keyword = { __proto__: null, if: 100, else: 102, for: 104 };
+const parser = LRParser.deserialize({
+  version: 14,
+  states:
+    ",fQcQPOOO!iQPO'#C}OOQO'#Cd'#CdO#cQPO'#CdO${QPO'#DXOcQPO'#CiO%SQPO'#CjO%ZQPO'#ClO%`QPO'#CnO%eQQO'#CrO%mQPO'#CuO'ZQPO'#DXOcQPO'#C{OOQO'#DX'#DXQcQPOOOcQPO,58yOcQPO,58yOcQPO,58yOcQPO,58yOcQPO,59VOOQO,59O,59OOOQO,59Q,59QO'eQPO,59TOOQO,59U,59UO'lQPO,59UO'sQPO,59WO'xQPO,59YO'}QPO,59^OcQPO,59^O(SQSO,59aO(ZQPO,59fOcQPO,59]OcQPO,59dOOQO,59g,59gOOQO-E6{-E6{O)uQPO1G.eOOQO1G.e1G.eO)|QPO1G.eO*TQPO1G.eO+hQPO1G.qOOQO1G.o1G.oOOQO1G.p1G.pO+oQPO1G.rO-VQQO1G.tOOQO1G.x1G.xO-[QPO'#CtO-cQPO1G.xO-hQPO'#CvOOQO'#Cw'#CwOOQO'#Cv'#CvO-rQPO1G.{O-zQPO1G/QOcQPO'#DQO.UQPO1G/QOOQO1G/Q1G/QO.^QPO1G.wO/dQPO1G/OOcQPO7+$]O0jQPO7+$^O0rQPO7+$^OcQPO7+$`O2YQQO7+$dO(SQSO'#DPO2_QPO7+$gOOQO7+$g7+$gO2gQPO7+$lOOQO7+$l7+$lO2oQPO,59lOOQO-E7O-E7OO2yQPO<<GwO%ZQPO,59jOOQO<<Gx<<GxO0jQPO<<GxOOQO-E6|-E6|O4PQPO'#CpO4WQPO<<GzO4]QPO<<HOOOQO,59k,59kOOQO-E6}-E6}OOQO<<HR<<HROOQO<<HW<<HWO'sQPO1G/UOOQOAN=dAN=dP0mQPO'#DOO'sQPOAN=fOOQOAN=jAN=jOOQO7+$p7+$pOOQOG23QG23Q",
+  stateData:
+    "4m~OwOSPOSxOSyOSzOS~OSROXQO[]OaYOcZOgXOp[O|TO!OUO!SVO!UWO~OS_OT`OUaOVbO!QcO~OXqX[qXaqXcqXgqXpqXuqX|qX!OqX!SqX!UqX!PqX~P!WOXdO~OS{XT{XU{XV{XX{X[{Xa{Xc{Xg{Xp{Xu{X|{X!O{X!Q{X!S{X!U{X}{X!P{X!R{X!X{X!]{X~OZeO~P#hO!PgO~PcO|TO~O|jO~O!WlO!YkO~O|nO!WmOSiXTiXUiXViXXiX[iXaiXciXgiXmiXpiXuiX!OiX!QiX!SiX!UiX![iX}iX!PiX!RiX!XiX!]iX~OmpO![oO~P#hO}xO~P!WO!PyO~PcO!OUO~Oc{O~Oa|O~O!Z!QO~PcO}!WO!]!UO~PcOT`OURiVRiXRi[RiaRicRigRipRiuRi|Ri!ORi!QRi!SRi!URi}Ri!PRi!RRi!XRi!]Ri~OSRi~P(eOS_O~P(eOS_OT`OUaOVRiXRi[RiaRicRigRipRiuRi|Ri!ORi!QRi!SRi!URi}Ri!PRi!RRi!XRi!]Ri~O!R!ZO~P!WO!T![OS`iT`iU`iV`iX`i[`ia`ic`ig`ip`iu`i|`i!O`i!Q`i!S`i!U`i}`i!P`i!R`i!X`i!]`i~O!V!^O~O!XhX~P!WO!X!_O~O!RjX!XjX~P!WO!R!`O!X!bO~O}!dO!]!UO~P!WO}!dO!]!UO~OXei[eiaeiceigeipeiuei|ei!Oei!Sei!Uei}ei!Pei!Rei!Xei!]ei~P!WOXli[lialicliglipliuli|li!Oli!Sli!Uli}li!Pli!Rli!Xli!]li~P!WO!OUO!S!hO~O!T!jOS`qT`qU`qV`qX`q[`qa`qc`qg`qp`qu`q|`q!O`q!Q`q!S`q!U`q}`q!P`q!R`q!X`q!]`q~O!Y!nO~O!R!`O!X!qO~O}!rO!]!UO~O}ta!]ta~P!WOX_y[_ya_yc_yg_yp_yu_y|_y!O_y!S_y!U_y}_y!P_y!R_y!X_y!]_y~P!WO}dX~P!WO}!vO~Oa!wO~OPTg[XScZaZ~",
+  goto:
+    "'O|PPP}PPPP!eP}PP!{#i}}P}P$`}$cP$y$c$|%S}P}}P%W%b%h%nPPPPPP%xy]OTU[^_`abchlmnop!U!Z!^!`ySOTU[^_`abchlmnop!U!Z!^!`x]OTU[^_`abchlmnop!U!Z!^!`QiVR!s!hx]OTU[^_`abchlmnop!U!Z!^!`QziQ!i![Q!t!jQ!x!sR!y!vR!m!^yZOTU[^_`abchlmnop!U!Z!^!`R!OlQ!SmR!o!`T!Rm!`Q^OQhUTr^hQ!]zR!k!]Q!a!SR!p!aQ!VnQ!c!TT!f!V!cWPOU^hQfTQq[Qs_Qt`QuaQvbQwcQ}lS!Pm!`Q!TnQ!XoQ!YpQ!e!UQ!g!ZR!l!^",
+  nodeNames:
+    "⚠ LineComment Program BinaryExpression Plus Times Cmp AndOr NumberExpression Number WeightExpression Unit Percentage ParenthesisExpression BlockExpression Ternary IfExpression Keyword ForExpression Variable ForInExpression AssignmentExpression StateVariable StateKeyword StateVariableIndex VariableExpression VariableIndex Wildcard IncAssignmentExpression IncAssignment BuiltinFunctionExpression UnaryExpression Not",
+  maxTerm: 59,
+  skippedNodes: [0, 1],
+  repeatNodeCount: 4,
+  tokenData:
+    "1S~R}X^$Opq$Oqr$suv%Qvw%Vxy%byz%gz{%l{|%{|}&T}!O%{!O!P&Y!P!Q&r!Q!['f![!](e!]!^(j!^!_(o!_!`(w!`!a(o!a!b)P!c!})U!}#O)g#P#Q)l#T#])U#]#^)q#^#_)U#_#`*m#`#a+i#a#g)U#g#h,Q#h#j)U#j#k.b#k#o)U#o#p0_#p#q0l#q#r0r#r#s0w#y#z$O$f$g$O#BY#BZ$O$IS$I_$O$I|$JO$O$JT$JU$O$KV$KW$O&FU&FV$O~$TYw~X^$Opq$O#y#z$O$f$g$O#BY#BZ$O$IS$I_$O$I|$JO$O$JT$JU$O$KV$KW$O&FU&FV$O~$xPp~!_!`${~%QOU~P%VOTP~%YPvw%]~%bOV~~%gO|~~%lO}~T%sP!ZSTP!_!`%vP%{OmP~&QPS~!_!`%v~&YO!]~V&_P!YQ!Q![&bT&gQXTuv&m!Q![&bT&rO[T~&wQTP!P!Q&}!_!`%v~'SSP~OY&}Z;'S&};'S;=`'`<%lO&}~'cP;=`<%l&}T'kRXTuv&m!O!P't!Q!['fT'yQXTuv&m!Q![(PT(URXTuv&m!O!P(_!Q![(PT(bP!Q![(P~(jO!R~~(oOx~~(tPU~!_!`${~(|P![~!_!`${~)UO!Q~T)ZSaT!Q![)U!c!})U#R#S)U#T#o)U~)lO!W~~)qO!X~V)vUaT!Q![)U!c!})U#R#S)U#T#b)U#b#c*Y#c#o)UV*aS!VQaT!Q![)U!c!})U#R#S)U#T#o)U~*rUaT!Q![)U!c!})U#R#S)U#T#Z)U#Z#[+U#[#o)U~+]SZ~aT!Q![)U!c!})U#R#S)U#T#o)U~+nUaT!Q![)U!c!})U#R#S)U#T#U)U#U#V+U#V#o)U~,VUaT!Q![)U!c!})U#R#S)U#T#h)U#h#i,i#i#o)U~,nTaT!Q![)U!c!})U#R#S)U#T#U,}#U#o)U~-SUaT!Q![)U!c!})U#R#S)U#T#h)U#h#i-f#i#o)U~-kUaT!Q![)U!c!})U#R#S)U#T#X)U#X#Y-}#Y#o)U~.USg~aT!Q![)U!c!})U#R#S)U#T#o)U~.gTaT!Q![)U!c!})U#R#S)U#T#U.v#U#o)U~.{UaT!Q![)U!c!})U#R#S)U#T#f)U#f#g/_#g#o)U~/dTaT!O!P/s!Q![)U!c!})U#R#S)U#T#o)U~/vQ!c!}/|#T#o/|~0RSc~!Q![/|!c!}/|#R#S/|#T#o/|~0dP!O~#r#s0g~0lOy~~0oP#p#q%]~0wO!P~~0zP#q#r0}~1SOz~",
+  tokenizers: [0, 1, 2],
+  topRules: { Program: [0, 2] },
+  specialized: [{ term: 17, get: (value) => spec_Keyword[value] || -1 }],
+  tokenPrec: 892,
+});
+
+module.exports = { parser };

minimal-validator.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+
+// Minimal Liftoscript validator using Lezer parsers
+// No dependencies on the full Liftosaur codebase
+
+const { parser: liftoscriptParser } = require('./liftoscript-parser.js');
+const { parser: plannerParser } = require('./planner-parser.js');
+
+function getLineAndColumn(text, position) {
+  const lines = text.split('\n');
+  let currentPos = 0;
+  
+  for (let i = 0; i < lines.length; i++) {
+    const lineLength = lines[i].length + 1; // +1 for newline
+    if (position < currentPos + lineLength) {
+      return {
+        line: i + 1,
+        column: position - currentPos + 1
+      };
+    }
+    currentPos += lineLength;
+  }
+  
+  return { line: lines.length, column: 1 };
+}
+
+function detectScriptType(script) {
+  // Detect if this is planner syntax or pure Liftoscript
+  const plannerIndicators = [
+    /^#\s+Week/m,
+    /^##\s+Day/m,
+    /^\s*\w+\s*\/\s*\d+x\d+/m,  // Exercise format like "Squat / 3x5"
+    /\/\s*progress:/,
+    /\/\s*warmup:/,
+    /\/\s*update:/
+  ];
+  
+  return plannerIndicators.some(regex => regex.test(script)) ? 'planner' : 'liftoscript';
+}
+
+function validateLiftoscript(script) {
+  try {
+    const scriptType = detectScriptType(script);
+    let tree;
+    
+    if (scriptType === 'planner') {
+      // Parse with planner parser
+      tree = plannerParser.parse(script);
+    } else {
+      // Parse as pure Liftoscript
+      tree = liftoscriptParser.parse(script);
+    }
+    
+    // Check for error nodes
+    let hasError = false;
+    let errorNode = null;
+    let errorType = null;
+    
+    tree.iterate({
+      enter: (node) => {
+        if (node.type.isError) {
+          hasError = true;
+          errorNode = node;
+          errorType = node.type.name;
+          return false; // Stop iteration
+        }
+      }
+    });
+    
+    if (hasError && errorNode) {
+      const { line, column } = getLineAndColumn(script, errorNode.from);
+      
+      // Try to provide more helpful error messages
+      let message = `Syntax error`;
+      const problemText = script.substring(errorNode.from, Math.min(errorNode.to, errorNode.from + 20));
+      
+      if (scriptType === 'planner') {
+        if (problemText.includes('/')) {
+          message = "Invalid exercise format. Expected: 'Exercise / Sets x Reps'";
+        } else if (problemText.includes(':')) {
+          message = "Invalid property format. Expected: 'property: value' or 'property: function(args)'";
+        }
+      } else {
+        if (problemText.includes('=')) {
+          message = "Invalid assignment. Check variable names and syntax";
+        } else if (problemText.includes('{') || problemText.includes('}')) {
+          message = "Unmatched braces";
+        }
+      }
+      
+      return {
+        valid: false,
+        error: {
+          message: `${message} at "${problemText.trim()}"`,
+          line: line,
+          column: column,
+          type: scriptType
+        }
+      };
+    }
+    
+    // No syntax errors found
+    return {
+      valid: true,
+      error: null,
+      type: scriptType
+    };
+  } catch (e) {
+    return {
+      valid: false,
+      error: {
+        message: `Parser error: ${e.message}`,
+        line: 0,
+        column: 0
+      }
+    };
+  }
+}
+
+// Export for use
+module.exports = { validateLiftoscript };
+
+// CLI interface
+if (require.main === module) {
+  const fs = require('fs');
+  const args = process.argv.slice(2);
+  
+  if (args.length === 0) {
+    console.log('Liftoscript Validator');
+    console.log('Usage: node minimal-validator.js <script or -> [--json]');
+    console.log('\nExamples:');
+    console.log('  node minimal-validator.js "state.weight = 100lb"');
+    console.log('  node minimal-validator.js - < program.liftoscript');
+    console.log('  echo "Squat / 3x5" | node minimal-validator.js - --json');
+    process.exit(0);
+  }
+  
+  let script;
+  const jsonOutput = args.includes('--json');
+  
+  if (args[0] === '-') {
+    // Read from stdin
+    script = fs.readFileSync(0, 'utf-8');
+  } else {
+    script = args[0];
+  }
+  
+  const result = validateLiftoscript(script);
+  
+  if (jsonOutput) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    if (result.valid) {
+      console.log(`✅ Valid ${result.type} syntax`);
+    } else {
+      console.error(`❌ Invalid syntax (${result.error.type || 'unknown'} mode)`);
+      console.error(`   Line ${result.error.line}, Column ${result.error.column}: ${result.error.message}`);
+      process.exit(1);
+    }
+  }
+}

package.json

@@ -0,0 +1,16 @@
+{
+  "name": "liftoscript-mcp-validator",
+  "version": "1.0.0",
+  "description": "Minimal Liftoscript validator for MCP server",
+  "main": "minimal-validator.js",
+  "scripts": {
+    "test": "node test-validator.js"
+  },
+  "dependencies": {
+    "@lezer/lr": "^1.3.14"
+  },
+  "devDependencies": {},
+  "keywords": ["liftoscript", "validator", "mcp"],
+  "author": "",
+  "license": "MIT"
+}

packages.txt

@@ -0,0 +1,3 @@
+nodejs
+npm
+git

planner-parser.js

@@ -0,0 +1,27 @@
+// Planner parser - compiled from Lezer grammar
+// This parses the Week/Day/Exercise format
+const { LRParser } = require("@lezer/lr");
+
+const spec_Keyword = { __proto__: null, none: 148 };
+const parser = LRParser.deserialize({
+  version: 14,
+  states:
+    "2SQVQPOOOOQO'#D`'#D`OkQQO'#CcO|QQO'#CbOOQO'#D^'#D^OOQO'#Dk'#DkOOQO'#D_'#D_QVQPOOOOQO-E7^-E7^O!XQSO'#CeO!oQSO'#DbO#SQQO,58|OOQO,58|,58|O#SQQO,58|OOQO-E7]-E7]OOQO'#Cf'#CfO#[QSO,59PO#_QSO,59PO#gQWO'#CfOOQO'#Cl'#ClO#rQSO'#CwO#}QPO'#C{O$SQSO'#CkOOQO'#DR'#DRO$XQWO'#DUO$aQSO'#DVO%RQSO'#DWO#}QPO'#DXOOQO'#Df'#DfO%sQSO'#DSO&TQSO'#DQO!^QSO'#DQO&cQQO'#DYO&qQQO'#CjOOQO,59|,59|OOQO-E7`-E7`OOQO1G.h1G.hO&|QQO1G.hO!XQSO,59SO!XQSO'#DaO'UQSO1G.kOOQO1G.k1G.kOOQO,59o,59oOOQO'#Cs'#CsO'^QSO,59cOOQO,59c,59cOOQO,59g,59gO(RQSO,59VO!XQSO,59pO(dQWO,59pOOQO,59q,59qOOQO,59r,59rO(iQPO,59sOOQO-E7d-E7dO!^QSO'#DgO(qQSO,59lO(qQSO,59lO)PQWO'#DZOOQO,59t,59tO)XQPO,59UOOQO7+$S7+$SOOQO1G.n1G.nO)^QSO,59{OOQO,59{,59{OOQO-E7_-E7_OOQO7+$V7+$VOOQO1G.}1G.}OOQO'#Co'#CoO)iQQO'#CnO)}QWO'#DOOOQO'#Dd'#DdO*iQSO'#C}O+QQSO'#C|OOQO'#DP'#DPOOQO1G.q1G.qO,QQSO1G/[O+`QSO1G/[O!XQSO1G/[OOQO1G/_1G/_OOQO,5:R,5:ROOQO-E7e-E7eO,XQSO1G/WOOQO'#D['#D[O,gQSO,59uOOQO1G.p1G.pO,oQSO'#CzOOQO,59Y,59YO-`QSO,59YO!XQSO,59jOOQO-E7b-E7bO-jQSO'#DeO-uQSO,59hOOQO7+$v7+$vO.uQSO7+$vO.TQSO7+$vOOQO1G/a1G/aO)PQWO1G/aO.|QPO,59fO/RQSO'#CfO/^QSO'#ChOOQO'#Cq'#CqO/cQSO'#CqO/kQSO'#CxOOQO'#Cp'#CpO,tQSO'#DcO/sQSO1G.tO/{QQO1G.tO/sQSO1G.tOOQO1G/U1G/UOOQO,5:P,5:POOQO-E7c-E7cOOQO<<Hb<<HbO0^QPO7+${O0cQPO'#CcOOQO1G/Q1G/QOOQO,59],59]O0kQSO,59dO1PQSO,59dOOQO,59},59}OOQO-E7a-E7aO1UQQO7+$`OOQO7+$`7+$`O1gQSO7+$`OOQO<<Hg<<HgOOQO1G/O1G/OO1oQSO1G/OOOQO<<Gz<<GzO2TQQO<<GzOOQO7+$j7+$jOOQOAN=fAN=fO#}QPO'#C{",
+  stateData:
+    "2u~O!^OS~OQTORTOSTOTTOWPO!pSO~OWPO]VX!`VX!qVX!oVX~O]YO!`XO!q[O~OZ_O~OZbOiiOjjO!ekO!fdO~OacO!ieO!mgO]!UX!q!UX~P!^O]YO!qtO~O!avO!bwO!cyO~O!nzOfYX!kYX~OZ{Of}Oh{O~OWPO~O!d!PO~Of!RO!k!QO~Of!SOZyX]yXiyXjyX!byX!eyX!fyX!oyX!qyX~Of!TOZzX]zXizXjzX!bzX!ezX!fzX!ozX!qzX~O]vX!bvX!ovX!qvX~P!^O!b!WO]tX!otX!qtX~O!`!ZO]|X!o|X!q|X~O!o!]O]^X!q^X~O]YO!q!^O~O!bwO!c!cO~Of!dOZka]kaikajka!bka!eka!fka!oka!qka!gka~OZ_Oa!eOi!hOj!hO!l!kO~O!k!oO~OWPO!g!pO~O!b!WO]ta!ota!qta~OZ!tO!P!tO~O!p!vO~O!avO!b!Ta!c!Ta~Om!xO!e!yO!h!wO]bX!obX!qbX~O!k!zOZrX]rXirXjrX!brX!orX!qrX~OZ_Oi!hOj!hO]qX!bqX!oqX!qqX~O!b!|O]pX!opX!qpX~Of#OOZxi]xiixijxi!bxi!exi!fxi!oxi!qxi~O!avO~P+`O!b!WO]ti!oti!qti~O!c#RO!d#SO~O!i#vO~OZ#UOa#YOf#XOh{Oi#ZOj#ZO!a#XO!fdO~O!b#[O!g#^O~P,tOZ_Oi!hOj!hO~O!b!|O]pa!opa!qpa~Of#cOZxq]xqixqjxq!bxq!exq!fxq!oxq!qxq~O!avO~P.TO!j#fO~O!aYX!bgX!ggX~O!avO~OZ{Oh{O~Of#iO!d#hO~O!b#[O!g#lO~Om#mO!h!wO]bi!obi!qbi~O!c#oO~OWPO!jVX~OZ{Of#XOh{Oi#pOj#pO!a#XO~O!d#qO~Om#rO!h!wO]bq!obq!qbq~O!b#[O!g#sO~OZ{Of#XOh{Oi#tOj#tO!a#XO~Om#uO!h!wO]by!oby!qby~Oiajh!o!`!cWTZSRQR~",
+  goto:
+    "'|!`PPPPPP!a!eP!m!pP#cP#s#v#yP#|$P$S$YP$dPPP$p#oP$z%W#|%^%d#|#v%i%l%u%u%u%u%u#v%{&OP!a&U&[&l&s&}'X'`'f'nPPP'xTTOVSROVT!Oe#vR]RQ`XWhYmo!WQ!_vQ!`wU!g!P!i!|Q!m!QQ#P!oS#V!y#[R#`!zQaXQ!awQ!n!QQ#Q!oT#Z!y#[RrYRqYRfYR!l!PR!f!PQ#_!yR#j#[S#Z!y#[Q#p#hR#t#qQ|dW#W!y#[#h#qR#g#XWlYmo!WT#Z!y#[Q!x!fQ#m#^Q#r#lR#u#sQpYR#T!wQ!j!PR#a!|V!h!P!i!|RoYQnYQ!YoR!q!WXlYmo!WR![pQ!u!ZR#d#SQVOR^VUQOVeUWQ!U#eQ!UkR#e#vSx`aR!bxQZRSsZuRu]Q#]!yS#k#]#nR#n#_S!i!P!|R!{!iQ!}!jR#b!}UmYo!WR!VmQ!XnS!r!X!sR!s!YTUOV",
+  nodeNames:
+    "⚠ Program LineComment TripleLineComment Week Day ExerciseExpression ExerciseName NonSeparator Repeat Rep Int RepRange SectionSeparator ExerciseSection ExerciseProperty ExercisePropertyName Keyword FunctionExpression FunctionName FunctionArgument Number Plus PosNumber Float Weight Percentage Rpe KeyValue Liftoscript ReuseLiftoscript ReuseSection WarmupExerciseSets WarmupExerciseSet WarmupSetPart None ExerciseSets CurrentVariation ExerciseSet Timer SetPart WeightWithPlus PercentageWithPlus SetLabel ReuseSectionWithWeekDay WeekDay WeekOrDay Current EmptyExpression",
+  maxTerm: 79,
+  skippedNodes: [0],
+  repeatNodeCount: 9,
+  tokenData:
+    "KQ~R{OX#xXY$|YZ%XZ]#x]^%`^p#xpq$|qr%jrs#xst&jtx#xxy*lyz*qz{#x{|*v|}3z}!O4z!O!P6Q!P!Q:i!Q![>s![!]AZ!]!b#x!b!cBZ!c!}CZ!}#ODj#O#PDo#P#QEo#Q#R#x#R#SEt#S#T#x#T#gCZ#g#hGV#h#lCZ#l#mHh#m#oCZ#o#pIy#p#q#x#q#rJv#r;'S#x;'S;=`$v<%l~#x~O#x~~J{R#}]WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#xR$yP;=`<%l#x~%RQ!^~XY$|pq$|_%`O!pP!q^_%gP!pP!q^YZ%XV%q]!mSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x~&mZOY'`YZ(OZ]'`]^(T^s'`st({t;'S'`;'S;=`(u<%l~'`~O'`~~(O~'cXOY'`YZ(OZ]'`]^(T^;'S'`;'S;=`(u<%l~'`~O'`~~(O~(TOS~~(YXS~OY'`YZ(OZ]'`]^(T^;'S'`;'S;=`(u<%l~'`~O'`~~(O~(xP;=`<%l'`~)OXOY({YZ)kZ]({]^)r^;'S({;'S;=`*f<%l~({~O({~~)k~)rOT~S~~)yXT~S~OY({YZ)kZ]({]^)r^;'S({;'S;=`*f<%l~({~O({~~)k~*iP;=`<%l({~*qO!e~~*vO!g~_*}_f[WROX#xZ]#x^p#xqs#xtx#xz!O#x!O!P+|!Q![2g![!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_,R^WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q![,}![!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_-ScWROX#xZ]#x^p#xqs#xtu#xuv._vx#xz!P#x!Q![,}![!}#x#O#P#x#Q#_#x#_#`/_#`#a1c#a#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_.f]j[WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_/d_WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#Z#x#Z#[0c#[#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_0j]i[WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_1h_WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#U#x#U#V0c#V#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_2ldWROX#xZ]#x^p#xqs#xtu#xuv._vx#xz!O#x!O!P+|!Q![2g![!}#x#O#P#x#Q#_#x#_#`/_#`#a1c#a#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_4R]!b[WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_5R_!aSWROX#xZ]#x^p#xqs#xtx#xz!O#x!O!P+|!Q![2g![!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_6V_WROX#xZ]#x^p#xqs#xtx#xz!O#x!O!P7U!Q![9V![!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#xV7Z^WROX#xZ]#x^p#xqs#xtx#xz!O#x!O!P8V!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#xV8^]!iSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_9^chSWROX#xZ]#x^p#xqs#xtu#xuv._vx#xz!P#x!Q![9V![!}#x#O#P#x#Q#_#x#_#`/_#`#a1c#a#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_:nP]^!P!Q:qP:tZOY;gYZ<VZ];g]^<[^!P;g!P!Q=S!Q;'S;g;'S;=`<|<%l~;g~O;g~~<VP;jXOY;gYZ<VZ];g]^<[^;'S;g;'S;=`<|<%l~;g~O;g~~<VP<[OQPP<aXQPOY;gYZ<VZ];g]^<[^;'S;g;'S;=`<|<%l~;g~O;g~~<VP=PP;=`<%l;gP=VXOY=SYZ=rZ]=S]^=y^;'S=S;'S;=`>m<%l~=S~O=S~~=rP=yORPQPP>QXRPQPOY=SYZ=rZ]=S]^=y^;'S=S;'S;=`>m<%l~=S~O=S~~=rP>pP;=`<%l=S_>zdWRZ[OX#xZ]#x^p#xqs#xtu#xuv._vx#xz!O#x!O!P@Y!Q![>s![!}#x#O#P#x#Q#_#x#_#`/_#`#a1c#a#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x_@_^WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q![9V![!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#xVAb]!dSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#xVBb]!fSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#xVCbbaSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q![CZ![!c#x!c!}CZ#O#P#x#Q#R#x#R#SCZ#S#T#x#T#oCZ#p#q#x#r;'S#x;'S;=`$v<%lO#x~DoO!`~~Dv]!o~WROX#xZ]#x^p#xqs#xtx#xz!P#x!Q!}#x#O#P#x#Q#o#x#p#q#x#r;'S#x;'S;=`$v<%lO#x~EtO!c~_E}b!PWaSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q![CZ![!c#x!c!}CZ#O#P#x#Q#R#x#R#SCZ#S#T#x#T#oCZ#p#q#x#r;'S#x;'S;=`$v<%lO#x_G`b!nWaSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q![CZ![!c#x!c!}CZ#O#P#x#Q#R#x#R#SCZ#S#T#x#T#oCZ#p#q#x#r;'S#x;'S;=`$v<%lO#x_Hqb!kWaSWROX#xZ]#x^p#xqs#xtx#xz!P#x!Q![CZ![!c#x!c!}CZ#O#P#x#Q#R#x#R#SCZ#S#T#x#T#oCZ#p#q#x#r;'S#x;'S;=`$v<%lO#x~JOP!h~#r#sJR~JUTO#rJR#r#sJe#s;'SJR;'S;=`Jp<%lOJR~JhP#q#rJk~JpOm~~JsP;=`<%lJR~J{O!j~^KQO!q^",
+  tokenizers: [0, 1, 2, 3],
+  topRules: { Program: [0, 1] },
+  specialized: [{ term: 17, get: (value) => spec_Keyword[value] || -1 }],
+  tokenPrec: 804,
+});
+
+module.exports = { parser };

requirements.txt

@@ -0,0 +1,2 @@
+gradio[mcp]>=5.0.0
+requests>=2.31.0