Esc
↑↓ to move↵ to openEsc to close

DocsConfiguration

Reference

Every rule kind, setting and default, generated from the schemas.

Generated from schemas

Rules (org_rules.schema.json)

Version: 5.4

How an organisation manages its code, as flat typed rules (kind + match + value). Orgs may write any number of rules, but the compiler always reduces them to the fixed column set in x-riffle-model-columns. Undeclared means null, never 0. Adding a column is a schema version bump, a retrain, and a decision record. Rules are read point-in-time from git history of the rules file, and the compiled hash is pinned into model_version. Read from the default branch only; an invalid file keeps the last valid compiled rules and posts a notice. Org file: riffle/rules.yml in the org's .github repo. Repo file: .github/riffle/rules.yml, appended after org rules and limited to that repo.

Fields every rule accepts

KeyAllowedDefaultFlagsMeaning
idstring matching ^[a-z0-9][a-z0-9-]{0,63}$Rule identifier
kindstringRule kind, which decides the other fields the rule accepts
applies_to.reposlist of string["*"]Repositories the rule applies to; * is every repo
applies_to.pathslist of stringLimit to a monorepo package, e.g. packages/react-native/**
applies_to.brancheslist of stringBranches the rule applies to
priorityinteger 0–10050Conflict resolution: higher wins, then the more specific glob, then the later rule.
enabledbooleantruefalse turns the rule off without removing it
notestringFree-text note about the rule

Rule kinds

path_tier

Sink: feature
Compiles to: max_criticality, frac_lines_in_critical

FieldAllowedDefaultRequiredMeaning
matchstringrequiredPath glob
valuelow, normal, elevated, criticalrequiredCriticality of the matching paths, low to critical, as 0-3 in max_criticality

path_class

Sink: feature | filter
Compiles to: effective_lines_changed, test_lines_ratio, docs_only, config_only

FieldAllowedDefaultRequiredMeaning
matchstringrequiredPath glob
valueexcluded, vendored, generated, lockfile, test, test_fixture, docs, config, build_config, dependency_manifest, i18nrequiredClass of the matching files

sensitivity

What the code handles. Split from change_signal so authn and authz stay distinct.

Sink: feature
Compiles to: n_sensitivity_tags

FieldAllowedDefaultRequiredMeaning
matchstringrequiredPath glob
valueauthn, authz, payments, pii, secrets, crypto, infra, public_apirequiredWhat the matching code handles

change_signal

Risky change types. Handled by the extractor's own path rules too; these declarations override its defaults per repo.

Sink: feature
Compiles to: sharpens extractor touches_* features; no new columns

FieldAllowedDefaultRequiredMeaning
matchstringrequiredPath glob
valueschema_migration, wire_protocol, infra_as_code, build_system, dependency_bump, feature_flag, concurrency, native_interop, release_configrequiredChange type the matching paths signal

component

Names a monorepo package or module. The name is free text, but the model only sees generic stats computed per component from history.

Sink: feature
Compiles to: n_components_touched, max_criticality, max_exposure, max_data_class, regulated_scope_count, log_max_blast_radius, touches_deprecated

FieldAllowedDefaultRequiredMeaning
matchstringrequirede.g. streams/** or packages/virtualized-lists/**
valuestring matching ^[a-z0-9][a-z0-9-]{0,63}$requiredComponent name
tierinteger 1–4Availability tier, 1 is most critical
exposureinternal, partner, externalWho the component is exposed to; max_exposure encodes internal 0, partner 1, external 2
data_classpublic, internal, confidential, restrictedClass of data the component holds; max_data_class encodes public 0 to restricted 3
regimeslist of pci, gdpr, hipaa, sox, soc2, fedrampCompliance regimes the component falls under, counted in regulated_scope_count
lifecycleexperimental, active, stable, deprecatedLifecycle stage; deprecated sets touches_deprecated
blast_radiusinteger 0–Declared downstream dependents

owner

Path ownership. import_codeowners reads CODEOWNERS instead of listing paths.

Sink: feature
Compiles to: author_is_owner, owning_teams_touched (extractor, not a declared column)

FieldAllowedDefaultRequiredMeaning
matchstringrequiredPath glob, or the CODEOWNERS path when import_codeowners is true
valuestringrequiredTeam or login, e.g. @apache/kafka-streams
import_codeownersbooleanfalseRead ownership from the CODEOWNERS file at match instead of listing paths

policy

Team policies checked against the diff. Each firing policy adds one to policy_violations; the specific policy is shown in the comment, not given its own column.

Sink: feature
Compiles to: policy_violations, required_tests_missing

FieldAllowedDefaultRequiredMeaning
matchstringrequiredPath glob the policy covers
valuerequired_tests, high_scrutiny, perf_critical, no_import_from, flag_required, migration_reversible, migration_no_destructive, dependency_allowlist, dependency_denylist, regen_pairrequiredPolicy to check against the diff
targetstring or list of stringno_import_from: forbidden path glob. dependency_*: package names. regen_pair: generated path glob.
testsstringrequired_tests: test glob that satisfies it; defaults to path_class test
languageslist of java, python, typescript, javascript, go, kotlinno_import_from only: languages to parse imports for. Others are skipped, and the feature is null for files in them

Phase notes: no_import_from v1 for listed languages via tree-sitter import queries; other languages later; flag_required later: heuristic on known flag SDK calls only

freeze_window

Declared code freeze. days_to_freeze_start is left to the extractor.

Sink: feature
Compiles to: in_freeze_window

FieldAllowedDefaultRequiredMeaning
startstring (date-time)requiredWhen the freeze starts
endstring (date-time)requiredWhen the freeze ends
matchstring"*"Branch glob

pr_label

Maps PR labels at open time. Different from issue_label, which is about linked issues.

Sink: feature
Compiles to: label_priority, label_is_hotfix, label_security

FieldAllowedDefaultRequiredMeaning
matchstringrequiredExact PR label name
valuepriority, hotfix, security, saferequiredWhat the label means; priority also needs level
levelinteger 0–3priority only: 3 is highest (P0)

safe_change

Which change kinds this team treats as safe. No match; the extractor classifies lines.

Sink: feature
Compiles to: is_safe_change_only

FieldAllowedDefaultRequiredMeaning
valuedocs, tests, formatting, comments, generated, i18nrequiredChange kind treated as safe

pattern

Sink: label | feature
Compiles to: task_type, is_backport, labels: revert, bugfix

FieldAllowedDefaultRequiredMeaning
matchstring (regex)requiredRegex matched against field
valuerevert, bugfix, hotfix, backport, conventional_type, security_fixrequiredWhat a match marks the change as
fieldcommit_message, commit_trailer, pr_title, pr_body, branch_name"commit_message"Text the regex is matched against

Connects objects Riffle would otherwise treat as unrelated. match must contain a named group (?<ref>...).

Sink: link
Compiles to: commit-PR-issue graph used by every label source; cherry picks dedupe labels across branches

FieldAllowedDefaultRequiredMeaning
matchstring (regex)requiredRegex with a named group (?<ref>...) that captures the reference
fieldcommit_message, commit_trailer, pr_title, pr_body"commit_trailer"Text the regex is matched against
valuepr_ref, revert_target, cherry_pick_source, issue_key, external_change_idrequiredWhat the captured reference points to
trackerstring matching ^[a-z0-9][a-z0-9-]{0,63}$For issue_key: which sources.trackers entry

identity

Recovers the real person when a bot lands the commit or email differs from login. match needs a named group (?<login>...) or (?<email>...).

Sink: feature
Compiles to: author_* features use the resolved author, reviewer_count, reviewer_path_experience

FieldAllowedDefaultRequiredMeaning
matchstring (regex)requiredRegex with a named group (?<login>...) or (?<email>...)
oncommit_trailer, commit_message, pr_body, co_authored_by"commit_trailer"Text the regex is matched against
valueauthor, co_author, reviewer, landerrequiredRole of the recovered person

merge_signal

What counts as merged. Needed when PRs are closed and the change lands another way.

Sink: label
Compiles to: merged_at, merge_commit_sha for every outcome window

FieldAllowedDefaultRequiredMeaning
valuegithub_merge, linked_commit_on_default, bot_close_with_commit, direct_pushrequiredHow a change counts as merged
matchstring"*"Actor login for bot_close_with_commit, else '*'

issue_field

Tracker fields beyond labels, e.g. Jira issuetype and priority.

Sink: label

FieldAllowedDefaultRequiredMeaning
trackerstring matching ^[a-z0-9][a-z0-9-]{0,63}$requiredsources.trackers entry
fieldstringrequirede.g. issuetype, priority, customfield_10020
matchstringrequiredField value to match
valuebug, incident, regression, security, not_a_bugrequiredWhat a matching issue counts as
severityinteger 1–41 is worst; scales label weight

issue_label

Sink: label

FieldAllowedDefaultRequiredMeaning
trackerstring matching ^[a-z0-9][a-z0-9-]{0,63}$"github"Tracker the issue label is read from
matchstringrequiredIssue label to match
valuebug, incident, regression, security, not_a_bugrequiredWhat a matching issue counts as
severityinteger 1–41 is worst; scales label weight

author_class

Sink: feature
Compiles to: agent_in_critical, author_is_maintainer, author_is_external, author_is_new (extractor)

FieldAllowedDefaultRequiredMeaning
matchstringrequiredValue to match in the field named by on
onlogin, email_domain, branch_prefix, commit_trailer"login"What match is compared with
valuebot, agent, maintainer, employee, externalrequiredClass given to matching authors
new_contributor_daysinteger 1–730Optional; overrides the default tenure cut for authors this rule matches

ci_check

Sink: feature | label
Compiles to: ci_required_failed, ci_failures_non_flaky, label: post_merge_ci

FieldAllowedDefaultRequiredMeaning
sourcestring matching ^[a-z0-9][a-z0-9-]{0,63}$sources.ci entry; default is GitHub checks
matchstringrequiredCheck name to match
valuerequired, flaky, informational, auxiliaryrequiredauxiliary (CodeQL, Scorecards, coverage) never triggers ci_fail
stagepre_merge, post_merge, nightly, release"pre_merge"When the check runs

test_class

Test-level flakiness from sources.test_reports, for repos with one giant CI check.

Sink: feature | label
Phase: later

FieldAllowedDefaultRequiredMeaning
matchstringrequiredTest id glob, e.g. org.apache.kafka.streams.integration.*
valueflaky, quarantined, slowrequiredClass given to matching tests

label_source

Weight of an outcome source as a sample weight in this org's per-repo layer. Never applied to the global model. Windows: revert 30d, ci_fail on required checks only, hotfix is a hotfix-labelled PR on the same lines within 7d, follow_up_fix is any PR on the same lines within 14d.

Sink: label

FieldAllowedDefaultRequiredMeaning
matchrevert, ci_fail, hotfix, szz, follow_up_fix, route_override, incident_link, external_importrequiredOutcome source the weight applies to
valuenumber 0–2requiredSample weight for this source in the org's per-repo layer, 0 to 2
window_daysinteger 1–90Window in days for this source, in place of its default

branch_class

Sink: feature | label
Compiles to: targets_release_branch

FieldAllowedDefaultRequiredMeaning
matchstringrequiredBranch glob
valuedefault, release, hotfix, backport, long_lived, experimentalrequiredClass of the matching branches; release and hotfix set targets_release_branch when they are the base branch

stack

Stacked PR tooling, so a stack is understood as related changes.

Sink: feature
Compiles to: stack_depth, stack_position

FieldAllowedDefaultRequiredMeaning
valueghstack, graphite, sapling, spr, branch_chainrequiredStacked PR tool
matchstringrequiredBranch pattern or body marker the tool leaves

sources block

KeyAllowedDefaultFlagsMeaning
sources.trackerslist of objectsIssue trackers, referenced by link and issue rules through their id.
sources.trackers[].idstring matching ^[a-z0-9][a-z0-9-]{0,63}$Tracker identifier, referenced by the tracker field of link, issue_field and issue_label rules
sources.trackers[].providergithub, jira, linear, bugzilla, youtrackTracker product
sources.trackers[].base_urlstring (uri)Base URL of the tracker
sources.trackers[].projectslist of stringTracker projects to read
sources.trackers[].credentials_refstringSecret reference for the tracker's credentials, never the value
sources.cilist of objectsCI systems beyond GitHub checks, referenced by ci_check rules through their id.
sources.ci[].idstring matching ^[a-z0-9][a-z0-9-]{0,63}$CI source identifier, referenced by the source field of ci_check rules
sources.ci[].providergithub_checks, commit_status, external_apicommit_status covers Jenkins, Buildkite and anything posting legacy statuses
sources.ci[].context_globstring"*"Glob over the check or status names read from this source
sources.ci[].credentials_refstringSecret reference for the CI system's credentials, never the value
sources.test_reports.enabledbooleanfalselaterRead test reports
sources.test_reports.formatjunit_xml"junit_xml"laterTest report file format
sources.test_reports.artifact_globstring"**/TEST-*.xml"laterGlob matching test report files
sources.outcome_import.enabledbooleanfalseAccept outcomes at POST /v1/outcomes
sources.outcome_import.secret_refstringSecret reference for the secret that signs POST /v1/outcomes requests, never the value

