@vibesdotdev/forge 0.0.0-stage → 1.0.0-rc.4

package/dist/plugin.js

@@ -0,0 +1,58 @@
+import { createRuntimePlugin, createRuntimeImplementation, loader } from '@vibesdotdev/kernel';
+import { runtimeClientKind } from '@vibesdotdev/kernel/client';
+import { forgeApiClientKind } from "./forge.api-client.js";
+import { forgeApiClientDescriptor } from "./forge.api-client.descriptor.js";
+import { forgePullRequestKind } from "./pull-request/pull-request.js";
+import { ForgePullRequestDescriptorSchema, forgePullRequestDescriptor } from "./pull-request/pull-request.descriptor.js";
+import { forgePrStacksStorageDescriptor } from "./storage/index.js";
+import { forgePrStacksStorageTransform } from "./storage/index.js";
+import forgeStackOperationRecoveryJob from "./jobs/stack-operation-recovery.job.descriptor.js";
+import forgeStackOperationHostDescriptor, { FORGE_STACK_OPERATION_HOST_CONTEXT_ID } from "./jobs/stack-operation-host.context.js";
+const forgePlugin = createRuntimePlugin({
+    id: 'forge',
+    name: 'Forge Runtime',
+    description: 'Canonical Forge collaboration contracts and persisted pull-request stacks.',
+    dependencies: ['storage', 'workers'],
+    kinds: [runtimeClientKind, forgeApiClientKind, forgePullRequestKind],
+    loaders: [loader('forge', { kind: 'runtime/client' }, () => import("./client.js"))],
+    descriptors: [
+        { kind: 'runtime/client', id: 'forge', name: 'Forge',
+            config: { citations: { links: [{ kind: 'pr', source: 'forge' }], queryPolicy: 'literal' } } },
+        forgeApiClientDescriptor,
+        forgePullRequestDescriptor,
+        forgePrStacksStorageDescriptor,
+        forgePrStacksStorageTransform.descriptor,
+        forgeStackOperationHostDescriptor,
+        forgeStackOperationRecoveryJob
+    ],
+    async onRegister(runtime) {
+        runtime.registerLoader('storage/transform', forgePrStacksStorageTransform.descriptor.id, async () => forgePrStacksStorageTransform.implementation);
+        runtime.registerLoader('workers/job', forgeStackOperationRecoveryJob.id, async () => createRuntimeImplementation({
+            kind: 'workers/job',
+            id: forgeStackOperationRecoveryJob.id,
+            constraint: { hardware: ['cloud'] },
+            implementation: {
+                async handle(context) {
+                    const host = await runtime.context(FORGE_STACK_OPERATION_HOST_CONTEXT_ID);
+                    const { runForgeStackOperationRecoveryWith } = await import('./jobs/stack-operation-recovery.job.impl.js');
+                    return runForgeStackOperationRecoveryWith(context.data, host);
+                }
+            }
+        }), { constraint: { hardware: ['cloud'] } });
+        runtime.registerLoader('forge/pull-request', forgePullRequestDescriptor.id, async () => {
+            const { DefaultForgePullRequests } = await import('./pull-request/pull-request.impl.js');
+            return createRuntimeImplementation({
+                kind: 'forge/pull-request',
+                id: forgePullRequestDescriptor.id,
+                constraint: {},
+                implementation: class extends DefaultForgePullRequests {
+                    constructor(descriptor) {
+                        super(ForgePullRequestDescriptorSchema.parse(descriptor ?? forgePullRequestDescriptor), runtime);
+                    }
+                }
+            });
+        });
+    }
+});
+export default forgePlugin;
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/pr-idempotency.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stable identity for pull-request creation.
+ *
+ * A PR creation is unique for repository + source branch + target branch +
+ * resolved head commit. The head sha is the LIFECYCLE discriminator:
+ * `tracking_origins` provenance rows are immutable, so a key without it lets
+ * the first merged/closed PR for a branch pair poison every later create on
+ * the same pair (fixed-branch flows like autoloop's codex/autoloop→main).
+ * Retries of one creation attempt share the same resolved head, so they still
+ * collapse to a single key. A caller with NO resolvable head sha must not
+ * derive a key at all — it should mint a per-attempt id (crypto.randomUUID())
+ * instead; the open-PR lookup on the platform route still deduplicates that
+ * path. Keeping this framework-neutral lets the CLI, MCP tools, and platform
+ * route agree on the same retry/concurrency identity.
+ */
+/** Treat `feature/x` and `refs/heads/feature/x` as the same branch ref. */
+export declare function canonicalizePrRef(ref: string): string;
+/** Build a header-safe, deterministic key for one PR-creation lifecycle. */
+export declare function buildPrCreationIdempotencyKey(repositoryId: string, sourceRef: string, targetRef: string, 
+/** Resolved head commit sha — the lifecycle discriminator (case-insensitive). */
+headSha: string): string;
+//# sourceMappingURL=pr-idempotency.d.ts.map

package/dist/pr-idempotency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-idempotency.d.ts","sourceRoot":"","sources":["../src/pr-idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,2EAA2E;AAC3E,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAC5C,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM;AACjB,iFAAiF;AACjF,OAAO,EAAE,MAAM,GACb,MAAM,CAUR"}

package/dist/pr-idempotency.js

@@ -0,0 +1,36 @@
+/**
+ * Stable identity for pull-request creation.
+ *
+ * A PR creation is unique for repository + source branch + target branch +
+ * resolved head commit. The head sha is the LIFECYCLE discriminator:
+ * `tracking_origins` provenance rows are immutable, so a key without it lets
+ * the first merged/closed PR for a branch pair poison every later create on
+ * the same pair (fixed-branch flows like autoloop's codex/autoloop→main).
+ * Retries of one creation attempt share the same resolved head, so they still
+ * collapse to a single key. A caller with NO resolvable head sha must not
+ * derive a key at all — it should mint a per-attempt id (crypto.randomUUID())
+ * instead; the open-PR lookup on the platform route still deduplicates that
+ * path. Keeping this framework-neutral lets the CLI, MCP tools, and platform
+ * route agree on the same retry/concurrency identity.
+ */
+const HEADS_PREFIX = 'refs/heads/';
+/** Treat `feature/x` and `refs/heads/feature/x` as the same branch ref. */
+export function canonicalizePrRef(ref) {
+    const trimmed = ref.trim();
+    return trimmed.startsWith(HEADS_PREFIX) ? trimmed.slice(HEADS_PREFIX.length) : trimmed;
+}
+/** Build a header-safe, deterministic key for one PR-creation lifecycle. */
+export function buildPrCreationIdempotencyKey(repositoryId, sourceRef, targetRef, 
+/** Resolved head commit sha — the lifecycle discriminator (case-insensitive). */
+headSha) {
+    return [
+        'forge-pr-create',
+        repositoryId.trim(),
+        canonicalizePrRef(sourceRef),
+        canonicalizePrRef(targetRef),
+        headSha.trim().toLowerCase()
+    ]
+        .map(encodeURIComponent)
+        .join(':');
+}
+//# sourceMappingURL=pr-idempotency.js.map

package/dist/pr-idempotency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-idempotency.js","sourceRoot":"","sources":["../src/pr-idempotency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,YAAY,GAAG,aAAa,CAAC;AAEnC,2EAA2E;AAC3E,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;AACxF,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B,CAC5C,YAAoB,EACpB,SAAiB,EACjB,SAAiB;AACjB,iFAAiF;AACjF,OAAe;IAEf,OAAO;QACN,iBAAiB;QACjB,YAAY,CAAC,IAAI,EAAE;QACnB,iBAAiB,CAAC,SAAS,CAAC;QAC5B,iBAAiB,CAAC,SAAS,CAAC;QAC5B,OAAO,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE;KAC5B;SACC,GAAG,CAAC,kBAAkB,CAAC;SACvB,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC"}

package/dist/presentation.d.ts

@@ -0,0 +1,298 @@
+/**
+ * Light presentational prop types for forge UI shells.
+ *
+ * These are minimal data-in shapes for the (purely presentational) components
+ * in this package. They are deliberately decoupled from the app tracking schema
+ * (`TrackingItem`/`TrackingComment` etc.) — a host route maps its rows onto
+ * these shapes before rendering. Keep them small and additive.
+ */
+import type { TrackingPrState, StatusCheckState as TrackingStatusCheckState } from '@vibesdotdev/tracking-schemas';
+import type { CiStatus } from './ci/schemas.ts';
+export type { ForgePrStackMemberView, ForgePrStackView, ForgePrStackMembershipProjection } from './schemas/stack.ts';
+/**
+ * Lifecycle state shared by issues and pull requests. This is a *presentational
+ * reduction* of the canonical tracking status set (an issue is shown as
+ * `open` / `closed` / `draft`); a host route maps the full
+ * `TrackingItemStatus` onto these three buckets before rendering, so it is
+ * intentionally not derived from a tracking enum.
+ */
+export type IssueState = 'open' | 'closed' | 'draft';
+/**
+ * Pull-request lifecycle state. DERIVED (type-only) from the canonical
+ * `@vibesdotdev/tracking-schemas` `TrackingPrState` (the leaf shared with
+ * `@vibesdotdev/projects/app`'s tracking domain) so the forge PR badge can never drift
+ * from the schema. `import type` keeps `@vibesdotdev/tracking-schemas` erased
+ * at runtime. The drift guard lives in `__tests__/pr-state.test.ts`.
+ */
+export type PrState = TrackingPrState;
+/** A repository label / tag. */
+export interface Label {
+    name: string;
+    /** Hex color (`#rrggbb`) or any CSS color; the chip derives contrast text. */
+    color?: string;
+    description?: string;
+}
+/** A user reference for authorship / assignment. */
+export interface ForgeUser {
+    id?: string;
+    /** Handle or display name shown in the UI. */
+    name: string;
+    avatarUrl?: string;
+    /** Optional `@handle` (without the leading `@`) shown beside the name. */
+    handle?: string;
+    /**
+     * Marks AI-authored identity. When true the chip renders a small bot badge.
+     * The `isAgent` prop on `UserChip` takes precedence over this flag.
+     */
+    isAgent?: boolean;
+}
+/** A row in an issue list. */
+export interface IssueSummary {
+    number: number;
+    title: string;
+    state: IssueState;
+    labels?: Label[];
+    assignee?: ForgeUser | null;
+    commentCount?: number;
+    /** ISO timestamp or pre-formatted string; rendered verbatim. */
+    updatedAt?: string;
+}
+/** A fully-rendered issue (detail view). */
+export interface IssueDetail {
+    number: number;
+    title: string;
+    state: IssueState;
+    /** Markdown body. */
+    body?: string;
+    author?: ForgeUser;
+    labels?: Label[];
+    assignees?: ForgeUser[];
+    /** ISO timestamp or pre-formatted string. */
+    createdAt?: string;
+}
+/** A single comment in a thread (issue comments and PR review threads). */
+export interface IssueComment {
+    id: string;
+    author: ForgeUser;
+    /** Markdown body. */
+    body: string;
+    /** ISO timestamp or pre-formatted string. */
+    createdAt?: string;
+    /** True when authored by the current viewer (for subtle highlight). */
+    mine?: boolean;
+}
+/** Anchor for a code-review thread. */
+export interface ReviewAnchor {
+    path: string;
+    line: number;
+    /** Which side of the diff the line belongs to. */
+    side?: 'old' | 'new';
+    /** The commit the thread was anchored to. */
+    commitSha?: string;
+}
+/** A code-review thread: comments anchored to a diff location. */
+export interface ReviewThreadData {
+    id: string;
+    anchor: ReviewAnchor;
+    comments: IssueComment[];
+    /** Thread resolution state. */
+    resolved?: boolean;
+    /** The anchored line no longer exists in the latest diff. */
+    outdated?: boolean;
+}
+/** A pull-request summary row. */
+export interface PullRequestSummary {
+    number: number;
+    title: string;
+    state: PrState;
+    sourceRef: string;
+    targetRef: string;
+    labels?: Label[];
+    author?: ForgeUser | null;
+    commentCount?: number;
+    /** ISO timestamp or pre-formatted string. */
+    updatedAt?: string;
+}
+/**
+ * A forge-actions CI status-check state. DERIVED (type-only) from the canonical
+ * `@vibesdotdev/tracking-schemas` `StatusCheckState` so the forge status badge
+ * can never drift from the schema.
+ */
+export type StatusCheckState = TrackingStatusCheckState;
+/**
+ * A single PR status-check row (presentational reduction of the app
+ * `StatusCheck`). A host route maps its `metadata.statusChecks` array onto these
+ * before rendering; the component is data-in / no-fetch.
+ */
+export interface StatusCheckRow {
+    /** Logical check name, e.g. `forge/test`, `forge/deploy`, `forge/config`. */
+    context: string;
+    state: StatusCheckState;
+    /** Optional deep link to the run logs. */
+    targetUrl?: string;
+    /** Short human description rendered under the context. */
+    description?: string;
+}
+/**
+ * Canonical package-owned CI lifecycle state.
+ */
+export type ForgeRunState = CiStatus;
+export interface ForgeRunAttemptRow {
+    id: string;
+    suiteId: string;
+    context: string;
+    runnerId: string;
+    executorId: string;
+    ordinal: number;
+    state: ForgeRunState;
+    failureSummary?: string | null;
+    logsRef?: string | null;
+    artifactsRef?: string | null;
+    startedAt?: string | null;
+    finishedAt?: string | null;
+    durationMs?: number | null;
+}
+/**
+ * A row in the forge Actions tab (a recorded CI run). Presentational, data-in:
+ * a host route maps the package `CiRun` contract onto this before
+ * rendering (decoupled from the DB row, like the `RepoIssue → IssueSummary`
+ * mapping). Timestamps are ISO strings or pre-formatted strings (rendered
+ * verbatim); `durationMs` is the run wall-clock the host may pre-format.
+ */
+export interface ForgeRunRow {
+    id: string;
+    state: ForgeRunState;
+    /** Stable compiled pipeline id. */
+    pipelineId: string;
+    /** Required status contexts produced by the immutable execution plan. */
+    requiredContexts: string[];
+    /** The commit the run was dispatched for (full sha; the row shows a short form). */
+    sha: string;
+    /** Event class that triggered the run (e.g. `pr`); rendered verbatim. */
+    event?: string;
+    /** Associated pull-request number, when the run came from a PR pipeline. */
+    prNumber?: number | null;
+    /** Short human description of the outcome. */
+    summary?: string | null;
+    attempts?: ForgeRunAttemptRow[];
+    /** ISO timestamp or pre-formatted string; rendered verbatim. */
+    startedAt?: string | null;
+    /** ISO timestamp or pre-formatted string; rendered verbatim. */
+    finishedAt?: string | null;
+    /** Run wall-clock in milliseconds (the row formats it as a duration). */
+    durationMs?: number | null;
+    /** ISO timestamp or pre-formatted string; rendered verbatim. */
+    createdAt?: string | null;
+}
+/** Kind of timeline event for a PR / issue. */
+export type TimelineEventKind = 'opened' | 'commented' | 'committed' | 'reviewed' | 'labeled' | 'merged' | 'closed' | 'reopened';
+/** A single PR/issue timeline event. */
+export interface TimelineEvent {
+    id: string;
+    kind: TimelineEventKind;
+    actor?: ForgeUser;
+    /** Short human description (e.g. "approved these changes"). */
+    summary?: string;
+    /** ISO timestamp or pre-formatted string. */
+    at?: string;
+}
+/** A board column definition (maps to a PlanningStatusSet category). */
+export interface KanbanColumn {
+    /** Stable status id matching `IssueSummary` placement. */
+    id: string;
+    label: string;
+    /** Accent color for the column header. */
+    color?: string;
+    /** Marks whether this column represents a terminal/completed state (e.g. done, closed). */
+    isFinal?: boolean;
+}
+/** A card on the kanban board. */
+export interface KanbanCard {
+    /** Stable item identity. Falls back to the repository issue number for older callers. */
+    id?: string;
+    number: number;
+    title: string;
+    /** The column id this card belongs to. */
+    columnId: string;
+    state?: IssueState;
+    labels?: Label[];
+    assignee?: ForgeUser | null;
+    description?: string | null;
+    priority?: string;
+    type?: string;
+    updatedAt?: string;
+    createdAt?: string;
+    repositoryId?: string;
+    repositoryName?: string;
+    /** Marks whether the card has been archived from active board views. */
+    archived?: boolean;
+}
+/**
+ * A row in the projects list. A "project" is the first-class planning entity
+ * that rolls up issues/PRs across one or more member repositories. Presentational
+ * data-in shape — a host route maps its `Project` wire rows onto this.
+ */
+export interface ProjectSummary {
+    id: string;
+    name: string;
+    /** Optional owner-scoped slug (rendered as a subtle handle). */
+    slug?: string | null;
+    description?: string | null;
+    /** Lifecycle status (e.g. `active`, `archived`); rendered verbatim. */
+    status?: string;
+    /** Visibility marker (`public` / `private`); drives a small badge. */
+    visibility?: string;
+    /** Count of member repositories linked to the project. */
+    repoCount?: number;
+    /** Count of open issues/PRs rolled up across member repos. */
+    openCount?: number;
+    /** ISO timestamp or pre-formatted string; rendered verbatim. */
+    updatedAt?: string;
+}
+/**
+ * A milestone roll-up row. Progress is the closed/total ratio of the tracking
+ * items assigned to the milestone; the host route supplies the counts (this
+ * package never aggregates). Mirrors `PlanningMilestoneSchema` fields plus the
+ * derived progress counters.
+ */
+export interface MilestoneSummary {
+    id: string;
+    title: string;
+    description?: string | null;
+    /** `open` while work remains; `closed` when the milestone is completed. */
+    state?: 'open' | 'closed';
+    /** ISO date/time or pre-formatted string; rendered verbatim. */
+    dueAt?: string | null;
+    /** Number of tracking items assigned to this milestone that are done/closed. */
+    closedCount?: number;
+    /** Total number of tracking items assigned to this milestone. */
+    totalCount?: number;
+}
+/** A surface-level delta between baseline and current encoding benchmarks. */
+export interface ComparisonDelta {
+    surface: string;
+    encoder: string;
+    bytesDelta?: number;
+    tokensDelta?: number;
+    latencyDelta?: number;
+    fidelity: 'pass' | 'fail';
+    comprehension?: number;
+}
+/** Data contract for Forge ComparisonCard (F11 contract). */
+export interface ComparisonCardData {
+    suite: string;
+    profile: string;
+    baselineRef?: {
+        kind: string;
+        ref: string;
+        establishedBy?: string;
+    };
+    currentRunIds: string[];
+    deltas: ComparisonDelta[];
+    verdict: 'advisory' | 'fail' | 'pass';
+    links: {
+        runs?: string[];
+        compareUrl?: string;
+    };
+}
+//# sourceMappingURL=presentation.d.ts.map

package/dist/presentation.d.ts.map

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

package/dist/presentation.js

@@ -0,0 +1,10 @@
+/**
+ * Light presentational prop types for forge UI shells.
+ *
+ * These are minimal data-in shapes for the (purely presentational) components
+ * in this package. They are deliberately decoupled from the app tracking schema
+ * (`TrackingItem`/`TrackingComment` etc.) — a host route maps its rows onto
+ * these shapes before rendering. Keep them small and additive.
+ */
+export {};
+//# sourceMappingURL=presentation.js.map

package/dist/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/pull-request/index.d.ts

@@ -0,0 +1,4 @@
+export * from './pull-request.descriptor.ts';
+export * from './pull-request.ts';
+export { createForgePullRequestsForRequest } from './request-client.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/pull-request/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pull-request/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/pull-request/index.js

@@ -0,0 +1,4 @@
+export * from "./pull-request.descriptor.js";
+export * from "./pull-request.js";
+export { createForgePullRequestsForRequest } from "./request-client.js";
+//# sourceMappingURL=index.js.map

package/dist/pull-request/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/pull-request/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,iCAAiC,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/pull-request/pull-request.d.ts

@@ -0,0 +1,35 @@
+import type { RuntimeRef } from '@vibesdotdev/kernel';
+import type { RuntimeKindDescriptor, KindContext } from '@vibesdotdev/kernel/schemas/kind';
+import type { RepositoryBranchPolicy, RepositoryBranchPolicyUpsert } from '@vibesdotdev/git-operations/repository/schemas';
+import type { PrCloseInput, PrCloseOutput, PrCreateInput, PrCreateOutput, PrFilesInput, PrFilesOutput, PrGetInput, PrGetOutput, PrListInput, PrListOutput, PrMergeInput, PrMergeOutput, PrMergeStatusInput, PrMergeStatusOutput, PrReopenInput, PrReopenOutput, PrReviewCommentInput, PrReviewCommentOutput, PrSearchInput, PrSearchOutput, PrUpdateInput, PrUpdateOutput, PrAutoMergeEnableInput, PrAutoMergeGetInput, PrAutoMergeIntentOutput } from '../schemas/wire-contracts.ts';
+import { type ForgePullRequestDescriptor } from './pull-request.descriptor.ts';
+/** Complete cross-surface pull-request capability. Surfaces render; this owns behavior. */
+export interface ForgePullRequestInterface {
+    readonly descriptor: ForgePullRequestDescriptor;
+    listBranchPolicies(repositoryId: string): Promise<RepositoryBranchPolicy[]>;
+    listAutomationAgents(repositoryId: string): Promise<Array<{
+        id: string;
+        name: string;
+        canMerge: boolean;
+    }>>;
+    setBranchPolicy(repositoryId: string, input: RepositoryBranchPolicyUpsert): Promise<RepositoryBranchPolicy>;
+    setBranchAutomation(repositoryId: string, input: Pick<RepositoryBranchPolicyUpsert, 'branchPattern' | 'pullRequestChatAutomation'>): Promise<RepositoryBranchPolicy>;
+    list(input: PrListInput): Promise<PrListOutput>;
+    get(input: PrGetInput): Promise<PrGetOutput>;
+    search(input: PrSearchInput): Promise<PrSearchOutput>;
+    create(input: PrCreateInput): Promise<PrCreateOutput>;
+    update(input: PrUpdateInput): Promise<PrUpdateOutput>;
+    close(input: PrCloseInput): Promise<PrCloseOutput>;
+    reopen(input: PrReopenInput): Promise<PrReopenOutput>;
+    files(input: PrFilesInput): Promise<PrFilesOutput>;
+    review(input: PrReviewCommentInput): Promise<PrReviewCommentOutput>;
+    mergeStatus(input: PrMergeStatusInput): Promise<PrMergeStatusOutput>;
+    merge(input: PrMergeInput): Promise<PrMergeOutput>;
+    enableAutoMerge(input: PrAutoMergeEnableInput): Promise<PrAutoMergeIntentOutput>;
+    getAutoMerge(input: PrAutoMergeGetInput): Promise<PrAutoMergeIntentOutput>;
+    cancelAutoMerge(input: PrAutoMergeGetInput): Promise<PrAutoMergeIntentOutput>;
+}
+export declare const forgePullRequestKind: RuntimeKindDescriptor<ForgePullRequestDescriptor, ForgePullRequestInterface, KindContext>;
+/** The `forge/pull-request` implementation the runtime selects. */
+export declare function resolveForgePullRequests(runtime: Pick<RuntimeRef, 'query'>): Promise<ForgePullRequestInterface>;
+//# sourceMappingURL=pull-request.d.ts.map

package/dist/pull-request/pull-request.d.ts.map

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

package/dist/pull-request/pull-request.descriptor.d.ts

@@ -0,0 +1,52 @@
+import * as z from 'zod/v4';
+export declare const ForgePullRequestDescriptorSchema: z.ZodObject<{
+    id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    hardware: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    capabilityId: z.ZodOptional<z.ZodString>;
+    requiredContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    optionalContext: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    config: z.ZodOptional<z.ZodUnknown>;
+    retention: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        maxAgeDays: z.ZodOptional<z.ZodNumber>;
+        maxEntries: z.ZodOptional<z.ZodNumber>;
+        maxBytes: z.ZodOptional<z.ZodNumber>;
+        cascadeFrom: z.ZodOptional<z.ZodString>;
+        ageField: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+        enforcedBy: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    kind: z.ZodLiteral<"forge/pull-request">;
+    name: z.ZodDefault<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type ForgePullRequestDescriptor = z.infer<typeof ForgePullRequestDescriptorSchema>;
+export declare function createForgePullRequestDescriptor(options: Omit<Partial<ForgePullRequestDescriptor>, 'kind'> & {
+    id: string;
+}): ForgePullRequestDescriptor;
+export declare const forgePullRequestDescriptor: {
+    id: string;
+    kind: "forge/pull-request";
+    name: string;
+    priority: number;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    hardware?: string[] | undefined;
+    enabled?: boolean | undefined;
+    capabilityId?: string | undefined;
+    requiredContext?: string[] | undefined;
+    optionalContext?: string[] | undefined;
+    config?: unknown;
+    retention?: string | {
+        reason: string;
+        maxAgeDays?: number | undefined;
+        maxEntries?: number | undefined;
+        maxBytes?: number | undefined;
+        cascadeFrom?: string | undefined;
+        ageField?: string | undefined;
+        enforcedBy?: string | undefined;
+    } | undefined;
+};
+//# sourceMappingURL=pull-request.descriptor.d.ts.map

package/dist/pull-request/pull-request.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-request.descriptor.d.ts","sourceRoot":"","sources":["../../src/pull-request/pull-request.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAG5B,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;iBAI3C,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gCAAgC,CAAC,CAAC;AAE1F,wBAAgB,gCAAgC,CAC/C,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,0BAA0B,CAAC,EAAE,MAAM,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GACzE,0BAA0B,CAE5B;AAED,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;CAKrC,CAAC"}

package/dist/pull-request/pull-request.descriptor.js

@@ -0,0 +1,17 @@
+import * as z from 'zod/v4';
+import { RuntimeDescriptorSchema } from '@vibesdotdev/kernel/schemas/descriptor';
+export const ForgePullRequestDescriptorSchema = RuntimeDescriptorSchema.extend({
+    kind: z.literal('forge/pull-request'),
+    name: z.string().default('Forge Pull Requests'),
+    priority: z.number().int().default(100)
+});
+export function createForgePullRequestDescriptor(options) {
+    return ForgePullRequestDescriptorSchema.parse({ ...options, kind: 'forge/pull-request' });
+}
+export const forgePullRequestDescriptor = createForgePullRequestDescriptor({
+    id: 'forge-pull-request',
+    name: 'Forge Pull Requests',
+    description: 'Provider-neutral pull-request lifecycle, review, diff, merge-policy, merge, and durable exact-head auto-merge intent capability.',
+    priority: 100
+});
+//# sourceMappingURL=pull-request.descriptor.js.map

package/dist/pull-request/pull-request.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-request.descriptor.js","sourceRoot":"","sources":["../../src/pull-request/pull-request.descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AAEjF,MAAM,CAAC,MAAM,gCAAgC,GAAG,uBAAuB,CAAC,MAAM,CAAC;IAC9E,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,qBAAqB,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC;CACvC,CAAC,CAAC;AAIH,MAAM,UAAU,gCAAgC,CAC/C,OAA2E;IAE3E,OAAO,gCAAgC,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,CAAC,MAAM,0BAA0B,GAAG,gCAAgC,CAAC;IAC1E,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,qBAAqB;IAC3B,WAAW,EAAE,kIAAkI;IAC/I,QAAQ,EAAE,GAAG;CACb,CAAC,CAAC"}

package/dist/pull-request/pull-request.impl.d.ts

@@ -0,0 +1,38 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { type RepositoryBranchPolicy, type RepositoryBranchPolicyUpsert } from '@vibesdotdev/git-operations/repository/schemas';
+import type { ForgeApiClientInterface } from '../forge.api-client.ts';
+import type { PrCloseInput, PrCloseOutput, PrCreateInput, PrCreateOutput, PrFilesInput, PrFilesOutput, PrGetInput, PrGetOutput, PrListInput, PrListOutput, PrMergeInput, PrMergeOutput, PrMergeStatusInput, PrMergeStatusOutput, PrReopenInput, PrReopenOutput, PrReviewCommentInput, PrReviewCommentOutput, PrSearchInput, PrSearchOutput, PrUpdateInput, PrUpdateOutput, PrAutoMergeEnableInput, PrAutoMergeGetInput, PrAutoMergeIntentOutput } from '../schemas/wire-contracts.ts';
+import type { ForgePullRequestDescriptor } from './pull-request.descriptor.ts';
+import type { ForgePullRequestInterface } from './pull-request.ts';
+export declare class DefaultForgePullRequests implements ForgePullRequestInterface {
+    readonly descriptor: ForgePullRequestDescriptor;
+    private readonly runtime;
+    constructor(descriptor: ForgePullRequestDescriptor, runtime: RuntimeRef | ForgeApiClientInterface);
+    private api;
+    listBranchPolicies(repositoryId: string): Promise<RepositoryBranchPolicy[]>;
+    listAutomationAgents(repositoryId: string): Promise<Array<{
+        id: string;
+        name: string;
+        canMerge: boolean;
+    }>>;
+    setBranchPolicy(repositoryId: string, input: RepositoryBranchPolicyUpsert): Promise<RepositoryBranchPolicy>;
+    setBranchAutomation(repositoryId: string, input: Pick<RepositoryBranchPolicyUpsert, 'branchPattern' | 'pullRequestChatAutomation'>): Promise<RepositoryBranchPolicy>;
+    private repo;
+    private parse;
+    private request;
+    list(input: PrListInput): Promise<PrListOutput>;
+    get(input: PrGetInput): Promise<PrGetOutput>;
+    search(input: PrSearchInput): Promise<PrSearchOutput>;
+    create(input: PrCreateInput): Promise<PrCreateOutput>;
+    update(input: PrUpdateInput): Promise<PrUpdateOutput>;
+    close(input: PrCloseInput): Promise<PrCloseOutput>;
+    reopen(input: PrReopenInput): Promise<PrReopenOutput>;
+    files(input: PrFilesInput): Promise<PrFilesOutput>;
+    review(input: PrReviewCommentInput): Promise<PrReviewCommentOutput>;
+    mergeStatus(input: PrMergeStatusInput): Promise<PrMergeStatusOutput>;
+    merge(input: PrMergeInput): Promise<PrMergeOutput>;
+    enableAutoMerge(input: PrAutoMergeEnableInput): Promise<PrAutoMergeIntentOutput>;
+    getAutoMerge(input: PrAutoMergeGetInput): Promise<PrAutoMergeIntentOutput>;
+    cancelAutoMerge(input: PrAutoMergeGetInput): Promise<PrAutoMergeIntentOutput>;
+}
+//# sourceMappingURL=pull-request.impl.d.ts.map