@a5c-ai/extension-mux 5.0.1-staging.04ca6ab00d21

package/dist/transformEmitters.js

@@ -0,0 +1,340 @@
+// Manifest generators and file copy functions for the transform stage
+import * as fs from 'fs';
+import * as path from 'path';
+import { getAdapter } from './targets/adapters/index.js';
+import { generateProgrammaticExtension } from './proxiedHookTemplates.js';
+import { generateCliBinScript, generateInstallScript, generateUninstallScript } from './binTemplates.js';
+import { generateInstallInstructions } from './installInstructions.js';
+import { generateTeamInstall, resolveExtraFiles, } from './transformHelpers.js';
+import { generateInstallShared } from './installSharedGenerator.js';
+import { resolveSdkConfig, resolveTargetCliName, resolveTargetNpmPackageName, } from './sdkConfig.js';
+import { getCommandPaths } from './utils.js';
+function toOutputPath(value) {
+    return value.replace(/\\/g, '/');
+}
+function getRequiredSurfaceFilename(targetProfile) {
+    return targetProfile.requiredSurfaceFile ?? null;
+}
+function buildSurfaceFallback(manifest, targetProfile, filename) {
+    return `# ${filename}
+
+This file was generated by @a5c-ai/extension-mux for target \`${targetProfile.name}\`.
+
+The plugin manifest for \`${manifest.name}\` does not declare a dedicated ${filename} source file.
+Add \`agents\` and/or \`contextFiles.${targetProfile.name}\` in \`plugin.json\` to replace this placeholder with real target guidance.
+`;
+}
+function readExistingTextFile(sourceDir, relativePath) {
+    const fullPath = path.join(sourceDir, relativePath);
+    if (!fs.existsSync(fullPath) || !fs.statSync(fullPath).isFile()) {
+        return null;
+    }
+    return fs.readFileSync(fullPath, 'utf-8');
+}
+function resolveAgentSurfaceContent(sourceDir, manifest) {
+    if (!manifest.agents) {
+        return null;
+    }
+    const agentPaths = typeof manifest.agents === 'string' ? [manifest.agents] : manifest.agents;
+    const contents = agentPaths
+        .map((agentPath) => readExistingTextFile(sourceDir, agentPath))
+        .filter((content) => content !== null);
+    if (contents.length === 0) {
+        return null;
+    }
+    return contents.join('\n\n');
+}
+function generateCjsWrapper(moduleBasename, exportOnly = false) {
+    if (exportOnly) {
+        return `'use strict';\n\nmodule.exports = require('./${moduleBasename}.js');\n`;
+    }
+    return `#!/usr/bin/env node
+'use strict';
+
+require('./${moduleBasename}.js');
+`;
+}
+export function generateManifests(sourceDir, manifest, targetProfile, _diagnostics) {
+    const files = [];
+    // Filter manifest hooks to only those supported by this target
+    // and resolve handler paths through hookFilePattern
+    const sdkCfg = resolveSdkConfig(manifest);
+    const filteredManifest = { ...manifest };
+    if (manifest.hooks) {
+        const hookFilePattern = manifest.targets?.[targetProfile.name]?.hookFilePattern
+            ?? manifest.hookFilePattern;
+        const pat = typeof hookFilePattern === 'string' ? hookFilePattern : 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();
+        const filtered = {};
+        for (const [canonical, handler] of Object.entries(manifest.hooks)) {
+            if (handler === null || !targetProfile.supportedHooks.has(canonical))
+                continue;
+            if (typeof handler === 'string' && handler !== 'proxy' && pat) {
+                const native = targetProfile.supportedHooks.get(canonical) || canonical;
+                const resolved = 'hooks/' + pat
+                    .replace(/\{\{name\}\}/g, manifest.name)
+                    .replace(/\{\{slug\}\}/g, toSlug(canonical))
+                    .replace(/\{\{native\}\}/g, toNativeSlug(native));
+                filtered[canonical] = resolved;
+            }
+            else {
+                filtered[canonical] = handler;
+            }
+        }
+        filteredManifest.hooks = filtered;
+    }
+    // Add target name to end of keywords if not already present
+    if (filteredManifest.keywords) {
+        const kw = [...filteredManifest.keywords];
+        if (!kw.includes(targetProfile.name)) {
+            kw.push(targetProfile.name);
+        }
+        filteredManifest.keywords = kw;
+    }
+    const adapter = getAdapter(targetProfile.name);
+    if (adapter) {
+        const adapterFiles = adapter.generateManifestFiles(sourceDir, filteredManifest, targetProfile, _diagnostics, manifest);
+        files.push(...adapterFiles);
+    }
+    // Generate package.json for npm-distributed targets that don't already have one
+    if ((targetProfile.distribution === 'npm-cli' || (targetProfile.distribution === 'both' && targetProfile.npmPublishable)) &&
+        !files.some(f => f.path === 'package.json')) {
+        const packageMetadata = targetProfile.packageMetadata ?? {};
+        const npmPkg = resolveTargetNpmPackageName(manifest, targetProfile);
+        const cliName = resolveTargetCliName(manifest, targetProfile);
+        const isEsm = packageMetadata.moduleType === 'module';
+        const ext = packageMetadata.binScriptExt ?? (isEsm ? '.cjs' : '.js');
+        const scripts = {
+            deploy: 'npm publish --access public',
+            'deploy:staging': 'npm publish --access public --tag staging',
+        };
+        if (packageMetadata.installLifecycle === 'plugin-scripts') {
+            scripts['plugin:install'] = `node bin/install${ext} --global`;
+            scripts['plugin:uninstall'] = `node bin/uninstall${ext} --global`;
+        }
+        else if (packageMetadata.installLifecycle === 'postinstall') {
+            scripts.postinstall = `node bin/install${ext}`;
+            scripts.preuninstall = `node bin/uninstall${ext}`;
+        }
+        scripts['team:install'] = `node scripts/team-install${ext}`;
+        for (const [scriptName, scriptValue] of Object.entries(packageMetadata.extraScripts ?? {})) {
+            scripts[scriptName] = scriptValue;
+        }
+        const packageFiles = ['bin/', ...(packageMetadata.extraPackageFiles ?? [])];
+        packageFiles.push('hooks/', 'skills/', 'commands/', 'scripts/', 'plugin.json');
+        packageFiles.push('README.md', 'versions.json', 'package.json');
+        const pkgJson = {
+            name: npmPkg,
+            version: manifest.version,
+            description: manifest.description,
+            scripts,
+            bin: { [cliName]: `bin/cli${ext}` },
+            files: packageFiles,
+            keywords: [manifest.name, targetProfile.name, 'orchestration'],
+            author: manifest.author,
+            license: manifest.license,
+            publishConfig: { access: 'public' },
+            dependencies: { [sdkCfg.package]: manifest.version },
+        };
+        if (isEsm)
+            pkgJson.type = 'module';
+        if (manifest.repository) {
+            let repoUrl = typeof manifest.repository === 'string' ? manifest.repository : manifest.repository.url;
+            if (!repoUrl.startsWith('git+'))
+                repoUrl = `git+${repoUrl}`;
+            if (!repoUrl.endsWith('.git'))
+                repoUrl = `${repoUrl}.git`;
+            const directory = `plugins/${npmPkg.split('/').pop()}`;
+            const baseUrl = repoUrl.replace(/\.git$/, '').replace(/^git\+/, '');
+            pkgJson.repository = { type: 'git', url: repoUrl, directory };
+            pkgJson.homepage = `${baseUrl}/tree/main/${directory}#readme`;
+            pkgJson.bugs = { url: `${baseUrl}/issues` };
+        }
+        if (targetProfile.adapterFamily === 'programmatic') {
+            const peerPkg = packageMetadata.peerDependencyPackage;
+            if (peerPkg)
+                pkgJson.peerDependencies = { [peerPkg]: '*' };
+        }
+        files.push({ path: 'package.json', content: JSON.stringify(pkgJson, null, 2) + '\n' });
+    }
+    return files;
+}
+export function copyAgentFiles(sourceDir, manifest, targetProfile, _diagnostics) {
+    if (targetProfile.componentSupport?.agents !== 'native') {
+        return [];
+    }
+    if (getRequiredSurfaceFilename(targetProfile) === 'AGENTS.md') {
+        return [];
+    }
+    const content = resolveAgentSurfaceContent(sourceDir, manifest);
+    if (!content) {
+        return [];
+    }
+    return [{
+            path: 'AGENTS.md',
+            content,
+        }];
+}
+export function copyContextFiles(sourceDir, manifest, targetProfile, _diagnostics) {
+    const requiredFilename = getRequiredSurfaceFilename(targetProfile);
+    if (!requiredFilename) {
+        return [];
+    }
+    const contextPath = manifest.contextFiles?.[targetProfile.name]
+        ?? (targetProfile.name === 'gemini-cli' ? manifest.contextFiles?.gemini : undefined);
+    const declaredContextContent = contextPath ? readExistingTextFile(sourceDir, contextPath) : null;
+    const agentContent = resolveAgentSurfaceContent(sourceDir, manifest);
+    const content = declaredContextContent
+        ?? agentContent
+        ?? buildSurfaceFallback(manifest, targetProfile, requiredFilename);
+    return [{
+            path: toOutputPath(requiredFilename),
+            content,
+        }];
+}
+export function copyIncludedFiles(sourceDir, manifest, excludePatterns = []) {
+    const files = [];
+    if (!manifest.include || manifest.include.length === 0) {
+        return files;
+    }
+    for (const pattern of manifest.include) {
+        if (excludePatterns.some(ex => pattern === ex || pattern.startsWith(ex)))
+            continue;
+        if (!pattern.includes('*')) {
+            const fullPath = path.join(sourceDir, pattern);
+            if (fs.existsSync(fullPath)) {
+                const stat = fs.statSync(fullPath);
+                if (stat.isFile()) {
+                    files.push({
+                        path: toOutputPath(pattern),
+                        content: fs.readFileSync(fullPath, 'utf-8'),
+                    });
+                }
+                else if (stat.isDirectory()) {
+                    collectDir(sourceDir, pattern, files);
+                }
+            }
+            continue;
+        }
+        // Simple *.ext glob in a directory
+        const dir = path.dirname(pattern);
+        const ext = path.extname(pattern);
+        const fullDir = path.join(sourceDir, dir);
+        if (fs.existsSync(fullDir) && fs.statSync(fullDir).isDirectory()) {
+            for (const entry of fs.readdirSync(fullDir)) {
+                if (ext && !entry.endsWith(ext))
+                    continue;
+                const entryPath = toOutputPath(path.join(dir, entry));
+                const fullEntry = path.join(sourceDir, entryPath);
+                if (fs.statSync(fullEntry).isFile()) {
+                    files.push({
+                        path: entryPath,
+                        content: fs.readFileSync(fullEntry, 'utf-8'),
+                    });
+                }
+            }
+        }
+    }
+    return files;
+}
+export function collectDir(sourceDir, relDir, files) {
+    const fullDir = path.join(sourceDir, relDir);
+    for (const entry of fs.readdirSync(fullDir)) {
+        const relPath = toOutputPath(path.join(relDir, entry));
+        const fullPath = path.join(sourceDir, relPath);
+        const stat = fs.statSync(fullPath);
+        if (stat.isFile()) {
+            files.push({
+                path: relPath,
+                content: fs.readFileSync(fullPath, 'utf-8'),
+            });
+        }
+        else if (stat.isDirectory()) {
+            collectDir(sourceDir, relPath, files);
+        }
+    }
+}
+export function generateExtraFiles(sourceDir, manifest, targetProfile, _diagnostics) {
+    const files = [];
+    const sdkCfg = resolveSdkConfig(manifest);
+    // Generate programmatic extensions (Pi, oh-my-pi, and other programmatic targets)
+    if (targetProfile.adapterFamily === 'programmatic') {
+        const cmdPaths = getCommandPaths(sourceDir, manifest);
+        const extensionsContent = generateProgrammaticExtension(manifest, targetProfile, cmdPaths);
+        files.push({
+            path: 'extensions/index.ts',
+            content: extensionsContent,
+        });
+    }
+    // Generate CLI bin scripts for npm-cli distribution targets
+    if (targetProfile.distribution === 'npm-cli' || (targetProfile.distribution === 'both' && targetProfile.npmPublishable)) {
+        const packageMetadata = targetProfile.packageMetadata ?? {};
+        const isEsm = packageMetadata.moduleType === 'module';
+        const ext = packageMetadata.binScriptExt ?? (isEsm ? '.cjs' : '.js');
+        files.push({ path: `bin/cli${ext}`, content: generateCliBinScript(manifest, targetProfile), executable: true });
+        files.push({ path: `bin/install${ext}`, content: generateInstallScript(manifest, targetProfile), executable: true });
+        files.push({ path: `bin/uninstall${ext}`, content: generateUninstallScript(manifest, targetProfile), executable: true });
+        files.push({ path: `bin/install-shared${ext}`, content: generateInstallShared(manifest, targetProfile, sourceDir) });
+        files.push({ path: `scripts/team-install${ext}`, content: generateTeamInstall(manifest, targetProfile, ext), executable: true });
+        if (packageMetadata.emitCjsWrappers && ext !== '.cjs') {
+            files.push({ path: 'bin/cli.cjs', content: generateCjsWrapper('cli'), executable: true });
+            files.push({ path: 'bin/install.cjs', content: generateCjsWrapper('install'), executable: true });
+            files.push({ path: 'bin/uninstall.cjs', content: generateCjsWrapper('uninstall'), executable: true });
+            files.push({ path: 'bin/install-shared.cjs', content: generateCjsWrapper('install-shared', true) });
+        }
+    }
+    // Generate installation instructions for all targets
+    files.push({
+        path: 'README.md',
+        content: generateInstallInstructions(manifest, targetProfile, sourceDir),
+    });
+    // .gitignore
+    files.push({
+        path: '.gitignore',
+        content: `node_modules/\ndist/\n${sdkCfg.stateDir}/runs/\n${sdkCfg.stateDir}/logs/\n${sdkCfg.stateDir}/processes/\n${sdkCfg.stateDir}/artifacts/\n${sdkCfg.stateDir}/session.json\n${sdkCfg.stateDir}/current-run.json\n${sdkCfg.stateDir}/observer.json\n${sdkCfg.stateDir}/index/\n${sdkCfg.stateDir}/team/\n${sdkCfg.stateDir}/config/rules.local.json\n*.sqlite\n*.sqlite-shm\n*.sqlite-wal\n*.log\n.DS_Store\n`,
+    });
+    // Emit target-override extraFiles
+    const extraFiles = resolveExtraFiles(manifest, targetProfile);
+    if (Object.keys(extraFiles).length > 0) {
+        for (const [outputPath, value] of Object.entries(extraFiles)) {
+            if (value.startsWith('file:')) {
+                const srcPath = value.slice(5);
+                const fullPath = path.join(sourceDir, srcPath);
+                if (fs.existsSync(fullPath)) {
+                    const isBinary = /\.(png|jpg|jpeg|gif|ico|woff2?|ttf|eot|svg|pdf)$/i.test(outputPath);
+                    if (isBinary) {
+                        files.push({
+                            path: outputPath,
+                            content: '',
+                            binaryContent: fs.readFileSync(fullPath),
+                        });
+                    }
+                    else {
+                        files.push({
+                            path: outputPath,
+                            content: fs.readFileSync(fullPath, 'utf-8'),
+                        });
+                    }
+                }
+            }
+            else {
+                files.push({ path: outputPath, content: value });
+            }
+        }
+    }
+    if (manifest.postInstall) {
+        const postInstallPath = path.join(sourceDir, manifest.postInstall);
+        if (fs.existsSync(postInstallPath)) {
+            files.push({ path: 'scripts/post-install.js', content: fs.readFileSync(postInstallPath, 'utf-8'), executable: true });
+        }
+    }
+    const adapter = getAdapter(targetProfile.name);
+    if (adapter) {
+        const adapterExtraFiles = adapter.generateExtraTargetFiles(sourceDir, manifest, targetProfile, _diagnostics);
+        files.push(...adapterExtraFiles);
+    }
+    return files;
+}