labels block

KeyAllowedDefaultFlagsMeaning
labels.targetunion, weighted"union"union: label_bad = any target source fires (binary). weighted: each source's label_source weight becomes a sample weight. Per-repo layer only
labels.szz_in_targetbooleanfalseSZZ stays a separate label unless true
labels.maturity_daysinteger 7–18030Rows younger than this are dropped before training (label_mature)
labels.szz_maturity_daysinteger 30–36590Days before an SZZ label is mature, used for SZZ instead of maturity_days
labels.unobservedmask, negative, downweight"downweight"What to do when a label source had no data for a mature PR (e.g. CI results expired). Any observed source that fired still makes the row positive. Otherwise: mask drops the row; negative counts it as fully clean; downweight counts it as clean with sample weight unobserved_weight
labels.unobserved_weightnumber 0.05–10.5downweight only. Multiplies the row's sample weight for each unobserved source (0.5 with one missing, 0.25 with two)
labels.target_sourceslist of revert, ci_fail, hotfix, szz, follow_up_fix, route_override, incident_link, external_import["revert", "ci_fail", "hotfix"]Sources that can make a row positive. Others still get mined and reported as ablations, but do not enter the target
labels.merge_outcome.enabledbooleantrueMine closed-unmerged PRs and the merge-outcome labels: label_merged, label_rework, label_duplicate, label_unwanted, label_abandoned, label_ci_technical, close_reason
labels.merge_outcome.rework_grace_secondsinteger 0–3600300Commits and force-pushes this soon after open are part of opening the PR, not rework. Also the cut for the at-open snapshot the features are computed from (docs/adr/0010-features-at-open.md)
labels.merge_outcome.abandon_daysinteger 14–36560A PR still open this many days after opening with no human non-author response counts as unmerged and abandoned
labels.merge_outcome.close_reason_classifierllm, rules"llm"llm: an LLM reads each unmerged PR's comments, reviews and labels up to close and picks close_reason, falling back to rules when the LLM is off or fails. Training data only, never the scoring path
labels.merge_outcome.stale_bot_loginslist of string["stale[bot]", "stale-bot", "stalebot"]unionA PR closed by one of these accounts is abandoned
labels.merge_outcome.unwanted_labelslist of string["wontfix", "won't fix", "invalid", "not planned", "out of scope", "declined", "rejected", "spam"]unionLabels present at close that mark the PR unwanted. Matched case-insensitively as substrings, so rejected AI counts

mining block

KeyAllowedDefaultFlagsMeaning
mining.similar_prs.kinteger 3–205Number of nearest past PRs similar_pr_bad_rate is computed over
mining.similar_prs.min_file_overlapnumber 0.05–10.2Jaccard over touched files
mining.similar_prs.lookback_daysinteger 30–1095365Days of past PRs searched for neighbours
mining.similar_prs.min_neighboursinteger 1–103Fewer than this and the feature is null
mining.scrutiny.lookback_daysinteger 30–1095180Days of prior PR reviews counted
mining.scrutiny.exclude_bot_reviewsbooleantrueLeave bot reviews out of revealed_path_scrutiny
mining.scrutiny.min_prior_prsinteger 1–505Fewer prior PRs than this and the feature is null
mining.failure_mode.lookback_daysinteger 90–1095365Days of past bad changes on the touched paths counted
mining.failure_mode.min_bad_changesinteger 1–202Fewer past bad changes than this and the features are null
mining.path_size.lookback_daysinteger 30–1095365Days of past changes to the same files compared against
mining.path_size.min_prior_changesinteger 3–10010Fewer past changes to the same files than this and the feature is null
mining.release_cycle.tag_patternstring (regex)"^v?\\d+\\.\\d+(\\.\\d+)?$"Which tags count as releases, e.g. ^\d+.\d+.0$ for minor releases only
mining.release_cycle.min_releasesinteger 2–203Fewer release tags than this and the feature is null
mining.release_cycle.interval_statmedian, mean"median"Statistic over past release intervals used as the repo's typical release interval
mining.flaky_detection.enabledbooleantruefalse turns off flaky detection from re-runs
mining.flaky_detection.min_rerun_passesinteger 1–203Failed-then-passed re-runs needed before a check is marked flaky
mining.flaky_detection.lookback_daysinteger 14–36590Days of check history searched for failed-then-passed re-runs

