agy-plugin-porter 0.0.0-stage → 0.2.0

package/lib/transpiler-engine.mjs

@@ -0,0 +1,190 @@
+// detect -> stage -> compile -> audit -> write. For Claude Code and Gemini CLI
+// sources, staging is `agy plugin install` run against a throwaway home, and
+// the porter post-processes what agy staged (docs/agy-baseline.md). Cursor,
+// Roo/Kilo and Codex sources, which agy doesn't detect, start from an empty
+// plugin dir. agy only ever runs with HOME/USERPROFILE pointed at a temp dir,
+// so the user's real profile is never read or written.
+import { spawnSync } from 'node:child_process';
+import { cpSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, realpathSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { basename, join, resolve, sep } from 'node:path';
+
+import { detect } from './detector.mjs';
+import { compileHooks, writeHookPort } from './hook-compiler.mjs';
+import { sanitizeManifest, sourceManifest } from './manifest-sanitizer.mjs';
+import { compileMods, userConfigDefaults } from './mod-compiler.mjs';
+import { compileModes } from './mode-compiler.mjs';
+import { compileRules } from './rules-compiler.mjs';
+import { compileSkills, slugifyName } from './skill-compiler.mjs';
+import { removeTree } from './source.mjs';
+import { auditPlugin } from './static-auditor.mjs';
+
+const AGY_STAGED = ['claude', 'gemini'];
+
+export function throwawayEnv(home) {
+  return { ...process.env, HOME: home, USERPROFILE: home, NO_COLOR: '1' };
+}
+
+// Spawns agy. An `agy` that names a .mjs/.js file runs under this Node (tests use a stand-in).
+export function spawnAgy(agy, args, options) {
+  return /\.m?js$/i.test(agy) ? spawnSync(process.execPath, [agy, ...args], options) : spawnSync(agy, args, options);
+}
+
+export function runAgy(args, { agy = 'agy', home }) {
+  const run = spawnAgy(agy, args, { encoding: 'utf8', env: throwawayEnv(home), timeout: 120_000 });
+  if (run.error) throw new Error(`can't run ${agy}: ${run.error.message}`);
+  return run;
+}
+
+// Runs `agy plugin install <srcDir>` in a throwaway home and returns the staged dir.
+export function stageWithAgy(srcDir, { agy, workDir }) {
+  const home = join(workDir, 'home');
+  mkdirSync(home, { recursive: true });
+  const run = runAgy(['plugin', 'install', srcDir], { agy, home });
+  const pluginsDir = join(home, '.gemini', 'config', 'plugins');
+  const staged = existsSync(pluginsDir) ? readdirSync(pluginsDir).filter((d) => statSync(join(pluginsDir, d)).isDirectory()) : [];
+  if (run.status !== 0 || staged.length !== 1) {
+    throw new Error(`agy plugin install failed (exit ${run.status}): ${(run.stdout + run.stderr).trim()}`);
+  }
+  return join(pluginsDir, staged[0]);
+}
+
+const removeEmptyDirs = (dir) => {
+  for (const entry of readdirSync(dir)) {
+    const full = join(dir, entry);
+    if (statSync(full).isDirectory()) {
+      removeEmptyDirs(full);
+      if (readdirSync(full).length === 0) rmSync(full, { recursive: true });
+    }
+  }
+};
+
+const merge = (into, part) => {
+  into.ported.push(...part.ported);
+  into.unported.push(...part.unported);
+  into.warnings.push(...part.warnings);
+};
+
+export function defaultSlug(srcDir, ecosystems) {
+  const name = sourceManifest(srcDir, ecosystems).name;
+  return slugifyName(typeof name === 'string' && name ? name : basename(resolve(srcDir)));
+}
+
+function makeCopyFilter(rootDir, skipRe) {
+  let rootReal = '';
+  try { rootReal = realpathSync(rootDir); } catch { rootReal = resolve(rootDir); }
+  return (p) => {
+    if (skipRe.test(p)) return false;
+    try {
+      const lst = lstatSync(p);
+      if (lst.isSymbolicLink()) {
+        const targetReal = realpathSync(p);
+        if (targetReal !== rootReal && !targetReal.startsWith(rootReal + sep)) return false;
+      }
+    } catch {
+      return false;
+    }
+    return true;
+  };
+}
+
+// Ports srcDir into outDir. Returns the port report. `esbuild` overrides the optional
+// esbuild the mod compiler loads for TS/TSX mods (null: act as if it's missing).
+export function transpile({ srcDir, outDir, slug, agy = 'agy', force = false, validate = false, esbuild }) {
+  srcDir = resolve(srcDir);
+  const detection = detect(srcDir);
+  const { ecosystems } = detection;
+  if (ecosystems.length === 0) throw new Error(`no plugin found in ${srcDir} (looked for Claude Code, Gemini CLI, Cursor, Roo/Kilo, Codex and Antigravity layouts)`);
+  slug = slug ?? defaultSlug(srcDir, ecosystems);
+  if (!/^[a-z0-9][a-z0-9._-]*$/.test(slug)) throw new Error(`invalid slug "${slug}": use lowercase letters, digits, ".", "_" and "-"`);
+  outDir = resolve(outDir);
+  if (existsSync(outDir) && readdirSync(outDir).length && !force) throw new Error(`${outDir} isn't empty (pass force to replace it)`);
+
+  const report = { slug, ecosystems, ported: [], unported: [], warnings: [], flags: [], tier: null, tierReasons: [] };
+  const workDir = mkdtempSync(join(tmpdir(), 'agy-porter-'));
+  try {
+    const pluginDir = join(workDir, 'plugin');
+    const stagedPaths = [];
+    if (ecosystems.includes('antigravity')) {
+      cpSync(srcDir, pluginDir, { recursive: true, filter: makeCopyFilter(srcDir, /[\\/](\.git|node_modules)$/) });
+      report.ported.push('native plugin (copied as is)');
+    } else if (ecosystems.some((e) => AGY_STAGED.includes(e))) {
+      let stageFrom = srcDir;
+      if (detection.manifestless) {
+        // agy only detects Claude plugins by their manifest, so stage a copy with one.
+        stageFrom = join(workDir, 'src');
+        cpSync(srcDir, stageFrom, { recursive: true, filter: makeCopyFilter(srcDir, /[\\/](\.git|node_modules)$/) });
+        mkdirSync(join(stageFrom, '.claude-plugin'));
+        writeFileSync(join(stageFrom, '.claude-plugin', 'plugin.json'), JSON.stringify({ name: slug }));
+        report.warnings.push('no .claude-plugin/plugin.json: ported as a Claude Code plugin from its default folders');
+      }
+      const staged = stageWithAgy(stageFrom, { agy, workDir });
+      // agy may write the resolved path (macOS /var -> /private/var, Windows 8.3 names).
+      stagedPaths.push(...new Set([staged, realpathSync.native(staged)]));
+      cpSync(staged, pluginDir, { recursive: true, filter: makeCopyFilter(staged, /[\\/]\.git$/) });
+    } else {
+      mkdirSync(pluginDir);
+    }
+
+    if (!ecosystems.includes('antigravity')) {
+      merge(report, sanitizeManifest(pluginDir, { srcDir, ecosystems, slug, stagedPaths }));
+      const hooks = compileHooks(detection.hookSources, { slug });
+      writeHookPort(pluginDir, hooks);
+      merge(report, hooks.report);
+      // UI mods become sidecars (it merges its hooks into hooks.json, so it runs after
+      // writeHookPort). The raw module files agy staged are dropped either way.
+      if (detection.uiMods.length) {
+        const manifest = sourceManifest(srcDir, ecosystems);
+        merge(report, compileMods(detection.uiMods, {
+          srcDir, pluginDir, slug, esbuild,
+          sourceName: typeof manifest.name === 'string' ? manifest.name : slug,
+          title: typeof manifest.displayName === 'string' ? manifest.displayName : undefined,
+          version: typeof manifest.version === 'string' ? manifest.version : undefined,
+          options: userConfigDefaults(manifest.userConfig),
+        }));
+        if (typeof manifest.types === 'string') rmSync(join(pluginDir, manifest.types), { force: true });
+      }
+      merge(report, compileSkills(pluginDir, { srcDir, ecosystems }));
+      merge(report, compileRules(pluginDir, { srcDir, ecosystems }));
+      merge(report, compileModes(pluginDir, { srcDir, ecosystems, slug }));
+      removeEmptyDirs(pluginDir);
+    }
+
+    const audit = auditPlugin(pluginDir);
+    report.flags = audit.flags;
+    report.warnings.push(...audit.warnings);
+    report.tier = audit.tier;
+    report.tierReasons = audit.reasons;
+
+    removeTree(outDir);
+    mkdirSync(outDir, { recursive: true });
+    cpSync(pluginDir, outDir, { recursive: true });
+    if (validate) report.validation = validateWithAgy(outDir, { agy, workDir });
+    return report;
+  } finally {
+    removeTree(workDir);
+  }
+}
+
+// `agy plugin validate --json` in a throwaway home.
+export function validateWithAgy(pluginDir, { agy = 'agy', workDir } = {}) {
+  const ownDir = !workDir;
+  const dir = workDir ?? mkdtempSync(join(tmpdir(), 'agy-porter-validate-'));
+  const home = join(dir, 'validate-home');
+  mkdirSync(home, { recursive: true });
+  try {
+    const run = runAgy(['plugin', 'validate', pluginDir, '--json'], { agy, home });
+    let result = null;
+    try { result = JSON.parse(run.stdout); } catch {}
+    if (!result) return { ok: false, errors: [], warnings: [], output: (run.stdout + run.stderr).trim() };
+    const findings = result.findings ?? [];
+    return {
+      ok: run.status === 0,
+      components: result.components,
+      errors: findings.filter((f) => f.severity === 'error'),
+      warnings: findings.filter((f) => f.severity === 'warning'),
+    };
+  } finally {
+    if (ownDir) removeTree(dir);
+  }
+}

package/lib/yaml-lite.mjs

@@ -0,0 +1,222 @@
+// A YAML subset, enough for Markdown frontmatter and `.roomodes`: block maps and
+// sequences, flow `[a, b]` / `{k: v}` (on one line or several), quoted and plain scalars, `|` / `>` block
+// scalars, multi-line plain scalars and comments. Anchors, tags and multiple
+// documents are not supported. Like agy's loader, it tolerates `: ` inside an
+// unquoted value (`description: Runs checks: lint`).
+
+const KEY = /^("(?:[^"\\]|\\.)*"|'(?:[^']|'')*'|[^\s"'#\-[{][^:#]*?|-[^\s:#][^:#]*?)\s*:(?=\s|$)/;
+const UNSAFE_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+
+function unquote(s) {
+  if (s.startsWith('"')) {
+    try { return JSON.parse(s); } catch { return s.slice(1, -1); }
+  }
+  if (s.startsWith("'")) return s.slice(1, -1).replace(/''/g, "'");
+  return s;
+}
+
+function stripComment(s) {
+  let quote = null;
+  for (let i = 0; i < s.length; i++) {
+    const c = s[i];
+    if (quote) {
+      if (c === quote && !(quote === '"' && s[i - 1] === '\\')) quote = null;
+    } else if (c === '"' || c === "'") {
+      if (i === 0 || /[\s[{,]/.test(s[i - 1])) quote = c;
+    } else if (c === '#' && (i === 0 || /\s/.test(s[i - 1]))) {
+      return s.slice(0, i).trimEnd();
+    }
+  }
+  return s;
+}
+
+function splitFlow(s) {
+  const parts = [];
+  let depth = 0;
+  let quote = null;
+  let start = 0;
+  for (let i = 0; i < s.length; i++) {
+    const c = s[i];
+    if (quote) { if (c === quote) quote = null; continue; }
+    if (c === '"' || c === "'") quote = c;
+    else if (c === '[' || c === '{') depth++;
+    else if (c === ']' || c === '}') depth--;
+    else if (c === ',' && depth === 0) { parts.push(s.slice(start, i)); start = i + 1; }
+  }
+  parts.push(s.slice(start));
+  return parts.map((p) => p.trim()).filter((p) => p !== '');
+}
+
+// True once every `[` and `{` outside quotes is closed.
+function flowClosed(s) {
+  let depth = 0;
+  let quote = null;
+  for (const c of s) {
+    if (quote) { if (c === quote) quote = null; continue; }
+    if (c === '"' || c === "'") quote = c;
+    else if (c === '[' || c === '{') depth++;
+    else if (c === ']' || c === '}') depth--;
+  }
+  return depth <= 0;
+}
+
+export function parseScalar(raw) {
+  const s = stripComment(raw.trim());
+  if (s === '') return null;
+  if (s.startsWith('"') || s.startsWith("'")) return unquote(s);
+  if (s.startsWith('[') && s.endsWith(']')) return splitFlow(s.slice(1, -1)).map(parseScalar);
+  if (s.startsWith('{') && s.endsWith('}')) {
+    const obj = {};
+    for (const part of splitFlow(s.slice(1, -1))) {
+      const m = KEY.exec(part);
+      if (m) {
+        const k = unquote(m[1]);
+        if (!UNSAFE_KEYS.has(k)) obj[k] = parseScalar(part.slice(m[0].length));
+      }
+    }
+    return obj;
+  }
+  if (/^(true|True|TRUE)$/.test(s)) return true;
+  if (/^(false|False|FALSE)$/.test(s)) return false;
+  if (/^(null|Null|NULL|~)$/.test(s)) return null;
+  if (/^[-+]?\d+(\.\d+)?$/.test(s)) return Number(s);
+  return s;
+}
+
+export function parseYaml(text) {
+  const lines = String(text).replace(/^/, '').replace(/\r\n?/g, '\n').split('\n')
+    .map((raw) => ({ raw, indent: raw.match(/^ */)[0].length, text: raw.trim() }));
+  let i = 0;
+  if (lines[0]?.text === '---') i = 1;
+  const blank = (l) => l.text === '' || l.text.startsWith('#');
+  const skip = () => { while (i < lines.length && blank(lines[i])) i++; };
+  const isSeq = (t) => t === '-' || t.startsWith('- ');
+
+  function blockScalar(header, parentIndent) {
+    const folded = header.startsWith('>');
+    const chomp = header.includes('-') ? 'strip' : header.includes('+') ? 'keep' : 'clip';
+    const body = [];
+    while (i < lines.length && (lines[i].text === '' || lines[i].indent > parentIndent)) body.push(lines[i++]);
+    const first = body.find((l) => l.text !== '');
+    const ind = first ? first.indent : 0;
+    const rows = body.map((l) => (l.text === '' ? '' : l.raw.slice(ind)));
+    let out;
+    if (folded) {
+      out = '';
+      rows.forEach((row, k) => {
+        if (k === 0) out = row;
+        else if (row === '' || rows[k - 1] === '' || /^\s/.test(row)) out += `\n${row}`;
+        else out += ` ${row}`;
+      });
+      out = out.replace(/\n(?=\n)/g, '');
+    } else out = rows.join('\n');
+    const trimmed = out.replace(/\n+$/, '');
+    if (chomp === 'strip') return trimmed;
+    if (chomp === 'keep') return out.endsWith('\n') ? out : `${out}\n`;
+    return trimmed === '' ? '' : `${trimmed}\n`;
+  }
+
+  // A flow `[...]` or `{...}` that spans lines (`allowed-tools:\n  [\n "Read",\n ]`):
+  // joins lines until its brackets close.
+  function flowValue(first) {
+    let text = stripComment(first);
+    while (!flowClosed(text) && i < lines.length) text += ` ${stripComment(lines[i++].text)}`;
+    if (!flowClosed(text)) throw new Error(`yaml: unclosed ${text[0]} at the end of the document`);
+    return parseScalar(text);
+  }
+
+  // A value on the same line as its key or dash, with continuation lines for plain scalars.
+  function inlineValue(rest, indent) {
+    if (/^[|>][-+0-9]*$/.test(stripComment(rest))) return blockScalar(rest, indent);
+    if (/^[[{]/.test(rest) && !flowClosed(stripComment(rest))) return flowValue(rest);
+    const value = parseScalar(rest);
+    if (typeof value !== 'string' || /^["'[{]/.test(rest)) return value;
+    let joined = value;
+    while (i < lines.length && lines[i].text !== '' && lines[i].indent > indent && !KEY.test(lines[i].text) && !isSeq(lines[i].text)) {
+      joined += ` ${stripComment(lines[i++].text)}`;
+    }
+    return joined;
+  }
+
+  function node(indent) {
+    skip();
+    if (i >= lines.length || lines[i].indent < indent) return null;
+    if (/^[[{]/.test(lines[i].text)) return flowValue(lines[i++].text);
+    return isSeq(lines[i].text) ? seq(lines[i].indent) : map(lines[i].indent);
+  }
+
+  function seq(indent) {
+    const items = [];
+    for (skip(); i < lines.length && lines[i].indent === indent && isSeq(lines[i].text); skip()) {
+      const line = lines[i];
+      const rest = line.text.slice(1).trimStart();
+      if (rest === '' || rest.startsWith('#')) { i++; items.push(node(indent + 1)); continue; }
+      if (isSeq(rest) || KEY.test(rest)) {
+        // `- - x` or `- key: v`: reparse the rest as a node at its own column.
+        const col = line.raw.indexOf(rest, line.indent + 1);
+        lines[i] = { raw: ' '.repeat(col) + rest, indent: col, text: rest };
+        items.push(node(col));
+        continue;
+      }
+      i++;
+      items.push(inlineValue(rest, indent));
+    }
+    return items;
+  }
+
+  function map(indent) {
+    const obj = {};
+    for (skip(); i < lines.length && lines[i].indent === indent; skip()) {
+      const m = KEY.exec(lines[i].text);
+      if (!m) throw new Error(`yaml: can't parse line ${i + 1}: ${lines[i].text}`);
+      const key = unquote(m[1].trim());
+      const rest = lines[i].text.slice(m[0].length).trim();
+      i++;
+      if (rest === '' || rest.startsWith('#')) {
+        skip();
+        const next = lines[i];
+        const val = next && (next.indent > indent || (next.indent === indent && isSeq(next.text))) ? node(next.indent) : null;
+        if (!UNSAFE_KEYS.has(key)) obj[key] = val;
+      } else {
+        const val = inlineValue(rest, indent);
+        if (!UNSAFE_KEYS.has(key)) obj[key] = val;
+      }
+    }
+    return obj;
+  }
+
+  const result = node(0);
+  skip();
+  if (i < lines.length && lines[i].text !== '---') throw new Error(`yaml: unexpected indentation at line ${i + 1}`);
+  return result;
+}
+
+// Splits `---\n<yaml>\n---\n<body>`. Returns {data, body, hasFrontmatter}.
+export function splitFrontmatter(text) {
+  const src = String(text).replace(/^/, '').replace(/\r\n?/g, '\n');
+  const m = /^---\n([\s\S]*?\n)?---[ \t]*(?:\n|$)/.exec(src);
+  if (!m) return { data: {}, body: src, hasFrontmatter: false };
+  return { data: parseYaml(m[1] ?? '') ?? {}, body: src.slice(m[0].length), hasFrontmatter: true };
+}
+
+function scalar(value) {
+  if (typeof value === 'boolean' || typeof value === 'number') return String(value);
+  const s = String(value);
+  const plain = /^[A-Za-z0-9_./*][^\n:#]*$/.test(s) && s === s.trim()
+    && !/^(true|false|null|yes|no|on|off|~|[-+]?\d+(\.\d+)?)$/i.test(s) && !/[[\]{},&*!|>'"%@`]/.test(s[0]);
+  return plain ? s : JSON.stringify(s);
+}
+
+// Writes frontmatter from plain values; arrays become block lists, null/undefined are skipped.
+export function formatFrontmatter(data, body) {
+  const lines = ['---'];
+  for (const [key, value] of Object.entries(data)) {
+    if (value === undefined || value === null) continue;
+    if (Array.isArray(value)) {
+      lines.push(value.length ? `${key}:` : `${key}: []`);
+      value.forEach((v) => lines.push(`  - ${scalar(v)}`));
+    } else lines.push(`${key}: ${scalar(value)}`);
+  }
+  lines.push('---', '');
+  return `${lines.join('\n')}${body.replace(/^\n+/, '\n')}`;
+}

package/package.json

@@ -1,6 +1,75 @@
 {
   "name": "agy-plugin-porter",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Ports Claude Code, Gemini CLI, Cursor, Roo/Kilo and Codex plugins to native Antigravity plugins.",
+  "type": "module",
+  "license": "MIT",
+  "author": {
+    "name": "Arthur Cavallari",
+    "url": "https://github.com/arthurcavallari"
+  },
+  "homepage": "https://github.com/arthurcavallari/agy-plugin-porter#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/arthurcavallari/agy-plugin-porter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/arthurcavallari/agy-plugin-porter/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/arthurcavallari"
+  },
+  "keywords": [
+    "antigravity",
+    "google-antigravity",
+    "agy",
+    "agy-plugin",
+    "antigravity-plugin",
+    "claude-code",
+    "claude-code-plugin",
+    "gemini-cli",
+    "cursor",
+    "roo-code",
+    "codex",
+    "plugin-porter",
+    "hooks",
+    "mcp"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "agy-porter": "bin/agy-porter.mjs"
+  },
+  "optionalDependencies": {
+    "esbuild": "0.28.2"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "scripts/hook-shim.mjs",
+    "scripts/mod-runtime",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": "./lib/index.mjs",
+    "./consent": "./lib/consent.mjs",
+    "./detector": "./lib/detector.mjs",
+    "./hook-compiler": "./lib/hook-compiler.mjs",
+    "./manifest-sanitizer": "./lib/manifest-sanitizer.mjs",
+    "./mod-compiler": "./lib/mod-compiler.mjs",
+    "./skill-compiler": "./lib/skill-compiler.mjs",
+    "./rules-compiler": "./lib/rules-compiler.mjs",
+    "./mode-compiler": "./lib/mode-compiler.mjs",
+    "./static-auditor": "./lib/static-auditor.mjs",
+    "./transpiler-engine": "./lib/transpiler-engine.mjs",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "test": "node --test test/yaml-lite.test.mjs test/detector.test.mjs test/hook-compiler.test.mjs test/hook-shim.test.mjs test/compilers.test.mjs test/transpiler.test.mjs test/mod-scan.test.mjs test/mod-compiler.test.mjs test/mod-continuation.test.mjs test/mod-runtime.test.mjs test/mod-stage.test.mjs test/mod-e2e.test.mjs test/consent.test.mjs test/session-start.test.mjs test/plugin-build.test.mjs test/plugin-mcp.test.mjs test/cockpit.test.mjs",
+    "test:pack": "node scripts/pack-smoke.mjs",
+    "build:plugin": "node scripts/build-plugin.mjs"
+  }
+}