@bluefly/openstandardagents 0.4.4 → 0.4.6

package/dist/adapters/base/adapter.interface.js

@@ -8,6 +8,8 @@
  * DRY: Reusable across all platform adapters
  */
 import * as yaml from 'yaml';
+import { isMultiAgentManifest } from '../../services/multi-agent/team-generator.service.js';
+import { generatePerfectAgentBundle } from './common-file-generator.js';
 /**
  * Base adapter implementation with common functionality
  */
@@ -92,5 +94,45 @@ export class BaseAdapter {
     createManifestFile(manifest) {
         return this.createFile('agent.ossa.yaml', yaml.stringify(manifest), 'config', 'yaml');
     }
+    /**
+     * Default toConfig() — throws unless overridden by the adapter.
+     * Adapters that support lightweight config-only export should override this.
+     */
+    async toConfig(manifest) {
+        throw new Error(`toConfig() is not implemented for platform "${this.platform}". ` +
+            `Use export() for full file scaffold export.`);
+    }
+    // ── Perfect Agent Export ─────────────────────────────────────────
+    /**
+     * Resolve effective options: if perfectAgent is set, enable all flags.
+     */
+    resolvePerfectAgentOptions(options) {
+        const opts = { ...options };
+        if (opts.perfectAgent) {
+            opts.includeAgentCard ??= true;
+            opts.includeAgentsMd ??= true;
+            opts.includeDID ??= true;
+            opts.includeEvals ??= true;
+            opts.includeGovernance ??= true;
+            opts.includeObservability ??= true;
+            opts.includeSkill ??= true;
+            opts.includeTeam ??= true;
+        }
+        return opts;
+    }
+    /**
+     * Detect if manifest defines a multi-agent system
+     */
+    isMultiAgent(manifest) {
+        return isMultiAgentManifest(manifest);
+    }
+    /**
+     * Generate all "perfect agent" supplementary files.
+     * Called by adapters when ExportOptions.perfectAgent is true.
+     * Delegates to generatePerfectAgentBundle() in common-file-generator.
+     */
+    generatePerfectAgentFiles(manifest, options) {
+        return generatePerfectAgentBundle(manifest, options);
+    }
 }
 //# sourceMappingURL=adapter.interface.js.map