model block

KeyAllowedDefaultFlagsMeaning
model.per_repo_layer.enabledbooleantruefalse serves the global model only (layer_weight 0)
model.per_repo_layer.max_layer_weightnumber 0–11.0Upper limit on layer_weight, the per-repo layer's share of the score (0 to 1)
model.disabled_featureslist of string[]unionFeature names forced to null. Width of the vector never changes. Repos may only add. Example: agent_authored
model.backfill.lookback_daysinteger 90–36501095Days of history mined on install
model.backfill.recent_first_daysinteger 30–365180Most recent days of history mined first; older history follows in the background

Declared model columns

Every rule compiles to these fixed columns. null when undeclared.

ColumnMeaning
max_criticality0-3 from path_tier and component tier
frac_lines_in_criticalshare of changed lines at tier critical
n_components_toucheddeclared components spanned
n_sensitivity_tagsdistinct sensitivity values touched
max_exposure0 internal, 1 partner, 2 external
max_data_class0 public, 1 internal, 2 confidential, 3 restricted
regulated_scope_countdistinct regimes touched
log_max_blast_radiuslog1p of declared dependents
touches_deprecatedany touched component has lifecycle deprecated
policy_violationscount of policy rules broken by the diff
required_tests_missinga required_tests policy fired
in_freeze_windowPR opened inside a freeze window
targets_release_branchbase branch class is release or hotfix
author_is_ownerresolved author owns any touched path
agent_in_criticalagent-authored and max_criticality = 3
label_priority0-3 from pr_label priority, null if unlabeled
is_safe_change_onlyevery changed line falls in a declared safe_change kind

Settings (org_config.schema.json)

Version: 5.0

How the app behaves. Settings never change what the model sees or learns; those live in contracts/org_rules.schema.json and are pinned into model_version. Files: .github/riffle.yml in the org's .github repo (org defaults) and in each repo. Loading: built-in defaults, then org file, then repo file (repo wins), then organization.locked_keys restored from the org file. Files are read from the default branch only, so a PR cannot change the settings it is judged by. An invalid file never stops Riffle: the last valid settings stay in force and one neutral notice is posted. Arrays replace unless marked x-riffle-merge: union. Keys marked x-riffle-org-only are ignored in repo files. Every key has a default, so a file with only schema_version is valid.

schema_version

KeyAllowedDefaultFlagsMeaning
schema_versionstring matching ^5\.[0-9]+$major.minor. Minor adds optional keys; major renames or removes, with deprecated keys accepted for one minor version

mode

KeyAllowedDefaultFlagsMeaning
modeactive, shadow, off"active"shadow scores, learns and logs but posts nothing

organization

KeyAllowedDefaultFlagsMeaning
organization.outcome_sharing.enabledbooleanfalseorg onlyAnonymised feature vectors and outcomes only. Never code, diffs or identities
organization.data_retention.store_diffsbooleanfalseorg onlyKeep full diffs after features are computed
organization.data_retention.retention_daysinteger 30–730365org onlyDays stored data is kept
organization.label_prefixstring"riffle"org onlyPrefix of every label Riffle applies
organization.locked_keyslist of string matching ^/["/organization", "/llm/provider", "/llm/send"]org onlyJSON pointers a repo file may not change

scope

KeyAllowedDefaultFlagsMeaning
scope.base_brancheslist of string (regex)[]Extra target branches besides the default branch
scope.include_draftsbooleanfalsePost on draft PRs too
scope.quiet_authorslist of string["dependabot[bot]", "renovate[bot]", "github-actions[bot]"]unionScored and shown on the dashboard, but no comment or label. Nothing is left unscored
scope.quiet_title_keywordslist of string["WIP", "DO NOT MERGE"]unionSame as quiet_authors, matched on the PR title

rank_bands

KeyAllowedDefaultFlagsMeaning
rank_bands.modepercentile, absolute"percentile"percentile cuts bands from the repo's score distribution; absolute cuts on fixed scores
rank_bands.percentile.senior_recommended_top_fractionnumber 0–10.05Share of the highest-scoring PRs placed in senior_recommended
rank_bands.percentile.review_first_top_fractionnumber 0–10.2Matches the top-20% effort-aware recall metric
rank_bands.percentile.windowrepo, component"repo"component ranks each monorepo package against itself
rank_bands.absolute.senior_recommended_min_scorenumber 0–10.8Lowest risk_score placed in senior_recommended
rank_bands.absolute.review_first_min_scorenumber 0–10.5Lowest risk_score placed in review_first
rank_bands.holdout_fractionnumber 0.02–0.10.05Share of PRs left unranked (FIFO) to measure lift and limit feedback-loop bias
rank_bands.tie_breaklist of similar_pr_bad_rate, path_detection_lag_days, revealed_path_scrutiny, path_size_pctile, release_cycle_position["similar_pr_bad_rate", "path_detection_lag_days"]Only for identical rounded scores; PR age is always the last key

floors

KeyAllowedDefaultFlagsMeaning
floors.enabledbooleantruedecision pendingfalse turns off every floor
floors.pathslist of objects[]decision pending, unionMinimum band for PRs that touch a path
floors.paths[].patternstringdecision pending, unionPath glob
floors.paths[].min_bandreview_first, senior_recommendeddecision pending, unionstandard is the lowest band, so it is not a floor
floors.ai_agentsreview_first, senior_recommended or nullnulldecision pendingMinimum band for PRs by AI agents; null for none
floors.first_time_contributorsreview_first, senior_recommended or nullnulldecision pendingMinimum band for PRs by first-time contributors; null for none

size

KeyAllowedDefaultFlagsMeaning
size.thresholds.xsinteger 0–0Lower bound of xs
size.thresholds.sinteger 0–10Lower bound of s
size.thresholds.minteger 0–100Lower bound of m
size.thresholds.linteger 0–500Lower bound of l
size.thresholds.xlinteger 0–1000Lower bound of xl
size.count_filesbooleanfalseWhether changed files count toward the size label
size.ignore_pathslist of string["**/*.lock", "**/package-lock.json", "**/go.sum"]Excluded from the size label only; still counted for risk
size.apply_labelbooleantrueApply the size label
size.large_pr_notestring or nullnullNote shown on large PRs; null for none

authors

KeyAllowedDefaultFlagsMeaning
authors.agentsfull, label_only, silent"full"silent still scores and shows on the dashboard
authors.externalfull, label_only, silent"full"silent still scores and shows on the dashboard
authors.ai_agent_labelstring or null"ai-authored"Transparency label. Detection itself is configured in rules (author_class)
authors.path_experience_notebooleantrueMention when the author rarely touches these files

reviewer_routing

KeyAllowedDefaultFlagsMeaning
reviewer_routing.modeoff, suggest, request"suggest"off, suggest reviewers, or request them on the PR
reviewer_routing.use_codeownersbooleantrueUse CODEOWNERS when choosing reviewers
reviewer_routing.senior_reviewerslist of string matching ^@[A-Za-z0-9-]+(/[A-Za-z0-9._-]+)?$[]Reviewers for senior_recommended PRs
reviewer_routing.groupslist of objects[]Reviewers by path
reviewer_routing.groups[].namestringGroup name
reviewer_routing.groups[].pathslist of stringPath globs the group reviews
reviewer_routing.groups[].reviewerslist of string matching ^@[A-Za-z0-9-]+(/[A-Za-z0-9._-]+)?$Reviewers in the group
reviewer_routing.reviewers_per_printeger 1–51Reviewers chosen per PR
reviewer_routing.algorithmload_balance, round_robin, random"load_balance"How reviewers are picked
reviewer_routing.max_open_reviews_per_reviewerinteger or null 1–nullMost open reviews per reviewer; null for no limit
reviewer_routing.skip_title_keywordslist of string["wip"]PR title keywords that skip reviewer routing

availability

