agentsmesh 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.14.0
+
+### Minor Changes
+
+- 16a7f0d: Self-serve MCP server. `agentsmesh mcp` boots a stdio MCP server exposing 41 tools and 16 resources for canonical config introspection, CRUD on rules/commands/agents/skills, settings management (config/mcp-servers/permissions/hooks/ignore), capability matrix queries, and orchestration verbs (generate/lint/check/diff/import/convert). Auto-registered in `.agentsmesh/mcp.json` on `init` and `import`. See the MCP server reference page.
+
+## 0.13.0
+
+### Minor Changes
+
+- f68ab67: feat(cli): add convert command for direct tool-to-tool migration
+
+  Adds `agentsmesh convert --from <source> --to <target>` for direct tool-to-tool conversion without going through canonical setup. Internally chains the existing import and generate pipelines via a temporary directory, producing destination tool files from source tool files in a single command. Supports `--dry-run` and `--json` flags.
+
+- c8d58c0: feat(cli): add structured JSON output mode
+
+  Adds `--json` support across CLI commands so automation and CI can consume stable machine-readable command results. JSON mode returns structured success/error envelopes while keeping the existing human-readable output as the default.
+
 ## 0.12.0
 
 ### Minor Changes

package/README.md

@@ -85,7 +85,7 @@ Prefer a local install? `npm install -D agentsmesh` (also `pnpm add -D` / `yarn
 If your repo already has `.cursor/`, `.claude/`, `.github/copilot-instructions.md`, or other native files, you don't have to delete them. The recommended flow imports them into `.agentsmesh/` first, lets you preview the projection, and only then trusts `generate`.
 
 ```bash
-npx agentsmesh import --from cursor   # or claude-code, copilot, codex-cli, gemini-cli, windsurf, ...
+npx agentsmesh import --from cursor   # or claude-code, copilot, codex-cli, gemini-cli, windsurf, amp, zed, warp, ...
 npx agentsmesh diff                   # patch-style preview of what generate would change
 npx agentsmesh generate               # write native configs (back) from canonical
 npx agentsmesh check                  # add to CI to detect drift
@@ -121,7 +121,7 @@ On macOS/Linux you can also run `tree .agentsmesh` if you have `tree` installed.
 
 ## Supported AI coding tools
 
-AgentsMesh currently generates native config for every major AI coding assistant — Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Continue, Cline, Kiro, Codex CLI, Junie, Roo Code, Antigravity — plus plugin targets you can ship as standalone npm packages. Each tool's native vs. embedded support per feature is tracked in the [supported tools matrix](https://samplexbro.github.io/agentsmesh/reference/supported-tools/). The full matrix table is also embedded [further down this README](#supported-tools--feature-matrix).
+AgentsMesh currently generates native config for every major AI coding assistant — Claude Code, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Continue, Cline, Kiro, Codex CLI, Junie, Roo Code, Antigravity, Amp, Zed, Warp — plus plugin targets you can ship as standalone npm packages. Each tool's native vs. embedded support per feature is tracked in the [supported tools matrix](https://samplexbro.github.io/agentsmesh/reference/supported-tools/). The full matrix table is also embedded [further down this README](#supported-tools--feature-matrix).
 
 ---
 
@@ -133,6 +133,7 @@ AgentsMesh currently generates native config for every major AI coding assistant
 - **Team-safe collaboration** — `agentsmesh check` is a CI drift gate against `.agentsmesh/.lock`, `agentsmesh diff` previews changes, `agentsmesh merge` rebuilds the lock after three-way Git conflicts, and `lock_features` + per-feature `strategy` prevent accidental overrides.
 - **Global mode** — `~/.agentsmesh/` syncs personal AI config to `~/.claude/`, `~/.cursor/`, `~/.codex/`, `~/.windsurf/`, and other user-level folders. Every CLI command accepts `--global`.
 - **Extensible** — community packs (`agentsmesh install ...`), remote `extends`, runtime plugins (`agentsmesh plugin add`), schema-validated config files, and a typed programmatic API for scripts, IDE extensions, and CI.
+- **Self-serve MCP server** — `agentsmesh mcp` exposes canonical configuration as an MCP tool so AI agents can introspect rules, commands, agents, and skills, and trigger `generate` — all within the conversation. Seeded automatically by `agentsmesh init`.
 
 ---
 
@@ -147,7 +148,7 @@ The reason `AGENTS.md` alone is not enough: most AI coding assistants expose con
 - **GitHub Copilot** has `.github/copilot-instructions.md`, `.github/instructions/*.instructions.md`, agents, prompts, and (partial) hooks.
 - **Gemini CLI** has `GEMINI.md`, `.gemini/settings.json` (MCP + hooks), `.gemini/commands/*.toml`, and agents.
 - **Codex CLI** has `AGENTS.md` plus `.codex/config.toml`, `.codex/agents/*.toml`, and `.codex/rules/`.
-- **Windsurf**, **Continue**, **Cline**, **Kiro**, **Junie**, **Roo Code**, **Antigravity** each have their own native rules, workflows, MCP servers, skills, and ignore files.
+- **Windsurf**, **Continue**, **Cline**, **Kiro**, **Junie**, **Roo Code**, **Antigravity**, **Amp**, **Zed**, **Warp** each have their own native rules, workflows, MCP servers, skills, and ignore files.
 
 AgentsMesh canonicalizes all of these — rules, commands, agents, skills, MCP servers, hooks, ignore patterns, permissions — so you don't pick one tool's surface as the lowest common denominator. When a tool has no native slot for a feature, AgentsMesh embeds it with round-trip metadata instead of dropping it.
 
@@ -183,6 +184,7 @@ Detailed contracts: [Canonical Config](https://samplexbro.github.io/agentsmesh/c
 agentsmesh init [--global] [--yes]
 agentsmesh generate [--global] [--targets <csv>] [--check] [--dry-run] [--force] [--refresh-cache]
 agentsmesh import --from <target> [--global]
+agentsmesh convert --from <target> --to <target> [--global] [--dry-run]
 agentsmesh diff [--global] [--targets <csv>]
 agentsmesh lint [--global] [--targets <csv>]
 agentsmesh watch [--global] [--targets <csv>]
@@ -196,6 +198,20 @@ agentsmesh target scaffold <id> [--name <displayName>] [--force]
 
 `agentsmesh --help` prints the same surface; `agentsmesh <cmd> --help` is also supported.
 
+### Machine-readable output
+
+All commands support `--json` for CI pipelines and scripting:
+
+```bash
+agentsmesh lint --json
+# {"success":true,"command":"lint","data":{"diagnostics":[],"summary":{"errors":0,"warnings":0}}}
+
+agentsmesh generate --check --json
+# {"success":false,"command":"generate","error":"Command 'generate' failed","data":{"scope":"project","mode":"check","files":[...],...}}
+```
+
+Every command emits a single JSON envelope to stdout: `{ success, command, data?, error? }`. Human output is fully suppressed. Exit codes are preserved. `--json` is not supported with `watch`.
+
 ### Global mode (personal AI assistant config)
 
 `.agentsmesh/` at the project level is for teams. `~/.agentsmesh/` at the home level is for personal setup across every repo you touch:
@@ -375,7 +391,7 @@ See the [full feature matrix docs](https://samplexbro.github.io/agentsmesh/refer
 
 - **[Getting Started](https://samplexbro.github.io/agentsmesh/getting-started/installation/)** — installation, quick start
 - **[Canonical Config](https://samplexbro.github.io/agentsmesh/canonical-config/)** — rules, commands, agents, skills, MCP, hooks, ignore, permissions
-- **[CLI Reference](https://samplexbro.github.io/agentsmesh/cli/)** — `init`, `generate`, `import`, `install`, `diff`, `lint`, `watch`, `check`, `merge`, `matrix`, `plugin`, `target`
+- **[CLI Reference](https://samplexbro.github.io/agentsmesh/cli/)** — `init`, `generate`, `import`, `convert`, `install`, `diff`, `lint`, `watch`, `check`, `merge`, `matrix`, `plugin`, `target`
 - **[Configuration](https://samplexbro.github.io/agentsmesh/configuration/agentsmesh-yaml/)** — `agentsmesh.yaml`, local overrides, extends, collaboration, conversions
 - **[Guides](https://samplexbro.github.io/agentsmesh/guides/existing-project/)** — adopting in existing projects · multi-tool teams · sharing config · CI drift detection · community packs · **building plugins**
 - **[Reference](https://samplexbro.github.io/agentsmesh/reference/generation-pipeline/)** — supported tools matrix · generation pipeline · managed embedding

package/dist/canonical.js

@@ -1166,12 +1166,12 @@ async function readExistingServers(path) {
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
   const raw = parsed.mcpServers;
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
-  const out = {};
+  const out2 = {};
   for (const [name, value] of Object.entries(raw)) {
     if (!value || typeof value !== "object" || Array.isArray(value)) continue;
-    out[name] = value;
+    out2[name] = value;
   }
-  return out;
+  return out2;
 }
 var init_mcp_merge = __esm({
   "src/targets/import/mcp-merge.ts"() {
@@ -1454,13 +1454,13 @@ function parseMcpJson(content) {
   if (!parsed || typeof parsed !== "object") return {};
   const raw = parsed.mcpServers;
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
-  const out = {};
+  const out2 = {};
   for (const [name, value] of Object.entries(raw)) {
     if (!value || typeof value !== "object" || Array.isArray(value)) continue;
     const server = value;
     const description = typeof server.description === "string" ? server.description : void 0;
     if (typeof server.command === "string") {
-      out[name] = {
+      out2[name] = {
         type: typeof server.type === "string" ? server.type : "stdio",
         command: server.command,
         args: toStringArray5(server.args),
@@ -1470,7 +1470,7 @@ function parseMcpJson(content) {
       continue;
     }
     if (typeof server.url === "string") {
-      out[name] = {
+      out2[name] = {
         type: typeof server.type === "string" ? server.type : "http",
         url: server.url,
         headers: toStringRecord(server.headers),
@@ -1479,7 +1479,7 @@ function parseMcpJson(content) {
       };
     }
   }
-  return out;
+  return out2;
 }
 async function runMcpJson(spec, sources, projectRoot, fromTool) {
   if (!spec.canonicalFilename) {
@@ -9549,18 +9549,18 @@ function generateRules11(canonical) {
   return outputs;
 }
 function toJunieMcpServer(server) {
-  const out = {};
-  if (server.description) out.description = server.description;
-  if (server.type !== "stdio") out.type = server.type;
+  const out2 = {};
+  if (server.description) out2.description = server.description;
+  if (server.type !== "stdio") out2.type = server.type;
   if (isStdioMcpServer(server)) {
-    out.command = server.command;
-    out.args = server.args;
+    out2.command = server.command;
+    out2.args = server.args;
   } else {
-    out.url = server.url;
-    if (Object.keys(server.headers).length > 0) out.headers = server.headers;
+    out2.url = server.url;
+    if (Object.keys(server.headers).length > 0) out2.headers = server.headers;
   }
-  if (Object.keys(server.env).length > 0) out.env = server.env;
-  return out;
+  if (Object.keys(server.env).length > 0) out2.env = server.env;
+  return out2;
 }
 function generateMcp7(canonical) {
   if (!canonical.mcp || Object.keys(canonical.mcp.mcpServers).length === 0) return [];
@@ -11029,11 +11029,11 @@ var init_generator17 = __esm({
 });
 function toStringRecord2(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return {};
-  const out = {};
+  const out2 = {};
   for (const [k, v] of Object.entries(value)) {
-    if (typeof v === "string") out[k] = v;
+    if (typeof v === "string") out2[k] = v;
   }
-  return out;
+  return out2;
 }
 function parseOpenCodeMcp(content) {
   let parsed;
@@ -11045,12 +11045,12 @@ function parseOpenCodeMcp(content) {
   if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return {};
   const raw = parsed.mcp;
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return {};
-  const out = {};
+  const out2 = {};
   for (const [name, value] of Object.entries(raw)) {
     if (!value || typeof value !== "object" || Array.isArray(value)) continue;
     const entry = value;
     if (typeof entry.url === "string") {
-      out[name] = {
+      out2[name] = {
         type: "url",
         url: entry.url,
         headers: toStringRecord2(entry.headers),
@@ -11064,7 +11064,7 @@ function parseOpenCodeMcp(content) {
       const command = cmdArr[0];
       if (command === void 0) continue;
       const args = cmdArr.slice(1);
-      out[name] = {
+      out2[name] = {
         type: "stdio",
         command,
         args,
@@ -11073,7 +11073,7 @@ function parseOpenCodeMcp(content) {
       };
     }
   }
-  return out;
+  return out2;
 }
 async function importMcp4(projectRoot, scope, results) {
   const configFile = scope === "global" ? OPENCODE_GLOBAL_CONFIG_FILE : OPENCODE_CONFIG_FILE;
@@ -13495,12 +13495,12 @@ function topLevelDotfilePrefixes(descriptor19) {
     ...layouts.flatMap((l) => l.managedOutputs?.dirs ?? []),
     ...layouts.flatMap((l) => l.managedOutputs?.files ?? [])
   ];
-  const out = /* @__PURE__ */ new Set();
+  const out2 = /* @__PURE__ */ new Set();
   for (const candidate of candidates) {
     const top = candidate.split("/")[0];
-    if (top && top.startsWith(".") && top.length > 1) out.add(`${top}/`);
+    if (top && top.startsWith(".") && top.length > 1) out2.add(`${top}/`);
   }
-  return out;
+  return out2;
 }
 function buildDefaultRootRelativePrefixes() {
   const set = /* @__PURE__ */ new Set([".agentsmesh/"]);
@@ -15076,12 +15076,60 @@ function parseServer(raw) {
     env
   };
 }
+function stripJsonComments(text) {
+  let result = "";
+  let i = 0;
+  const len = text.length;
+  while (i < len) {
+    const ch = text[i];
+    if (ch === '"') {
+      result += ch;
+      i++;
+      while (i < len) {
+        const sc = text[i];
+        result += sc;
+        if (sc === "\\") {
+          i++;
+          if (i < len) {
+            result += text[i];
+          }
+        } else if (sc === '"') {
+          break;
+        }
+        i++;
+      }
+      i++;
+      continue;
+    }
+    if (ch === "/" && text[i + 1] === "*") {
+      i += 2;
+      while (i < len) {
+        if (text[i] === "*" && text[i + 1] === "/") {
+          i += 2;
+          break;
+        }
+        i++;
+      }
+      continue;
+    }
+    if (ch === "/" && text[i + 1] === "/") {
+      i += 2;
+      while (i < len && text[i] !== "\n") {
+        i++;
+      }
+      continue;
+    }
+    result += ch;
+    i++;
+  }
+  return result;
+}
 async function parseMcp(mcpPath) {
   const content = await readFileSafe(mcpPath);
   if (!content) return null;
   let parsed;
   try {
-    parsed = JSON.parse(content);
+    parsed = JSON.parse(stripJsonComments(content));
   } catch {
     return null;
   }
@@ -15283,14 +15331,14 @@ function mergeHooks(base, overlay) {
 }
 function mergeIgnore(base, overlay) {
   const seen = new Set(base);
-  const out = [...base];
+  const out2 = [...base];
   for (const p of overlay) {
     if (!seen.has(p)) {
       seen.add(p);
-      out.push(p);
+      out2.push(p);
     }
   }
-  return out;
+  return out2;
 }
 
 // src/config/resolve/native-format-detector.ts
@@ -15398,6 +15446,11 @@ var C = {
   cyan: "\x1B[36m",
   reset: "\x1B[0m"
 };
+function out(text) {
+  {
+    process.stdout.write(text);
+  }
+}
 function noColor() {
   return process.env.NO_COLOR !== void 0 && process.env.NO_COLOR !== "";
 }
@@ -15410,7 +15463,7 @@ function pad(str, width) {
 }
 var logger = {
   info(msg) {
-    process.stdout.write(c(C.cyan, msg) + "\n");
+    out(c(C.cyan, msg) + "\n");
   },
   warn(msg) {
     process.stderr.write(c(C.yellow, "\u26A0 ") + msg + "\n");
@@ -15419,11 +15472,11 @@ var logger = {
     process.stderr.write(c(C.red, "\u2717 ") + msg + "\n");
   },
   success(msg) {
-    process.stdout.write(c(C.green, "\u2713 ") + msg + "\n");
+    out(c(C.green, "\u2713 ") + msg + "\n");
   },
   debug(msg) {
     if (process.env.AGENTSMESH_DEBUG === "1") {
-      process.stdout.write(c(C.cyan, "[debug] ") + msg + "\n");
+      out(c(C.cyan, "[debug] ") + msg + "\n");
     }
   },
   table(rows) {
@@ -15439,13 +15492,13 @@ var logger = {
       widths[j] = max;
     }
     const border = "+" + widths.map((w) => "-".repeat(w + 2)).join("+") + "+";
-    process.stdout.write(border + "\n");
+    out(border + "\n");
     for (let i = 0; i < rows.length; i++) {
       const row = rows[i];
       const line = "| " + row.map((cell, j) => pad(cell, widths[j])).join(" | ") + " |";
-      process.stdout.write(line + "\n");
+      out(line + "\n");
     }
-    process.stdout.write(border + "\n");
+    out(border + "\n");
   }
 };