@makaio/contracts 1.0.0-dev-1779051654000

package/dist/capabilities/review/types.d.ts

@@ -0,0 +1,199 @@
+import type { ICapabilityProvider } from '../../capability/types.js';
+import type { FindingTarget, ReviewFinding, ReviewIssueComment, ReviewSourceRateLimit } from './schemas.js';
+import type { VCSReviewComment, VCSReview } from '../vcs/schemas/index.js';
+/**
+ * Parameters for triggering a review.
+ */
+export interface ReviewTriggerParams {
+    /** Target PR/branch to review */
+    target: FindingTarget;
+    /** Source to trigger (optional, uses default) */
+    sourceId?: string;
+}
+/**
+ * Result of triggering a review.
+ */
+export interface ReviewTriggerResult {
+    /** Whether the trigger was successful */
+    triggered: boolean;
+    /** Estimated delay before results are available */
+    estimatedDelayMs?: number;
+    /** Current rate limit state */
+    rateLimit: ReviewSourceRateLimit | null;
+}
+/**
+ * Parameters for fetching findings from a source.
+ */
+export interface FetchFindingsParams {
+    /** Target PR/branch */
+    target: FindingTarget;
+}
+/**
+ * Execution context carrying VCS routing information.
+ */
+export interface ReviewRequestContext {
+    /** Local repository path used only for VCS provider routing */
+    repoPath: string;
+    /** Target PR/branch */
+    target: FindingTarget;
+}
+/**
+ * Snapshot of raw data from a review source, before processing.
+ */
+export interface ReviewSourceSnapshot {
+    /** Source that produced this snapshot */
+    sourceId: string;
+    /** Reviewer family */
+    reviewer: string;
+    /** Target PR/branch */
+    target: FindingTarget;
+    /** Inline and general review comments */
+    comments: VCSReviewComment[];
+    /** Review-level bodies */
+    reviews: VCSReview[];
+    /** Issue-level comments (e.g., from issue timeline) */
+    issueComments?: ReviewIssueComment[];
+    /** CLI tool output */
+    cliOutput?: string;
+    /** Raw body containing rate limit information */
+    rateLimitBody?: string;
+}
+/**
+ * Parameters for processing inline comments.
+ */
+export interface ProcessCommentsParams {
+    /** Source that fetched the comments */
+    sourceId: string;
+    /** Target PR/branch */
+    target: FindingTarget;
+    /** Raw VCS review comments */
+    comments: readonly VCSReviewComment[];
+}
+/**
+ * Parameters for processing review bodies.
+ */
+export interface ProcessReviewBodyParams {
+    /** Source that fetched the reviews */
+    sourceId: string;
+    /** Target PR/branch */
+    target: FindingTarget;
+    /** Raw VCS reviews */
+    reviews: readonly VCSReview[];
+}
+/**
+ * Parameters for processing issue comments.
+ */
+export interface ProcessIssueCommentsParams {
+    /** Source that fetched the issue comments */
+    sourceId: string;
+    /** Target PR/branch */
+    target: FindingTarget;
+    /** Raw issue comments */
+    issueComments: readonly ReviewIssueComment[];
+}
+/**
+ * Parameters for processing CLI output.
+ */
+export interface ProcessCliOutputParams {
+    /** Source that produced the output */
+    sourceId: string;
+    /** Target PR/branch */
+    target: FindingTarget;
+    /** Raw CLI output string */
+    cliOutput: string;
+}
+/**
+ * Review source capability provider.
+ *
+ * Sources handle source-specific I/O: VCS reads, CLI invocation, trigger
+ * comments, and rate-limit metadata.
+ */
+export interface IReviewSource extends ICapabilityProvider {
+    /** Must be 'review-source' */
+    readonly capabilityId: 'review-source';
+    /** Reviewer family this source feeds (e.g., 'coderabbit') */
+    readonly reviewer: string;
+    /** Preferred processor key for this source */
+    readonly preferredProcessorKey?: string;
+    /** Source capabilities */
+    readonly capabilities: {
+        canTrigger: boolean;
+        canFetch: boolean;
+        isPush: boolean;
+    };
+    /**
+     * Trigger a review (e.g., post "\@coderabbitai review" comment).
+     * @param params - Trigger parameters merged with VCS routing context
+     * @returns Result indicating whether the trigger succeeded
+     */
+    trigger?(params: ReviewTriggerParams & ReviewRequestContext): Promise<ReviewTriggerResult>;
+    /**
+     * Fetch raw snapshot from the source.
+     * @param params - Fetch parameters merged with VCS routing context
+     * @returns Raw snapshot of source data before processing
+     */
+    fetchSnapshot?(params: FetchFindingsParams & ReviewRequestContext): Promise<ReviewSourceSnapshot>;
+    /**
+     * Get current rate limit state.
+     * @returns Current rate limit or null if not applicable
+     */
+    getRateLimit?(): ReviewSourceRateLimit | null;
+}
+/**
+ * Reviewer processor capability provider.
+ *
+ * Processors handle stateless transformation from raw source data to
+ * ReviewFinding arrays. They must be pure transformation logic with no
+ * I/O dependencies.
+ */
+export interface IReviewerProcessor extends ICapabilityProvider {
+    /** Must be 'reviewer-processor' */
+    readonly capabilityId: 'reviewer-processor';
+    /** Reviewer family this processor handles */
+    readonly reviewer: string;
+    /** Unique processor key (e.g., 'makaio/coderabbit') */
+    readonly processorKey: string;
+    /** Priority for processor resolution (higher wins, default 0) */
+    readonly priority?: number;
+    /** Processor keys this one supersedes (diagnostic metadata) */
+    readonly supersedes?: readonly string[];
+    /** Bot usernames that produce content for this reviewer */
+    readonly botAuthors: readonly string[];
+    /**
+     * Process inline review comments into findings.
+     * @param params - Parameters containing source ID, target, and raw comments
+     * @returns Array of review findings extracted from the comments
+     */
+    processComments(params: ProcessCommentsParams): ReviewFinding[];
+    /**
+     * Process review body content into findings.
+     * @param params - Parameters containing source ID, target, and raw reviews
+     * @returns Array of review findings extracted from the review bodies
+     */
+    processReviewBody(params: ProcessReviewBodyParams): ReviewFinding[];
+    /**
+     * Process issue-level comments into findings.
+     * @param params - Parameters containing source ID, target, and raw issue comments
+     * @returns Array of review findings extracted from the issue comments
+     */
+    processIssueComments?(params: ProcessIssueCommentsParams): ReviewFinding[];
+    /**
+     * Process CLI output into findings.
+     * @param params - Parameters containing source ID, target, and raw CLI output
+     * @returns Array of review findings extracted from the CLI output
+     */
+    processCliOutput?(params: ProcessCliOutputParams): ReviewFinding[];
+    /**
+     * Parse rate limit information from a body string.
+     * @param body - Raw text body potentially containing rate limit information
+     * @returns Parsed rate limit or null if none found
+     */
+    parseRateLimit?(body: string): ReviewSourceRateLimit | null;
+    /**
+     * Extract AI-optimized agent prompt from a comment body.
+     * @param body - Raw comment body text
+     * @returns Agent-optimized prompt string or undefined if not extractable
+     */
+    extractAgentPrompt?(body: string): string | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/review/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/capabilities/review/types.ts"],"names":[],"mappings":"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"}

package/dist/capabilities/server/index.d.ts

@@ -0,0 +1,3 @@
+export type { HttpServerLike, IServerProvider, ServerAddress, UpgradeHandler } from './types.js';
+export { SERVER_CAPABILITY_ID, registerServerProvider, unregisterServerProvider } from './register.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/server/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjG,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC"}

package/dist/capabilities/server/register.d.ts

@@ -0,0 +1,18 @@
+import type { MakaioBusLike } from '@makaio/framework/core';
+import { type IServerProvider } from './types.js';
+export { SERVER_CAPABILITY_ID } from './types.js';
+/**
+ * Register an HTTP server provider with the capability bus.
+ * @param bus - The Makaio bus instance.
+ * @param provider - The server provider instance to register.
+ * @returns Promise that resolves after registration handlers have completed.
+ */
+export declare function registerServerProvider(bus: MakaioBusLike, provider: IServerProvider): Promise<void>;
+/**
+ * Unregister an HTTP server provider from the capability bus.
+ * @param bus - The Makaio bus instance.
+ * @param providerId - The provider ID to unregister.
+ * @returns Promise that resolves after unregistration handlers have completed.
+ */
+export declare function unregisterServerProvider(bus: MakaioBusLike, providerId: string): Promise<void>;
+//# sourceMappingURL=register.d.ts.map

package/dist/capabilities/server/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/capabilities/server/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAExE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAKnG;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9F"}

package/dist/capabilities/server/types.d.ts

@@ -0,0 +1,97 @@
+import type { ICapabilityProvider } from '../../capability/types.js';
+/**
+ * Capability identifier for HTTP server providers.
+ */
+export declare const SERVER_CAPABILITY_ID: "server";
+/**
+ * Handler invoked when an HTTP connection requests a protocol upgrade.
+ *
+ * Follows the Node.js `http.Server` `upgrade` event signature so callers
+ * can attach WebSocket or other protocol handlers without coupling to a
+ * specific HTTP library.
+ * @param request - The incoming HTTP request that triggered the upgrade.
+ * @param socket - The raw network socket for the connection.
+ * @param head - The first packet of the upgraded stream, buffered before
+ *   the upgrade handler was attached.
+ */
+export type UpgradeHandler = (request: unknown, socket: unknown, head: unknown) => void;
+/**
+ * Address information returned by {@link HttpServerLike.address}.
+ */
+export interface ServerAddress {
+    /** Bound port number. */
+    readonly port: number;
+}
+/**
+ * Minimal Node-compatible HTTP server interface for WebSocket upgrade handling
+ * and port resolution.
+ *
+ * This contract models servers that expose Node's `upgrade` event. Bun's
+ * native `Bun.Server` uses `server.upgrade(request)` from the fetch handler
+ * instead, so Bun hosts should expose WebSocket routing through a Bun-specific
+ * host seam rather than returning `Bun.Server` as `HttpServerLike`.
+ */
+export interface HttpServerLike {
+    /**
+     * Attach an event handler to the server.
+     *
+     * Only the `'upgrade'` event is required by this contract; implementors
+     * may support additional events via overloads.
+     * @param event - The event name to listen for.
+     * @param handler - The handler to invoke when the event fires.
+     */
+    on(event: 'upgrade', handler: UpgradeHandler): void;
+    /**
+     * Remove a previously attached event handler from the server.
+     *
+     * Only the `'upgrade'` event is required by this contract.
+     * @param event - The event name to remove the handler from.
+     * @param handler - The handler to remove.
+     */
+    off(event: 'upgrade', handler: UpgradeHandler): void;
+    /**
+     * Return the bound address of the server.
+     *
+     * Returns `null` when the server is not yet listening. Returns a
+     * {@link ServerAddress} when bound to a TCP port. The string case
+     * (Unix domain socket) is not used by the relay but is included for
+     * compatibility with Node.js `Server#address()` callers.
+     * @returns Server address, pipe path string, or null
+     */
+    address(): ServerAddress | string | null;
+}
+/**
+ * Capability provider that exposes a raw HTTP server for WebSocket upgrades.
+ *
+ * The composition root (host shell) registers an `IServerProvider` after
+ * creating a Node-compatible HTTP server. Extensions that need to handle
+ * WebSocket upgrade events query this capability from the bus and call
+ * {@link getServer} to obtain the server handle.
+ *
+ * If no provider is registered (e.g. in a test kernel), consumers must
+ * degrade gracefully.
+ * @example
+ * ```typescript
+ * class NodeServerProvider implements IServerProvider {
+ *   readonly id = 'node-server';
+ *   readonly displayName = 'Node HTTP Server';
+ *   readonly capabilityId = SERVER_CAPABILITY_ID;
+ *
+ *   constructor(private readonly server: HttpServerLike) {}
+ *
+ *   getServer(): HttpServerLike {
+ *     return this.server;
+ *   }
+ * }
+ * ```
+ */
+export interface IServerProvider extends ICapabilityProvider {
+    /** Capability identifier — must be `'server'`. */
+    readonly capabilityId: typeof SERVER_CAPABILITY_ID;
+    /**
+     * Return the underlying HTTP server for upgrade handling.
+     * @returns The HTTP server instance.
+     */
+    getServer(): HttpServerLike;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/capabilities/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/capabilities/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,oBAAoB,UAAoB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAEpD;;;;;;OAMG;IACH,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IAErD;;;;;;;;OAQG;IACH,OAAO,IAAI,aAAa,GAAG,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,OAAO,oBAAoB,CAAC;IAEnD;;;OAGG;IACH,SAAS,IAAI,cAAc,CAAC;CAC7B"}

package/dist/capabilities/vcs/events.d.ts

@@ -0,0 +1,70 @@
+/**
+ * VCS comment mutation events for cache invalidation.
+ *
+ * Emitted after successful write operations. Subscribers use these events
+ * to trigger automatic cache refreshes in UI components.
+ * @packageDocumentation
+ */
+import { z } from 'zod';
+/**
+ * VCS events namespace for cache invalidation.
+ *
+ * These events are emitted after successful PR comment mutations
+ * (create, reply, resolve) to notify subscribers that cached data
+ * should be refreshed.
+ */
+export declare const VCSEventsNamespace: import("@makaio/framework/core").BusNamespaceDefinition<"vcs:events", {
+    /**
+     * Emitted after a comment is created or replied to.
+     *
+     * Subject: `vcs:events.comment.created`
+     * Type: Event
+     */
+    'comment.created': z.ZodObject<{
+        repoPath: z.ZodString;
+        prNumber: z.ZodNumber;
+        commentId: z.ZodNumber;
+    }, z.core.$strip>;
+    /**
+     * Emitted after a thread is resolved.
+     *
+     * Subject: `vcs:events.thread.resolved`
+     * Type: Event
+     */
+    'thread.resolved': z.ZodObject<{
+        repoPath: z.ZodString;
+        prNumber: z.ZodNumber;
+        threadId: z.ZodString;
+    }, z.core.$strip>;
+}>;
+/**
+ * Type-safe subjects for VCS events.
+ *
+ * Use these subjects with bus.emit() to trigger cache invalidation,
+ * or with bus.on() to subscribe to cache invalidation events.
+ */
+export declare const VCSEvents: import("@makaio/framework/core").BusSubjects<import("@makaio/framework/core").FlatSubjectDefinitions<"vcs:events", {
+    /**
+     * Emitted after a comment is created or replied to.
+     *
+     * Subject: `vcs:events.comment.created`
+     * Type: Event
+     */
+    'comment.created': z.ZodObject<{
+        repoPath: z.ZodString;
+        prNumber: z.ZodNumber;
+        commentId: z.ZodNumber;
+    }, z.core.$strip>;
+    /**
+     * Emitted after a thread is resolved.
+     *
+     * Subject: `vcs:events.thread.resolved`
+     * Type: Event
+     */
+    'thread.resolved': z.ZodObject<{
+        repoPath: z.ZodString;
+        prNumber: z.ZodNumber;
+        threadId: z.ZodString;
+    }, z.core.$strip>;
+}>, "vcs:events">;
+//# sourceMappingURL=events.d.ts.map

package/dist/capabilities/vcs/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/capabilities/vcs/events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;;;;OAKG;;;;;;IAUH;;;;;OAKG;;;;;;EASH,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IArCpB;;;;;OAKG;;;;;;IAUH;;;;;OAKG;;;;;;iBAiB+C,CAAC"}

package/dist/capabilities/vcs/index.d.ts

@@ -0,0 +1,7 @@
+export type { IVCSProvider, CreatePROptions, MergeOptions } from './types.js';
+export { VCSCheckRunSchema, VCSCommitStatusSchema, VCSPullRequestDetailSchema, VCSPullRequestSchema, VCSRepositorySchema, VCSReviewCommentSchema, VCSReviewSchema, VCSSchemas, } from './schemas/index.js';
+export type { VCSCheckRun, VCSCommitStatus, VCSPullRequest, VCSPullRequestDetail, VCSRepository, VCSReview, VCSReviewComment, } from './schemas/index.js';
+export { VCSNamespace, VCSSubjects } from './namespace.js';
+export { VCSEvents, VCSEventsNamespace } from './events.js';
+export { VCS_CAPABILITY_ID, registerVCSProvider, unregisterVCSProvider } from './register.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/vcs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/vcs/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,eAAe,EACf,UAAU,GACX,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,WAAW,EACX,eAAe,EACf,cAAc,EACd,oBAAoB,EACpB,aAAa,EACb,SAAS,EACT,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}