KeyAllowedDefaultFlagsMeaning
availability.users_unavailablelist of string matching ^@[A-Za-z0-9-]+(/[A-Za-z0-9._-]+)?$[]Users or teams currently unavailable to review
availability.timezonestring"UTC"IANA name
availability.working_dayslist of mon, tue, wed, thu, fri, sat, sun["mon", "tue", "wed", "thu", "fri"]Days that count as working days
availability.working_hoursstring matching ^([01][0-9]|2[0-3]):[0-5][0-9]-([01][0-9]|2[0-3]):[0-5][0-9]$"09:00-17:00"Working hours on a working day, HH:MM-HH:MM in timezone

review_targets

KeyAllowedDefaultFlagsMeaning
review_targets.senior_recommended_hoursinteger 1–7204Target for senior_recommended PRs, in working hours
review_targets.review_first_hoursinteger 1–7204Target for review_first PRs, in working hours
review_targets.standard_hoursinteger 1–7208Target for standard PRs, in working hours

reminders

KeyAllowedDefaultFlagsMeaning
reminders.enabledbooleanfalseSend reminders
reminders.min_age_hoursinteger 1–72024Hours a PR must be open before a reminder
reminders.min_staleness_hoursinteger 1–7208Hours without activity before a reminder
reminders.ignore_draftsbooleantrueNo reminders on draft PRs
reminders.ignore_approved_withinteger 0–101No reminders on PRs with at least this many approvals
reminders.ignored_labelslist of string[]PR labels that stop reminders

rescore

KeyAllowedDefaultFlagsMeaning
rescore.onlist of push, ready_for_review, ci_completed, reopened, edited, labeled["push", "ready_for_review", "ci_completed", "reopened"]PR events that trigger a rescore
rescore.max_rescores_per_printeger 1–10020Most rescores one PR gets
rescore.min_minutes_between_editsinteger 0–602Minutes between rescores triggered by edits

commands

KeyAllowedDefaultFlagsMeaning
commands.enabledbooleantrueAccept /riffle commands
commands.prefixstring matching ^/[a-z-]+$"/riffle"Command prefix
commands.override.allowedwrite_access, maintainers, codeowners"write_access"org onlyWho may override a band
commands.override.require_reasonbooleantrueorg onlyThe reason is stored with the route_override training label
commands.override.allow_downgradebooleantrueorg onlyFloors still apply
commands.disable_labelstring"riffle:disabled"Stops comments on that PR; it is still scored

pr_output

KeyAllowedDefaultFlagsMeaning
pr_output.post_commentbooleantruePost a comment on the PR
pr_output.update_existing_commentbooleantrueEdit the existing comment rather than posting a new one
pr_output.apply_labelsbooleantrueApply band labels
pr_output.labels.review_firststring"review first"Label for review_first
pr_output.labels.standardstring"standard"Label for standard
pr_output.labels.senior_recommendedstring"senior recommended"Label for senior_recommended
pr_output.labels.overridestring"wrong route"Label for a PR whose band was overridden
pr_output.component_label_prefixstring or nullnullPrefix of component labels; null for none
pr_output.bands_with_commentlist of review_first, standard, senior_recommended["review_first", "senior_recommended"]Bands whose PRs get a comment
pr_output.show_top_factorsinteger 0–53From SHAP; explains the rank even with the LLM off
pr_output.show_scorebooleanfalseShow risk_score in the comment
pr_output.show_componentbooleantrueShow the component in the comment
pr_output.collapsebooleantrueCollapse the comment
pr_output.evidence.cite_similar_prsinteger 0–53Most similar past PRs cited
pr_output.evidence.failure_modebooleantrueCite failure_mode_top
pr_output.evidence.scrutinybooleantrueCite scrutiny_top_path
pr_output.evidence.path_sizebooleantrueCite size_context
pr_output.evidence.release_cyclebooleantrueCite release_context

explanation

KeyAllowedDefaultFlagsMeaning
explanation.enabledbooleantrueTurning off never stops scoring
explanation.languagestring matching ^[a-z]{2}(-[A-Z]{2})?$"en-US"Language of the explanation, e.g. en-US
explanation.max_bulletsinteger 1–73Most bullets in the explanation
explanation.show_review_effortbooleantrueMention review effort
explanation.mention_missing_testsbooleantrueMention missing tests
explanation.mention_missing_issuebooleanfalseMention a missing linked issue
explanation.show_effective_configbooleanfalseShow the effective settings
explanation.known_fragilelist of string[]Paths the narrator names explicitly
explanation.house_termsobject{}Up to 50 organisation terms for the narrator, as term to text

llm

KeyAllowedDefaultFlagsMeaning
llm.providernone, hosted, self_hosted"none"none = SHAP template explanations only
llm.endpointstring or null (uri)nullURL of the LLM endpoint
llm.sendfeatures_only, diff_hunks, full_files"features_only"Repos may only make this stricter
llm.excluded_pathslist of string["**/.env*", "**/*.pem", "**/*.key", "**/*secret*"]unionPaths never sent to the LLM
llm.max_calls_per_hourinteger 0–1000060Most LLM calls per hour

queue

KeyAllowedDefaultFlagsMeaning
queue.epic_prioritybooleanfalseLinked issue priority breaks ties inside a band
queue.manual_boosts.enabledbooleanfalseApply manual boosts
queue.manual_boosts.areaslist of objects[]Paths whose PRs move up the queue
queue.manual_boosts.areas[].pathslist of stringPath globs the boost applies to
queue.manual_boosts.areas[].boostnumber 0–0.20.05Moves queue position, never risk_score

stacks

KeyAllowedDefaultFlagsMeaning
stacks.score_aseach_pr, whole_stack"each_pr"Score each PR in a stack on its own, or the stack as a whole
stacks.comment_oneach_pr, stack_top"each_pr"Comment on each PR in a stack, or only the top one

limits

KeyAllowedDefaultFlagsMeaning
limits.max_comments_per_hourinteger 1–1000120Most comments Riffle posts per hour

overrides

Per component or path, inside a monorepo. Most specific match wins.

Each entry has match (component or paths) and may set rank_bands, pr_output, reviewer_routing, review_targets with the same keys as the top-level blocks.

dashboard

KeyAllowedDefaultFlagsMeaning
dashboard.visibilityorg_members, repo_writers, admins"repo_writers"org onlyWho can see the dashboard
dashboard.show_individual_metricsbooleanfalseorg onlyPer-person statistics stay hidden unless on
dashboard.group_byband, component, owner, author_type"band"org onlyHow the dashboard groups PRs

audit

KeyAllowedDefaultFlagsMeaning
audit.enabledbooleantrueorg onlyKeep the audit log
audit.retention_daysinteger 30–1095365org onlyDays audit entries are kept

notifications

KeyAllowedDefaultFlagsMeaning
notifications.slack_webhook_secret_refstring or nullnulllaterSecret reference for a Slack webhook, never the value; null for none
notifications.digestoff, daily, weekly"off"laterHow often a digest is sent

Code checks

Cross-field rules the schema cannot express:

  • rank_bands.percentile.senior_recommended_top_fraction <= review_first_top_fraction
  • rank_bands.absolute.review_first_min_score <= senior_recommended_min_score
  • size.thresholds strictly increase xs < s < m < l < xl
  • scope.base_branches entries compile as regex
  • repo files cannot loosen locked or privacy keys (e.g. llm.send may only move toward features_only)
  • floors never lower a band; a floor that equals the model band is not shown

Mined features (mined_features.schema.json)

Version: 1.0

Nine repo-local columns mined from git, CI and review history that capture how one repository behaves. Computed at the PR's base commit by the scorer's extractor at scoring time and by the repo miner (pipelines/ingestion/repo_miner) for training rows, appended to the fixed feature vector, and emitted alongside evidence the narrator may cite. Point-in-time rule: only past PRs merged before this PR opened AND whose labels were mature at that moment may contribute. Only reviews completed before open count. null means not enough history (thresholds in rules.mining), never 0.

columns

