@iloom/cli 0.10.0 → 0.10.1

package/dist/{init-GFQ5W7GK.js → init-32YOKXRL.js}

@@ -4,32 +4,32 @@ import {
 } from "./chunk-BYUMEDDD.js";
 import {
   ShellCompletion
-} from "./chunk-VECNX6VX.js";
+} from "./chunk-KIK2ZFAL.js";
 import {
   TelemetryService
 } from "./chunk-RSYT7MVI.js";
-import "./chunk-VGGST52X.js";
+import "./chunk-I5T677EA.js";
 import {
   FirstRunManager
 } from "./chunk-Q7POFB5Q.js";
 import {
   AgentManager
-} from "./chunk-SF2P22EE.js";
+} from "./chunk-C6HNNJIV.js";
 import {
   parseGitRemotes
 } from "./chunk-FXDYIV3K.js";
 import {
   detectClaudeCli,
   launchClaude
-} from "./chunk-ONQYPICO.js";
+} from "./chunk-UR5DGNUO.js";
 import {
   PromptTemplateManager
-} from "./chunk-4WJNIR5O.js";
+} from "./chunk-UUEW5KWB.js";
 import {
   getRepoRoot,
   isFileGitignored
-} from "./chunk-MNHZB4Z2.js";
-import "./chunk-YYAKPQBT.js";
+} from "./chunk-4FGEGQW4.js";
+import "./chunk-7VHJNVLF.js";
 import "./chunk-KB64WNBZ.js";
 import "./chunk-6MLEBAYZ.js";
 import "./chunk-7JDMYTFZ.js";
@@ -461,4 +461,4 @@ var InitCommand = class {
 export {
   InitCommand
 };
-//# sourceMappingURL=init-GFQ5W7GK.js.map
+//# sourceMappingURL=init-32YOKXRL.js.map

package/dist/{issues-T4ZZSPEG.js → issues-4UUAQ5K6.js}

@@ -4,10 +4,10 @@ import {
 } from "./chunk-4232AHNQ.js";
 import {
   findMainWorktreePathWithSettings
-} from "./chunk-MNHZB4Z2.js";
+} from "./chunk-4FGEGQW4.js";
 import {
   SettingsManager
-} from "./chunk-YYAKPQBT.js";
+} from "./chunk-7VHJNVLF.js";
 import "./chunk-KB64WNBZ.js";
 import {
   IssueTrackerFactory
@@ -176,4 +176,4 @@ var IssuesCommand = class {
 export {
   IssuesCommand
 };
-//# sourceMappingURL=issues-T4ZZSPEG.js.map
+//# sourceMappingURL=issues-4UUAQ5K6.js.map

package/dist/{lint-6TQXDZ3T.js → lint-AAN2NZWG.js}

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   ScriptCommandBase
-} from "./chunk-NRSWLOAZ.js";
+} from "./chunk-WXIM2WS7.js";
 import "./chunk-WWKOVDWC.js";
-import "./chunk-WY4QBK43.js";
-import "./chunk-VGGST52X.js";
+import "./chunk-63QWFWH3.js";
+import "./chunk-I5T677EA.js";
 import "./chunk-YQ57ORTV.js";
-import "./chunk-MNHZB4Z2.js";
-import "./chunk-YYAKPQBT.js";
+import "./chunk-4FGEGQW4.js";
+import "./chunk-7VHJNVLF.js";
 import "./chunk-KB64WNBZ.js";
 import "./chunk-6MLEBAYZ.js";
 import "./chunk-VT4PDUYT.js";
