mmt-mcp 1.42.2-pre → 1.42.4

package/dist/guides/offline-agent.md

@@ -42,5 +42,5 @@ testlight docs api --pack full
 `testlight docs` reads from, in order:
 
 1. `MMT_GUIDES_DIR`
-2. Guides bundled next to the CLI (`guides/` beside `cli.js`)
+2. Guides bundled next to the CLI (`guides/` beside `cli.js` or inside the standalone binary)
 3. Repo `docs/AI` when developing from source

package/dist/server.cjs

@@ -8299,8 +8299,41 @@ var init_grpcCore = __esm({
 });
 
 // src/index.ts
+var import_module = require("module");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
+// ../core/src/testlightHelp.ts
+var TESTLIGHT_NAME = "testlight";
+var TESTLIGHT_DESCRIPTION = "Multimeter CLI \u2014 run .mmt API tests, suites, and docs";
+var TESTLIGHT_HELP_AFTER = [
+  "",
+  "Run options:",
+  "  -q, --quiet                Minimal output",
+  "  -o, --out <file>           Write result JSON to file",
+  "  -i, --input <k=v...>       Input variables (repeatable)",
+  "  -e, --env <k=v...>         Environment variables (repeatable)",
+  "  -F, --env-file <path>      Environment file (.mmt/.yaml)",
+  "  -P, --preset <name>        Preset from env file (repeatable)",
+  "  -x, --example <name|#n>    Named example or index (#1 is first)",
+  "  -p, --print-js             Print generated JS before executing",
+  "  -r, --report <format>      junit | mmt | html | md | md-detailed",
+  "  -R, --report-file <path>   Report output path",
+  "",
+  "Examples:",
+  "  testlight run path/to/test.mmt",
+  "  testlight run path/to/test.mmt -F env.mmt -P runner.dev -P custom.prod",
+  "  testlight run path/to/suite.mmt --report html",
+  "  testlight scaffold test --from path/to/api.mmt",
+  "  testlight scaffold test --from path/to/api.mmt -o tests/api-smoke.mmt",
+  "  testlight docs test",
+  "  testlight validate path/to/test.mmt",
+  "  testlight suggest asserts --from path/to/api.mmt",
+  "  testlight update",
+  "  testlight update --check",
+  "",
+  "Run `testlight <command> --help` for command-specific options."
+].join("\n");
+
 // src/server.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_zod = require("zod");