KeyAllowedDefaultFlagsMeaning
columns.similar_pr_bad_ratenumber or null 0–1Share of the k nearest past PRs (Jaccard over touched files, >= min_file_overlap) with label_bad. Smoothed toward repo_revert_base_rate when neighbours are few
columns.similar_pr_countinteger 0–Neighbours actually found; lets the model discount a rate built on 3 PRs
columns.revealed_path_scrutinynumber or null 0–Mean over touched files of (review comments + 2 x changes_requested + rounds) on prior PRs, divided by the repo mean. 1.0 = typical for this repo
columns.path_failure_mode_revertnumber or null 0–1Share of past bad changes on these paths that were reverts
columns.path_failure_mode_cinumber or null 0–1Share that were post-merge CI failures
columns.path_failure_mode_hotfixnumber or null 0–1Share that were hotfixes. The three shares sum to 1 when not null. Encoded as shares, not a category, so trees can split on them
columns.path_detection_lag_daysnumber or null 0–Median days from merge to the outcome event for past bad changes on these paths. High = failures here surface slowly
columns.path_size_pctilenumber or null 0–1Percentile of this PR's LA+LD among past changes to the same files (weighted by lines per file). Complements the repo-wide pr_size_pctile_repo
columns.release_cycle_positionnumber or null 0–Days since last release tag divided by the repo's typical release interval. Above 1 means a release is overdue

evidence

KeyAllowedDefaultFlagsMeaning
evidence.similar_prslist of objectsPast PRs behind similar_pr_bad_rate
evidence.similar_prs[].pr_numberintegerPast PR number
evidence.similar_prs[].overlapnumber 0–1Jaccard over touched files with this PR
evidence.similar_prs[].outcomeclean, revert, ci_fail, hotfixHow the past PR turned out
evidence.similar_prs[].merged_atstring (date-time)When the past PR merged
evidence.scrutiny_top_pathobject or nullTouched path with the highest scrutiny ratio, for revealed_path_scrutiny.
evidence.failure_mode_topobject or nullMost common failure mode on these paths, for the path_failure_mode_* columns.
evidence.size_contextobject or nullComparison behind path_size_pctile.
evidence.release_contextobject or nullRelease history behind release_cycle_position.

Outcome import (outcome_import.schema.json)

Version: 1.0

Body of POST /v1/outcomes. Lets an org report outcomes Riffle cannot see (internal reverts, incidents, internal CI). Signed with the secret named in rules sources.outcome_import. Imported outcomes become the external_import label source, weighted by its label_source rule. Idempotent on event_id. Never carries code or diffs.

KeyAllowedDefaultFlagsMeaning
event_idstringSender's unique id; resends are ignored
repostring matching ^[A-Za-z0-9-]+/[A-Za-z0-9._-]+$Repository as owner/name
target.commit_shastring matching ^[0-9a-f]{40}$Commit the outcome is about
target.pr_numberinteger 1–PR the outcome is about
target.external_change_idstringMatched through link rules, e.g. D12345678
outcomerevert, incident, ci_fail, hotfix, cleanWhat happened to the target
severityinteger 1–41 is worst
occurred_atstring (date-time)When the outcome happened
sourcestringFree label for audit, e.g. internal-ci

Riffle head commit features (mined_commit_features.schema.json)

Version: 1.1

Code features of each head commit a PR had while open, captured during mining (snapshot_capture.py) for the PRs snapshots are built for: up to snapshot_max_heads per PR. Feature columns are null on the at-open head, whose features are in the mined row, and on a head that failed (error).

KeyAllowedDefaultFlagsMeaning
repostringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
pr_numberintegerRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_shastringA head commit the PR had while it was open
base_shastring or nullIts fork point from the base branch; the code features are base...head
first_seenstring (date-time)When this commit became the PR's head (commit time standing in for push time)
at_openbooleanThe at-open head; its features are the mined row's, not repeated here
errorstring or nullWhy the features couldn't be computed, if they couldn't
Entropynumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
LAnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
LDnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NDnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NFnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NSnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
api_contract_changeadditive, breaking, NoneSource 5 API contract diff. Computed in pipelines/ingestion/repo_miner/features/api_contract.py.
bound_or_comparison_editnumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
ccn_deltanumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
dependency_major_bump_countnumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
docs_onlyboolean or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
frac_generated_linesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
frac_test_linesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
ghsa_malware_depboolean or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
ghsa_max_severity_introducedLOW, MODERATE, HIGH, CRITICAL, NoneSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
hardcoded_secret_addednumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
lang_mixnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
max_ccn_changed_funcnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
migration_reversibilitydestructive, reversible, NoneSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
n_deps_addednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_deps_downgradednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_deps_upgradednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_files_addednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_files_removednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_files_renamednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_funcs_modifiednumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
n_major_bumpsnumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
new_env_or_config_keynumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
observability_deltanumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
osv_ghsa_disagreementanySource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py. Type not pinned yet: null in every sampled row.
osv_vulns_fixednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
osv_vulns_introducednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
patch_missing_filesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
semgrep_cwe_top25_newboolean or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
semgrep_findings_newnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
semgrep_high_conf_security_newnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
test_onlyboolean or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
touches_auth_pathboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_ci_configboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_codeowners_or_riffle_ymlboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_dep_manifestboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_infraboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_lockfileboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_migrationboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
unused_import_or_dead_code_addednumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
vuln_has_fix_availableboolean or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.

Riffle repo miner training row (mined_dataset.schema.json)

Version: 1.3

One row of the training dataset written by the repo miner (pipelines/ingestion/repo_miner, .parquet or .jsonl): one closed PR, merged or unmerged (ADR 0009), with every feature computed from the PR as it opened (ADR 0010) and its outcome labels. Labels and the counts behind them are outcomes and never model inputs. The nine repo-local columns are defined in mined_features.schema.json. null means not observed or not enough history, never 0. Every column is present on every row; a stage that is turned off leaves its columns null. Since 1.1 rows also carry provenance (miner_version, miner_commit, llm_model, llm_prompt_version) and domain; these are optional in the schema so rows mined before miner 4.0.0 still validate, and the miner writes them on every row. Since 1.2: outcome_3class, nowhere_reason, ci_fail_flaky_only and author_confirmed_maintainer, optional in the schema for older rows; the miner writes them on every row.

