@mmerterden/multi-agent-pipeline 10.6.0 → 10.7.0

package/pipeline/adapters/_base.mjs

@@ -1,640 +0,0 @@
-/**
- * @file Adapter base  -  shared helpers for third-party AI tool adapters.
- *
- * Each adapter (cursor.mjs, copilot-chat.mjs, antigravity.mjs, codex.mjs)
- * consumes the same source tree under `pipeline/skills/` and `pipeline/rules/`
- * and emits its own format. This module owns the shared mechanics: SKILL.md
- * parsing, frontmatter mapping, platform glob inference, the install/uninstall
- * file-loop factories, MCP config merging, and the
- * `<!-- multi-agent-pipeline:begin/end -->` marker pair used to scope
- * pipeline-managed content inside user-owned files.
- *
- * Zero runtime deps (ADR-4). Pure ES module.
- *
- * @module pipeline/adapters/_base
- */
-
-import {
-  cpSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  readdirSync,
-  rmSync,
-  writeFileSync,
-} from "fs";
-import { homedir } from "os";
-import { join, relative } from "path";
-import { DEV_ONLY_SCRIPTS } from "../../install/_dev-only-files.mjs";
-
-/**
- * Pipeline-managed block markers. Anything between BEGIN and END inside a
- * user-owned file is owned by this installer and may be replaced/removed.
- * Content outside the markers is preserved on uninstall.
- */
-export const MARKER_BEGIN = "<!-- multi-agent-pipeline:begin -->";
-export const MARKER_END = "<!-- multi-agent-pipeline:end -->";
-
-/**
- * Parse a YAML-ish frontmatter block from a SKILL.md file. The pipeline's
- * frontmatter is intentionally narrow (no nested mappings inside list values,
- * no anchors), so a regex parser is sufficient and avoids a YAML dep.
- *
- * @param {string} raw - file contents
- * @returns {{ frontmatter: Record<string, string>, body: string }}
- */
-export function parseFrontmatter(raw) {
-  const match = /^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/.exec(raw);
-  if (!match) return { frontmatter: {}, body: raw };
-  const [, fmBlock, body] = match;
-  const fm = {};
-  for (const line of fmBlock.split("\n")) {
-    const kv = /^([a-zA-Z][\w-]*)\s*:\s*(.*)$/.exec(line);
-    if (!kv) continue;
-    let val = kv[2].trim();
-    if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
-      val = val.slice(1, -1);
-    }
-    fm[kv[1]] = val;
-  }
-  return { frontmatter: fm, body: body.trimStart() };
-}
-
-/**
- * Default skill source dirs (relative to `pipeline/skills/`) consumed by the
- * adapters. Order matters: it drives per-file write order and the section
- * order inside concatenated digests.
- */
-export const DEFAULT_SKILL_SOURCES = Object.freeze([
-  "shared/core",
-  "shared/external",
-  "figma-ios",
-  "figma-android",
-  "figma-common",
-]);
-
-/**
- * Walk a skills root and yield every SKILL.md found one directory deep. The
- * pipeline tree is shallow on purpose (one dir per skill, body inside), so a
- * one-level scan covers shared/core, shared/external, figma-{ios,android,common}.
- *
- * @param {string} skillsRoot
- * @returns {Array<{ name: string, srcPath: string, frontmatter: Record<string, string>, body: string }>}
- */
-export function walkSkills(skillsRoot) {
-  const out = [];
-  if (!existsSync(skillsRoot)) return out;
-  for (const entry of readdirSync(skillsRoot, { withFileTypes: true })) {
-    if (!entry.isDirectory()) continue;
-    const skillFile = join(skillsRoot, entry.name, "SKILL.md");
-    if (!existsSync(skillFile)) continue;
-    const raw = readFileSync(skillFile, "utf-8");
-    const { frontmatter, body } = parseFrontmatter(raw);
-    out.push({
-      name: frontmatter.name || entry.name,
-      srcPath: skillFile,
-      frontmatter,
-      body,
-    });
-  }
-  return out;
-}
-
-/**
- * Infer a Cursor-style globs string from a skill name. Mirrors the prefix
- * heuristic in `install.js#classifyExternalSkill` so the two stay in sync,
- * but returns globs instead of a coarse platform tag.
- *
- * Skills that don't match a known prefix get null (= no globs, = always-on
- * eligible). The adapter decides whether null means alwaysApply or just
- * description-only.
- *
- * @param {string} skillName
- * @returns {string | null}
- */
-export function inferGlobs(skillName) {
-  const lower = skillName.toLowerCase();
-  if (lower.startsWith("multi-agent")) return null;
-  if (
-    lower.startsWith("swiftui") ||
-    lower.startsWith("swift") ||
-    lower.startsWith("ios") ||
-    lower.startsWith("apple-") ||
-    lower === "alarmkit" ||
-    lower === "callkit-voip" ||
-    lower === "cloudkit-sync" ||
-    lower === "core-bluetooth" ||
-    lower === "core-motion" ||
-    lower === "core-nfc" ||
-    lower === "coreml" ||
-    lower === "eventkit-calendar" ||
-    lower === "healthkit" ||
-    lower === "homekit-matter" ||
-    lower === "live-activities" ||
-    lower === "mapkit-location" ||
-    lower === "musickit-audio" ||
-    lower === "passkit-wallet" ||
-    lower === "pencilkit-drawing" ||
-    lower === "permissionkit" ||
-    lower === "realitykit-ar" ||
-    lower === "speech-recognition" ||
-    lower === "storekit" ||
-    lower === "tipkit" ||
-    lower === "vision-framework" ||
-    lower === "weatherkit" ||
-    lower === "widgetkit" ||
-    lower === "natural-language" ||
-    lower === "authentication" ||
-    lower === "background-processing" ||
-    lower === "contacts-framework" ||
-    lower === "device-integrity" ||
-    lower === "debugging-instruments" ||
-    lower === "energykit" ||
-    lower === "metrickit-diagnostics" ||
-    lower === "shareplay-activities" ||
-    lower === "photos-camera-media" ||
-    lower === "push-notifications" ||
-    lower === "swiftdata" ||
-    lower === "swiftdata-pro" ||
-    lower === "app-clips" ||
-    lower === "app-intents" ||
-    lower === "app-store-changelog" ||
-    lower === "app-store-review" ||
-    lower === "app-store-optimization" ||
-    lower.startsWith("hig-") ||
-    lower.startsWith("macos-") ||
-    lower.startsWith("apple-")
-  ) {
-    return "**/*.swift";
-  }
-  if (
-    lower.startsWith("android") ||
-    lower.startsWith("kotlin") ||
-    lower.startsWith("jetpack") ||
-    lower.startsWith("compose") ||
-    lower === "room-database" ||
-    lower === "retrofit-networking" ||
-    lower === "gradle-kotlin-dsl" ||
-    lower === "play-store-review" ||
-    lower === "google-play-compliance"
-  ) {
-    return "**/*.{kt,kts}";
-  }
-  if (lower === "react-best-practices" || lower === "nextjs-app-router") return "**/*.{tsx,ts,jsx,js}";
-  if (lower === "vue-composition") return "**/*.{vue,ts,js}";
-  if (lower === "tailwind-css" || lower === "css-modern") return "**/*.{css,scss,tsx,jsx,vue,html}";
-  if (lower === "html-semantic") return "**/*.html";
-  if (lower === "typescript-patterns") return "**/*.{ts,tsx}";
-  if (lower === "python-patterns" || lower === "fastapi-pro") return "**/*.py";
-  if (lower === "nodejs-backend-patterns") return "**/*.{js,mjs,ts}";
-  return null;
-}
-
-/**
- * Replace (or insert) a pipeline-managed block inside a user-owned file.
- * If the file does not exist, write it with just the block. If it exists
- * and contains a marker pair, replace between them. Otherwise, append.
- *
- * @param {string} filePath
- * @param {string} blockBody - content WITHOUT the marker lines
- * @param {object} [opts]
- * @param {string} [opts.beforeBlockText] - content prepended ABOVE the markers when creating new file
- * @param {{ begin: string, end: string }} [opts.markers] - alternative marker pair
- *   for formats that can't host HTML comments (e.g. `#`-comment markers in TOML)
- */
-export function replaceManagedBlock(filePath, blockBody, opts = {}) {
-  const begin = opts.markers ? opts.markers.begin : MARKER_BEGIN;
-  const end = opts.markers ? opts.markers.end : MARKER_END;
-  const wrapped = `${begin}\n${blockBody.trim()}\n${end}`;
-  if (!existsSync(filePath)) {
-    const header = opts.beforeBlockText ? `${opts.beforeBlockText.trimEnd()}\n\n` : "";
-    writeFileSync(filePath, `${header}${wrapped}\n`);
-    return "created";
-  }
-  const existing = readFileSync(filePath, "utf-8");
-  const re = new RegExp(`${escapeRegex(begin)}[\\s\\S]*?${escapeRegex(end)}`, "m");
-  if (re.test(existing)) {
-    writeFileSync(filePath, existing.replace(re, wrapped));
-    return "replaced";
-  }
-  writeFileSync(filePath, `${existing.trimEnd()}\n\n${wrapped}\n`);
-  return "appended";
-}
-
-/**
- * Remove a pipeline-managed block from a user-owned file. If the file becomes
- * empty (or whitespace-only) after removal, the file is deleted entirely.
- *
- * @param {string} filePath
- * @param {object} [opts]
- * @param {{ begin: string, end: string }} [opts.markers] - alternative marker pair
- * @returns {"removed" | "removed-and-deleted-empty-file" | "missing" | "no-marker"}
- */
-export function removeManagedBlock(filePath, opts = {}) {
-  const begin = opts.markers ? opts.markers.begin : MARKER_BEGIN;
-  const end = opts.markers ? opts.markers.end : MARKER_END;
-  if (!existsSync(filePath)) return "missing";
-  const existing = readFileSync(filePath, "utf-8");
-  const re = new RegExp(
-    `\\s*${escapeRegex(begin)}[\\s\\S]*?${escapeRegex(end)}\\s*`,
-    "m",
-  );
-  if (!re.test(existing)) return "no-marker";
-  const cleaned = existing.replace(re, "\n").trim();
-  if (cleaned.length === 0) {
-    rmSync(filePath, { force: true });
-    return "removed-and-deleted-empty-file";
-  }
-  writeFileSync(filePath, cleaned + "\n");
-  return "removed";
-}
-
-/**
- * Concatenate a list of skill bodies into a single document, with each skill
- * preceded by a heading line. Used by adapters that emit a single rules file
- * (windsurf) instead of one-file-per-skill (cursor / cline).
- *
- * @param {Array<{ name: string, frontmatter: Record<string, string>, body: string }>} skills
- * @returns {string}
- */
-export function concatSkills(skills) {
-  const parts = [];
-  for (const skill of skills) {
-    const desc = skill.frontmatter.description || "";
-    parts.push(`## ${skill.name}`);
-    if (desc) parts.push(`> ${desc}`);
-    parts.push("");
-    parts.push(skill.body.trim());
-    parts.push("");
-  }
-  return parts.join("\n");
-}
-
-/**
- * Filter the multi-agent-* core skills out of a skill list. Used by tools
- * that don't have slash-command infrastructure (cursor / windsurf / cline)  - 
- * the orchestration commands aren't invocable there, so shipping them as
- * rules just bloats context. Tools get the knowledge layer (rules + external
- * skills) but not the dispatch layer.
- *
- * @template {{ name: string }} T
- * @param {Array<T>} skills
- * @returns {Array<T>}
- */
-export function withoutOrchestrationSkills(skills) {
-  return skills.filter((s) => !s.name.startsWith("multi-agent"));
-}
-
-/**
- * Collect every skill under `pipeline/skills/` and narrow it to the requested
- * platform. The glob heuristic from `inferGlobs` decides platform membership:
- * skills with no inferred globs are generic and always included.
- *
- * @param {string} pipelineSrc
- * @param {"all"|"ios"|"android"} [platformFilter]
- * @param {object} [opts]
- * @param {string[]} [opts.sources] - source dirs relative to `pipeline/skills/`;
- *   order drives output order (defaults to DEFAULT_SKILL_SOURCES)
- * @returns {Array<{ name: string, srcPath: string, frontmatter: Record<string, string>, body: string }>}
- */
-export function collectSkills(pipelineSrc, platformFilter = "all", opts = {}) {
-  const skillsRoot = join(pipelineSrc, "skills");
-  const sources = opts.sources || DEFAULT_SKILL_SOURCES;
-  const all = [];
-  for (const src of sources) all.push(...walkSkills(join(skillsRoot, ...src.split("/"))));
-  if (platformFilter === "all") return all;
-  return all.filter((s) => {
-    const globs = inferGlobs(s.name);
-    if (globs == null) return true; // generic / orchestration → always include
-    if (platformFilter === "ios") return globs.includes("swift");
-    if (platformFilter === "android") return globs.includes("kt");
-    return true;
-  });
-}
-
-/**
- * Walk the pipeline rules tree (`pipeline/rules/*.md`) and yield each rule's
- * name (filename without extension) and raw body.
- *
- * @param {string} pipelineSrc
- * @returns {Array<{ name: string, body: string }>}
- */
-export function walkRules(pipelineSrc) {
-  const rulesSrc = join(pipelineSrc, "rules");
-  const out = [];
-  if (!existsSync(rulesSrc)) return out;
-  for (const entry of readdirSync(rulesSrc, { withFileTypes: true })) {
-    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-    out.push({
-      name: entry.name.replace(/\.md$/, ""),
-      body: readFileSync(join(rulesSrc, entry.name), "utf-8"),
-    });
-  }
-  return out;
-}
-
-/**
- * Render the AGENTS.md-style skill index block: a title, an intro quote, and
- * one bullet per skill. Used by the adapters that ship a context file instead
- * of per-skill rule files (antigravity, codex).
- *
- * @param {{ title: string, intro: string[], skills: Array<{ name: string, frontmatter: Record<string, string> }> }} opts
- * @returns {string}
- */
-export function renderSkillIndex({ title, intro, skills }) {
-  const parts = [title, "", ...intro, "", "## Skills (knowledge index)", ""];
-  for (const s of skills) {
-    const desc = (s.frontmatter.description || "").replace(/\s+/g, " ").trim();
-    parts.push(`- **${s.name}**${desc ? ` - ${desc}` : ""}`);
-  }
-  parts.push("");
-  return parts.join("\n");
-}
-
-/**
- * Write one rendered file per item into `outDir` (created if missing).
- * The shared install loop behind every per-skill / per-rule emit.
- *
- * @template T
- * @param {{ outDir: string, items: T[], fileFor: (item: T) => string, render: (item: T) => string }} opts
- * @returns {number} files written
- */
-export function installAdapterFiles({ outDir, items, fileFor, render }) {
-  ensureDir(outDir);
-  let written = 0;
-  for (const item of items) {
-    writeFileSync(join(outDir, fileFor(item)), render(item));
-    written++;
-  }
-  return written;
-}
-
-/**
- * Transform every pipeline persona (`pipeline/agents/*.md`) into a
- * platform-specific agent file, plus the cross-vendor second reviewer next to
- * `code-reviewer` (the platforms support distinct per-agent models, so a
- * second reviewer pinned to a different vendor restores 2-model review).
- *
- * @param {{
- *   pipelineSrc: string,
- *   outDir: string,
- *   prefix: string,
- *   fileFor: (name: string) => string,
- *   render: (persona: string, frontmatter: Record<string, string>, body: string, opts: object) => string,
- *   primaryOpts?: (persona: string) => object,
- *   crossReviewer?: object,
- * }} opts
- * @returns {{ agents: number, names: string[] }}
- */
-export function installPersonaAgents({ pipelineSrc, outDir, prefix, fileFor, render, primaryOpts, crossReviewer }) {
-  ensureDir(outDir);
-  const personaDir = join(pipelineSrc, "agents");
-  const names = [];
-  if (!existsSync(personaDir)) return { agents: 0, names };
-  for (const entry of readdirSync(personaDir, { withFileTypes: true })) {
-    if (!entry.isFile() || !entry.name.endsWith(".md")) continue;
-    const persona = entry.name.replace(/\.md$/, "");
-    const { frontmatter, body } = parseFrontmatter(readFileSync(join(personaDir, entry.name), "utf-8"));
-    writeFileSync(
-      join(outDir, fileFor(persona)),
-      render(persona, frontmatter, body, primaryOpts ? primaryOpts(persona) : {}),
-    );
-    names.push(`${prefix}${persona}`);
-    if (persona === "code-reviewer" && crossReviewer) {
-      writeFileSync(join(outDir, fileFor("code-reviewer-x")), render(persona, frontmatter, body, crossReviewer));
-      names.push(`${prefix}code-reviewer-x`);
-    }
-  }
-  return { agents: names.length, names };
-}
-
-/**
- * Remove a dir if (and only if) it is empty. Never touches user content.
- * @param {string} dir
- */
-export function removeDirIfEmpty(dir) {
-  try {
-    if (existsSync(dir) && readdirSync(dir).length === 0) rmSync(dir, { recursive: true, force: true });
-  } catch {
-    /* non-fatal */
-  }
-}
-
-/**
- * Remove every `<prefix>*<suffix>` file in `dir`, then drop the dir itself if
- * it ended up empty. The shared uninstall loop behind every per-skill /
- * per-rule / per-agent emit.
- *
- * @param {string} dir
- * @param {string} prefix
- * @param {string} suffix
- * @returns {number} files removed
- */
-export function removePrefixedFiles(dir, prefix, suffix) {
-  let removed = 0;
-  if (!existsSync(dir)) return removed;
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    if (!entry.isFile()) continue;
-    if (entry.name.startsWith(prefix) && entry.name.endsWith(suffix)) {
-      rmSync(join(dir, entry.name), { force: true });
-      removed++;
-    }
-  }
-  removeDirIfEmpty(dir);
-  return removed;
-}
-
-/**
- * Remove a single pipeline-owned file, then optionally prune its parent dir
- * when empty.
- *
- * @param {string} filePath
- * @param {string} [pruneDir]
- * @returns {number} 1 if the file existed and was removed, else 0
- */
-export function removeFileAndPrune(filePath, pruneDir) {
-  let removed = 0;
-  if (existsSync(filePath)) {
-    rmSync(filePath, { force: true });
-    removed = 1;
-  }
-  if (pruneDir) removeDirIfEmpty(pruneDir);
-  return removed;
-}
-
-/**
- * Register the dev-toolkit MCP server inside a JSON MCP config, merging into
- * the user's existing servers (never clobbering them). `rootKey` follows the
- * platform schema: `mcpServers` (Cursor, Antigravity) or `servers` (VS Code).
- *
- * @param {string} mcpPath
- * @param {object} [opts]
- * @param {string} [opts.rootKey]
- * @returns {"created" | "merged" | "skipped"}
- */
-export function mergeMcpJson(mcpPath, opts = {}) {
-  const rootKey = opts.rootKey || "mcpServers";
-  const entry = { command: "npx", args: ["-y", "@mmerterden/dev-toolkit-mcp"] };
-  ensureDir(join(mcpPath, ".."));
-  if (!existsSync(mcpPath)) {
-    writeFileSync(mcpPath, JSON.stringify({ [rootKey]: { "dev-toolkit": entry } }, null, 2) + "\n");
-    return "created";
-  }
-  let cfg;
-  try {
-    cfg = JSON.parse(readFileSync(mcpPath, "utf-8"));
-  } catch {
-    return "skipped";
-  }
-  cfg[rootKey] = cfg[rootKey] || {};
-  cfg[rootKey]["dev-toolkit"] = entry;
-  writeFileSync(mcpPath, JSON.stringify(cfg, null, 2) + "\n");
-  return "merged";
-}
-
-/**
- * Remove only OUR dev-toolkit entry from a JSON MCP config; the user's other
- * servers (and the file) survive. The file is deleted only when it held
- * nothing but our entry.
- *
- * @param {string} mcpPath
- * @param {object} [opts]
- * @param {string} [opts.rootKey]
- */
-export function unmergeMcpJson(mcpPath, opts = {}) {
-  const rootKey = opts.rootKey || "mcpServers";
-  if (!existsSync(mcpPath)) return;
-  let cfg;
-  try {
-    cfg = JSON.parse(readFileSync(mcpPath, "utf-8"));
-  } catch {
-    return;
-  }
-  if (cfg[rootKey] && cfg[rootKey]["dev-toolkit"]) {
-    delete cfg[rootKey]["dev-toolkit"];
-    if (Object.keys(cfg[rootKey]).length === 0) {
-      rmSync(mcpPath, { force: true });
-      return;
-    }
-    writeFileSync(mcpPath, JSON.stringify(cfg, null, 2) + "\n");
-  }
-}
-
-/**
- * JSON-quote a frontmatter value (descriptions may contain `:` or quotes).
- * @param {string} s
- */
-export function jsonString(s) {
-  return JSON.stringify(s);
-}
-
-/**
- * Ensure a directory exists. Recursive.
- * @param {string} dir
- */
-export function ensureDir(dir) {
-  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-}
-
-/**
- * Return the relative path of `child` against `parent` for log output.
- * @param {string} parent
- * @param {string} child
- */
-export function rel(parent, child) {
-  try {
-    return relative(parent, child) || child;
-  } catch {
-    return child;
-  }
-}
-
-function escapeRegex(s) {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-/**
- * Cross-vendor reviewer model lineup per adapter platform. The pipeline's value
- * is multi-model review (Claude Code = Opus + Sonnet; Copilot CLI adds GPT-5.4).
- * The adapter platforms support distinct per-agent models, so we emit a SECOND
- * reviewer agent pinned to a different vendor to restore cross-model diversity.
- *
- * Model strings drift as platforms ship new versions - treat this like
- * cost-table.json and update it when the platforms' pickers change. Verified
- * mid-2026 against each platform's model docs.
- *
- * Cursor: per-agent `model:` takes a model ID; the exact Claude slug is not
- * published (docs only give `gpt-5.5` / `composer-2`), so the PRIMARY reviewer
- * stays `inherit` (the user's selected model, usually Claude) and the SECONDARY
- * pins `gpt-5.5` - that yields two vendors without guessing the Claude slug.
- * Copilot Chat: frontmatter `model:` takes the picker LABEL verbatim (confirmed).
- * Antigravity: model is chosen in the side-panel UI, not a file - so its
- * workflow only NAMES the recommended diverse pair; it cannot pin them.
- */
-export const REVIEWER_MODELS = Object.freeze({
-  cursor: { primary: "inherit", crossModel: "gpt-5.5" },
-  copilotChat: { primary: "Claude Opus 4.8", crossModel: "GPT-5.5" },
-  antigravity: { primary: "Gemini 3 Pro", crossModel: "Claude Opus 4.6" },
-  codex: { primary: "GPT-5.5-Codex", crossModel: "Claude Opus 4.8" },
-});
-
-/**
- * Shared cross-platform runtime root. The non-native adapters (Cursor,
- * Antigravity, VS Code Copilot Chat) have no user-global skills dir like
- * `~/.claude` / `~/.copilot`, so the pipeline's deterministic-gate scripts are
- * installed once here and the emitted agents/commands reference them by
- * absolute path. This is what lets the gates actually EXECUTE on those
- * platforms instead of degrading to advisory.
- */
-export function sharedRuntimeRoot() {
-  return join(homedir(), ".multi-agent");
-}
-
-/**
- * Copy scripts/ + lib/ + schemas/ into the shared runtime root, excluding
- * dev-only files (the figma scrub map, the personal-data scanners). Idempotent.
- * @param {string} pipelineSrc
- * @returns {{ root: string, trees: string[] }}
- */
-export function installSharedRuntime(pipelineSrc) {
-  const root = sharedRuntimeRoot();
-  const trees = [];
-  for (const sub of ["scripts", "lib", "schemas"]) {
-    const src = join(pipelineSrc, sub);
-    if (!existsSync(src)) continue;
-    const dest = join(root, sub);
-    ensureDir(dest);
-    cpSync(src, dest, {
-      recursive: true,
-      // Never copy a dev-only / PII-bearing file into the shared runtime.
-      filter: (s) => !DEV_ONLY_SCRIPTS.includes(s.split(/[\\/]/).pop()),
-    });
-    trees.push(sub);
-  }
-  return { root, trees };
-}
-
-/**
- * Remove the shared runtime root. The tree is 100% pipeline-owned, so a full
- * recursive remove is safe.
- * @returns {boolean} true if anything was removed
- */
-export function uninstallSharedRuntime() {
-  const root = sharedRuntimeRoot();
-  if (!existsSync(root)) return false;
-  rmSync(root, { recursive: true, force: true });
-  return true;
-}
-
-/**
- * Rewrite logical `pipeline/scripts/...` and `pipeline/lib/...` references in an
- * emitted agent/command/workflow body to the absolute shared-runtime path, so
- * they resolve from any working directory on the adapter platforms.
- * @param {string} body
- * @returns {string}
- */
-export function rewriteScriptRefs(body) {
-  return String(body)
-    .replace(/pipeline\/scripts\//g, "$HOME/.multi-agent/scripts/")
-    .replace(/pipeline\/lib\//g, "$HOME/.multi-agent/lib/");
-}