@@ -20707,9 +20740,6 @@ function matchesSource(filePath, src) {
   if (!fp || !s) {
     return false;
   }
-  if (s === ".") {
-    return true;
-  }
   if (/\.mmt$/i.test(s)) {
     return fp.endsWith(s) || fp === s;
   }
@@ -21102,9 +21132,6 @@ function matchesSource2(filePath, src) {
   if (!fp || !s) {
     return false;
   }
-  if (s === ".") {
-    return true;
-  }
   if (/\.mmt$/i.test(s)) {
     return fp.endsWith(s) || fp === s;
   }
@@ -24327,6 +24354,88 @@ function parseDurationMs(duration) {
   return void 0;
 }
 
+// ../core/src/agentDocs.ts
+var FULL_TOPIC_FILES = {
+  overview: ["agent-workflow.md", "general.md", "generate.md"],
+  workflow: ["agent-workflow.md"],
+  test: ["generate-test.md"],
+  api: ["generate-api.md"],
+  loadtest: ["generate-loadtest.md"],
+  suite: ["generate-suite.md"],
+  env: ["generate-env.md"],
+  doc: ["generate-doc.md"],
+  constraints: ["generate-test-skill.md"]
+};
+var MIN_TOPIC_FILES = {
+  overview: ["min/overview.md"],
+  workflow: ["min/workflow.md"],
+  test: ["min/test.md"],
+  api: ["min/api.md"],
+  loadtest: ["min/loadtest.md"],
+  suite: ["min/suite.md"],
+  env: ["min/env.md"],
+  doc: ["min/doc.md"],
+  constraints: ["min/constraints.md"]
+};
+var AGENT_DOC_FILE_TOPICS = Object.keys(MIN_TOPIC_FILES);
+function filesForAgentDocTopic(topic, pack = "min") {
+  if (topic === "offline") {
+    return ["offline-agent.md"];
+  }
+  const table = pack === "full" ? FULL_TOPIC_FILES : MIN_TOPIC_FILES;
+  if (topic === "all") {
+    return Array.from(new Set(Object.values(table).flat()));
+  }
+  return table[topic];
+}
+function loadAgentDocSections(opts) {
+  const topic = opts.topic || "overview";
+  const pack = opts.pack || "min";
+  const files = filesForAgentDocTopic(topic, pack);
+  return {
+    topic,
+    pack,
+    sections: files.map((fileName) => ({
+      fileName,
+      content: opts.readText(fileName)
+    }))
+  };
+}
+
+// ../core/src/validateMmt.ts
+function validateMmtContent(content, filePath, expectedType) {
+  const detectedType = fileType(filePath || "", content);
+  if (expectedType && detectedType && detectedType !== expectedType) {
+    return {
+      valid: false,
+      detectedType,
+      errors: [`Expected type "${expectedType}" but detected "${detectedType}"`]
+    };
+  }
+  const type = expectedType || detectedType;
+  try {
+    if (type === "api") {
+      yamlToAPIStrict(content);
+    } else if (type === "test" || !type) {
+      yamlToTestStrict(content);
+    } else {
+      return {
+        valid: false,
+        detectedType,
+        errors: [`Validation for type "${type}" is not implemented yet`]
+      };
+    }
+    return { valid: true, detectedType: type || detectedType, errors: [] };
+  } catch (error) {
+    const message = error?.message || String(error);
+    return {
+      valid: false,
+      detectedType,
+      errors: message.split("\n").filter(Boolean)
+    };
+  }
+}
+
 // ../core/src/mmtFormatAst.ts
 var import_yaml3 = __toESM(require("yaml"));
 var ROOT_KEY_ORDER = {
@@ -26634,42 +26743,23 @@ function toWorkspaceRelative(workspaceRoot, fullPath) {
 // src/resources/documentation.ts
 var import_fs3 = __toESM(require("fs"), 1);
 var import_path3 = __toESM(require("path"), 1);
-var FULL_TOPIC_FILES = {
-  overview: ["agent-workflow.md", "general.md", "generate.md"],
-  workflow: ["agent-workflow.md"],
-  test: ["generate-test.md"],
-  api: ["generate-api.md"],
-  loadtest: ["generate-loadtest.md"],
-  suite: ["generate-suite.md"],
-  env: ["generate-env.md"],
-  doc: ["generate-doc.md"],
-  constraints: ["generate-test-skill.md"]
-};
-var MIN_TOPIC_FILES = {
-  overview: ["min/overview.md"],
-  workflow: ["min/workflow.md"],
-  test: ["min/test.md"],
-  api: ["min/api.md"],
-  loadtest: ["min/loadtest.md"],
-  suite: ["min/suite.md"],
-  env: ["min/env.md"],
-  doc: ["min/doc.md"],
-  constraints: ["min/constraints.md"]
-};
 function readDocumentation(topic = "overview", pack = "min") {
-  const table = pack === "full" ? FULL_TOPIC_FILES : MIN_TOPIC_FILES;
-  const files = topic === "all" ? Array.from(new Set(Object.values(table).flat())) : table[topic];
-  const sections = files.map((fileName) => {
-    const resource = GUIDE_RESOURCES.find((item) => item.fileName === fileName);
+  const loaded = loadAgentDocSections({
+    topic,
+    pack,
+    readText: readGuideContent
+  });
+  const sections = loaded.sections.map((section) => {
+    const resource = GUIDE_RESOURCES.find((item) => item.fileName === section.fileName);
     return {
-      name: resource?.name || fileName.replace(/\.md$/, "").replace(/^min\//, ""),
-      fileName,
-      content: readGuideContent(fileName)
+      name: resource?.name || section.fileName.replace(/\.md$/, "").replace(/^min\//, ""),
+      fileName: section.fileName,
+      content: section.content
     };
   });
   return {
-    topic,
-    pack,
+    topic: loaded.topic,
+    pack: loaded.pack,
     sections,
     usage: pack === "min" ? 'Default min pack. Request pack: "full" only when you need rare syntax.' : 'Full documentation pack. Prefer pack: "min" for routine generate/modify.'
   };
@@ -26769,33 +26859,6 @@ function listExamples(options) {
 }
 
 // src/tools/handlers.ts
-function detectType(content, filePath) {
-  if (filePath) {
-    return JSer_exports.fileType(filePath, content);
-  }
-  if (content.includes("type: api")) {
-    return "api";
-  }
-  if (content.includes("type: test")) {
-    return "test";
-  }
-  if (content.includes("type: env")) {
-    return "env";
-  }
-  if (content.includes("type: suite")) {
-    return "suite";
-  }
-  if (content.includes("type: doc")) {
-    return "doc";
-  }
-  if (content.includes("type: server")) {
-    return "server";
-  }
-  if (content.includes("type: loadtest")) {
-    return "loadtest";
-  }
-  return null;
-}
 function buildValidationSuggestions(errors) {
   const suggestions = /* @__PURE__ */ new Set();
   for (const error of errors) {
@@ -26824,37 +26887,11 @@ function buildValidationSuggestions(errors) {
   return Array.from(suggestions);
 }
 function validateContent(content, filePath, expectedType) {
-  const detectedType = detectType(content, filePath);
-  if (expectedType && detectedType && detectedType !== expectedType) {
-    const errors = [`Expected type "${expectedType}" but detected "${detectedType}"`];
-    return {
-      valid: false,
-      detectedType,
-      errors,
-      suggestions: buildValidationSuggestions(errors)
-    };
-  }
-  try {
-    const type = expectedType || detectedType;
-    if (type === "api") {
-      apiParsePack_exports.yamlToAPIStrict(content);
-    } else if (type === "test" || !type) {
-      testParsePack_exports.yamlToTestStrict(content);
-    } else {
-      const errors = [`Validation for type "${type}" is not implemented yet`];
-      return { valid: false, detectedType, errors, suggestions: buildValidationSuggestions(errors) };
-    }
-    return { valid: true, detectedType: type || detectedType, errors: [], suggestions: [] };
-  } catch (error) {
-    const message = error?.message || String(error);
-    const errors = message.split("\n").filter(Boolean);
-    return {
-      valid: false,
-      detectedType,
-      errors,
-      suggestions: buildValidationSuggestions(errors)
-    };
-  }
+  const result = validateMmtContent(content, filePath, expectedType);
+  return {
+    ...result,
+    suggestions: result.valid ? [] : buildValidationSuggestions(result.errors)
+  };
 }
 async function handleReadDocumentation(args) {
   try {
@@ -27484,7 +27521,46 @@ function createMmtMcpServer() {
 }
 
 // src/index.ts
+var requireFromHere = (0, import_module.createRequire)(__filename);
+function resolveMcpVersion() {
+  try {
+    const version = requireFromHere("../package.json").version;
+    if (typeof version === "string" && version) {
+      return version;
+    }
+  } catch {
+  }
+  return "0.0.0";
+}
+function printHelp() {
+  const version = resolveMcpVersion();
+  process.stdout.write([
+    `mmt-mcp ${version}`,
+    "",
+    "Multimeter MCP server over stdio.",
+    "Tools: read_documentation, list_examples, discover_api, api_card,",
+    "       scaffold_test, suggest_assertions, validate, format, run",
+    "",
+    "Usage: npx -y mmt-mcp",
+    "Docs:  https://mmt.dev/docs/features/mcp",
+    "",
+    `${TESTLIGHT_NAME} \u2014 ${TESTLIGHT_DESCRIPTION}`,
+    "npm (mmt-testlight) and GitHub/Homebrew binaries share this CLI:",
+    TESTLIGHT_HELP_AFTER,
+    ""
+  ].join("\n"));
+}
 async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    process.stdout.write(`${resolveMcpVersion()}
+`);
+    return;
+  }
   const server = createMmtMcpServer();
   const transport = new import_stdio.StdioServerTransport();
   await server.connect(transport);

package/dist/server.js

@@ -8299,8 +8299,41 @@ var init_grpcCore = __esm({
 });
 
 // src/index.ts
+var import_module = require("module");
 var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
+// ../core/src/testlightHelp.ts
+var TESTLIGHT_NAME = "testlight";
+var TESTLIGHT_DESCRIPTION = "Multimeter CLI \u2014 run .mmt API tests, suites, and docs";
+var TESTLIGHT_HELP_AFTER = [
+  "",
+  "Run options:",
+  "  -q, --quiet                Minimal output",
+  "  -o, --out <file>           Write result JSON to file",
+  "  -i, --input <k=v...>       Input variables (repeatable)",
+  "  -e, --env <k=v...>         Environment variables (repeatable)",
+  "  -F, --env-file <path>      Environment file (.mmt/.yaml)",
+  "  -P, --preset <name>        Preset from env file (repeatable)",
+  "  -x, --example <name|#n>    Named example or index (#1 is first)",
+  "  -p, --print-js             Print generated JS before executing",
+  "  -r, --report <format>      junit | mmt | html | md | md-detailed",
+  "  -R, --report-file <path>   Report output path",
+  "",
+  "Examples:",
+  "  testlight run path/to/test.mmt",
+  "  testlight run path/to/test.mmt -F env.mmt -P runner.dev -P custom.prod",
+  "  testlight run path/to/suite.mmt --report html",
+  "  testlight scaffold test --from path/to/api.mmt",
+  "  testlight scaffold test --from path/to/api.mmt -o tests/api-smoke.mmt",
+  "  testlight docs test",
+  "  testlight validate path/to/test.mmt",
+  "  testlight suggest asserts --from path/to/api.mmt",
+  "  testlight update",
+  "  testlight update --check",
+  "",
+  "Run `testlight <command> --help` for command-specific options."
+].join("\n");
+
 // src/server.ts
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_zod = require("zod");
@@ -20707,9 +20740,6 @@ function matchesSource(filePath, src) {
   if (!fp || !s) {
     return false;
   }
-  if (s === ".") {
-    return true;
-  }
   if (/\.mmt$/i.test(s)) {
     return fp.endsWith(s) || fp === s;
   }
@@ -21102,9 +21132,6 @@ function matchesSource2(filePath, src) {
   if (!fp || !s) {
     return false;
   }
-  if (s === ".") {
-    return true;
-  }
   if (/\.mmt$/i.test(s)) {
     return fp.endsWith(s) || fp === s;
   }
@@ -24327,6 +24354,88 @@ function parseDurationMs(duration) {
   return void 0;
 }
 
+// ../core/src/agentDocs.ts
+var FULL_TOPIC_FILES = {
+  overview: ["agent-workflow.md", "general.md", "generate.md"],
+  workflow: ["agent-workflow.md"],
+  test: ["generate-test.md"],
+  api: ["generate-api.md"],
+  loadtest: ["generate-loadtest.md"],
+  suite: ["generate-suite.md"],
+  env: ["generate-env.md"],
+  doc: ["generate-doc.md"],
+  constraints: ["generate-test-skill.md"]
+};
+var MIN_TOPIC_FILES = {
+  overview: ["min/overview.md"],
+  workflow: ["min/workflow.md"],
+  test: ["min/test.md"],
+  api: ["min/api.md"],
+  loadtest: ["min/loadtest.md"],
+  suite: ["min/suite.md"],
+  env: ["min/env.md"],
+  doc: ["min/doc.md"],
+  constraints: ["min/constraints.md"]
+};
+var AGENT_DOC_FILE_TOPICS = Object.keys(MIN_TOPIC_FILES);
+function filesForAgentDocTopic(topic, pack = "min") {
+  if (topic === "offline") {
+    return ["offline-agent.md"];
+  }
+  const table = pack === "full" ? FULL_TOPIC_FILES : MIN_TOPIC_FILES;
+  if (topic === "all") {
+    return Array.from(new Set(Object.values(table).flat()));
+  }
+  return table[topic];
+}
+function loadAgentDocSections(opts) {
+  const topic = opts.topic || "overview";
+  const pack = opts.pack || "min";
+  const files = filesForAgentDocTopic(topic, pack);
+  return {
+    topic,
+    pack,
+    sections: files.map((fileName) => ({
+      fileName,
+      content: opts.readText(fileName)
+    }))
+  };
+}
+
+// ../core/src/validateMmt.ts
+function validateMmtContent(content, filePath, expectedType) {
+  const detectedType = fileType(filePath || "", content);
+  if (expectedType && detectedType && detectedType !== expectedType) {
+    return {
+      valid: false,
+      detectedType,
+      errors: [`Expected type "${expectedType}" but detected "${detectedType}"`]
+    };
+  }
+  const type = expectedType || detectedType;
+  try {
+    if (type === "api") {
+      yamlToAPIStrict(content);
+    } else if (type === "test" || !type) {
+      yamlToTestStrict(content);
+    } else {
+      return {
+        valid: false,
+        detectedType,
+        errors: [`Validation for type "${type}" is not implemented yet`]
+      };
+    }
+    return { valid: true, detectedType: type || detectedType, errors: [] };
+  } catch (error) {
+    const message = error?.message || String(error);
+    return {
+      valid: false,
+      detectedType,
+      errors: message.split("\n").filter(Boolean)
+    };
+  }
+}
+
 // ../core/src/mmtFormatAst.ts
 var import_yaml3 = __toESM(require("yaml"));
 var ROOT_KEY_ORDER = {
@@ -26634,42 +26743,23 @@ function toWorkspaceRelative(workspaceRoot, fullPath) {
 // src/resources/documentation.ts
 var import_fs3 = __toESM(require("fs"), 1);
 var import_path3 = __toESM(require("path"), 1);
-var FULL_TOPIC_FILES = {
-  overview: ["agent-workflow.md", "general.md", "generate.md"],
-  workflow: ["agent-workflow.md"],
-  test: ["generate-test.md"],
-  api: ["generate-api.md"],
-  loadtest: ["generate-loadtest.md"],
-  suite: ["generate-suite.md"],
-  env: ["generate-env.md"],
-  doc: ["generate-doc.md"],
-  constraints: ["generate-test-skill.md"]
-};
-var MIN_TOPIC_FILES = {
-  overview: ["min/overview.md"],
-  workflow: ["min/workflow.md"],
-  test: ["min/test.md"],
-  api: ["min/api.md"],
-  loadtest: ["min/loadtest.md"],
-  suite: ["min/suite.md"],
-  env: ["min/env.md"],
-  doc: ["min/doc.md"],
-  constraints: ["min/constraints.md"]
-};
 function readDocumentation(topic = "overview", pack = "min") {
-  const table = pack === "full" ? FULL_TOPIC_FILES : MIN_TOPIC_FILES;
-  const files = topic === "all" ? Array.from(new Set(Object.values(table).flat())) : table[topic];
-  const sections = files.map((fileName) => {
-    const resource = GUIDE_RESOURCES.find((item) => item.fileName === fileName);
+  const loaded = loadAgentDocSections({
+    topic,
+    pack,
+    readText: readGuideContent
+  });
+  const sections = loaded.sections.map((section) => {
+    const resource = GUIDE_RESOURCES.find((item) => item.fileName === section.fileName);
     return {
-      name: resource?.name || fileName.replace(/\.md$/, "").replace(/^min\//, ""),
-      fileName,
-      content: readGuideContent(fileName)
+      name: resource?.name || section.fileName.replace(/\.md$/, "").replace(/^min\//, ""),
+      fileName: section.fileName,
+      content: section.content
     };
   });
   return {
-    topic,
-    pack,
+    topic: loaded.topic,
+    pack: loaded.pack,
     sections,
     usage: pack === "min" ? 'Default min pack. Request pack: "full" only when you need rare syntax.' : 'Full documentation pack. Prefer pack: "min" for routine generate/modify.'
   };
@@ -26769,33 +26859,6 @@ function listExamples(options) {
 }
 
 // src/tools/handlers.ts
-function detectType(content, filePath) {
-  if (filePath) {
-    return JSer_exports.fileType(filePath, content);
-  }
-  if (content.includes("type: api")) {
-    return "api";
-  }
-  if (content.includes("type: test")) {
-    return "test";
-  }
-  if (content.includes("type: env")) {
-    return "env";
-  }
-  if (content.includes("type: suite")) {
-    return "suite";
-  }
-  if (content.includes("type: doc")) {
-    return "doc";
-  }
-  if (content.includes("type: server")) {
-    return "server";
-  }
-  if (content.includes("type: loadtest")) {
-    return "loadtest";
-  }
-  return null;
-}
 function buildValidationSuggestions(errors) {
   const suggestions = /* @__PURE__ */ new Set();
   for (const error of errors) {
@@ -26824,37 +26887,11 @@ function buildValidationSuggestions(errors) {
   return Array.from(suggestions);
 }
 function validateContent(content, filePath, expectedType) {
-  const detectedType = detectType(content, filePath);
-  if (expectedType && detectedType && detectedType !== expectedType) {
-    const errors = [`Expected type "${expectedType}" but detected "${detectedType}"`];
-    return {
-      valid: false,
-      detectedType,
-      errors,
-      suggestions: buildValidationSuggestions(errors)
-    };
-  }
-  try {
-    const type = expectedType || detectedType;
-    if (type === "api") {
-      apiParsePack_exports.yamlToAPIStrict(content);
-    } else if (type === "test" || !type) {
-      testParsePack_exports.yamlToTestStrict(content);
-    } else {
-      const errors = [`Validation for type "${type}" is not implemented yet`];
-      return { valid: false, detectedType, errors, suggestions: buildValidationSuggestions(errors) };
-    }
-    return { valid: true, detectedType: type || detectedType, errors: [], suggestions: [] };
-  } catch (error) {
-    const message = error?.message || String(error);
-    const errors = message.split("\n").filter(Boolean);
-    return {
-      valid: false,
-      detectedType,
-      errors,
-      suggestions: buildValidationSuggestions(errors)
-    };
-  }
+  const result = validateMmtContent(content, filePath, expectedType);
+  return {
+    ...result,
+    suggestions: result.valid ? [] : buildValidationSuggestions(result.errors)
+  };
 }
 async function handleReadDocumentation(args) {
   try {
@@ -27484,7 +27521,46 @@ function createMmtMcpServer() {
 }
 
 // src/index.ts
+var requireFromHere = (0, import_module.createRequire)(__filename);
+function resolveMcpVersion() {
+  try {
+    const version = requireFromHere("../package.json").version;
+    if (typeof version === "string" && version) {
+      return version;
+    }
+  } catch {
+  }
+  return "0.0.0";
+}
+function printHelp() {
+  const version = resolveMcpVersion();
+  process.stdout.write([
+    `mmt-mcp ${version}`,
+    "",
+    "Multimeter MCP server over stdio.",
+    "Tools: read_documentation, list_examples, discover_api, api_card,",
+    "       scaffold_test, suggest_assertions, validate, format, run",
+    "",
+    "Usage: npx -y mmt-mcp",
+    "Docs:  https://mmt.dev/docs/features/mcp",
+    "",
+    `${TESTLIGHT_NAME} \u2014 ${TESTLIGHT_DESCRIPTION}`,
+    "npm (mmt-testlight) and GitHub/Homebrew binaries share this CLI:",
+    TESTLIGHT_HELP_AFTER,
+    ""
+  ].join("\n"));
+}
 async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    printHelp();
+    return;
+  }
+  if (args.includes("--version") || args.includes("-v")) {
+    process.stdout.write(`${resolveMcpVersion()}
+`);
+    return;
+  }
   const server = createMmtMcpServer();
   const transport = new import_stdio.StdioServerTransport();
   await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mmt-mcp",
-  "version": "1.42.2-pre",
+  "version": "1.42.4",
   "description": "Multimeter MCP server for Cursor, Copilot, and Claude. Scaffold, validate, format, and run YAML .mmt API tests. Do not invent .mmt syntax.",
   "mcpName": "io.github.mshobeyri/multimeter",
   "type": "module",