package/dist/adapters/base/base-exporter.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Base Exporter - Abstract class for export orchestration
+ *
+ * Extracts the common export pattern shared across all platform adapters:
+ * 1. Start timing
+ * 2. Validate manifest (optional, based on options)
+ * 3. Generate platform-specific files (delegated to subclass)
+ * 4. Return result with timing metadata
+ * 5. Catch and wrap errors
+ *
+ * This eliminates ~53% duplication across adapters by centralizing:
+ * - Export method boilerplate (validation, timing, error handling)
+ * - Validate method boilerplate (base + platform-specific merge)
+ * - Common file generation (package.json, tsconfig.json, README)
+ *
+ * SOLID: Template Method pattern - subclasses provide platform-specific logic
+ * DRY: All orchestration boilerplate lives here, not in each adapter
+ */
+import { BaseAdapter } from './adapter.interface.js';
+import type { OssaAgent, ExportOptions, ExportResult, ExportFile, ValidationResult, ValidationError, ValidationWarning } from './adapter.interface.js';
+import { type PackageJsonOptions, type TsConfigOptions, type ReadmeSections } from './common-file-generator.js';
+/**
+ * Abstract Base Exporter
+ *
+ * Subclasses implement:
+ * - generateFiles() - platform-specific file generation
+ * - platformValidate() - platform-specific validation rules
+ * - getExportVersion() - version string for metadata
+ *
+ * The base class handles:
+ * - Export orchestration (timing, validation, error handling)
+ * - Manifest provenance file generation
+ * - Common file helpers (package.json, tsconfig, README, gitignore)
+ */
+export declare abstract class BaseExporter extends BaseAdapter {
+    /**
+     * Generate platform-specific files from the manifest.
+     * This is the core method subclasses must implement.
+     *
+     * @param manifest - Validated OSSA agent manifest
+     * @param options - Export options
+     * @returns Array of generated files
+     */
+    protected abstract generateFiles(manifest: OssaAgent, options?: ExportOptions): Promise<ExportFile[]>;
+    /**
+     * Platform-specific validation rules.
+     * Called after base validation. Override to add platform checks.
+     *
+     * @param manifest - OSSA agent manifest
+     * @returns Object with arrays of errors and warnings
+     */
+    protected platformValidate(manifest: OssaAgent): {
+        errors: ValidationError[];
+        warnings: ValidationWarning[];
+    };
+    /**
+     * Get the export adapter version for metadata.
+     * Override to provide a specific version string.
+     */
+    protected getExportVersion(): string;
+    /**
+     * Export OSSA manifest to platform-specific format.
+     * Orchestrates: validate -> generate -> wrap result with timing.
+     *
+     * Subclasses do NOT need to override this. Implement generateFiles() instead.
+     */
+    export(manifest: OssaAgent, options?: ExportOptions): Promise<ExportResult>;
+    /**
+     * Validate manifest for platform compatibility.
+     * Merges base validation with platform-specific rules.
+     *
+     * Subclasses do NOT need to override this. Implement platformValidate() instead.
+     */
+    validate(manifest: OssaAgent): Promise<ValidationResult>;
+    /**
+     * Generate a package.json file using shared generator
+     */
+    protected generatePackageJsonFile(manifest: OssaAgent, prefix: string, options?: PackageJsonOptions): ExportFile;
+    /**
+     * Generate a tsconfig.json file using shared generator
+     */
+    protected generateTsConfigFile(prefix: string, options?: TsConfigOptions): ExportFile;
+    /**
+     * Generate a README.md file using shared generator
+     */
+    protected generateReadmeFile(manifest: OssaAgent, prefix: string, sections?: ReadmeSections): ExportFile;
+    /**
+     * Generate a .gitignore file using shared generator
+     */
+    protected generateGitIgnoreFile(prefix: string): ExportFile;
+    /**
+     * Helper: Get the agent name from manifest with fallback
+     */
+    protected getAgentName(manifest: OssaAgent, fallback?: string): string;
+    /**
+     * Helper: Get the agent description from manifest
+     */
+    protected getAgentDescription(manifest: OssaAgent): string;
+    /**
+     * Helper: Extract tools array from manifest
+     */
+    protected getTools(manifest: OssaAgent): Array<Record<string, unknown>>;
+    /**
+     * Helper: Extract capabilities array from manifest (as strings)
+     */
+    protected getCapabilities(manifest: OssaAgent): string[];
+}
+//# sourceMappingURL=base-exporter.d.ts.map

package/dist/adapters/base/base-exporter.js