@@ -24,4 +24,4 @@ var LintCommand = class extends ScriptCommandBase {
 export {
   LintCommand
 };
-//# sourceMappingURL=lint-6TQXDZ3T.js.map
+//# sourceMappingURL=lint-AAN2NZWG.js.map

package/dist/mcp/harness-server.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+
+// src/mcp/harness-server.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { fileURLToPath } from "url";
+import net from "net";
+var SIGNAL_TIMEOUT_MS = 3e4;
+function validateEnvironment() {
+  const socketPath = process.env.ILOOM_HARNESS_SOCKET;
+  if (!socketPath) {
+    console.error("Missing required environment variable: ILOOM_HARNESS_SOCKET");
+    process.exit(1);
+  }
+  return socketPath;
+}
+var validatedSocketPath = null;
+function getSocketPath() {
+  if (!validatedSocketPath) {
+    throw new Error("ILOOM_HARNESS_SOCKET not validated - validateEnvironment() must be called first");
+  }
+  return validatedSocketPath;
+}
+function sendSignalToHarness(socketPath, message) {
+  return new Promise((resolve, reject) => {
+    const socket = net.createConnection(socketPath);
+    let responseData = "";
+    let settled = false;
+    const timeoutHandle = globalThis.setTimeout(() => {
+      if (!settled) {
+        settled = true;
+        socket.destroy();
+        reject(new Error("Harness did not respond within 30s."));
+      }
+    }, SIGNAL_TIMEOUT_MS);
+    socket.on("connect", () => {
+      const payload = JSON.stringify(message) + "\n";
+      socket.write(payload);
+    });
+    socket.on("data", (chunk) => {
+      responseData += chunk.toString();
+      const newlineIndex = responseData.indexOf("\n");
+      if (newlineIndex !== -1) {
+        const line = responseData.slice(0, newlineIndex).trim();
+        if (!settled) {
+          settled = true;
+          globalThis.clearTimeout(timeoutHandle);
+          socket.destroy();
+          try {
+            const parsed = JSON.parse(line);
+            resolve(parsed);
+          } catch {
+            reject(new Error(`Harness returned invalid JSON: ${line}`));
+          }
+        }
+      }
+    });
+    socket.on("error", (err) => {
+      if (!settled) {
+        settled = true;
+        globalThis.clearTimeout(timeoutHandle);
+        if (err.code === "EPIPE" || err.code === "ECONNRESET") {
+          reject(new Error("Harness closed connection before responding."));
+        } else {
+          reject(err);
+        }
+      }
+    });
+    socket.on("close", () => {
+      if (!settled) {
+        settled = true;
+        globalThis.clearTimeout(timeoutHandle);
+        reject(new Error("Harness closed connection before responding."));
+      }
+    });
+  });
+}
+var server = new McpServer({
+  name: "iloom-harness",
+  version: "0.1.0"
+});
+server.registerTool(
+  "signal",
+  {
+    title: "Signal",
+    description: "Send a structured signal to the iloom harness process and return the response. Use this to notify the harness of workflow events (e.g., done, status update).",
+    inputSchema: {
+      type: z.string().describe('Signal type (e.g., "done", "status")'),
+      data: z.record(z.unknown()).optional().describe("Optional payload data for the signal")
+    }
+  },
+  async ({ type, data }) => {
+    const socketPath = getSocketPath();
+    const message = { type };
+    if (data !== void 0) {
+      message.data = data;
+    }
+    let response;
+    try {
+      response = await sendSignalToHarness(socketPath, message);
+    } catch (err) {
+      const errorMessage = err instanceof Error ? err.message : String(err);
+      const isTimeout = errorMessage.includes("within 30s");
+      const text = isTimeout ? "Error: Harness did not respond within 30s." : `Error: ${errorMessage}`;
+      return {
+        content: [{ type: "text", text }],
+        isError: true
+      };
+    }
+    return {
+      content: [{ type: "text", text: JSON.stringify(response) }]
+    };
+  }
+);
+async function main() {
+  console.error("=== Iloom Harness MCP Server Starting ===");
+  console.error(`PID: ${process.pid}`);
+  console.error(`Node version: ${process.version}`);
+  console.error(`CWD: ${process.cwd()}`);
+  console.error(`Script: ${fileURLToPath(import.meta.url)}`);
+  console.error("Environment variables:");
+  console.error(`  ILOOM_HARNESS_SOCKET=${process.env.ILOOM_HARNESS_SOCKET ?? "<not set>"}`);
+  validatedSocketPath = validateEnvironment();
+  console.error(`Harness socket path: ${validatedSocketPath}`);
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("=== Iloom Harness MCP Server READY (stdio transport) ===");
+}
+var isMain = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1];
+if (isMain) {
+  main().catch((error) => {
+    console.error("Fatal error starting MCP server:", error);
+    process.exit(1);
+  });
+}
+export {
+  sendSignalToHarness
+};
+//# sourceMappingURL=harness-server.js.map

