@harness-engineering/cli 2.1.1 → 2.2.0

package/dist/{chunk-FNCJ3UCU.js → chunk-GOOTYTTV.js}

@@ -32,7 +32,7 @@ import {
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
-} from "./chunk-SVC7THFK.js";
+} from "./chunk-OJMO4JBQ.js";
 import {
   toKebabCase
 } from "./chunk-KET4QQZB.js";
@@ -57,7 +57,7 @@ import {
   loadCachedSnapshot,
   persistToolingConfig,
   recommend
-} from "./chunk-7XQYOXTB.js";
+} from "./chunk-L2IDE7WS.js";
 import {
   loadGraphStore
 } from "./chunk-KTWKW6KJ.js";
@@ -2410,6 +2410,22 @@ function writeMcpEntry(filePath, name, entry) {
   config.mcpServers[name] = entry;
   writeJson(filePath, config);
 }
+function readOpencodeConfig(filePath) {
+  const config = readJsonSafe(filePath);
+  if (!config) return { mcp: {} };
+  if (!config.mcp) config.mcp = {};
+  return config;
+}
+function writeOpencodeMcpEntry(filePath, name, entry) {
+  const config = readOpencodeConfig(filePath);
+  config.mcp[name] = {
+    type: "local",
+    command: [entry.command, ...entry.args ?? []],
+    enabled: true,
+    ...entry.env ? { environment: entry.env } : {}
+  };
+  writeJson(filePath, config);
+}
 function removeMcpEntry(filePath, name) {
   if (!fs6.existsSync(filePath)) return;
   const config = readMcpConfig(filePath);
@@ -4106,6 +4122,16 @@ function setupMcp(cwd, client) {
       configured.push("Cursor");
     }
   }