@@ -0,0 +1,165 @@
+/**
+ * Base Exporter - Abstract class for export orchestration
+ *
+ * Extracts the common export pattern shared across all platform adapters:
+ * 1. Start timing
+ * 2. Validate manifest (optional, based on options)
+ * 3. Generate platform-specific files (delegated to subclass)
+ * 4. Return result with timing metadata
+ * 5. Catch and wrap errors
+ *
+ * This eliminates ~53% duplication across adapters by centralizing:
+ * - Export method boilerplate (validation, timing, error handling)
+ * - Validate method boilerplate (base + platform-specific merge)
+ * - Common file generation (package.json, tsconfig.json, README)
+ *
+ * SOLID: Template Method pattern - subclasses provide platform-specific logic
+ * DRY: All orchestration boilerplate lives here, not in each adapter
+ */
+import { BaseAdapter } from './adapter.interface.js';
+import { generatePackageJson, generateTsConfig, generateGitIgnore, generateReadme, } from './common-file-generator.js';
+/**
+ * Abstract Base Exporter
+ *
+ * Subclasses implement:
+ * - generateFiles() - platform-specific file generation
+ * - platformValidate() - platform-specific validation rules
+ * - getExportVersion() - version string for metadata
+ *
+ * The base class handles:
+ * - Export orchestration (timing, validation, error handling)
+ * - Manifest provenance file generation
+ * - Common file helpers (package.json, tsconfig, README, gitignore)
+ */
+export class BaseExporter extends BaseAdapter {
+    /**
+     * Platform-specific validation rules.
+     * Called after base validation. Override to add platform checks.
+     *
+     * @param manifest - OSSA agent manifest
+     * @returns Object with arrays of errors and warnings
+     */
+    platformValidate(manifest) {
+        return { errors: [], warnings: [] };
+    }
+    /**
+     * Get the export adapter version for metadata.
+     * Override to provide a specific version string.
+     */
+    getExportVersion() {
+        return '1.0.0';
+    }
+    /**
+     * Export OSSA manifest to platform-specific format.
+     * Orchestrates: validate -> generate -> wrap result with timing.
+     *
+     * Subclasses do NOT need to override this. Implement generateFiles() instead.
+     */
+    async export(manifest, options) {
+        const startTime = Date.now();
+        try {
+            // Step 1: Validate manifest (unless explicitly disabled)
+            if (options?.validate !== false) {
+                const validation = await this.validate(manifest);
+                if (!validation.valid) {
+                    return this.createResult(false, [], `Validation failed: ${validation.errors?.map((e) => e.message).join(', ')}`, {
+                        duration: Date.now() - startTime,
+                        warnings: validation.warnings?.map((w) => w.message),
+                    });
+                }
+            }
+            // Step 2: Generate platform-specific files
+            const files = await this.generateFiles(manifest, options);
+            // Step 3: Append provenance manifest
+            files.push(this.createManifestFile(manifest));
+            // Step 4: Return success result with timing
+            return this.createResult(true, files, undefined, {
+                duration: Date.now() - startTime,
+                version: this.getExportVersion(),
+            });
+        }
+        catch (error) {
+            return this.createResult(false, [], error instanceof Error ? error.message : String(error), { duration: Date.now() - startTime });
+        }
+    }
+    /**
+     * Validate manifest for platform compatibility.
+     * Merges base validation with platform-specific rules.
+     *
+     * Subclasses do NOT need to override this. Implement platformValidate() instead.
+     */
+    async validate(manifest) {
+        const errors = [];
+        const warnings = [];
+        // Base validation (metadata.name, metadata.version, spec.role)
+        const baseValidation = await super.validate(manifest);
+        if (baseValidation.errors)
+            errors.push(...baseValidation.errors);
+        if (baseValidation.warnings)
+            warnings.push(...baseValidation.warnings);
+        // Platform-specific validation
+        const platformResult = this.platformValidate(manifest);
+        errors.push(...platformResult.errors);
+        warnings.push(...platformResult.warnings);
+        return {
+            valid: errors.length === 0,
+            errors: errors.length > 0 ? errors : undefined,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        };
+    }
+    // ──────────────────────────────────────────────────────────────────
+    // Common File Generation Helpers
+    // Delegates to shared common-file-generator.ts, reducing duplication
+    // ──────────────────────────────────────────────────────────────────
+    /**
+     * Generate a package.json file using shared generator
+     */
+    generatePackageJsonFile(manifest, prefix, options) {
+        return this.createFile(`${prefix}/package.json`, generatePackageJson(manifest, this.platform, options), 'config');
+    }
+    /**
+     * Generate a tsconfig.json file using shared generator
+     */
+    generateTsConfigFile(prefix, options) {
+        return this.createFile(`${prefix}/tsconfig.json`, generateTsConfig(options), 'config');
+    }
+    /**
+     * Generate a README.md file using shared generator
+     */
+    generateReadmeFile(manifest, prefix, sections) {
+        return this.createFile(`${prefix}/README.md`, generateReadme(manifest, this.platform, sections), 'documentation');
+    }
+    /**
+     * Generate a .gitignore file using shared generator
+     */
+    generateGitIgnoreFile(prefix) {
+        return this.createFile(`${prefix}/.gitignore`, generateGitIgnore(this.platform), 'config');
+    }
+    /**
+     * Helper: Get the agent name from manifest with fallback
+     */
+    getAgentName(manifest, fallback) {
+        return manifest.metadata?.name || fallback || this.platform + '-agent';
+    }
+    /**
+     * Helper: Get the agent description from manifest
+     */
+    getAgentDescription(manifest) {
+        return (manifest.spec?.role ||
+            manifest.metadata?.description ||
+            `${this.displayName} agent`);
+    }
+    /**
+     * Helper: Extract tools array from manifest
+     */
+    getTools(manifest) {
+        return (manifest.spec?.tools || []);
+    }
+    /**
+     * Helper: Extract capabilities array from manifest (as strings)
+     */
+    getCapabilities(manifest) {
+        return (manifest.spec?.capabilities || []).map((c) => (typeof c === 'string' ? c : c.name || ''));
+    }
+}
+//# sourceMappingURL=base-exporter.js.map

