@loopover/engine 1.0.0

package/dist/types/predicted-gate-types.d.ts

@@ -0,0 +1,338 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type RegistryRepoConfig = {
+    repo: string;
+    emissionShare: number;
+    issueDiscoveryShare: number;
+    labelMultipliers: Record<string, number>;
+    trustedLabelPipeline?: boolean | null;
+    maintainerCut: number;
+    defaultLabelMultiplier?: number | null;
+    fixedBaseScore?: number | null;
+    eligibilityMode?: string | null;
+    raw: Record<string, JsonValue>;
+};
+export type AdvisoryConclusion = "success" | "neutral" | "action_required";
+export type AdvisorySeverity = "info" | "warning" | "critical";
+export type AdvisoryFinding = {
+    code: string;
+    title: string;
+    severity: AdvisorySeverity;
+    detail: string;
+    action?: string;
+    publicText?: string;
+    confidence?: number;
+};
+export type Advisory = {
+    id: string;
+    targetType: "repository" | "pull_request" | "issue";
+    targetKey: string;
+    repoFullName: string;
+    pullNumber?: number;
+    issueNumber?: number;
+    headSha?: string;
+    conclusion: AdvisoryConclusion;
+    severity: AdvisorySeverity;
+    title: string;
+    summary: string;
+    findings: AdvisoryFinding[];
+    generatedAt: string;
+};
+export type RepositoryRecord = {
+    fullName: string;
+    owner: string;
+    name: string;
+    installationId?: number | null | undefined;
+    isInstalled: boolean;
+    isRegistered: boolean;
+    isPrivate: boolean;
+    htmlUrl?: string | null | undefined;
+    defaultBranch?: string | null | undefined;
+    registryConfig?: RegistryRepoConfig | null | undefined;
+};
+export type PullRequestRecord = {
+    repoFullName: string;
+    number: number;
+    title: string;
+    state: string;
+    authorLogin?: string | null | undefined;
+    authorAssociation?: string | null | undefined;
+    headSha?: string | null | undefined;
+    headRef?: string | null | undefined;
+    baseRef?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    mergedAt?: string | null | undefined;
+    isDraft?: boolean | null | undefined;
+    mergeableState?: string | null | undefined;
+    reviewDecision?: string | null | undefined;
+    body?: string | null | undefined;
+    createdAt?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    closedAt?: string | null | undefined;
+    linkedIssueClaimedAt?: string | null | undefined;
+    labels: string[];
+    linkedIssues: number[];
+    slopRisk?: number | null | undefined;
+    slopBand?: string | null | undefined;
+    mergeAttemptCount?: number | null | undefined;
+    mergeBlockedSha?: string | null | undefined;
+    mergeBlockedReason?: string | null | undefined;
+    approvedHeadSha?: string | null | undefined;
+    lastRegatedAt?: string | null | undefined;
+    lastPublishedSurfaceSha?: string | null | undefined;
+    changedFiles?: string[] | undefined;
+};
+export type IssueRecord = {
+    repoFullName: string;
+    number: number;
+    title: string;
+    state: string;
+    authorLogin?: string | null | undefined;
+    authorAssociation?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    body?: string | null | undefined;
+    createdAt?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    closedAt?: string | null | undefined;
+    labels: string[];
+    linkedPrs: number[];
+};
+export type BountyRecord = {
+    id: string;
+    repoFullName: string;
+    issueNumber: number;
+    status: string;
+    amountText?: string | null | undefined;
+    sourceUrl?: string | null | undefined;
+    payload: Record<string, JsonValue>;
+    discoveredAt?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+};
+export type GateRuleMode = "off" | "advisory" | "block";
+export type GatePolicyPack = "gittensor" | "oss-anti-slop";
+export type RepositorySettings = {
+    repoFullName: string;
+    hardGuardrailGlobs?: string[] | null | undefined;
+};
+export type RecentMergedPullRequestRecord = {
+    repoFullName: string;
+    number: number;
+    title: string;
+    authorLogin?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    labels: string[];
+    linkedIssues: number[];
+    changedFiles?: string[] | undefined;
+};
+export type ParticipationLane = "direct_pr" | "issue_discovery" | "split" | "inactive" | "unknown";
+export type SignalFinding = AdvisoryFinding;
+export type LaneAdvice = {
+    lane: ParticipationLane;
+    repoFullName: string;
+    issueDiscoveryShare?: number | undefined;
+    directPrShare?: number | undefined;
+    summary: string;
+    contributorGuidance: string;
+    maintainerGuidance: string;
+};
+export type CollisionItem = {
+    type: "issue" | "pull_request" | "recent_merged_pull_request";
+    number: number;
+    title: string;
+    authorLogin?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    labels?: string[] | undefined;
+    linkedIssues?: number[] | undefined;
+    linkedIssueClaimedAt?: string | null | undefined;
+    changedFiles?: string[] | undefined;
+    body?: string | null | undefined;
+};
+export type CollisionCluster = {
+    id: string;
+    risk: "low" | "medium" | "high";
+    reason: string;
+    items: CollisionItem[];
+};
+export type CollisionReport = {
+    repoFullName: string;
+    generatedAt: string;
+    summary: {
+        clusterCount: number;
+        highRiskCount: number;
+        itemsReviewed: number;
+    };
+    clusters: CollisionCluster[];
+};
+export type QueueHealth = {
+    repoFullName: string;
+    generatedAt: string;
+    burdenScore: number;
+    level: "low" | "medium" | "high" | "critical";
+    summary: string;
+    signals: {
+        openIssues: number;
+        openPullRequests: number;
+        unlinkedPullRequests: number;
+        stalePullRequests: number;
+        draftPullRequests: number;
+        maintainerAuthoredPullRequests: number;
+        collisionClusters: number;
+        ageBuckets: {
+            under7Days: number;
+            days7To30: number;
+            over30Days: number;
+        };
+        likelyReviewablePullRequests: number;
+        cachedOpenPullRequests?: number | undefined;
+        likelyReviewablePullRequestsSource?: "cache" | "sampled_cache" | "authoritative" | undefined;
+    };
+    findings: AdvisoryFinding[];
+};
+export type QueueSignalCounts = {
+    openIssues?: number | undefined;
+    openPullRequests?: number | undefined;
+    likelyReviewablePullRequests?: number | undefined;
+};
+export type PreflightInput = {
+    repoFullName: string;
+    contributorLogin?: string | undefined;
+    title: string;
+    body?: string | undefined;
+    labels?: string[] | undefined;
+    changedFiles?: string[] | undefined;
+    linkedIssues?: number[] | undefined;
+    tests?: string[] | undefined;
+    authorAssociation?: string | undefined;
+};
+export type PreflightResult = {
+    repoFullName: string;
+    generatedAt: string;
+    status: "ready" | "needs_work" | "hold";
+    lane: LaneAdvice;
+    reviewBurden: "low" | "medium" | "high";
+    linkedIssues: number[];
+    findings: SignalFinding[];
+    collisions: CollisionCluster[];
+};
+export type PublicReadinessScore = {
+    total: number;
+    components: Array<{
+        key: "traceability" | "related_work" | "change_scope" | "validation" | "pr_state" | "queue_pressure";
+        label: string;
+        score: number;
+        max: number;
+        evidence: string;
+        action: string;
+    }>;
+};
+export type IssueQualityReport = {
+    repoFullName: string;
+    generatedAt: string;
+    lane: LaneAdvice;
+    issues: Array<{
+        number: number;
+        title: string;
+        status: "ready" | "needs_proof" | "hold" | "do_not_use";
+        score: number;
+        reasons: string[];
+        warnings: string[];
+    }>;
+    summary: string;
+};
+export type BountyLifecycle = "active" | "historical" | "completed" | "cancelled" | "stale" | "ambiguous" | "unknown";
+export type FocusManifestSource = "repo_file" | "api_record" | "none";
+export type FocusManifestLinkedIssuePolicy = "required" | "preferred" | "optional";
+export type FocusManifestIssueDiscoveryPolicy = "encouraged" | "neutral" | "discouraged";
+export type ReviewCheckMode = "required" | "visible" | "disabled";
+export type CombineStrategy = "single" | "consensus" | "synthesis";
+export type OnMerge = "either" | "both";
+export type FocusManifestGateConfig = {
+    present: boolean;
+    enabled: boolean | null;
+    checkMode: ReviewCheckMode | null;
+    pack: GatePolicyPack | null;
+    linkedIssue: GateRuleMode | null;
+    duplicates: GateRuleMode | null;
+    readinessMode: GateRuleMode | null;
+    readinessMinScore: number | null;
+    slopMode: GateRuleMode | null;
+    slopMinScore: number | null;
+    slopAiAdvisory: boolean | null;
+    sizeMode: GateRuleMode | null;
+    lockfileIntegrityMode: GateRuleMode | null;
+    aiReviewMode: GateRuleMode | null;
+    aiReviewByok: boolean | null;
+    aiReviewProvider: "anthropic" | "openai" | null;
+    aiReviewModel: string | null;
+    aiReviewAllAuthors: boolean | null;
+    aiReviewCloseConfidence: number | null;
+    aiReviewCombine: CombineStrategy | null;
+    aiReviewOnMerge: OnMerge | null;
+    aiReviewReviewers: ReadonlyArray<{
+        model: string;
+        fallback?: string | null | undefined;
+    }> | null;
+    mergeReadiness: GateRuleMode | null;
+    manifestPolicy: GateRuleMode | null;
+    selfAuthoredLinkedIssue: GateRuleMode | null;
+    dryRun: boolean | null;
+    firstTimeContributorGrace: boolean | null;
+    premergeContentRecheck: boolean | null;
+    requireFreshRebaseWindowMinutes: number | null;
+    claMode: GateRuleMode | null;
+    claConsentPhrase: string | null;
+    claCheckRunName: string | null;
+    claCheckRunAppSlug: string | null;
+    expectedCiContexts: ReadonlyArray<string> | null;
+};
+export type PreMergeCheck = {
+    name: string;
+    whenPaths: string[];
+    titleContains: string | null;
+    descriptionContains: string | null;
+    requireLabel: string | null;
+    enforce: boolean;
+};
+export type FocusManifestReviewConfig = {
+    present: boolean;
+    preMergeChecks: PreMergeCheck[];
+};
+export type FocusManifestSettings = {
+    hardGuardrailGlobs?: string[] | null | undefined;
+};
+export type FocusManifest = {
+    present: boolean;
+    source: FocusManifestSource;
+    wantedPaths: string[];
+    preferredLabels: string[];
+    linkedIssuePolicy: FocusManifestLinkedIssuePolicy;
+    testExpectations: string[];
+    issueDiscoveryPolicy: FocusManifestIssueDiscoveryPolicy;
+    maintainerNotes: string[];
+    publicNotes: string[];
+    gate: FocusManifestGateConfig;
+    settings: FocusManifestSettings;
+    review: FocusManifestReviewConfig;
+    warnings: string[];
+};
+export type FocusManifestFinding = {
+    code: "manifest_off_focus" | "manifest_preferred_path" | "manifest_missing_preferred_label" | "manifest_linked_issue_required" | "manifest_linked_issue_preferred" | "manifest_missing_tests" | "manifest_issue_discovery_discouraged" | "manifest_malformed";
+    severity: "info" | "warning" | "critical";
+    title: string;
+    detail: string;
+    action?: string | undefined;
+};
+export type FocusManifestGuidance = {
+    present: boolean;
+    source: FocusManifestSource;
+    linkedIssuePolicy: FocusManifestLinkedIssuePolicy;
+    issueDiscoveryPolicy: FocusManifestIssueDiscoveryPolicy;
+    matchedWantedPaths: string[];
+    preferredLabelHits: string[];
+    findings: FocusManifestFinding[];
+    publicNextSteps: string[];
+    warnings: string[];
+    summary: string;
+};

