@a5c-ai/extensions-adapter 6.0.1-staging.ffc4f312f8c0 → 6.0.2

package/dist/targets/adapters/opencode.js

@@ -0,0 +1,101 @@
+// OpenCode harness output adapter
+import { BaseHarnessOutputAdapter } from './base.js';
+import { iterateHooks, slugify, applyPattern, resolveHookPath, getPattern, getJsPattern, resolveSdkConfig, } from './hooks-utils.js';
+import { generateOpenCodeAccomplishSkill } from '../../transformHelpers.js';
+import { buildOpencodeMcp, toJsonContent } from '../../mcpConfig.js';
+export class OpenCodeAdapter extends BaseHarnessOutputAdapter {
+    generateMcpConfig(manifest, _targetProfile) {
+        if (!manifest.mcpServers || Object.keys(manifest.mcpServers).length === 0) {
+            return null;
+        }
+        return { path: 'opencode.json', content: toJsonContent(buildOpencodeMcp(manifest.mcpServers)) };
+    }
+    generateHookRegistration(manifest, targetProfile, _diagnostics) {
+        const content = generateOpenCodeHooksJson(manifest, targetProfile);
+        return { path: targetProfile.hookRegistrationOutputPath || 'hooks/hooks.json', content };
+    }
+    generateManifestFiles(_sourceDir, manifest, _targetProfile, _diagnostics) {
+        const files = [];
+        files.push({
+            path: 'plugin.json',
+            content: generateOpenCodeManifest(manifest, this.targetName),
+        });
+        return files;
+    }
+    generateExtraTargetFiles(_sourceDir, manifest, _targetProfile, _diagnostics) {
+        const files = [];
+        const accomplishSkill = generateOpenCodeAccomplishSkill(manifest);
+        if (accomplishSkill) {
+            files.push({ path: `accomplish-skills/${manifest.name}/SKILL.md`, content: accomplishSkill });
+        }
+        return files;
+    }
+}
+export function generateOpenCodeManifest(manifest, targetName = 'opencode') {
+    const pluginJson = {
+        name: manifest.name,
+        version: manifest.version,
+        description: manifest.description,
+        author: manifest.author,
+        license: manifest.license,
+        harness: targetName,
+        // Only declare the hooks/ dir when the plugin ships hooks (hook-free for atlas).
+        ...(manifest.hooks && Object.keys(manifest.hooks).length > 0 ? { hooks: 'hooks/' } : {}),
+        commands: 'commands/',
+        skills: 'skills/',
+    };
+    if (manifest.repository) {
+        pluginJson.repository = manifest.repository;
+    }
+    if (manifest.keywords) {
+        pluginJson.keywords = manifest.keywords;
+    }
+    return JSON.stringify(pluginJson, null, 2) + '\n';
+}
+export function generateOpenCodeHooksJson(manifest, targetProfile) {
+    const hooks = {};
+    const pat = getPattern(manifest, targetProfile.name);
+    const sdk = resolveSdkConfig(manifest);
+    iterateHooks(manifest, targetProfile, (canonical, native, handler) => {
+        const slug = slugify(canonical);
+        const adapter = targetProfile.adapterName;
+        if (handler === 'proxy') {
+            hooks[native] = [{
+                    type: 'command',
+                    command: `${sdk.proxyBinary} invoke --adapter ${adapter} --json`,
+                    description: `${manifest.name} ${canonical} hook`,
+                    timeoutMs: canonical === 'ShellEnv' ? 5000 : 30000,
+                }];
+        }
+        else if (handler === true) {
+            hooks[native] = [{
+                    type: 'command',
+                    command: `echo '{}'`,
+                    description: `${manifest.name} ${canonical} hook`,
+                    timeoutMs: canonical === 'ShellEnv' ? 5000 : 30000,
+                }];
+        }
+        else {
+            const jsPat = getJsPattern(manifest, targetProfile.name);
+            let handlerScript;
+            if (jsPat) {
+                handlerScript = applyPattern(jsPat, manifest.name, slug, native);
+            }
+            else {
+                const p = resolveHookPath(handler, slug, manifest.name, native, pat);
+                handlerScript = p ? p.replace(/\.sh$/, '.js') : 'echo {}';
+            }
+            hooks[native] = [{
+                    type: 'command',
+                    script: `./${handlerScript}`,
+                    description: `${manifest.name} ${canonical} hook`,
+                    timeoutMs: canonical === 'ShellEnv' ? 5000 : 30000,
+                }];
+        }
+    });
+    return JSON.stringify({
+        version: 1,
+        description: `${manifest.name} hook registration for OpenCode.`,
+        hooks,
+    }, null, 2) + '\n';
+}

