@urateam/core 0.1.0

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,225 @@
+import { z } from "zod";
+// --- Stage Types ---
+export const StageTypeSchema = z.enum([
+    "triage", "await-approval", "reproduce", "implement", "test", "review",
+]);
+export const AGENT_STAGES = [
+    "triage", "reproduce", "implement", "test", "review",
+];
+// --- Pipeline Config ---
+export const RetryStrategySchema = z.enum(["fix-and-retry", "escalate", "fail-fast"]);
+export const RetryConfigSchema = z.object({
+    maxAttempts: z.number().int().min(0),
+    strategy: RetryStrategySchema,
+});
+export const ReviewConfigSchema = z.object({
+    requiredApprovals: z.number().int().min(0),
+});
+export const PipelineConfigSchema = z.object({
+    name: z.string(),
+    stages: z.array(StageTypeSchema).min(1),
+    retry: RetryConfigSchema,
+    review: ReviewConfigSchema,
+    prStrategy: z.enum(["draft", "ready"]),
+    /** Run a lightweight validation agent after each stage to verify handoff accuracy.
+     *  Default: false. Set to true to opt in (adds ~15-20K tokens per run). */
+    validateHandoffs: z.boolean().optional(),
+    /** RALPH loop iterations for the implement stage. 0 disables. Default: 1.
+     *  Set to 2 for more thorough requirements checking (adds ~100-200K tokens per iteration). */
+    ralphIterations: z.number().int().min(0).max(5).optional(),
+    /** Review-fix loop iterations. When review finds blocking issues, re-run implement→test→review.
+     *  Default: 1, 0 disables. WARNING: compounds with ralphIterations — worst case is
+     *  reviewFixIterations × (1 + ralphIterations) implement runs per fix cycle.
+     *  Set to 2 for an extra fix pass (adds ~150-300K tokens per iteration). */
+    reviewFixIterations: z.number().int().min(0).max(5).optional(),
+    /** Deep review passes using 3 parallel sub-agents (reuse, quality, efficiency).
+     *  Runs after the review-fix loop resolves blocking findings. Default: 0 (disabled).
+     *  Set to 1 to opt in for critical pipelines (adds ~45-100K tokens per pass). */
+    deepReviewPasses: z.number().int().min(0).max(5).optional(),
+    /** Hard cap on deep review passes. Prevents infinite loops. Default: 3. */
+    maxDeepReviewPasses: z.number().int().min(1).max(10).optional(),
+    /** Auto-merge PRs when changes are trivial. Default: false (opt-in). */
+    autoMerge: z.boolean().optional(),
+    /** Max diff lines for auto-merge eligibility. Default: 200. */
+    autoMergeMaxLines: z.number().int().min(1).optional(),
+    /** File glob patterns that require manual review (skip auto-merge if any changed file matches).
+     *  Example: ["**\/migrations\/**", "**\/*.env", "infra\/**"]  */
+    autoMergeExcludePatterns: z.array(z.string()).optional(),
+    /**
+     * Advanced automerge criteria evaluated when GitHub sends a PR event (check_suite.completed,
+     * status, pull_request.labeled, etc.).  All criteria must pass for the PR to be merged.
+     * Requires GitHub App credentials (github config in ServerConfig).
+     */
+    autoMergeConfig: z.object({
+        /** Minimum number of unique approving reviews required. Default: 0. */
+        minimumApprovingReviews: z.number().int().min(0).optional(),
+        /** Status check context names (or check run names) that must all report "success".
+         *  Example: ["ci/tests", "security/snyk"]  */
+        requiredStatusChecks: z.array(z.string()).optional(),
+        /** Labels the PR must carry — all listed labels must be present. Default: [] */
+        requiredLabels: z.array(z.string()).optional(),
+        /** Allowed base branches for auto-merge. If empty, any base branch is allowed. */
+        allowedBranches: z.array(z.string()).optional(),
+        /** Merge method to use when merging the PR. Default: "squash". */
+        mergeMethod: z.enum(["merge", "squash", "rebase"]).optional(),
+    }).optional(),
+    /** Maximum total tokens (input + output) allowed per pipeline run. Exceeding this aborts the run. */
+    maxTokens: z.number().int().positive().optional(),
+    /** Per-stage model overrides. Keys are stage names; values are model strings passed to the Agent SDK.
+     *  Invalid model strings are passed through as-is (let the SDK error, no local validation).
+     *  Example: { implement: "claude-opus-4-6", test: "claude-haiku-4-5" } */
+    stageModels: z.record(z.string()).optional(),
+    /** Fail the pipeline run if the agent did not commit its work and auto-commit was triggered.
+     *  When false (default), auto-commit is a silent safety net and the run continues normally.
+     *  When true, triggering auto-commit is treated as a pipeline error so the issue surfaces immediately. */
+    failOnAutoCommit: z.boolean().optional(),
+});
+// --- Trigger Map ---
+export const TriggerMapSchema = z.object({
+    start: z.string(),
+    resume: z.string(),
+    pause: z.string(),
+    abort: z.string(),
+});
+export const DEFAULT_TRIGGER_MAP = {
+    start: "Todo",
+    resume: "Approved",
+    pause: "Blocked",
+    abort: "Canceled",
+};
+// --- Repo Config ---
+// Each setup command is [command, ...args] to avoid shell parsing.
+// Example: ["pnpm", "install", "--frozen-lockfile"]
+export const SetupCommandSchema = z.array(z.string()).min(1);
+export const McpServerEntrySchema = z.object({
+    command: z.string(),
+    args: z.array(z.string()).optional(),
+    env: z.record(z.string()).optional(),
+});
+export const PluginEntrySchema = z.object({
+    type: z.literal("local"),
+    path: z.string(),
+});
+export const PluginConfigSchema = z.object({
+    /** Explicit MCP servers to always include */
+    mcpServers: z.record(McpServerEntrySchema).optional(),
+    /** MCP server names to never include */
+    excludeMcpServers: z.array(z.string()).optional(),
+    /** Explicit plugins to always include */
+    plugins: z.array(PluginEntrySchema).optional(),
+    /** Plugin paths to never include */
+    excludePlugins: z.array(z.string()).optional(),
+    /** Set to false to disable auto-detection of plugins/MCP servers */
+    autoDetect: z.boolean().optional(),
+});
+export const DevcontainerConfigSchema = z.object({
+    /** Enable devcontainer usage. Default: "auto" (use if .devcontainer exists) */
+    mode: z.enum(["auto", "always", "never"]).optional(),
+    /** Override path to devcontainer config */
+    configPath: z.string().optional(),
+    /** Extra environment variables for the container */
+    env: z.record(z.string()).optional(),
+});
+export const GitHubFeedbackConfigSchema = z.object({
+    /**
+     * GitHub logins allowed to trigger feedback runs.
+     * If empty/omitted, any reviewer can trigger.
+     */
+    allowedReviewers: z.array(z.string()).optional(),
+    /**
+     * GitHub logins that should never trigger feedback runs (e.g. the bot itself).
+     */
+    botLogins: z.array(z.string()).optional(),
+    /**
+     * If provided, only comments containing this keyword trigger a feedback run.
+     * When omitted and autoTrigger is true (the default), any qualifying comment triggers.
+     * Example: "@agent fix this"
+     */
+    triggerKeyword: z.string().optional(),
+    /**
+     * If true (default), any qualifying review comment automatically triggers a feedback run.
+     * Set to false to require the triggerKeyword to be present.
+     */
+    autoTrigger: z.boolean().optional(),
+    /**
+     * If true, re-request review on the PR after the feedback run pushes changes.
+     * Requires GitHub App credentials in server config. Default: false.
+     */
+    rerequestReview: z.boolean().optional(),
+});
+export const RepoConfigSchema = z.object({
+    url: z.string(),
+    defaultBranch: z.string(),
+    testCommand: z.string(),
+    buildCommand: z.string(),
+    setupCommands: z.array(SetupCommandSchema).optional(),
+    workingDirectory: z.string().optional(),
+    plugins: PluginConfigSchema.optional(),
+    devcontainer: DevcontainerConfigSchema.optional(),
+    /** Per-team trigger map. Overrides the global triggerMap for this team's repo. Falls back to DEFAULT_TRIGGER_MAP. */
+    triggerMap: TriggerMapSchema.optional(),
+    /** Hosting provider. Defaults to "github". Set to "gitlab" for GitLab repos. */
+    provider: z.enum(["github", "gitlab"]).optional(),
+    /** Configuration for GitHub PR review comment → pipeline re-entry (feedback runs). */
+    githubFeedback: GitHubFeedbackConfigSchema.optional(),
+});
+// --- Handoff Artifact ---
+export const TestResultSchema = z.object({
+    passed: z.number().int().min(0),
+    failed: z.number().int().min(0),
+    firstFailure: z.object({
+        test: z.string(),
+        error: z.string(),
+        file: z.string(),
+    }).optional(),
+});
+export const ReviewFindingSchema = z.object({
+    severity: z.enum(["blocking", "warning", "suggestion"]),
+    file: z.string(),
+    line: z.number().int(),
+    category: z.string(),
+    description: z.string(),
+    fix: z.string(),
+});
+export const HandoffArtifactSchema = z.object({
+    runId: z.string(),
+    issueId: z.string(),
+    stage: z.string(),
+    timestamp: z.string(),
+    summary: z.string(),
+    filesChanged: z.array(z.string()),
+    approach: z.string(),
+    context: z.object({
+        issueIntent: z.string(),
+        constraints: z.array(z.string()),
+        assumptions: z.array(z.string()),
+        testResults: TestResultSchema.optional(),
+        reviewFindings: z.array(ReviewFindingSchema).optional(),
+    }),
+    tokenBudget: z.object({
+        contextTokensUsed: z.number().int().min(0),
+        recommendedMaxTurns: z.number().int().min(0),
+    }),
+});
+// --- Review Feedback Context ---
+export const ReviewCommentSchema = z.object({
+    author: z.string(),
+    body: z.string(),
+    file: z.string().optional(),
+    line: z.number().int().optional(),
+    diffHunk: z.string().optional(),
+    createdAt: z.string(),
+});
+export const ReviewFeedbackContextSchema = z.object({
+    /** The URL of the PR being reviewed. */
+    prUrl: z.string(),
+    /** The branch to push fixes to (the existing PR branch). */
+    prBranch: z.string(),
+    /** Inline review comments with file/line context. */
+    comments: z.array(ReviewCommentSchema),
+    /** Optional overall review summary body (for full reviews, not just inline comments). */
+    reviewBody: z.string().optional(),
+    /** The original implement handoff, for context on what was done. */
+    previousHandoff: HandoffArtifactSchema.optional(),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/webhook/github-handler.d.ts

@@ -0,0 +1,39 @@
+import { Hono } from "hono";
+import type { AnyDb } from "../db/client.js";
+import type { PipelineRunner } from "../pipeline/runner.js";
+import type { PipelineConfig, RepoConfig } from "../types.js";
+import type { GitHubConfig } from "../repo/github.js";
+/** A single piece of review feedback from a GitHub PR comment or review. */
+export interface ReviewFeedbackComment {
+    commentId: string;
+    author: string;
+    body: string;
+    /** File path for inline review comments. */
+    filePath?: string;
+    /** Line number for inline review comments. */
+    lineNumber?: number;
+}
+export interface GitHubWebhookHandlerConfig {
+    /**
+     * GitHub webhook secret used to verify X-Hub-Signature-256 HMAC.
+     * If not provided, signature verification is skipped (not recommended for production).
+     */
+    webhookSecret?: string;
+    runner: PipelineRunner;
+    pipelineConfigs: Record<string, PipelineConfig>;
+    repoConfigs: Record<string, RepoConfig>;
+    db: AnyDb;
+    /**
+     * GitHub App credentials for automerge via the GitHub API.
+     * Required for autoMergeConfig criteria checks (minimumApprovingReviews,
+     * requiredStatusChecks, etc.).  When not provided, automerge events are skipped.
+     */
+    github?: GitHubConfig;
+}
+/**
+ * Verify a GitHub webhook signature.
+ * GitHub sends "sha256=<hex-digest>" in the X-Hub-Signature-256 header.
+ */
+export declare function verifyGitHubSignature(body: string, signature: string, secret: string): boolean;
+export declare function createGitHubWebhookHandler(config: GitHubWebhookHandlerConfig): Hono;
+//# sourceMappingURL=github-handler.d.ts.map

package/dist/webhook/github-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github-handler.d.ts","sourceRoot":"","sources":["../../src/webhook/github-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAStD,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,cAAc,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,EAAE,EAAE,KAAK,CAAC;IACV;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAWT;AAsLD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,0BAA0B,GACjC,IAAI,CA0SN"}