{
  "slug": "flux-bootstrap-supports-sparse-checkout-c4335674ece6",
  "title": "flux bootstrap supports sparse checkout",
  "tools": [
    "flux"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-06-30T15:48:09.000Z",
  "announced_at": "2026-06-30T15:48:09.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When bootstrapping Flux from a monorepo, pass `--sparse-checkout` with comma-separated directories and include the directory given to `--path`.",
    "examples": [
      "flux bootstrap github --owner=<owner> --repository=<repository> --path=<path> --sparse-checkout=<path>,<directory>"
    ],
    "gotchas": [
      "Version: v2.9.0",
      "--sparse-checkout: Comma-separated directories included in the GitRepository sparse checkout; the configured `--path` must be one of them.",
      "--path (required): Bootstrap target path; include it in `--sparse-checkout`.",
      "--owner (required): GitHub repository owner.",
      "--repository (required): GitHub repository name.",
      "The `--path` directory must be included in the `--sparse-checkout` list.",
      "The flag applies to the `github`, `gitlab`, `gitea`, `git`, and `bitbucket-server` bootstrap providers."
    ]
  },
  "why_it_matters": "Bootstrap Flux from a large monorepo while limiting the directories checked out by Flux.",
  "sources": [
    "https://github.com/fluxcd/flux2/releases/tag/v2.9.0",
    "https://github.com/fluxcd/flux2/pull/5918",
    "https://v2-9.docs.fluxcd.io/flux/cmd/flux_bootstrap/",
    "https://v2-9.docs.fluxcd.io/flux/cmd/flux_bootstrap_github/"
  ],
  "rank": 0.97022,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-20261016",
    "verdict_id": "wave1b-20261016:wave1b-20261016-d4dc415b1cefd189-11:gate",
    "evidence_hash": "f719b7a3225a7a50dddebee9d2bbb46e454b3c63ab3b9d94dcabcba8747b984f"
  },
  "review": {
    "draft_hash": "81d26a4031aeca19cd07881161bb204d16635fbb1fa6c2d682d6a443f4e59a2f",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-20261016:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.81 (>= 0.6 needed)."
  }
}