package/dist/targets/adapters/pi.d.ts

@@ -0,0 +1,12 @@
+import type { A5cPluginManifest, TargetProfile, TransformedFile, Diagnostic } from '../../types.js';
+import { BaseHarnessOutputAdapter } from './base.js';
+export declare class PiAdapter extends BaseHarnessOutputAdapter {
+    generateMcpConfig(manifest: A5cPluginManifest, _targetProfile: TargetProfile): TransformedFile | null;
+    generateManifestFiles(_sourceDir: string, manifest: A5cPluginManifest, _targetProfile: TargetProfile, _diagnostics: Diagnostic[]): TransformedFile[];
+}
+type ResolvedManifest = A5cPluginManifest & {
+    npmPackageName?: string;
+};
+export declare function generatePiManifest(manifest: ResolvedManifest, targetName?: string): string;
+export {};
+//# sourceMappingURL=pi.d.ts.map

package/dist/targets/adapters/pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi.d.ts","sourceRoot":"","sources":["../../../src/targets/adapters/pi.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACpG,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAOrD,qBAAa,SAAU,SAAQ,wBAAwB;IAErD,iBAAiB,CACf,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,EAAE,aAAa,GAC5B,eAAe,GAAG,IAAI;IAIzB,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,EAAE,aAAa,EAC7B,YAAY,EAAE,UAAU,EAAE,GACzB,eAAe,EAAE;CAQrB;AAED,KAAK,gBAAgB,GAAG,iBAAiB,GAAG;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAwCF,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,UAAU,SAAO,GAAG,MAAM,CAkDxF"}

package/dist/targets/adapters/pi.js

@@ -0,0 +1,98 @@
+// Pi harness output adapter
+import { BaseHarnessOutputAdapter } from './base.js';
+import { resolveTargetCliName, resolveTargetNpmPackageName, } from '../../sdkConfig.js';
+import { emitJsonMcpConfig } from '../../mcpConfig.js';
+export class PiAdapter extends BaseHarnessOutputAdapter {
+    generateMcpConfig(manifest, _targetProfile) {
+        return emitJsonMcpConfig(manifest, '.mcp.json');
+    }
+    generateManifestFiles(_sourceDir, manifest, _targetProfile, _diagnostics) {
+        const files = [];
+        files.push({
+            path: 'package.json',
+            content: generatePiManifest(manifest, this.targetName),
+        });
+        return files;
+    }
+}
+function buildNpmRepository(manifest, npmPackageName) {
+    if (!manifest.repository)
+        return undefined;
+    let url = typeof manifest.repository === 'string'
+        ? manifest.repository
+        : manifest.repository.url;
+    if (!url.startsWith('git+'))
+        url = `git+${url}`;
+    if (!url.endsWith('.git'))
+        url = `${url}.git`;
+    const directory = `plugins/${npmPackageName.split('/').pop()}`;
+    return { type: 'git', url, directory };
+}
+function buildNpmHomepage(manifest, npmPackageName) {
+    if (!manifest.repository)
+        return undefined;
+    const url = typeof manifest.repository === 'string'
+        ? manifest.repository
+        : manifest.repository.url;
+    const base = url.replace(/\.git$/, '').replace(/^git\+/, '');
+    const directory = `plugins/${npmPackageName.split('/').pop()}`;
+    return `${base}/tree/main/${directory}#readme`;
+}
+function buildNpmBugs(manifest) {
+    if (!manifest.repository)
+        return undefined;
+    const url = typeof manifest.repository === 'string'
+        ? manifest.repository
+        : manifest.repository.url;
+    const base = url.replace(/\.git$/, '').replace(/^git\+/, '');
+    return { url: `${base}/issues` };
+}
+export function generatePiManifest(manifest, targetName = 'pi') {
+    const target = { name: targetName };
+    const packageJson = {
+        name: resolveTargetNpmPackageName(manifest, target),
+        version: manifest.version,
+        type: 'module',
+        description: `${manifest.description} — ${targetName}`,
+        keywords: [targetName, manifest.name, 'orchestration'],
+        [targetName]: {
+            extensions: ['./extensions'],
+            skills: ['./skills'],
+        },
+        peerDependencies: {
+            '@earendil-works/pi-coding-agent': '*',
+        },
+        scripts: {
+            test: 'npm run validate:ci',
+            'test:integration': 'node --test test/integration.test.js',
+            'test:packaged-install': 'node test/packaged-install.test.cjs',
+            'validate:ci': 'npm run test:integration && npm run test:packaged-install',
+            deploy: 'npm publish --access public',
+            'deploy:staging': 'npm publish --access public --tag staging',
+        },
+        bin: { [resolveTargetCliName(manifest, target)]: 'bin/cli.cjs' },
+        files: [
+            'bin/',
+            'package.json',
+            'versions.json',
+            'README.md',
+            'AGENTS.md',
+            'extensions/',
+            'skills/',
+            'commands/',
+            'scripts/',
+            // hooks/ only when the plugin actually ships hooks (hook-free plugins
+            // like atlas emit no hooks/ dir, and verify rejects listed-but-missing
+            // publishable paths).
+            ...(manifest.hooks && Object.keys(manifest.hooks).length > 0 ? ['hooks/'] : []),
+        ],
+        author: typeof manifest.author === 'string' ? manifest.author : manifest.author.name,
+        license: manifest.license,
+        publishConfig: { access: 'public' },
+    };
+    const piPkgName = packageJson.name;
+    packageJson.repository = buildNpmRepository(manifest, piPkgName);
+    packageJson.homepage = buildNpmHomepage(manifest, piPkgName);
+    packageJson.bugs = buildNpmBugs(manifest);
+    return JSON.stringify(packageJson, null, 2) + '\n';
+}

