@intrect/openswarm 0.2.0

package/dist/agents/pairPipeline.d.ts

@@ -0,0 +1,155 @@
+import { EventEmitter } from 'node:events';
+import type { TaskItem } from '../orchestration/decisionEngine.js';
+import type { WorkerResult, ReviewResult, PairSession } from './agentPair.js';
+import type { TesterResult } from './tester.js';
+import type { DocumenterResult } from './documenter.js';
+import type { AuditorResult } from './auditor.js';
+import type { SkillDocumenterResult } from './skillDocumenter.js';
+import type { PipelineStage, RoleConfig, PipelineGuardsConfig, JobProfile } from '../core/types.js';
+import { type CostInfo } from '../support/costTracker.js';
+import { type GuardsRunResult } from './pipelineGuards.js';
+export interface PipelineConfig {
+    /** List of active stages (executed in order) */
+    stages: PipelineStage[];
+    /** Whether to continue on test failure */
+    continueOnTestFail?: boolean;
+    /** Skip Documenter if no changes */
+    skipDocumenterIfNoChange?: boolean;
+    /** Max total iterations (one cycle = Worker → Reviewer → Tester) */
+    maxIterations?: number;
+    /** Per-role configuration */
+    roles?: {
+        worker?: RoleConfig;
+        reviewer?: RoleConfig;
+        tester?: RoleConfig;
+        documenter?: RoleConfig;
+        auditor?: RoleConfig;
+        'skill-documenter'?: RoleConfig;
+    };
+    /** Pipeline guards configuration */
+    guards?: Partial<PipelineGuardsConfig>;
+    /** Optional job profiles for model selection */
+    jobProfiles?: JobProfile[];
+    /** Skip tester if no code files (.ts/.js/.py etc.) changed (default: true) */
+    skipTesterIfNoCodeChange?: boolean;
+    /** Skip auditor if fewer than N files changed (default: 3) */
+    skipAuditorUnderFileCount?: number;
+    /** Enable verbose logging (detailed stage info, agent decisions, timing) */
+    verbose?: boolean;
+}
+export interface StageResult {
+    stage: PipelineStage;
+    success: boolean;
+    result: WorkerResult | ReviewResult | TesterResult | DocumenterResult | AuditorResult | SkillDocumenterResult | {
+        success: false;
+        error: string;
+    };
+    duration: number;
+    /** Stage start time (epoch ms) */
+    startedAt: number;
+    /** Stage completion time (epoch ms) */
+    completedAt: number;
+}
+export interface PipelineResult {
+    success: boolean;
+    sessionId: string;
+    stages: StageResult[];
+    finalStatus: 'approved' | 'rejected' | 'failed' | 'cancelled' | 'decomposed';
+    totalDuration: number;
+    /** Total number of completed iterations */
+    iterations: number;
+    workerResult?: WorkerResult;
+    reviewResult?: ReviewResult;
+    testerResult?: TesterResult;
+    documenterResult?: DocumenterResult;
+    auditorResult?: AuditorResult;
+    skillDocumenterResult?: SkillDocumenterResult;
+    /** Task context (for reporting) */
+    taskContext?: {
+        issueIdentifier?: string;
+        projectName?: string;
+        projectPath?: string;
+        taskTitle?: string;
+    };
+    /** PR URL (auto-created PR in worktree mode) */
+    prUrl?: string;
+    /** Total cost across all stages */
+    totalCost?: CostInfo;
+}
+export interface PipelineContext {
+    task: TaskItem;
+    projectPath: string;
+    session: PairSession;
+    config: PipelineConfig;
+    /** Current iteration number (1-based) */
+    currentIteration: number;
+    /** Formatted task prefix for consistent logging (e.g., "OpenSwarm | INT-1171 | worktree/abc123") */
+    taskPrefix: string;
+    workerResult?: WorkerResult;
+    reviewResult?: ReviewResult;
+    testerResult?: TesterResult;
+    documenterResult?: DocumenterResult;
+    auditorResult?: AuditorResult;
+    skillDocumenterResult?: SkillDocumenterResult;
+    guardsResult?: GuardsRunResult;
+}
+/**
+ * Build a consistent task prefix for logging across all pipeline stages.
+ * Format: "ProjectName | INT-XXX | worktree/abc123" or "ProjectName | INT-XXX"
+ */
+export declare function buildTaskPrefix(task: TaskItem, projectPath: string): string;
+export type PipelineEventType = 'stage:start' | 'stage:complete' | 'stage:fail' | 'iteration:start' | 'iteration:complete' | 'iteration:fail' | 'pipeline:complete' | 'pipeline:fail' | 'halt';
+export declare class PairPipeline extends EventEmitter {
+    private config;
+    private stuckDetector;
+    private jobProfiles;
+    constructor(config: PipelineConfig);
+    private matchesProfile;
+    private getProfileForTask;
+    private getModelForRole;
+    /**
+     * Run pipeline
+     *
+     * 1 iteration = full pass through Worker → Reviewer → Tester
+     * On failure at any stage, returns to Worker (up to maxIterations)
+     */
+    run(task: TaskItem, projectPath: string): Promise<PipelineResult>;
+    /**
+     * Check if a stage is enabled
+     */
+    private hasStage;
+    /**
+     * Run a single stage
+     */
+    private runStage;
+    /**
+     * Determine stage success
+     */
+    private isStageSuccess;
+    /**
+     * Full iteration loop
+     *
+     * 1 iteration = full pass through Worker → Reviewer → Tester
+     * On failure (revise) at any stage, restart from Worker in next iteration
+     * reject = immediate termination
+     */
+    private runFullIterationLoop;
+    /**
+     * Build pipeline result
+     */
+    private buildResult;
+}
+/**
+ * Create default pipeline (Worker + Reviewer)
+ */
+export declare function createDefaultPipeline(maxIterations?: number): PairPipeline;
+/**
+ * Create full pipeline (Worker + Reviewer + Tester + Documenter)
+ */
+export declare function createFullPipeline(config?: Partial<PipelineConfig>): PairPipeline;
+/**
+ * Create pipeline from configuration
+ */
+export declare function createPipelineFromConfig(roles: PipelineConfig['roles'], maxIterations?: number, guards?: Partial<PipelineGuardsConfig>, jobProfiles?: JobProfile[]): PairPipeline;
+export { formatPipelineResult, formatPipelineResultEmbed } from './pipelineFormat.js';
+//# sourceMappingURL=pairPipeline.d.ts.map

package/dist/agents/pairPipeline.d.ts.map

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