@bluefly/openstandardagents 0.4.6 → 0.4.8

package/dist/services/release-automation/release-buttons.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+/**
+ * Release Button Handlers
+ * Manual triggers for controlled releases
+ */
+import { Gitlab } from '@gitbeaker/rest';
+import { execSync } from 'child_process';
+const gitlab = new Gitlab({
+    token: process.env.CI_JOB_TOKEN,
+});
+async function releaseToNpm() {
+    console.log('🚀 Starting npm release...');
+    const packageJson = JSON.parse(execSync('cat package.json').toString());
+    const packageName = packageJson.name;
+    const version = packageJson.version;
+    // Determine version type and appropriate tag
+    const isRC = version.includes('-rc');
+    const isDev = version.includes('-dev');
+    const isPrerelease = isRC || isDev || version.includes('-alpha') || version.includes('-beta');
+    // Determine npm tag based on version type
+    let npmTag = 'latest';
+    if (isRC) {
+        npmTag = 'rc';
+    }
+    else if (isDev) {
+        npmTag = 'dev';
+    }
+    else if (isPrerelease) {
+        npmTag = 'next';
+    }
+    console.log(`📦 Package: ${packageName}@${version}`);
+    console.log(`🏷️  Publishing with tag: ${npmTag}`);
+    // 1. Dry run first
+    console.log('Running dry-run...');
+    execSync(`npm publish --dry-run --tag ${npmTag}`, { stdio: 'inherit' });
+    // 2. Get current latest version before publishing (for legacy tag update)
+    let previousLatest = null;
+    if (!isPrerelease) {
+        try {
+            previousLatest = execSync(`npm view ${packageName} dist-tags.latest 2>/dev/null`)
+                .toString()
+                .trim();
+            console.log(`📌 Current latest version: ${previousLatest}`);
+        }
+        catch {
+            console.log('No previous latest version found');
+        }
+    }
+    // 3. Actual publish with appropriate tag
+    console.log(`Publishing to npm with --tag ${npmTag}...`);
+    execSync(`npm publish --access public --tag ${npmTag}`, { stdio: 'inherit' });
+    // 4. For stable releases, update legacy tag to previous stable
+    if (!isPrerelease && previousLatest && previousLatest !== version) {
+        console.log(`📌 Updating legacy tag to point to ${previousLatest}...`);
+        try {
+            execSync(`npm dist-tag add ${packageName}@${previousLatest} legacy`, {
+                stdio: 'inherit',
+            });
+            console.log(`✅ Legacy tag updated to ${previousLatest}`);
+        }
+        catch (error) {
+            console.warn(`⚠️ Failed to update legacy tag: ${error}`);
+        }
+    }
+    // 5. Verify package is downloadable
+    console.log('Verifying package...');
+    execSync(`npm view ${packageName}@${version}`, { stdio: 'inherit' });
+    // 6. Verify dist-tags are correct
+    console.log('Verifying dist-tags...');
+    execSync(`npm view ${packageName} dist-tags`, { stdio: 'inherit' });
+    // 7. Run smoke tests on published package
+    console.log('Running smoke tests...');
+    const tempDir = execSync('mktemp -d').toString().trim();
+    execSync(`cd ${tempDir} && npm install ${packageName}@${version}`, {
+        stdio: 'inherit',
+    });
+    execSync(`cd ${tempDir} && npx ${packageName} --version`, {
+        stdio: 'inherit',
+    });
+    console.log('✅ npm release successful');
+}
+async function releaseToGitHub() {
+    console.log('🐙 Starting GitHub release...');
+    const packageJson = JSON.parse(execSync('cat package.json').toString());
+    const version = packageJson.version;
+    const tag = `v${version}`;
+    // 1. Create GitHub release
+    const releaseNotes = execSync(`git tag -l --format='%(contents)' ${tag}`).toString();
+    execSync(`gh release create ${tag} \
+    --title "Release ${version}" \
+    --notes "${releaseNotes}" \
+    --repo blueflyio/openstandardagents`, { stdio: 'inherit' });
+    // 2. Upload artifacts
+    execSync(`gh release upload ${tag} dist/*.tgz \
+    --repo blueflyio/openstandardagents`, { stdio: 'inherit' });
+    console.log('✅ GitHub release successful');
+}
+async function deployWebsite() {
+    console.log('🌐 Starting website deployment...');
+    // Note: We're already in website/ directory from CI before_script
+    // Check if we're in website directory, if not, cd into it
+    const cwd = process.cwd();
+    const isInWebsite = cwd.endsWith('website');
+    const websiteDir = isInWebsite ? '.' : 'website';
+    // 1. Build website
+    execSync(`cd ${websiteDir} && npm run build`, { stdio: 'inherit' });
+    // 2. Run pre-deploy checks
+    execSync(`cd ${websiteDir} && npm run lighthouse`, { stdio: 'inherit' });
+    // 3. Deploy to production
+    execSync(`cd ${websiteDir} && npm run deploy`, { stdio: 'inherit' });
+    // 4. Verify deployment
+    const response = execSync('curl -s -o /dev/null -w "%{http_code}" https://openstandardagents.org').toString();
+    if (response !== '200') {
+        throw new Error(`Website deployment failed: HTTP ${response}`);
+    }
+    console.log('✅ Website deployment successful');
+}
+async function announceRelease() {
+    console.log('📢 Announcing release...');
+    const packageJson = JSON.parse(execSync('cat package.json').toString());
+    const version = packageJson.version;
+    // 1. Create announcement issue
+    const projectId = process.env.CI_PROJECT_ID;
+    const issueTitle = `🎉 Release ${version} Announcement`;
+    const issueDescription = `## Release ${version} is now available!
+
+### 📦 Installation
+\`\`\`bash
+npm install openstandardagents@${version}
+\`\`\`
+
+### 🔗 Links
+- [npm Package](https://www.npmjs.com/package/openstandardagents/v/${version})
+- [GitHub Release](https://github.com/blueflyio/openstandardagents/releases/tag/v${version})
+- [Documentation](https://openstandardagents.org/docs)
+- [Changelog](https://openstandardagents.org/docs/changelog)
+
+### 📣 Share
+Please help spread the word about this release!`;
+    await gitlab.Issues.create(projectId, issueTitle, {
+        description: issueDescription,
+        labels: 'announcement,release',
+    });
+    // 2. Notifications: set SLACK_WEBHOOK_URL or RELEASE_EMAIL to enable
+    const webhook = process.env.SLACK_WEBHOOK_URL;
+    const email = process.env.RELEASE_EMAIL;
+    if (webhook) {
+        try {
+            await fetch(webhook, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    text: `Release announced: ${issueTitle}`,
+                    unfurl_links: false,
+                }),
+            });
+        }
+        catch (e) {
+            console.warn('Slack notification failed:', e);
+        }
+    }
+    if (email) {
+        try {
+            const nodemailer = await import('nodemailer');
+            const opts = process.env.SMTP_URL ??
+                process.env.MAIL_TRANSPORT ?? { jsonTransport: true };
+            const transport = nodemailer.default.createTransport(opts);
+            await transport.sendMail({
+                from: process.env.RELEASE_MAIL_FROM || 'release@localhost',
+                to: email,
+                subject: `Release announced: ${process.env.npm_package_version || 'release'}`,
+                text: 'Release has been announced. See Slack or logs for details.',
+            });
+            console.log(`Release notification sent to ${email}`);
+        }
+        catch (e) {
+            console.warn('Email send failed (set SMTP_URL or install nodemailer):', e);
+        }
+    }
+    console.log('✅ Release announced');
+}
+// Main handler
+async function main() {
+    const action = process.env.RELEASE_ACTION;
+    switch (action) {
+        case 'npm':
+            await releaseToNpm();
+            break;
+        case 'github':
+            await releaseToGitHub();
+            break;
+        case 'website':
+            await deployWebsite();
+            break;
+        case 'announce':
+            await announceRelease();
+            break;
+        default:
+            console.error(`Unknown action: ${action}`);
+            process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('❌ Release failed:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=release-buttons.js.map

package/dist/services/release-automation/release.service.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Release CRUD Service
+ * Implements full CRUD operations for releases
+ */
+import { type Release, type CreateReleaseRequest, type UpdateReleaseRequest } from './schemas/release.schema.js';
+import { BaseCrudService } from './base-crud.service.js';
+import { z } from 'zod';
+/**
+ * Release Filter Input
+ */
+declare const ReleaseFilterSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        deprecated: "deprecated";
+        dev: "dev";
+        draft: "draft";
+        rc: "rc";
+        released: "released";
+    }>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type ReleaseFilter = z.infer<typeof ReleaseFilterSchema>;
+/**
+ * Release Service - CRUD operations
+ */
+export declare class ReleaseService extends BaseCrudService<Release, CreateReleaseRequest, UpdateReleaseRequest, ReleaseFilter> {
+    protected createSchema: z.ZodObject<{
+        version: z.ZodString;
+        milestoneId: z.ZodOptional<z.ZodNumber>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    protected updateSchema: z.ZodObject<{
+        state: z.ZodOptional<z.ZodEnum<{
+            deprecated: "deprecated";
+            dev: "dev";
+            draft: "draft";
+            rc: "rc";
+            released: "released";
+        }>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    protected filterSchema: z.ZodObject<{
+        version: z.ZodOptional<z.ZodString>;
+        state: z.ZodOptional<z.ZodEnum<{
+            deprecated: "deprecated";
+            dev: "dev";
+            draft: "draft";
+            rc: "rc";
+            released: "released";
+        }>>;
+        page: z.ZodDefault<z.ZodNumber>;
+        perPage: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    protected entitySchema: z.ZodObject<{
+        id: z.ZodString;
+        version: z.ZodString;
+        state: z.ZodEnum<{
+            deprecated: "deprecated";
+            dev: "dev";
+            draft: "draft";
+            rc: "rc";
+            released: "released";
+        }>;
+        milestoneId: z.ZodOptional<z.ZodNumber>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        mergeRequestId: z.ZodOptional<z.ZodNumber>;
+        createdAt: z.ZodString;
+        updatedAt: z.ZodString;
+        releasedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    private gitlab;
+    private projectId;
+    constructor(gitlabToken: string, projectId?: string | number);
+    /**
+     * Create a new release
+     */
+    create(input: CreateReleaseRequest): Promise<Release>;
+    /**
+     * Read release by ID (version)
+     */
+    read(id: string | number): Promise<Release | null>;
+    /**
+     * Update release
+     */
+    update(id: string | number, input: UpdateReleaseRequest): Promise<Release>;
+    /**
+     * Delete release
+     */
+    delete(id: string | number): Promise<void>;
+    /**
+     * List releases with filtering and pagination
+     */
+    list(filters?: ReleaseFilter): Promise<{
+        items: Release[];
+        pagination: {
+            page: number;
+            perPage: number;
+            total: number;
+            totalPages: number;
+        };
+    }>;
+    /**
+     * Helper: Find release by version
+     */
+    private findByVersion;
+    /**
+     * Helper: Convert GitLab tag to Release entity
+     */
+    private tagToRelease;
+    /**
+     * Helper: Determine release state from tag name
+     */
+    private determineReleaseState;
+}
+export {};
+//# sourceMappingURL=release.service.d.ts.map

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

@@ -0,0 +1,207 @@
+/**
+ * Release CRUD Service
+ * Implements full CRUD operations for releases
+ */
+import { Gitlab } from '@gitbeaker/rest';
+import { ReleaseSchema, CreateReleaseRequestSchema, UpdateReleaseRequestSchema, } from './schemas/release.schema.js';
+import { BaseCrudService } from './base-crud.service.js';
+import { z } from 'zod';
+/**
+ * Release Filter Input
+ */
+const ReleaseFilterSchema = z.object({
+    version: z.string().optional(),
+    state: z.enum(['draft', 'dev', 'rc', 'released', 'deprecated']).optional(),
+    page: z.number().int().positive().default(1),
+    perPage: z.number().int().positive().min(1).max(100).default(20),
+});
+/**
+ * Release Service - CRUD operations
+ */
+export class ReleaseService extends BaseCrudService {
+    createSchema = CreateReleaseRequestSchema;
+    updateSchema = UpdateReleaseRequestSchema;
+    filterSchema = ReleaseFilterSchema;
+    entitySchema = ReleaseSchema;
+    gitlab;
+    projectId;
+    constructor(gitlabToken, projectId = process.env.CI_PROJECT_ID || '') {
+        super();
+        this.gitlab = new Gitlab({ token: gitlabToken });
+        this.projectId = projectId;
+    }
+    /**
+     * Create a new release
+     */
+    async create(input) {
+        try {
+            const validated = this.validateCreate(input);
+            // Check if release already exists
+            const existing = await this.findByVersion(validated.version);
+            if (existing) {
+                throw new Error(`Release ${validated.version} already exists`);
+            }
+            // Create release entity
+            const release = {
+                id: validated.version,
+                version: validated.version.replace(/^v/, ''),
+                state: 'draft',
+                milestoneId: validated.milestoneId,
+                tags: [],
+                mergeRequestId: undefined,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                releasedAt: null,
+                metadata: validated.metadata || {},
+            };
+            return this.validateEntity(release);
+        }
+        catch (error) {
+            this.handleValidationError(error);
+            throw error;
+        }
+    }
+    /**
+     * Read release by ID (version)
+     */
+    async read(id) {
+        this.validateId(id);
+        try {
+            // Try to find by version
+            const version = String(id).replace(/^v/, '');
+            const release = await this.findByVersion(version);
+            return release;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Update release
+     */
+    async update(id, input) {
+        this.validateId(id);
+        const validated = this.validateUpdate(input);
+        const existing = await this.read(id);
+        if (!existing) {
+            this.throwNotFound('Release', id);
+        }
+        const updated = {
+            ...existing,
+            ...validated,
+            updatedAt: new Date().toISOString(),
+            releasedAt: validated.state === 'released'
+                ? new Date().toISOString()
+                : existing.releasedAt,
+        };
+        return this.validateEntity(updated);
+    }
+    /**
+     * Delete release
+     */
+    async delete(id) {
+        this.validateId(id);
+        const existing = await this.read(id);
+        if (!existing) {
+            this.throwNotFound('Release', id);
+        }
+        if (existing.state === 'released') {
+            throw new Error('Cannot delete a released version. Deprecate instead.');
+        }
+        // In a real implementation, you would delete from storage here
+        // For now, we just validate the operation
+    }
+    /**
+     * List releases with filtering and pagination
+     */
+    async list(filters) {
+        const validatedFilters = this.validateFilter(filters || {});
+        try {
+            // Get all tags from GitLab
+            const tags = await this.gitlab.Tags.all(this.projectId, {
+                perPage: 100,
+            });
+            // Filter and map to releases
+            const releases = tags
+                .map((tag) => this.tagToRelease(tag))
+                .filter((release) => {
+                if (validatedFilters.version) {
+                    return release.version.includes(validatedFilters.version);
+                }
+                if (validatedFilters.state) {
+                    return release.state === validatedFilters.state;
+                }
+                return true;
+            });
+            // Sort by version (newest first)
+            releases.sort((a, b) => {
+                return b.version.localeCompare(a.version, undefined, {
+                    numeric: true,
+                    sensitivity: 'base',
+                });
+            });
+            // Paginate
+            const total = releases.length;
+            const page = validatedFilters.page;
+            const perPage = validatedFilters.perPage;
+            const start = (page - 1) * perPage;
+            const end = start + perPage;
+            const paginated = releases.slice(start, end);
+            return {
+                items: paginated.map((r) => this.validateEntity(r)),
+                pagination: this.calculatePagination(total, page, perPage),
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to list releases: ${error}`);
+        }
+    }
+    /**
+     * Helper: Find release by version
+     */
+    async findByVersion(version) {
+        try {
+            const tags = await this.gitlab.Tags.all(this.projectId, {
+                search: version,
+            });
+            const matchingTag = tags.find((tag) => tag.name.includes(version) || tag.name === `v${version}`);
+            if (matchingTag) {
+                return this.tagToRelease(matchingTag);
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Helper: Convert GitLab tag to Release entity
+     */
+    tagToRelease(tag) {
+        const version = tag.name.replace(/^v/, '');
+        const state = this.determineReleaseState(tag.name);
+        return {
+            id: tag.name,
+            version,
+            state,
+            tags: [tag.name],
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            releasedAt: state === 'released' ? new Date().toISOString() : null,
+            metadata: {},
+        };
+    }
+    /**
+     * Helper: Determine release state from tag name
+     */
+    determineReleaseState(tagName) {
+        if (tagName.includes('-dev.'))
+            return 'dev';
+        if (tagName.includes('-rc.'))
+            return 'rc';
+        if (tagName.match(/^v?[0-9]+\.[0-9]+\.[0-9]+$/))
+            return 'released';
+        return 'draft';
+    }
+}
+//# sourceMappingURL=release.service.js.map