KeyAllowedDefaultFlagsMeaning
AGEnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
EXPnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
Entropynumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
FIXboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
LAnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
LDnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
LTnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
NDnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NFnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NSnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
REXPnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
SEXPnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
agent_boilerplateboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
agent_nameclaude_code, codex, copilot, cursor, devin, jules, sweep, NoneMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
agent_recent_closed_countnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
agent_recent_merge_rateanyMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py. Type not pinned yet: null in every sampled row.
ai_agent_authoredboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
api_contract_changeadditive, breaking, NoneSource 5 API contract diff. Computed in pipelines/ingestion/repo_miner/features/api_contract.py.
author_account_age_daysnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_associationOWNER, MEMBER, COLLABORATOR, CONTRIBUTOR, FIRST_TIME_CONTRIBUTOR, FIRST_TIMER, MANNEQUIN, NONE, NoneRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_days_since_last_changenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
author_emailstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_file_familiaritynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
author_is_botboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_post_merge_ci_fail_rateanySource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py. Type not pinned yet: null in every sampled row.
author_prs_merged_reponumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_revert_ratenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
authz_check_changenone, added, removed, weakened, moved, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
base_behind_bynumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
base_shastringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
body_checklist_itemsnumber or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
body_has_test_planboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
body_headingsnumber or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
body_lennumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
bound_or_comparison_editnumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
ccn_deltanumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
change_intentfeat, fix, refactor, perf, docs, test, build_ci, chore, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
changes_public_api_signatureboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
changes_requested_reviewsnumber or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
ci_observedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
close_reasonduplicate, unwanted, ci_technical, abandoned, other, NoneMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
close_reason_sourcellm, rules, NoneMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
closed_atstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
cochange_degreenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
cochange_partners_missingnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
concurrent_open_prs_same_filesnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
concurrent_open_prs_same_hunksnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
config_or_feature_flag_changenone, config, feature_flag, both, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
created_atstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
days_to_hotfixanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
days_to_revertanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
days_to_szz_fixanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
db_schema_or_query_changenone, schema, query, both, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
declared_hotfixboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
dependency_major_bump_countnumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
docs_onlyboolean or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
entropy_pctile_reponumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
error_handling_changenone, added, removed, modified, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
exception_swallowedboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
expected_test_cochange_missingboolean or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
feature_flag_guardingn_a, guarded, partial, unguarded, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
frac_generated_linesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
frac_test_linesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
ghsa_malware_depboolean or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
ghsa_max_severity_introducedLOW, MODERATE, HIGH, CRITICAL, NoneSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
hardcoded_secret_addednumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
has_agents_mdboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
has_contributingboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
has_linked_issueboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
has_milestoneboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_branch_agent_prefixboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_from_forkboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_shastringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
hotfix_window_closedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
input_validation_changenone, added, weakened, modified, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
la_normnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
label_abandonedboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_badboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_bad_observedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_ci_failanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
label_ci_fail_optionalanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
label_ci_technicalboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_duplicateboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_hotfixboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_mergedboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_revertboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_reworkboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_szz_bugboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_unwantedboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
lang_mixnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
ld_normnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
llm_touches_authn_authzboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
max_NDEVnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_NUCnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_abandoned_lines_sharenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_ccn_changed_funcnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
max_file_churn_365dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_churn_90dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_complexity_ccnnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_fix_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_hotspot_scorenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_minor_contributor_countnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_post_merge_ci_fail_rateanySource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py. Type not pinned yet: null in every sampled row.
max_file_revert_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_top_author_sharenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_fix_decay_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_hotfix_count_365dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_hunk_fix_proximitynumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
max_mod_lines_distinct_authorsnumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
max_mod_lines_prior_fix_sharenumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
max_recent_merge_burst_7dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_revert_decay_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_sim_open_prsnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
max_sim_recent_mergednumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
max_test_cochange_rationumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_file_age_daysnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_file_fix_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_file_revert_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_hunk_fix_proximitynumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
mean_mod_lines_self_authored_sharenumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
median_mod_line_age_days_mediannumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
merge_viagithub, landed_commit, NoneRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
merged_atstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
migration_reversibilitydestructive, reversible, NoneSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
min_days_since_last_fixnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
min_days_since_last_revertanySource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py. Type not pinned yet: null in every sampled row.
min_file_hotspot_ranknumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
min_hotspot_rank_touchednumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
min_mod_line_age_days_minnumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
mined_atstringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
n_deps_addednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_deps_downgradednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_deps_upgradednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_files_addednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_files_removednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_files_renamednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_funcs_modifiednumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
n_major_bumpsnumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_topk_hotspots_touchednumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
new_env_or_config_keynumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
nf_pctile_reponumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
null_handling_changenone, added, removed, new_nullable_deref, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
numeric_money_precisionboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
observability_deltanumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
observed_throughstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
open_snapshotexact, recovered, approx, final, NoneRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
osv_ghsa_disagreementanySource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py. Type not pinned yet: null in every sampled row.
osv_vulns_fixednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
osv_vulns_introducednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
patch_missing_filesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
path_detection_lag_daysanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_failure_mode_cianyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_failure_mode_hotfixanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_failure_mode_revertanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_size_pctilenumber or nullRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py.
post_open_commitsnumber or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
post_open_force_pushesnumber or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
pr_numberintegerRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
pr_size_pctile_reponumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
refactor_vs_behaviorpure_refactor, behavior_change, mixed, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
release_cycle_positionnumber or nullRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py.
repostringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
repo_agent_pr_load_30dnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
repo_median_first_response_hoursanyMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py. Type not pinned yet: null in every sampled row.
repo_outside_closed_countnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
repo_outside_merge_ratenumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
repo_revert_base_ratenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
resource_lifecycle_changenone, acquire_no_release, release_removed, modified, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
retry_timeout_idempotency_changeboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
revealed_path_scrutinyanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
revert_window_closedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
satd_addedinteger or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
security_sensitive_opsboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
semantic_risk_1to5integer or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
semgrep_cwe_top25_newboolean or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
semgrep_findings_newnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
semgrep_high_conf_security_newnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
similar_pr_bad_rateanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
similar_pr_countnumber or nullRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py.
sum_file_complexity_ccnnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
sum_hotfix_count_365dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
targets_default_branchboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
test_code_alignmentnone, unrelated, partial, aligned, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
test_onlyboolean or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
tests_added_for_behavior_changeyes, no, n_a, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
time_handling_changeboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
title_lennumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
touches_auth_pathboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_ci_configboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_codeowners_or_riffle_ymlboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_dep_manifestboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_infraboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_lockfileboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_migrationboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_topk_hotspotboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
transaction_boundary_changenone, added, removed, widened, narrowed, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
unrelated_change_shareinteger or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
unused_import_or_dead_code_addednumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
vuln_has_fix_availableboolean or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
miner_versionstringRepo miner version that wrote the row (version.py). Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
miner_commitstringThe miner's git commit (12 characters), with -dirty when its files had uncommitted changes, or unknown. Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
llm_modelstring or nullLLM model the row's LLM columns were asked of; null when the LLM was off. Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
llm_prompt_versionstring or nullHash of the LLM prompts and schemas (flags and close-reason classifier); null when the LLM was off. Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
domainstring or nullDataset domain of the repository (ADR 0011), from its [domain: NAME] tag in the repos file; null when untagged. Computed in pipelines/ingestion/repo_miner/build_dataset.py.
outcome_3classlands_clean, lands_after_rework, goes_nowhere, NoneTraining target (proposal Part 4): lands_clean (merged, no rework), lands_after_rework (merged after rework), goes_nowhere (closed unmerged, or abandoned); null when rework wasn't observable. An outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
nowhere_reasonabandoned, duplicate, unwanted, ci_technical, unknown, NoneFor goes_nowhere rows: abandoned, duplicate, unwanted, ci_technical, or unknown (read, but no rule or classifier found a reason); null on merged rows and when the timeline was unreadable. An outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
ci_fail_flaky_onlyboolean or nullTrue when the merge commit's required CI failure came only from checks flaky at merge time (3+ rerun-passes in the prior 90 days, rules.mining.flaky_detection); label_ci_fail is then False. Null when CI wasn't observed and on unmerged rows. An outcome detail, never a model input. Computed in pipelines/ingestion/repo_miner/flaky.py.
author_confirmed_maintainerboolean or nullThe PR author had merged or closed someone else's PR before this one opened, from the repo's timelines (proposal 2.2). author_association shows today's status and hides private org members, so this is what decides outside contributors. Null when no timelines were read. Computed in pipelines/ingestion/repo_miner/maintainers.py.
llm_diff_truncatedboolean or nullTrue when the LLM diff size cap dropped or cut code the model would have read; false when the whole diff was shown; null when no LLM call was made (off, skipped, empty or a reused answer). Metadata about the call, never a model input. Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
szz_window_closedboolean or nullTrue when the SZZ observation window for the PR has closed: szz_maturity_days (default 90) had passed between the PR's merge and the observation cutoff (observed_through), so a label_szz_bug of false is mature. False while the window is still open: a fix that would later be traced to this PR may not exist yet. Null when the SZZ label was not computed (SZZ off, an unmerged PR) or szz_maturity_days is 0 (no cap, so no window). Never a model input. Computed in pipelines/ingestion/repo_miner/labels.py.

Riffle mined history manifest (mined_history.schema.json)

Version: 1.0

Manifest written by the Go history miner (services/miner) for one repository and one run, next to the Parquet tables it lists. pipelines/ and scorer read the tables only through this manifest. Tables are raw history, not model features: every feature is computed in Python from these tables, in training and serving alike. Data stays inside the installation; author emails are stored only as salted hashes. A run is usable only when status is complete; partial runs carry a checkpoint and are resumed, never read.

KeyAllowedDefaultFlagsMeaning
run_idstringUnique per run; reruns with the same run_id overwrite the same files (idempotent)
tenant_idstringInstallation the run belongs to
repostring matching ^[A-Za-z0-9-]+/[A-Za-z0-9._-]+$Repository as owner/name
miner_versionstringPinned into model_version via the feature extractor version
statusrunning, partial, complete, failedRun state; only complete runs are read
window.fromstring (date-time)Start of the history covered
window.tostring (date-time)End of the history covered
window.head_shastring matching ^[0-9a-f]{40}$Default branch head the run mined up to
started_atstring (date-time)When the run started
finished_atstring or null (date-time)When the run finished; null if it has not
checkpointobject or nullWhere a partial or failed run resumes. Opaque to readers.
rate_limit.requestsinteger 0–GitHub API requests made
rate_limit.conditional_hitsinteger 0–304 responses, which do not count against the limit
rate_limit.secondary_limit_waitsinteger 0–Times the run waited on a GitHub secondary rate limit
coverage.check_runs_fromstring or null (date-time)Earliest check result still retrievable; ci_fail is unobserved before this
coverage.reviews_fromstring or null (date-time)Earliest review still retrievable
tableslist of objectsParquet tables the run wrote.
tables[].namecommits, file_changes, pull_requests, reviews, check_runs, tagsTable name; columns are listed in x-riffle-tables
tables[].uristringgs:// or file:// path to the Parquet file
tables[].rowsinteger 0–Row count
tables[].sha256string matching ^[0-9a-f]{64}$SHA-256 of the Parquet file

