@urateam/core 0.1.0

package/dist/pipeline/runner.d.ts

@@ -0,0 +1,142 @@
+import type { PipelineConfig, RepoConfig, Notifier, SanitizedIssue } from "../types.js";
+import type { Db } from "../db/client.js";
+import { type GitHubConfig } from "../repo/github.js";
+import { type GitLabConfig } from "../repo/gitlab.js";
+import type { ReviewFeedbackComment } from "../webhook/github-handler.js";
+/**
+ * Test whether a file path matches any of the provided glob patterns.
+ * Supports `**` (any path segments), `*` (any chars except `/`), and `?`
+ * (any single char except `/`). Used for auto-merge exclusion patterns.
+ */
+export declare function matchesAnyPattern(filePath: string, patterns: string[]): boolean;
+export interface PipelineRunnerConfig {
+    db: Db;
+    notifier: Notifier;
+    concurrency?: number;
+    agentRunDir?: string;
+    repoCloneDir?: string;
+    github?: GitHubConfig;
+    gitlab?: GitLabConfig;
+    /**
+     * Maximum time (ms) to wait for the distributed branch lock before failing
+     * the pipeline.  Defaults to 120 000 ms (2 minutes).
+     */
+    prLockTimeoutMs?: number;
+}
+export interface LinearIssue {
+    id: string;
+    identifier: string;
+    title: string;
+    description: string;
+    labels: Array<{
+        name: string;
+    }>;
+    priority: number;
+    teamId: string;
+    projectId?: string;
+}
+export declare class PipelineRunner {
+    private queue;
+    /** Push queue: concurrency=1 serialises push+PR creation within this process.
+     *  The distributed branch lock (withBranchLock) extends this to multiple
+     *  instances so they don't race on PR creation for the same branch. */
+    private pushQueue;
+    private db;
+    private notifier;
+    private activeRuns;
+    private budgetAlertedRuns;
+    /** PR URL -> runId for in-flight review-feedback runs (rate-limit gate). */
+    private activeFeedbackRuns;
+    private agentRunDir;
+    private repoCloneDir;
+    private githubConfig?;
+    private gitlabConfig?;
+    private lockAdapter;
+    private prLockTimeoutMs;
+    constructor(config: PipelineRunnerConfig);
+    start(issue: LinearIssue, pipelineKey: string, pipelineConfig: PipelineConfig, repoConfig: RepoConfig, sanitizedIssue: SanitizedIssue): Promise<void>;
+    resume(issueId: string): Promise<void>;
+    pause(issueId: string): Promise<void>;
+    abort(issueId: string): Promise<void>;
+    isActive(issueId: string): boolean;
+    /** Returns true if a review-feedback run is already in progress for the given PR URL. */
+    isActiveFeedback(prUrl: string): boolean;
+    /**
+     * Start a review-feedback pipeline run triggered by a PR review comment.
+     *
+     * Unlike start(), this method:
+     *  - Does NOT create a new branch — it checks out the existing PR branch.
+     *  - Skips triage and reproduce stages, entering directly at implement.
+     *  - Does NOT create a new PR — it pushes to the same branch.
+     *  - Optionally re-requests review after pushing.
+     */
+    startFeedback(params: {
+        issue: LinearIssue;
+        pipelineKey: string;
+        pipelineConfig: PipelineConfig;
+        repoConfig: RepoConfig;
+        sanitizedIssue: SanitizedIssue;
+        branch: string;
+        prUrl: string;
+        prNumber?: number;
+        parentRunId?: string;
+        feedbackComments: ReviewFeedbackComment[];
+        rerequestReview?: boolean;
+    }): Promise<void>;
+    /**
+     * Inject the framework's CLAUDE.md into the worktree if the repo doesn't
+     * already have one. Claude Code automatically reads CLAUDE.md from the
+     * working directory, so this establishes coding standards for every stage.
+     */
+    private injectAgentConfig;
+    private executePipeline;
+    private failPipeline;
+    /**
+     * Check token budget and send alert/fail as needed. Returns true if the budget
+     * has been exceeded and the pipeline should abort.
+     */
+    private checkTokenBudget;
+    /**
+     * Recover pipeline runs that were interrupted by a previous server restart.
+     *
+     * Queries for any runs with status 'running' or 'queued' that are NOT
+     * currently tracked in the in-memory activeRuns map (i.e. they belong to a
+     * previous process). For each such run the method:
+     *   1. Checks whether the worktree still exists on disk.
+     *   2. Marks the run as 'failed' with a descriptive error message.
+     *   3. Removes the corresponding active_work coordination row.
+     *   4. Emits a structured warning log entry.
+     *
+     * After processing all stuck runs the method runs `git worktree prune` on
+     * every repository clone directory to remove stale worktree administrative
+     * entries that git still knows about.
+     *
+     * Call this once, early in the startup sequence, before the webhook server
+     * begins accepting requests.
+     */
+    recoverStuckRuns(): Promise<void>;
+    /**
+     * Run `git worktree prune` on every repository directory found under
+     * repoCloneDir. Uses gitExecSafe so failures (e.g. non-git directories)
+     * are silently ignored.
+     */
+    private pruneAllWorktreeRefs;
+    /**
+     * Query the DB for all runs on a given date and emit a DailyTokenSummary
+     * notification. Defaults to today (UTC).
+     */
+    sendDailyTokenSummary(date?: Date): Promise<void>;
+    /**
+     * Execute a review-feedback pipeline run.
+     *
+     * Key differences from executePipeline():
+     *  - Checks out the EXISTING PR branch (not a new one).
+     *  - Skips triage, reproduce, await-approval stages.
+     *  - Does NOT create a new PR — pushes to the same branch.
+     *  - Optionally re-requests review via GitHub App after push.
+     *  - Feedback comment context is injected into the implement stage prompt.
+     */
+    private executeFeedbackPipeline;
+    private buildPipelineRun;
+}
+//# sourceMappingURL=runner.d.ts.map

package/dist/pipeline/runner.d.ts.map

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