package/dist/adapters/base/common-file-generator.d.ts

@@ -8,6 +8,8 @@
  * DRY: Eliminates 8,000+ duplicate lines across adapters
  */
 import type { OssaAgent } from '../../types/index.js';
+import type { ExportFile, ExportOptions } from './adapter.interface.js';
+import { type TeamTargetPlatform } from '../../services/multi-agent/team-generator.service.js';
 /**
  * Supported target platforms for file generation
  */
@@ -134,6 +136,35 @@ export declare function generateLicense(type: string): string;
  * @returns CHANGELOG content
  */
 export declare function generateChangelog(manifest: OssaAgent): string;
+/**
+ * Options for standalone perfect agent file generation.
+ */
+export interface PerfectAgentOptions {
+    includeAgentCard?: boolean;
+    includeAgentsMd?: boolean;
+    includeEvals?: boolean;
+    includeGovernance?: boolean;
+    includeObservability?: boolean;
+    includeSkill?: boolean;
+    includeTeam?: boolean;
+    platform?: string;
+}
+interface GeneratedFile {
+    path: string;
+    content: string;
+    type: 'code' | 'config' | 'documentation' | 'test' | 'other';
+    language?: string;
+}
+/**
+ * Standalone perfect agent file generator.
+ * Use this from CLI or non-adapter contexts.
+ * Delegates to generatePerfectAgentBundle for actual file generation.
+ *
+ * @param manifest - OSSA agent manifest
+ * @param options - Which sections to include (all enabled by default)
+ * @returns Array of generated files
+ */
+export declare function generatePerfectAgentFiles(manifest: OssaAgent, options?: PerfectAgentOptions): Promise<GeneratedFile[]>;
 /**
  * Sanitize a string for use as an npm package name.
  *
@@ -157,4 +188,30 @@ export declare function extractMetadata(manifest: OssaAgent): {
     author: string | undefined;
     apiVersion: string;
 };
+/**
+ * Generate team scaffolding files from manifest spec.team.
+ *
+ * @param manifest - OSSA agent manifest with spec.team
+ * @param platform - Target platform for code generation
+ * @returns Array of ExportFile objects
+ */
+export declare function generateTeamFilesForExport(manifest: OssaAgent, platform?: TeamTargetPlatform, includeDocumentation?: boolean): ExportFile[];
+/**
+ * Generate AGENTS.md file from manifest with team topology awareness.
+ *
+ * @param manifest - OSSA agent manifest
+ * @returns ExportFile for AGENTS.md
+ */
+export declare function generateAgentsMdFile(manifest: OssaAgent): ExportFile;
+/**
+ * Generate the complete "perfect agent" bundle: AGENTS.md + team scaffolding +
+ * evals + governance + observability.
+ *
+ * @param manifest - OSSA agent manifest
+ * @param options - Export options controlling which parts are included
+ * @param platform - Target platform for team code generation
+ * @returns Array of ExportFile objects
+ */
+export declare function generatePerfectAgentBundle(manifest: OssaAgent, options?: ExportOptions, platform?: TeamTargetPlatform): ExportFile[];
+export {};
 //# sourceMappingURL=common-file-generator.d.ts.map

package/dist/adapters/base/common-file-generator.js

@@ -8,6 +8,9 @@
  * DRY: Eliminates 8,000+ duplicate lines across adapters
  */
 import { renderConditional } from './template-engine.js';