Table commits

ColumnType and meaning
shastring, primary key
parent_shaslist<string>
author_loginstring or null, resolved through identity rules
author_email_hashstring, salted per installation
committed_attimestamp
messagestring, used by pattern and link rules
is_mergebool

Table file_changes

ColumnType and meaning
shastring, commits.sha
pathstring
old_pathstring or null, set on rename
statusadded | modified | removed | renamed
lines_addedint
lines_deletedint
is_binarybool

Table pull_requests

ColumnType and meaning
numberint, primary key
author_loginstring
created_attimestamp
merged_attimestamp or null
closed_attimestamp or null
base_branchstring
head_branchstring
merge_commit_shastring or null
labels_at_openlist<string>
is_draft_at_openbool
titlestring

Table reviews

ColumnType and meaning
pr_numberint, pull_requests.number
reviewer_loginstring
stateapproved | changes_requested | commented | dismissed
submitted_attimestamp
comment_countint

Table check_runs

ColumnType and meaning
head_shastring
namestring
conclusionsuccess | failure | neutral | cancelled | skipped | timed_out | action_required | null
run_attemptint, for flaky detection
app_idint
completed_attimestamp or null

Table tags

ColumnType and meaning
namestring
shastring
created_attimestamp

Riffle PR snapshot row (mined_snapshot.schema.json)

Version: 1.4

One PR at one moment while it was open (pipelines/ingestion/repo_miner/snapshots.py), labelled with how the PR finally ended. Every column of mined_dataset.schema.json, with three groups taken as of snapshot_at instead of the PR's open: the code features of the head commit then (diff sizes, path flags, deterministic, scanner, dependency and API-contract columns), the merge signals (repo_outside_merge_rate and the rest), and the snapshot state columns. Git-history, blame, LLM and PR-metadata columns stay as at open. Labels are outcomes and never model inputs; so is near_decided. Bots count for nothing in the state. Since 1.2: outcome_3class, nowhere_reason, ci_fail_flaky_only and author_confirmed_maintainer, optional in the schema for older rows; the miner writes them on every row. Since 1.3: snapshot_weight and moment_bucket (optional in the schema; snapshots.py writes them).