package/dist/transformHelpers.d.ts

@@ -0,0 +1,13 @@
+import type { A5cPluginManifest, TargetProfile } from './types.js';
+export declare function resolveExtraFiles(manifest: A5cPluginManifest, targetProfile: TargetProfile): Record<string, string>;
+export declare function resolveHarnessInstallSurfaceExports(manifest: A5cPluginManifest, targetProfile: TargetProfile): string[];
+export declare function generatePs1Wrapper(hookSlug: string, adapterName: string, _sourceScript: string): string;
+export declare function generateJsBridge(_name: string, shellScript: string, targetProfile: TargetProfile): string;
+export declare function generateHarnessManifest(manifest: A5cPluginManifest, targetProfile: TargetProfile): string;
+export declare function generateTeamInstall(manifest: A5cPluginManifest, _targetProfile: TargetProfile, ext?: string): string;
+export declare function generateOpenClawNativeHooksSection(manifest: A5cPluginManifest, targetProfile: TargetProfile): Record<string, string>;
+export declare function generateOpenCodeAccomplishSkill(manifest: A5cPluginManifest): string | null;
+export declare function generateTsHookStub(nativeHook: string, nativeSlug: string, shellScriptName: string, targetProfile: TargetProfile): string;
+export declare function generateGeminiPostinstall(pluginName: string): string;
+export declare function generateGeminiPreuninstall(pluginName: string): string;
+//# sourceMappingURL=transformHelpers.d.ts.map