package/dist/types/predicted-gate-types.js

@@ -0,0 +1,3 @@
+// Local mirrors from src/types.ts, src/signals/engine.ts, and src/signals/focus-manifest.ts.
+// Keep in sync by hand — the engine package cannot import across into src/.
+export {};

package/dist/types/reward-risk-types.d.ts

@@ -0,0 +1,319 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export type ParticipationLane = "direct_pr" | "issue_discovery" | "split" | "inactive" | "unknown";
+export type ContributorRole = "outside_contributor" | "repo_maintainer" | "org_member" | "collaborator" | "owner" | "unknown";
+export type AdvisorySeverity = "info" | "warning" | "critical";
+export type AdvisoryFinding = {
+    code: string;
+    title: string;
+    severity: AdvisorySeverity;
+    detail: string;
+    action?: string;
+    publicText?: string;
+    confidence?: number;
+};
+export type SignalFinding = AdvisoryFinding;
+export type RepoTimeDecayOverrides = {
+    gracePeriodHours?: number | null | undefined;
+    sigmoidMidpointDays?: number | null | undefined;
+    sigmoidSteepness?: number | null | undefined;
+    minMultiplier?: number | null | undefined;
+};
+export type RegistryRepoConfig = {
+    repo: string;
+    emissionShare: number;
+    issueDiscoveryShare: number;
+    labelMultipliers: Record<string, number>;
+    trustedLabelPipeline?: boolean | null;
+    maintainerCut: number;
+    defaultLabelMultiplier?: number | null;
+    fixedBaseScore?: number | null;
+    eligibilityMode?: string | null;
+    timeDecay?: RepoTimeDecayOverrides | null;
+    raw: Record<string, JsonValue>;
+};
+export type RepositoryRecord = {
+    fullName: string;
+    owner: string;
+    name: string;
+    installationId?: number | null | undefined;
+    isInstalled: boolean;
+    isRegistered: boolean;
+    isPrivate: boolean;
+    htmlUrl?: string | null | undefined;
+    defaultBranch?: string | null | undefined;
+    registryConfig?: RegistryRepoConfig | null | undefined;
+};
+export type PullRequestRecord = {
+    repoFullName: string;
+    number: number;
+    title: string;
+    state: string;
+    authorLogin?: string | null | undefined;
+    authorAssociation?: string | null | undefined;
+    headSha?: string | null | undefined;
+    headRef?: string | null | undefined;
+    baseRef?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    mergedAt?: string | null | undefined;
+    isDraft?: boolean | null | undefined;
+    mergeableState?: string | null | undefined;
+    reviewDecision?: string | null | undefined;
+    body?: string | null | undefined;
+    createdAt?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    closedAt?: string | null | undefined;
+    linkedIssueClaimedAt?: string | null | undefined;
+    labels: string[];
+    linkedIssues: number[];
+    slopRisk?: number | null | undefined;
+    slopBand?: string | null | undefined;
+    mergeAttemptCount?: number | null | undefined;
+    mergeBlockedSha?: string | null | undefined;
+    mergeBlockedReason?: string | null | undefined;
+    approvedHeadSha?: string | null | undefined;
+    lastRegatedAt?: string | null | undefined;
+    lastPublishedSurfaceSha?: string | null | undefined;
+    changedFiles?: string[] | undefined;
+};
+export type IssueRecord = {
+    repoFullName: string;
+    number: number;
+    title: string;
+    state: string;
+    authorLogin?: string | null | undefined;
+    authorAssociation?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    body?: string | null | undefined;
+    createdAt?: string | null | undefined;
+    updatedAt?: string | null | undefined;
+    closedAt?: string | null | undefined;
+    labels: string[];
+    linkedPrs: number[];
+};
+export type RecentMergedPullRequestRecord = {
+    repoFullName: string;
+    number: number;
+    title: string;
+    authorLogin?: string | null | undefined;
+    htmlUrl?: string | null | undefined;
+    mergedAt?: string | null | undefined;
+    labels: string[];
+    linkedIssues: number[];
+    changedFiles: string[];
+    payload: Record<string, JsonValue>;
+};
+export type PullRequestFileRecord = {
+    repoFullName: string;
+    pullNumber: number;
+    path: string;
+    status?: string | null | undefined;
+    additions: number;
+    deletions: number;
+    changes: number;
+    previousFilename?: string | null | undefined;
+    payload: Record<string, JsonValue>;
+};
+export type PullRequestReviewRecord = {
+    id: string;
+    repoFullName: string;
+    pullNumber: number;
+    reviewerLogin?: string | null | undefined;
+    state: string;
+    authorAssociation?: string | null | undefined;
+    submittedAt?: string | null | undefined;
+    payload: Record<string, JsonValue>;
+};
+export type CheckSummaryRecord = {
+    id: string;
+    repoFullName: string;
+    pullNumber?: number | null | undefined;
+    headSha?: string | null | undefined;
+    name: string;
+    status: string;
+    conclusion?: string | null | undefined;
+    startedAt?: string | null | undefined;
+    completedAt?: string | null | undefined;
+    detailsUrl?: string | null | undefined;
+    payload: Record<string, JsonValue>;
+};
+export type ScoringModelSnapshotRecord = {
+    id: string;
+    sourceKind: "raw-github" | "api" | "fallback" | "test";
+    sourceUrl: string;
+    fetchedAt: string;
+    activeModel: "current_density_model" | "pending_saturation_model" | "exponential_saturation_model" | "unknown";
+    constants: Record<string, number>;
+    programmingLanguages: Record<string, JsonValue>;
+    registrySnapshotId?: string | null | undefined;
+    warnings: string[];
+    payload: Record<string, JsonValue>;
+};
+export type PublicContributorProfile = {
+    login: string;
+    topLanguages: string[];
+    source: "github" | "unavailable";
+};
+export type ContributorProfile = {
+    login: string;
+    generatedAt: string;
+    github: PublicContributorProfile;
+    source: "gittensor_api" | "github_cache";
+    registeredRepoActivity: {
+        pullRequests: number;
+        mergedPullRequests: number;
+        issues: number;
+        reposTouched: string[];
+        dominantLabels: string[];
+    };
+    trustSignals: {
+        evidenceScore: number;
+        level: "new" | "emerging" | "established";
+        unlinkedOpenPullRequests: number;
+        maintainerAssociatedPullRequests: number;
+    };
+};
+export type ContributorScoringProfile = {
+    evidence: {
+        credibilityAssumption: number;
+    };
+};
+export type ContributorFit = {
+    profile: ContributorProfile;
+    languageFit: Array<{
+        repoFullName: string;
+        language?: string | null | undefined;
+        match: boolean;
+    }>;
+    opportunities: Array<{
+        repoFullName: string;
+    }>;
+};
+export type OutcomePattern = {
+    repoFullName?: string | undefined;
+    title: string;
+    detail: string;
+    confidence: "high" | "medium" | "low";
+};
+export type ContributorOutcomeHistory = {
+    login: string;
+    generatedAt: string;
+    source: ContributorProfile["source"];
+    totals: {
+        pullRequests: number;
+        mergedPullRequests: number;
+        openPullRequests: number;
+        closedPullRequests: number;
+        closedPullRequestRate: number;
+        issues: number;
+        openIssues: number;
+        closedIssues: number;
+        solvedIssues: number;
+        validSolvedIssues: number;
+        credibility: number;
+        issueCredibility: number;
+    };
+    repoOutcomes: Array<{
+        repoFullName: string;
+        role: ContributorRole;
+        lane: ParticipationLane;
+        maintainerLane: boolean;
+        pullRequests: number;
+        mergedPullRequests: number;
+        openPullRequests: number;
+        closedPullRequests: number;
+        closedPullRequestRate: number;
+        issues: number;
+        openIssues: number;
+        closedIssues: number;
+        solvedIssues: number;
+        validSolvedIssues: number;
+        credibility: number;
+        issueCredibility: number;
+        isEligible: boolean;
+        successLevel: "strong" | "emerging" | "weak" | "maintainer_context";
+        strengths: string[];
+        risks: string[];
+    }>;
+    successPatterns: OutcomePattern[];
+    failurePatterns: OutcomePattern[];
+    summary: string;
+};
+export type CollisionItem = {
+    type: "issue" | "pull_request" | "recent_merged_pull_request";
+    number: number;
+    title: string;
+};
+export type CollisionCluster = {
+    id: string;
+    risk: "low" | "medium" | "high";
+    reason: string;
+    items: CollisionItem[];
+};
+export type CollisionReport = {
+    repoFullName: string;
+    generatedAt: string;
+    summary: {
+        clusterCount: number;
+        highRiskCount: number;
+        itemsReviewed: number;
+    };
+    clusters: CollisionCluster[];
+};
+export type RoleContext = {
+    login: string;
+    repoFullName: string;
+    generatedAt: string;
+    role: ContributorRole;
+    maintainerLane: boolean;
+    normalContributorEvidenceAllowed: boolean;
+    source: "github_association" | "repo_owner_match" | "gittensor_api" | "cache" | "unknown";
+    association?: string | null | undefined;
+    reasons: string[];
+    guidance: string;
+};
+export type LaneAdvice = {
+    lane: ParticipationLane;
+    repoFullName: string;
+    issueDiscoveryShare?: number | undefined;
+    directPrShare?: number | undefined;
+    summary: string;
+    contributorGuidance: string;
+    maintainerGuidance: string;
+};
+export type QueueHealth = {
+    repoFullName: string;
+    generatedAt: string;
+    burdenScore: number;
+    level: "low" | "medium" | "high" | "critical";
+    summary: string;
+    signals: {
+        openIssues: number;
+        openPullRequests: number;
+        unlinkedPullRequests: number;
+        stalePullRequests: number;
+        draftPullRequests: number;
+        maintainerAuthoredPullRequests: number;
+        collisionClusters: number;
+        ageBuckets: {
+            under7Days: number;
+            days7To30: number;
+            over30Days: number;
+        };
+        likelyReviewablePullRequests: number;
+        cachedOpenPullRequests?: number | undefined;
+        likelyReviewablePullRequestsSource?: "cache" | "sampled_cache" | "authoritative" | undefined;
+    };
+    findings: SignalFinding[];
+    rankedPullRequests?: {
+        number: number;
+        title: string;
+        authorLogin: string;
+        recommendation: string;
+    }[];
+};
+export type RepoFitRecommendation = {
+    recommendation: "pursue" | "cleanup_first" | "maintainer_lane" | "avoid_for_now" | "unknown";
+};

