@bluefly/openstandardagents 0.4.6 → 0.4.8

package/dist/services/release-automation/schemas/release.schema.d.ts

@@ -0,0 +1,299 @@
+/**
+ * Release Automation - Zod Schemas
+ * DRY: Reusable validation schemas for release entities
+ */
+import { z } from 'zod';
+/**
+ * Release State
+ */
+export declare const ReleaseStateSchema: z.ZodEnum<{
+    deprecated: "deprecated";
+    dev: "dev";
+    draft: "draft";
+    rc: "rc";
+    released: "released";
+}>;
+/**
+ * Tag Type
+ */
+export declare const TagTypeSchema: z.ZodEnum<{
+    dev: "dev";
+    release: "release";
+    rc: "rc";
+}>;
+/**
+ * Milestone State
+ */
+export declare const MilestoneStateSchema: z.ZodEnum<{
+    active: "active";
+    closed: "closed";
+}>;
+/**
+ * Merge Request State
+ */
+export declare const MergeRequestStateSchema: z.ZodEnum<{
+    closed: "closed";
+    opened: "opened";
+    merged: "merged";
+    locked: "locked";
+}>;
+/**
+ * Merge Status
+ */
+export declare const MergeStatusSchema: z.ZodEnum<{
+    can_be_merged: "can_be_merged";
+    cannot_be_merged: "cannot_be_merged";
+    checking: "checking";
+    unchecked: "unchecked";
+}>;
+/**
+ * Base Pagination Schema
+ */
+export declare const PaginationSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Release Schema
+ */
+export declare const ReleaseSchema: 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>;
+/**
+ * Create Release Request
+ */
+export declare const CreateReleaseRequestSchema: z.ZodObject<{
+    version: z.ZodString;
+    milestoneId: z.ZodOptional<z.ZodNumber>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * Update Release Request
+ */
+export declare const UpdateReleaseRequestSchema: 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>;
+/**
+ * Milestone Schema
+ */
+export declare const MilestoneSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+    }>;
+    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    statistics: z.ZodDefault<z.ZodObject<{
+        totalIssues: z.ZodDefault<z.ZodNumber>;
+        closedIssues: z.ZodDefault<z.ZodNumber>;
+        openIssues: z.ZodDefault<z.ZodNumber>;
+        completionPercentage: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Create Milestone Request
+ */
+export declare const CreateMilestoneRequestSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    dueDate: z.ZodOptional<z.ZodString>;
+    startDate: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Update Milestone Request
+ */
+export declare const UpdateMilestoneRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        closed: "closed";
+    }>>;
+    dueDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    startDate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Tag Schema
+ */
+export declare const TagSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodEnum<{
+        dev: "dev";
+        release: "release";
+        rc: "rc";
+    }>;
+    version: z.ZodString;
+    commitSha: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodString;
+    ref: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Create Tag Request
+ */
+export declare const CreateTagRequestSchema: z.ZodObject<{
+    name: z.ZodString;
+    ref: z.ZodString;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Merge Request Schema
+ */
+export declare const MergeRequestSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    sourceBranch: z.ZodString;
+    targetBranch: z.ZodString;
+    state: z.ZodEnum<{
+        closed: "closed";
+        opened: "opened";
+        merged: "merged";
+        locked: "locked";
+    }>;
+    mergeStatus: z.ZodOptional<z.ZodEnum<{
+        can_be_merged: "can_be_merged";
+        cannot_be_merged: "cannot_be_merged";
+        checking: "checking";
+        unchecked: "unchecked";
+    }>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    mergedAt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    approvals: z.ZodDefault<z.ZodObject<{
+        required: z.ZodDefault<z.ZodNumber>;
+        received: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * Create Merge Request Request
+ */
+export declare const CreateMergeRequestRequestSchema: z.ZodObject<{
+    sourceBranch: z.ZodString;
+    targetBranch: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    labels: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    milestoneId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Update Merge Request Request
+ */
+export declare const UpdateMergeRequestRequestSchema: z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    state: z.ZodOptional<z.ZodEnum<{
+        closed: "closed";
+        opened: "opened";
+        merged: "merged";
+        locked: "locked";
+    }>>;
+    labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Webhook Payloads
+ */
+export declare const MilestoneWebhookPayloadSchema: z.ZodObject<{
+    object_kind: z.ZodLiteral<"milestone">;
+    project: z.ZodObject<{
+        id: z.ZodNumber;
+        path_with_namespace: z.ZodString;
+    }, z.core.$strip>;
+    object_attributes: z.ZodObject<{
+        id: z.ZodNumber;
+        title: z.ZodString;
+        state: z.ZodEnum<{
+            active: "active";
+            closed: "closed";
+        }>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export declare const PushWebhookPayloadSchema: z.ZodObject<{
+    object_kind: z.ZodLiteral<"push">;
+    project: z.ZodObject<{
+        id: z.ZodNumber;
+    }, z.core.$strip>;
+    ref: z.ZodString;
+    commits: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+}, z.core.$strip>;
+/**
+ * Webhook Response
+ */
+export declare const WebhookResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    message: z.ZodString;
+    actions: z.ZodOptional<z.ZodDefault<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        status: z.ZodString;
+        details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+/**
+ * Error Response
+ */
+export declare const ErrorResponseSchema: z.ZodObject<{
+    message: z.ZodString;
+    code: z.ZodOptional<z.ZodString>;
+    details: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$loose>;
+/**
+ * List Response (with pagination)
+ */
+export declare function createListResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    items: z.ZodArray<T>;
+    pagination: z.ZodObject<{
+        page: z.ZodDefault<z.ZodNumber>;
+        perPage: z.ZodDefault<z.ZodNumber>;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+/**
+ * Type exports for TypeScript
+ */
+export type Release = z.infer<typeof ReleaseSchema>;
+export type CreateReleaseRequest = z.infer<typeof CreateReleaseRequestSchema>;
+export type UpdateReleaseRequest = z.infer<typeof UpdateReleaseRequestSchema>;
+export type Milestone = z.infer<typeof MilestoneSchema>;
+export type CreateMilestoneRequest = z.infer<typeof CreateMilestoneRequestSchema>;
+export type UpdateMilestoneRequest = z.infer<typeof UpdateMilestoneRequestSchema>;
+export type Tag = z.infer<typeof TagSchema>;
+export type CreateTagRequest = z.infer<typeof CreateTagRequestSchema>;
+export type MergeRequest = z.infer<typeof MergeRequestSchema>;
+export type CreateMergeRequestRequest = z.infer<typeof CreateMergeRequestRequestSchema>;
+export type UpdateMergeRequestRequest = z.infer<typeof UpdateMergeRequestRequestSchema>;
+export type MilestoneWebhookPayload = z.infer<typeof MilestoneWebhookPayloadSchema>;
+export type PushWebhookPayload = z.infer<typeof PushWebhookPayloadSchema>;
+export type WebhookResponse = z.infer<typeof WebhookResponseSchema>;
+export type ErrorResponse = z.infer<typeof ErrorResponseSchema>;
+//# sourceMappingURL=release.schema.d.ts.map

package/dist/services/release-automation/schemas/release.schema.js

@@ -0,0 +1,272 @@
+/**
+ * Release Automation - Zod Schemas
+ * DRY: Reusable validation schemas for release entities
+ */
+import { z } from 'zod';
+/**
+ * Version pattern: v0.2.5, 0.2.5-RC, 0.2.5-dev.1, etc.
+ */
+const VersionPattern = z
+    .string()
+    .regex(/^v?[0-9]+\.[0-9]+\.[0-9]+(-[A-Za-z0-9]+(\.[0-9]+)?)?$/, {
+    message: 'Invalid version format. Expected: v0.2.5, 0.2.5-RC, 0.2.5-dev.1',
+});
+/**
+ * Tag name pattern: v0.2.5-RC, v0.2.5-dev.1, etc.
+ */
+const TagNamePattern = z
+    .string()
+    .regex(/^v?[0-9]+\.[0-9]+\.[0-9]+(-[a-z]+\.?[0-9]+)?$/, {
+    message: 'Invalid tag format. Expected: v0.2.5-RC, v0.2.5-dev.1',
+});
+/**
+ * Git commit SHA pattern
+ */
+const CommitShaPattern = z.string().regex(/^[0-9a-f]{40}$/, {
+    message: 'Invalid commit SHA. Must be 40 character hex string',
+});
+/**
+ * Release State
+ */
+export const ReleaseStateSchema = z.enum([
+    'draft',
+    'dev',
+    'rc',
+    'released',
+    'deprecated',
+]);
+/**
+ * Tag Type
+ */
+export const TagTypeSchema = z.enum(['dev', 'rc', 'release']);
+/**
+ * Milestone State
+ */
+export const MilestoneStateSchema = z.enum(['active', 'closed']);
+/**
+ * Merge Request State
+ */
+export const MergeRequestStateSchema = z.enum([
+    'opened',
+    'closed',
+    'merged',
+    'locked',
+]);
+/**
+ * Merge Status
+ */
+export const MergeStatusSchema = z.enum([
+    'can_be_merged',
+    'cannot_be_merged',
+    'checking',
+    'unchecked',
+]);
+/**
+ * Base Pagination Schema
+ */
+export const PaginationSchema = z.object({
+    page: z.number().int().positive().default(1),
+    perPage: z.number().int().positive().min(1).max(100).default(20),
+});
+/**
+ * Release Schema
+ */
+export const ReleaseSchema = z.object({
+    id: z.string(),
+    version: VersionPattern,
+    state: ReleaseStateSchema,
+    milestoneId: z.number().int().positive().optional(),
+    tags: z.array(z.string()).default([]),
+    mergeRequestId: z.number().int().positive().optional(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    releasedAt: z.string().datetime().nullable().optional(),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+});
+/**
+ * Create Release Request
+ */
+export const CreateReleaseRequestSchema = z.object({
+    version: VersionPattern,
+    milestoneId: z.number().int().positive().optional(),
+    metadata: z.record(z.string(), z.unknown()).default({}),
+});
+/**
+ * Update Release Request
+ */
+export const UpdateReleaseRequestSchema = z.object({
+    state: ReleaseStateSchema.optional(),
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Milestone Schema
+ */
+export const MilestoneSchema = z.object({
+    id: z.number().int().positive(),
+    title: z.string(),
+    description: z.string().optional(),
+    state: MilestoneStateSchema,
+    dueDate: z.string().nullable().optional(),
+    startDate: z.string().nullable().optional(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    statistics: z
+        .object({
+        totalIssues: z.number().int().nonnegative().default(0),
+        closedIssues: z.number().int().nonnegative().default(0),
+        openIssues: z.number().int().nonnegative().default(0),
+        completionPercentage: z.number().min(0).max(100).default(0),
+    })
+        .default({
+        totalIssues: 0,
+        closedIssues: 0,
+        openIssues: 0,
+        completionPercentage: 0,
+    }),
+});
+/**
+ * Create Milestone Request
+ */
+export const CreateMilestoneRequestSchema = z.object({
+    title: z.string().regex(/^v?[0-9]+\.[0-9]+\.[0-9]+/, {
+        message: 'Milestone title must contain version (e.g., v0.3.0)',
+    }),
+    description: z.string().optional(),
+    dueDate: z.string().optional(),
+    startDate: z.string().optional(),
+});
+/**
+ * Update Milestone Request
+ */
+export const UpdateMilestoneRequestSchema = z.object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    state: MilestoneStateSchema.optional(),
+    dueDate: z.string().nullable().optional(),
+    startDate: z.string().nullable().optional(),
+});
+/**
+ * Tag Schema
+ */
+export const TagSchema = z.object({
+    name: TagNamePattern,
+    type: TagTypeSchema,
+    version: VersionPattern,
+    commitSha: CommitShaPattern,
+    message: z.string().optional(),
+    createdAt: z.string().datetime(),
+    ref: z.string(),
+});
+/**
+ * Create Tag Request
+ */
+export const CreateTagRequestSchema = z.object({
+    name: TagNamePattern,
+    ref: z.string(),
+    message: z.string().optional(),
+});
+/**
+ * Merge Request Schema
+ */
+export const MergeRequestSchema = z.object({
+    id: z.number().int().positive(),
+    title: z.string(),
+    description: z.string().optional(),
+    sourceBranch: z.string(),
+    targetBranch: z.string(),
+    state: MergeRequestStateSchema,
+    mergeStatus: MergeStatusSchema.optional(),
+    createdAt: z.string().datetime(),
+    updatedAt: z.string().datetime(),
+    mergedAt: z.string().datetime().nullable().optional(),
+    labels: z.array(z.string()).default([]),
+    approvals: z
+        .object({
+        required: z.number().int().nonnegative().default(0),
+        received: z.number().int().nonnegative().default(0),
+    })
+        .default({ required: 0, received: 0 }),
+});
+/**
+ * Create Merge Request Request
+ */
+export const CreateMergeRequestRequestSchema = z.object({
+    sourceBranch: z.string().min(1),
+    targetBranch: z.string().min(1),
+    title: z.string().min(1),
+    description: z.string().optional(),
+    labels: z.array(z.string()).default([]),
+    milestoneId: z.number().int().positive().optional(),
+});
+/**
+ * Update Merge Request Request
+ */
+export const UpdateMergeRequestRequestSchema = z.object({
+    title: z.string().optional(),
+    description: z.string().optional(),
+    state: MergeRequestStateSchema.optional(),
+    labels: z.array(z.string()).optional(),
+});
+/**
+ * Webhook Payloads
+ */
+export const MilestoneWebhookPayloadSchema = z.object({
+    object_kind: z.literal('milestone'),
+    project: z.object({
+        id: z.number().int().positive(),
+        path_with_namespace: z.string(),
+    }),
+    object_attributes: z.object({
+        id: z.number().int().positive(),
+        title: z.string(),
+        state: MilestoneStateSchema,
+        created_at: z.string(),
+        updated_at: z.string(),
+    }),
+});
+export const PushWebhookPayloadSchema = z.object({
+    object_kind: z.literal('push'),
+    project: z.object({
+        id: z.number().int().positive(),
+    }),
+    ref: z.string(),
+    commits: z.array(z.record(z.string(), z.unknown())).default([]),
+});
+/**
+ * Webhook Response
+ */
+export const WebhookResponseSchema = z.object({
+    success: z.boolean(),
+    message: z.string(),
+    actions: z
+        .array(z.object({
+        type: z.string(),
+        status: z.string(),
+        details: z.record(z.string(), z.unknown()).optional(),
+    }))
+        .default([])
+        .optional(),
+});
+/**
+ * Error Response
+ */
+export const ErrorResponseSchema = z
+    .object({
+    message: z.string(),
+    code: z.string().optional(),
+    details: z.record(z.string(), z.unknown()).optional(),
+})
+    .passthrough();
+/**
+ * List Response (with pagination)
+ */
+export function createListResponseSchema(itemSchema) {
+    return z.object({
+        items: z.array(itemSchema),
+        pagination: PaginationSchema.extend({
+            total: z.number().int().nonnegative(),
+            totalPages: z.number().int().nonnegative(),
+        }),
+    });
+}
+//# sourceMappingURL=release.schema.js.map

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

@@ -0,0 +1,99 @@
+/**
+ * Tag CRUD Service
+ * Implements full CRUD operations for Git tags
+ */
+import { type Tag, type CreateTagRequest } from './schemas/release.schema.js';
+import { BaseCrudService } from './base-crud.service.js';
+import { z } from 'zod';
+/**
+ * Tag Filter Input
+ */
+declare const TagFilterSchema: z.ZodObject<{
+    version: z.ZodOptional<z.ZodString>;
+    type: z.ZodDefault<z.ZodEnum<{
+        dev: "dev";
+        all: "all";
+        release: "release";
+        rc: "rc";
+    }>>;
+    page: z.ZodDefault<z.ZodNumber>;
+    perPage: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type TagFilter = z.infer<typeof TagFilterSchema>;
+/**
+ * Tag Service - CRUD operations
+ */
+export declare class TagService extends BaseCrudService<Tag, CreateTagRequest, never, // Tags are immutable - no update
+TagFilter> {
+    protected createSchema: z.ZodObject<{
+        name: z.ZodString;
+        ref: z.ZodString;
+        message: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    protected updateSchema: z.ZodNever;
+    protected filterSchema: z.ZodObject<{
+        version: z.ZodOptional<z.ZodString>;
+        type: z.ZodDefault<z.ZodEnum<{
+            dev: "dev";
+            all: "all";
+            release: "release";
+            rc: "rc";
+        }>>;
+        page: z.ZodDefault<z.ZodNumber>;
+        perPage: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    protected entitySchema: z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            dev: "dev";
+            release: "release";
+            rc: "rc";
+        }>;
+        version: z.ZodString;
+        commitSha: z.ZodString;
+        message: z.ZodOptional<z.ZodString>;
+        createdAt: z.ZodString;
+        ref: z.ZodString;
+    }, z.core.$strip>;
+    private gitlab;
+    private projectId;
+    constructor(gitlabToken: string, projectId?: string | number);
+    /**
+     * Create a new tag
+     */
+    create(input: CreateTagRequest): Promise<Tag>;
+    /**
+     * Read tag by name
+     */
+    read(id: string | number): Promise<Tag | null>;
+    /**
+     * Update tag - NOT SUPPORTED (tags are immutable)
+     */
+    update(): Promise<Tag>;
+    /**
+     * Delete tag
+     */
+    delete(id: string | number): Promise<void>;
+    /**
+     * List tags with filtering and pagination
+     */
+    list(filters?: TagFilter): Promise<{
+        items: Tag[];
+        pagination: {
+            page: number;
+            perPage: number;
+            total: number;
+            totalPages: number;
+        };
+    }>;
+    /**
+     * Helper: Determine tag type from name
+     */
+    private determineTagType;
+    /**
+     * Helper: Extract version from tag name
+     */
+    private extractVersion;
+}
+export {};
+//# sourceMappingURL=tag.service.d.ts.map