@bluefly/openstandardagents 0.3.5 → 0.3.6

package/dist/services/release-automation/release-agent.service.js

@@ -0,0 +1,42 @@
+/**
+ * Release Agent Service
+ *
+ * Agent-based release automation integrating semantic-release and Keep a Changelog.
+ * FOLLOWS DRY: Single source of truth - OpenAPI spec drives types.
+ * FOLLOWS API-FIRST: OpenAPI spec defined FIRST, then implementation.
+ */
+import { z } from 'zod';
+import { execSync } from 'child_process';
+const ReleaseAnalysisRequestSchema = z.object({
+    branch: z.string().min(1),
+    fromTag: z.string().optional(),
+    toCommit: z.string().optional().default('HEAD'),
+    dryRun: z.boolean().optional().default(false),
+});
+export class ReleaseAgentService {
+    rootDir;
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+    }
+    async analyzeRelease(request) {
+        return {
+            releaseNeeded: false,
+            currentVersion: '0.3.6',
+            commits: [],
+        };
+    }
+    async validateChangelog(changelogPath = 'CHANGELOG.md') {
+        try {
+            execSync(`npx keep-a-changelog validate ${changelogPath} --url https://github.com/blueflyio/openstandardagents`, { encoding: 'utf-8', cwd: this.rootDir });
+            return { valid: true, errors: [], warnings: [] };
+        }
+        catch (error) {
+            return {
+                valid: false,
+                errors: [String(error) || 'Changelog validation failed'],
+                warnings: [],
+            };
+        }
+    }
+}
+//# sourceMappingURL=release-agent.service.js.map

package/dist/services/release-automation/release-agent.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-agent.service.js","sourceRoot":"","sources":["../../../src/services/release-automation/release-agent.service.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC9C,CAAC,CAAC;AAgBH,MAAM,OAAO,mBAAmB;IACV;IAApB,YAAoB,UAAkB,OAAO,CAAC,GAAG,EAAE;QAA/B,YAAO,GAAP,OAAO,CAAwB;IAAG,CAAC;IAEvD,KAAK,CAAC,cAAc,CAClB,OAAqD;QAErD,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,cAAc,EAAE,OAAO;YACvB,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,gBAAwB,cAAc;QAK5D,IAAI,CAAC;YACH,QAAQ,CACN,iCAAiC,aAAa,wDAAwD,EACtG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,CACzC,CAAC;YACF,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,6BAA6B,CAAC;gBACxD,QAAQ,EAAE,EAAE;aACb,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/services/skills/claude-skills.service.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Claude Skills Service
+ * Discovery, generation, and synchronization of Claude Skills from OSSA manifests
+ */
+import type { OssaAgent } from '../../types/index.js';
+export interface ClaudeSkill {
+    name: string;
+    description: string;
+    triggerKeywords: string[];
+    path: string;
+    skillPath?: string;
+}
+export interface SkillGenerationOptions {
+    outputPath?: string;
+    skillName?: string;
+    includeExamples?: boolean;
+}
+export declare class ClaudeSkillsService {
+    /**
+     * Discover Claude Skills from standard locations
+     */
+    discoverSkills(): Promise<ClaudeSkill[]>;
+    /**
+     * Scan directory for Claude Skills
+     */
+    private scanSkillsDirectory;
+    /**
+     * Parse Claude Skill file (SKILL.md)
+     */
+    private parseSkillFile;
+    /**
+     * Generate Claude Skill from OSSA manifest
+     */
+    generateSkillFromOSSA(manifest: OssaAgent, options?: SkillGenerationOptions): Promise<string>;
+    /**
+     * Generate skill content from OSSA manifest
+     */
+    private generateSkillContent;
+    /**
+     * Sync OSSA manifest with Claude Skill
+     */
+    syncSkillToOSSA(skillPath: string, manifestPath: string): Promise<void>;
+    /**
+     * Validate skill against OSSA schema
+     */
+    validateSkill(skillPath: string): Promise<{
+        valid: boolean;
+        errors: string[];
+    }>;
+}
+//# sourceMappingURL=claude-skills.service.d.ts.map

