@bluefly/openstandardagents 0.4.6 → 0.4.9

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

@@ -0,0 +1,207 @@
+/**
+ * Milestone CRUD Service
+ * Implements full CRUD operations for milestones
+ */
+import { Gitlab } from '@gitbeaker/rest';
+import { MilestoneSchema, CreateMilestoneRequestSchema, UpdateMilestoneRequestSchema, } from './schemas/release.schema.js';
+import { BaseCrudService } from './base-crud.service.js';
+import { z } from 'zod';
+/**
+ * Milestone Filter Input
+ */
+const MilestoneFilterSchema = z.object({
+    state: z.enum(['active', 'closed']).optional(),
+    page: z.number().int().positive().default(1),
+    perPage: z.number().int().positive().min(1).max(100).default(20),
+});
+/**
+ * Milestone Service - CRUD operations
+ */
+export class MilestoneService extends BaseCrudService {
+    createSchema = CreateMilestoneRequestSchema;
+    updateSchema = UpdateMilestoneRequestSchema;
+    filterSchema = MilestoneFilterSchema;
+    entitySchema = MilestoneSchema;
+    gitlab;
+    projectId;
+    constructor(gitlabToken, projectId = process.env.CI_PROJECT_ID || '') {
+        super();
+        this.gitlab = new Gitlab({ token: gitlabToken });
+        this.projectId = projectId;
+    }
+    /**
+     * Create a new milestone
+     */
+    async create(input) {
+        try {
+            const validated = this.validateCreate(input);
+            const milestone = await this.gitlab.ProjectMilestones.create(this.projectId, validated.title, {
+                description: validated.description,
+                dueDate: validated.dueDate,
+                startDate: validated.startDate,
+            });
+            const statistics = await this.getMilestoneStatistics(milestone.id);
+            const result = {
+                id: milestone.id,
+                title: String(milestone.title),
+                description: String(milestone.description || ''),
+                state: milestone.state,
+                dueDate: milestone.dueDate ? String(milestone.dueDate) : null,
+                startDate: milestone.startDate ? String(milestone.startDate) : null,
+                createdAt: String(milestone.createdAt),
+                updatedAt: String(milestone.updatedAt),
+                statistics,
+            };
+            return this.validateEntity(result);
+        }
+        catch (error) {
+            this.handleValidationError(error);
+            throw error;
+        }
+    }
+    /**
+     * Read milestone by ID
+     */
+    async read(id) {
+        this.validateId(id);
+        try {
+            const milestone = await this.gitlab.ProjectMilestones.show(this.projectId, Number(id));
+            const statistics = await this.getMilestoneStatistics(milestone.id);
+            const result = {
+                id: milestone.id,
+                title: String(milestone.title),
+                description: String(milestone.description || ''),
+                state: milestone.state,
+                dueDate: milestone.dueDate ? String(milestone.dueDate) : null,
+                startDate: milestone.startDate ? String(milestone.startDate) : null,
+                createdAt: String(milestone.createdAt),
+                updatedAt: String(milestone.updatedAt),
+                statistics,
+            };
+            return this.validateEntity(result);
+        }
+        catch (error) {
+            if (error &&
+                typeof error === 'object' &&
+                'response' in error &&
+                error.response.status === 404) {
+                return null;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Update milestone
+     */
+    async update(id, input) {
+        this.validateId(id);
+        const validated = this.validateUpdate(input);
+        const existing = await this.read(id);
+        if (!existing) {
+            this.throwNotFound('Milestone', id);
+        }
+        const updateParams = {};
+        if (validated.title)
+            updateParams.title = validated.title;
+        if (validated.description)
+            updateParams.description = validated.description;
+        if (validated.state === 'closed')
+            updateParams.stateEvent = 'close';
+        if (validated.state === 'active')
+            updateParams.stateEvent = 'activate';
+        if (validated.dueDate)
+            updateParams.dueDate = validated.dueDate;
+        if (validated.startDate)
+            updateParams.startDate = validated.startDate;
+        const updated = await this.gitlab.ProjectMilestones.edit(this.projectId, Number(id), updateParams);
+        const statistics = await this.getMilestoneStatistics(updated.id);
+        const result = {
+            id: updated.id,
+            title: String(updated.title),
+            description: String(updated.description || ''),
+            state: updated.state,
+            dueDate: updated.dueDate ? String(updated.dueDate) : null,
+            startDate: updated.startDate ? String(updated.startDate) : null,
+            createdAt: String(updated.createdAt),
+            updatedAt: String(updated.updatedAt),
+            statistics,
+        };
+        return this.validateEntity(result);
+    }
+    /**
+     * Delete milestone
+     */
+    async delete(id) {
+        this.validateId(id);
+        const existing = await this.read(id);
+        if (!existing) {
+            this.throwNotFound('Milestone', id);
+        }
+        await this.gitlab.ProjectMilestones.remove(this.projectId, Number(id));
+    }
+    /**
+     * List milestones with filtering and pagination
+     */
+    async list(filters) {
+        const validatedFilters = this.validateFilter(filters || {});
+        try {
+            const milestones = await this.gitlab.ProjectMilestones.all(this.projectId, {
+                state: validatedFilters.state,
+                perPage: validatedFilters.perPage,
+                page: validatedFilters.page,
+            });
+            const items = await Promise.all(milestones.map(async (m) => {
+                const statistics = await this.getMilestoneStatistics(m.id);
+                return this.validateEntity({
+                    id: m.id,
+                    title: m.title,
+                    description: m.description || '',
+                    state: m.state,
+                    dueDate: m.dueDate || null,
+                    startDate: m.startDate || null,
+                    createdAt: m.createdAt,
+                    updatedAt: m.updatedAt,
+                    statistics,
+                });
+            }));
+            // Note: GitLab API doesn't always return total, so we estimate
+            const total = items.length >= validatedFilters.perPage
+                ? items.length + validatedFilters.perPage
+                : items.length;
+            return {
+                items,
+                pagination: this.calculatePagination(total, validatedFilters.page, validatedFilters.perPage),
+            };
+        }
+        catch (error) {
+            throw new Error(`Failed to list milestones: ${error}`);
+        }
+    }
+    /**
+     * Helper: Get milestone statistics
+     */
+    async getMilestoneStatistics(milestoneId) {
+        try {
+            const milestone = await this.gitlab.ProjectMilestones.show(this.projectId, milestoneId);
+            const totalIssues = milestone.totalIssuesCount || 0;
+            const closedIssues = milestone.closedIssuesCount || 0;
+            const openIssues = totalIssues - closedIssues;
+            const completionPercentage = totalIssues > 0 ? (closedIssues / totalIssues) * 100 : 0;
+            return {
+                totalIssues: Number(totalIssues),
+                closedIssues: Number(closedIssues),
+                openIssues: Number(openIssues),
+                completionPercentage: Math.round(completionPercentage * 100) / 100,
+            };
+        }
+        catch {
+            return {
+                totalIssues: 0,
+                closedIssues: 0,
+                openIssues: 0,
+                completionPercentage: 0,
+            };
+        }
+    }
+}
+//# sourceMappingURL=milestone.service.js.map

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

@@ -0,0 +1,39 @@
+/**
+ * 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';
+declare const ReleaseAnalysisRequestSchema: z.ZodObject<{
+    branch: z.ZodString;
+    fromTag: z.ZodOptional<z.ZodString>;
+    toCommit: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, z.core.$strip>;
+export interface ReleaseAnalysisResult {
+    releaseNeeded: boolean;
+    releaseType?: 'major' | 'minor' | 'patch' | 'prerelease';
+    currentVersion: string;
+    nextVersion?: string;
+    commits: Array<{
+        hash: string;
+        type: string;
+        scope?: string;
+        subject: string;
+        breaking: boolean;
+    }>;
+}
+export declare class ReleaseAgentService {
+    private rootDir;
+    constructor(rootDir?: string);
+    analyzeRelease(request: z.infer<typeof ReleaseAnalysisRequestSchema>): Promise<ReleaseAnalysisResult>;
+    validateChangelog(changelogPath?: string): Promise<{
+        valid: boolean;
+        errors: string[];
+        warnings: string[];
+    }>;
+}
+export {};
+//# sourceMappingURL=release-agent.service.d.ts.map

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

@@ -0,0 +1,43 @@
+/**
+ * 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 { execSync } from 'child_process';
+import { z } from 'zod';
+import { getVersion } from '../../utils/version.js';
+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: getVersion(),
+            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-buttons.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Release Button Handlers
+ * Manual triggers for controlled releases
+ */
+export {};
+//# sourceMappingURL=release-buttons.d.ts.map

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