[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-nvidia-jetson-build-source":3,"mdc-hdyg4s-key":34,"related-org-nvidia-jetson-build-source":3717,"related-repo-nvidia-jetson-build-source":3876},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":32,"mdContent":33},"jetson-build-source","rebuild Jetson BSP source components","Use when you need to rebuild the BSP overlay — DT, OOT modules, or kernel — from changes under bsp_sources\u002F. Triggers: build bsp, rebuild dtb, rebuild kernel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"nvidia","NVIDIA","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fnvidia.png",[12,16,19,20],{"name":13,"slug":14,"type":15},"Hardware","hardware","tag",{"name":17,"slug":18,"type":15},"Deployment","deployment",{"name":9,"slug":8,"type":15},{"name":21,"slug":22,"type":15},"Engineering","engineering",2473,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002Fskills","2026-07-14T05:27:15.223424","Apache-2.0",281,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":31},[],"AI agent skills published by NVIDIA","https:\u002F\u002Fgithub.com\u002FNVIDIA\u002Fskills\u002Ftree\u002FHEAD\u002Fskills\u002Fjetson-build-source","---\nname: jetson-build-source\ndescription: >-\n  Use when you need to rebuild the BSP overlay — DT, OOT modules,\n  or kernel — from changes under bsp_sources\u002F. Triggers: build\n  bsp, rebuild dtb, rebuild kernel.\nversion: 0.0.1\nlicense: \"Apache-2.0\"\nargument-hint: \"dt | oot | kernel | full\"\nmetadata:\n  data-classification: public\n  author: \"Jetson Team\"\n  team: pts\n  tags:\n    - bsp\n    - build\n  domain: meta\n---\n\n# Build BSP Source\n\n## Purpose\n\nRebuild the kernel-side artifacts (DTBs, OOT modules, in-tree\nmodules, kernel `Image`) implied by changes under\n`\u003Csource.root_path>\u002Fbsp_sources\u002F`, and write a manifest that\n`\u002Fjetson-promote-image` reads to stage those outputs into the BSP\nimage. The skill never writes into `\u003Cbsp_image.root_path>` itself.\n\n## Prerequisites\n\n- Active target-platform profile with `bsp_image:` and\n  `source.toolchain:` resolved (run `\u002Fjetson-init-image` and\n  `\u002Fjetson-init-source` first).\n- `\u003Csource.root_path>\u002Fbsp_sources\u002F` populated with the kernel-side\n  checkout layout `\u002Fjetson-init-source` materializes.\n- `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource\u002Fkernel_src_build_env.sh`\n  present (extracted from `public_sources.tbz2`).\n- Host packages: `flex`, `bison`, `libssl-dev` (hard); `git`,\n  `build-essential`, `bc`, `zstd` (warn-only).\n- Cross-toolchain at `${source.toolchain}gcc` resolvable on disk.\n\n## Overview\n\nThis skill is the **Build** stage of the workflow — see\n[`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md)\nfor where it sits in the Setup → Customize → Build → Deploy pipeline\nand what triggers it. The skill takes source-side customization\ncommits, rebuilds the implied artifacts, and records which were\nrebuilt in a manifest. Outputs stay in-tree under\n`\u003Csource.root_path>\u002Fbsp_sources\u002F`;\n[`jetson-promote-image`](..\u002Fjetson-promote-image\u002FSKILL.md) reads the\nmanifest at Deploy to copy each rebuilt artifact into the matching\npath under `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F`.\n\nOverlay-only edits (`nvpmodel.conf`, `nvfancontrol.conf`, BPMP DTB)\nskip Build — `customize-*` stages them directly to the overlay\ntracker; BPMP DTB uses the `dtc` decompile → edit → recompile loop in\n[`..\u002F..\u002Freferences\u002Fbsp-customization-bpmp-dtb.md`](..\u002F..\u002Freferences\u002Fbsp-customization-bpmp-dtb.md).\n\n**Custom-overlay slot ownership.** Kernel-DT customizations from\nevery customize-* skill collect into a single composite\n`tegra\u003Csoc>-\u003Ccarrier-id-sku>+\u003Cmodule-id>-xxxx-custom.dts` per\nactive target — see\n[`..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md`](..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md)\nfor the filename \u002F location \u002F append protocol. This skill is the\n**sole owner** of the composite's per-dir Makefile registration\n(`dtbo-y += \u003Cname>.dtbo`) and the carrier flash conf's\n`OVERLAY_DTB_FILE+=` line (the \"Register composite custom overlay\" step).\n\n**Four build modes** matched to the dirty-repo profile:\n\n| Mode | What's built | Auto-picks when |\n|---|---|---|\n| **dt** | NVIDIA DTBs only | only `hardware\u002Fnvidia\u002F*` or `kernel-devicetree` dirty |\n| **oot** | OOT modules (six repos) | only OOT repos dirty |\n| **kernel** | Kernel `Image` + full in-tree `.ko` set + kernel-side dtbs | only `kernel\u002F$KERNEL_SRC_DIR` dirty |\n| **full** | Everything above + optional install consolidation | mixed dirty set |\n\nMode selection: **auto** (default — invoke `\u002Fjetson-build-source`\nwith no argument) walks the dirty-repo set; force a specific mode\nby passing it as the skill argument.\n\n**Design principle: delegate to upstream.** Every build primitive\nalready exists in `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource\u002F`\n— the env file, top-level Makefile (`nvidia-dtbs` \u002F `modules` \u002F\n`modules_install`), kernel Makefile (`kernel` \u002F `install`). The\nskill drives those primitives against\n`\u003Csource.root_path>\u002Fbsp_sources\u002F` — never duplicates their\nlogic in shell.\n\n## When to invoke\n\n- **Auto-chained** at the end of a Customize `customize-*` invocation\n  whenever Customize committed to a kernel-side source repo.\n- **Manual re-run** via `\u002Fjetson-build-source [\u003Cmode>]` when:\n  - the auto-chained build was interrupted,\n  - source commits arrived via `git pull` from other users,\n  - the user wants to force a rebuild without a fresh edit,\n  - the user wants a specific mode (e.g. install consolidation for\n    a manual scp deploy to a DUT).\n\n## Instructions\n\n### Resolve active target + paths + upstream env\n\nResolve the active profile per\n[`..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md`](..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md).\nRefuse and route in these cases:\n\n| Condition | Route to |\n|---|---|\n| No active profile, or `active: NA` | `\u002Fjetson-set-target` or `\u002Fjetson-init-target` |\n| Profile lacks `bsp_image:` | `\u002Fjetson-init-image` |\n| Profile lacks `source.toolchain:` | `\u002Fjetson-init-source` |\n| `\u003Csource.root_path>\u002Fbsp_sources\u002F` missing or empty | `\u002Fjetson-init-source` |\n| `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource\u002Fkernel_src_build_env.sh` missing | `\u002Fjetson-init-image` (BSP not properly extracted) |\n\nBind:\n\n```bash\nWORKSPACE=\u003Cparent of target-platform\u002F>\nBSP_SRC=\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource   # NVIDIA's build primitives\nKS=\u003Csource.root_path>\u002Fbsp_sources                      # our kernel-side checkout\nKOUT=\u003Csource.root_path>\u002F.build\u002Fkernel-out              # DT-mode out-of-tree build dir\nSTAGE=\u003Csource.root_path>\u002F.build\u002Finstall-stage          # install consolidation (full mode \u002F opt-in)\nSTATE=\u003Csource.root_path>\u002F.build-state.yaml             # per-repo watermark\nMANIFEST=\u003Csource.root_path>\u002F.build-manifest.yaml       # rebuilt-artifact list for jetson-promote-image\n```\n\n**Source the NVIDIA build env** to inherit canonical names — never\nhardcode `kernel-noble`, the OOT module list, or `KERNEL_DEF_CONFIG`:\n\n```bash\nsource \"$BSP_SRC\u002Fkernel_src_build_env.sh\"\n# Now in scope: KERNEL_SRC_DIR (e.g. kernel-noble), KERNEL_DEF_CONFIG,\n# OOT_SOURCE_LIST, kernel_name (e.g. noble), KERNEL_MODULAR_BUILD\n```\n\nRefuse if `$KS\u002Fkernel\u002F$KERNEL_SRC_DIR\u002F` is missing or if any name\nin `$OOT_SOURCE_LIST` is missing under `$KS\u002F`. Route to\n`\u002Fjetson-init-source`.\n\n### Resolve toolchain (read-only)\n\nRead `source.toolchain` from the active profile (authored by\n`jetson-init-source`). Validate:\n\n```bash\nexport ARCH=arm64\nexport CROSS_COMPILE=\u003Csource.toolchain>   # trailing dash mandatory\n[ -f \"${CROSS_COMPILE}gcc\" ] || refuse \\\n  \"source.toolchain points at ${CROSS_COMPILE}gcc which does not exist. Re-run \u002Fjetson-init-source.\"\n```\n\nA trailing dash on `CROSS_COMPILE` is mandatory — kbuild treats it\nas a prefix (`${CROSS_COMPILE}gcc`); a missing dash breaks with\n`command not found`. The `[ -f ]` check catches it before any\n`make` runs.\n\nThis skill **never** prompts for the toolchain or attempts to\nresolve a missing one — that's `jetson-init-source`'s exclusive\nresponsibility. A missing field is a Setup gap; route there.\n\nVerify build-host prerequisites once:\n\n```bash\nfor p in flex bison libssl-dev; do\n  dpkg -s \"$p\" >\u002Fdev\u002Fnull 2>&1 || refuse \"host package missing: $p\"\ndone\nfor p in git build-essential bc zstd; do\n  dpkg -s \"$p\" >\u002Fdev\u002Fnull 2>&1 || warn \"host package missing: $p\"\ndone\n```\n\n### Detect dirty source repos\n\nThe watermark file `$STATE` records the last successfully built\ncommit per kernel-side repo. The repo list is derived at runtime\nfrom `OOT_SOURCE_LIST` + `kernel\u002F$KERNEL_SRC_DIR`. For each repo:\nHEAD ≠ watermark → dirty; uncommitted edits (`git diff --quiet`\nnon-zero) → also dirty.\n\n**Branch-A note**: when `bsp_sources\u002F` is one mono-repo with a\nsingle `.git`, every canonical sub-path shares the same HEAD —\nthe watermark schema still keys per-sub-path and the dirty set\nstill works (any change anywhere flips every sub-path's HEAD).\n\nIf `STATE` is absent (first build), treat all repos as clean\nunless the auto-chain context says \"Customize just committed\". If\n`DIRTY` is empty and no mode argument was passed: report\n\"nothing to build\" and return.\n\n### Pick build mode\n\nMap the dirty set to a mode (auto), or honor the mode argument:\n\n| Dirty repos (auto) | Mode |\n|---|---|\n| Only `hardware\u002Fnvidia\u002F*` or `kernel-devicetree` | `dt` |\n| Only OOT subset of `$OOT_SOURCE_LIST` | `oot` |\n| Only `kernel\u002F$KERNEL_SRC_DIR` | `kernel` |\n| Any mix spanning the above | `full` |\n\nModes are union-able: `full` runs `kernel` → `oot` → `dt` in that\norder (kernel produces headers OOT needs; `nvidia-dtbs` uses the\nsame generated headers). A manually passed mode argument skips\nauto-detection.\n\n### Execute build\n\n#### Common setup + per-mode build snippets\n\nCommon setup (validate orchestrator Makefiles, `cd $KS`) and the\nexact `make` invocations for each mode (`dt`, `oot`, `kernel`,\n`full`) plus the optional install consolidation pass live in\n[`references\u002Fbuild-modes.md`](references\u002Fbuild-modes.md). Drive\nthe relevant mode's snippet against the bindings from the\n\"Resolve active target + paths + upstream env\" step.\n\n#### Register composite custom overlay (dt + full only)\n\nSkip unless the selected mode is `dt` or `full`. The composite\noverlay slot is documented in\n[`..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md`](..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md);\nthis sub-step owns the build \u002F Makefile \u002F flash-conf side of it.\n\nResolve the composite path for the active target (`$COMPOSITE_BASE`,\n`$COMPOSITE_DTS`, `$COMPOSITE_MK`) using the active profile's\nchip family, carrier ID\u002FSKU, and module ID — full snippet in\n[`references\u002Fcomposite-registration.md`](references\u002Fcomposite-registration.md#path-resolution).\n\n**Gate (symmetric).** `$COMPOSITE_DTS` drives both directions:\npresent → apply the two idempotent patches below; absent → run the\n[cleanup pass](references\u002Fcomposite-registration.md#cleanup-pass-on-composite-removal)\nto strip any stale `dtbo-y +=` \u002F `OVERLAY_DTB_FILE+=` line from a\nprior run. Either path keeps `OVERLAY_DTB_FILE+=` from referencing\nan unbuilt `.dtbo` — the build-time enforcement of the\n[no-direct-in-tree-DT-edits rule](..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md#hard-rule-no-direct-in-tree-dts--dtsi-edits).\n\n1. **Per-dir Makefile** — append `dtbo-y += \u003Cname>.dtbo` after the\n   last *literal-named* `dtbo-y +=` entry. Inserting after the\n   `$(old-dtbo)` merge-back line skips the `$(addprefix\n   makefile-path\u002F,…)` prefix pass and the build silently drops\n   the composite. Commit to the `bsp_sources\u002F` mono-repo. Full\n   snippet + rationale:\n   [`references\u002Fcomposite-registration.md`](references\u002Fcomposite-registration.md#makefile-patch-idempotent-position-sensitive).\n2. **Carrier flash conf** — append `OVERLAY_DTB_FILE+=\",\u003Cname>.dtbo\"`\n   with first-touch pristine import on the overlay tracker. On a\n   fresh workspace the tracker is empty git-init; import the\n   conf from `bsp_image` and commit as `pristine:` *before* the\n   customization commit (workflow contract). Full snippet:\n   [`references\u002Fcomposite-registration.md`](references\u002Fcomposite-registration.md#flash-conf-patch-idempotent-with-first-touch-pristine-import).\n\nThe composite's parent sub-repo flipping HEAD during a customize-*\nappend is what the \"Detect dirty source repos\" step's dirty detection consumes — no extra\nbookkeeping needed here.\n\n**Self-check** before invoking `nvidia-dtbs`:\n\n```bash\ngrep -qxF \"dtbo-y += ${COMPOSITE_BASE}.dtbo\" \"$COMPOSITE_MK\" \\\n  || refuse \"Composite Makefile registration missing after patch.\"\ngrep -qxF \"$line\" \"$FLASH_CONF\" \\\n  || refuse \"Composite flash-conf registration missing after patch.\"\n```\n\n### Write the build manifest\n\nWalk the `DIRTY` set and emit a manifest entry per implied artifact,\nfollowing the **trace-to-dirty policy** — only artifacts traceable\nto a dirty source repo. Promoting baseline-divergence noise would\nattribute it to a customization's audit trail (forbidden).\n\nThe full source → kbuild → destination mapping, YAML schema, and\nfilter rules live in\n[`references\u002Fmanifest-schema.md`](references\u002Fmanifest-schema.md).\n\nAtomic write: stage to `${MANIFEST}.tmp`, then `mv -f`.\n\n### Update watermark + summary\n\nOn success, rewrite `$STATE` with the new per-repo HEADs, toolchain,\n`bsp_image.version`, and last-run mode (schema in\n[`references\u002Fmanifest-schema.md`](references\u002Fmanifest-schema.md)).\n\nReport:\n\n- Toolchain (from `source.toolchain`).\n- Build mode: `\u003Cdt|oot|kernel|full>` (auto-picked or forced by skill argument).\n- Dirty repos and their new HEADs.\n- Artifacts built: counts per kind (`.dtb`, in-tree `.ko`, OOT `.ko`, `Image`).\n- Manifest path + entry count.\n- Consolidated install stage path (if the \"Install consolidation\" step ran).\n- Next step: `\u002Fjetson-promote-image`.\n\nIf a Customize skill triggered this run, prompt the user to re-issue\ntheir original request.\n\n## Limitations\n\nThe top tier — failure modes that block a build or silently\nproduce wrong artifacts. See\n[`references\u002Flong-tail-gotchas.md`](references\u002Flong-tail-gotchas.md)\nfor invariants, deploy patterns, and performance hints.\n\n- **Toolchain resolution is `jetson-init-source`'s job.** This\n  skill only reads `source.toolchain` and exports `CROSS_COMPILE`.\n  Missing field → refuse and route, never resolve in-skill.\n- **R36.x Branch-A `$KS\u002FMakefile` collision.** R36.x's\n  `public_sources.tbz2` can leave the dGPU\u002FOpenRM proprietary\n  Makefile at `$KS\u002FMakefile` instead of the Tegra orchestrator;\n  its `modules` target recurses into `kernel-open\u002F` + `src\u002Fnvidia\u002F`,\n  pulls host `\u002Flib\u002Fmodules` headers, and breaks arm64 cross-builds\n  with `'-mlittle-endian' unrecognized`. R38+ extractions are\n  unaffected. `\u002Fjetson-init-source`'s step 3a is the primary defense\n  (extract-time); the \"Common setup\" check here is the safety net.\n  Don't relax the regex.\n- **Kernel-DT changes: composite-overlay-only, split ownership.**\n  Direct edits to in-tree `.dts` \u002F `.dtsi` files under `bsp_sources\u002F`\n  are forbidden for customize-\\* skills — every kernel-DT change\n  lands as a fragment in the composite overlay slot\n  ([rule + rationale](..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md#hard-rule-no-direct-in-tree-dts--dtsi-edits)).\n  The composite `.dts` *content* is owned by each customize-\\*\n  skill; the **build \u002F Makefile \u002F flash-conf registration** is\n  owned by this skill (gated on the composite `.dts` existing — so\n  `OVERLAY_DTB_FILE+=` can't reference an unbuilt `.dtbo`).\n- **the \"Register composite custom overlay\" step Makefile insertion point matters.** Insert after\n  the last *literal-named* `dtbo-y +=` entry; inserting after\n  `$(old-dtbo)` skips the `$(addprefix makefile-path\u002F,…)` prefix\n  pass and the build silently drops your `.dtbo`. The regex\n  `^dtbo-y *+= *[a-zA-Z0-9]` filters correctly; do not relax it.\n- **the \"Register composite custom overlay\" step first-touch needs pristine import.** On a fresh\n  workspace the overlay tracker is empty git-init — the carrier\n  flash conf is imported from `bsp_image` and committed as\n  `pristine:` *before* the customization commit. Both commits go\n  through the workflow acceptance gate.\n- **Avoid bare `$0` in shell snippets inside this SKILL.md.** When\n  invoked with an argument, the harness expands skill-body `$0`\n  against the caller's `$0` before handing the rendered prompt to\n  the model. Use sed-based line splicing or\n  `awk -v ROW=\"$0\"`. See\n  [`references\u002Fcomposite-registration.md`](references\u002Fcomposite-registration.md#why-sed-based-splicing-not-awk).\n- **No overlay staging.** Build outputs stay where the build put\n  them; the manifest is the contract to `jetson-promote-image`.\n  Deliberate divergence from the original overlay→promote\n  indirection — keeps the full build output set out of the\n  overlay tracker's git history.\n- **`KERNEL_HEADERS` vs `KERNEL_OUTPUT` in DT mode.** Different\n  semantics (srctree vs objtree); do not collapse. the \"DT-only\" step's\n  snippet is correct as written.\n- **OOT mode prereq: previously-built kernel headers.** A manual\n  `oot` invocation against a never-built tree refuses with \"run\n  `kernel` (or `full`) first\" rather than producing a confusing\n  build error.\n\n## Examples\n\nAuto-detect mode from the dirty source tree (typical invocation):\n\n```\n\u002Fjetson-build-source\n```\n\nForce a single mode (skips auto-detect):\n\n```\n\u002Fjetson-build-source dt       # rebuild NVIDIA DTBs only\n\u002Fjetson-build-source oot      # rebuild OOT modules only\n\u002Fjetson-build-source kernel   # rebuild kernel Image + in-tree modules\n\u002Fjetson-build-source full     # rebuild everything + install consolidation\n```\n\nTypical chain after a customize-* skill commits to a kernel-side\nrepo (the customize-* skill calls this automatically):\n\n```\n\u002Fjetson-customize-pcie ...   # commits to hardware\u002Fnvidia\u002F...\u002Fnv-public\n   ↓\n\u002Fjetson-build-source         # auto-picks `dt` from the dirty set\n   ↓\n\u002Fjetson-promote-image        # reads .build-manifest.yaml, stages into bsp_image\n   ↓\n\u002Fjetson-flash-image          # flashes\n```\n\n## Troubleshooting\n\n| Error | Cause | Solution |\n|---|---|---|\n| `source.toolchain points at \u003C...>gcc which does not exist` | Toolchain field stale (path moved, install missing) | Re-run `\u002Fjetson-init-source` to re-resolve. This skill never resolves toolchain itself. |\n| `No rule to make target '$KOUT\u002Fscripts\u002FMakefile.compiler'` | `KERNEL_HEADERS` set to `$KOUT` instead of `$KS\u002Fkernel\u002F$KERNEL_SRC_DIR` | Use the DT-mode snippet in [`references\u002Fbuild-modes.md`](references\u002Fbuild-modes.md) verbatim — srctree vs objtree must not collapse. |\n| `'-mlittle-endian' unrecognized` during `make modules` | R36.x Branch-A `$KS\u002FMakefile` collision — dGPU\u002FOpenRM Makefile in place of Tegra orchestrator | The Common-setup safety net normally repairs it; if not, `git checkout HEAD -- Makefile` then re-run `\u002Fjetson-init-source` step 3a. |\n| `run kernel (or full) first` on manual `oot` invocation | Kernel source tree never prepared | Run `\u002Fjetson-build-source kernel` (or `full`) once, then `oot`. |\n| `nothing to build` and dirty edits exist | Edits uncommitted in a sub-repo but `.build-state.yaml` watermark already matches HEAD | Commit the edits, or re-run with an explicit mode argument (`\u002Fjetson-build-source dt` etc.). |\n| Composite `.dtbo` silently missing from the output set | Per-dir Makefile insertion landed after `$(old-dtbo)` merge-back line | See [`references\u002Fcomposite-registration.md`](references\u002Fcomposite-registration.md#makefile-patch-idempotent-position-sensitive) — insert after the last *literal-named* `dtbo-y +=` entry. |\n| Promote step copies stale baseline artifacts | Trace-to-dirty filter skipped after a manual `cp` into `$KS` | Only edit via a customize-* skill or `git`; the dirty detector keys on git HEAD, not file mtime. |\n| `host package missing: \u003Cpkg>` | `flex`\u002F`bison`\u002F`libssl-dev` refuse; others warn. | `sudo apt install \u003Cpkg>` per [`references\u002Fupstream-recipe.md`](references\u002Fupstream-recipe.md). |\n\n## See also\n\n- [`references\u002Fbuild-modes.md`](references\u002Fbuild-modes.md) — per-mode `make` snippets + install consolidation.\n- [`references\u002Fmanifest-schema.md`](references\u002Fmanifest-schema.md) — `.build-manifest.yaml` + `.build-state.yaml` schemas.\n- [`references\u002Fcomposite-registration.md`](references\u002Fcomposite-registration.md) — the \"Register composite custom overlay\" step full snippets + rationale.\n- [`references\u002Flong-tail-gotchas.md`](references\u002Flong-tail-gotchas.md) — invariants, deploy patterns, performance hints.\n- [`references\u002Fupstream-recipe.md`](references\u002Fupstream-recipe.md) — verbatim NVIDIA recipe, divergences, spec status.\n- [`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md#workflow-invariants) — workspace edit protocol.\n- [`..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md`](..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md) — composite custom-overlay contract.\n- [`..\u002F..\u002Freferences\u002Fbsp-customization-bpmp-dtb.md`](..\u002F..\u002Freferences\u002Fbsp-customization-bpmp-dtb.md) — BPMP-DTB edit contract (routed around this skill).\n- [`..\u002Fjetson-init-source\u002FSKILL.md`](..\u002Fjetson-init-source\u002FSKILL.md) — Setup; authors `source.toolchain`.\n- [`..\u002Fjetson-promote-image\u002FSKILL.md`](..\u002Fjetson-promote-image\u002FSKILL.md) — Deploy promoter; reads this skill's manifest.\n",{"data":35,"body":46},{"name":4,"description":6,"version":36,"license":26,"argument-hint":37,"metadata":38},"0.0.1","dt | oot | kernel | full",{"data-classification":39,"author":40,"team":41,"tags":42,"domain":45},"public","Jetson Team","pts",[43,44],"bsp","build","meta",{"type":47,"children":48},"root",[49,58,65,104,110,258,264,316,362,414,424,578,598,661,667,736,742,749,765,902,907,1153,1179,1231,1266,1272,1293,1446,1490,1509,1514,1749,1755,1791,1817,1837,1843,1848,1953,1992,1998,2005,2061,2067,2095,2133,2194,2311,2316,2332,2488,2494,2513,2528,2548,2554,2583,2588,2673,2678,2684,2700,3092,3098,3103,3113,3118,3127,3132,3141,3147,3543,3549,3711],{"type":50,"tag":51,"props":52,"children":54},"element","h1",{"id":53},"build-bsp-source",[55],{"type":56,"value":57},"text","Build BSP Source",{"type":50,"tag":59,"props":60,"children":62},"h2",{"id":61},"purpose",[63],{"type":56,"value":64},"Purpose",{"type":50,"tag":66,"props":67,"children":68},"p",{},[69,71,78,80,86,88,94,96,102],{"type":56,"value":70},"Rebuild the kernel-side artifacts (DTBs, OOT modules, in-tree\nmodules, kernel ",{"type":50,"tag":72,"props":73,"children":75},"code",{"className":74},[],[76],{"type":56,"value":77},"Image",{"type":56,"value":79},") implied by changes under\n",{"type":50,"tag":72,"props":81,"children":83},{"className":82},[],[84],{"type":56,"value":85},"\u003Csource.root_path>\u002Fbsp_sources\u002F",{"type":56,"value":87},", and write a manifest that\n",{"type":50,"tag":72,"props":89,"children":91},{"className":90},[],[92],{"type":56,"value":93},"\u002Fjetson-promote-image",{"type":56,"value":95}," reads to stage those outputs into the BSP\nimage. The skill never writes into ",{"type":50,"tag":72,"props":97,"children":99},{"className":98},[],[100],{"type":56,"value":101},"\u003Cbsp_image.root_path>",{"type":56,"value":103}," itself.",{"type":50,"tag":59,"props":105,"children":107},{"id":106},"prerequisites",[108],{"type":56,"value":109},"Prerequisites",{"type":50,"tag":111,"props":112,"children":113},"ul",{},[114,151,168,187,245],{"type":50,"tag":115,"props":116,"children":117},"li",{},[118,120,126,128,134,136,142,143,149],{"type":56,"value":119},"Active target-platform profile with ",{"type":50,"tag":72,"props":121,"children":123},{"className":122},[],[124],{"type":56,"value":125},"bsp_image:",{"type":56,"value":127}," and\n",{"type":50,"tag":72,"props":129,"children":131},{"className":130},[],[132],{"type":56,"value":133},"source.toolchain:",{"type":56,"value":135}," resolved (run ",{"type":50,"tag":72,"props":137,"children":139},{"className":138},[],[140],{"type":56,"value":141},"\u002Fjetson-init-image",{"type":56,"value":127},{"type":50,"tag":72,"props":144,"children":146},{"className":145},[],[147],{"type":56,"value":148},"\u002Fjetson-init-source",{"type":56,"value":150}," first).",{"type":50,"tag":115,"props":152,"children":153},{},[154,159,161,166],{"type":50,"tag":72,"props":155,"children":157},{"className":156},[],[158],{"type":56,"value":85},{"type":56,"value":160}," populated with the kernel-side\ncheckout layout ",{"type":50,"tag":72,"props":162,"children":164},{"className":163},[],[165],{"type":56,"value":148},{"type":56,"value":167}," materializes.",{"type":50,"tag":115,"props":169,"children":170},{},[171,177,179,185],{"type":50,"tag":72,"props":172,"children":174},{"className":173},[],[175],{"type":56,"value":176},"\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource\u002Fkernel_src_build_env.sh",{"type":56,"value":178},"\npresent (extracted from ",{"type":50,"tag":72,"props":180,"children":182},{"className":181},[],[183],{"type":56,"value":184},"public_sources.tbz2",{"type":56,"value":186},").",{"type":50,"tag":115,"props":188,"children":189},{},[190,192,198,200,206,207,213,215,221,223,229,230,236,237,243],{"type":56,"value":191},"Host packages: ",{"type":50,"tag":72,"props":193,"children":195},{"className":194},[],[196],{"type":56,"value":197},"flex",{"type":56,"value":199},", ",{"type":50,"tag":72,"props":201,"children":203},{"className":202},[],[204],{"type":56,"value":205},"bison",{"type":56,"value":199},{"type":50,"tag":72,"props":208,"children":210},{"className":209},[],[211],{"type":56,"value":212},"libssl-dev",{"type":56,"value":214}," (hard); ",{"type":50,"tag":72,"props":216,"children":218},{"className":217},[],[219],{"type":56,"value":220},"git",{"type":56,"value":222},",\n",{"type":50,"tag":72,"props":224,"children":226},{"className":225},[],[227],{"type":56,"value":228},"build-essential",{"type":56,"value":199},{"type":50,"tag":72,"props":231,"children":233},{"className":232},[],[234],{"type":56,"value":235},"bc",{"type":56,"value":199},{"type":50,"tag":72,"props":238,"children":240},{"className":239},[],[241],{"type":56,"value":242},"zstd",{"type":56,"value":244}," (warn-only).",{"type":50,"tag":115,"props":246,"children":247},{},[248,250,256],{"type":56,"value":249},"Cross-toolchain at ",{"type":50,"tag":72,"props":251,"children":253},{"className":252},[],[254],{"type":56,"value":255},"${source.toolchain}gcc",{"type":56,"value":257}," resolvable on disk.",{"type":50,"tag":59,"props":259,"children":261},{"id":260},"overview",[262],{"type":56,"value":263},"Overview",{"type":50,"tag":66,"props":265,"children":266},{},[267,269,275,277,287,289,294,296,306,308,314],{"type":56,"value":268},"This skill is the ",{"type":50,"tag":270,"props":271,"children":272},"strong",{},[273],{"type":56,"value":274},"Build",{"type":56,"value":276}," stage of the workflow — see\n",{"type":50,"tag":278,"props":279,"children":281},"a",{"href":280},"..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md",[282],{"type":50,"tag":72,"props":283,"children":285},{"className":284},[],[286],{"type":56,"value":280},{"type":56,"value":288},"\nfor where it sits in the Setup → Customize → Build → Deploy pipeline\nand what triggers it. The skill takes source-side customization\ncommits, rebuilds the implied artifacts, and records which were\nrebuilt in a manifest. Outputs stay in-tree under\n",{"type":50,"tag":72,"props":290,"children":292},{"className":291},[],[293],{"type":56,"value":85},{"type":56,"value":295},";\n",{"type":50,"tag":278,"props":297,"children":299},{"href":298},"..\u002Fjetson-promote-image\u002FSKILL.md",[300],{"type":50,"tag":72,"props":301,"children":303},{"className":302},[],[304],{"type":56,"value":305},"jetson-promote-image",{"type":56,"value":307}," reads the\nmanifest at Deploy to copy each rebuilt artifact into the matching\npath under ",{"type":50,"tag":72,"props":309,"children":311},{"className":310},[],[312],{"type":56,"value":313},"\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F",{"type":56,"value":315},".",{"type":50,"tag":66,"props":317,"children":318},{},[319,321,327,328,334,336,342,344,350,352,361],{"type":56,"value":320},"Overlay-only edits (",{"type":50,"tag":72,"props":322,"children":324},{"className":323},[],[325],{"type":56,"value":326},"nvpmodel.conf",{"type":56,"value":199},{"type":50,"tag":72,"props":329,"children":331},{"className":330},[],[332],{"type":56,"value":333},"nvfancontrol.conf",{"type":56,"value":335},", BPMP DTB)\nskip Build — ",{"type":50,"tag":72,"props":337,"children":339},{"className":338},[],[340],{"type":56,"value":341},"customize-*",{"type":56,"value":343}," stages them directly to the overlay\ntracker; BPMP DTB uses the ",{"type":50,"tag":72,"props":345,"children":347},{"className":346},[],[348],{"type":56,"value":349},"dtc",{"type":56,"value":351}," decompile → edit → recompile loop in\n",{"type":50,"tag":278,"props":353,"children":355},{"href":354},"..\u002F..\u002Freferences\u002Fbsp-customization-bpmp-dtb.md",[356],{"type":50,"tag":72,"props":357,"children":359},{"className":358},[],[360],{"type":56,"value":354},{"type":56,"value":315},{"type":50,"tag":66,"props":363,"children":364},{},[365,370,372,378,380,389,391,396,398,404,406,412],{"type":50,"tag":270,"props":366,"children":367},{},[368],{"type":56,"value":369},"Custom-overlay slot ownership.",{"type":56,"value":371}," Kernel-DT customizations from\nevery customize-* skill collect into a single composite\n",{"type":50,"tag":72,"props":373,"children":375},{"className":374},[],[376],{"type":56,"value":377},"tegra\u003Csoc>-\u003Ccarrier-id-sku>+\u003Cmodule-id>-xxxx-custom.dts",{"type":56,"value":379}," per\nactive target — see\n",{"type":50,"tag":278,"props":381,"children":383},{"href":382},"..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md",[384],{"type":50,"tag":72,"props":385,"children":387},{"className":386},[],[388],{"type":56,"value":382},{"type":56,"value":390},"\nfor the filename \u002F location \u002F append protocol. This skill is the\n",{"type":50,"tag":270,"props":392,"children":393},{},[394],{"type":56,"value":395},"sole owner",{"type":56,"value":397}," of the composite's per-dir Makefile registration\n(",{"type":50,"tag":72,"props":399,"children":401},{"className":400},[],[402],{"type":56,"value":403},"dtbo-y += \u003Cname>.dtbo",{"type":56,"value":405},") and the carrier flash conf's\n",{"type":50,"tag":72,"props":407,"children":409},{"className":408},[],[410],{"type":56,"value":411},"OVERLAY_DTB_FILE+=",{"type":56,"value":413}," line (the \"Register composite custom overlay\" step).",{"type":50,"tag":66,"props":415,"children":416},{},[417,422],{"type":50,"tag":270,"props":418,"children":419},{},[420],{"type":56,"value":421},"Four build modes",{"type":56,"value":423}," matched to the dirty-repo profile:",{"type":50,"tag":425,"props":426,"children":427},"table",{},[428,452],{"type":50,"tag":429,"props":430,"children":431},"thead",{},[432],{"type":50,"tag":433,"props":434,"children":435},"tr",{},[436,442,447],{"type":50,"tag":437,"props":438,"children":439},"th",{},[440],{"type":56,"value":441},"Mode",{"type":50,"tag":437,"props":443,"children":444},{},[445],{"type":56,"value":446},"What's built",{"type":50,"tag":437,"props":448,"children":449},{},[450],{"type":56,"value":451},"Auto-picks when",{"type":50,"tag":453,"props":454,"children":455},"tbody",{},[456,494,515,557],{"type":50,"tag":433,"props":457,"children":458},{},[459,468,473],{"type":50,"tag":460,"props":461,"children":462},"td",{},[463],{"type":50,"tag":270,"props":464,"children":465},{},[466],{"type":56,"value":467},"dt",{"type":50,"tag":460,"props":469,"children":470},{},[471],{"type":56,"value":472},"NVIDIA DTBs only",{"type":50,"tag":460,"props":474,"children":475},{},[476,478,484,486,492],{"type":56,"value":477},"only ",{"type":50,"tag":72,"props":479,"children":481},{"className":480},[],[482],{"type":56,"value":483},"hardware\u002Fnvidia\u002F*",{"type":56,"value":485}," or ",{"type":50,"tag":72,"props":487,"children":489},{"className":488},[],[490],{"type":56,"value":491},"kernel-devicetree",{"type":56,"value":493}," dirty",{"type":50,"tag":433,"props":495,"children":496},{},[497,505,510],{"type":50,"tag":460,"props":498,"children":499},{},[500],{"type":50,"tag":270,"props":501,"children":502},{},[503],{"type":56,"value":504},"oot",{"type":50,"tag":460,"props":506,"children":507},{},[508],{"type":56,"value":509},"OOT modules (six repos)",{"type":50,"tag":460,"props":511,"children":512},{},[513],{"type":56,"value":514},"only OOT repos dirty",{"type":50,"tag":433,"props":516,"children":517},{},[518,526,546],{"type":50,"tag":460,"props":519,"children":520},{},[521],{"type":50,"tag":270,"props":522,"children":523},{},[524],{"type":56,"value":525},"kernel",{"type":50,"tag":460,"props":527,"children":528},{},[529,531,536,538,544],{"type":56,"value":530},"Kernel ",{"type":50,"tag":72,"props":532,"children":534},{"className":533},[],[535],{"type":56,"value":77},{"type":56,"value":537}," + full in-tree ",{"type":50,"tag":72,"props":539,"children":541},{"className":540},[],[542],{"type":56,"value":543},".ko",{"type":56,"value":545}," set + kernel-side dtbs",{"type":50,"tag":460,"props":547,"children":548},{},[549,550,556],{"type":56,"value":477},{"type":50,"tag":72,"props":551,"children":553},{"className":552},[],[554],{"type":56,"value":555},"kernel\u002F$KERNEL_SRC_DIR",{"type":56,"value":493},{"type":50,"tag":433,"props":558,"children":559},{},[560,568,573],{"type":50,"tag":460,"props":561,"children":562},{},[563],{"type":50,"tag":270,"props":564,"children":565},{},[566],{"type":56,"value":567},"full",{"type":50,"tag":460,"props":569,"children":570},{},[571],{"type":56,"value":572},"Everything above + optional install consolidation",{"type":50,"tag":460,"props":574,"children":575},{},[576],{"type":56,"value":577},"mixed dirty set",{"type":50,"tag":66,"props":579,"children":580},{},[581,583,588,590,596],{"type":56,"value":582},"Mode selection: ",{"type":50,"tag":270,"props":584,"children":585},{},[586],{"type":56,"value":587},"auto",{"type":56,"value":589}," (default — invoke ",{"type":50,"tag":72,"props":591,"children":593},{"className":592},[],[594],{"type":56,"value":595},"\u002Fjetson-build-source",{"type":56,"value":597},"\nwith no argument) walks the dirty-repo set; force a specific mode\nby passing it as the skill argument.",{"type":50,"tag":66,"props":599,"children":600},{},[601,606,608,614,616,622,624,630,632,638,640,645,646,652,654,659],{"type":50,"tag":270,"props":602,"children":603},{},[604],{"type":56,"value":605},"Design principle: delegate to upstream.",{"type":56,"value":607}," Every build primitive\nalready exists in ",{"type":50,"tag":72,"props":609,"children":611},{"className":610},[],[612],{"type":56,"value":613},"\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource\u002F",{"type":56,"value":615},"\n— the env file, top-level Makefile (",{"type":50,"tag":72,"props":617,"children":619},{"className":618},[],[620],{"type":56,"value":621},"nvidia-dtbs",{"type":56,"value":623}," \u002F ",{"type":50,"tag":72,"props":625,"children":627},{"className":626},[],[628],{"type":56,"value":629},"modules",{"type":56,"value":631}," \u002F\n",{"type":50,"tag":72,"props":633,"children":635},{"className":634},[],[636],{"type":56,"value":637},"modules_install",{"type":56,"value":639},"), kernel Makefile (",{"type":50,"tag":72,"props":641,"children":643},{"className":642},[],[644],{"type":56,"value":525},{"type":56,"value":623},{"type":50,"tag":72,"props":647,"children":649},{"className":648},[],[650],{"type":56,"value":651},"install",{"type":56,"value":653},"). The\nskill drives those primitives against\n",{"type":50,"tag":72,"props":655,"children":657},{"className":656},[],[658],{"type":56,"value":85},{"type":56,"value":660}," — never duplicates their\nlogic in shell.",{"type":50,"tag":59,"props":662,"children":664},{"id":663},"when-to-invoke",[665],{"type":56,"value":666},"When to invoke",{"type":50,"tag":111,"props":668,"children":669},{},[670,687],{"type":50,"tag":115,"props":671,"children":672},{},[673,678,680,685],{"type":50,"tag":270,"props":674,"children":675},{},[676],{"type":56,"value":677},"Auto-chained",{"type":56,"value":679}," at the end of a Customize ",{"type":50,"tag":72,"props":681,"children":683},{"className":682},[],[684],{"type":56,"value":341},{"type":56,"value":686}," invocation\nwhenever Customize committed to a kernel-side source repo.",{"type":50,"tag":115,"props":688,"children":689},{},[690,695,697,703,705],{"type":50,"tag":270,"props":691,"children":692},{},[693],{"type":56,"value":694},"Manual re-run",{"type":56,"value":696}," via ",{"type":50,"tag":72,"props":698,"children":700},{"className":699},[],[701],{"type":56,"value":702},"\u002Fjetson-build-source [\u003Cmode>]",{"type":56,"value":704}," when:\n",{"type":50,"tag":111,"props":706,"children":707},{},[708,713,726,731],{"type":50,"tag":115,"props":709,"children":710},{},[711],{"type":56,"value":712},"the auto-chained build was interrupted,",{"type":50,"tag":115,"props":714,"children":715},{},[716,718,724],{"type":56,"value":717},"source commits arrived via ",{"type":50,"tag":72,"props":719,"children":721},{"className":720},[],[722],{"type":56,"value":723},"git pull",{"type":56,"value":725}," from other users,",{"type":50,"tag":115,"props":727,"children":728},{},[729],{"type":56,"value":730},"the user wants to force a rebuild without a fresh edit,",{"type":50,"tag":115,"props":732,"children":733},{},[734],{"type":56,"value":735},"the user wants a specific mode (e.g. install consolidation for\na manual scp deploy to a DUT).",{"type":50,"tag":59,"props":737,"children":739},{"id":738},"instructions",[740],{"type":56,"value":741},"Instructions",{"type":50,"tag":743,"props":744,"children":746},"h3",{"id":745},"resolve-active-target-paths-upstream-env",[747],{"type":56,"value":748},"Resolve active target + paths + upstream env",{"type":50,"tag":66,"props":750,"children":751},{},[752,754,763],{"type":56,"value":753},"Resolve the active profile per\n",{"type":50,"tag":278,"props":755,"children":757},{"href":756},"..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md",[758],{"type":50,"tag":72,"props":759,"children":761},{"className":760},[],[762],{"type":56,"value":756},{"type":56,"value":764},".\nRefuse and route in these cases:",{"type":50,"tag":425,"props":766,"children":767},{},[768,784],{"type":50,"tag":429,"props":769,"children":770},{},[771],{"type":50,"tag":433,"props":772,"children":773},{},[774,779],{"type":50,"tag":437,"props":775,"children":776},{},[777],{"type":56,"value":778},"Condition",{"type":50,"tag":437,"props":780,"children":781},{},[782],{"type":56,"value":783},"Route to",{"type":50,"tag":453,"props":785,"children":786},{},[787,817,838,858,879],{"type":50,"tag":433,"props":788,"children":789},{},[790,801],{"type":50,"tag":460,"props":791,"children":792},{},[793,795],{"type":56,"value":794},"No active profile, or ",{"type":50,"tag":72,"props":796,"children":798},{"className":797},[],[799],{"type":56,"value":800},"active: NA",{"type":50,"tag":460,"props":802,"children":803},{},[804,810,811],{"type":50,"tag":72,"props":805,"children":807},{"className":806},[],[808],{"type":56,"value":809},"\u002Fjetson-set-target",{"type":56,"value":485},{"type":50,"tag":72,"props":812,"children":814},{"className":813},[],[815],{"type":56,"value":816},"\u002Fjetson-init-target",{"type":50,"tag":433,"props":818,"children":819},{},[820,830],{"type":50,"tag":460,"props":821,"children":822},{},[823,825],{"type":56,"value":824},"Profile lacks ",{"type":50,"tag":72,"props":826,"children":828},{"className":827},[],[829],{"type":56,"value":125},{"type":50,"tag":460,"props":831,"children":832},{},[833],{"type":50,"tag":72,"props":834,"children":836},{"className":835},[],[837],{"type":56,"value":141},{"type":50,"tag":433,"props":839,"children":840},{},[841,850],{"type":50,"tag":460,"props":842,"children":843},{},[844,845],{"type":56,"value":824},{"type":50,"tag":72,"props":846,"children":848},{"className":847},[],[849],{"type":56,"value":133},{"type":50,"tag":460,"props":851,"children":852},{},[853],{"type":50,"tag":72,"props":854,"children":856},{"className":855},[],[857],{"type":56,"value":148},{"type":50,"tag":433,"props":859,"children":860},{},[861,871],{"type":50,"tag":460,"props":862,"children":863},{},[864,869],{"type":50,"tag":72,"props":865,"children":867},{"className":866},[],[868],{"type":56,"value":85},{"type":56,"value":870}," missing or empty",{"type":50,"tag":460,"props":872,"children":873},{},[874],{"type":50,"tag":72,"props":875,"children":877},{"className":876},[],[878],{"type":56,"value":148},{"type":50,"tag":433,"props":880,"children":881},{},[882,892],{"type":50,"tag":460,"props":883,"children":884},{},[885,890],{"type":50,"tag":72,"props":886,"children":888},{"className":887},[],[889],{"type":56,"value":176},{"type":56,"value":891}," missing",{"type":50,"tag":460,"props":893,"children":894},{},[895,900],{"type":50,"tag":72,"props":896,"children":898},{"className":897},[],[899],{"type":56,"value":141},{"type":56,"value":901}," (BSP not properly extracted)",{"type":50,"tag":66,"props":903,"children":904},{},[905],{"type":56,"value":906},"Bind:",{"type":50,"tag":908,"props":909,"children":914},"pre",{"className":910,"code":911,"language":912,"meta":913,"style":913},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","WORKSPACE=\u003Cparent of target-platform\u002F>\nBSP_SRC=\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002Fsource   # NVIDIA's build primitives\nKS=\u003Csource.root_path>\u002Fbsp_sources                      # our kernel-side checkout\nKOUT=\u003Csource.root_path>\u002F.build\u002Fkernel-out              # DT-mode out-of-tree build dir\nSTAGE=\u003Csource.root_path>\u002F.build\u002Finstall-stage          # install consolidation (full mode \u002F opt-in)\nSTATE=\u003Csource.root_path>\u002F.build-state.yaml             # per-repo watermark\nMANIFEST=\u003Csource.root_path>\u002F.build-manifest.yaml       # rebuilt-artifact list for jetson-promote-image\n","bash","",[915],{"type":50,"tag":72,"props":916,"children":917},{"__ignoreMap":913},[918,963,997,1029,1060,1091,1122],{"type":50,"tag":919,"props":920,"children":923},"span",{"class":921,"line":922},"line",1,[924,930,936,942,948,953,958],{"type":50,"tag":919,"props":925,"children":927},{"style":926},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[928],{"type":56,"value":929},"WORKSPACE",{"type":50,"tag":919,"props":931,"children":933},{"style":932},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[934],{"type":56,"value":935},"=\u003C",{"type":50,"tag":919,"props":937,"children":939},{"style":938},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[940],{"type":56,"value":941},"parent",{"type":50,"tag":919,"props":943,"children":945},{"style":944},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[946],{"type":56,"value":947}," of",{"type":50,"tag":919,"props":949,"children":950},{"style":938},[951],{"type":56,"value":952}," target-platform",{"type":50,"tag":919,"props":954,"children":955},{"style":926},[956],{"type":56,"value":957},"\u002F",{"type":50,"tag":919,"props":959,"children":960},{"style":932},[961],{"type":56,"value":962},">\n",{"type":50,"tag":919,"props":964,"children":966},{"class":921,"line":965},2,[967,972,976,981,986,991],{"type":50,"tag":919,"props":968,"children":969},{"style":926},[970],{"type":56,"value":971},"BSP_SRC",{"type":50,"tag":919,"props":973,"children":974},{"style":932},[975],{"type":56,"value":935},{"type":50,"tag":919,"props":977,"children":978},{"style":938},[979],{"type":56,"value":980},"bsp_image.root_path",{"type":50,"tag":919,"props":982,"children":983},{"style":932},[984],{"type":56,"value":985},">",{"type":50,"tag":919,"props":987,"children":988},{"style":938},[989],{"type":56,"value":990},"\u002FLinux_for_Tegra\u002Fsource",{"type":50,"tag":919,"props":992,"children":994},{"style":993},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[995],{"type":56,"value":996},"   # NVIDIA's build primitives\n",{"type":50,"tag":919,"props":998,"children":1000},{"class":921,"line":999},3,[1001,1006,1010,1015,1019,1024],{"type":50,"tag":919,"props":1002,"children":1003},{"style":926},[1004],{"type":56,"value":1005},"KS",{"type":50,"tag":919,"props":1007,"children":1008},{"style":932},[1009],{"type":56,"value":935},{"type":50,"tag":919,"props":1011,"children":1012},{"style":938},[1013],{"type":56,"value":1014},"source.root_path",{"type":50,"tag":919,"props":1016,"children":1017},{"style":932},[1018],{"type":56,"value":985},{"type":50,"tag":919,"props":1020,"children":1021},{"style":938},[1022],{"type":56,"value":1023},"\u002Fbsp_sources",{"type":50,"tag":919,"props":1025,"children":1026},{"style":993},[1027],{"type":56,"value":1028},"                      # our kernel-side checkout\n",{"type":50,"tag":919,"props":1030,"children":1032},{"class":921,"line":1031},4,[1033,1038,1042,1046,1050,1055],{"type":50,"tag":919,"props":1034,"children":1035},{"style":926},[1036],{"type":56,"value":1037},"KOUT",{"type":50,"tag":919,"props":1039,"children":1040},{"style":932},[1041],{"type":56,"value":935},{"type":50,"tag":919,"props":1043,"children":1044},{"style":938},[1045],{"type":56,"value":1014},{"type":50,"tag":919,"props":1047,"children":1048},{"style":932},[1049],{"type":56,"value":985},{"type":50,"tag":919,"props":1051,"children":1052},{"style":938},[1053],{"type":56,"value":1054},"\u002F.build\u002Fkernel-out",{"type":50,"tag":919,"props":1056,"children":1057},{"style":993},[1058],{"type":56,"value":1059},"              # DT-mode out-of-tree build dir\n",{"type":50,"tag":919,"props":1061,"children":1063},{"class":921,"line":1062},5,[1064,1069,1073,1077,1081,1086],{"type":50,"tag":919,"props":1065,"children":1066},{"style":926},[1067],{"type":56,"value":1068},"STAGE",{"type":50,"tag":919,"props":1070,"children":1071},{"style":932},[1072],{"type":56,"value":935},{"type":50,"tag":919,"props":1074,"children":1075},{"style":938},[1076],{"type":56,"value":1014},{"type":50,"tag":919,"props":1078,"children":1079},{"style":932},[1080],{"type":56,"value":985},{"type":50,"tag":919,"props":1082,"children":1083},{"style":938},[1084],{"type":56,"value":1085},"\u002F.build\u002Finstall-stage",{"type":50,"tag":919,"props":1087,"children":1088},{"style":993},[1089],{"type":56,"value":1090},"          # install consolidation (full mode \u002F opt-in)\n",{"type":50,"tag":919,"props":1092,"children":1094},{"class":921,"line":1093},6,[1095,1100,1104,1108,1112,1117],{"type":50,"tag":919,"props":1096,"children":1097},{"style":926},[1098],{"type":56,"value":1099},"STATE",{"type":50,"tag":919,"props":1101,"children":1102},{"style":932},[1103],{"type":56,"value":935},{"type":50,"tag":919,"props":1105,"children":1106},{"style":938},[1107],{"type":56,"value":1014},{"type":50,"tag":919,"props":1109,"children":1110},{"style":932},[1111],{"type":56,"value":985},{"type":50,"tag":919,"props":1113,"children":1114},{"style":938},[1115],{"type":56,"value":1116},"\u002F.build-state.yaml",{"type":50,"tag":919,"props":1118,"children":1119},{"style":993},[1120],{"type":56,"value":1121},"             # per-repo watermark\n",{"type":50,"tag":919,"props":1123,"children":1125},{"class":921,"line":1124},7,[1126,1131,1135,1139,1143,1148],{"type":50,"tag":919,"props":1127,"children":1128},{"style":926},[1129],{"type":56,"value":1130},"MANIFEST",{"type":50,"tag":919,"props":1132,"children":1133},{"style":932},[1134],{"type":56,"value":935},{"type":50,"tag":919,"props":1136,"children":1137},{"style":938},[1138],{"type":56,"value":1014},{"type":50,"tag":919,"props":1140,"children":1141},{"style":932},[1142],{"type":56,"value":985},{"type":50,"tag":919,"props":1144,"children":1145},{"style":938},[1146],{"type":56,"value":1147},"\u002F.build-manifest.yaml",{"type":50,"tag":919,"props":1149,"children":1150},{"style":993},[1151],{"type":56,"value":1152},"       # rebuilt-artifact list for jetson-promote-image\n",{"type":50,"tag":66,"props":1154,"children":1155},{},[1156,1161,1163,1169,1171,1177],{"type":50,"tag":270,"props":1157,"children":1158},{},[1159],{"type":56,"value":1160},"Source the NVIDIA build env",{"type":56,"value":1162}," to inherit canonical names — never\nhardcode ",{"type":50,"tag":72,"props":1164,"children":1166},{"className":1165},[],[1167],{"type":56,"value":1168},"kernel-noble",{"type":56,"value":1170},", the OOT module list, or ",{"type":50,"tag":72,"props":1172,"children":1174},{"className":1173},[],[1175],{"type":56,"value":1176},"KERNEL_DEF_CONFIG",{"type":56,"value":1178},":",{"type":50,"tag":908,"props":1180,"children":1182},{"className":910,"code":1181,"language":912,"meta":913,"style":913},"source \"$BSP_SRC\u002Fkernel_src_build_env.sh\"\n# Now in scope: KERNEL_SRC_DIR (e.g. kernel-noble), KERNEL_DEF_CONFIG,\n# OOT_SOURCE_LIST, kernel_name (e.g. noble), KERNEL_MODULAR_BUILD\n",[1183],{"type":50,"tag":72,"props":1184,"children":1185},{"__ignoreMap":913},[1186,1215,1223],{"type":50,"tag":919,"props":1187,"children":1188},{"class":921,"line":922},[1189,1195,1200,1205,1210],{"type":50,"tag":919,"props":1190,"children":1192},{"style":1191},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[1193],{"type":56,"value":1194},"source",{"type":50,"tag":919,"props":1196,"children":1197},{"style":932},[1198],{"type":56,"value":1199}," \"",{"type":50,"tag":919,"props":1201,"children":1202},{"style":926},[1203],{"type":56,"value":1204},"$BSP_SRC",{"type":50,"tag":919,"props":1206,"children":1207},{"style":938},[1208],{"type":56,"value":1209},"\u002Fkernel_src_build_env.sh",{"type":50,"tag":919,"props":1211,"children":1212},{"style":932},[1213],{"type":56,"value":1214},"\"\n",{"type":50,"tag":919,"props":1216,"children":1217},{"class":921,"line":965},[1218],{"type":50,"tag":919,"props":1219,"children":1220},{"style":993},[1221],{"type":56,"value":1222},"# Now in scope: KERNEL_SRC_DIR (e.g. kernel-noble), KERNEL_DEF_CONFIG,\n",{"type":50,"tag":919,"props":1224,"children":1225},{"class":921,"line":999},[1226],{"type":50,"tag":919,"props":1227,"children":1228},{"style":993},[1229],{"type":56,"value":1230},"# OOT_SOURCE_LIST, kernel_name (e.g. noble), KERNEL_MODULAR_BUILD\n",{"type":50,"tag":66,"props":1232,"children":1233},{},[1234,1236,1242,1244,1250,1252,1258,1260,1265],{"type":56,"value":1235},"Refuse if ",{"type":50,"tag":72,"props":1237,"children":1239},{"className":1238},[],[1240],{"type":56,"value":1241},"$KS\u002Fkernel\u002F$KERNEL_SRC_DIR\u002F",{"type":56,"value":1243}," is missing or if any name\nin ",{"type":50,"tag":72,"props":1245,"children":1247},{"className":1246},[],[1248],{"type":56,"value":1249},"$OOT_SOURCE_LIST",{"type":56,"value":1251}," is missing under ",{"type":50,"tag":72,"props":1253,"children":1255},{"className":1254},[],[1256],{"type":56,"value":1257},"$KS\u002F",{"type":56,"value":1259},". Route to\n",{"type":50,"tag":72,"props":1261,"children":1263},{"className":1262},[],[1264],{"type":56,"value":148},{"type":56,"value":315},{"type":50,"tag":743,"props":1267,"children":1269},{"id":1268},"resolve-toolchain-read-only",[1270],{"type":56,"value":1271},"Resolve toolchain (read-only)",{"type":50,"tag":66,"props":1273,"children":1274},{},[1275,1277,1283,1285,1291],{"type":56,"value":1276},"Read ",{"type":50,"tag":72,"props":1278,"children":1280},{"className":1279},[],[1281],{"type":56,"value":1282},"source.toolchain",{"type":56,"value":1284}," from the active profile (authored by\n",{"type":50,"tag":72,"props":1286,"children":1288},{"className":1287},[],[1289],{"type":56,"value":1290},"jetson-init-source",{"type":56,"value":1292},"). Validate:",{"type":50,"tag":908,"props":1294,"children":1296},{"className":910,"code":1295,"language":912,"meta":913,"style":913},"export ARCH=arm64\nexport CROSS_COMPILE=\u003Csource.toolchain>   # trailing dash mandatory\n[ -f \"${CROSS_COMPILE}gcc\" ] || refuse \\\n  \"source.toolchain points at ${CROSS_COMPILE}gcc which does not exist. Re-run \u002Fjetson-init-source.\"\n",[1297],{"type":50,"tag":72,"props":1298,"children":1299},{"__ignoreMap":913},[1300,1324,1353,1411],{"type":50,"tag":919,"props":1301,"children":1302},{"class":921,"line":922},[1303,1309,1314,1319],{"type":50,"tag":919,"props":1304,"children":1306},{"style":1305},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[1307],{"type":56,"value":1308},"export",{"type":50,"tag":919,"props":1310,"children":1311},{"style":926},[1312],{"type":56,"value":1313}," ARCH",{"type":50,"tag":919,"props":1315,"children":1316},{"style":932},[1317],{"type":56,"value":1318},"=",{"type":50,"tag":919,"props":1320,"children":1321},{"style":926},[1322],{"type":56,"value":1323},"arm64\n",{"type":50,"tag":919,"props":1325,"children":1326},{"class":921,"line":965},[1327,1331,1336,1340,1344,1348],{"type":50,"tag":919,"props":1328,"children":1329},{"style":1305},[1330],{"type":56,"value":1308},{"type":50,"tag":919,"props":1332,"children":1333},{"style":926},[1334],{"type":56,"value":1335}," CROSS_COMPILE",{"type":50,"tag":919,"props":1337,"children":1338},{"style":932},[1339],{"type":56,"value":935},{"type":50,"tag":919,"props":1341,"children":1342},{"style":926},[1343],{"type":56,"value":1282},{"type":50,"tag":919,"props":1345,"children":1346},{"style":932},[1347],{"type":56,"value":985},{"type":50,"tag":919,"props":1349,"children":1350},{"style":993},[1351],{"type":56,"value":1352},"   # trailing dash mandatory\n",{"type":50,"tag":919,"props":1354,"children":1355},{"class":921,"line":999},[1356,1361,1366,1371,1376,1381,1386,1391,1396,1401,1406],{"type":50,"tag":919,"props":1357,"children":1358},{"style":932},[1359],{"type":56,"value":1360},"[",{"type":50,"tag":919,"props":1362,"children":1363},{"style":932},[1364],{"type":56,"value":1365}," -f",{"type":50,"tag":919,"props":1367,"children":1368},{"style":932},[1369],{"type":56,"value":1370}," \"${",{"type":50,"tag":919,"props":1372,"children":1373},{"style":926},[1374],{"type":56,"value":1375},"CROSS_COMPILE",{"type":50,"tag":919,"props":1377,"children":1378},{"style":932},[1379],{"type":56,"value":1380},"}",{"type":50,"tag":919,"props":1382,"children":1383},{"style":938},[1384],{"type":56,"value":1385},"gcc",{"type":50,"tag":919,"props":1387,"children":1388},{"style":932},[1389],{"type":56,"value":1390},"\"",{"type":50,"tag":919,"props":1392,"children":1393},{"style":932},[1394],{"type":56,"value":1395}," ]",{"type":50,"tag":919,"props":1397,"children":1398},{"style":932},[1399],{"type":56,"value":1400}," ||",{"type":50,"tag":919,"props":1402,"children":1403},{"style":944},[1404],{"type":56,"value":1405}," refuse",{"type":50,"tag":919,"props":1407,"children":1408},{"style":926},[1409],{"type":56,"value":1410}," \\\n",{"type":50,"tag":919,"props":1412,"children":1413},{"class":921,"line":1031},[1414,1419,1424,1429,1433,1437,1442],{"type":50,"tag":919,"props":1415,"children":1416},{"style":932},[1417],{"type":56,"value":1418},"  \"",{"type":50,"tag":919,"props":1420,"children":1421},{"style":938},[1422],{"type":56,"value":1423},"source.toolchain points at ",{"type":50,"tag":919,"props":1425,"children":1426},{"style":932},[1427],{"type":56,"value":1428},"${",{"type":50,"tag":919,"props":1430,"children":1431},{"style":926},[1432],{"type":56,"value":1375},{"type":50,"tag":919,"props":1434,"children":1435},{"style":932},[1436],{"type":56,"value":1380},{"type":50,"tag":919,"props":1438,"children":1439},{"style":938},[1440],{"type":56,"value":1441},"gcc which does not exist. Re-run \u002Fjetson-init-source.",{"type":50,"tag":919,"props":1443,"children":1444},{"style":932},[1445],{"type":56,"value":1214},{"type":50,"tag":66,"props":1447,"children":1448},{},[1449,1451,1456,1458,1464,1466,1472,1474,1480,1482,1488],{"type":56,"value":1450},"A trailing dash on ",{"type":50,"tag":72,"props":1452,"children":1454},{"className":1453},[],[1455],{"type":56,"value":1375},{"type":56,"value":1457}," is mandatory — kbuild treats it\nas a prefix (",{"type":50,"tag":72,"props":1459,"children":1461},{"className":1460},[],[1462],{"type":56,"value":1463},"${CROSS_COMPILE}gcc",{"type":56,"value":1465},"); a missing dash breaks with\n",{"type":50,"tag":72,"props":1467,"children":1469},{"className":1468},[],[1470],{"type":56,"value":1471},"command not found",{"type":56,"value":1473},". The ",{"type":50,"tag":72,"props":1475,"children":1477},{"className":1476},[],[1478],{"type":56,"value":1479},"[ -f ]",{"type":56,"value":1481}," check catches it before any\n",{"type":50,"tag":72,"props":1483,"children":1485},{"className":1484},[],[1486],{"type":56,"value":1487},"make",{"type":56,"value":1489}," runs.",{"type":50,"tag":66,"props":1491,"children":1492},{},[1493,1495,1500,1502,1507],{"type":56,"value":1494},"This skill ",{"type":50,"tag":270,"props":1496,"children":1497},{},[1498],{"type":56,"value":1499},"never",{"type":56,"value":1501}," prompts for the toolchain or attempts to\nresolve a missing one — that's ",{"type":50,"tag":72,"props":1503,"children":1505},{"className":1504},[],[1506],{"type":56,"value":1290},{"type":56,"value":1508},"'s exclusive\nresponsibility. A missing field is a Setup gap; route there.",{"type":50,"tag":66,"props":1510,"children":1511},{},[1512],{"type":56,"value":1513},"Verify build-host prerequisites once:",{"type":50,"tag":908,"props":1515,"children":1517},{"className":910,"code":1516,"language":912,"meta":913,"style":913},"for p in flex bison libssl-dev; do\n  dpkg -s \"$p\" >\u002Fdev\u002Fnull 2>&1 || refuse \"host package missing: $p\"\ndone\nfor p in git build-essential bc zstd; do\n  dpkg -s \"$p\" >\u002Fdev\u002Fnull 2>&1 || warn \"host package missing: $p\"\ndone\n",[1518],{"type":50,"tag":72,"props":1519,"children":1520},{"__ignoreMap":913},[1521,1565,1631,1639,1682,1742],{"type":50,"tag":919,"props":1522,"children":1523},{"class":921,"line":922},[1524,1530,1535,1540,1545,1550,1555,1560],{"type":50,"tag":919,"props":1525,"children":1527},{"style":1526},"--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic",[1528],{"type":56,"value":1529},"for",{"type":50,"tag":919,"props":1531,"children":1532},{"style":926},[1533],{"type":56,"value":1534}," p ",{"type":50,"tag":919,"props":1536,"children":1537},{"style":1526},[1538],{"type":56,"value":1539},"in",{"type":50,"tag":919,"props":1541,"children":1542},{"style":938},[1543],{"type":56,"value":1544}," flex",{"type":50,"tag":919,"props":1546,"children":1547},{"style":938},[1548],{"type":56,"value":1549}," bison",{"type":50,"tag":919,"props":1551,"children":1552},{"style":938},[1553],{"type":56,"value":1554}," libssl-dev",{"type":50,"tag":919,"props":1556,"children":1557},{"style":932},[1558],{"type":56,"value":1559},";",{"type":50,"tag":919,"props":1561,"children":1562},{"style":1526},[1563],{"type":56,"value":1564}," do\n",{"type":50,"tag":919,"props":1566,"children":1567},{"class":921,"line":965},[1568,1573,1578,1582,1587,1591,1596,1601,1606,1610,1614,1618,1623,1627],{"type":50,"tag":919,"props":1569,"children":1570},{"style":944},[1571],{"type":56,"value":1572},"  dpkg",{"type":50,"tag":919,"props":1574,"children":1575},{"style":938},[1576],{"type":56,"value":1577}," -s",{"type":50,"tag":919,"props":1579,"children":1580},{"style":932},[1581],{"type":56,"value":1199},{"type":50,"tag":919,"props":1583,"children":1584},{"style":926},[1585],{"type":56,"value":1586},"$p",{"type":50,"tag":919,"props":1588,"children":1589},{"style":932},[1590],{"type":56,"value":1390},{"type":50,"tag":919,"props":1592,"children":1593},{"style":932},[1594],{"type":56,"value":1595}," >",{"type":50,"tag":919,"props":1597,"children":1598},{"style":938},[1599],{"type":56,"value":1600},"\u002Fdev\u002Fnull",{"type":50,"tag":919,"props":1602,"children":1603},{"style":932},[1604],{"type":56,"value":1605}," 2>&1",{"type":50,"tag":919,"props":1607,"children":1608},{"style":932},[1609],{"type":56,"value":1400},{"type":50,"tag":919,"props":1611,"children":1612},{"style":944},[1613],{"type":56,"value":1405},{"type":50,"tag":919,"props":1615,"children":1616},{"style":932},[1617],{"type":56,"value":1199},{"type":50,"tag":919,"props":1619,"children":1620},{"style":938},[1621],{"type":56,"value":1622},"host package missing: ",{"type":50,"tag":919,"props":1624,"children":1625},{"style":926},[1626],{"type":56,"value":1586},{"type":50,"tag":919,"props":1628,"children":1629},{"style":932},[1630],{"type":56,"value":1214},{"type":50,"tag":919,"props":1632,"children":1633},{"class":921,"line":999},[1634],{"type":50,"tag":919,"props":1635,"children":1636},{"style":1526},[1637],{"type":56,"value":1638},"done\n",{"type":50,"tag":919,"props":1640,"children":1641},{"class":921,"line":1031},[1642,1646,1650,1654,1659,1664,1669,1674,1678],{"type":50,"tag":919,"props":1643,"children":1644},{"style":1526},[1645],{"type":56,"value":1529},{"type":50,"tag":919,"props":1647,"children":1648},{"style":926},[1649],{"type":56,"value":1534},{"type":50,"tag":919,"props":1651,"children":1652},{"style":1526},[1653],{"type":56,"value":1539},{"type":50,"tag":919,"props":1655,"children":1656},{"style":938},[1657],{"type":56,"value":1658}," git",{"type":50,"tag":919,"props":1660,"children":1661},{"style":938},[1662],{"type":56,"value":1663}," build-essential",{"type":50,"tag":919,"props":1665,"children":1666},{"style":938},[1667],{"type":56,"value":1668}," bc",{"type":50,"tag":919,"props":1670,"children":1671},{"style":938},[1672],{"type":56,"value":1673}," zstd",{"type":50,"tag":919,"props":1675,"children":1676},{"style":932},[1677],{"type":56,"value":1559},{"type":50,"tag":919,"props":1679,"children":1680},{"style":1526},[1681],{"type":56,"value":1564},{"type":50,"tag":919,"props":1683,"children":1684},{"class":921,"line":1062},[1685,1689,1693,1697,1701,1705,1709,1713,1717,1721,1726,1730,1734,1738],{"type":50,"tag":919,"props":1686,"children":1687},{"style":944},[1688],{"type":56,"value":1572},{"type":50,"tag":919,"props":1690,"children":1691},{"style":938},[1692],{"type":56,"value":1577},{"type":50,"tag":919,"props":1694,"children":1695},{"style":932},[1696],{"type":56,"value":1199},{"type":50,"tag":919,"props":1698,"children":1699},{"style":926},[1700],{"type":56,"value":1586},{"type":50,"tag":919,"props":1702,"children":1703},{"style":932},[1704],{"type":56,"value":1390},{"type":50,"tag":919,"props":1706,"children":1707},{"style":932},[1708],{"type":56,"value":1595},{"type":50,"tag":919,"props":1710,"children":1711},{"style":938},[1712],{"type":56,"value":1600},{"type":50,"tag":919,"props":1714,"children":1715},{"style":932},[1716],{"type":56,"value":1605},{"type":50,"tag":919,"props":1718,"children":1719},{"style":932},[1720],{"type":56,"value":1400},{"type":50,"tag":919,"props":1722,"children":1723},{"style":944},[1724],{"type":56,"value":1725}," warn",{"type":50,"tag":919,"props":1727,"children":1728},{"style":932},[1729],{"type":56,"value":1199},{"type":50,"tag":919,"props":1731,"children":1732},{"style":938},[1733],{"type":56,"value":1622},{"type":50,"tag":919,"props":1735,"children":1736},{"style":926},[1737],{"type":56,"value":1586},{"type":50,"tag":919,"props":1739,"children":1740},{"style":932},[1741],{"type":56,"value":1214},{"type":50,"tag":919,"props":1743,"children":1744},{"class":921,"line":1093},[1745],{"type":50,"tag":919,"props":1746,"children":1747},{"style":1526},[1748],{"type":56,"value":1638},{"type":50,"tag":743,"props":1750,"children":1752},{"id":1751},"detect-dirty-source-repos",[1753],{"type":56,"value":1754},"Detect dirty source repos",{"type":50,"tag":66,"props":1756,"children":1757},{},[1758,1760,1766,1768,1774,1776,1781,1783,1789],{"type":56,"value":1759},"The watermark file ",{"type":50,"tag":72,"props":1761,"children":1763},{"className":1762},[],[1764],{"type":56,"value":1765},"$STATE",{"type":56,"value":1767}," records the last successfully built\ncommit per kernel-side repo. The repo list is derived at runtime\nfrom ",{"type":50,"tag":72,"props":1769,"children":1771},{"className":1770},[],[1772],{"type":56,"value":1773},"OOT_SOURCE_LIST",{"type":56,"value":1775}," + ",{"type":50,"tag":72,"props":1777,"children":1779},{"className":1778},[],[1780],{"type":56,"value":555},{"type":56,"value":1782},". For each repo:\nHEAD ≠ watermark → dirty; uncommitted edits (",{"type":50,"tag":72,"props":1784,"children":1786},{"className":1785},[],[1787],{"type":56,"value":1788},"git diff --quiet",{"type":56,"value":1790},"\nnon-zero) → also dirty.",{"type":50,"tag":66,"props":1792,"children":1793},{},[1794,1799,1801,1807,1809,1815],{"type":50,"tag":270,"props":1795,"children":1796},{},[1797],{"type":56,"value":1798},"Branch-A note",{"type":56,"value":1800},": when ",{"type":50,"tag":72,"props":1802,"children":1804},{"className":1803},[],[1805],{"type":56,"value":1806},"bsp_sources\u002F",{"type":56,"value":1808}," is one mono-repo with a\nsingle ",{"type":50,"tag":72,"props":1810,"children":1812},{"className":1811},[],[1813],{"type":56,"value":1814},".git",{"type":56,"value":1816},", every canonical sub-path shares the same HEAD —\nthe watermark schema still keys per-sub-path and the dirty set\nstill works (any change anywhere flips every sub-path's HEAD).",{"type":50,"tag":66,"props":1818,"children":1819},{},[1820,1822,1827,1829,1835],{"type":56,"value":1821},"If ",{"type":50,"tag":72,"props":1823,"children":1825},{"className":1824},[],[1826],{"type":56,"value":1099},{"type":56,"value":1828}," is absent (first build), treat all repos as clean\nunless the auto-chain context says \"Customize just committed\". If\n",{"type":50,"tag":72,"props":1830,"children":1832},{"className":1831},[],[1833],{"type":56,"value":1834},"DIRTY",{"type":56,"value":1836}," is empty and no mode argument was passed: report\n\"nothing to build\" and return.",{"type":50,"tag":743,"props":1838,"children":1840},{"id":1839},"pick-build-mode",[1841],{"type":56,"value":1842},"Pick build mode",{"type":50,"tag":66,"props":1844,"children":1845},{},[1846],{"type":56,"value":1847},"Map the dirty set to a mode (auto), or honor the mode argument:",{"type":50,"tag":425,"props":1849,"children":1850},{},[1851,1866],{"type":50,"tag":429,"props":1852,"children":1853},{},[1854],{"type":50,"tag":433,"props":1855,"children":1856},{},[1857,1862],{"type":50,"tag":437,"props":1858,"children":1859},{},[1860],{"type":56,"value":1861},"Dirty repos (auto)",{"type":50,"tag":437,"props":1863,"children":1864},{},[1865],{"type":56,"value":441},{"type":50,"tag":453,"props":1867,"children":1868},{},[1869,1896,1917,1937],{"type":50,"tag":433,"props":1870,"children":1871},{},[1872,1888],{"type":50,"tag":460,"props":1873,"children":1874},{},[1875,1877,1882,1883],{"type":56,"value":1876},"Only ",{"type":50,"tag":72,"props":1878,"children":1880},{"className":1879},[],[1881],{"type":56,"value":483},{"type":56,"value":485},{"type":50,"tag":72,"props":1884,"children":1886},{"className":1885},[],[1887],{"type":56,"value":491},{"type":50,"tag":460,"props":1889,"children":1890},{},[1891],{"type":50,"tag":72,"props":1892,"children":1894},{"className":1893},[],[1895],{"type":56,"value":467},{"type":50,"tag":433,"props":1897,"children":1898},{},[1899,1909],{"type":50,"tag":460,"props":1900,"children":1901},{},[1902,1904],{"type":56,"value":1903},"Only OOT subset of ",{"type":50,"tag":72,"props":1905,"children":1907},{"className":1906},[],[1908],{"type":56,"value":1249},{"type":50,"tag":460,"props":1910,"children":1911},{},[1912],{"type":50,"tag":72,"props":1913,"children":1915},{"className":1914},[],[1916],{"type":56,"value":504},{"type":50,"tag":433,"props":1918,"children":1919},{},[1920,1929],{"type":50,"tag":460,"props":1921,"children":1922},{},[1923,1924],{"type":56,"value":1876},{"type":50,"tag":72,"props":1925,"children":1927},{"className":1926},[],[1928],{"type":56,"value":555},{"type":50,"tag":460,"props":1930,"children":1931},{},[1932],{"type":50,"tag":72,"props":1933,"children":1935},{"className":1934},[],[1936],{"type":56,"value":525},{"type":50,"tag":433,"props":1938,"children":1939},{},[1940,1945],{"type":50,"tag":460,"props":1941,"children":1942},{},[1943],{"type":56,"value":1944},"Any mix spanning the above",{"type":50,"tag":460,"props":1946,"children":1947},{},[1948],{"type":50,"tag":72,"props":1949,"children":1951},{"className":1950},[],[1952],{"type":56,"value":567},{"type":50,"tag":66,"props":1954,"children":1955},{},[1956,1958,1963,1965,1970,1972,1977,1978,1983,1985,1990],{"type":56,"value":1957},"Modes are union-able: ",{"type":50,"tag":72,"props":1959,"children":1961},{"className":1960},[],[1962],{"type":56,"value":567},{"type":56,"value":1964}," runs ",{"type":50,"tag":72,"props":1966,"children":1968},{"className":1967},[],[1969],{"type":56,"value":525},{"type":56,"value":1971}," → ",{"type":50,"tag":72,"props":1973,"children":1975},{"className":1974},[],[1976],{"type":56,"value":504},{"type":56,"value":1971},{"type":50,"tag":72,"props":1979,"children":1981},{"className":1980},[],[1982],{"type":56,"value":467},{"type":56,"value":1984}," in that\norder (kernel produces headers OOT needs; ",{"type":50,"tag":72,"props":1986,"children":1988},{"className":1987},[],[1989],{"type":56,"value":621},{"type":56,"value":1991}," uses the\nsame generated headers). A manually passed mode argument skips\nauto-detection.",{"type":50,"tag":743,"props":1993,"children":1995},{"id":1994},"execute-build",[1996],{"type":56,"value":1997},"Execute build",{"type":50,"tag":1999,"props":2000,"children":2002},"h4",{"id":2001},"common-setup-per-mode-build-snippets",[2003],{"type":56,"value":2004},"Common setup + per-mode build snippets",{"type":50,"tag":66,"props":2006,"children":2007},{},[2008,2010,2016,2018,2023,2025,2030,2031,2036,2037,2042,2043,2048,2050,2059],{"type":56,"value":2009},"Common setup (validate orchestrator Makefiles, ",{"type":50,"tag":72,"props":2011,"children":2013},{"className":2012},[],[2014],{"type":56,"value":2015},"cd $KS",{"type":56,"value":2017},") and the\nexact ",{"type":50,"tag":72,"props":2019,"children":2021},{"className":2020},[],[2022],{"type":56,"value":1487},{"type":56,"value":2024}," invocations for each mode (",{"type":50,"tag":72,"props":2026,"children":2028},{"className":2027},[],[2029],{"type":56,"value":467},{"type":56,"value":199},{"type":50,"tag":72,"props":2032,"children":2034},{"className":2033},[],[2035],{"type":56,"value":504},{"type":56,"value":199},{"type":50,"tag":72,"props":2038,"children":2040},{"className":2039},[],[2041],{"type":56,"value":525},{"type":56,"value":222},{"type":50,"tag":72,"props":2044,"children":2046},{"className":2045},[],[2047],{"type":56,"value":567},{"type":56,"value":2049},") plus the optional install consolidation pass live in\n",{"type":50,"tag":278,"props":2051,"children":2053},{"href":2052},"references\u002Fbuild-modes.md",[2054],{"type":50,"tag":72,"props":2055,"children":2057},{"className":2056},[],[2058],{"type":56,"value":2052},{"type":56,"value":2060},". Drive\nthe relevant mode's snippet against the bindings from the\n\"Resolve active target + paths + upstream env\" step.",{"type":50,"tag":1999,"props":2062,"children":2064},{"id":2063},"register-composite-custom-overlay-dt-full-only",[2065],{"type":56,"value":2066},"Register composite custom overlay (dt + full only)",{"type":50,"tag":66,"props":2068,"children":2069},{},[2070,2072,2077,2078,2083,2085,2093],{"type":56,"value":2071},"Skip unless the selected mode is ",{"type":50,"tag":72,"props":2073,"children":2075},{"className":2074},[],[2076],{"type":56,"value":467},{"type":56,"value":485},{"type":50,"tag":72,"props":2079,"children":2081},{"className":2080},[],[2082],{"type":56,"value":567},{"type":56,"value":2084},". The composite\noverlay slot is documented in\n",{"type":50,"tag":278,"props":2086,"children":2087},{"href":382},[2088],{"type":50,"tag":72,"props":2089,"children":2091},{"className":2090},[],[2092],{"type":56,"value":382},{"type":56,"value":2094},";\nthis sub-step owns the build \u002F Makefile \u002F flash-conf side of it.",{"type":50,"tag":66,"props":2096,"children":2097},{},[2098,2100,2106,2107,2113,2114,2120,2122,2132],{"type":56,"value":2099},"Resolve the composite path for the active target (",{"type":50,"tag":72,"props":2101,"children":2103},{"className":2102},[],[2104],{"type":56,"value":2105},"$COMPOSITE_BASE",{"type":56,"value":222},{"type":50,"tag":72,"props":2108,"children":2110},{"className":2109},[],[2111],{"type":56,"value":2112},"$COMPOSITE_DTS",{"type":56,"value":199},{"type":50,"tag":72,"props":2115,"children":2117},{"className":2116},[],[2118],{"type":56,"value":2119},"$COMPOSITE_MK",{"type":56,"value":2121},") using the active profile's\nchip family, carrier ID\u002FSKU, and module ID — full snippet in\n",{"type":50,"tag":278,"props":2123,"children":2125},{"href":2124},"references\u002Fcomposite-registration.md#path-resolution",[2126],{"type":50,"tag":72,"props":2127,"children":2129},{"className":2128},[],[2130],{"type":56,"value":2131},"references\u002Fcomposite-registration.md",{"type":56,"value":315},{"type":50,"tag":66,"props":2134,"children":2135},{},[2136,2141,2143,2148,2150,2156,2158,2164,2165,2170,2172,2177,2179,2185,2187,2193],{"type":50,"tag":270,"props":2137,"children":2138},{},[2139],{"type":56,"value":2140},"Gate (symmetric).",{"type":56,"value":2142}," ",{"type":50,"tag":72,"props":2144,"children":2146},{"className":2145},[],[2147],{"type":56,"value":2112},{"type":56,"value":2149}," drives both directions:\npresent → apply the two idempotent patches below; absent → run the\n",{"type":50,"tag":278,"props":2151,"children":2153},{"href":2152},"references\u002Fcomposite-registration.md#cleanup-pass-on-composite-removal",[2154],{"type":56,"value":2155},"cleanup pass",{"type":56,"value":2157},"\nto strip any stale ",{"type":50,"tag":72,"props":2159,"children":2161},{"className":2160},[],[2162],{"type":56,"value":2163},"dtbo-y +=",{"type":56,"value":623},{"type":50,"tag":72,"props":2166,"children":2168},{"className":2167},[],[2169],{"type":56,"value":411},{"type":56,"value":2171}," line from a\nprior run. Either path keeps ",{"type":50,"tag":72,"props":2173,"children":2175},{"className":2174},[],[2176],{"type":56,"value":411},{"type":56,"value":2178}," from referencing\nan unbuilt ",{"type":50,"tag":72,"props":2180,"children":2182},{"className":2181},[],[2183],{"type":56,"value":2184},".dtbo",{"type":56,"value":2186}," — the build-time enforcement of the\n",{"type":50,"tag":278,"props":2188,"children":2190},{"href":2189},"..\u002F..\u002Freferences\u002Fbsp-customization-kernel-dtb.md#hard-rule-no-direct-in-tree-dts--dtsi-edits",[2191],{"type":56,"value":2192},"no-direct-in-tree-DT-edits rule",{"type":56,"value":315},{"type":50,"tag":2195,"props":2196,"children":2197},"ol",{},[2198,2262],{"type":50,"tag":115,"props":2199,"children":2200},{},[2201,2206,2208,2213,2215,2221,2222,2227,2229,2235,2237,2243,2245,2250,2252,2261],{"type":50,"tag":270,"props":2202,"children":2203},{},[2204],{"type":56,"value":2205},"Per-dir Makefile",{"type":56,"value":2207}," — append ",{"type":50,"tag":72,"props":2209,"children":2211},{"className":2210},[],[2212],{"type":56,"value":403},{"type":56,"value":2214}," after the\nlast ",{"type":50,"tag":2216,"props":2217,"children":2218},"em",{},[2219],{"type":56,"value":2220},"literal-named",{"type":56,"value":2142},{"type":50,"tag":72,"props":2223,"children":2225},{"className":2224},[],[2226],{"type":56,"value":2163},{"type":56,"value":2228}," entry. Inserting after the\n",{"type":50,"tag":72,"props":2230,"children":2232},{"className":2231},[],[2233],{"type":56,"value":2234},"$(old-dtbo)",{"type":56,"value":2236}," merge-back line skips the ",{"type":50,"tag":72,"props":2238,"children":2240},{"className":2239},[],[2241],{"type":56,"value":2242},"$(addprefix makefile-path\u002F,…)",{"type":56,"value":2244}," prefix pass and the build silently drops\nthe composite. Commit to the ",{"type":50,"tag":72,"props":2246,"children":2248},{"className":2247},[],[2249],{"type":56,"value":1806},{"type":56,"value":2251}," mono-repo. Full\nsnippet + rationale:\n",{"type":50,"tag":278,"props":2253,"children":2255},{"href":2254},"references\u002Fcomposite-registration.md#makefile-patch-idempotent-position-sensitive",[2256],{"type":50,"tag":72,"props":2257,"children":2259},{"className":2258},[],[2260],{"type":56,"value":2131},{"type":56,"value":315},{"type":50,"tag":115,"props":2263,"children":2264},{},[2265,2270,2271,2277,2279,2285,2287,2293,2294,2299,2301,2310],{"type":50,"tag":270,"props":2266,"children":2267},{},[2268],{"type":56,"value":2269},"Carrier flash conf",{"type":56,"value":2207},{"type":50,"tag":72,"props":2272,"children":2274},{"className":2273},[],[2275],{"type":56,"value":2276},"OVERLAY_DTB_FILE+=\",\u003Cname>.dtbo\"",{"type":56,"value":2278},"\nwith first-touch pristine import on the overlay tracker. On a\nfresh workspace the tracker is empty git-init; import the\nconf from ",{"type":50,"tag":72,"props":2280,"children":2282},{"className":2281},[],[2283],{"type":56,"value":2284},"bsp_image",{"type":56,"value":2286}," and commit as ",{"type":50,"tag":72,"props":2288,"children":2290},{"className":2289},[],[2291],{"type":56,"value":2292},"pristine:",{"type":56,"value":2142},{"type":50,"tag":2216,"props":2295,"children":2296},{},[2297],{"type":56,"value":2298},"before",{"type":56,"value":2300}," the\ncustomization commit (workflow contract). Full snippet:\n",{"type":50,"tag":278,"props":2302,"children":2304},{"href":2303},"references\u002Fcomposite-registration.md#flash-conf-patch-idempotent-with-first-touch-pristine-import",[2305],{"type":50,"tag":72,"props":2306,"children":2308},{"className":2307},[],[2309],{"type":56,"value":2131},{"type":56,"value":315},{"type":50,"tag":66,"props":2312,"children":2313},{},[2314],{"type":56,"value":2315},"The composite's parent sub-repo flipping HEAD during a customize-*\nappend is what the \"Detect dirty source repos\" step's dirty detection consumes — no extra\nbookkeeping needed here.",{"type":50,"tag":66,"props":2317,"children":2318},{},[2319,2324,2326,2331],{"type":50,"tag":270,"props":2320,"children":2321},{},[2322],{"type":56,"value":2323},"Self-check",{"type":56,"value":2325}," before invoking ",{"type":50,"tag":72,"props":2327,"children":2329},{"className":2328},[],[2330],{"type":56,"value":621},{"type":56,"value":1178},{"type":50,"tag":908,"props":2333,"children":2335},{"className":910,"code":2334,"language":912,"meta":913,"style":913},"grep -qxF \"dtbo-y += ${COMPOSITE_BASE}.dtbo\" \"$COMPOSITE_MK\" \\\n  || refuse \"Composite Makefile registration missing after patch.\"\ngrep -qxF \"$line\" \"$FLASH_CONF\" \\\n  || refuse \"Composite flash-conf registration missing after patch.\"\n",[2336],{"type":50,"tag":72,"props":2337,"children":2338},{"__ignoreMap":913},[2339,2398,2423,2464],{"type":50,"tag":919,"props":2340,"children":2341},{"class":921,"line":922},[2342,2347,2352,2356,2361,2365,2370,2374,2378,2382,2386,2390,2394],{"type":50,"tag":919,"props":2343,"children":2344},{"style":944},[2345],{"type":56,"value":2346},"grep",{"type":50,"tag":919,"props":2348,"children":2349},{"style":938},[2350],{"type":56,"value":2351}," -qxF",{"type":50,"tag":919,"props":2353,"children":2354},{"style":932},[2355],{"type":56,"value":1199},{"type":50,"tag":919,"props":2357,"children":2358},{"style":938},[2359],{"type":56,"value":2360},"dtbo-y += ",{"type":50,"tag":919,"props":2362,"children":2363},{"style":932},[2364],{"type":56,"value":1428},{"type":50,"tag":919,"props":2366,"children":2367},{"style":926},[2368],{"type":56,"value":2369},"COMPOSITE_BASE",{"type":50,"tag":919,"props":2371,"children":2372},{"style":932},[2373],{"type":56,"value":1380},{"type":50,"tag":919,"props":2375,"children":2376},{"style":938},[2377],{"type":56,"value":2184},{"type":50,"tag":919,"props":2379,"children":2380},{"style":932},[2381],{"type":56,"value":1390},{"type":50,"tag":919,"props":2383,"children":2384},{"style":932},[2385],{"type":56,"value":1199},{"type":50,"tag":919,"props":2387,"children":2388},{"style":926},[2389],{"type":56,"value":2119},{"type":50,"tag":919,"props":2391,"children":2392},{"style":932},[2393],{"type":56,"value":1390},{"type":50,"tag":919,"props":2395,"children":2396},{"style":926},[2397],{"type":56,"value":1410},{"type":50,"tag":919,"props":2399,"children":2400},{"class":921,"line":965},[2401,2406,2410,2414,2419],{"type":50,"tag":919,"props":2402,"children":2403},{"style":932},[2404],{"type":56,"value":2405},"  ||",{"type":50,"tag":919,"props":2407,"children":2408},{"style":944},[2409],{"type":56,"value":1405},{"type":50,"tag":919,"props":2411,"children":2412},{"style":932},[2413],{"type":56,"value":1199},{"type":50,"tag":919,"props":2415,"children":2416},{"style":938},[2417],{"type":56,"value":2418},"Composite Makefile registration missing after patch.",{"type":50,"tag":919,"props":2420,"children":2421},{"style":932},[2422],{"type":56,"value":1214},{"type":50,"tag":919,"props":2424,"children":2425},{"class":921,"line":999},[2426,2430,2434,2438,2443,2447,2451,2456,2460],{"type":50,"tag":919,"props":2427,"children":2428},{"style":944},[2429],{"type":56,"value":2346},{"type":50,"tag":919,"props":2431,"children":2432},{"style":938},[2433],{"type":56,"value":2351},{"type":50,"tag":919,"props":2435,"children":2436},{"style":932},[2437],{"type":56,"value":1199},{"type":50,"tag":919,"props":2439,"children":2440},{"style":926},[2441],{"type":56,"value":2442},"$line",{"type":50,"tag":919,"props":2444,"children":2445},{"style":932},[2446],{"type":56,"value":1390},{"type":50,"tag":919,"props":2448,"children":2449},{"style":932},[2450],{"type":56,"value":1199},{"type":50,"tag":919,"props":2452,"children":2453},{"style":926},[2454],{"type":56,"value":2455},"$FLASH_CONF",{"type":50,"tag":919,"props":2457,"children":2458},{"style":932},[2459],{"type":56,"value":1390},{"type":50,"tag":919,"props":2461,"children":2462},{"style":926},[2463],{"type":56,"value":1410},{"type":50,"tag":919,"props":2465,"children":2466},{"class":921,"line":1031},[2467,2471,2475,2479,2484],{"type":50,"tag":919,"props":2468,"children":2469},{"style":932},[2470],{"type":56,"value":2405},{"type":50,"tag":919,"props":2472,"children":2473},{"style":944},[2474],{"type":56,"value":1405},{"type":50,"tag":919,"props":2476,"children":2477},{"style":932},[2478],{"type":56,"value":1199},{"type":50,"tag":919,"props":2480,"children":2481},{"style":938},[2482],{"type":56,"value":2483},"Composite flash-conf registration missing after patch.",{"type":50,"tag":919,"props":2485,"children":2486},{"style":932},[2487],{"type":56,"value":1214},{"type":50,"tag":743,"props":2489,"children":2491},{"id":2490},"write-the-build-manifest",[2492],{"type":56,"value":2493},"Write the build manifest",{"type":50,"tag":66,"props":2495,"children":2496},{},[2497,2499,2504,2506,2511],{"type":56,"value":2498},"Walk the ",{"type":50,"tag":72,"props":2500,"children":2502},{"className":2501},[],[2503],{"type":56,"value":1834},{"type":56,"value":2505}," set and emit a manifest entry per implied artifact,\nfollowing the ",{"type":50,"tag":270,"props":2507,"children":2508},{},[2509],{"type":56,"value":2510},"trace-to-dirty policy",{"type":56,"value":2512}," — only artifacts traceable\nto a dirty source repo. Promoting baseline-divergence noise would\nattribute it to a customization's audit trail (forbidden).",{"type":50,"tag":66,"props":2514,"children":2515},{},[2516,2518,2527],{"type":56,"value":2517},"The full source → kbuild → destination mapping, YAML schema, and\nfilter rules live in\n",{"type":50,"tag":278,"props":2519,"children":2521},{"href":2520},"references\u002Fmanifest-schema.md",[2522],{"type":50,"tag":72,"props":2523,"children":2525},{"className":2524},[],[2526],{"type":56,"value":2520},{"type":56,"value":315},{"type":50,"tag":66,"props":2529,"children":2530},{},[2531,2533,2539,2541,2547],{"type":56,"value":2532},"Atomic write: stage to ",{"type":50,"tag":72,"props":2534,"children":2536},{"className":2535},[],[2537],{"type":56,"value":2538},"${MANIFEST}.tmp",{"type":56,"value":2540},", then ",{"type":50,"tag":72,"props":2542,"children":2544},{"className":2543},[],[2545],{"type":56,"value":2546},"mv -f",{"type":56,"value":315},{"type":50,"tag":743,"props":2549,"children":2551},{"id":2550},"update-watermark-summary",[2552],{"type":56,"value":2553},"Update watermark + summary",{"type":50,"tag":66,"props":2555,"children":2556},{},[2557,2559,2564,2566,2572,2574,2582],{"type":56,"value":2558},"On success, rewrite ",{"type":50,"tag":72,"props":2560,"children":2562},{"className":2561},[],[2563],{"type":56,"value":1765},{"type":56,"value":2565}," with the new per-repo HEADs, toolchain,\n",{"type":50,"tag":72,"props":2567,"children":2569},{"className":2568},[],[2570],{"type":56,"value":2571},"bsp_image.version",{"type":56,"value":2573},", and last-run mode (schema in\n",{"type":50,"tag":278,"props":2575,"children":2576},{"href":2520},[2577],{"type":50,"tag":72,"props":2578,"children":2580},{"className":2579},[],[2581],{"type":56,"value":2520},{"type":56,"value":186},{"type":50,"tag":66,"props":2584,"children":2585},{},[2586],{"type":56,"value":2587},"Report:",{"type":50,"tag":111,"props":2589,"children":2590},{},[2591,2602,2615,2620,2652,2657,2662],{"type":50,"tag":115,"props":2592,"children":2593},{},[2594,2596,2601],{"type":56,"value":2595},"Toolchain (from ",{"type":50,"tag":72,"props":2597,"children":2599},{"className":2598},[],[2600],{"type":56,"value":1282},{"type":56,"value":186},{"type":50,"tag":115,"props":2603,"children":2604},{},[2605,2607,2613],{"type":56,"value":2606},"Build mode: ",{"type":50,"tag":72,"props":2608,"children":2610},{"className":2609},[],[2611],{"type":56,"value":2612},"\u003Cdt|oot|kernel|full>",{"type":56,"value":2614}," (auto-picked or forced by skill argument).",{"type":50,"tag":115,"props":2616,"children":2617},{},[2618],{"type":56,"value":2619},"Dirty repos and their new HEADs.",{"type":50,"tag":115,"props":2621,"children":2622},{},[2623,2625,2631,2633,2638,2640,2645,2646,2651],{"type":56,"value":2624},"Artifacts built: counts per kind (",{"type":50,"tag":72,"props":2626,"children":2628},{"className":2627},[],[2629],{"type":56,"value":2630},".dtb",{"type":56,"value":2632},", in-tree ",{"type":50,"tag":72,"props":2634,"children":2636},{"className":2635},[],[2637],{"type":56,"value":543},{"type":56,"value":2639},", OOT ",{"type":50,"tag":72,"props":2641,"children":2643},{"className":2642},[],[2644],{"type":56,"value":543},{"type":56,"value":199},{"type":50,"tag":72,"props":2647,"children":2649},{"className":2648},[],[2650],{"type":56,"value":77},{"type":56,"value":186},{"type":50,"tag":115,"props":2653,"children":2654},{},[2655],{"type":56,"value":2656},"Manifest path + entry count.",{"type":50,"tag":115,"props":2658,"children":2659},{},[2660],{"type":56,"value":2661},"Consolidated install stage path (if the \"Install consolidation\" step ran).",{"type":50,"tag":115,"props":2663,"children":2664},{},[2665,2667,2672],{"type":56,"value":2666},"Next step: ",{"type":50,"tag":72,"props":2668,"children":2670},{"className":2669},[],[2671],{"type":56,"value":93},{"type":56,"value":315},{"type":50,"tag":66,"props":2674,"children":2675},{},[2676],{"type":56,"value":2677},"If a Customize skill triggered this run, prompt the user to re-issue\ntheir original request.",{"type":50,"tag":59,"props":2679,"children":2681},{"id":2680},"limitations",[2682],{"type":56,"value":2683},"Limitations",{"type":50,"tag":66,"props":2685,"children":2686},{},[2687,2689,2698],{"type":56,"value":2688},"The top tier — failure modes that block a build or silently\nproduce wrong artifacts. See\n",{"type":50,"tag":278,"props":2690,"children":2692},{"href":2691},"references\u002Flong-tail-gotchas.md",[2693],{"type":50,"tag":72,"props":2694,"children":2696},{"className":2695},[],[2697],{"type":56,"value":2691},{"type":56,"value":2699},"\nfor invariants, deploy patterns, and performance hints.",{"type":50,"tag":111,"props":2701,"children":2702},{},[2703,2734,2811,2890,2941,2970,3020,3037,3061],{"type":50,"tag":115,"props":2704,"children":2705},{},[2706,2718,2720,2725,2727,2732],{"type":50,"tag":270,"props":2707,"children":2708},{},[2709,2711,2716],{"type":56,"value":2710},"Toolchain resolution is ",{"type":50,"tag":72,"props":2712,"children":2714},{"className":2713},[],[2715],{"type":56,"value":1290},{"type":56,"value":2717},"'s job.",{"type":56,"value":2719}," This\nskill only reads ",{"type":50,"tag":72,"props":2721,"children":2723},{"className":2722},[],[2724],{"type":56,"value":1282},{"type":56,"value":2726}," and exports ",{"type":50,"tag":72,"props":2728,"children":2730},{"className":2729},[],[2731],{"type":56,"value":1375},{"type":56,"value":2733},".\nMissing field → refuse and route, never resolve in-skill.",{"type":50,"tag":115,"props":2735,"children":2736},{},[2737,2750,2752,2757,2759,2764,2766,2771,2773,2779,2780,2786,2788,2794,2796,2802,2804,2809],{"type":50,"tag":270,"props":2738,"children":2739},{},[2740,2742,2748],{"type":56,"value":2741},"R36.x Branch-A ",{"type":50,"tag":72,"props":2743,"children":2745},{"className":2744},[],[2746],{"type":56,"value":2747},"$KS\u002FMakefile",{"type":56,"value":2749}," collision.",{"type":56,"value":2751}," R36.x's\n",{"type":50,"tag":72,"props":2753,"children":2755},{"className":2754},[],[2756],{"type":56,"value":184},{"type":56,"value":2758}," can leave the dGPU\u002FOpenRM proprietary\nMakefile at ",{"type":50,"tag":72,"props":2760,"children":2762},{"className":2761},[],[2763],{"type":56,"value":2747},{"type":56,"value":2765}," instead of the Tegra orchestrator;\nits ",{"type":50,"tag":72,"props":2767,"children":2769},{"className":2768},[],[2770],{"type":56,"value":629},{"type":56,"value":2772}," target recurses into ",{"type":50,"tag":72,"props":2774,"children":2776},{"className":2775},[],[2777],{"type":56,"value":2778},"kernel-open\u002F",{"type":56,"value":1775},{"type":50,"tag":72,"props":2781,"children":2783},{"className":2782},[],[2784],{"type":56,"value":2785},"src\u002Fnvidia\u002F",{"type":56,"value":2787},",\npulls host ",{"type":50,"tag":72,"props":2789,"children":2791},{"className":2790},[],[2792],{"type":56,"value":2793},"\u002Flib\u002Fmodules",{"type":56,"value":2795}," headers, and breaks arm64 cross-builds\nwith ",{"type":50,"tag":72,"props":2797,"children":2799},{"className":2798},[],[2800],{"type":56,"value":2801},"'-mlittle-endian' unrecognized",{"type":56,"value":2803},". R38+ extractions are\nunaffected. ",{"type":50,"tag":72,"props":2805,"children":2807},{"className":2806},[],[2808],{"type":56,"value":148},{"type":56,"value":2810},"'s step 3a is the primary defense\n(extract-time); the \"Common setup\" check here is the safety net.\nDon't relax the regex.",{"type":50,"tag":115,"props":2812,"children":2813},{},[2814,2819,2821,2827,2828,2834,2836,2841,2843,2848,2850,2855,2856,2861,2863,2868,2870,2875,2877,2882,2884,2889],{"type":50,"tag":270,"props":2815,"children":2816},{},[2817],{"type":56,"value":2818},"Kernel-DT changes: composite-overlay-only, split ownership.",{"type":56,"value":2820},"\nDirect edits to in-tree ",{"type":50,"tag":72,"props":2822,"children":2824},{"className":2823},[],[2825],{"type":56,"value":2826},".dts",{"type":56,"value":623},{"type":50,"tag":72,"props":2829,"children":2831},{"className":2830},[],[2832],{"type":56,"value":2833},".dtsi",{"type":56,"value":2835}," files under ",{"type":50,"tag":72,"props":2837,"children":2839},{"className":2838},[],[2840],{"type":56,"value":1806},{"type":56,"value":2842},"\nare forbidden for customize-* skills — every kernel-DT change\nlands as a fragment in the composite overlay slot\n(",{"type":50,"tag":278,"props":2844,"children":2845},{"href":2189},[2846],{"type":56,"value":2847},"rule + rationale",{"type":56,"value":2849},").\nThe composite ",{"type":50,"tag":72,"props":2851,"children":2853},{"className":2852},[],[2854],{"type":56,"value":2826},{"type":56,"value":2142},{"type":50,"tag":2216,"props":2857,"children":2858},{},[2859],{"type":56,"value":2860},"content",{"type":56,"value":2862}," is owned by each customize-*\nskill; the ",{"type":50,"tag":270,"props":2864,"children":2865},{},[2866],{"type":56,"value":2867},"build \u002F Makefile \u002F flash-conf registration",{"type":56,"value":2869}," is\nowned by this skill (gated on the composite ",{"type":50,"tag":72,"props":2871,"children":2873},{"className":2872},[],[2874],{"type":56,"value":2826},{"type":56,"value":2876}," existing — so\n",{"type":50,"tag":72,"props":2878,"children":2880},{"className":2879},[],[2881],{"type":56,"value":411},{"type":56,"value":2883}," can't reference an unbuilt ",{"type":50,"tag":72,"props":2885,"children":2887},{"className":2886},[],[2888],{"type":56,"value":2184},{"type":56,"value":186},{"type":50,"tag":115,"props":2891,"children":2892},{},[2893,2898,2900,2904,2905,2910,2912,2917,2919,2924,2926,2931,2933,2939],{"type":50,"tag":270,"props":2894,"children":2895},{},[2896],{"type":56,"value":2897},"the \"Register composite custom overlay\" step Makefile insertion point matters.",{"type":56,"value":2899}," Insert after\nthe last ",{"type":50,"tag":2216,"props":2901,"children":2902},{},[2903],{"type":56,"value":2220},{"type":56,"value":2142},{"type":50,"tag":72,"props":2906,"children":2908},{"className":2907},[],[2909],{"type":56,"value":2163},{"type":56,"value":2911}," entry; inserting after\n",{"type":50,"tag":72,"props":2913,"children":2915},{"className":2914},[],[2916],{"type":56,"value":2234},{"type":56,"value":2918}," skips the ",{"type":50,"tag":72,"props":2920,"children":2922},{"className":2921},[],[2923],{"type":56,"value":2242},{"type":56,"value":2925}," prefix\npass and the build silently drops your ",{"type":50,"tag":72,"props":2927,"children":2929},{"className":2928},[],[2930],{"type":56,"value":2184},{"type":56,"value":2932},". The regex\n",{"type":50,"tag":72,"props":2934,"children":2936},{"className":2935},[],[2937],{"type":56,"value":2938},"^dtbo-y *+= *[a-zA-Z0-9]",{"type":56,"value":2940}," filters correctly; do not relax it.",{"type":50,"tag":115,"props":2942,"children":2943},{},[2944,2949,2951,2956,2958,2963,2964,2968],{"type":50,"tag":270,"props":2945,"children":2946},{},[2947],{"type":56,"value":2948},"the \"Register composite custom overlay\" step first-touch needs pristine import.",{"type":56,"value":2950}," On a fresh\nworkspace the overlay tracker is empty git-init — the carrier\nflash conf is imported from ",{"type":50,"tag":72,"props":2952,"children":2954},{"className":2953},[],[2955],{"type":56,"value":2284},{"type":56,"value":2957}," and committed as\n",{"type":50,"tag":72,"props":2959,"children":2961},{"className":2960},[],[2962],{"type":56,"value":2292},{"type":56,"value":2142},{"type":50,"tag":2216,"props":2965,"children":2966},{},[2967],{"type":56,"value":2298},{"type":56,"value":2969}," the customization commit. Both commits go\nthrough the workflow acceptance gate.",{"type":50,"tag":115,"props":2971,"children":2972},{},[2973,2986,2988,2993,2995,3000,3002,3008,3010,3019],{"type":50,"tag":270,"props":2974,"children":2975},{},[2976,2978,2984],{"type":56,"value":2977},"Avoid bare ",{"type":50,"tag":72,"props":2979,"children":2981},{"className":2980},[],[2982],{"type":56,"value":2983},"$0",{"type":56,"value":2985}," in shell snippets inside this SKILL.md.",{"type":56,"value":2987}," When\ninvoked with an argument, the harness expands skill-body ",{"type":50,"tag":72,"props":2989,"children":2991},{"className":2990},[],[2992],{"type":56,"value":2983},{"type":56,"value":2994},"\nagainst the caller's ",{"type":50,"tag":72,"props":2996,"children":2998},{"className":2997},[],[2999],{"type":56,"value":2983},{"type":56,"value":3001}," before handing the rendered prompt to\nthe model. Use sed-based line splicing or\n",{"type":50,"tag":72,"props":3003,"children":3005},{"className":3004},[],[3006],{"type":56,"value":3007},"awk -v ROW=\"$0\"",{"type":56,"value":3009},". See\n",{"type":50,"tag":278,"props":3011,"children":3013},{"href":3012},"references\u002Fcomposite-registration.md#why-sed-based-splicing-not-awk",[3014],{"type":50,"tag":72,"props":3015,"children":3017},{"className":3016},[],[3018],{"type":56,"value":2131},{"type":56,"value":315},{"type":50,"tag":115,"props":3021,"children":3022},{},[3023,3028,3030,3035],{"type":50,"tag":270,"props":3024,"children":3025},{},[3026],{"type":56,"value":3027},"No overlay staging.",{"type":56,"value":3029}," Build outputs stay where the build put\nthem; the manifest is the contract to ",{"type":50,"tag":72,"props":3031,"children":3033},{"className":3032},[],[3034],{"type":56,"value":305},{"type":56,"value":3036},".\nDeliberate divergence from the original overlay→promote\nindirection — keeps the full build output set out of the\noverlay tracker's git history.",{"type":50,"tag":115,"props":3038,"children":3039},{},[3040,3059],{"type":50,"tag":270,"props":3041,"children":3042},{},[3043,3049,3051,3057],{"type":50,"tag":72,"props":3044,"children":3046},{"className":3045},[],[3047],{"type":56,"value":3048},"KERNEL_HEADERS",{"type":56,"value":3050}," vs ",{"type":50,"tag":72,"props":3052,"children":3054},{"className":3053},[],[3055],{"type":56,"value":3056},"KERNEL_OUTPUT",{"type":56,"value":3058}," in DT mode.",{"type":56,"value":3060}," Different\nsemantics (srctree vs objtree); do not collapse. the \"DT-only\" step's\nsnippet is correct as written.",{"type":50,"tag":115,"props":3062,"children":3063},{},[3064,3069,3071,3076,3078,3083,3085,3090],{"type":50,"tag":270,"props":3065,"children":3066},{},[3067],{"type":56,"value":3068},"OOT mode prereq: previously-built kernel headers.",{"type":56,"value":3070}," A manual\n",{"type":50,"tag":72,"props":3072,"children":3074},{"className":3073},[],[3075],{"type":56,"value":504},{"type":56,"value":3077}," invocation against a never-built tree refuses with \"run\n",{"type":50,"tag":72,"props":3079,"children":3081},{"className":3080},[],[3082],{"type":56,"value":525},{"type":56,"value":3084}," (or ",{"type":50,"tag":72,"props":3086,"children":3088},{"className":3087},[],[3089],{"type":56,"value":567},{"type":56,"value":3091},") first\" rather than producing a confusing\nbuild error.",{"type":50,"tag":59,"props":3093,"children":3095},{"id":3094},"examples",[3096],{"type":56,"value":3097},"Examples",{"type":50,"tag":66,"props":3099,"children":3100},{},[3101],{"type":56,"value":3102},"Auto-detect mode from the dirty source tree (typical invocation):",{"type":50,"tag":908,"props":3104,"children":3108},{"className":3105,"code":3107,"language":56},[3106],"language-text","\u002Fjetson-build-source\n",[3109],{"type":50,"tag":72,"props":3110,"children":3111},{"__ignoreMap":913},[3112],{"type":56,"value":3107},{"type":50,"tag":66,"props":3114,"children":3115},{},[3116],{"type":56,"value":3117},"Force a single mode (skips auto-detect):",{"type":50,"tag":908,"props":3119,"children":3122},{"className":3120,"code":3121,"language":56},[3106],"\u002Fjetson-build-source dt       # rebuild NVIDIA DTBs only\n\u002Fjetson-build-source oot      # rebuild OOT modules only\n\u002Fjetson-build-source kernel   # rebuild kernel Image + in-tree modules\n\u002Fjetson-build-source full     # rebuild everything + install consolidation\n",[3123],{"type":50,"tag":72,"props":3124,"children":3125},{"__ignoreMap":913},[3126],{"type":56,"value":3121},{"type":50,"tag":66,"props":3128,"children":3129},{},[3130],{"type":56,"value":3131},"Typical chain after a customize-* skill commits to a kernel-side\nrepo (the customize-* skill calls this automatically):",{"type":50,"tag":908,"props":3133,"children":3136},{"className":3134,"code":3135,"language":56},[3106],"\u002Fjetson-customize-pcie ...   # commits to hardware\u002Fnvidia\u002F...\u002Fnv-public\n   ↓\n\u002Fjetson-build-source         # auto-picks `dt` from the dirty set\n   ↓\n\u002Fjetson-promote-image        # reads .build-manifest.yaml, stages into bsp_image\n   ↓\n\u002Fjetson-flash-image          # flashes\n",[3137],{"type":50,"tag":72,"props":3138,"children":3139},{"__ignoreMap":913},[3140],{"type":56,"value":3135},{"type":50,"tag":59,"props":3142,"children":3144},{"id":3143},"troubleshooting",[3145],{"type":56,"value":3146},"Troubleshooting",{"type":50,"tag":425,"props":3148,"children":3149},{},[3150,3171],{"type":50,"tag":429,"props":3151,"children":3152},{},[3153],{"type":50,"tag":433,"props":3154,"children":3155},{},[3156,3161,3166],{"type":50,"tag":437,"props":3157,"children":3158},{},[3159],{"type":56,"value":3160},"Error",{"type":50,"tag":437,"props":3162,"children":3163},{},[3164],{"type":56,"value":3165},"Cause",{"type":50,"tag":437,"props":3167,"children":3168},{},[3169],{"type":56,"value":3170},"Solution",{"type":50,"tag":453,"props":3172,"children":3173},{},[3174,3203,3254,3304,3355,3395,3449,3488],{"type":50,"tag":433,"props":3175,"children":3176},{},[3177,3186,3191],{"type":50,"tag":460,"props":3178,"children":3179},{},[3180],{"type":50,"tag":72,"props":3181,"children":3183},{"className":3182},[],[3184],{"type":56,"value":3185},"source.toolchain points at \u003C...>gcc which does not exist",{"type":50,"tag":460,"props":3187,"children":3188},{},[3189],{"type":56,"value":3190},"Toolchain field stale (path moved, install missing)",{"type":50,"tag":460,"props":3192,"children":3193},{},[3194,3196,3201],{"type":56,"value":3195},"Re-run ",{"type":50,"tag":72,"props":3197,"children":3199},{"className":3198},[],[3200],{"type":56,"value":148},{"type":56,"value":3202}," to re-resolve. This skill never resolves toolchain itself.",{"type":50,"tag":433,"props":3204,"children":3205},{},[3206,3215,3239],{"type":50,"tag":460,"props":3207,"children":3208},{},[3209],{"type":50,"tag":72,"props":3210,"children":3212},{"className":3211},[],[3213],{"type":56,"value":3214},"No rule to make target '$KOUT\u002Fscripts\u002FMakefile.compiler'",{"type":50,"tag":460,"props":3216,"children":3217},{},[3218,3223,3225,3231,3233],{"type":50,"tag":72,"props":3219,"children":3221},{"className":3220},[],[3222],{"type":56,"value":3048},{"type":56,"value":3224}," set to ",{"type":50,"tag":72,"props":3226,"children":3228},{"className":3227},[],[3229],{"type":56,"value":3230},"$KOUT",{"type":56,"value":3232}," instead of ",{"type":50,"tag":72,"props":3234,"children":3236},{"className":3235},[],[3237],{"type":56,"value":3238},"$KS\u002Fkernel\u002F$KERNEL_SRC_DIR",{"type":50,"tag":460,"props":3240,"children":3241},{},[3242,3244,3252],{"type":56,"value":3243},"Use the DT-mode snippet in ",{"type":50,"tag":278,"props":3245,"children":3246},{"href":2052},[3247],{"type":50,"tag":72,"props":3248,"children":3250},{"className":3249},[],[3251],{"type":56,"value":2052},{"type":56,"value":3253}," verbatim — srctree vs objtree must not collapse.",{"type":50,"tag":433,"props":3255,"children":3256},{},[3257,3273,3284],{"type":50,"tag":460,"props":3258,"children":3259},{},[3260,3265,3267],{"type":50,"tag":72,"props":3261,"children":3263},{"className":3262},[],[3264],{"type":56,"value":2801},{"type":56,"value":3266}," during ",{"type":50,"tag":72,"props":3268,"children":3270},{"className":3269},[],[3271],{"type":56,"value":3272},"make modules",{"type":50,"tag":460,"props":3274,"children":3275},{},[3276,3277,3282],{"type":56,"value":2741},{"type":50,"tag":72,"props":3278,"children":3280},{"className":3279},[],[3281],{"type":56,"value":2747},{"type":56,"value":3283}," collision — dGPU\u002FOpenRM Makefile in place of Tegra orchestrator",{"type":50,"tag":460,"props":3285,"children":3286},{},[3287,3289,3295,3297,3302],{"type":56,"value":3288},"The Common-setup safety net normally repairs it; if not, ",{"type":50,"tag":72,"props":3290,"children":3292},{"className":3291},[],[3293],{"type":56,"value":3294},"git checkout HEAD -- Makefile",{"type":56,"value":3296}," then re-run ",{"type":50,"tag":72,"props":3298,"children":3300},{"className":3299},[],[3301],{"type":56,"value":148},{"type":56,"value":3303}," step 3a.",{"type":50,"tag":433,"props":3305,"children":3306},{},[3307,3325,3330],{"type":50,"tag":460,"props":3308,"children":3309},{},[3310,3316,3318,3323],{"type":50,"tag":72,"props":3311,"children":3313},{"className":3312},[],[3314],{"type":56,"value":3315},"run kernel (or full) first",{"type":56,"value":3317}," on manual ",{"type":50,"tag":72,"props":3319,"children":3321},{"className":3320},[],[3322],{"type":56,"value":504},{"type":56,"value":3324}," invocation",{"type":50,"tag":460,"props":3326,"children":3327},{},[3328],{"type":56,"value":3329},"Kernel source tree never prepared",{"type":50,"tag":460,"props":3331,"children":3332},{},[3333,3335,3341,3342,3347,3349,3354],{"type":56,"value":3334},"Run ",{"type":50,"tag":72,"props":3336,"children":3338},{"className":3337},[],[3339],{"type":56,"value":3340},"\u002Fjetson-build-source kernel",{"type":56,"value":3084},{"type":50,"tag":72,"props":3343,"children":3345},{"className":3344},[],[3346],{"type":56,"value":567},{"type":56,"value":3348},") once, then ",{"type":50,"tag":72,"props":3350,"children":3352},{"className":3351},[],[3353],{"type":56,"value":504},{"type":56,"value":315},{"type":50,"tag":433,"props":3356,"children":3357},{},[3358,3369,3382],{"type":50,"tag":460,"props":3359,"children":3360},{},[3361,3367],{"type":50,"tag":72,"props":3362,"children":3364},{"className":3363},[],[3365],{"type":56,"value":3366},"nothing to build",{"type":56,"value":3368}," and dirty edits exist",{"type":50,"tag":460,"props":3370,"children":3371},{},[3372,3374,3380],{"type":56,"value":3373},"Edits uncommitted in a sub-repo but ",{"type":50,"tag":72,"props":3375,"children":3377},{"className":3376},[],[3378],{"type":56,"value":3379},".build-state.yaml",{"type":56,"value":3381}," watermark already matches HEAD",{"type":50,"tag":460,"props":3383,"children":3384},{},[3385,3387,3393],{"type":56,"value":3386},"Commit the edits, or re-run with an explicit mode argument (",{"type":50,"tag":72,"props":3388,"children":3390},{"className":3389},[],[3391],{"type":56,"value":3392},"\u002Fjetson-build-source dt",{"type":56,"value":3394}," etc.).",{"type":50,"tag":433,"props":3396,"children":3397},{},[3398,3410,3422],{"type":50,"tag":460,"props":3399,"children":3400},{},[3401,3403,3408],{"type":56,"value":3402},"Composite ",{"type":50,"tag":72,"props":3404,"children":3406},{"className":3405},[],[3407],{"type":56,"value":2184},{"type":56,"value":3409}," silently missing from the output set",{"type":50,"tag":460,"props":3411,"children":3412},{},[3413,3415,3420],{"type":56,"value":3414},"Per-dir Makefile insertion landed after ",{"type":50,"tag":72,"props":3416,"children":3418},{"className":3417},[],[3419],{"type":56,"value":2234},{"type":56,"value":3421}," merge-back line",{"type":50,"tag":460,"props":3423,"children":3424},{},[3425,3427,3435,3437,3441,3442,3447],{"type":56,"value":3426},"See ",{"type":50,"tag":278,"props":3428,"children":3429},{"href":2254},[3430],{"type":50,"tag":72,"props":3431,"children":3433},{"className":3432},[],[3434],{"type":56,"value":2131},{"type":56,"value":3436}," — insert after the last ",{"type":50,"tag":2216,"props":3438,"children":3439},{},[3440],{"type":56,"value":2220},{"type":56,"value":2142},{"type":50,"tag":72,"props":3443,"children":3445},{"className":3444},[],[3446],{"type":56,"value":2163},{"type":56,"value":3448}," entry.",{"type":50,"tag":433,"props":3450,"children":3451},{},[3452,3457,3476],{"type":50,"tag":460,"props":3453,"children":3454},{},[3455],{"type":56,"value":3456},"Promote step copies stale baseline artifacts",{"type":50,"tag":460,"props":3458,"children":3459},{},[3460,3462,3468,3470],{"type":56,"value":3461},"Trace-to-dirty filter skipped after a manual ",{"type":50,"tag":72,"props":3463,"children":3465},{"className":3464},[],[3466],{"type":56,"value":3467},"cp",{"type":56,"value":3469}," into ",{"type":50,"tag":72,"props":3471,"children":3473},{"className":3472},[],[3474],{"type":56,"value":3475},"$KS",{"type":50,"tag":460,"props":3477,"children":3478},{},[3479,3481,3486],{"type":56,"value":3480},"Only edit via a customize-* skill or ",{"type":50,"tag":72,"props":3482,"children":3484},{"className":3483},[],[3485],{"type":56,"value":220},{"type":56,"value":3487},"; the dirty detector keys on git HEAD, not file mtime.",{"type":50,"tag":433,"props":3489,"children":3490},{},[3491,3500,3522],{"type":50,"tag":460,"props":3492,"children":3493},{},[3494],{"type":50,"tag":72,"props":3495,"children":3497},{"className":3496},[],[3498],{"type":56,"value":3499},"host package missing: \u003Cpkg>",{"type":50,"tag":460,"props":3501,"children":3502},{},[3503,3508,3509,3514,3515,3520],{"type":50,"tag":72,"props":3504,"children":3506},{"className":3505},[],[3507],{"type":56,"value":197},{"type":56,"value":957},{"type":50,"tag":72,"props":3510,"children":3512},{"className":3511},[],[3513],{"type":56,"value":205},{"type":56,"value":957},{"type":50,"tag":72,"props":3516,"children":3518},{"className":3517},[],[3519],{"type":56,"value":212},{"type":56,"value":3521}," refuse; others warn.",{"type":50,"tag":460,"props":3523,"children":3524},{},[3525,3531,3533,3542],{"type":50,"tag":72,"props":3526,"children":3528},{"className":3527},[],[3529],{"type":56,"value":3530},"sudo apt install \u003Cpkg>",{"type":56,"value":3532}," per ",{"type":50,"tag":278,"props":3534,"children":3536},{"href":3535},"references\u002Fupstream-recipe.md",[3537],{"type":50,"tag":72,"props":3538,"children":3540},{"className":3539},[],[3541],{"type":56,"value":3535},{"type":56,"value":315},{"type":50,"tag":59,"props":3544,"children":3546},{"id":3545},"see-also",[3547],{"type":56,"value":3548},"See also",{"type":50,"tag":111,"props":3550,"children":3551},{},[3552,3572,3599,3612,3625,3638,3652,3665,3678,3698],{"type":50,"tag":115,"props":3553,"children":3554},{},[3555,3563,3565,3570],{"type":50,"tag":278,"props":3556,"children":3557},{"href":2052},[3558],{"type":50,"tag":72,"props":3559,"children":3561},{"className":3560},[],[3562],{"type":56,"value":2052},{"type":56,"value":3564}," — per-mode ",{"type":50,"tag":72,"props":3566,"children":3568},{"className":3567},[],[3569],{"type":56,"value":1487},{"type":56,"value":3571}," snippets + install consolidation.",{"type":50,"tag":115,"props":3573,"children":3574},{},[3575,3583,3585,3591,3592,3597],{"type":50,"tag":278,"props":3576,"children":3577},{"href":2520},[3578],{"type":50,"tag":72,"props":3579,"children":3581},{"className":3580},[],[3582],{"type":56,"value":2520},{"type":56,"value":3584}," — ",{"type":50,"tag":72,"props":3586,"children":3588},{"className":3587},[],[3589],{"type":56,"value":3590},".build-manifest.yaml",{"type":56,"value":1775},{"type":50,"tag":72,"props":3593,"children":3595},{"className":3594},[],[3596],{"type":56,"value":3379},{"type":56,"value":3598}," schemas.",{"type":50,"tag":115,"props":3600,"children":3601},{},[3602,3610],{"type":50,"tag":278,"props":3603,"children":3604},{"href":2131},[3605],{"type":50,"tag":72,"props":3606,"children":3608},{"className":3607},[],[3609],{"type":56,"value":2131},{"type":56,"value":3611}," — the \"Register composite custom overlay\" step full snippets + rationale.",{"type":50,"tag":115,"props":3613,"children":3614},{},[3615,3623],{"type":50,"tag":278,"props":3616,"children":3617},{"href":2691},[3618],{"type":50,"tag":72,"props":3619,"children":3621},{"className":3620},[],[3622],{"type":56,"value":2691},{"type":56,"value":3624}," — invariants, deploy patterns, performance hints.",{"type":50,"tag":115,"props":3626,"children":3627},{},[3628,3636],{"type":50,"tag":278,"props":3629,"children":3630},{"href":3535},[3631],{"type":50,"tag":72,"props":3632,"children":3634},{"className":3633},[],[3635],{"type":56,"value":3535},{"type":56,"value":3637}," — verbatim NVIDIA recipe, divergences, spec status.",{"type":50,"tag":115,"props":3639,"children":3640},{},[3641,3650],{"type":50,"tag":278,"props":3642,"children":3644},{"href":3643},"..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md#workflow-invariants",[3645],{"type":50,"tag":72,"props":3646,"children":3648},{"className":3647},[],[3649],{"type":56,"value":280},{"type":56,"value":3651}," — workspace edit protocol.",{"type":50,"tag":115,"props":3653,"children":3654},{},[3655,3663],{"type":50,"tag":278,"props":3656,"children":3657},{"href":382},[3658],{"type":50,"tag":72,"props":3659,"children":3661},{"className":3660},[],[3662],{"type":56,"value":382},{"type":56,"value":3664}," — composite custom-overlay contract.",{"type":50,"tag":115,"props":3666,"children":3667},{},[3668,3676],{"type":50,"tag":278,"props":3669,"children":3670},{"href":354},[3671],{"type":50,"tag":72,"props":3672,"children":3674},{"className":3673},[],[3675],{"type":56,"value":354},{"type":56,"value":3677}," — BPMP-DTB edit contract (routed around this skill).",{"type":50,"tag":115,"props":3679,"children":3680},{},[3681,3690,3692,3697],{"type":50,"tag":278,"props":3682,"children":3684},{"href":3683},"..\u002Fjetson-init-source\u002FSKILL.md",[3685],{"type":50,"tag":72,"props":3686,"children":3688},{"className":3687},[],[3689],{"type":56,"value":3683},{"type":56,"value":3691}," — Setup; authors ",{"type":50,"tag":72,"props":3693,"children":3695},{"className":3694},[],[3696],{"type":56,"value":1282},{"type":56,"value":315},{"type":50,"tag":115,"props":3699,"children":3700},{},[3701,3709],{"type":50,"tag":278,"props":3702,"children":3703},{"href":298},[3704],{"type":50,"tag":72,"props":3705,"children":3707},{"className":3706},[],[3708],{"type":56,"value":298},{"type":56,"value":3710}," — Deploy promoter; reads this skill's manifest.",{"type":50,"tag":3712,"props":3713,"children":3714},"style",{},[3715],{"type":56,"value":3716},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3718,"total":3875},[3719,3737,3753,3764,3776,3790,3803,3817,3830,3841,3855,3864],{"slug":3720,"name":3720,"fn":3721,"description":3722,"org":3723,"tags":3724,"stars":3734,"repoUrl":3735,"updatedAt":3736},"nemoclaw-user-guide","retrieve NemoClaw documentation and configuration","Guides human users' AI agents to the NemoClaw docs MCP server and canonical Fern documentation in Markdown form. Use when users ask how to install, configure, operate, troubleshoot, secure, or learn NemoClaw with an AI coding assistant. Trigger keywords - nemoclaw docs, use nemoclaw with ai agent, nemoclaw mcp docs, nemoclaw install help, nemoclaw quickstart, nemoclaw markdown docs, llms.txt, agent skills.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3725,3728,3731],{"name":3726,"slug":3727,"type":15},"Documentation","documentation",{"name":3729,"slug":3730,"type":15},"MCP","mcp",{"name":3732,"slug":3733,"type":15},"Search","search",21777,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002FNemoClaw","2026-07-20T06:00:01.461044",{"slug":3738,"name":3738,"fn":3739,"description":3740,"org":3741,"tags":3742,"stars":3750,"repoUrl":3751,"updatedAt":3752},"mcore-build-and-dependency","manage Megatron-LM development environments","Container-based dev environment setup and dependency management for Megatron-LM. Covers acquiring and launching the CI container, uv package management, and updating uv.lock.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3743,3746,3747],{"name":3744,"slug":3745,"type":15},"Containers","containers",{"name":17,"slug":18,"type":15},{"name":3748,"slug":3749,"type":15},"Python","python",17049,"https:\u002F\u002Fgithub.com\u002FNVIDIA\u002FMegatron-LM","2026-07-27T06:06:11.249662",{"slug":3754,"name":3754,"fn":3755,"description":3756,"org":3757,"tags":3758,"stars":3750,"repoUrl":3751,"updatedAt":3763},"mcore-bump-base-image","update NVIDIA PyTorch base images","Bump the NVIDIA PyTorch base image (`nvcr.io\u002Fnvidia\u002Fpytorch:YY.MM-py3`) used by Megatron-LM CI. Covers the two pin sites (GitHub CI in `docker\u002F.ngc_version.dev` and GitLab CI in `.gitlab\u002Fstages\u002F01.build.yml`), the post-bump CI loop (re-run functional tests, refresh golden values, mark broken tests), and the gotchas that bit PRs",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3759,3762],{"name":3760,"slug":3761,"type":15},"CI\u002FCD","ci-cd",{"name":17,"slug":18,"type":15},"2026-07-14T05:25:59.97109",{"slug":3765,"name":3765,"fn":3766,"description":3767,"org":3768,"tags":3769,"stars":3750,"repoUrl":3751,"updatedAt":3775},"mcore-cicd","manage CI\u002FCD pipelines for Megatron-LM","CI\u002FCD reference for Megatron-LM. Covers CI pipeline structure, PR scope labels, triggering internal GitLab CI (which force-pushes the current branch to a pull-request\u002FBRANCH ref — always dry-run and verify the destination first; never run against shared or protected branches), and CI failure investigation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3770,3771,3772],{"name":3760,"slug":3761,"type":15},{"name":17,"slug":18,"type":15},{"name":3773,"slug":3774,"type":15},"GitHub","github","2026-07-27T06:06:12.278222",{"slug":3777,"name":3777,"fn":3778,"description":3779,"org":3780,"tags":3781,"stars":3750,"repoUrl":3751,"updatedAt":3789},"mcore-create-issue","investigate CI failures and create issues","Investigate a failing GitHub Actions run or job and create a GitHub issue for the failure.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3782,3785,3786],{"name":3783,"slug":3784,"type":15},"Debugging","debugging",{"name":3773,"slug":3774,"type":15},{"name":3787,"slug":3788,"type":15},"Triage","triage","2026-07-14T05:25:57.442089",{"slug":3791,"name":3791,"fn":3792,"description":3793,"org":3794,"tags":3795,"stars":3750,"repoUrl":3751,"updatedAt":3802},"mcore-linting-and-formatting","lint and format Megatron-LM code","Linting and formatting for Megatron-LM. Covers running autoformat.sh, tools (ruff, black, isort, pylint, mypy), and code style rules.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3796,3799],{"name":3797,"slug":3798,"type":15},"Best Practices","best-practices",{"name":3800,"slug":3801,"type":15},"Code Analysis","code-analysis","2026-07-14T05:25:56.18433",{"slug":3804,"name":3804,"fn":3805,"description":3806,"org":3807,"tags":3808,"stars":3750,"repoUrl":3751,"updatedAt":3816},"mcore-migrate-gpt-to-hybrid","migrate Megatron-LM models to HybridModel","Migration guide for moving Megatron Core GPTModel checkpoints, model providers, training commands, and layer mappings to HybridModel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3809,3812,3815],{"name":3810,"slug":3811,"type":15},"Machine Learning","machine-learning",{"name":3813,"slug":3814,"type":15},"Migration","migration",{"name":9,"slug":8,"type":15},"2026-07-17T06:07:11.777011",{"slug":3818,"name":3818,"fn":3819,"description":3820,"org":3821,"tags":3822,"stars":3750,"repoUrl":3751,"updatedAt":3829},"mcore-onboard-gb200-1node-tests","onboard functional tests for GB200","Onboard 1-node GitHub MR functional tests for GB200 from existing mr-scoped 2-node tests.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3823,3826],{"name":3824,"slug":3825,"type":15},"QA","qa",{"name":3827,"slug":3828,"type":15},"Testing","testing","2026-07-14T05:25:53.673039",{"slug":3831,"name":3831,"fn":3832,"description":3833,"org":3834,"tags":3835,"stars":3750,"repoUrl":3751,"updatedAt":3840},"mcore-run-on-slurm","launch distributed training jobs on SLURM","How to launch distributed Megatron-LM training jobs on a SLURM cluster. Covers a minimal sbatch skeleton, environment-variable setup for torch.distributed.run, CUDA_DEVICE_MAX_CONNECTIONS rules across hardware and parallelism modes, container conventions, monitoring, and per-rank failure diagnosis.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3836,3837],{"name":17,"slug":18,"type":15},{"name":3838,"slug":3839,"type":15},"Infrastructure","infrastructure","2026-07-14T05:25:49.362534",{"slug":3842,"name":3842,"fn":3843,"description":3844,"org":3845,"tags":3846,"stars":3750,"repoUrl":3751,"updatedAt":3854},"mcore-split-pr","split pull requests to reduce review load","Split a PR into multiple PRs to reduce the number of required CODEOWNERS reviewer groups.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3847,3850,3851],{"name":3848,"slug":3849,"type":15},"Code Review","code-review",{"name":3773,"slug":3774,"type":15},{"name":3852,"slug":3853,"type":15},"Pull Requests","pull-requests","2026-07-14T05:26:01.226578",{"slug":3856,"name":3856,"fn":3857,"description":3858,"org":3859,"tags":3860,"stars":3750,"repoUrl":3751,"updatedAt":3863},"mcore-testing","run and manage Megatron-LM tests","Test system for Megatron-LM. Covers test layout, recipe YAML structure, adding and running unit and functional tests, golden values, marker filters, and CI parity.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3861,3862],{"name":3824,"slug":3825,"type":15},{"name":3827,"slug":3828,"type":15},"2026-07-14T05:25:54.928983",{"slug":3865,"name":3865,"fn":3866,"description":3867,"org":3868,"tags":3869,"stars":3750,"repoUrl":3751,"updatedAt":3874},"nightly-sync","manage nightly main-to-dev sync workflows","Domain knowledge for the nightly main-to-dev sync workflow. Covers merge strategy, CI architecture, failure investigation, and known issues.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3870,3873],{"name":3871,"slug":3872,"type":15},"Automation","automation",{"name":3760,"slug":3761,"type":15},"2026-07-30T05:29:03.275638",496,{"items":3877,"total":3973},[3878,3895,3905,3919,3929,3944,3959],{"slug":3879,"name":3879,"fn":3880,"description":3881,"org":3882,"tags":3883,"stars":23,"repoUrl":24,"updatedAt":3894},"accelerated-computing-cudf","accelerate data processing with cuDF","Official NVIDIA-authored guidance for NVIDIA cuDF GPU DataFrames, pandas acceleration, dask-cuDF, ETL, joins, groupby, CSV\u002FParquet I\u002FO, nullable semantics, and multi-GPU DataFrame workloads.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3884,3887,3890,3891],{"name":3885,"slug":3886,"type":15},"Data Analysis","data-analysis",{"name":3888,"slug":3889,"type":15},"Data Engineering","data-engineering",{"name":9,"slug":8,"type":15},{"name":3892,"slug":3893,"type":15},"Performance","performance","2026-07-14T05:28:43.176466",{"slug":3896,"name":3896,"fn":3897,"description":3898,"org":3899,"tags":3900,"stars":23,"repoUrl":24,"updatedAt":3904},"aiq-deploy","deploy and manage NVIDIA AI-Q infrastructure","Use when asked to install, deploy, run, validate, troubleshoot, or stop NVIDIA AI-Q Blueprint infrastructure.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3901,3902,3903],{"name":17,"slug":18,"type":15},{"name":3838,"slug":3839,"type":15},{"name":9,"slug":8,"type":15},"2026-07-14T05:29:06.667109",{"slug":3906,"name":3906,"fn":3907,"description":3908,"org":3909,"tags":3910,"stars":23,"repoUrl":24,"updatedAt":3918},"aiq-research","conduct deep research with AI-Q","Use when asked to run deep research or AI-Q research through a reachable NVIDIA AI-Q Blueprint backend.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3911,3914,3915],{"name":3912,"slug":3913,"type":15},"Agents","agents",{"name":9,"slug":8,"type":15},{"name":3916,"slug":3917,"type":15},"Research","research","2026-07-14T05:28:06.816956",{"slug":3920,"name":3920,"fn":3921,"description":3922,"org":3923,"tags":3924,"stars":23,"repoUrl":24,"updatedAt":3928},"amc-run-sample-calibration","run AMC sample dataset calibration","Run end-to-end calibration on the shipped sample dataset (sdg_08_2_sample_data_010926.zip) against a running AMC microservice. Use when user says 'test sample dataset', 'run sample calibration', 'verify AMC install', or 'launch and test'.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3925,3926,3927],{"name":3885,"slug":3886,"type":15},{"name":9,"slug":8,"type":15},{"name":3827,"slug":3828,"type":15},"2026-07-17T05:29:03.913266",{"slug":3930,"name":3930,"fn":3931,"description":3932,"org":3933,"tags":3934,"stars":23,"repoUrl":24,"updatedAt":3943},"amc-run-video-calibration","calibrate video datasets with AutoMagicCalib","Calibrate a new dataset from pre-recorded video files via the AutoMagicCalib REST API. Use when user has local MP4s and says 'calibrate my videos', 'run AMC on these videos', or similar. For RTSP\u002Flive streams, use amc-run-rtsp-calibration instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3935,3936,3939,3940],{"name":3871,"slug":3872,"type":15},{"name":3937,"slug":3938,"type":15},"Imaging","imaging",{"name":9,"slug":8,"type":15},{"name":3941,"slug":3942,"type":15},"Video","video","2026-07-17T05:28:53.905004",{"slug":3945,"name":3945,"fn":3946,"description":3947,"org":3948,"tags":3949,"stars":23,"repoUrl":24,"updatedAt":3958},"amc-setup-calibration-stack","deploy AutoMagicCalib microservice with Docker","Launch AutoMagicCalib microservice and web UI from NGC release images via Docker Compose. Use when user says 'deploy auto calibration', 'launch auto calibration', 'launch AMC', 'start MS+UI', or 'set up auto-magic-calib'. Requires NGC API key.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3950,3951,3954,3955],{"name":17,"slug":18,"type":15},{"name":3952,"slug":3953,"type":15},"Docker","docker",{"name":9,"slug":8,"type":15},{"name":3956,"slug":3957,"type":15},"Operations","operations","2026-07-17T05:28:56.913999",{"slug":3960,"name":3960,"fn":3961,"description":3962,"org":3963,"tags":3964,"stars":23,"repoUrl":24,"updatedAt":3972},"cudaq-guide","develop quantum applications with CUDA-Q","CUDA-Q onboarding guide for installation, test programs, GPU simulation, QPU hardware, and quantum applications.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[3965,3966,3969],{"name":9,"slug":8,"type":15},{"name":3967,"slug":3968,"type":15},"Quantum Computing","quantum-computing",{"name":3970,"slug":3971,"type":15},"Simulation","simulation","2026-07-14T05:26:58.898253",305]