package/dist/targets/index.d.ts

@@ -0,0 +1,7 @@
+import type { TargetProfile } from '../types.js';
+export declare const TARGET_REGISTRY: Record<string, TargetProfile>;
+export declare const HOOK_NAME_MAP: Record<string, Record<string, string>>;
+export declare function getTargetProfile(name: string): TargetProfile | null;
+export declare function requireTargetProfile(name: string): TargetProfile;
+export declare function getAllTargets(): string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/targets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/targets/index.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAiEjD,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAEzD,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAoB,CAAC;AAEtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAInE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAMhE;AAED,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAExC"}

package/dist/targets/index.js

@@ -0,0 +1,79 @@
+// Catalog-backed target registry and hook name mapping
+import { getHookNameMap, getPluginTargetDescriptor, listPluginTargetDescriptors, } from '@a5c-ai/atlas/catalog';
+function toManifestFormat(format) {
+    if (format === 'plugin.json')
+        return 'plugin.json';
+    if (format === 'state-only' || format.includes('package.json'))
+        return 'package.json';
+    return 'multiple';
+}
+function toCommandFormat(format) {
+    if (format === 'extension-manifest')
+        return 'toml';
+    if (format === 'none' || format === 'package-json commands')
+        return 'none';
+    return 'markdown';
+}
+function toHookRegistrationFormat(format) {
+    return format || null;
+}
+function toScriptVariants(variants) {
+    return (variants ?? []).filter((variant) => variant === 'bash' ||
+        variant === 'powershell' ||
+        variant === 'javascript' ||
+        variant === 'typescript');
+}
+function canonicalTargetName(name) {
+    // Try exact match first; if not found, check if any target's adapterName or cliCommand matches
+    if (getPluginTargetDescriptor(name))
+        return name;
+    for (const target of listPluginTargetDescriptors()) {
+        if (target.adapterName === name || target.cliCommand === name)
+            return target.targetId;
+    }
+    return name;
+}
+function toTargetProfile(target) {
+    return {
+        name: target.targetId,
+        displayName: target.displayName,
+        adapterName: target.adapterName,
+        pluginRootEnvVar: target.pluginRootEnvVar ?? null,
+        supportedHooks: new Map(Object.entries(target.supportedHooks)),
+        commandFormat: toCommandFormat(target.commandFormat),
+        skillHandling: target.skillHandling ?? 'none',
+        manifestFormat: toManifestFormat(target.manifestFormat),
+        hookRegistrationFormat: toHookRegistrationFormat(target.hookRegistrationFormat),
+        hookRegistrationOutputPath: target.hookRegistrationOutputPath ?? null,
+        hookRegistrationAliasPaths: target.hookRegistrationAliasPaths ?? [],
+        harnessManifestPath: target.harnessManifestPath ?? null,
+        requiredSurfaceFile: target.requiredSurfaceFile ?? null,
+        scriptVariants: toScriptVariants(target.scriptVariants),
+        npmPublishable: target.npmPublishable,
+        adapterFamily: target.adapterFamily ?? 'shell-hook',
+        distribution: target.distribution ?? 'marketplace',
+        pluginRootEnvVarForExtension: target.pluginRootEnvVarForExtension ?? undefined,
+        marketplacePath: target.marketplacePath,
+        installLayout: target.installLayout,
+        packageMetadata: target.packageMetadata,
+        componentSupport: target.componentSupport,
+    };
+}
+export const TARGET_REGISTRY = Object.fromEntries(listPluginTargetDescriptors().map((target) => [target.targetId, toTargetProfile(target)]));
+export const HOOK_NAME_MAP = getHookNameMap();
+export function getTargetProfile(name) {
+    const descriptor = getPluginTargetDescriptor(canonicalTargetName(name));
+    if (descriptor)
+        return toTargetProfile(descriptor);
+    return null;
+}
+export function requireTargetProfile(name) {
+    const profile = getTargetProfile(name);
+    if (!profile) {
+        throw new Error(`Unknown target profile: ${name}`);
+    }
+    return profile;
+}
+export function getAllTargets() {
+    return listPluginTargetDescriptors().map((target) => target.targetId);
+}