package/dist/services/skills/claude-skills.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-skills.service.d.ts","sourceRoot":"","sources":["../../../src/services/skills/claude-skills.service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBACa,mBAAmB;IAC9B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAmB9C;;OAEG;YACW,mBAAmB;IAmCjC;;OAEG;YACW,cAAc;IAoC5B;;OAEG;IACG,qBAAqB,CACzB,QAAQ,EAAE,SAAS,EACnB,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,MAAM,CAAC;IAoElB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyD5B;;OAEG;IACG,eAAe,CACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAiChB;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAC9C,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CA4BH"}

package/dist/services/skills/claude-skills.service.js

@@ -0,0 +1,252 @@
+/**
+ * Claude Skills Service
+ * Discovery, generation, and synchronization of Claude Skills from OSSA manifests
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { injectable } from 'inversify';
+let ClaudeSkillsService = class ClaudeSkillsService {
+    /**
+     * Discover Claude Skills from standard locations
+     */
+    async discoverSkills() {
+        const skills = [];
+        const skillPaths = [
+            path.join(process.env.HOME || '~', '.claude', 'skills'),
+            path.join(process.cwd(), '.claude', 'skills'),
+            path.join(process.cwd(), 'skills'),
+        ];
+        for (const skillPath of skillPaths) {
+            const resolvedPath = path.resolve(skillPath);
+            if (fs.existsSync(resolvedPath)) {
+                const discovered = await this.scanSkillsDirectory(resolvedPath);
+                skills.push(...discovered);
+            }
+        }
+        return skills;
+    }
+    /**
+     * Scan directory for Claude Skills
+     */
+    async scanSkillsDirectory(dir) {
+        const skills = [];
+        if (!fs.existsSync(dir) || !fs.statSync(dir).isDirectory()) {
+            return skills;
+        }
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const skillDir = path.join(dir, entry.name);
+                const skillFile = path.join(skillDir, 'SKILL.md');
+                if (fs.existsSync(skillFile)) {
+                    try {
+                        const skill = await this.parseSkillFile(skillFile);
+                        skills.push({
+                            ...skill,
+                            path: skillFile,
+                            skillPath: skillDir,
+                        });
+                    }
+                    catch (error) {
+                        // Skip invalid skill files
+                        if (process.env.DEBUG) {
+                            console.warn(`Failed to parse skill: ${skillFile}`, error);
+                        }
+                    }
+                }
+            }
+        }
+        return skills;
+    }
+    /**
+     * Parse Claude Skill file (SKILL.md)
+     */
+    async parseSkillFile(skillPath) {
+        const content = fs.readFileSync(skillPath, 'utf-8');
+        // Extract frontmatter
+        const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            throw new Error('No frontmatter found in SKILL.md');
+        }
+        const frontmatter = yaml.parse(frontmatterMatch[1]);
+        // Extract description from content if not in frontmatter
+        let description = frontmatter.description || '';
+        if (!description) {
+            const contentAfterFrontmatter = content.replace(/^---\n[\s\S]*?\n---\n/, '');
+            const firstParagraph = contentAfterFrontmatter
+                .split('\n\n')
+                .find((p) => p.trim().length > 0);
+            description = firstParagraph?.trim() || '';
+        }
+        return {
+            name: frontmatter.name || path.basename(path.dirname(skillPath)),
+            description,
+            triggerKeywords: frontmatter.trigger_keywords || [],
+            path: skillPath,
+        };
+    }
+    /**
+     * Generate Claude Skill from OSSA manifest
+     */
+    async generateSkillFromOSSA(manifest, options = {}) {
+        const agentName = manifest.metadata?.name || 'unknown-agent';
+        const skillName = options.skillName || agentName;
+        const outputPath = options.outputPath ||
+            path.join(process.cwd(), '.claude', 'skills', skillName);
+        // Ensure directory exists
+        if (!fs.existsSync(outputPath)) {
+            fs.mkdirSync(outputPath, { recursive: true });
+        }
+        const skillPath = path.join(outputPath, 'SKILL.md');
+        // Extract trigger keywords from taxonomy and capabilities
+        const triggerKeywords = [];
+        const taxonomy = manifest.spec?.taxonomy;
+        if (taxonomy?.domain) {
+            triggerKeywords.push(taxonomy.domain);
+        }
+        if (taxonomy?.subdomain) {
+            triggerKeywords.push(taxonomy.subdomain);
+        }
+        if (taxonomy?.capability) {
+            triggerKeywords.push(taxonomy.capability);
+        }
+        // Extract from capabilities (if exists in spec)
+        const specRecord = manifest.spec;
+        if (specRecord.capabilities) {
+            const capabilities = specRecord.capabilities;
+            for (const cap of capabilities) {
+                if (typeof cap === 'string') {
+                    triggerKeywords.push(cap);
+                }
+                else if (cap && typeof cap === 'object' && 'name' in cap) {
+                    triggerKeywords.push(String(cap.name));
+                }
+            }
+        }
+        // Extract from role/system prompt
+        const role = manifest.spec?.role || '';
+        const roleKeywords = role
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((w) => w.length > 4)
+            .slice(0, 5);
+        triggerKeywords.push(...roleKeywords);
+        // Generate skill content
+        const skillContent = this.generateSkillContent(manifest, triggerKeywords, options.includeExamples || false);
+        fs.writeFileSync(skillPath, skillContent, 'utf-8');
+        return skillPath;
+    }
+    /**
+     * Generate skill content from OSSA manifest
+     */
+    generateSkillContent(manifest, triggerKeywords, includeExamples) {
+        const agentName = manifest.metadata?.name || 'agent';
+        const description = manifest.metadata?.description || manifest.spec?.role || 'OSSA agent';
+        const frontmatter = {
+            name: agentName,
+            description: description.substring(0, 200),
+            trigger_keywords: [...new Set(triggerKeywords)].slice(0, 10),
+        };
+        let content = `---\n${yaml.stringify(frontmatter)}---\n\n`;
+        content += `# ${agentName}\n\n`;
+        content += `${description}\n\n`;
+        content += `## Purpose\n\n`;
+        content += `This skill enables Claude to work with the ${agentName} OSSA agent.\n\n`;
+        content += `## OSSA Manifest\n\n`;
+        content += `- **Agent Name**: ${agentName}\n`;
+        content += `- **Version**: ${manifest.metadata?.version || '0.1.0'}\n`;
+        if (manifest.metadata?.labels?.['ossa.ai/domain']) {
+            content += `- **Domain**: ${manifest.metadata.labels['ossa.ai/domain']}\n`;
+        }
+        content += `\n`;
+        if (manifest.spec?.tools && manifest.spec.tools.length > 0) {
+            content += `## Available Tools\n\n`;
+            for (const tool of manifest.spec.tools) {
+                const toolName = typeof tool === 'string' ? tool : tool.name || 'unknown';
+                content += `- ${toolName}\n`;
+            }
+            content += `\n`;
+        }
+        if (includeExamples && manifest.spec?.role) {
+            content += `## Example Usage\n\n`;
+            content += `\`\`\`\n`;
+            content += `Use ${agentName} to: ${description}\n`;
+            content += `\`\`\`\n\n`;
+        }
+        content += `## When to Use\n\n`;
+        content += `This skill activates when:\n`;
+        for (const keyword of triggerKeywords.slice(0, 5)) {
+            content += `- Task involves: ${keyword}\n`;
+        }
+        content += `\n`;
+        return content;
+    }
+    /**
+     * Sync OSSA manifest with Claude Skill
+     */
+    async syncSkillToOSSA(skillPath, manifestPath) {
+        const skill = await this.parseSkillFile(skillPath);
+        const manifestContent = fs.readFileSync(manifestPath, 'utf-8');
+        const manifest = yaml.parse(manifestContent);
+        // Update manifest metadata with skill info
+        if (!manifest.metadata) {
+            manifest.metadata = { name: '' };
+        }
+        if (!manifest.metadata.labels) {
+            manifest.metadata.labels = {};
+        }
+        manifest.metadata.labels['claude.skill.path'] = skillPath;
+        manifest.metadata.labels['claude.skill.name'] = skill.name;
+        // Update taxonomy from trigger keywords if not set
+        if (!manifest.spec?.taxonomy) {
+            const specRecord = manifest.spec;
+            if (!specRecord.taxonomy) {
+                specRecord.taxonomy = {};
+            }
+            const taxonomy = specRecord.taxonomy;
+            if (skill.triggerKeywords.length > 0 && !taxonomy.domain) {
+                taxonomy.domain = skill.triggerKeywords[0];
+            }
+        }
+        // Write updated manifest
+        const updatedContent = yaml.stringify(manifest);
+        fs.writeFileSync(manifestPath, updatedContent, 'utf-8');
+    }
+    /**
+     * Validate skill against OSSA schema
+     */
+    async validateSkill(skillPath) {
+        const errors = [];
+        try {
+            const skill = await this.parseSkillFile(skillPath);
+            if (!skill.name) {
+                errors.push('Skill name is required');
+            }
+            if (!skill.description || skill.description.length < 10) {
+                errors.push('Skill description must be at least 10 characters');
+            }
+            if (skill.triggerKeywords.length === 0) {
+                errors.push('At least one trigger keyword is required');
+            }
+        }
+        catch (error) {
+            errors.push(`Failed to parse skill: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return {
+            valid: errors.length === 0,
+            errors,
+        };
+    }
+};
+ClaudeSkillsService = __decorate([
+    injectable()
+], ClaudeSkillsService);
+export { ClaudeSkillsService };
+//# sourceMappingURL=claude-skills.service.js.map

package/dist/services/skills/claude-skills.service.js.map

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

package/dist/services/structure/agents-folder.service.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Agent Folder Structure Service
+ *
+ * Creates complete, standardized .agents folder structure following
+ * OpenAPI-first, API-first, Zod, CRUD, SOLID, and DRY principles.
+ *
+ * SOLID: Single Responsibility - Only creates folder structure
+ * DRY: Single source of truth (manifest), all code generated
+ */
+export interface AgentFolderStructure {
+    agentName: string;
+    basePath: string;
+    directories: string[];
+    files: Array<{
+        path: string;
+        content: string;
+        description: string;
+    }>;
+}
+export declare class AgentsFolderService {
+    /**
+     * Generate complete agent folder structure
+     */
+    generateStructure(agentName: string, basePath?: string): AgentFolderStructure;
+    /**
+     * Create folder structure on filesystem
+     */
+    createStructure(structure: AgentFolderStructure, overwrite?: boolean): void;
+    /**
+     * Validate folder structure
+     */
+    validateStructure(agentDir: string): {
+        valid: boolean;
+        errors: string[];
+    };
+}
+//# sourceMappingURL=agents-folder.service.d.ts.map

package/dist/services/structure/agents-folder.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-folder.service.d.ts","sourceRoot":"","sources":["../../../src/services/structure/agents-folder.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,MAAM,EACjB,QAAQ,GAAE,MAAkB,GAC3B,oBAAoB;IAqRvB;;OAEG;IACH,eAAe,CACb,SAAS,EAAE,oBAAoB,EAC/B,SAAS,GAAE,OAAe,GACzB,IAAI;IAkBP;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;CAqC1E"}