package/dist/mcp/harness-server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/mcp/harness-server.ts"],"sourcesContent":["/**\n * Harness MCP Server\n *\n * Provides Claude with a `signal` tool to send structured messages to the iloom\n * harness process via Unix domain socket. This is the Claude-side counterpart to\n * the HarnessServer (#762).\n *\n * Environment variables:\n * - ILOOM_HARNESS_SOCKET: Path to the harness Unix domain socket (required)\n */\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { z } from 'zod'\nimport { fileURLToPath } from 'node:url'\nimport net from 'net'\n\nconst SIGNAL_TIMEOUT_MS = 30_000\n\n/**\n * Validate required environment variables\n * Exits with error if missing\n */\nfunction validateEnvironment(): string {\n\tconst socketPath = process.env.ILOOM_HARNESS_SOCKET\n\n\tif (!socketPath) {\n\t\tconsole.error('Missing required environment variable: ILOOM_HARNESS_SOCKET')\n\t\tprocess.exit(1)\n\t}\n\n\treturn socketPath\n}\n\nlet validatedSocketPath: string | null = null\n\n/**\n * Get the validated socket path\n * Throws if called before validateEnvironment()\n */\nfunction getSocketPath(): string {\n\tif (!validatedSocketPath) {\n\t\tthrow new Error('ILOOM_HARNESS_SOCKET not validated - validateEnvironment() must be called first')\n\t}\n\treturn validatedSocketPath\n}\n\n/**\n * Send a signal message to the harness via Unix domain socket and wait for response.\n * Returns the parsed response object, or throws on error/timeout.\n */\nexport function sendSignalToHarness(\n\tsocketPath: string,\n\tmessage: { type: string; data?: Record<string, unknown> }\n): Promise<Record<string, unknown>> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst socket = net.createConnection(socketPath)\n\n\t\tlet responseData = ''\n\t\tlet settled = false\n\n\t\tconst timeoutHandle = globalThis.setTimeout(() => {\n\t\t\tif (!settled) {\n\t\t\t\tsettled = true\n\t\t\t\tsocket.destroy()\n\t\t\t\treject(new Error('Harness did not respond within 30s.'))\n\t\t\t}\n\t\t}, SIGNAL_TIMEOUT_MS)\n\n\t\tsocket.on('connect', () => {\n\t\t\tconst payload = JSON.stringify(message) + '\\n'\n\t\t\tsocket.write(payload)\n\t\t})\n\n\t\tsocket.on('data', (chunk: Buffer) => {\n\t\t\tresponseData += chunk.toString()\n\n\t\t\tconst newlineIndex = responseData.indexOf('\\n')\n\t\t\tif (newlineIndex !== -1) {\n\t\t\t\tconst line = responseData.slice(0, newlineIndex).trim()\n\t\t\t\tif (!settled) {\n\t\t\t\t\tsettled = true\n\t\t\t\t\tglobalThis.clearTimeout(timeoutHandle)\n\t\t\t\t\tsocket.destroy()\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst parsed = JSON.parse(line) as Record<string, unknown>\n\t\t\t\t\t\tresolve(parsed)\n\t\t\t\t\t} catch {\n\t\t\t\t\t\treject(new Error(`Harness returned invalid JSON: ${line}`))\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\n\t\tsocket.on('error', (err: NodeJS.ErrnoException) => {\n\t\t\tif (!settled) {\n\t\t\t\tsettled = true\n\t\t\t\tglobalThis.clearTimeout(timeoutHandle)\n\t\t\t\t// EPIPE and ECONNRESET mean the connection was closed before we could write/read\n\t\t\t\tif (err.code === 'EPIPE' || err.code === 'ECONNRESET') {\n\t\t\t\t\treject(new Error('Harness closed connection before responding.'))\n\t\t\t\t} else {\n\t\t\t\t\treject(err)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\n\t\tsocket.on('close', () => {\n\t\t\tif (!settled) {\n\t\t\t\tsettled = true\n\t\t\t\tglobalThis.clearTimeout(timeoutHandle)\n\t\t\t\treject(new Error('Harness closed connection before responding.'))\n\t\t\t}\n\t\t})\n\t})\n}\n\n// Initialize MCP server\nconst server = new McpServer({\n\tname: 'iloom-harness',\n\tversion: '0.1.0',\n})\n\n// Register signal tool\nserver.registerTool(\n\t'signal',\n\t{\n\t\ttitle: 'Signal',\n\t\tdescription:\n\t\t\t'Send a structured signal to the iloom harness process and return the response. ' +\n\t\t\t'Use this to notify the harness of workflow events (e.g., done, status update).',\n\t\tinputSchema: {\n\t\t\ttype: z.string().describe('Signal type (e.g., \"done\", \"status\")'),\n\t\t\tdata: z.record(z.unknown()).optional().describe('Optional payload data for the signal'),\n\t\t},\n\t},\n\tasync ({ type, data }) => {\n\t\tconst socketPath = getSocketPath()\n\t\tconst message: { type: string; data?: Record<string, unknown> } = { type }\n\t\tif (data !== undefined) {\n\t\t\tmessage.data = data as Record<string, unknown>\n\t\t}\n\n\t\tlet response: Record<string, unknown>\n\t\ttry {\n\t\t\tresponse = await sendSignalToHarness(socketPath, message)\n\t\t} catch (err) {\n\t\t\tconst errorMessage = err instanceof Error ? err.message : String(err)\n\t\t\tconst isTimeout = errorMessage.includes('within 30s')\n\t\t\tconst text = isTimeout\n\t\t\t\t? 'Error: Harness did not respond within 30s.'\n\t\t\t\t: `Error: ${errorMessage}`\n\t\t\treturn {\n\t\t\t\tcontent: [{ type: 'text' as const, text }],\n\t\t\t\tisError: true,\n\t\t\t}\n\t\t}\n\n\t\treturn {\n\t\t\tcontent: [{ type: 'text' as const, text: JSON.stringify(response) }],\n\t\t}\n\t}\n)\n\n// Main server startup\nasync function main(): Promise<void> {\n\tconsole.error('=== Iloom Harness MCP Server Starting ===')\n\tconsole.error(`PID: ${process.pid}`)\n\tconsole.error(`Node version: ${process.version}`)\n\tconsole.error(`CWD: ${process.cwd()}`)\n\tconsole.error(`Script: ${fileURLToPath(import.meta.url)}`)\n\n\tconsole.error('Environment variables:')\n\tconsole.error(`  ILOOM_HARNESS_SOCKET=${process.env.ILOOM_HARNESS_SOCKET ?? '<not set>'}`)\n\n\tvalidatedSocketPath = validateEnvironment()\n\tconsole.error(`Harness socket path: ${validatedSocketPath}`)\n\n\tconst transport = new StdioServerTransport()\n\tawait server.connect(transport)\n\tconsole.error('=== Iloom Harness MCP Server READY (stdio transport) ===')\n}\n\n// Only run main when executed directly (not when imported in tests)\nconst isMain = process.argv[1] && fileURLToPath(import.meta.url) === process.argv[1]\nif (isMain) {\n\tmain().catch((error) => {\n\t\tconsole.error('Fatal error starting MCP server:', error)\n\t\tprocess.exit(1)\n\t})\n}\n"],"mappings":"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","names":[]}

package/dist/mcp/issue-management-server.js

@@ -2831,6 +2831,7 @@ import { z } from "zod";
 import deepmerge from "deepmerge";
 var BaseAgentSettingsSchema = z.object({
   model: z.enum(["sonnet", "opus", "haiku"]).optional().describe("Claude model shorthand: sonnet, opus, or haiku"),
+  swarmModel: z.enum(["sonnet", "opus", "haiku"]).optional().describe("Model to use for this agent in swarm mode. Overrides the base model when running inside swarm workers."),
   enabled: z.boolean().optional().describe("Whether this agent is enabled. Defaults to true."),
   providers: z.record(
     z.enum(["claude", "gemini", "codex"]),
@@ -2839,10 +2840,12 @@ var BaseAgentSettingsSchema = z.object({
   review: z.boolean().optional().describe("Whether artifacts from this agent should be reviewed before posting (defaults to false)")
 });
 var AgentSettingsSchema = BaseAgentSettingsSchema.extend({
-  agents: z.record(z.string(), BaseAgentSettingsSchema).optional().describe("Nested per-agent model overrides for swarm mode. Configure under agents.iloom-swarm-worker.agents.<agent-name>.model to set a different model for phase agents when running inside swarm workers. Fallback chain: swarm-specific agent model > explicit swarm worker model > base agent model. Only meaningful under the iloom-swarm-worker agent entry.")
+  agents: z.record(z.string(), BaseAgentSettingsSchema).optional().describe("Nested per-agent settings. Only meaningful under the iloom-swarm-worker agent entry for sub-agent timeout configuration."),
+  subAgentTimeout: z.number().min(1, "Sub-agent timeout must be at least 1 minute").max(120, "Sub-agent timeout cannot exceed 120 minutes").default(10).describe("Timeout in minutes for sub-agent claude -p invocations in swarm mode. Applies to each phase agent (evaluator, analyzer, planner, implementer) when invoked via the Bash tool. Default: 10 minutes. Only meaningful under the iloom-swarm-worker agent entry.")
 });
 var SpinAgentSettingsSchema = z.object({
-  model: z.enum(["sonnet", "opus", "haiku"]).default("opus").describe("Claude model shorthand for spin orchestrator")
+  model: z.enum(["sonnet", "opus", "haiku"]).default("opus").describe("Claude model shorthand for spin orchestrator"),
+  swarmModel: z.enum(["sonnet", "opus", "haiku"]).optional().describe("Model for the spin orchestrator when running in swarm mode. Overrides spin.model for swarm workflows.")
 });
 var PlanCommandSettingsSchema = z.object({
   model: z.enum(["sonnet", "opus", "haiku"]).default("opus").describe("Claude model shorthand for plan command"),
@@ -2935,7 +2938,7 @@ var IloomSettingsSchema = z.object({
   copyGitIgnoredPatterns: z.array(z.string().min(1, "Pattern cannot be empty")).optional().describe(`Glob patterns for gitignored files to copy to looms (e.g., ["*.db", "data/*.sqlite"]). Great for local dbs and large test data files that are too big to commit to git. Note: .env (dotenv-flow) files, iloom's and claude's local settings are automatically copied and do not need to be specified here.`),
   workflows: WorkflowsSettingsSchema.describe("Per-workflow-type permission configurations"),
   agents: z.record(z.string(), AgentSettingsSchema).optional().nullable().describe(
-    'Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements), iloom-artifact-reviewer (reviews artifacts before posting), iloom-swarm-worker (swarm worker agent, dynamically generated). The iloom-swarm-worker agent supports a nested "agents" sub-record for configuring phase agent models specifically in swarm mode.'
+    "Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements), iloom-artifact-reviewer (reviews artifacts before posting), iloom-swarm-worker (swarm worker agent, dynamically generated). Use swarmModel on any agent to override its model in swarm mode."
   ),
   spin: SpinAgentSettingsSchema.optional().describe(
     "Spin orchestrator configuration. Model defaults to opus when not configured."
@@ -3033,10 +3036,11 @@ var IloomSettingsSchemaNoDefaults = z.object({
   copyGitIgnoredPatterns: z.array(z.string().min(1, "Pattern cannot be empty")).optional().describe(`Glob patterns for gitignored files to copy to looms (e.g., ["*.db", "data/*.sqlite"]). Great for local dbs and large test data files that are too big to commit to git. Note: .env (dotenv-flow) files, iloom's and claude's local settings are automatically copied and do not need to be specified here.`),
   workflows: WorkflowsSettingsSchemaNoDefaults.describe("Per-workflow-type permission configurations"),
   agents: z.record(z.string(), AgentSettingsSchema).optional().nullable().describe(
-    'Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements), iloom-artifact-reviewer (reviews artifacts before posting), iloom-swarm-worker (swarm worker agent, dynamically generated). The iloom-swarm-worker agent supports a nested "agents" sub-record for configuring phase agent models specifically in swarm mode.'
+    "Per-agent configuration overrides. Available agents: iloom-issue-analyzer (analyzes issues), iloom-issue-planner (creates implementation plans), iloom-issue-analyze-and-plan (combined analysis and planning), iloom-issue-complexity-evaluator (evaluates complexity), iloom-issue-enhancer (enhances issue descriptions), iloom-issue-implementer (implements code changes), iloom-code-reviewer (reviews code changes against requirements), iloom-artifact-reviewer (reviews artifacts before posting), iloom-swarm-worker (swarm worker agent, dynamically generated). Use swarmModel on any agent to override its model in swarm mode."
   ),
   spin: z.object({
-    model: z.enum(["sonnet", "opus", "haiku"]).optional()
+    model: z.enum(["sonnet", "opus", "haiku"]).optional(),
+    swarmModel: z.enum(["sonnet", "opus", "haiku"]).optional()
   }).optional().describe("Spin orchestrator configuration"),
   plan: z.object({
     model: z.enum(["sonnet", "opus", "haiku"]).optional(),
@@ -3326,9 +3330,15 @@ ${errorMessages.join("\n")}`
    * @param settings - Pre-loaded settings object
    * @returns Model shorthand ('opus', 'sonnet', or 'haiku')
    */
-  getSpinModel(settings2) {
-    var _a;
-    return ((_a = settings2 == null ? void 0 : settings2.spin) == null ? void 0 : _a.model) ?? SpinAgentSettingsSchema.parse({}).model;
+  getSpinModel(settings2, mode) {
+    var _a, _b;
+    if (mode === "swarm") {
+      if ((_a = settings2 == null ? void 0 : settings2.spin) == null ? void 0 : _a.swarmModel) {
+        return settings2.spin.swarmModel;
+      }
+      return "opus";
+    }
+    return ((_b = settings2 == null ? void 0 : settings2.spin) == null ? void 0 : _b.model) ?? SpinAgentSettingsSchema.parse({}).model;
   }
   /**
    * Get the plan command model with default applied
@@ -3722,6 +3732,108 @@ var IssueManagementProviderFactory = class {
   }
 };
 
+// src/utils/jira-wiki-sanitizer.ts
+var JiraWikiSanitizer = class {
+  /**
+   * Sanitize body text by converting unambiguous Jira Wiki patterns to Markdown.
+   * Preserves content inside backtick-fenced code blocks.
+   * Returns text unchanged if no Wiki patterns detected.
+   */
+  static sanitize(text) {
+    if (!text) {
+      return "";
+    }
+    const segments = this.splitByCodeBlocks(text);
+    const converted = segments.map((segment) => {
+      if (segment.isCode) {
+        return segment.text;
+      }
+      return this.convertSegment(segment.text);
+    });
+    return converted.join("");
+  }
+  /**
+   * Check if text contains unambiguous Jira Wiki patterns.
+   * Only checks for patterns that are safe to convert.
+   */
+  static hasJiraWikiPatterns(text) {
+    if (!text) {
+      return false;
+    }
+    if (/^h[1-6]\.\s+/m.test(text)) {
+      return true;
+    }
+    if (/\{code(?::[^}]*)?\}/i.test(text)) {
+      return true;
+    }
+    if (/\{quote\}/i.test(text)) {
+      return true;
+    }
+    if (/\[[^\]|]+\|https?:\/\/[^\]]+\]/.test(text)) {
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Split text into segments, separating existing Markdown fenced code blocks
+   * from the rest of the content. This ensures we don't modify content inside
+   * code blocks (e.g., Jira Wiki examples shown in a Markdown code block).
+   */
+  static splitByCodeBlocks(text) {
+    const segments = [];
+    const codeBlockRegex = /^(`{3,})[^\n]*\n[\s\S]*?^\1\s*$/gm;
+    let lastIndex = 0;
+    for (const match of text.matchAll(codeBlockRegex)) {
+      const matchStart = match.index ?? 0;
+      if (matchStart > lastIndex) {
+        segments.push({ text: text.slice(lastIndex, matchStart), isCode: false });
+      }
+      segments.push({ text: match[0], isCode: true });
+      lastIndex = matchStart + match[0].length;
+    }
+    if (lastIndex < text.length) {
+      segments.push({ text: text.slice(lastIndex), isCode: false });
+    }
+    return segments;
+  }
+  /**
+   * Apply all safe Jira Wiki -> Markdown conversions to a text segment.
+   */
+  static convertSegment(text) {
+    let result = text;
+    result = result.replace(/^h([1-6])\.\s+(.*?)$/gm, (_match, level, content) => {
+      const hashes = "#".repeat(parseInt(level, 10));
+      return `${hashes} ${content}`;
+    });
+    result = result.replace(
+      /\{code:([^}]+)\}\s*\n([\s\S]*?)\n?\s*\{code\}/gi,
+      (_match, lang, content) => {
+        return "```" + lang.trim() + "\n" + content + "\n```";
+      }
+    );
+    result = result.replace(
+      /\{code\}\s*\n([\s\S]*?)\n?\s*\{code\}/gi,
+      (_match, content) => {
+        return "```\n" + content + "\n```";
+      }
+    );
+    result = result.replace(
+      /\{quote\}\s*\n([\s\S]*?)\n?\s*\{quote\}/gi,
+      (_match, content) => {
+        const lines = content.split("\n");
+        return lines.map((line) => `> ${line}`).join("\n");
+      }
+    );
+    result = result.replace(
+      /\[([^\]|]+)\|(https?:\/\/[^\]]+)\]/g,
+      (_match, linkText, url) => {
+        return `[${linkText}](${url})`;
+      }
+    );
+    return result;
+  }
+};
+
 // src/mcp/issue-management-server.ts
 var settings;
 function validateEnvironment() {
@@ -4018,7 +4130,8 @@ server.registerTool(
     inputSchema: {
       number: z2.string().describe("The issue or PR identifier"),
       body: z2.string().describe("The comment body (markdown supported)"),
-      type: z2.enum(["issue", "pr"]).describe("Type of entity to comment on (issue or pr)")
+      type: z2.enum(["issue", "pr"]).describe("Type of entity to comment on (issue or pr)"),
+      markupLanguage: z2.literal("GFM").describe("The markup language for the body content. Must be GitHub Flavored Markdown (GFM).")
     },
     outputSchema: {
       id: z2.string(),
@@ -4029,9 +4142,10 @@ server.registerTool(
   async ({ number, body, type }) => {
     console.error(`Creating ${type} comment on ${number}`);
     try {
+      const sanitizedBody = JiraWikiSanitizer.sanitize(body);
       const providerType = type === "pr" ? "github" : process.env.ISSUE_PROVIDER;
       const provider = IssueManagementProviderFactory.create(providerType, settings);
-      const result = await provider.createComment({ number, body, type });
+      const result = await provider.createComment({ number, body: sanitizedBody, type });
       console.error(
         `Comment created successfully: ${result.id} at ${result.url}`
       );
@@ -4060,7 +4174,8 @@ server.registerTool(
       commentId: z2.string().describe("The comment identifier to update"),
       number: z2.string().describe("The issue or PR identifier (context for providers that need it)"),
       body: z2.string().describe("The updated comment body (markdown supported)"),
-      type: z2.enum(["issue", "pr"]).optional().describe("Optional type to route PR comments to GitHub regardless of configured provider")
+      type: z2.enum(["issue", "pr"]).optional().describe("Optional type to route PR comments to GitHub regardless of configured provider"),
+      markupLanguage: z2.literal("GFM").describe("The markup language for the body content. Must be GitHub Flavored Markdown (GFM).")
     },
     outputSchema: {
       id: z2.string(),
@@ -4071,9 +4186,10 @@ server.registerTool(
   async ({ commentId, number, body, type }) => {
     console.error(`Updating comment ${commentId} on ${type === "pr" ? "PR" : "issue"} ${number}`);
     try {
+      const sanitizedBody = JiraWikiSanitizer.sanitize(body);
       const providerType = type === "pr" ? "github" : process.env.ISSUE_PROVIDER;
       const provider = IssueManagementProviderFactory.create(providerType, settings);
-      const result = await provider.updateComment({ commentId, number, body });
+      const result = await provider.updateComment({ commentId, number, body: sanitizedBody });
       console.error(
         `Comment updated successfully: ${result.id} at ${result.url}`
       );
@@ -4105,7 +4221,8 @@ server.registerTool(
       teamKey: z2.string().optional().describe('Team key for Linear (e.g., "ENG"). Falls back to settings or team extracted from previous get_issue call. Ignored for GitHub.'),
       repo: z2.string().optional().describe(
         'Optional repository in "owner/repo" format or full GitHub URL. When not provided, uses the current repository. GitHub only.'
-      )
+      ),
+      markupLanguage: z2.literal("GFM").describe("The markup language for the body content. Must be GitHub Flavored Markdown (GFM).")
     },
     outputSchema: {
       id: z2.string().describe("Issue identifier"),
@@ -4116,11 +4233,12 @@ server.registerTool(
   async ({ title, body, labels, teamKey, repo }) => {
     console.error(`Creating issue: ${title}${repo ? ` in ${repo}` : ""}`);
     try {
+      const sanitizedBody = JiraWikiSanitizer.sanitize(body);
       const provider = IssueManagementProviderFactory.create(
         process.env.ISSUE_PROVIDER,
         settings
       );
-      const result = await provider.createIssue({ title, body, labels, teamKey, repo });
+      const result = await provider.createIssue({ title, body: sanitizedBody, labels, teamKey, repo });
       console.error(`Issue created successfully: ${result.id} at ${result.url}`);
       return {
         content: [
@@ -4151,7 +4269,8 @@ server.registerTool(
       teamKey: z2.string().optional().describe('Team key for Linear (e.g., "ENG"). Falls back to parent team. Ignored for GitHub.'),
       repo: z2.string().optional().describe(
         'Optional repository in "owner/repo" format or full GitHub URL. When not provided, uses the current repository. GitHub only.'
-      )
+      ),
+      markupLanguage: z2.literal("GFM").describe("The markup language for the body content. Must be GitHub Flavored Markdown (GFM).")
     },
     outputSchema: {
       id: z2.string().describe("Issue identifier"),
@@ -4162,11 +4281,12 @@ server.registerTool(
   async ({ parentId, title, body, labels, teamKey, repo }) => {
     console.error(`Creating child issue for parent ${parentId}: ${title}${repo ? ` in ${repo}` : ""}`);
     try {
+      const sanitizedBody = JiraWikiSanitizer.sanitize(body);
       const provider = IssueManagementProviderFactory.create(
         process.env.ISSUE_PROVIDER,
         settings
       );
-      const result = await provider.createChildIssue({ parentId, title, body, labels, teamKey, repo });
+      const result = await provider.createChildIssue({ parentId, title, body: sanitizedBody, labels, teamKey, repo });
       console.error(`Child issue created successfully: ${result.id} at ${result.url}`);
       return {
         content: [
@@ -4453,7 +4573,8 @@ server.registerTool(
       labels: z2.array(z2.string()).optional().describe("Labels to add to the issue"),
       repo: z2.string().optional().describe(
         'Optional repository in "owner/repo" format or full GitHub URL. When not provided, uses the current repository. GitHub only.'
-      )
+      ),
+      markupLanguage: z2.literal("GFM").optional().describe("The markup language for the body content. Must be GitHub Flavored Markdown (GFM).")
     },
     outputSchema: {
       success: z2.boolean().describe("Whether the issue was edited successfully")
@@ -4462,11 +4583,12 @@ server.registerTool(
   async ({ number, title, body, state, labels, repo }) => {
     console.error(`Editing issue ${number}${repo ? ` in ${repo}` : ""}`);
     try {
+      const sanitizedBody = body ? JiraWikiSanitizer.sanitize(body) : void 0;
       const provider = IssueManagementProviderFactory.create(
         process.env.ISSUE_PROVIDER,
         settings
       );
-      await provider.editIssue({ number, title, body, state, labels, repo });
+      await provider.editIssue({ number, title, body: sanitizedBody, state, labels, repo });
       console.error(`Issue edited successfully: ${number}`);
       return {
         content: [