package/dist/transform.d.ts

@@ -0,0 +1,4 @@
+import type { A5cPluginManifest, TargetProfile, TransformResult } from './types.js';
+export declare function transform(sourceDir: string, manifest: A5cPluginManifest, targetProfile: TargetProfile): TransformResult;
+export { getCommandPaths } from './utils.js';
+//# sourceMappingURL=transform.d.ts.map

package/dist/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../src/transform.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EAGhB,MAAM,YAAY,CAAC;AA6BpB,wBAAgB,SAAS,CACvB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,GAC3B,eAAe,CAwCjB;AA8HD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/transform.js

@@ -0,0 +1,301 @@
+// Stage 3: TRANSFORM - Transform components to target format
+import * as fs from 'fs';
+import * as path from 'path';
+import { buildSkillFromCommand, getCommandPaths, markdownToToml, } from './utils.js';
+import { getAdapter } from './targets/adapters/index.js';
+import { buildTemplateVars, interpolateTemplate, generatePs1Wrapper, generateJsBridge, generateTsHookStub, } from './transformHelpers.js';
+import { generateManifests, copyAgentFiles, copyContextFiles, copyIncludedFiles, generateExtraFiles, } from './transformEmitters.js';
+function toOutputPath(value) {
+    return value.replace(/\\/g, '/');
+}
+export function transform(sourceDir, manifest, targetProfile) {
+    const files = [];
+    const diagnostics = [];
+    // Transform commands
+    const commandFiles = transformCommands(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...commandFiles);
+    // Transform skills
+    const skillFiles = transformSkills(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...skillFiles);
+    // Transform hooks
+    const hookFiles = transformHooks(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...hookFiles);
+    // Generate manifests
+    const manifestFiles = generateManifests(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...manifestFiles);
+    // Emit native MCP config (one file per target) when manifest.mcpServers present
+    emitMcpConfig(manifest, targetProfile, files);
+    // Copy agent instruction files
+    const agentFiles = copyAgentFiles(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...agentFiles);
+    // Copy context files
+    const contextFiles = copyContextFiles(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...contextFiles);
+    // Copy included files (versions.json, assets, etc.) — skip hooks/ since transformHooks handles those
+    const includedFiles = copyIncludedFiles(sourceDir, manifest, ['hooks/', 'hooks']);
+    files.push(...includedFiles);
+    // Generate extra files (Pi/oh-my-pi extensions, etc.)
+    const extraFiles = generateExtraFiles(sourceDir, manifest, targetProfile, diagnostics);
+    files.push(...extraFiles);
+    return { files, diagnostics };
+}
+function transformCommands(sourceDir, manifest, targetProfile, _diagnostics) {
+    const files = [];
+    if (targetProfile.commandFormat === 'none') {
+        return files;
+    }
+    if (!manifest.commands) {
+        return files;
+    }
+    const commandPaths = [];
+    if (typeof manifest.commands === 'string') {
+        // Directory path - glob all .md files
+        const commandDir = path.join(sourceDir, manifest.commands);
+        if (fs.existsSync(commandDir)) {
+            const entries = fs.readdirSync(commandDir);
+            for (const entry of entries) {
+                if (entry.endsWith('.md')) {
+                    commandPaths.push(toOutputPath(path.join(manifest.commands, entry)));
+                }
+            }
+        }
+    }
+    else {
+        commandPaths.push(...manifest.commands.map(toOutputPath));
+    }
+    for (const cmdPath of commandPaths) {
+        const fullPath = path.join(sourceDir, cmdPath);
+        if (!fs.existsSync(fullPath)) {
+            continue;
+        }
+        const vars = buildTemplateVars(manifest, targetProfile);
+        const content = interpolateTemplate(fs.readFileSync(fullPath, 'utf-8'), vars);
+        if (targetProfile.commandFormat === 'toml') {
+            // Convert to TOML (Gemini)
+            const tomlContent = markdownToToml(content);
+            const basename = path.basename(cmdPath, '.md');
+            files.push({
+                path: `commands/${basename}.toml`,
+                content: tomlContent,
+            });
+        }
+        else {
+            // Copy as-is (Markdown)
+            files.push({
+                path: cmdPath,
+                content,
+            });
+        }
+    }
+    return files;
+}
+function transformSkills(sourceDir, manifest, targetProfile, _diagnostics) {
+    const files = [];
+    if (targetProfile.skillHandling === 'none') {
+        return files;
+    }
+    const vars = buildTemplateVars(manifest, targetProfile);
+    // Always copy standalone skills
+    if (manifest.skills && Array.isArray(manifest.skills)) {
+        for (const skill of manifest.skills) {
+            const fullPath = path.join(sourceDir, skill.file);
+            if (fs.existsSync(fullPath)) {
+                files.push({
+                    path: skill.file,
+                    content: interpolateTemplate(fs.readFileSync(fullPath, 'utf-8'), vars),
+                });
+            }
+        }
+    }
+    // Derive skills from commands if needed
+    if (targetProfile.skillHandling === 'derived-from-commands') {
+        const commandPaths = getCommandPaths(sourceDir, manifest);
+        // Build set of standalone skill names to avoid duplicating them
+        const standaloneSkillNames = new Set();
+        if (manifest.skills && Array.isArray(manifest.skills)) {
+            for (const skill of manifest.skills) {
+                standaloneSkillNames.add(skill.name);
+            }
+        }
+        for (const cmdPath of commandPaths) {
+            const fullPath = path.join(sourceDir, cmdPath);
+            if (!fs.existsSync(fullPath))
+                continue;
+            const basename = path.basename(cmdPath, '.md');
+            if (standaloneSkillNames.has(basename)) {
+                continue;
+            }
+            const content = interpolateTemplate(fs.readFileSync(fullPath, 'utf-8'), vars);
+            const derivedSkill = buildSkillFromCommand(basename, content);
+            files.push({
+                path: `skills/${basename}/SKILL.md`,
+                content: derivedSkill,
+            });
+        }
+    }
+    return files;
+}
+// Re-export for backward compatibility
+export { getCommandPaths } from './utils.js';
+function transformHooks(sourceDir, manifest, targetProfile, diagnostics) {
+    const files = [];
+    if (!manifest.hooks || targetProfile.supportedHooks.size === 0) {
+        return files;
+    }
+    const isProgrammatic = targetProfile.adapterFamily === 'programmatic';
+    const override = manifest.targets?.[targetProfile.name];
+    const hookFilePattern = typeof override?.hookFilePattern === 'string'
+        ? override.hookFilePattern
+        : typeof manifest.hookFilePattern === 'string' ? manifest.hookFilePattern : undefined;
+    const hookJsPattern = typeof override?.hookJsPattern === 'string'
+        ? override.hookJsPattern
+        : hookFilePattern ? hookFilePattern.replace(/\.sh$/, '.js') : undefined;
+    const toSlug = (s) => s
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2').toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    const toNativeSlug = (s) => s.replace(/[._]/g, '-').replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+    for (const [canonicalHook, handlerValue] of Object.entries(manifest.hooks)) {
+        if (handlerValue === null)
+            continue;
+        const nativeHook = targetProfile.supportedHooks.get(canonicalHook);
+        if (!nativeHook)
+            continue;
+        if (typeof handlerValue !== 'string' || handlerValue === 'proxy')
+            continue;
+        const hookSlug = toSlug(canonicalHook);
+        const nativeSlug = toNativeSlug(nativeHook);
+        const sourceScript = path.join(sourceDir, handlerValue);
+        if (!fs.existsSync(sourceScript))
+            continue;
+        const rawContent = fs.readFileSync(sourceScript, 'utf-8');
+        const content = rawContent.replace(/ADAPTER_NAME="\$\{ADAPTER_NAME:\?[^}]*\}"/, `ADAPTER_NAME="\${ADAPTER_NAME:-${targetProfile.adapterName}}"`);
+        // Determine bash output filename via hookFilePattern
+        let outName;
+        if (hookFilePattern) {
+            outName = hookFilePattern
+                .replace(/\{\{name\}\}/g, manifest.name)
+                .replace(/\{\{slug\}\}/g, hookSlug)
+                .replace(/\{\{native\}\}/g, nativeSlug);
+        }
+        else {
+            outName = path.basename(handlerValue);
+        }
+        files.push({ path: `hooks/${outName}`, content, executable: true });
+        if (targetProfile.scriptVariants.includes('powershell')) {
+            const ps1Name = outName.replace(/\.sh$/, '.ps1');
+            files.push({ path: `hooks/${ps1Name}`, content: generatePs1Wrapper(hookSlug, targetProfile.adapterName, handlerValue) });
+        }
+        // JS bridge for programmatic targets — uses hookJsPattern if available
+        if (isProgrammatic) {
+            let jsName;
+            if (hookJsPattern) {
+                jsName = hookJsPattern
+                    .replace(/\{\{name\}\}/g, manifest.name)
+                    .replace(/\{\{slug\}\}/g, hookSlug)
+                    .replace(/\{\{native\}\}/g, nativeSlug);
+            }
+            else {
+                jsName = outName.replace(/\.sh$/, '.js');
+            }
+            files.push({ path: `hooks/${jsName}`, content: generateJsBridge(jsName.replace(/\.js$/, ''), handlerValue, targetProfile), executable: true });
+        }
+        // TS hook stubs for targets with typescript variant (openclaw)
+        if (targetProfile.scriptVariants.includes('typescript')) {
+            const tsName = `${nativeSlug}.ts`;
+            files.push({
+                path: `extensions/hooks/${tsName}`,
+                content: generateTsHookStub(nativeHook, nativeSlug, outName, targetProfile),
+            });
+        }
+    }
+    // Emit Stop hook script for programmatic targets that declare Stop in the
+    // manifest but don't list it in supportedHooks (e.g. openclaw).
+    if (targetProfile.adapterFamily === 'programmatic' && typeof manifest.hooks?.Stop === 'string' && !targetProfile.supportedHooks.has('Stop')) {
+        const stopSource = path.join(sourceDir, manifest.hooks.Stop);
+        if (fs.existsSync(stopSource)) {
+            const rawContent = fs.readFileSync(stopSource, 'utf-8');
+            const content = rawContent.replace(/ADAPTER_NAME="\$\{ADAPTER_NAME:\?[^}]*\}"/, `ADAPTER_NAME="\${ADAPTER_NAME:-${targetProfile.adapterName}}"`);
+            const stopOutName = hookFilePattern
+                ? hookFilePattern
+                    .replace(/\{\{name\}\}/g, manifest.name)
+                    .replace(/\{\{slug\}\}/g, toSlug('Stop'))
+                    .replace(/\{\{native\}\}/g, 'stop-hook')
+                : path.basename(manifest.hooks.Stop);
+            const stopPath = `hooks/${stopOutName}`;
+            if (!files.some((file) => file.path === stopPath)) {
+                files.push({ path: stopPath, content, executable: true });
+            }
+        }
+    }
+    // Generate hook registration file for shell-hook targets
+    if (targetProfile.hookRegistrationFormat) {
+        const hookRegFile = generateHookRegistrationFile(manifest, targetProfile, diagnostics);
+        if (hookRegFile) {
+            files.push(hookRegFile);
+            for (const aliasPath of targetProfile.hookRegistrationAliasPaths) {
+                files.push({ path: aliasPath, content: hookRegFile.content });
+            }
+        }
+    }
+    return files;
+}
+function generateHookRegistrationFile(manifest, targetProfile, diagnostics) {
+    const adapter = getAdapter(targetProfile.name);
+    if (!adapter)
+        return null;
+    return adapter.generateHookRegistration(manifest, targetProfile, diagnostics);
+}
+/**
+ * Global MCP emit step: produces exactly one native MCP config file per target
+ * from manifest.mcpServers. When a file already exists at the target MCP path
+ * (e.g. gemini's gemini-extension.json emitted by generateManifestFiles), the
+ * MCP keys are deep-merged into it rather than emitting a duplicate path.
+ */
+function emitMcpConfig(manifest, targetProfile, files) {
+    if (!manifest.mcpServers || Object.keys(manifest.mcpServers).length === 0) {
+        return;
+    }
+    const adapter = getAdapter(targetProfile.name);
+    if (!adapter)
+        return;
+    const mcpFile = adapter.generateMcpConfig(manifest, targetProfile);
+    if (!mcpFile)
+        return;
+    const existing = files.find((f) => f.path === mcpFile.path);
+    if (!existing) {
+        files.push(mcpFile);
+        return;
+    }
+    // A file already lives at this path — merge MCP keys into it (JSON only).
+    if (mcpFile.path.endsWith('.json')) {
+        try {
+            const base = JSON.parse(existing.content);
+            const incoming = JSON.parse(mcpFile.content);
+            existing.content = toMergedJsonContent(base, incoming);
+            return;
+        }
+        catch {
+            // Fall through to replacement if either side is not valid JSON.
+        }
+    }
+    // Non-JSON or unparseable: the MCP content takes precedence.
+    existing.content = mcpFile.content;
+}
+function toMergedJsonContent(base, incoming) {
+    const merged = { ...base };
+    for (const [key, value] of Object.entries(incoming)) {
+        const baseValue = merged[key];
+        if (baseValue &&
+            typeof baseValue === 'object' &&
+            !Array.isArray(baseValue) &&
+            value &&
+            typeof value === 'object' &&
+            !Array.isArray(value)) {
+            merged[key] = { ...baseValue, ...value };
+        }
+        else {
+            merged[key] = value;
+        }
+    }
+    return JSON.stringify(merged, null, 2) + '\n';
+}