+  if (client === "all" || client === "opencode") {
+    const configPath = path26.join(cwd, "opencode.json");
+    const existing = readJsonFile(configPath);
+    if (existing?.mcp?.["harness"]) {
+      skipped.push("OpenCode");
+    } else {
+      writeOpencodeMcpEntry(configPath, "harness", { command: "harness", args: ["mcp"] });
+      configured.push("OpenCode");
+    }
+  }
   return { configured, skipped, trustedFolder };
 }
 async function resolveCursorWithPicker(cwd, pick) {
@@ -4155,7 +4181,11 @@ function printMcpResult(configured, skipped, trustedFolder) {
   console.log("");
 }
 function createSetupMcpCommand() {
-  return new Command34("setup-mcp").description("Configure MCP server for AI agent integration").option("--client <client>", "Client to configure (claude, gemini, codex, cursor, all)", "all").option("--pick", "Launch interactive tool picker (Cursor only)").option("--yes", "Bypass interactive picker and use curated 25-tool set (Cursor only)").action(async (opts, cmd) => {
+  return new Command34("setup-mcp").description("Configure MCP server for AI agent integration").option(
+    "--client <client>",
+    "Client to configure (claude, gemini, codex, cursor, opencode, all)",
+    "all"
+  ).option("--pick", "Launch interactive tool picker (Cursor only)").option("--yes", "Bypass interactive picker and use curated 25-tool set (Cursor only)").action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     const cwd = process.cwd();
     let configured;
@@ -5775,7 +5805,7 @@ function createMcpCommand() {
     parseBudget
   ).action(async (opts) => {
     const [{ startServer: startServer2, getToolDefinitions: getToolDefinitions2 }, { selectTier }] = await Promise.all([
-      import("./mcp-QFZDPFNP.js"),
+      import("./mcp-JDJGELGD.js"),
       import("./tool-tiers-7QGZ3FKY.js")
     ]);
     if (opts.tools && opts.tools.length > 0) {
@@ -7302,7 +7332,13 @@ async function runMcpSetup(cwd) {
       configTarget: ".gemini/settings.json"
     },
     { name: "Codex CLI", dir: ".codex", client: "codex", configTarget: ".codex/config.toml" },
-    { name: "Cursor", dir: ".cursor", client: "cursor", configTarget: ".cursor/mcp.json" }
+    { name: "Cursor", dir: ".cursor", client: "cursor", configTarget: ".cursor/mcp.json" },
+    {
+      name: "OpenCode",
+      dir: path47.join(".config", "opencode"),
+      client: "opencode",
+      configTarget: "opencode.json"
+    }
   ];
   for (const { name, dir, client, configTarget } of clients) {
     if (!detectClient(dir)) {
@@ -7350,6 +7386,13 @@ function configureTier0Integrations(cwd) {
         }
       }
     }
+    const opencodePath = path47.join(cwd, "opencode.json");
+    const opencodeGlobalDir = path47.join(os7.homedir(), ".config", "opencode");
+    if (fs29.existsSync(opencodePath) || fs29.existsSync(opencodeGlobalDir)) {
+      for (const integration of tier0) {
+        writeOpencodeMcpEntry(opencodePath, integration.name, integration.mcpConfig);
+      }
+    }
     if (added.length === 0) {
       return { status: "pass", message: "Tier 0 MCP integrations already configured" };
     }

package/dist/{chunk-7XQYOXTB.js → chunk-L2IDE7WS.js}

@@ -2251,6 +2251,36 @@ function renderClaudeCode(spec) {
   return lines.join("\n");
 }
 
+// src/slash-commands/render-cursor-command.ts
+function renderCursorCommand(spec) {
+  const lines = ["---"];
+  lines.push(`name: ${spec.fullName}`);
+  lines.push(`description: ${spec.description}`);
+  lines.push("---");
+  lines.push("");
+  lines.push(GENERATED_HEADER_CURSOR);
+  lines.push("");
+  lines.push("<context>");
+  lines.push(spec.prompt.context);
+  lines.push("</context>");
+  lines.push("");
+  lines.push("<objective>");
+  lines.push(spec.prompt.objective);
+  lines.push("</objective>");
+  lines.push("");
+  if (spec.prompt.executionContext) {
+    lines.push("<execution_context>");
+    lines.push(spec.prompt.executionContext);
+    lines.push("</execution_context>");
+    lines.push("");
+  }
+  lines.push("<process>");
+  lines.push(spec.prompt.process);
+  lines.push("</process>");
+  lines.push("");
+  return lines.join("\n");
+}
+
 // src/slash-commands/render-gemini.ts
 function escapeTomlLiteral(content) {
   return content.replace(/'''/g, "''\\'''");
@@ -2473,8 +2503,11 @@ function resolveAbsoluteExecutionContext(spec) {
     }
   };
 }
-function renderSpec(platform, spec, useAbsolutePaths) {
+function renderSpec(platform, spec, useAbsolutePaths, cursorMode = "rules") {
   if (platform === "cursor") {
+    if (cursorMode === "commands") {
+      return [`${spec.name}.md`, renderCursorCommand(spec)];
+    }
     const mdPath2 = path14.join(spec.skillsBaseDir, spec.sourceDir, "SKILL.md");
     const skillMd = fs12.existsSync(mdPath2) ? fs12.readFileSync(mdPath2, "utf-8") : "";
     return [`${spec.skillYamlName}.mdc`, renderCursor(spec, skillMd, spec.cursor)];
@@ -2503,7 +2536,7 @@ function generateForPlatform(platform, outputDir, specs, opts) {
   const parentRendered = /* @__PURE__ */ new Map();
   const customNamespaceRendered = /* @__PURE__ */ new Map();
   for (const spec of specs) {
-    const [filename, content] = renderSpec(platform, spec, opts.global);
+    const [filename, content] = renderSpec(platform, spec, opts.global, opts.cursorMode);
     if (spec.commandName && (platform === "claude-code" || platform === "gemini-cli")) {
       parentRendered.set(filename, content);
     } else if (spec.customNamespace && (platform === "claude-code" || platform === "gemini-cli")) {
@@ -2633,10 +2666,20 @@ ${result.platform} \u2192 ${result.outputDir}`);
 function createGenerateSlashCommandsCommand() {
   return new Command("generate-slash-commands").description(
     "Generate native commands for Claude Code, Gemini CLI, Codex CLI, and Cursor from skill metadata"
-  ).option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global config directories", false).option("--include-global", "Include built-in global skills alongside project skills", false).option("--output <dir>", "Custom output directory").option("--skills-dir <path>", "Skills directory to scan").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).action(async (opts, cmd) => {
+  ).option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global config directories", false).option("--include-global", "Include built-in global skills alongside project skills", false).option("--output <dir>", "Custom output directory").option("--skills-dir <path>", "Skills directory to scan").option("--dry-run", "Show what would change without writing", false).option("--yes", "Skip deletion confirmation prompts", false).option(
+    "--cursor-mode <mode>",
+    'For cursor platform: "rules" (.mdc with description/globs/alwaysApply, default) or "commands" (.md with name/description for plugin commands/ dir)',
+    "rules"
+  ).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     try {
       const platforms = validatePlatforms(opts.platforms.split(",").map((p) => p.trim()));
+      if (opts.cursorMode !== "rules" && opts.cursorMode !== "commands") {
+        throw new CLIError(
+          `Invalid --cursor-mode "${opts.cursorMode}". Expected "rules" or "commands".`,
+          ExitCode.VALIDATION_FAILED
+        );
+      }
       const generateOpts = {
         platforms,
         global: opts.global,
@@ -2644,7 +2687,8 @@ function createGenerateSlashCommandsCommand() {
         output: opts.output,
         skillsDir: opts.skillsDir ?? "",
         dryRun: opts.dryRun,
-        yes: opts.yes
+        yes: opts.yes,
+        cursorMode: opts.cursorMode
       };
       const results = generateSlashCommands(generateOpts);
       if (globalOpts.json) {
@@ -3734,7 +3778,7 @@ var generateAgentDefinitionsDefinition = {
   }
 };
 async function handleGenerateAgentDefinitions(input) {
-  const { generateAgentDefinitions } = await import("./generate-agent-definitions-ZHFFS6YG.js");
+  const { generateAgentDefinitions } = await import("./generate-agent-definitions-GFNXJCBY.js");
   const platforms = input.platform === "all" || !input.platform ? ["claude-code", "gemini-cli"] : [input.platform];
   const results = generateAgentDefinitions({
     platforms: [...platforms],

package/dist/{chunk-SVC7THFK.js → chunk-OJMO4JBQ.js}

@@ -175,16 +175,67 @@ function renderGeminiAgent(def) {
   return lines.join("\n");
 }
 
+// src/agent-definitions/render-cursor.ts
+function formatStep3(step, index) {
+  if ("command" in step && step.command) {
+    const cmd = step.command;
+    const when = step.when ?? "always";
+    return `${index + 1}. Run \`harness ${cmd}\` (${when})`;
+  }
+  if ("skill" in step && step.skill) {
+    const skill = step.skill;
+    const when = step.when ?? "always";
+    return `${index + 1}. Execute ${skill} skill (${when})`;
+  }
+  return `${index + 1}. Unknown step`;
+}
+function renderCursorAgent(def) {
+  const lines = ["---"];
+  lines.push(`name: ${def.name}`);
+  lines.push(`description: >`);
+  lines.push(`  ${def.description}`);
+  lines.push("---");
+  lines.push("");
+  lines.push(GENERATED_HEADER_AGENT);
+  lines.push("");
+  lines.push("## Role");
+  lines.push("");
+  lines.push(def.role);
+  lines.push("");
+  lines.push("## Skills");
+  lines.push("");
+  for (const skill of def.skills) {
+    lines.push(`- ${skill}`);
+  }
+  lines.push("");
+  lines.push("## Steps");
+  lines.push("");
+  def.steps.forEach((step, i) => {
+    lines.push(formatStep3(step, i));
+  });
+  lines.push("");
+  if (def.methodology) {
+    lines.push("## Methodology");
+    lines.push("");
+    lines.push(def.methodology);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
 // src/commands/generate-agent-definitions.ts
 function resolveOutputDir(platform, opts) {
   if (opts.output) {
-    return platform === "claude-code" ? path.join(opts.output, "claude-code") : path.join(opts.output, "gemini-cli");
+    return path.join(opts.output, platform);
   }
   if (opts.global) {
     const home = os.homedir();
-    return platform === "claude-code" ? path.join(home, ".claude", "agents") : path.join(home, ".gemini", "agents");
+    if (platform === "claude-code") return path.join(home, ".claude", "agents");
+    if (platform === "gemini-cli") return path.join(home, ".gemini", "agents");
+    if (platform === "cursor") return path.join(home, ".cursor", "agents");
+    return path.join(home, ".codex", "agents");
   }
-  return platform === "claude-code" ? path.join("agents", "agents", "claude-code") : path.join("agents", "agents", "gemini-cli");
+  return path.join("agents", "agents", platform);
 }
 function loadSkillContent(skillName) {
   const skillsDir = resolveSkillsDir();
@@ -193,7 +244,9 @@ function loadSkillContent(skillName) {
   return fs.readFileSync(skillMdPath, "utf-8");
 }
 function getRenderer(platform) {
-  return platform === "claude-code" ? renderClaudeCodeAgent : renderGeminiAgent;
+  if (platform === "claude-code") return renderClaudeCodeAgent;
+  if (platform === "cursor") return renderCursorAgent;
+  return renderGeminiAgent;
 }
 function generateAgentDefinitions(opts) {
   const personasDir = resolvePersonasDir();
@@ -265,7 +318,9 @@ ${result.platform} \u2192 ${result.outputDir}`);
   }
 }
 function createGenerateAgentDefinitionsCommand() {
-  return new Command("generate-agent-definitions").description("Generate agent definition files from personas for Claude Code and Gemini CLI").option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global agent directories", false).option("--output <dir>", "Custom output directory").option("--dry-run", "Show what would change without writing", false).action(async (opts, cmd) => {
+  return new Command("generate-agent-definitions").description(
+    "Generate agent definition files from personas for Claude Code, Gemini CLI, and Cursor"
+  ).option("--platforms <list>", "Target platforms (comma-separated)", "claude-code,gemini-cli").option("--global", "Write to global agent directories", false).option("--output <dir>", "Custom output directory").option("--dry-run", "Show what would change without writing", false).action(async (opts, cmd) => {
     const globalOpts = cmd.optsWithGlobals();
     try {
       const platforms = parsePlatforms(opts.platforms);

package/dist/{generate-agent-definitions-ZHFFS6YG.js → generate-agent-definitions-GFNXJCBY.js}

@@ -1,7 +1,7 @@
 import {
   createGenerateAgentDefinitionsCommand,
   generateAgentDefinitions
-} from "./chunk-SVC7THFK.js";
+} from "./chunk-OJMO4JBQ.js";
 import "./chunk-KET4QQZB.js";
 import "./chunk-VJQLUS5I.js";
 import "./chunk-3ISINLYT.js";

package/dist/index.d.ts

@@ -148,6 +148,14 @@ interface GeneratedFiles {
 declare function generateSkillFiles(opts: CreateSkillOptions): GeneratedFiles;
 
 type Platform = 'claude-code' | 'gemini-cli' | 'codex' | 'cursor';
+/**
+ * For the `cursor` platform, decides whether output is rendered as Cursor
+ * rules (`.mdc` with description/globs/alwaysApply — for `~/.cursor/rules/`)
+ * or as Cursor plugin commands (`.md` with name/description — for
+ * `<plugin>/commands/`). Defaults to `rules` for backward compatibility
+ * with `harness setup`.
+ */
+type CursorRenderMode = 'rules' | 'commands';
 interface GenerateOptions {
     platforms: Platform[];
     global: boolean;
@@ -156,6 +164,7 @@ interface GenerateOptions {
     skillsDir: string;
     dryRun: boolean;
     yes: boolean;
+    cursorMode?: CursorRenderMode;
 }
 
 interface SkillSource {
@@ -779,14 +788,14 @@ declare const HarnessConfigSchema: z.ZodObject<{
         modules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodUnion<[z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodNumber>]>>>>;
     }, "strip", z.ZodTypeAny, {
         enabled: boolean;
-        thresholds: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>;
-        modules: Record<string, Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>>;
         baselinePath: string;
+        thresholds: Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>;
+        modules: Record<string, Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>>;
     }, {
         enabled?: boolean | undefined;
-        thresholds?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>> | undefined;
-        modules?: Record<string, Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>> | undefined;
         baselinePath?: string | undefined;
+        thresholds?: Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>> | undefined;
+        modules?: Record<string, Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>> | undefined;
     }>>;
     /** Skill loading, suggestion, and tier override settings */
     skills: z.ZodOptional<z.ZodObject<{
@@ -1040,9 +1049,9 @@ declare const HarnessConfigSchema: z.ZodObject<{
     } | undefined;
     architecture?: {
         enabled: boolean;
-        thresholds: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>;
-        modules: Record<string, Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>>;
         baselinePath: string;
+        thresholds: Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>;
+        modules: Record<string, Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>>;
     } | undefined;
     traceability?: {
         enabled: boolean;
@@ -1198,9 +1207,9 @@ declare const HarnessConfigSchema: z.ZodObject<{
     } | undefined;
     architecture?: {
         enabled?: boolean | undefined;
-        thresholds?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>> | undefined;
-        modules?: Record<string, Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>> | undefined;
         baselinePath?: string | undefined;
+        thresholds?: Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>> | undefined;
+        modules?: Record<string, Partial<Record<"circular-deps" | "layer-violations" | "complexity" | "coupling" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>> | undefined;
     } | undefined;
     traceability?: {
         enabled?: boolean | undefined;

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   runSnapshotCapture,
   runUninstall,
   runUninstallConstraints
-} from "./chunk-FNCJ3UCU.js";
+} from "./chunk-GOOTYTTV.js";
 import {
   generateRuntime
 } from "./chunk-TNZYQTEE.js";
@@ -52,7 +52,7 @@ import {
   generateAgentDefinitions,
   renderClaudeCodeAgent,
   renderGeminiAgent
-} from "./chunk-SVC7THFK.js";
+} from "./chunk-OJMO4JBQ.js";
 import "./chunk-KET4QQZB.js";
 import {
   listPersonas,
@@ -66,7 +66,7 @@ import {
   generateSlashCommands,
   getToolDefinitions,
   startServer
-} from "./chunk-7XQYOXTB.js";
+} from "./chunk-L2IDE7WS.js";
 import "./chunk-36X7TRUI.js";
 import "./chunk-YWD6WXXM.js";
 import "./chunk-IOW3MW2K.js";

package/dist/{mcp-QFZDPFNP.js → mcp-JDJGELGD.js}

@@ -2,7 +2,7 @@ import {
   createHarnessServer,
   getToolDefinitions,
   startServer
-} from "./chunk-7XQYOXTB.js";
+} from "./chunk-L2IDE7WS.js";
 import "./chunk-36X7TRUI.js";
 import "./chunk-YWD6WXXM.js";
 import "./chunk-IOW3MW2K.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/cli",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "CLI for Harness Engineering toolkit",
   "type": "module",
   "bin": {
@@ -41,8 +41,8 @@
     "@harness-engineering/core": "0.23.8",
     "@harness-engineering/dashboard": "0.5.2",
     "@harness-engineering/graph": "0.8.0",
-    "@harness-engineering/linter-gen": "0.1.7",
     "@harness-engineering/orchestrator": "0.3.2",
+    "@harness-engineering/linter-gen": "0.1.7",
     "@harness-engineering/types": "0.11.0"
   },
   "peerDependencies": {