@farmslot/protocol 0.25.0 → 0.27.0

package/dist/contracts/pr-rules.d.ts

@@ -0,0 +1,350 @@
+import type { MonitoredPRIdentity, PRExecutionProfile, PRMonitorPolicy, PRSourceAccount } from './pr-monitoring.js';
+import type { ReviewScope, ReviewSessionIntent, ReviewValidationDepth } from './runs.js';
+/** Uses the same Continue/Fresh and review-depth choices as manual review rounds. */
+export interface PRReviewOptions {
+    sessionIntent: ReviewSessionIntent;
+    scope: ReviewScope;
+    validationDepth: ReviewValidationDepth;
+    /** Wait for the compatible saved reviewer's slot, or allow a fresh session elsewhere. */
+    busySession?: 'wait' | 'fresh';
+}
+export declare const DEFAULT_PR_REVIEW_OPTIONS: Readonly<PRReviewOptions>;
+export type PRRuleField = 'repository' | 'author' | 'state' | 'draft' | 'base-branch' | 'head-branch' | 'labels' | 'changed-paths' | 'author-teams' | 'project-memberships' | {
+    projectId: string;
+    fieldId: string;
+    valueType: 'text' | 'number' | 'date' | 'single-select';
+};
+export type PRRuleValue = string | number | boolean | string[] | null;
+export type PRRulePredicate = {
+    kind: 'all' | 'any';
+    items: PRRulePredicate[];
+} | {
+    kind: 'not';
+    item: PRRulePredicate;
+} | {
+    kind: 'compare';
+    field: PRRuleField;
+    operator: 'equals' | 'one-of' | 'contains-any' | 'contains-all' | 'glob' | 'greater-than' | 'less-than' | 'is-set';
+    value: PRRuleValue;
+};
+export type PRRuleFact = {
+    state: 'known';
+    value: PRRuleValue;
+} | {
+    state: 'unknown';
+    reason: string;
+};
+/** Observed GitHub review state for one configured account; cannot authorize execution. */
+export interface PRReviewObservation {
+    observedAt: string;
+    headSha: string;
+    state: 'open' | 'closed' | 'merged';
+    draft: boolean;
+    decision: string | null;
+    reviewer: string;
+    requested: boolean;
+    review: {
+        state: string;
+        commit: string | null;
+        submittedAt: string | null;
+    } | null;
+}
+export interface PRRuleSubject {
+    pr: MonitoredPRIdentity;
+    headSha: string;
+    title: string;
+    observedAt: string;
+    /** Keyed with prRuleFieldKey; Project option IDs remain distinct from their display names. */
+    facts: Record<string, PRRuleFact>;
+    sourceReasons?: string[];
+    reviewObservation?: PRReviewObservation;
+    /** Supplemental display observations; not changes that authorize rule admission. */
+    reviewPolicyFacts?: {
+        approvalCount?: number;
+        providerReviewDecision?: string;
+        lastActivityAt?: string;
+    };
+}
+export interface PRRuleMatch {
+    state: 'match' | 'no-match' | 'unknown';
+    reasons: string[];
+}
+export type PRRuleSource = {
+    kind: 'repository';
+    repo: string;
+} | {
+    kind: 'github-project';
+    projectId: string;
+    label: string;
+    url?: string;
+    importedView?: PRImportedProjectView;
+};
+export type PRProjectFilterTerm = {
+    text: string;
+} & ({
+    kind: 'predicate';
+    predicate: PRRulePredicate;
+    manuallyMapped?: boolean;
+} | {
+    kind: 'constant';
+    value: boolean;
+} | {
+    kind: 'unmapped';
+    reason: string;
+});
+/** A reviewed snapshot of view filters. Later edits to the GitHub view require another import. */
+export interface PRImportedProjectView {
+    number: number;
+    name: string;
+    filter: string;
+    terms: PRProjectFilterTerm[];
+}
+export interface PRProjectField {
+    id: string;
+    name: string;
+    dataType: string;
+    options?: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+export interface PRProjectCatalog {
+    id: string;
+    title: string;
+    url: string;
+    fields: PRProjectField[];
+}
+export interface PRRepositoryReviewPolicy {
+    repo: string;
+    project?: string;
+    reviewProfile: string;
+    review?: PRReviewOptions;
+    execution?: PRExecutionProfile;
+    excludedLabels: string[];
+    approvalTarget?: number;
+    staleAfterDays?: number;
+}
+export interface PRTeamConfig {
+    name: string;
+    account: PRSourceAccount;
+    sources: PRRuleSource[];
+    predicate: PRRulePredicate;
+    repositories: PRRepositoryReviewPolicy[];
+    execution?: PRExecutionProfile;
+    review?: PRReviewOptions;
+    /** GitHub membership checks are limited to these explicit org/team slugs. */
+    githubTeams: string[];
+    /** Audience selection never grants gateway or repository access. */
+    notificationPrincipalIds: string[];
+}
+export interface PRTeamProfile {
+    id: string;
+    ownerId: string;
+    revision: number;
+    config: PRTeamConfig;
+    createdAt: string;
+    updatedAt: string;
+}
+export type PRRuleAction = {
+    kind: 'notify';
+} | {
+    kind: 'monitor';
+    policy: PRMonitorPolicy;
+    pollIntervalMs?: number;
+} | {
+    kind: 'review';
+    autoStart: boolean;
+    execution?: PRExecutionProfile;
+    review?: PRReviewOptions;
+};
+export interface PRTriggerRuleConfig {
+    name: string;
+    teamId: string;
+    predicate: PRRulePredicate;
+    actions: PRRuleAction[];
+    pollIntervalMs: number;
+    maxAdmissionsPerScan: number;
+    rereviewOnHeadChange: boolean;
+}
+export interface PRRuleSourceProgress {
+    id: string;
+    startedAt: string;
+    oldestObservationAt?: string;
+    completedAt?: string;
+    pages: number;
+    items: number;
+    pendingConnections: number;
+    requestsThisAttempt: number;
+    resumed: boolean;
+    nextAttemptAt?: string;
+}
+export interface PRRuleScanState {
+    sourceProgress?: PRRuleSourceProgress;
+    baselinePending: boolean;
+    /** Changed source/fact configuration needs a new baseline, while already-admitted work is revalidated. */
+    rebasePending?: boolean;
+    backfillRequested: boolean;
+    checkedAt?: string;
+    nextScanAt?: string;
+    error?: string;
+    admissionWarning?: string;
+    /** Baseline revisions prevent enabling/editing a rule from silently backfilling old matches. */
+    subjects: Record<string, {
+        revision: string;
+        matched: boolean;
+        admitted: boolean;
+        admittedActions?: Array<PRRuleAction['kind']>;
+        actionIds?: Partial<Record<'notify' | 'monitor', string>>;
+        deferredActions?: Array<PRRuleAction['kind']>;
+    }>;
+}
+/** Durable non-worker actions. Completed monitor enrollment never changes an existing policy. */
+export interface PRRuleActionRecord {
+    id: string;
+    kind: 'notify' | 'monitor';
+    requiresFreshValidation?: boolean;
+    nextValidationAt?: string;
+    ownerId: string;
+    ruleId: string;
+    ruleRevision: number;
+    ruleName: string;
+    teamId: string;
+    teamRevision: number;
+    teamName: string;
+    account: PRSourceAccount;
+    subject: PRRuleSubject;
+    sourceRevision: string;
+    reasons: string[];
+    project?: string;
+    monitorPolicy?: PRMonitorPolicy;
+    monitorPollIntervalMs?: number;
+    current: boolean;
+    status: 'pending' | 'applied' | 'withdrawn';
+    monitorId?: string;
+    error?: string;
+    acknowledgedBy: Record<string, string>;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Audience-filtered attention, independent of optional push delivery. */
+export interface PRRuleNotification {
+    id: string;
+    teamId: string;
+    pr: MonitoredPRIdentity;
+    headSha: string;
+    title: string;
+    teamName: string;
+    ruleName: string;
+    reasons: string[];
+    current: boolean;
+    createdAt: string;
+    acknowledgedAt?: string;
+}
+export interface PRTriggerRule {
+    id: string;
+    ownerId: string;
+    revision: number;
+    config: PRTriggerRuleConfig;
+    enabled: boolean;
+    createdAt: string;
+    updatedAt: string;
+    scan: PRRuleScanState;
+}
+export interface PRReviewRequest {
+    teamId: string;
+    pr: MonitoredPRIdentity;
+    idempotencyKey: string;
+    autoStart: boolean;
+    execution?: PRExecutionProfile;
+    review?: PRReviewOptions;
+    /** Display/audit references only; these never confer execution authority. */
+    source: {
+        client: string;
+        reference?: string;
+        requester?: string;
+    };
+}
+export interface PRReviewSubmission {
+    id: string;
+    ownerId: string;
+    revision: number;
+    request: PRReviewRequest;
+    intentId?: string;
+    /** Gateway-frozen execution boundary at submission, before provider reads. */
+    priorExecutionIds?: string[];
+    checkedAt?: string;
+    error?: string;
+    cancelledAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export type PRReviewContribution = {
+    reviewObservation?: PRReviewObservation;
+    teamId: string;
+    teamRevision: number;
+    ownerId: string;
+    reasons: string[];
+    project?: string;
+    execution?: PRExecutionProfile;
+    review?: PRReviewOptions;
+    autoStart: boolean;
+    eligible: boolean;
+    configurationErrors: string[];
+    acceptedAt?: string;
+    deferredAt?: string;
+} & ({
+    ruleId: string;
+    ruleRevision: number;
+    submissionId?: never;
+    submissionRevision?: never;
+} | {
+    submissionId: string;
+    submissionRevision: number;
+    ruleId?: never;
+    ruleRevision?: never;
+});
+export interface PRReviewIntent {
+    id: string;
+    /** Display metadata from discovery; absent on older saved intents. */
+    title?: string;
+    author?: string;
+    /** Explicit resubmission after execution starts creates another round for this head/profile. */
+    round?: number;
+    pr: MonitoredPRIdentity;
+    headSha: string;
+    reviewProfile: string;
+    status: 'held' | 'needs-configuration' | 'queued' | 'running' | 'completed' | 'failed' | 'withdrawn';
+    contributions: PRReviewContribution[];
+    createdAt: string;
+    updatedAt: string;
+    waitingReason?: string;
+    queueItemId?: string;
+    runId?: string;
+    reviewedSha?: string;
+    dispatchHold?: string;
+}
+export interface PRRulePreviewItem {
+    subject: PRRuleSubject;
+    match: PRRuleMatch;
+    project?: string;
+    reviewProfile: string;
+    execution?: PRExecutionProfile;
+    review?: PRReviewOptions;
+    configurationErrors: string[];
+    actionErrors?: Partial<Record<PRRuleAction['kind'], string[]>>;
+    /** Supplemental team policy observations; never merge authority. */
+    policySummary?: string[];
+}
+export interface PRRulePreview {
+    sourceProgress?: PRRuleSourceProgress;
+    teamId: string;
+    teamRevision: number;
+    ruleId: string;
+    ruleRevision: number;
+    checkedAt: string;
+    complete: boolean;
+    sourceErrors: string[];
+    ignoredItems: number;
+    items: PRRulePreviewItem[];
+}
+//# sourceMappingURL=pr-rules.d.ts.map

package/dist/contracts/pr-rules.d.ts.map

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

package/dist/contracts/pr-rules.js

@@ -0,0 +1,6 @@
+export const DEFAULT_PR_REVIEW_OPTIONS = {
+    sessionIntent: 'resume',
+    scope: 'incremental',
+    validationDepth: 'static-code',
+};
+//# sourceMappingURL=pr-rules.js.map

package/dist/contracts/pr-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-rules.js","sourceRoot":"","sources":["../../src/contracts/pr-rules.ts"],"names":[],"mappings":"AAiBA,MAAM,CAAC,MAAM,yBAAyB,GAA8B;IAClE,aAAa,EAAE,QAAQ;IACvB,KAAK,EAAE,aAAa;IACpB,eAAe,EAAE,aAAa;CAC/B,CAAC"}

package/dist/contracts/readiness.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Readiness record: what a harness did to make a checkout ready for a task and
+ * whether it succeeded. Farmslot defines the shape; a harness (mm-harness) fills
+ * the steps. Lives at `<artifacts dir>/sandbox.json` — the task's `artifacts/`
+ * for a skill run, the checkout runtime dir for a farm slot.
+ */
+export declare const READINESS_RECORD = "sandbox.json";
+export type ReadinessStepStatus = 'pass' | 'fail' | 'skipped';
+export interface ReadinessStep {
+    /** Stable step id, e.g. `doctor`, `status`, `launch`, `fixtures`, `verify`. */
+    id: string;
+    /** The exact command line the harness ran. */
+    command: string;
+    status: ReadinessStepStatus;
+    exitCode: number;
+    /** Report the step produced, relative to the record's directory, when it wrote one. */
+    reportPath?: string;
+    /** One-line reason for a fail or skip. */
+    reason?: string;
+}
+export interface ReadinessRecord {
+    schemaVersion: 1;
+    harness: {
+        name: string;
+        version: string;
+        /** How the executable was chosen: env override, task-local lock, PATH, … */
+        source: string;
+        executable: string;
+    };
+    platform: string;
+    mobilePlatform?: 'ios' | 'android';
+    steps: ReadinessStep[];
+    /** True when every non-skipped step passed. */
+    ready: boolean;
+    recordedAt: string;
+}
+//# sourceMappingURL=readiness.d.ts.map

package/dist/contracts/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/contracts/readiness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAE/C,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,EAAE,EAAE,MAAM,CAAC;IACX,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,4EAA4E;QAC5E,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;IACnC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,+CAA+C;IAC/C,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/contracts/readiness.js

@@ -0,0 +1,8 @@
+/**
+ * Readiness record: what a harness did to make a checkout ready for a task and
+ * whether it succeeded. Farmslot defines the shape; a harness (mm-harness) fills
+ * the steps. Lives at `<artifacts dir>/sandbox.json` — the task's `artifacts/`
+ * for a skill run, the checkout runtime dir for a farm slot.
+ */
+export const READINESS_RECORD = 'sandbox.json';
+//# sourceMappingURL=readiness.js.map

package/dist/contracts/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/contracts/readiness.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC"}

package/dist/contracts/reviews.d.ts

@@ -19,6 +19,7 @@ export type PRFamilyWorkflowState = 'active' | 'complete' | 'failed';
 export type PRFamilyMergeState = 'not_applicable' | 'waiting_for_merge' | 'merged' | 'closed_without_merge';
 export interface PRStatus {
     pr: number;
+    author?: string;
     title: string;
     summary: string | null;
     repo: string;

package/dist/contracts/reviews.d.ts.map

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

package/dist/contracts/reviews.js.map

@@ -1 +1 @@
-{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/contracts/reviews.ts"],"names":[],"mappings":"AA4HA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}
+{"version":3,"file":"reviews.js","sourceRoot":"","sources":["../../src/contracts/reviews.ts"],"names":[],"mappings":"AA6HA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,WAAW,CAAC"}

package/dist/contracts/runs.d.ts

@@ -1,6 +1,6 @@
 import type { ArtifactRef, SelfReviewIssue } from '../recipes/step-io.js';
 import type { WorkerSignalChecklistEvent, WorkerSignalChecklistTiming } from '../transport/signal.js';
-import type { AgentContext, AgentContextTarget, SafetyTier, ScriptedRunnerConfig } from './agents.js';
+import type { AgentContext, AgentContextTarget, RunnerSessionArchiveRef, SafetyTier, ScriptedRunnerConfig } from './agents.js';
 import type { FailureCategory, RunRecoveryProposalConfidence } from './chat.js';
 import type { TaskTemplateSelection, TemplateProvenance } from './evals.js';
 import type { EvidenceQualityReport, RecipeQualityArtifact } from './recipes.js';
@@ -93,6 +93,8 @@ export interface ReviewGatePayload {
     qualityReport?: EvidenceQualityReport | null;
     workerLearnings?: string;
 }
+/** Review evidence retained independently of the decision to publish it. */
+export type RunReviewResult = Pick<ReviewGatePayload, 'recommendation' | 'reviewMd' | 'lineComments' | 'reviewSnapshot' | 'artifactManifest' | 'reviewInputArtifactPaths'>;
 export type PublicationTarget = 'draft' | 'ready';
 export type PublicationStatus = 'not_published' | 'pending_publish' | 'published_draft' | 'published_ready' | 'publish_failed';
 export interface ReviewDepthPolicy {
@@ -126,7 +128,7 @@ export declare function reviewValidationDepthForLoop(_index: number, _total: num
 export type ReviewSessionIntent = 'resume' | 'reset';
 /** What actually happened when the reviewer generation launched. */
 export type ReviewSessionContinuity = 'fresh' | 'resumed' | 'fallback-fresh' | 'resume-unconfirmed';
-export type ReviewSessionFallbackReason = 'unsupported-runner' | 'slot-mismatch' | 'runner-mismatch' | 'missing-session' | 'session-unavailable';
+export type ReviewSessionFallbackReason = 'unsupported-runner' | 'slot-mismatch' | 'runner-mismatch' | 'model-mismatch' | 'missing-session' | 'session-unavailable';
 export interface ReviewSessionTrace {
     intent: ReviewSessionIntent;
     continuity: ReviewSessionContinuity;
@@ -926,6 +928,11 @@ export interface RunMetrics {
     runner: string | null;
     runnerSessionId?: string | null;
     runnerSessionPath?: string | null;
+    /**
+     * Recycle snapshot of the primary runner transcript. Pointer only; the bytes
+     * live under `.runs/session-archives/`. Not eval evidence and not a farmrun payload.
+     */
+    runnerSessionArchive?: RunnerSessionArchiveRef;
     /**
      * Operator-local provider subscription label that actually funded this run
      * (after any in-place failover). Label only — never an email, token, or home path.
@@ -1617,6 +1624,8 @@ export interface MachineParkRecord {
 }
 export interface Run {
     id: string;
+    prWork?: import('./pr-monitoring.js').PRWorkReference;
+    prPublications?: import('./pr-monitoring.js').PRPublicationRecord[];
     familyId: string;
     parentRunId?: string | null;
     familyRootTicketOrPr?: string;
@@ -1696,6 +1705,7 @@ export interface Run {
     mergedAt?: string | null;
     steps: RunStep[];
     decisions: RunDecision[];
+    reviewResult?: RunReviewResult;
     metrics: RunMetrics;
     createdAt: string;
     /** Timestamp when the supervised run lifecycle started. */
@@ -1894,6 +1904,8 @@ export interface RunCiWatchState {
     lastProgressReason?: string;
     /** Last watched-check status fingerprint used to detect progress. */
     lastCheckFingerprint?: string;
+    /** Last observed actionable feedback, retained so restart does not invent progress. */
+    lastActionableFingerprint?: string;
     /** Last observed local PR head SHA used to detect new commits. */
     lastHeadSha?: string | null;
     /** Consecutive-failure counter; resets on success. Gates consecutive fallback (MAX_INLINE_CI_FIX_ATTEMPTS). */
@@ -2101,11 +2113,15 @@ export declare const DEFAULT_TASK_DIR = ".task";
  * Changing this value alters defaults across the dispatch wizard and gateway
  * dispatch path — verify all `DEFAULT_CLAUDE_MODEL` callers when touching it. */
 export declare const DEFAULT_CLAUDE_MODEL = "opus";
-/** Default Codex model used when no slot/task/project/user override is set.
- * GPT-5.6 family uses tiered slugs (sol/terra/luna); Sol is the flagship. */
-export declare const DEFAULT_CODEX_MODEL = "gpt-5.6-sol";
+/** Default Codex model used when no slot/task/project/user override is set. */
+export declare const DEFAULT_CODEX_MODEL = "gpt-6-astra";
+/** Reasoning efforts exposed by the Codex CLI, including Astra's max and ultra. */
+export declare const CODEX_REASONING_EFFORTS: readonly ["low", "medium", "high", "xhigh", "max", "ultra"];
+export type CodexReasoningEffort = (typeof CODEX_REASONING_EFFORTS)[number];
+/** Model capabilities from the Codex CLI catalog. Unknown models keep the legacy levels. */
+export declare function codexReasoningEfforts(model?: string | null): readonly CodexReasoningEffort[];
 /** Default Codex reasoning effort when dispatch/launch omits effort. */
-export declare const DEFAULT_CODEX_EFFORT = "xhigh";
+export declare const DEFAULT_CODEX_EFFORT = "high";
 /** Default Cursor Agent model used when no slot/task/project/user override is set. */
 export declare const DEFAULT_CURSOR_MODEL = "cursor-grok-4.6-high-fast";
 /** Default Grok model used when no slot/task/project/user override is set. */