@mcp-graph-workflow/mcp-graph 5.19.3 → 5.20.0

package/dist/core/translation/validators/code-validator.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Code Validators — syntax validation for translated code.
+ *
+ * TypeScript: uses ts.createSourceFile to parse and detect syntax errors.
+ * Python: uses heuristic checks (indentation, brackets, colons, keywords).
+ *
+ * No external dependencies — all local analysis.
+ */
+export interface ValidationError {
+    line: number;
+    column?: number;
+    message: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    language: string;
+    errors: ValidationError[];
+}
+/**
+ * Validate TypeScript code by parsing with the TS compiler.
+ * Detects syntax errors (not type errors — no type-checker).
+ */
+export declare function validateTypescript(code: string): ValidationResult;
+/**
+ * Validate Python code using heuristic checks.
+ * Checks: indentation consistency, bracket matching, colon placement,
+ * basic keyword structure.
+ */
+export declare function validatePython(code: string): ValidationResult;
+//# sourceMappingURL=code-validator.d.ts.map

package/dist/core/translation/validators/code-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-validator.d.ts","sourceRoot":"","sources":["../../../../src/core/translation/validators/code-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CA6BjE;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAqB7D"}

package/dist/core/translation/validators/code-validator.js

@@ -0,0 +1,159 @@
+/**
+ * Code Validators — syntax validation for translated code.
+ *
+ * TypeScript: uses ts.createSourceFile to parse and detect syntax errors.
+ * Python: uses heuristic checks (indentation, brackets, colons, keywords).
+ *
+ * No external dependencies — all local analysis.
+ */
+import ts from "typescript";
+// ── TypeScript Validator ───────────────────────────
+/**
+ * Validate TypeScript code by parsing with the TS compiler.
+ * Detects syntax errors (not type errors — no type-checker).
+ */
+export function validateTypescript(code) {
+    const sourceFile = ts.createSourceFile("validation.ts", code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const errors = [];
+    // Access internal parseDiagnostics (not public API — may change in future TS versions).
+    // The public alternative ts.getPreEmitDiagnostics() requires a Program, which is heavier.
+    const diagnostics = sourceFile.parseDiagnostics ?? [];
+    for (const diag of diagnostics) {
+        const pos = sourceFile.getLineAndCharacterOfPosition(diag.start ?? 0);
+        errors.push({
+            line: pos.line + 1,
+            column: pos.character + 1,
+            message: ts.flattenDiagnosticMessageText(diag.messageText, "\n"),
+        });
+    }
+    return {
+        valid: errors.length === 0,
+        language: "typescript",
+        errors,
+    };
+}
+// ── Python Validator ───────────────────────────────
+/**
+ * Validate Python code using heuristic checks.
+ * Checks: indentation consistency, bracket matching, colon placement,
+ * basic keyword structure.
+ */
+export function validatePython(code) {
+    const errors = [];
+    const lines = code.split("\n");
+    // Check bracket/paren matching
+    const bracketErrors = checkBracketMatching(lines);
+    errors.push(...bracketErrors);
+    // Check indentation after colon-terminated lines
+    const indentErrors = checkPythonIndentation(lines);
+    errors.push(...indentErrors);
+    // Check colon placement on def/class/if/for/while/try/except/with
+    const colonErrors = checkColonPlacement(lines);
+    errors.push(...colonErrors);
+    return {
+        valid: errors.length === 0,
+        language: "python",
+        errors,
+    };
+}
+// ── Python Heuristic Helpers ───────────────────────
+function checkBracketMatching(lines) {
+    const errors = [];
+    const stack = [];
+    const openers = { "(": ")", "[": "]", "{": "}" };
+    const closers = { ")": "(", "]": "[", "}": "{" };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        // Skip strings (simplified — doesn't handle all edge cases)
+        let inString = false;
+        let stringChar = "";
+        for (let j = 0; j < line.length; j++) {
+            const ch = line[j];
+            if (!inString && (ch === "'" || ch === '"')) {
+                inString = true;
+                stringChar = ch;
+                continue;
+            }
+            if (inString && ch === stringChar) {
+                inString = false;
+                continue;
+            }
+            if (inString || ch === "#")
+                break; // comment — skip rest of line
+            if (openers[ch]) {
+                stack.push({ char: ch, line: i + 1 });
+            }
+            else if (closers[ch]) {
+                if (stack.length === 0 || stack[stack.length - 1].char !== closers[ch]) {
+                    errors.push({ line: i + 1, message: `Unmatched '${ch}'` });
+                }
+                else {
+                    stack.pop();
+                }
+            }
+        }
+    }
+    for (const item of stack) {
+        errors.push({ line: item.line, message: `Unmatched '${item.char}'` });
+    }
+    return errors;
+}
+function checkPythonIndentation(lines) {
+    const errors = [];
+    const blockKeywords = /^\s*(def |class |if |elif |else:|for |while |try:|except |finally:|with |async def |async for |async with )/;
+    for (let i = 0; i < lines.length - 1; i++) {
+        const line = lines[i];
+        const trimmed = line.trimStart();
+        // Skip empty lines and comments
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        // If line ends with colon (block opener), next non-empty line must be indented more
+        if (trimmed.endsWith(":") && blockKeywords.test(line)) {
+            const currentIndent = line.length - trimmed.length;
+            const nextLine = findNextNonEmptyLine(lines, i + 1);
+            if (nextLine !== null) {
+                const nextTrimmed = lines[nextLine].trimStart();
+                const nextIndent = lines[nextLine].length - nextTrimmed.length;
+                if (nextIndent <= currentIndent && nextTrimmed !== "" && !nextTrimmed.startsWith("#")) {
+                    errors.push({
+                        line: nextLine + 1,
+                        message: `Expected indented block after '${trimmed.slice(0, 30)}'`,
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+function checkColonPlacement(lines) {
+    const errors = [];
+    const needsColon = /^\s*(def |class |if |elif |else|for |while |try|except |finally|with |async def |async for |async with )/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trimStart();
+        if (trimmed === "" || trimmed.startsWith("#"))
+            continue;
+        if (needsColon.test(line)) {
+            // These keywords need a colon at end of line (or before comment)
+            const withoutComment = trimmed.split("#")[0].trimEnd();
+            if (!withoutComment.endsWith(":") && !withoutComment.endsWith(":\\")) {
+                // Allow multi-line (line ending with \ or open bracket)
+                if (!withoutComment.endsWith("\\") && !withoutComment.endsWith(",") && !withoutComment.endsWith("(")) {
+                    errors.push({
+                        line: i + 1,
+                        message: `Expected ':' at end of '${trimmed.slice(0, 40)}'`,
+                    });
+                }
+            }
+        }
+    }
+    return errors;
+}
+function findNextNonEmptyLine(lines, start) {
+    for (let i = start; i < lines.length; i++) {
+        if (lines[i].trim() !== "")
+            return i;
+    }
+    return null;
+}
+//# sourceMappingURL=code-validator.js.map

package/dist/core/translation/validators/code-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-validator.js","sourceRoot":"","sources":["../../../../src/core/translation/validators/code-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-graph-workflow/mcp-graph",
-  "version": "5.19.3",
+  "version": "5.20.0",
   "description": "MCP local-first PRD to task graph — transforms text into executable structure",
   "type": "module",
   "main": "dist/index.js",
@@ -16,7 +16,8 @@
     "dashboard:install": "cd src/web/dashboard && npm install",
     "dashboard:dev": "cd src/web/dashboard && npm run dev",
     "dashboard:build": "cd src/web/dashboard && npm run build",
-    "build": "tsc && npm run dashboard:build && npm run copy-dashboard",
+    "build": "tsc && npm run copy-assets && npm run dashboard:build && npm run copy-dashboard",
+    "copy-assets": "node -e \"const fs=require('fs');fs.cpSync('src/core/translation/ucr/construct-seed-data.json','dist/core/translation/ucr/construct-seed-data.json')\"",
     "copy-dashboard": "node -e \"const fs=require('fs');if(fs.existsSync('dist/web/dashboard/dist')){fs.rmSync('dist/web/dashboard/dist',{recursive:true})};fs.cpSync('src/web/dashboard/dist','dist/web/dashboard/dist',{recursive:true})\"",
     "start": "node dist/mcp/server.js",
     "test": "vitest run",
@@ -77,13 +78,14 @@
     "vitest": "^4.0.18"
   },
   "dependencies": {
-    "@mcp-graph-workflow/mcp-graph": "^5.17.0",
+    "@mcp-graph-workflow/mcp-graph": "^5.19.3",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "better-sqlite3": "^12.6.2",
     "cheerio": "^1.2.0",
     "commander": "^14.0.3",
     "express": "^5.2.1",
     "fast-xml-parser": "^5.5.8",
+    "lru-cache": "^11.2.7",
     "mammoth": "^1.12.0",
     "multer": "^2.1.1",
     "pdf-parse": "^2.4.5",
@@ -93,9 +95,9 @@
     "zod": "^4.3.6"
   },
   "optionalDependencies": {
+    "intelephense": ">=1.10.0",
     "typescript": ">=5.0.0",
-    "typescript-language-server": ">=4.0.0",
-    "intelephense": ">=1.10.0"
+    "typescript-language-server": ">=4.0.0"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"