@trikhub/mcp 0.2.0 → 0.3.0

package/dist/tools/validate.js

@@ -0,0 +1,179 @@
+/**
+ * validate_manifest — v2 implementation.
+ *
+ * Validates a v2 manifest using the @trikhub/manifest validator,
+ * reports errors with fix suggestions, and returns quality score.
+ */
+import { validateManifest } from '@trikhub/manifest';
+// ============================================================================
+// Error-to-fix mapping
+// ============================================================================
+const FIX_MAP = [
+    {
+        pattern: /schemaVersion/i,
+        fix: 'Set "schemaVersion": 2 at the top level of your manifest.',
+    },
+    {
+        pattern: /agent.*required|required.*agent/i,
+        fix: 'Add an "agent" object with "mode" and "domain" fields. Add "handoffDescription" if using conversational mode.',
+    },
+    {
+        pattern: /handoffDescription.*minLength|handoffDescription.*short/i,
+        fix: 'Make handoffDescription at least 10 characters. Describe what your trik does clearly for handoff routing.',
+    },
+    {
+        pattern: /handoffDescription.*maxLength|handoffDescription.*long/i,
+        fix: 'Keep handoffDescription under 500 characters. Be concise but descriptive.',
+    },
+    {
+        pattern: /mode.*enum/i,
+        fix: 'Set agent.mode to "conversational" (for LLM agents) or "tool" (to export native tools).',
+    },
+    {
+        pattern: /domain.*minItems/i,
+        fix: 'Add at least one domain tag in agent.domain. Example: ["content curation", "article generation"].',
+    },
+    {
+        pattern: /systemPrompt.*mutually exclusive|systemPromptFile.*mutually exclusive/i,
+        fix: 'Use either agent.systemPrompt (inline) or agent.systemPromptFile (path to .md), not both.',
+    },
+    {
+        pattern: /conversational.*requires.*systemPrompt/i,
+        fix: 'Conversational mode requires a system prompt. Add agent.systemPrompt or agent.systemPromptFile.',
+    },
+    {
+        pattern: /unconstrained.*string|logSchema.*unconstrained/i,
+        fix: 'Add constraints to string fields in logSchema: use enum, format, pattern, or maxLength.',
+    },
+    {
+        pattern: /placeholder.*logSchema|logSchema.*placeholder/i,
+        fix: 'Add a logSchema entry for each {{placeholder}} in your logTemplate.',
+    },
+    {
+        pattern: /tool.*mode.*requires.*tools|tools.*required.*tool.*mode/i,
+        fix: 'Tool-mode triks must have a "tools" block with inputSchema and outputSchema for each tool.',
+    },
+    {
+        pattern: /inputSchema.*required|outputSchema.*required/i,
+        fix: 'Tool-mode tools need both "inputSchema" and "outputSchema". Define the JSON Schema for input and output.',
+    },
+    {
+        pattern: /outputSchema.*unconstrained/i,
+        fix: 'Output schema strings must be agent-safe: use enum, pattern, or format. maxLength alone is not sufficient for outputSchema.',
+    },
+    {
+        pattern: /outputTemplate.*required|required.*outputTemplate/i,
+        fix: 'Tool-mode tools need an "outputTemplate" with {{placeholders}} for each outputSchema field. Example: "{{status}} ({{resultId}})".',
+    },
+    {
+        pattern: /agent-safe|not agent-safe|maxLength.*not.*agent/i,
+        fix: 'outputSchema strings must use enum, format, or pattern — maxLength alone is not agent-safe. If your tool returns free-form text, use conversational mode instead.',
+    },
+    {
+        pattern: /outputTemplate.*placeholder.*outputSchema|placeholder.*not.*outputSchema/i,
+        fix: 'Every {{placeholder}} in outputTemplate must match a property in outputSchema. Check for typos.',
+    },
+    {
+        pattern: /entry.*required|entry.*module/i,
+        fix: 'Add an "entry" object with "module" (path to compiled file) and "export" (export name).',
+    },
+    {
+        pattern: /id.*pattern/i,
+        fix: 'Trik ID must be lowercase alphanumeric with dashes, starting with a letter. Example: "my-trik".',
+    },
+];
+function findFix(message) {
+    for (const { pattern, fix } of FIX_MAP) {
+        if (pattern.test(message)) {
+            return fix;
+        }
+    }
+    return 'Check the TrikHub documentation for the correct manifest format.';
+}
+function extractPath(message) {
+    // Try to extract a JSON path from the error message
+    const pathMatch = message.match(/^([\w./[\]]+):/);
+    if (pathMatch) {
+        return pathMatch[1];
+    }
+    // Try to extract from "tools.NAME.logSchema" patterns
+    const toolMatch = message.match(/(tools\.\w+(?:\.\w+)*)/);
+    if (toolMatch) {
+        return toolMatch[1];
+    }
+    // Try to extract "agent.xxx" patterns
+    const agentMatch = message.match(/(agent(?:\.\w+)*)/);
+    if (agentMatch) {
+        return agentMatch[1];
+    }
+    return 'manifest';
+}
+// ============================================================================
+// Public API
+// ============================================================================
+export function validateTrikManifest(manifestJson, strict) {
+    // 1. Parse JSON
+    let manifest;
+    try {
+        manifest = JSON.parse(manifestJson);
+    }
+    catch (e) {
+        return {
+            valid: false,
+            errors: [
+                {
+                    path: 'manifest.json',
+                    message: `Invalid JSON: ${e instanceof Error ? e.message : 'parse error'}`,
+                    fix: 'Fix the JSON syntax. Use a JSON validator or your IDE to find the error.',
+                },
+            ],
+            warnings: [],
+            qualityScore: 0,
+        };
+    }
+    // 2. Run v2 validator
+    const result = validateManifest(manifest);
+    // 3. Convert to MCP tool output format
+    const errors = (result.errors || []).map((msg) => ({
+        path: extractPath(msg),
+        message: msg,
+        fix: findFix(msg),
+    }));
+    const warnings = (result.warnings || []).map((msg) => ({
+        path: extractPath(msg),
+        message: msg,
+        suggestion: findFix(msg),
+    }));
+    // 4. Add strict-mode warnings
+    if (strict && result.valid) {
+        const m = manifest;
+        if (!m.author) {
+            warnings.push({
+                path: 'author',
+                message: 'Missing optional "author" field.',
+                suggestion: 'Add an "author" field with your name or organization.',
+            });
+        }
+        if (!m.repository) {
+            warnings.push({
+                path: 'repository',
+                message: 'Missing optional "repository" field.',
+                suggestion: 'Add a "repository" field with your git repository URL.',
+            });
+        }
+        if (!m.license) {
+            warnings.push({
+                path: 'license',
+                message: 'Missing optional "license" field.',
+                suggestion: 'Add a "license" field (e.g., "MIT", "Apache-2.0").',
+            });
+        }
+    }
+    return {
+        valid: result.valid,
+        errors,
+        warnings,
+        qualityScore: result.qualityScore ?? 0,
+    };
+}
+//# sourceMappingURL=validate.js.map

package/dist/tools/validate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trikhub/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "MCP server for AI-assisted trik authoring",
   "type": "module",
   "main": "./dist/index.js",
@@ -49,8 +49,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^3.25.0",
-    "@trikhub/manifest": "0.11.0",
-    "@trikhub/linter": "0.11.0"
+    "@trikhub/manifest": "0.12.0"
   },
   "devDependencies": {
     "tsx": "^4.19.0"