+import { isMultiAgentManifest, generateTeamFiles, generateSubagentFiles, } from '../../services/multi-agent/team-generator.service.js';
+import { generateAgentsMd } from '../../services/agents-md/agents-md-generator.service.js';
+import { generateEvalStubs, generateGovernanceConfig, generateObservabilityConfig, generateSkillContent, } from './perfect-agent-utils.js';
 // ──────────────────────────────────────────────────────────────────
 // Package.json Generation
 // ──────────────────────────────────────────────────────────────────
@@ -122,8 +125,7 @@ export function generatePackageJson(manifest, platform, options) {
     const pkg = {
         name,
         version: manifest.metadata?.version || '1.0.0',
-        description: manifest.metadata?.description ||
-            `OSSA agent for ${platform}`,
+        description: manifest.metadata?.description || `OSSA agent for ${platform}`,
         type: options?.type ?? 'module',
         main: options?.main ?? 'index.js',
     };
@@ -151,10 +153,15 @@ export function generatePackageJson(manifest, platform, options) {
     if (Object.keys(devDeps).length > 0) {
         pkg.devDependencies = devDeps;
     }
-    if (options?.peerDependencies && Object.keys(options.peerDependencies).length > 0) {
+    if (options?.peerDependencies &&
+        Object.keys(options.peerDependencies).length > 0) {
         pkg.peerDependencies = options.peerDependencies;
     }
-    pkg.keywords = [...defaultKeywords, ...labels, ...(options?.extraKeywords || [])];
+    pkg.keywords = [
+        ...defaultKeywords,
+        ...labels,
+        ...(options?.extraKeywords || []),
+    ];
     pkg.license = manifest.metadata?.license || 'MIT';
     if (manifest.metadata?.author) {
         pkg.author = manifest.metadata.author;
@@ -323,7 +330,8 @@ tests/
  */
 export function generateReadme(manifest, platform, sections) {
     const name = manifest.metadata?.name || 'OSSA Agent';
-    const description = manifest.metadata?.description || `${platform} agent generated from OSSA manifest`;
+    const description = manifest.metadata?.description ||
+        `${platform} agent generated from OSSA manifest`;
     const role = manifest.spec?.role || 'AI Agent';
     const license = manifest.metadata?.license || 'MIT';
     const apiVersion = manifest.apiVersion?.split('/')[1] || 'v0.4.1';
@@ -547,9 +555,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Agent configuration and metadata
 ${manifest.spec?.tools && Array.isArray(manifest.spec.tools) && manifest.spec.tools.length > 0 ? `- ${manifest.spec.tools.length} tool(s) configured\n` : ''}`;
 }
-// ──────────────────────────────────────────────────────────────────
-// Utility Functions
-// ──────────────────────────────────────────────────────────────────
+/**
+ * Standalone perfect agent file generator.
+ * Use this from CLI or non-adapter contexts.
+ * Delegates to generatePerfectAgentBundle for actual file generation.
+ *
+ * @param manifest - OSSA agent manifest
+ * @param options - Which sections to include (all enabled by default)
+ * @returns Array of generated files
+ */
+export async function generatePerfectAgentFiles(manifest, options) {
+    return generatePerfectAgentBundle(manifest, options);
+}
 /**
  * Sanitize a string for use as an npm package name.
  *
@@ -581,4 +598,100 @@ export function extractMetadata(manifest) {
         apiVersion: manifest.apiVersion?.split('/')[1] || 'v0.4.1',
     };
 }
+// ──────────────────────────────────────────────────────────────────
+// Multi-Agent Team File Generation
+// ──────────────────────────────────────────────────────────────────
+/**
+ * Generate team scaffolding files from manifest spec.team.
+ *
+ * @param manifest - OSSA agent manifest with spec.team
+ * @param platform - Target platform for code generation
+ * @returns Array of ExportFile objects
+ */
+export function generateTeamFilesForExport(manifest, platform = 'generic', includeDocumentation = true) {
+    if (!isMultiAgentManifest(manifest))
+        return [];
+    const files = [];
+    const teamFiles = generateTeamFiles(manifest, {
+        platform,
+        includeDocumentation,
+    });
+    for (const tf of teamFiles) {
+        files.push({
+            path: tf.path,
+            content: tf.content,
+            type: tf.type,
+            language: tf.language,
+        });
+    }
+    const subagentFiles = generateSubagentFiles(manifest, { platform });
+    for (const sf of subagentFiles) {
+        files.push({
+            path: sf.path,
+            content: sf.content,
+            type: sf.type,
+            language: sf.language,
+        });
+    }
+    return files;
+}
+/**
+ * Generate AGENTS.md file from manifest with team topology awareness.
+ *
+ * @param manifest - OSSA agent manifest
+ * @returns ExportFile for AGENTS.md
+ */
+export function generateAgentsMdFile(manifest) {
+    const content = generateAgentsMd(manifest);
+    return {
+        path: 'AGENTS.md',
+        content,
+        type: 'documentation',
+        language: 'markdown',
+    };
+}
+/**
+ * Generate the complete "perfect agent" bundle: AGENTS.md + team scaffolding +
+ * evals + governance + observability.
+ *
+ * @param manifest - OSSA agent manifest
+ * @param options - Export options controlling which parts are included
+ * @param platform - Target platform for team code generation
+ * @returns Array of ExportFile objects
+ */
+export function generatePerfectAgentBundle(manifest, options, platform = 'generic') {
+    const files = [];
+    const isPerfect = options?.perfectAgent ?? options === undefined;
+    const includeAgentsMd = isPerfect || options?.includeAgentsMd;
+    const includeTeam = isPerfect || options?.includeTeam;
+    const includeSkill = isPerfect || options?.includeSkill;
+    const includeEvals = isPerfect || options?.includeEvals;
+    const includeGovernance = isPerfect || options?.includeGovernance;
+    const includeObservability = isPerfect || options?.includeObservability;
+    if (includeAgentsMd) {
+        files.push(generateAgentsMdFile(manifest));
+    }
+    if (includeSkill) {
+        const skillContent = generateSkillContent(manifest);
+        files.push({
+            path: 'skills/SKILL.md',
+            content: skillContent,
+            type: 'documentation',
+            language: 'markdown',
+        });
+    }
+    if (includeTeam) {
+        files.push(...generateTeamFilesForExport(manifest, platform));
+    }
+    if (includeEvals) {
+        files.push(generateEvalStubs(manifest));
+    }
+    if (includeGovernance) {
+        files.push(generateGovernanceConfig(manifest));
+    }
+    if (includeObservability) {
+        files.push(generateObservabilityConfig(manifest));
+    }
+    return files;
+}
 //# sourceMappingURL=common-file-generator.js.map

package/dist/adapters/base/index.d.ts

@@ -15,7 +15,9 @@
  * ```
  */
 export { BaseAdapter, type PlatformAdapter, type ExportResult, type ExportFile, type ExportOptions, type ValidationResult, type ValidationError, type ValidationWarning, type OssaAgent, } from './adapter.interface.js';
-export { generatePackageJson, generateTsConfig, generateGitIgnore, generateDockerIgnore, generateReadme, generateLicense, generateChangelog, sanitizePackageName, extractMetadata, type Platform, type PackageJsonOptions, type TsConfigOptions, type ReadmeSections, } from './common-file-generator.js';
+export { BaseExporter } from './base-exporter.js';
+export { generatePackageJson, generateTsConfig, generateGitIgnore, generateDockerIgnore, generateReadme, generateLicense, generateChangelog, sanitizePackageName, extractMetadata, generateTeamFilesForExport, generateAgentsMdFile, generatePerfectAgentBundle, type Platform, type PackageJsonOptions, type TsConfigOptions, type ReadmeSections, } from './common-file-generator.js';
 export { validate as validateManifest, validateWorkflow, validateLLM, validateTools, isValidSemver, isValidNpmName, mergeResults, type ManifestValidationResult, } from './manifest-validator.js';
+export { generateSkillContent, generateEvalStubs, generateGovernanceConfig, generateObservabilityConfig, } from './perfect-agent-utils.js';
 export { render, renderConditional, README_TEMPLATE, INSTALL_TEMPLATE, type TemplateData, } from './template-engine.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/adapters/base/index.js

@@ -16,10 +16,14 @@
  */
 // Base adapter interface and types
 export { BaseAdapter, } from './adapter.interface.js';
+// Base exporter with common orchestration (DRY export pattern)
+export { BaseExporter } from './base-exporter.js';
 // Common file generators
-export { generatePackageJson, generateTsConfig, generateGitIgnore, generateDockerIgnore, generateReadme, generateLicense, generateChangelog, sanitizePackageName, extractMetadata, } from './common-file-generator.js';
+export { generatePackageJson, generateTsConfig, generateGitIgnore, generateDockerIgnore, generateReadme, generateLicense, generateChangelog, sanitizePackageName, extractMetadata, generateTeamFilesForExport, generateAgentsMdFile, generatePerfectAgentBundle, } from './common-file-generator.js';
 // Manifest validation
 export { validate as validateManifest, validateWorkflow, validateLLM, validateTools, isValidSemver, isValidNpmName, mergeResults, } from './manifest-validator.js';
+// Perfect agent utilities
+export { generateSkillContent, generateEvalStubs, generateGovernanceConfig, generateObservabilityConfig, } from './perfect-agent-utils.js';
 // Template engine
 export { render, renderConditional, README_TEMPLATE, INSTALL_TEMPLATE, } from './template-engine.js';
 //# sourceMappingURL=index.js.map

package/dist/adapters/base/manifest-validator.d.ts

@@ -7,10 +7,8 @@
  * SOLID: Single Responsibility - Manifest validation only
  * DRY: Single source of truth for validation rules
  *
- * TODO: Consolidate into ValidationZodService. This module duplicates
- * validation logic that exists in src/services/validation-zod.service.ts.
- * Adapters currently depend on these functions directly, so migration
- * requires updating all adapter imports in a separate pass.
+ * For schema validation use ValidationZodService (src/services/validation-zod.service.ts).
+ * This module provides adapter-oriented validation (metadata, spec shape) used by export adapters.
  */
 import type { OssaAgent } from '../../types/index.js';
 import type { ValidationError, ValidationWarning } from './adapter.interface.js';

package/dist/adapters/base/manifest-validator.js

@@ -7,10 +7,8 @@
  * SOLID: Single Responsibility - Manifest validation only
  * DRY: Single source of truth for validation rules
  *
- * TODO: Consolidate into ValidationZodService. This module duplicates
- * validation logic that exists in src/services/validation-zod.service.ts.
- * Adapters currently depend on these functions directly, so migration
- * requires updating all adapter imports in a separate pass.
+ * For schema validation use ValidationZodService (src/services/validation-zod.service.ts).
+ * This module provides adapter-oriented validation (metadata, spec shape) used by export adapters.
  */
 /**
  * Validate core OSSA manifest fields required by all adapters.

package/dist/adapters/base/perfect-agent-utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Perfect Agent Utilities
+ *
+ * Utility functions for generating "perfect agent" export bundles.
+ * Provides skill file generation, eval stubs, governance config, and
+ * observability setup reusable across all platform adapters.
+ *
+ * SOLID: Single Responsibility - Perfect agent utilities only
+ * DRY: Reusable across all adapters
+ */
+import type { OssaAgent } from '../../types/index.js';
+import type { ExportFile } from './adapter.interface.js';
+/**
+ * Generate SKILL.md content from an OSSA manifest
+ */
+export declare function generateSkillContent(manifest: OssaAgent): string;
+/**
+ * Generate CLEAR framework evaluation stubs
+ */
+export declare function generateEvalStubs(manifest: OssaAgent): ExportFile;
+/**
+ * Generate governance/compliance configuration
+ */
+export declare function generateGovernanceConfig(manifest: OssaAgent): ExportFile;
+/**
+ * Generate observability configuration (OTel traces/metrics)
+ */
+export declare function generateObservabilityConfig(manifest: OssaAgent): ExportFile;
+//# sourceMappingURL=perfect-agent-utils.d.ts.map