package/dist/types/reward-risk-types.js

@@ -0,0 +1,11 @@
+// Local type mirrors for the reward-risk engine module (#2281).
+//
+// Mirrored by hand from `src/types.ts` and `src/signals/engine.ts` — the engine package cannot import
+// across into `src/`, so (as with `predicted-gate-types.ts`) these are kept in sync manually. Types that
+// only ever reach the injected `src`-side builders (see `RewardRiskEngineDeps` in `../reward-risk.ts`) or
+// `buildScorePreview` are subset mirrors carrying just the fields those consumers require: because the
+// omitted `src` fields are all optional, a subset stays mutually assignable to the full `src` type, and the
+// real runtime objects still flow through the injected builders untouched. Types that appear in this
+// module's PUBLIC return surface (`RoleContext`, `LaneAdvice`, `QueueHealth`) are full verbatim copies so
+// existing consumers can read every field.
+export {};

package/dist/utils/json.d.ts

@@ -0,0 +1 @@
+export declare function nowIso(): string;

package/dist/utils/json.js

@@ -0,0 +1,3 @@
+export function nowIso() {
+    return new Date().toISOString();
+}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** Published semver of `@loopover/engine`, derived from this package's own package.json. */
+export declare const ENGINE_VERSION: string;

package/dist/version.js

@@ -0,0 +1,3 @@
+import ownPackageJson from "../package.json" with { type: "json" };
+/** Published semver of `@loopover/engine`, derived from this package's own package.json. */
+export const ENGINE_VERSION = ownPackageJson.version;