KeyAllowedDefaultFlagsMeaning
AGEnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
EXPnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
Entropynumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
FIXboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
LAnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
LDnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
LTnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
NDnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NFnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
NSnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
REXPnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
SEXPnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
agent_boilerplateboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
agent_nameclaude_code, codex, copilot, cursor, devin, jules, sweep, NoneMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
agent_recent_closed_countnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
agent_recent_merge_rateanyMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py. Type not pinned yet: null in every sampled row.
ai_agent_authoredboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
api_contract_changeadditive, breaking, NoneSource 5 API contract diff. Computed in pipelines/ingestion/repo_miner/features/api_contract.py.
author_account_age_daysnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_associationOWNER, MEMBER, COLLABORATOR, CONTRIBUTOR, FIRST_TIME_CONTRIBUTOR, FIRST_TIMER, MANNEQUIN, NONE, NoneRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_days_since_last_changenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
author_emailstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_file_familiaritynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
author_is_botboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_post_merge_ci_fail_rateanySource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py. Type not pinned yet: null in every sampled row.
author_prs_merged_reponumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
author_revert_ratenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
authz_check_changenone, added, removed, weakened, moved, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
base_behind_bynumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
base_shastringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
body_checklist_itemsnumber or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
body_has_test_planboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
body_headingsnumber or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
body_lennumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
bound_or_comparison_editnumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
ccn_deltanumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
change_intentfeat, fix, refactor, perf, docs, test, build_ci, chore, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
changes_public_api_signatureboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
changes_requested_reviewsnumber or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
ci_observedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
close_reasonduplicate, unwanted, ci_technical, abandoned, other, NoneMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
close_reason_sourcellm, rules, NoneMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
closed_atstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
cochange_degreenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
cochange_partners_missingnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
concurrent_open_prs_same_filesnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
concurrent_open_prs_same_hunksnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
config_or_feature_flag_changenone, config, feature_flag, both, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
created_atstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
days_to_hotfixanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
days_to_revertanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
days_to_szz_fixanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
db_schema_or_query_changenone, schema, query, both, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
declared_hotfixboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
dependency_major_bump_countnumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
docs_onlyboolean or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
entropy_pctile_reponumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
error_handling_changenone, added, removed, modified, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
exception_swallowedboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
expected_test_cochange_missingboolean or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
feature_flag_guardingn_a, guarded, partial, unguarded, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
frac_generated_linesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
frac_test_linesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
ghsa_malware_depboolean or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
ghsa_max_severity_introducedLOW, MODERATE, HIGH, CRITICAL, NoneSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
hardcoded_secret_addednumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
has_agents_mdboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
has_contributingboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
has_linked_issueboolean or nullMerge-model signal. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
has_milestoneboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_branch_agent_prefixboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_from_forkboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
head_shastringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
hotfix_window_closedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
input_validation_changenone, added, weakened, modified, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
la_normnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
label_abandonedboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_badboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_bad_observedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_ci_failanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
label_ci_fail_optionalanyPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py. Type not pinned yet: null in every sampled row.
label_ci_technicalboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_duplicateboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_hotfixboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_mergedboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_revertboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_reworkboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
label_szz_bugboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
label_unwantedboolean or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
lang_mixnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
ld_normnumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
llm_touches_authn_authzboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
max_NDEVnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_NUCnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_abandoned_lines_sharenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_ccn_changed_funcnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
max_file_churn_365dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_churn_90dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_complexity_ccnnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_fix_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_hotspot_scorenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_minor_contributor_countnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_post_merge_ci_fail_rateanySource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py. Type not pinned yet: null in every sampled row.
max_file_revert_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_file_top_author_sharenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_fix_decay_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_hotfix_count_365dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_hunk_fix_proximitynumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
max_mod_lines_distinct_authorsnumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
max_mod_lines_prior_fix_sharenumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
max_recent_merge_burst_7dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_revert_decay_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
max_sim_open_prsnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
max_sim_recent_mergednumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
max_test_cochange_rationumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_file_age_daysnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_file_fix_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_file_revert_densitynumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
mean_hunk_fix_proximitynumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
mean_mod_lines_self_authored_sharenumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
median_mod_line_age_days_mediannumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
merge_viagithub, landed_commit, NoneRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
merged_atstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
migration_reversibilitydestructive, reversible, NoneSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
min_days_since_last_fixnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
min_days_since_last_revertanySource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py. Type not pinned yet: null in every sampled row.
min_file_hotspot_ranknumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
min_hotspot_rank_touchednumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
min_mod_line_age_days_minnumber or nullSource 3 line-level blame. Computed in pipelines/ingestion/repo_miner/features/line_history.py.
mined_atstringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
n_deps_addednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_deps_downgradednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_deps_upgradednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_files_addednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_files_removednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_files_renamednumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
n_funcs_modifiednumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
n_major_bumpsnumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
n_topk_hotspots_touchednumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
new_env_or_config_keynumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
nf_pctile_reponumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
null_handling_changenone, added, removed, new_nullable_deref, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
numeric_money_precisionboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
observability_deltanumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
observed_throughstring or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
open_snapshotexact, recovered, approx, final, NoneRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
osv_ghsa_disagreementanySource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py. Type not pinned yet: null in every sampled row.
osv_vulns_fixednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
osv_vulns_introducednumber or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
patch_missing_filesnumber or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
path_detection_lag_daysanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_failure_mode_cianyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_failure_mode_hotfixanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_failure_mode_revertanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
path_size_pctilenumber or nullRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py.
post_open_commitsnumber or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
post_open_force_pushesnumber or nullMerge-outcome label or its counts (ADR 0009), an outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
pr_numberintegerRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
pr_size_pctile_reponumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
refactor_vs_behaviorpure_refactor, behavior_change, mixed, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
release_cycle_positionnumber or nullRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py.
repostringRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
repo_agent_pr_load_30dnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
repo_median_first_response_hoursanyMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py. Type not pinned yet: null in every sampled row.
repo_outside_closed_countnumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
repo_outside_merge_ratenumber or nullMerge-model signal, prior PRs only. Computed in pipelines/ingestion/repo_miner/features/merge_signals.py.
repo_revert_base_ratenumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
resource_lifecycle_changenone, acquire_no_release, release_removed, modified, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
retry_timeout_idempotency_changeboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
revealed_path_scrutinyanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
revert_window_closedboolean or nullPost-merge label or outcome detail (ADR 0002), never a model input; null on unmerged rows. Computed in pipelines/ingestion/repo_miner/labels.py.
satd_addedinteger or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
security_sensitive_opsboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
semantic_risk_1to5integer or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
semgrep_cwe_top25_newboolean or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
semgrep_findings_newnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
semgrep_high_conf_security_newnumber or nullSource 4d scanners. Computed in pipelines/ingestion/repo_miner/features/scanners.py.
similar_pr_bad_rateanyRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py. Type not pinned yet: null in every sampled row.
similar_pr_countnumber or nullRepo-local mined feature (mined_features.schema.json). Computed in pipelines/ingestion/repo_miner/features/repo_local.py.
sum_file_complexity_ccnnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
sum_hotfix_count_365dnumber or nullSource 2 repo history. Computed in pipelines/ingestion/repo_miner/features/history.py.
targets_default_branchboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
test_code_alignmentnone, unrelated, partial, aligned, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
test_onlyboolean or nullSource 4a/4b diff and paths. Computed in pipelines/ingestion/repo_miner/features/diff_stats.py.
tests_added_for_behavior_changeyes, no, n_a, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
time_handling_changeboolean or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
title_lennumber or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
touches_auth_pathboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_ci_configboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_codeowners_or_riffle_ymlboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_dep_manifestboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_infraboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_lockfileboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_migrationboolean or nullSource 4b path flag. Computed in pipelines/ingestion/repo_miner/config.py.
touches_topk_hotspotboolean or nullRow metadata or Source 4c PR metadata. Computed in pipelines/ingestion/repo_miner/mine_repo.py.
transaction_boundary_changenone, added, removed, widened, narrowed, NoneSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
unrelated_change_shareinteger or nullSource 6 LLM flag (diff only). Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
unused_import_or_dead_code_addednumber or nullSource 5 deterministic checks. Computed in pipelines/ingestion/repo_miner/features/deterministic.py.
vuln_has_fix_availableboolean or nullSource 4e dependencies and CVEs. Computed in pipelines/ingestion/repo_miner/features/deps_cve.py.
snapshot_idstringStable id: hash of repo, PR number, trigger and time, so re-mining gives the same rows
snapshot_atstring (date-time)The moment the snapshot describes (UTC). Everything in the row is as of this moment, except labels
snapshot_indexinteger 0–Order of this snapshot among the PR's kept snapshots
triggerapproval, author_fix_push, back_to_draft, changes_requested, clock, first_maintainer_reply, idle, marked_duplicate, no_maintainer_reply, open, outcome_labelWhat made this moment a snapshot: an event, or a clock (time since start, idle, no maintainer reply)
trigger_roleauthor, maintainer, other, clockWho caused the trigger; clock for time-based snapshots
snapshot_head_shastring or nullThe PR's head commit at snapshot_at (or the nearest earlier captured one, see head_found)
snapshot_base_shastring or nullFork point the head's code features were computed from
head_foundopen, exact, approx, cappedopen: the at-open head; exact: from the head line with force-push history known; approx: force-push history unreadable; capped: the true head wasn't captured, so the nearest earlier captured one is used
near_decidedbooleanLast hour before close, or after the PR entered a merge queue or got auto-merge. For filtering in training; never a model input
time_since_start_hnumber 0–Snapshot state. Hours since the clock started (open, ready-for-review, or the last reopen)
time_since_last_human_activity_hnumber 0–Snapshot state. Hours since the last non-bot event
maintainer_repliedbooleanSnapshot state. A maintainer has commented or reviewed
first_maintainer_reply_hnumber or nullSnapshot state. Hours from start to the first maintainer reply; null if none yet
review_roundsinteger 0–Snapshot state. Reviews by humans other than the author
changes_requested_countinteger or null 0–Snapshot state. Changes-requested reviews so far; null when unknowable (a dismissed review in an old capture that does not say what it was before)
approvals_countinteger or null 0–Snapshot state. Approving reviews so far; null when unknowable (a dismissed review in an old capture that does not say what it was before)
commits_since_startinteger 0–Snapshot state. Commits pushed after the start (merges from the base not counted)
force_pushes_since_startinteger 0–Snapshot state. Force-pushes after the start
author_pushed_after_last_reviewbooleanSnapshot state. The author pushed after the latest review
maintainer_comment_countinteger 0–Snapshot state. Comments by maintainers
author_comment_countinteger 0–Snapshot state. Comments by the PR author
other_comment_countinteger 0–Snapshot state. Comments by other humans
has_outcome_labelbooleanSnapshot state. An outcome label (duplicate, wontfix, stale, needs-info, ...) is on the PR now
marked_duplicate_so_farbooleanSnapshot state. Someone marked the PR as a duplicate
is_draft_nowbooleanSnapshot state. The PR is back in draft
reopen_countinteger 0–Snapshot state. Times the PR was reopened so far
new_commits_since_previnteger or nullSnapshot state. Commits since the previous candidate moment (kept or capped out); null on the first
new_comments_since_previnteger or nullSnapshot state. Human comments since the previous candidate moment (kept or capped out); null on the first
diff_size_change_since_prevnumber or nullSnapshot state. Change in LA + LD since the previous candidate moment (kept or capped out); null on the first
miner_versionstringRepo miner version that wrote the row (version.py). Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
miner_commitstringThe miner's git commit (12 characters), with -dirty when its files had uncommitted changes, or unknown. Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
llm_modelstring or nullLLM model the row's LLM columns were asked of; null when the LLM was off. Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
llm_prompt_versionstring or nullHash of the LLM prompts and schemas (flags and close-reason classifier); null when the LLM was off. Provenance (proposal 1.7, 1.8). Computed in pipelines/ingestion/repo_miner/mine_repo.py.
domainstring or nullDataset domain of the repository (ADR 0011), from its [domain: NAME] tag in the repos file; null when untagged. Computed in pipelines/ingestion/repo_miner/build_dataset.py.
outcome_3classlands_clean, lands_after_rework, goes_nowhere, NoneTraining target (proposal Part 4): lands_clean (merged, no rework), lands_after_rework (merged after rework), goes_nowhere (closed unmerged, or abandoned); null when rework wasn't observable. An outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
nowhere_reasonabandoned, duplicate, unwanted, ci_technical, unknown, NoneFor goes_nowhere rows: abandoned, duplicate, unwanted, ci_technical, or unknown (read, but no rule or classifier found a reason); null on merged rows and when the timeline was unreadable. An outcome, never a model input. Computed in pipelines/ingestion/repo_miner/merge_labels.py.
ci_fail_flaky_onlyboolean or nullTrue when the merge commit's required CI failure came only from checks flaky at merge time (3+ rerun-passes in the prior 90 days, rules.mining.flaky_detection); label_ci_fail is then False. Null when CI wasn't observed and on unmerged rows. An outcome detail, never a model input. Computed in pipelines/ingestion/repo_miner/flaky.py.
author_confirmed_maintainerboolean or nullThe PR author had merged or closed someone else's PR before this one opened, from the repo's timelines (proposal 2.2). author_association shows today's status and hides private org members, so this is what decides outside contributors. Null when no timelines were read. Computed in pipelines/ingestion/repo_miner/maintainers.py.
snapshot_weightnumber –11 / the number of kept snapshots of this PR, so each PR adds up to 1 in training and slow PRs with many snapshots don't dominate. Depends on the PR's whole history, so it is a training weight and never a model input.
moment_bucketopen, <1d, 1-3d, 3-7d, 7-30d, >30dTime band of the snapshot: open (the open trigger) or time since start, for reporting metrics per moment.
llm_diff_truncatedboolean or nullTrue when the LLM diff size cap dropped or cut code the model would have read; false when the whole diff was shown; null when no LLM call was made (off, skipped, empty or a reused answer). Metadata about the call, never a model input. Computed in pipelines/ingestion/repo_miner/features/llm_flags.py.
szz_window_closedboolean or nullTrue when the SZZ observation window for the PR has closed: szz_maturity_days (default 90) had passed between the PR's merge and the observation cutoff (observed_through), so a label_szz_bug of false is mature. False while the window is still open: a fix that would later be traced to this PR may not exist yet. Null when the SZZ label was not computed (SZZ off, an unmerged PR) or szz_maturity_days is 0 (no cap, so no window). Never a model input. Computed in pipelines/ingestion/repo_miner/labels.py.