@mthanh/vespercli 2.0.0 → 2.1.0

package/dist/opencode-render.js

@@ -0,0 +1,254 @@
+// src/cli/utils/opencode-render.js
+var CORE_PLUGIN_NAME = "vesper";
+var OPENCODE_AGENT_DIR_RELATIVE = ".opencode/agents";
+var MODEL_PROVIDER_PREFIX = "anthropic/";
+var CLAUDE_TO_OPENCODE_TOOLS = Object.freeze({
+  Read: "read",
+  Write: "edit",
+  Edit: "edit",
+  MultiEdit: "edit",
+  NotebookEdit: "edit",
+  Bash: "bash",
+  Grep: "grep",
+  Glob: "glob",
+  LS: "list",
+  WebFetch: "webfetch",
+  WebSearch: "websearch",
+  Task: "task",
+  Agent: "task",
+  TodoWrite: "todowrite",
+  TodoRead: "todowrite",
+  AskUserQuestion: "question",
+  Skill: "skill"
+});
+var OPENCODE_GATED_PERMISSIONS = Object.freeze([
+  "read",
+  "edit",
+  "glob",
+  "grep",
+  "bash",
+  "task",
+  "todowrite",
+  "webfetch",
+  "websearch",
+  "question"
+]);
+function sanitizeMcpName(value) {
+  return String(value).replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function agentId(name, plugin = CORE_PLUGIN_NAME) {
+  return `${plugin || CORE_PLUGIN_NAME}:${name}`;
+}
+function mapModel(model) {
+  const m = String(model ?? "").trim();
+  if (!m || m === "inherit")
+    return void 0;
+  if (m.includes("/"))
+    return m;
+  if (m.startsWith("claude-"))
+    return `${MODEL_PROVIDER_PREFIX}${m}`;
+  return void 0;
+}
+function normalizeToolList(tools) {
+  if (tools === null || tools === void 0)
+    return null;
+  const list = Array.isArray(tools) ? tools : String(tools).split(",");
+  const names = list.map((s) => String(s).trim()).filter(Boolean);
+  return names.length ? names : null;
+}
+function mapTools(tools) {
+  const names = normalizeToolList(tools);
+  if (names === null)
+    return { permission: {}, unmapped: [], restricted: false };
+  const allowed = /* @__PURE__ */ new Set();
+  const mcpGlobs = /* @__PURE__ */ new Set();
+  const unmapped = [];
+  for (const tool of names) {
+    const mcp = /^mcp__(.+?)__(.+)$/.exec(tool);
+    if (mcp) {
+      mcpGlobs.add(`${sanitizeMcpName(mcp[1])}_*`);
+      continue;
+    }
+    const key = CLAUDE_TO_OPENCODE_TOOLS[tool];
+    if (key)
+      allowed.add(key);
+    else
+      unmapped.push(tool);
+  }
+  const permission = {};
+  for (const key of OPENCODE_GATED_PERMISSIONS)
+    permission[key] = allowed.has(key) ? "allow" : "deny";
+  for (const key of allowed)
+    if (!(key in permission))
+      permission[key] = "allow";
+  for (const glob of [...mcpGlobs].sort())
+    permission[glob] = "allow";
+  return { permission, unmapped, restricted: true };
+}
+function splitFrontmatter(text) {
+  const src = String(text ?? "").replace(/\r\n/g, "\n");
+  const m = /^---\n([\s\S]*?)\n---(?:\n|$)/.exec(src);
+  if (!m)
+    return { raw: "", body: src };
+  return { raw: m[1], body: src.slice(m[0].length) };
+}
+function scalar(value) {
+  const s = String(value).trim();
+  if (s.startsWith('"') && s.endsWith('"') && s.length >= 2) {
+    try {
+      return JSON.parse(s);
+    } catch {
+      return s.slice(1, -1);
+    }
+  }
+  if (s.startsWith("'") && s.endsWith("'") && s.length >= 2)
+    return s.slice(1, -1).replace(/''/g, "'");
+  return s;
+}
+function parseFrontmatter(raw) {
+  const out = {};
+  const lines = String(raw ?? "").replace(/\r\n/g, "\n").split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.trim() || /^\s*#/.test(line))
+      continue;
+    const m = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line);
+    if (!m)
+      continue;
+    const key = m[1];
+    const value = m[2].trim();
+    if (/^[>|]-?$/.test(value)) {
+      const block = [];
+      while (i + 1 < lines.length && (/^\s+\S/.test(lines[i + 1]) || lines[i + 1].trim() === ""))
+        block.push(lines[++i].trim());
+      while (block.length && block[block.length - 1] === "")
+        block.pop();
+      out[key] = value.startsWith(">") ? block.join(" ").replace(/\s+/g, " ") : block.join("\n");
+      continue;
+    }
+    if (value === "") {
+      const items = [];
+      while (i + 1 < lines.length && /^\s*-\s/.test(lines[i + 1]))
+        items.push(scalar(lines[++i].replace(/^\s*-\s*/, "")));
+      out[key] = items.length ? items : "";
+      continue;
+    }
+    if (value.startsWith("[") && value.endsWith("]")) {
+      out[key] = value.slice(1, -1).split(",").map((s) => scalar(s)).filter((s) => s !== "");
+      continue;
+    }
+    out[key] = scalar(value);
+  }
+  return out;
+}
+function parseAgentMarkdown(text) {
+  const { raw, body } = splitFrontmatter(text);
+  return { frontmatter: parseFrontmatter(raw), body };
+}
+function yamlKey(key) {
+  return /^[A-Za-z_][A-Za-z0-9_-]*$/.test(key) ? key : JSON.stringify(key);
+}
+function renderFrontmatter({ description, mode, model, permission }) {
+  const lines = ["---", `description: ${JSON.stringify(description)}`, `mode: ${mode}`];
+  if (model)
+    lines.push(`model: ${model}`);
+  if (permission && Object.keys(permission).length) {
+    lines.push("permission:");
+    for (const [key, action] of Object.entries(permission))
+      lines.push(`  ${yamlKey(key)}: ${action}`);
+  }
+  lines.push("---");
+  return lines.join("\n");
+}
+function convertClaudeAgent({ name, frontmatter = {}, body = "", plugin = CORE_PLUGIN_NAME } = {}) {
+  if (!name || typeof name !== "string")
+    throw new Error("convertClaudeAgent: `name` is required");
+  const fm = frontmatter && typeof frontmatter === "object" ? frontmatter : {};
+  const description = String(fm.description ?? "").replace(/\s+/g, " ").trim() || `Vesper specialist: ${name}`;
+  const model = mapModel(fm.model);
+  const { permission, unmapped, restricted } = mapTools(fm.tools);
+  const text = String(body ?? "");
+  const config = { description, mode: "subagent" };
+  if (model)
+    config.model = model;
+  if (restricted)
+    config.permission = permission;
+  config.prompt = text;
+  const markdown = `${renderFrontmatter({ description, mode: "subagent", model, permission: restricted ? permission : void 0 })}
+${text}`;
+  return { id: agentId(name, plugin), name, plugin: plugin || CORE_PLUGIN_NAME, markdown, config, unmapped };
+}
+var ORCHESTRATOR_RULES = Object.freeze([
+  [".claude/rules/vesper-orchestrator.md", "the orchestrator playbook (delegation law, purpose router, pipelines, degraded mode, host-mismatch warning)"],
+  [".claude/rules/vesper-orchestration.md", "the team roster + task-management config (the single authority for which `vesper:<name>` specialist fills which role)"],
+  [".claude/rules/vesper-context.md", "the slim project whitepaper (architecture, domain model, workflows, freshness)"]
+]);
+var DEFAULT_ORCHESTRATOR_DESCRIPTION = "Vesper super-orchestrator \u2014 the primary agent of a Vesper-managed project on OpenCode. Routes every request to the specialist team per the always-on orchestrator playbook and team roster in `.claude/rules/`.";
+function renderOrchestratorAgent({ source, description } = {}) {
+  let desc = description;
+  if (!desc && source)
+    desc = parseAgentMarkdown(source).frontmatter.description;
+  desc = String(desc || DEFAULT_ORCHESTRATOR_DESCRIPTION).replace(/\s+/g, " ").trim();
+  const body = [
+    "# Vesper (Super Orchestrator) \u2014 OpenCode primary agent",
+    "",
+    "You are Vesper, the super-orchestrator for this project. Your complete operating playbook \u2014",
+    "the mandatory delegation law, the purpose router, every pipeline, the degraded-mode carve-out",
+    "and the host-mismatch warning \u2014 is the **always-on rules** `opencode.json` loads through",
+    "`instructions` into every session:",
+    "",
+    ...ORCHESTRATOR_RULES.map(([path, what]) => `- \`${path}\` \u2014 ${what}.`),
+    "",
+    "This agent file is intentionally thin: it exists so `opencode.json` `default_agent:",
+    '"vesper-orchestrator"` resolves a real primary agent. All behavior lives in the rules above \u2014',
+    "follow them exactly. Do not restate or override them here.",
+    "",
+    "Specialists are delegated to by their namespaced names (`vesper:<name>` for the core catalog,",
+    "`vesper-<pack>:<name>` for an enabled pack), registered by the Vesper plugin",
+    "(`.opencode/plugins/vesper.js`) from the installed `@mthanh/vespercli` package \u2014 or, when",
+    '`vesper.agentsMode` is `"files"`, from the generated `.opencode/agents/<id>.md` files. The',
+    "committed maintenance skills resolve from `.claude/skills/` and are invoked unqualified",
+    "(`/reinit`, `/compact-knowledge`, `/revalidate-knowledge`, `/revalidate-team`).",
+    ""
+  ].join("\n");
+  return `${renderFrontmatter({ description: desc, mode: "primary" })}
+
+${body}`;
+}
+var opencode_render_default = {
+  CORE_PLUGIN_NAME,
+  OPENCODE_AGENT_DIR_RELATIVE,
+  CLAUDE_TO_OPENCODE_TOOLS,
+  OPENCODE_GATED_PERMISSIONS,
+  ORCHESTRATOR_RULES,
+  agentId,
+  mapModel,
+  mapTools,
+  normalizeToolList,
+  sanitizeMcpName,
+  splitFrontmatter,
+  parseFrontmatter,
+  parseAgentMarkdown,
+  convertClaudeAgent,
+  renderOrchestratorAgent
+};
+export {
+  CLAUDE_TO_OPENCODE_TOOLS,
+  CORE_PLUGIN_NAME,
+  DEFAULT_ORCHESTRATOR_DESCRIPTION,
+  MODEL_PROVIDER_PREFIX,
+  OPENCODE_AGENT_DIR_RELATIVE,
+  OPENCODE_GATED_PERMISSIONS,
+  ORCHESTRATOR_RULES,
+  agentId,
+  convertClaudeAgent,
+  opencode_render_default as default,
+  mapModel,
+  mapTools,
+  normalizeToolList,
+  parseAgentMarkdown,
+  parseFrontmatter,
+  renderOrchestratorAgent,
+  sanitizeMcpName,
+  splitFrontmatter
+};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mthanh/vespercli",
-	"version": "2.0.0",
+	"version": "2.1.0",
 	"description": "Vesper Agent Suite — CLI to manage AI agents, prompts, instructions, and skills for GitHub Copilot (VS Code) and Claude Code",
 	"type": "module",
 	"main": "./src/cli/index.js",
@@ -29,7 +29,7 @@
 		"test": "vitest run",
 		"test:unit": "vitest run",
 		"test:watch": "vitest",
-		"build:cli": "esbuild src/cli/index.js --bundle --platform=node --format=esm --minify --outfile=dist/cli.min.js --external:@inquirer/prompts --external:commander --external:picocolors --external:strip-json-comments",
+		"build:cli": "esbuild src/cli/index.js --bundle --platform=node --format=esm --minify --outfile=dist/cli.min.js --external:@inquirer/prompts --external:commander --external:picocolors --external:strip-json-comments && esbuild src/cli/utils/opencode-render.js --bundle --platform=node --format=esm --outfile=dist/opencode-render.js",
 		"build:mcp": "cd src/mcp/vesper-indexing && npm install && npm run build",
 		"build": "npm run build:cli && npm run build:mcp",
 		"eval": "node scripts/eval-orchestrator.js",