package/dist/transformHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transformHelpers.d.ts","sourceRoot":"","sources":["../src/transformHelpers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAwBnE,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAkBxB;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,GAC3B,MAAM,EAAE,CAmBV;AAED,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,MAAM,CAcR;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,aAAa,GAC3B,MAAM,CA4BR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,GAC3B,MAAM,CAkBR;AAGD,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,iBAAiB,EAC3B,cAAc,EAAE,aAAa,EAC7B,GAAG,SAAQ,GACV,MAAM,CA0BR;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,iBAAiB,EAC3B,aAAa,EAAE,aAAa,GAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,GAAG,IAAI,CAkBf;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,aAAa,GAC3B,MAAM,CAyBR;AAED,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAoBpE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBrE"}

package/dist/transformHelpers.js

@@ -0,0 +1,239 @@
+// Helper functions for the transform stage
+// Extracted to keep transform.ts under the max-lines limit
+function buildTemplateVars(manifest, targetProfile) {
+    const override = manifest.targets?.[targetProfile.name];
+    const overrideVars = override?.templateVars ?? {};
+    const targetDir = typeof overrideVars.targetDir === 'string' ? overrideVars.targetDir : targetProfile.name;
+    return {
+        target: targetProfile.name,
+        targetName: targetProfile.name,
+        targetDir,
+        ...overrideVars,
+    };
+}
+function interpolateTemplate(value, vars) {
+    return value.replace(/\{\{([a-zA-Z0-9_-]+)\}\}/g, (match, key) => vars[key] ?? match);
+}
+export function resolveExtraFiles(manifest, targetProfile) {
+    const override = manifest.targets?.[targetProfile.name];
+    const vars = buildTemplateVars(manifest, targetProfile);
+    const resolved = {};
+    for (const setName of override?.extraFileSets ?? []) {
+        const set = manifest.extraFileSets?.[setName];
+        if (!set)
+            continue;
+        for (const [outputPath, value] of Object.entries(set)) {
+            resolved[interpolateTemplate(outputPath, vars)] = interpolateTemplate(value, vars);
+        }
+    }
+    for (const [outputPath, value] of Object.entries(override?.extraFiles ?? {})) {
+        resolved[interpolateTemplate(outputPath, vars)] = interpolateTemplate(value, vars);
+    }
+    return resolved;
+}
+export function resolveHarnessInstallSurfaceExports(manifest, targetProfile) {
+    const override = manifest.targets?.[targetProfile.name];
+    const resolved = [];
+    const seen = new Set();
+    const addEntries = (entries) => {
+        if (!Array.isArray(entries))
+            return;
+        for (const entry of entries) {
+            if (typeof entry !== 'string' || seen.has(entry))
+                continue;
+            seen.add(entry);
+            resolved.push(entry);
+        }
+    };
+    for (const setName of override?.harnessInstallSurfaceExportSets ?? []) {
+        addEntries(manifest.harnessInstallSurfaceExportSets?.[setName]);
+    }
+    addEntries(override?.harnessInstallSurfaceExports);
+    return resolved;
+}
+export function generatePs1Wrapper(hookSlug, adapterName, _sourceScript) {
+    return `# PowerShell hook wrapper — sets env vars and delegates to bash
+$env:HOOK_TYPE = '${hookSlug}'
+$env:ADAPTER_NAME = '${adapterName}'
+$env:PLUGIN_ROOT = Split-Path -Parent (Split-Path -Parent $PSScriptRoot)
+
+$input_data = [Console]::In.ReadToEnd()
+$result = $input_data | & bash "$PSScriptRoot/../$($MyInvocation.MyCommand.Name -replace '\\.ps1$','.sh')" 2>$null
+if ($LASTEXITCODE -eq 0 -and $result) {
+  Write-Output $result
+} else {
+  Write-Output '{}'
+}
+`;
+}
+export function generateJsBridge(_name, shellScript, targetProfile) {
+    const pluginRootEnvVar = targetProfile.pluginRootEnvVarForExtension || 'PLUGIN_ROOT';
+    const defaultAdapterName = targetProfile.adapterName;
+    return `#!/usr/bin/env node
+"use strict";
+var execSync = require("child_process").execSync;
+var path = require("path");
+var readFileSync = require("fs").readFileSync;
+
+var PLUGIN_ROOT = process.env.${pluginRootEnvVar} || process.env.PLUGIN_ROOT || path.resolve(__dirname, "..");
+var stdin = "";
+try { stdin = readFileSync(0, "utf8"); } catch {}
+try {
+  var result = execSync("bash " + JSON.stringify(path.join(PLUGIN_ROOT, "${shellScript}")), {
+    input: stdin,
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 30000,
+    env: Object.assign({}, process.env, {
+      HOOK_TYPE: process.env.HOOK_TYPE || "",
+      ADAPTER_NAME: process.env.ADAPTER_NAME || "${defaultAdapterName}",
+      PLUGIN_ROOT: PLUGIN_ROOT
+    })
+  });
+  process.stdout.write(result);
+} catch (e) {
+  process.stdout.write("{}\\n");
+}
+`;
+}
+export function generateHarnessManifest(manifest, targetProfile) {
+    const override = manifest.targets?.[targetProfile.name];
+    const base = {
+        name: manifest.name,
+        version: manifest.version,
+        description: manifest.description,
+        author: manifest.author,
+        license: manifest.license,
+    };
+    if (manifest.repository)
+        base.repository = manifest.repository;
+    if (manifest.keywords)
+        base.keywords = manifest.keywords;
+    if (override?.harnessManifest) {
+        Object.assign(base, override.harnessManifest);
+    }
+    return JSON.stringify(base, null, 2) + '\n';
+}
+export function generateTeamInstall(manifest, _targetProfile, ext = '.js') {
+    const sharedRequire = ext === '.js' ? '../bin/install-shared' : `../bin/install-shared${ext}`;
+    return `#!/usr/bin/env node
+'use strict';
+
+var path = require('path');
+var shared = require('${sharedRequire}');
+
+var workspace = process.cwd();
+for (var i = 0; i < process.argv.length; i++) {
+  if (process.argv[i] === '--workspace' && process.argv[i + 1]) {
+    workspace = path.resolve(process.argv[i + 1]);
+  }
+}
+
+var src = process.env.PLUGIN_PACKAGE_ROOT || path.resolve(__dirname, '..');
+var dest = shared.getHomePluginRoot('workspace');
+console.log('[${manifest.name}] Team install to ' + dest);
+
+shared.copyPluginBundle(src, dest);
+if (typeof shared.harnessTeamInstall === 'function') {
+  shared.harnessTeamInstall(src, dest, workspace);
+}
+shared.runPostInstall(dest);
+console.log('[${manifest.name}] Team install complete.');
+`;
+}
+export function generateOpenClawNativeHooksSection(manifest, targetProfile) {
+    const hooks = {};
+    if (manifest.hooks) {
+        for (const [canonicalHook, handlerPath] of Object.entries(manifest.hooks)) {
+            if (handlerPath === null)
+                continue;
+            const nativeHook = targetProfile.supportedHooks.get(canonicalHook);
+            if (nativeHook) {
+                hooks[nativeHook] = `extensions/hooks/${nativeHook.replace(/[._]/g, '-').replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase()}.ts`;
+            }
+        }
+    }
+    return hooks;
+}
+export function generateOpenCodeAccomplishSkill(manifest) {
+    if (!manifest.skills || manifest.skills.length === 0)
+        return null;
+    const primarySkill = manifest.skills[0];
+    return `---
+name: ${manifest.name}
+description: ${manifest.description}
+command: /${primarySkill.name}
+verified: true
+---
+
+# ${manifest.name}
+
+${manifest.description}
+
+(This is a specialized accomplish-mode variant for OpenCode's accomplish workflow.)
+`;
+}
+export function generateTsHookStub(nativeHook, nativeSlug, shellScriptName, targetProfile) {
+    const handlerName = nativeHook
+        .replace(/[._]([a-z])/g, (_, c) => c.toUpperCase())
+        + 'Handler';
+    return `/**
+ * ${targetProfile.displayName} ${nativeHook} hook — delegates to shell script.
+ */
+import { execFileSync } from "node:child_process";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PLUGIN_ROOT = resolve(__dirname, "../..");
+
+export async function ${handlerName}(context: Record<string, unknown>): Promise<void> {
+  try {
+    execFileSync("bash", [resolve(PLUGIN_ROOT, "hooks/${shellScriptName}")], {
+      input: JSON.stringify(context),
+      stdio: ["pipe", "pipe", "pipe"],
+      timeout: 30000,
+      env: { ...process.env, ADAPTER_NAME: "${targetProfile.adapterName}", PLUGIN_ROOT },
+    });
+  } catch { /* best-effort */ }
+}
+`;
+}
+export function generateGeminiPostinstall(pluginName) {
+    return `#!/usr/bin/env node
+'use strict';
+var path = require('path');
+var spawnSync = require('child_process').spawnSync;
+var fs = require('fs');
+
+var PACKAGE_ROOT = path.resolve(__dirname, '..');
+var extDir = path.join(require('os').homedir(), '.gemini', 'extensions', '${pluginName}');
+
+if (!process.env.npm_config_global) process.exit(0);
+try { if (fs.lstatSync(extDir).isSymbolicLink()) process.exit(0); } catch {}
+
+try {
+  var result = spawnSync('gemini', ['extensions', 'install', PACKAGE_ROOT], { stdio: 'inherit', timeout: 60000 });
+  if (result.status === 0) process.exit(0);
+} catch {}
+
+console.log('[${pluginName}-gemini] Gemini CLI not found. Run: ${pluginName}-gemini install');
+`;
+}
+export function generateGeminiPreuninstall(pluginName) {
+    return `#!/usr/bin/env node
+'use strict';
+var path = require('path');
+var spawnSync = require('child_process').spawnSync;
+var fs = require('fs');
+
+var extDir = path.join(require('os').homedir(), '.gemini', 'extensions', '${pluginName}');
+
+try { if (!fs.existsSync(extDir) || fs.lstatSync(extDir).isSymbolicLink()) process.exit(0); } catch {}
+
+try {
+  spawnSync('gemini', ['extensions', 'uninstall', '${pluginName}'], { stdio: 'inherit', timeout: 30000 });
+} catch {
+  try { fs.rmSync(extDir, { recursive: true, force: true }); } catch {}
+}
+`;
+}