@ai-plugin-marketplace/core 0.1.0

package/dist/targets/cursor/validate.js

@@ -0,0 +1,181 @@
+/**
+ * Per-target validator for the Cursor target.
+ *
+ * Responsibilities (v0.1.0):
+ *   1. Manifest file refs resolve — checks that paths in .cursor-plugin/plugin.json
+ *      exist on disk with the correct type (directory for skills, .md for agents,
+ *      either for commands). Hooks refs are intentionally excluded: the hooks field
+ *      typically points at `hooks/claude.json`, which is a Claude-target generated
+ *      artifact and is not guaranteed to exist in a Cursor-only build context.
+ *   2. Cursor rule frontmatter — validates YAML frontmatter in rules/*.mdc files
+ *      against cursorRuleFrontmatterSchema. Files with no frontmatter block are
+ *      silently skipped.
+ *
+ * Cross-target concerns (envelope adherence, name consistency, MCP key sync,
+ * marketplace registration, freshness) are NOT checked here.
+ *
+ * @see packages/core/docs/specs/architecture.md §10 (validation contract)
+ * @see packages/core/docs/specs/architecture.md §8.1 (Finding, FindingCode)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+import { cursorPluginManifestSchema, cursorRuleFrontmatterSchema } from './schemas.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makeInvalid(plugin, message, hint) {
+    const finding = { severity: 'hard', code: 'schema-invalid', plugin, message };
+    if (hint !== undefined)
+        finding.hint = hint;
+    return finding;
+}
+/**
+ * Normalise a manifest field that may be a single string path, an array of
+ * string paths, or an inline object (which has no resolvable paths). Returns
+ * only the string path entries.
+ */
+function normalisePathField(value) {
+    if (value === undefined)
+        return [];
+    if (typeof value === 'string')
+        return [value];
+    if (Array.isArray(value))
+        return value.filter((v) => typeof v === 'string');
+    // Inline object (record of commands, inline hooks object) — no paths to check.
+    return [];
+}
+// ---------------------------------------------------------------------------
+// Manifest file-ref validation
+// ---------------------------------------------------------------------------
+function validateManifestFileRefs(pluginDir, pluginName) {
+    const manifestPath = path.join(pluginDir, '.cursor-plugin', 'plugin.json');
+    if (!fs.existsSync(manifestPath))
+        return [];
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    }
+    catch {
+        return [
+            makeInvalid(pluginName, `.cursor-plugin/plugin.json is not valid JSON`, 'Ensure the file is well-formed JSON.'),
+        ];
+    }
+    const parsed = cursorPluginManifestSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues.map((i) => i.message).join('; ');
+        return [
+            makeInvalid(pluginName, `.cursor-plugin/plugin.json failed schema validation: ${issues}`, 'Verify the manifest fields match the cursor plugin manifest schema.'),
+        ];
+    }
+    const manifest = parsed.data;
+    const findings = [];
+    // Ref groups: skills → directory, agents → .md file, commands → either.
+    // hooks is intentionally excluded — hooks/claude.json is a Claude-generated
+    // artifact and is not guaranteed present in a Cursor-only build context.
+    const refGroups = [
+        { field: 'skills', paths: normalisePathField(manifest.skills), mustBeDir: true },
+        { field: 'agents', paths: normalisePathField(manifest.agents), mustBeDir: false },
+        { field: 'commands', paths: normalisePathField(manifest.commands) },
+    ];
+    for (const { field, paths: refPaths, mustBeDir } of refGroups) {
+        for (const refPath of refPaths) {
+            // All manifest paths must start with "./"
+            if (!refPath.startsWith('./')) {
+                findings.push(makeInvalid(pluginName, `.cursor-plugin/plugin.json: ${field} path must start with "./": ${refPath}`, `Change the path to start with "./" (e.g. "./${refPath.replace(/^\/+/, '')}").`));
+                continue;
+            }
+            // Paths must not contain ".." segments (path traversal guard)
+            if (refPath.includes('..')) {
+                findings.push(makeInvalid(pluginName, `.cursor-plugin/plugin.json: ${field} path must not contain "..": ${refPath}`, 'Use a path relative to the plugin root without ".." traversal.'));
+                continue;
+            }
+            const resolved = path.join(pluginDir, refPath.slice(2));
+            if (!fs.existsSync(resolved)) {
+                findings.push(makeInvalid(pluginName, `.cursor-plugin/plugin.json: ${field} references non-existent path: ${refPath}`, `Create the missing ${field === 'skills' ? 'directory' : 'file'} at ${resolved}.`));
+                continue;
+            }
+            const stat = fs.statSync(resolved);
+            if (mustBeDir === true && !stat.isDirectory()) {
+                findings.push(makeInvalid(pluginName, `.cursor-plugin/plugin.json: ${field} path must be a directory, but a file was found: ${refPath}`, `The ${field} field expects a directory path, not a file path.`));
+            }
+            else if (mustBeDir === false && !stat.isFile()) {
+                findings.push(makeInvalid(pluginName, `.cursor-plugin/plugin.json: ${field} path must be a file, but a directory was found: ${refPath}`, `The ${field} field expects a file path, not a directory path.`));
+            }
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Cursor rule frontmatter validation
+// ---------------------------------------------------------------------------
+/**
+ * Parse the YAML frontmatter block from a .mdc file.
+ *
+ * Returns `null` when no frontmatter block is present (plain content is valid).
+ * Returns the parsed object when a frontmatter block is found.
+ * Throws if the YAML inside the block is malformed.
+ */
+function parseMdcFrontmatter(content) {
+    // Frontmatter is strictly between a leading `---\n` and the next `---`
+    if (!content.startsWith('---\n') && !content.startsWith('---\r\n'))
+        return null;
+    const end = content.indexOf('\n---', 4);
+    if (end === -1)
+        return null;
+    const yamlText = content.slice(4, end);
+    // yaml.parse returns `unknown`; we cast to a loose record type so Zod can
+    // validate the actual field types downstream.
+    const parsed = parseYaml(yamlText);
+    // An empty frontmatter block parses to null/undefined — treat as no frontmatter.
+    if (parsed === null || parsed === undefined)
+        return null;
+    return parsed;
+}
+function validateCursorRules(pluginDir, pluginName) {
+    const rulesDir = path.join(pluginDir, 'rules');
+    if (!fs.existsSync(rulesDir))
+        return [];
+    const findings = [];
+    const entries = fs.readdirSync(rulesDir, { withFileTypes: true });
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.endsWith('.mdc'))
+            continue;
+        const filePath = path.join(rulesDir, entry.name);
+        const content = fs.readFileSync(filePath, 'utf-8');
+        let frontmatter;
+        try {
+            frontmatter = parseMdcFrontmatter(content);
+        }
+        catch {
+            findings.push(makeInvalid(pluginName, `rules/${entry.name}: frontmatter YAML is malformed`, 'Ensure the YAML between the --- delimiters is valid.'));
+            continue;
+        }
+        // No frontmatter block → skip (plain .mdc content is valid)
+        if (frontmatter === null)
+            continue;
+        const result = cursorRuleFrontmatterSchema.safeParse(frontmatter);
+        if (!result.success) {
+            const issues = result.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ');
+            findings.push(makeInvalid(pluginName, `rules/${entry.name}: frontmatter failed schema validation: ${issues}`, 'Check the alwaysApply (boolean), globs (string[]), and description (string) fields.'));
+        }
+    }
+    return findings;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Run all Cursor-specific validators against a plugin directory.
+ *
+ * `pluginDir` is the absolute path to a `plugins/<name>/` directory.
+ * All findings use `plugin: path.basename(pluginDir)`.
+ */
+export function validateCursorPlugin(pluginDir) {
+    const pluginName = path.basename(pluginDir);
+    return [
+        ...validateManifestFileRefs(pluginDir, pluginName),
+        ...validateCursorRules(pluginDir, pluginName),
+    ];
+}
+//# sourceMappingURL=validate.js.map

package/dist/targets/cursor/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/targets/cursor/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAG1C,OAAO,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAEvF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E,SAAS,WAAW,CAAC,MAAc,EAAE,OAAe,EAAE,IAAa;IACjE,MAAM,OAAO,GAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACvF,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB,CACzB,KAA8D;IAE9D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;IACzF,+EAA+E;IAC/E,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,SAAS,wBAAwB,CAAC,SAAiB,EAAE,UAAkB;IACrE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;IAC3E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,WAAW,CACT,UAAU,EACV,8CAA8C,EAC9C,sCAAsC,CACvC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,0BAA0B,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,OAAO;YACL,WAAW,CACT,UAAU,EACV,wDAAwD,MAAM,EAAE,EAChE,qEAAqE,CACtE;SACF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;IAC7B,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,wEAAwE;IACxE,4EAA4E;IAC5E,yEAAyE;IACzE,MAAM,SAAS,GAA8D;QAC3E,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE;QAChF,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE;QACjF,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;KACpE,CAAC;IAEF,KAAK,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,SAAS,EAAE,CAAC;QAC9D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,0CAA0C;YAC1C,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC9B,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,+BAA+B,KAAK,+BAA+B,OAAO,EAAE,EAC5E,+CAA+C,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAChF,CACF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,8DAA8D;YAC9D,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,+BAA+B,KAAK,gCAAgC,OAAO,EAAE,EAC7E,gEAAgE,CACjE,CACF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAExD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,+BAA+B,KAAK,kCAAkC,OAAO,EAAE,EAC/E,sBAAsB,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,OAAO,QAAQ,GAAG,CAClF,CACF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEnC,IAAI,SAAS,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBAC9C,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,+BAA+B,KAAK,oDAAoD,OAAO,EAAE,EACjG,OAAO,KAAK,mDAAmD,CAChE,CACF,CAAC;YACJ,CAAC;iBAAM,IAAI,SAAS,KAAK,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;gBACjD,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,+BAA+B,KAAK,oDAAoD,OAAO,EAAE,EACjG,OAAO,KAAK,mDAAmD,CAChE,CACF,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,uEAAuE;IACvE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhF,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACvC,0EAA0E;IAC1E,8CAA8C;IAC9C,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAY,CAAC;IAC9C,iFAAiF;IACjF,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACzD,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAiB,EAAE,UAAkB;IAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,CAAC;IAExC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAE/B,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAClE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,SAAS;QAE9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAEnD,IAAI,WAA2C,CAAC;QAChD,IAAI,CAAC;YACH,WAAW,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,SAAS,KAAK,CAAC,IAAI,iCAAiC,EACpD,sDAAsD,CACvD,CACF,CAAC;YACF,SAAS;QACX,CAAC;QAED,4DAA4D;QAC5D,IAAI,WAAW,KAAK,IAAI;YAAE,SAAS;QAEnC,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9F,QAAQ,CAAC,IAAI,CACX,WAAW,CACT,UAAU,EACV,SAAS,KAAK,CAAC,IAAI,2CAA2C,MAAM,EAAE,EACtE,qFAAqF,CACtF,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO;QACL,GAAG,wBAAwB,CAAC,SAAS,EAAE,UAAU,CAAC;QAClD,GAAG,mBAAmB,CAAC,SAAS,EAAE,UAAU,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/targets/gemini/bundle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * I/O layer for the Gemini CLI target: copies a plugin's canonical files into a
+ * standalone export directory, rewriting agent tool names along the way.
+ *
+ * @see docs/specs/architecture.md §7 (mechanical transformations)
+ * @see docs/specs/architecture.md §12.4 (transform step + per-target folder layout)
+ */
+/**
+ * Build the Gemini CLI standalone export for a single plugin. Copies the canonical
+ * set of files/dirs from `pluginDir` into `destDir`, rewriting agent `.md` files'
+ * tool names along the way. Matches the output of `buildGeminiStandalone` in the
+ * template's `build-standalone.ts`.
+ *
+ * Impure (I/O): reads from pluginDir, writes to destDir. Clears destDir first.
+ *
+ * @param pluginDir - Absolute path to the source plugin directory.
+ * @param destDir   - Absolute path to the destination directory (cleared before writing).
+ * @returns `emitted`: paths relative to destDir for every file written.
+ *          `droppedToolsByAgent`: map of agent filename → dropped Claude tool names.
+ */
+export declare function bundleGeminiPlugin(pluginDir: string, destDir: string): {
+    emitted: string[];
+    droppedToolsByAgent: Record<string, string[]>;
+};
+//# sourceMappingURL=bundle.d.ts.map

package/dist/targets/gemini/bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.d.ts","sourceRoot":"","sources":["../../../src/targets/gemini/bundle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+FH;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CAmDtE"}

package/dist/targets/gemini/bundle.js

@@ -0,0 +1,149 @@
+/**
+ * I/O layer for the Gemini CLI target: copies a plugin's canonical files into a
+ * standalone export directory, rewriting agent tool names along the way.
+ *
+ * @see docs/specs/architecture.md §7 (mechanical transformations)
+ * @see docs/specs/architecture.md §12.4 (transform step + per-target folder layout)
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { convertClaudeHooksYamlToGeminiJson, rewriteAgentFrontmatterTools } from './transform.js';
+// ---------------------------------------------------------------------------
+// Internal file-system helpers (mirrors build-standalone.ts utilities)
+// ---------------------------------------------------------------------------
+function copyFile(src, dest) {
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+    fs.copyFileSync(src, dest);
+}
+function copyDir(src, dest) {
+    if (!fs.existsSync(src))
+        return;
+    fs.mkdirSync(dest, { recursive: true });
+    for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDir(srcPath, destPath);
+        }
+        else {
+            copyFile(srcPath, destPath);
+        }
+    }
+}
+function copyIfExists(src, dest) {
+    if (!fs.existsSync(src))
+        return false;
+    if (fs.statSync(src).isDirectory()) {
+        copyDir(src, dest);
+    }
+    else {
+        copyFile(src, dest);
+    }
+    return true;
+}
+function cleanDir(dir) {
+    if (fs.existsSync(dir)) {
+        fs.rmSync(dir, { recursive: true });
+    }
+}
+/** Collect all file paths under `dir` relative to `dir`. */
+function collectRelativePaths(dir) {
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        if (entry.isDirectory()) {
+            for (const sub of collectRelativePaths(path.join(dir, entry.name))) {
+                results.push(path.join(entry.name, sub));
+            }
+        }
+        else {
+            results.push(entry.name);
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Agent rewriting
+// ---------------------------------------------------------------------------
+/**
+ * Rewrite all `.md` files inside `agentsDir` in-place, translating Claude Code tool
+ * names to Gemini CLI equivalents. Returns a map of filename → dropped tools.
+ */
+function rewriteAgentsDir(agentsDir) {
+    const droppedToolsByAgent = {};
+    if (!fs.existsSync(agentsDir))
+        return droppedToolsByAgent;
+    for (const file of fs.readdirSync(agentsDir)) {
+        if (!file.endsWith('.md'))
+            continue;
+        const filePath = path.join(agentsDir, file);
+        const original = fs.readFileSync(filePath, 'utf-8');
+        const { content, droppedTools } = rewriteAgentFrontmatterTools(original);
+        fs.writeFileSync(filePath, content, 'utf-8');
+        if (droppedTools.length > 0) {
+            droppedToolsByAgent[file] = droppedTools;
+        }
+    }
+    return droppedToolsByAgent;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Build the Gemini CLI standalone export for a single plugin. Copies the canonical
+ * set of files/dirs from `pluginDir` into `destDir`, rewriting agent `.md` files'
+ * tool names along the way. Matches the output of `buildGeminiStandalone` in the
+ * template's `build-standalone.ts`.
+ *
+ * Impure (I/O): reads from pluginDir, writes to destDir. Clears destDir first.
+ *
+ * @param pluginDir - Absolute path to the source plugin directory.
+ * @param destDir   - Absolute path to the destination directory (cleared before writing).
+ * @returns `emitted`: paths relative to destDir for every file written.
+ *          `droppedToolsByAgent`: map of agent filename → dropped Claude tool names.
+ */
+export function bundleGeminiPlugin(pluginDir, destDir) {
+    cleanDir(destDir);
+    // ── Flat files (only if present) ──────────────────────────────────────────
+    const flatFiles = ['gemini-extension.json', 'GEMINI.md', 'README.md', 'LICENSE'];
+    for (const name of flatFiles) {
+        copyIfExists(path.join(pluginDir, name), path.join(destDir, name));
+    }
+    // ── Directories: skills/ and agents/ ─────────────────────────────────────
+    const plainDirs = ['skills', 'agents'];
+    for (const dir of plainDirs) {
+        copyIfExists(path.join(pluginDir, dir), path.join(destDir, dir));
+    }
+    // Rewrite agent tool names after copying
+    const droppedToolsByAgent = rewriteAgentsDir(path.join(destDir, 'agents'));
+    // ── commands/: .toml files only ───────────────────────────────────────────
+    const commandsSrc = path.join(pluginDir, 'commands');
+    const commandsDest = path.join(destDir, 'commands');
+    if (fs.existsSync(commandsSrc)) {
+        const tomlFiles = fs.readdirSync(commandsSrc).filter((f) => f.endsWith('.toml'));
+        if (tomlFiles.length > 0) {
+            fs.mkdirSync(commandsDest, { recursive: true });
+            for (const file of tomlFiles) {
+                copyFile(path.join(commandsSrc, file), path.join(commandsDest, file));
+            }
+        }
+    }
+    // ── hooks/hooks.json: translate Claude YAML → Gemini JSON ────────────────
+    // Gemini CLI looks for `hooks/hooks.json` regardless of the YAML source filename.
+    // Try claude.yaml first, then claude.yml, matching build-hooks.ts behaviour.
+    const hooksSrc = path.join(pluginDir, 'hooks');
+    const yamlCandidates = ['claude.yaml', 'claude.yml'];
+    for (const candidate of yamlCandidates) {
+        const yamlPath = path.join(hooksSrc, candidate);
+        if (fs.existsSync(yamlPath)) {
+            const yamlContent = fs.readFileSync(yamlPath, 'utf-8');
+            const jsonContent = convertClaudeHooksYamlToGeminiJson(yamlContent);
+            const hooksDestDir = path.join(destDir, 'hooks');
+            fs.mkdirSync(hooksDestDir, { recursive: true });
+            fs.writeFileSync(path.join(hooksDestDir, 'hooks.json'), jsonContent, 'utf-8');
+            break;
+        }
+    }
+    const emitted = collectRelativePaths(destDir);
+    return { emitted, droppedToolsByAgent };
+}
+//# sourceMappingURL=bundle.js.map

package/dist/targets/gemini/bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle.js","sourceRoot":"","sources":["../../../src/targets/gemini/bundle.ts"],"names":[],"mappings":"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"}

package/dist/targets/gemini/scaffold.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Scaffold templates for the Gemini CLI target.
+ *
+ * `scaffoldGeminiFiles` is a pure function returning the skeleton files this target contributes
+ * to a new plugin: the `gemini-extension.json` manifest and its referenced `GEMINI.md` context
+ * file. Every manifest carries `schemaVersion: "0.1.0"` (§12.2). No generated-file sentinels —
+ * these are author-authored skeleton files (§4.3).
+ *
+ * This module must not import from any sibling targets/<other>/ folder (§3.4).
+ *
+ * @see docs/specs/architecture.md §4 (plugin source layout)
+ * @see docs/specs/architecture.md §6.4 (compatibility-assist)
+ * @see docs/specs/architecture.md §12.2 (schemaVersion on every manifest)
+ * @see docs/specs/architecture.md §12.5 (per-target scaffold.ts)
+ */
+import { type ScaffoldedFile, type TargetScaffoldOptions } from '../scaffold-kit.js';
+/**
+ * Produce the Gemini CLI skeleton files for a plugin.
+ *
+ * The minimum required artifact (`TARGET_MIN_REQUIRED.gemini`) is `gemini-extension.json`. The
+ * manifest declares `contextFileName: "GEMINI.md"`, so the companion `GEMINI.md` is emitted too.
+ *
+ * @param pluginName - Plugin identity; written verbatim as the manifest `name`.
+ * @param opts - Optional description and add-target placeholder behaviour.
+ * @returns Files contributed by this target, with paths relative to the plugin directory.
+ */
+export declare function scaffoldGeminiFiles(pluginName: string, opts?: TargetScaffoldOptions): ScaffoldedFile[];
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/targets/gemini/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../src/targets/gemini/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC3B,MAAM,oBAAoB,CAAC;AAK5B;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE,qBAA0B,GAC/B,cAAc,EAAE,CA4BlB"}

package/dist/targets/gemini/scaffold.js

@@ -0,0 +1,57 @@
+/**
+ * Scaffold templates for the Gemini CLI target.
+ *
+ * `scaffoldGeminiFiles` is a pure function returning the skeleton files this target contributes
+ * to a new plugin: the `gemini-extension.json` manifest and its referenced `GEMINI.md` context
+ * file. Every manifest carries `schemaVersion: "0.1.0"` (§12.2). No generated-file sentinels —
+ * these are author-authored skeleton files (§4.3).
+ *
+ * This module must not import from any sibling targets/<other>/ folder (§3.4).
+ *
+ * @see docs/specs/architecture.md §4 (plugin source layout)
+ * @see docs/specs/architecture.md §6.4 (compatibility-assist)
+ * @see docs/specs/architecture.md §12.2 (schemaVersion on every manifest)
+ * @see docs/specs/architecture.md §12.5 (per-target scaffold.ts)
+ */
+import { resolveDescription, SCHEMA_VERSION, } from '../scaffold-kit.js';
+/** Identity tag enabling editor highlighting of the embedded Markdown context file. */
+const md = String.raw;
+/**
+ * Produce the Gemini CLI skeleton files for a plugin.
+ *
+ * The minimum required artifact (`TARGET_MIN_REQUIRED.gemini`) is `gemini-extension.json`. The
+ * manifest declares `contextFileName: "GEMINI.md"`, so the companion `GEMINI.md` is emitted too.
+ *
+ * @param pluginName - Plugin identity; written verbatim as the manifest `name`.
+ * @param opts - Optional description and add-target placeholder behaviour.
+ * @returns Files contributed by this target, with paths relative to the plugin directory.
+ */
+export function scaffoldGeminiFiles(pluginName, opts = {}) {
+    const description = resolveDescription(pluginName, opts);
+    const manifest = {
+        schemaVersion: SCHEMA_VERSION,
+        name: pluginName,
+        version: '0.0.1',
+        description,
+        contextFileName: 'GEMINI.md',
+        mcpServers: {},
+    };
+    return [
+        {
+            path: 'gemini-extension.json',
+            content: `${JSON.stringify(manifest, null, 2)}\n`,
+        },
+        {
+            path: 'GEMINI.md',
+            content: md `# ${pluginName}
+
+${description}
+
+## Overview
+
+Describe what this plugin does for Gemini CLI users.
+`,
+        },
+    ];
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/targets/gemini/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../src/targets/gemini/scaffold.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,kBAAkB,EAClB,cAAc,GAGf,MAAM,oBAAoB,CAAC;AAE5B,uFAAuF;AACvF,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC;AAEtB;;;;;;;;;GASG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,OAA8B,EAAE;IAEhC,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,QAAQ,GAA4B;QACxC,aAAa,EAAE,cAAc;QAC7B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;QAChB,WAAW;QACX,eAAe,EAAE,WAAW;QAC5B,UAAU,EAAE,EAAE;KACf,CAAC;IAEF,OAAO;QACL;YACE,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI;SAClD;QACD;YACE,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,EAAE,CAAA,KAAK,UAAU;;EAE9B,WAAW;;;;;CAKZ;SACI;KACF,CAAC;AACJ,CAAC"}

package/dist/targets/gemini/schemas.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Zod schemas for the Gemini CLI target.
+ *
+ * These are faithful, non-breaking ports of the JSON Schema contracts that the template
+ * repository has used in practice. Per §13 Phase A of the architecture spec, no schema
+ * breaking changes are introduced here — this is a mechanical port only.
+ *
+ * @see https://ai.google.dev/gemini-api/docs/gemini-cli (Gemini CLI extension format)
+ * @see docs/specs/architecture.md §3.4, §7.2, §9.4, §12.2, §13 Phase A
+ */
+import { z } from 'zod';
+/**
+ * The canonical set of Gemini CLI tool names, derived from the CLAUDE_TO_GEMINI_TOOLS
+ * mapping in build-standalone.ts of the template repository.
+ *
+ * Stage 3's transform layer consumes this for tool-name validation. Exporting from the
+ * schema module keeps the data colocated with the authoritative type definitions.
+ */
+export declare const GEMINI_TOOL_NAMES: readonly ["read_file", "replace", "search_file_content", "glob", "run_shell_command", "write_file", "activate_skill"];
+/** Union type of all valid Gemini CLI tool names. */
+export type GeminiToolName = (typeof GEMINI_TOOL_NAMES)[number];
+/**
+ * Schema for `gemini-extension.json` — the Gemini CLI extension manifest.
+ *
+ * NOTE: This schema uses `.loose()` at the top level rather than `.strict()`. Gemini CLI
+ * may include additional top-level fields that the template does not yet model (e.g., display
+ * metadata, capability declarations). Using `.loose()` tolerates those unknown fields without
+ * breaking validation, which matches the original `GeminiExtensionSchema` in validate.ts.
+ * When Gemini's manifest format is formally documented and stabilised, tighten this to
+ * `.strict()` and enumerate every known field.
+ */
+export declare const geminiExtensionManifestSchema: z.ZodObject<{
+    name: z.ZodString;
+    version: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    schemaVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+/**
+ * Schema for the YAML frontmatter of `agents/*.md` files emitted for the Gemini CLI target.
+ *
+ * NOTE: This schema uses `.loose()` for the same reason as `geminiExtensionManifestSchema` —
+ * agent frontmatter may include additional fields that Gemini CLI accepts but that the template
+ * does not yet model. The `tools` field accepts `string[]` without constraining to
+ * `GEMINI_TOOL_NAMES` because tool-name validation belongs to Stage 3's transform layer, not
+ * the shape-only validator here.
+ */
+export declare const geminiAgentFrontmatterSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodString;
+    tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    schemaVersion: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/targets/gemini/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/targets/gemini/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,uHAQpB,CAAC;AAEX,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAMhE;;;;;;;;;GASG;AACH,eAAO,MAAM,6BAA6B;;;;;iBAOhC,CAAC;AAMX;;;;;;;;GAQG;AACH,eAAO,MAAM,4BAA4B;;;;;iBAO/B,CAAC"}

package/dist/targets/gemini/schemas.js

@@ -0,0 +1,72 @@
+/**
+ * Zod schemas for the Gemini CLI target.
+ *
+ * These are faithful, non-breaking ports of the JSON Schema contracts that the template
+ * repository has used in practice. Per §13 Phase A of the architecture spec, no schema
+ * breaking changes are introduced here — this is a mechanical port only.
+ *
+ * @see https://ai.google.dev/gemini-api/docs/gemini-cli (Gemini CLI extension format)
+ * @see docs/specs/architecture.md §3.4, §7.2, §9.4, §12.2, §13 Phase A
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Canonical Gemini CLI tool names
+// ---------------------------------------------------------------------------
+/**
+ * The canonical set of Gemini CLI tool names, derived from the CLAUDE_TO_GEMINI_TOOLS
+ * mapping in build-standalone.ts of the template repository.
+ *
+ * Stage 3's transform layer consumes this for tool-name validation. Exporting from the
+ * schema module keeps the data colocated with the authoritative type definitions.
+ */
+export const GEMINI_TOOL_NAMES = [
+    'read_file',
+    'replace',
+    'search_file_content',
+    'glob',
+    'run_shell_command',
+    'write_file',
+    'activate_skill',
+];
+// ---------------------------------------------------------------------------
+// gemini-extension.json
+// ---------------------------------------------------------------------------
+/**
+ * Schema for `gemini-extension.json` — the Gemini CLI extension manifest.
+ *
+ * NOTE: This schema uses `.loose()` at the top level rather than `.strict()`. Gemini CLI
+ * may include additional top-level fields that the template does not yet model (e.g., display
+ * metadata, capability declarations). Using `.loose()` tolerates those unknown fields without
+ * breaking validation, which matches the original `GeminiExtensionSchema` in validate.ts.
+ * When Gemini's manifest format is formally documented and stabilised, tighten this to
+ * `.strict()` and enumerate every known field.
+ */
+export const geminiExtensionManifestSchema = z
+    .object({
+    name: z.string(),
+    version: z.string().optional(),
+    description: z.string().optional(),
+    schemaVersion: z.string().optional(),
+})
+    .loose();
+// ---------------------------------------------------------------------------
+// agents/*.md YAML frontmatter (as emitted for Gemini)
+// ---------------------------------------------------------------------------
+/**
+ * Schema for the YAML frontmatter of `agents/*.md` files emitted for the Gemini CLI target.
+ *
+ * NOTE: This schema uses `.loose()` for the same reason as `geminiExtensionManifestSchema` —
+ * agent frontmatter may include additional fields that Gemini CLI accepts but that the template
+ * does not yet model. The `tools` field accepts `string[]` without constraining to
+ * `GEMINI_TOOL_NAMES` because tool-name validation belongs to Stage 3's transform layer, not
+ * the shape-only validator here.
+ */
+export const geminiAgentFrontmatterSchema = z
+    .object({
+    name: z.string(),
+    description: z.string(),
+    tools: z.array(z.string()).optional(),
+    schemaVersion: z.string().optional(),
+})
+    .loose();
+//# sourceMappingURL=schemas.js.map

package/dist/targets/gemini/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/targets/gemini/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,SAAS;IACT,qBAAqB;IACrB,MAAM;IACN,mBAAmB;IACnB,YAAY;IACZ,gBAAgB;CACR,CAAC;AAKX,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,KAAK,EAAE,CAAC;AAEX,8EAA8E;AAC9E,uDAAuD;AACvD,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,KAAK,EAAE,CAAC"}