package/dist/transformEmitters.d.ts

@@ -0,0 +1,8 @@
+import type { A5cPluginManifest, TargetProfile, TransformedFile, Diagnostic } from './types.js';
+export declare function generateManifests(sourceDir: string, manifest: A5cPluginManifest, targetProfile: TargetProfile, _diagnostics: Diagnostic[]): TransformedFile[];
+export declare function copyAgentFiles(sourceDir: string, manifest: A5cPluginManifest, targetProfile: TargetProfile, _diagnostics: Diagnostic[]): TransformedFile[];
+export declare function copyContextFiles(sourceDir: string, manifest: A5cPluginManifest, targetProfile: TargetProfile, _diagnostics: Diagnostic[]): TransformedFile[];
+export declare function copyIncludedFiles(sourceDir: string, manifest: A5cPluginManifest, excludePatterns?: string[]): TransformedFile[];
+export declare function collectDir(sourceDir: string, relDir: string, files: TransformedFile[]): void;
+export declare function generateExtraFiles(sourceDir: string, manifest: A5cPluginManifest, targetProfile: TargetProfile, _diagnostics: Diagnostic[]): TransformedFile[];
+//# sourceMappingURL=transformEmitters.d.ts.map

package/dist/transformEmitters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformEmitters.d.ts","sourceRoot":"","sources":["../src/transformEmitters.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAgFhG,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,UAAU,EAAE,GACzB,eAAe,EAAE,CAsHnB;AAED,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,UAAU,EAAE,GACzB,eAAe,EAAE,CAkBnB;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,UAAU,EAAE,GACzB,eAAe,EAAE,CAkBnB;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,eAAe,GAAE,MAAM,EAAO,GAC7B,eAAe,EAAE,CA8CnB;AAED,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,eAAe,EAAE,GACvB,IAAI,CAeN;AAED,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,UAAU,EAAE,GACzB,eAAe,EAAE,CAoFnB"}