[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CPN3GP0J70S6R4JBX50TPY":3,"skill-same:01M7CPN3GP0J70S6R4JBX50TPY":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":6,"ownerDescription":40,"updatedAt":41,"install":42,"resources":55},"01M7CPN3GP0J70S6R4JBX50TPY","jetson-promote-image",null,"Use to promote overlay files and built artifacts into the staged BSP image. Do NOT use to flash or build. Triggers: promote bsp image.","om-scogo\u002Fskillsh-scraper","om-scogo","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160466840?v=4","01M79AWB6DFVCQ7RK70CS34B96","Om Achrekar","01M79AWB6ZM9SKR8KDH1WSSM22",0,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fnvidia-skills\u002Fjetson-promote-image\u002FSkill.md",[],[],"2026-11-15 14:19:17",false,"---\nname: jetson-promote-image\ndescription: >-\n  Use to promote overlay files and built artifacts into the staged\n  BSP image. Do NOT use to flash or build. Triggers: promote bsp\n  image.\nversion: 0.0.1\nlicense: \"Apache-2.0\"\nmetadata:\n  data-classification: public\n  author: \"Jetson Team\"\n  team: pts\n  tags:\n    - bsp\n    - promote\n    - deploy\n  domain: meta\n---\n\n# Promote BSP Image\n\n## Purpose\n\nStage every Customize-* and Build output into `bsp_image` so it is\nready for `\u002Fjetson-flash-image`. This is the **promote leg of\nDeploy** — it copies files, never flashes and never builds.\n\n## Prerequisites\n\n- Active target-platform profile with both `source:` and `bsp_image:`\n  resolved (run `\u002Fjetson-init-source` and `\u002Fjetson-init-image` first).\n- `\u003Csource.root_path>\u002FLinux_for_Tegra\u002F` initialized as a git repo\n  (overlay tracker) with a clean working tree.\n- `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` extracted from a BSP\n  tarball + `apply_binaries.sh` already run.\n- `git`, `yq`, `cmp`, and `sudo` (for `rootfs\u002F*` destinations) on\n  the host.\n- `\u003Csource.root_path>\u002F.build-manifest.yaml` + `.build-state.yaml`\n  from `\u002Fjetson-build-source` (required when kernel-side repos\n  have customize-* commits).\n\n## Overview\n\nThis is the **promote leg of Deploy** — see\n[`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md)\nfor the pipeline view. The two channels this skill walks are:\n\n| Channel | Source | Carrier | Owner |\n|---|---|---|---|\n| **Overlay tracker** | `\u003Csource.root_path>\u002FLinux_for_Tegra\u002F` (git repo at HEAD) | Customize-* outputs that don't require a build (e.g. `nvfancontrol.conf`, `nvpmodel.conf`, BPMP DTB hand-edits) | Customize `customize-*` skills commit here |\n| **Build manifest** | `\u003Csource.root_path>\u002F.build-manifest.yaml` | Rebuilt kernel `Image`, in-tree `.ko`, OOT `.ko`, NVIDIA DTBs | Build [`jetson-build-source`](..\u002Fjetson-build-source\u002FSKILL.md) writes here |\n\nThe skill computes the union of files to copy and writes each into\n`\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` with diff-aware\nskip-if-identical logic. When the copy pass touches the kernel\n`Image` or anything under `rootfs\u002Flib\u002Fmodules\u002F`, it also rebuilds\nthe initramfs via NVIDIA's `tools\u002Fl4t_update_initrd.sh` so the\nfreshly promoted kernel + modules ship in the initrd the\nbootloader actually loads. After it returns, `bsp_image` carries\nevery Customize and Build output. The skill does **not** flash and\ndoes **not** modify the workspace.\n\n## When to invoke\n\n- First leg of the typical Deploy chain\n  `jetson-promote-image → jetson-flash-image → jetson-validate-image`.\n- Standalone, when the user wants `bsp_image` updated but isn't\n  ready to flash yet (e.g. to inspect resolved files, run an\n  out-of-band build that reads bsp_image, or hand bsp_image to a\n  separate flashing host).\n\n## Procedure\n\n### Resolve active target + paths\n\nResolve the active profile per the contract in\n[`..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md`](..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md).\n\nRefuse and route in these cases:\n\n| Condition | Refuse with |\n|---|---|\n| No active profile, or `active: NA` | Route to `\u002Fjetson-set-target` or `\u002Fjetson-init-target`. |\n| Profile lacks `bsp_image:` | Route to `\u002Fjetson-init-image`. |\n| `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` missing | Route to `\u002Fjetson-init-image`. |\n| `\u003Csource.root_path>\u002FLinux_for_Tegra\u002F` missing or not a git repo | Route to `\u002Fjetson-init-source`. |\n\nResolve paths:\n\n- `\u003Cworkspace>` = parent of the active profile's `target-platform\u002F`\n  directory (discovered at load time).\n- `\u003Cbsp_image.root_path>` from `bsp_image.root_path:` if present,\n  else `\u003Cworkspace>\u002FImage`.\n- `\u003Csource.root_path>` from `source.root_path:` if present, else\n  `\u003Cworkspace>\u002FSource`.\n\nBind shell variables for the rest of the procedure:\n\n```bash\nLFT_SRC=\"\u003Csource.root_path>\u002FLinux_for_Tegra\"   # overlay tracker\nLFT_DST=\"\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\"\nMANIFEST=\"\u003Csource.root_path>\u002F.build-manifest.yaml\"   # build outputs\n```\n\n### Validate the two channels\n\nThe skill needs at least one channel populated. Refuse if the\noverlay tracker has uncommitted changes (`status --porcelain`\nnon-empty), if `$MANIFEST` exists but doesn't parse as YAML, or\nif both channels are empty. Records `OVERLAY_HAS_COMMITS` \u002F\n`OVERLAY_HEAD` and `MANIFEST_PRESENT` for downstream steps.\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#validate-the-two-channels)\nfor the shell snippet and refuse messages.\n\n### Verify build-source freshness\n\nRefuse if `.build-state.yaml` shows any kernel-side repo in\n`Source\u002Fbsp_sources\u002F` dirty since the last `\u002Fjetson-build-source`\n— otherwise the copy pass would silently ship stale artifacts.\nDetection rules + shell snippet in\n[`references\u002Fbuild-source-freshness-gate.md`](references\u002Fbuild-source-freshness-gate.md).\nRecords `BUILD_FRESH=1`.\n\n### Pre-promote collision check (overlay only)\n\nWhen the overlay tracks a remote, refuse if upstream has commits\nnot yet pulled. Skip gracefully when no remote is configured\n(the default `git init` empty tracker from `jetson-init-source`).\nManifest channel has no git remote concept — this check is\noverlay-only. Records `COLLISION_CHECK` for the Summary.\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#pre-promote-collision-check-overlay-only)\nfor the shell snippet.\n\n### Enumerate sources (both channels)\n\n**Channel A — overlay**: `git ls-files` against `$LFT_SRC` is\nthe source of truth (transparent to symlink mounts when\n`source.repos.Linux_for_Tegra` was overridden, excludes\nuntracked \u002F `.gitignore`d files). Each entry maps\n`src = $LFT_SRC\u002F\u003Crel>` → `dst = $LFT_DST\u002F\u003Crel>`.\n\n**Channel B — manifest**: parse `artifacts[].{src,dst}` from\n`$MANIFEST`. Refuse if any `src` is missing on disk (build was\ninterrupted, or manifest stale — re-run `\u002Fjetson-build-source`).\nThe manifest schema is written by\n[`jetson-build-source` v0.2.0](..\u002Fjetson-build-source\u002Freferences\u002Fmanifest-schema.md).\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#enumerate-sources)\nfor both shell snippets and the manifest YAML schema.\n\n### Diff-aware copy into bsp_image\n\nIterate the union of overlay files and manifest entries. For\neach `dst`: if byte-identical, skip; otherwise `cp -p` (with\n`sudo` for `rootfs\u002F*` destinations, where the sample rootfs\nwas extracted as root). Tag `INITRD_DIRTY=1` on any\n`rootfs\u002Flib\u002Fmodules\u002F*` or `kernel\u002FImage` write — the\n\"Refresh initramfs\" step gates on this flag. Counts \u002F\n`FIRST` \u002F `LAST` are recorded for the Summary.\n\nFail-fast: if any `cp` fails, surface the failed path and stop.\n`bsp_image` may be left partially updated — re-running after\nfixing the cause resumes via the diff-aware skip. **Channel\norder** is overlay first, then manifest: on a `dst` collision\nthe manifest wins (freshly built artifact beats the older\noverlay copy).\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#diff-aware-copy-into-bsp_image)\nfor the `copy_one()` function and the two driving loops.\n\n### Mirror kernel Image into rootfs (when kernel changed)\n\nThe kernel `Image` lives in two paths inside `bsp_image`:\n`\u003CLFT_DST>\u002Fkernel\u002FImage` (read by the flash tool) and\n`\u003CLFT_DST>\u002Frootfs\u002Fboot\u002FImage` (the rootfs-side copy, visible as\n`\u002Fboot\u002FImage` from inside the rootfs chroot the refresh tool\nwill run in). The build manifest only carries the `kernel\u002FImage`\ndst, so this step mirrors `kernel\u002FImage` → `rootfs\u002Fboot\u002FImage`\n(diff-aware, no-op when already in sync) so the chrooted refresh\ntool resolves the kernel against the freshly promoted binary,\nnot the stale rootfs copy. The mirror also sets `INITRD_DIRTY=1`\nso a kernel-only promote (no `rootfs\u002Flib\u002Fmodules\u002F*` writes) still\ntriggers the refresh.\n\nSee [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md#mirror-semantics--kernel-image-lands-in-two-places)\nfor the shell snippet, the failure mode this prevents, and the\n`INITRD_DIRTY` corner case.\n\n### Refresh initramfs (when kernel or modules changed)\n\nRun `tools\u002Fl4t_update_initrd.sh` from `\u003CLFT_DST>\u002F` whenever\n`INITRD_DIRTY=1` (set by the diff-aware copy or the mirror step\nabove). The tool chroots into `rootfs\u002F`, runs NVIDIA's\n`nv-update-initrd`, and writes both\n`\u003CLFT_DST>\u002Fbootloader\u002Fl4t_initrd.img` (used by the flash tool)\nand `\u003CLFT_DST>\u002Frootfs\u002Fboot\u002Finitrd` (`\u002Fboot\u002Finitrd` on the DUT).\nIdempotent; ~30 s. Skip when `INITRD_DIRTY=0` (overlay-only\nedits). DUT-side workarounds (`update-initramfs -u` + manual\n`cp`) are out of scope — fix the gap here so flash ships a\ncoherent image.\n\nSee [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md#refresh-tool--l4t_update_initrdsh)\nfor the shell snippet, refuse paths, the \"module shadowing\" and\n\"vermagic skew\" failure modes the rebuild closes, and why\n`bootloader\u002Finitrd` (a different file) is left alone.\n\n### Summary\n\nReport:\n\n- Overlay scope: `overlay HEAD ($OVERLAY_HEAD)` or \"(empty)\".\n- Manifest scope: `mode=\u003C...>, bsp_version=\u003C...>, rebuilt_at=\u003C...>,\n  N artifacts` or \"(absent)\".\n- Collision check: `$COLLISION_CHECK`.\n- Counts:\n  - overlay: `$COPIED_OVERLAY copied, $IDENTICAL_OVERLAY identical`\n  - manifest: `$COPIED_MANIFEST copied, $IDENTICAL_MANIFEST identical`\n- Kernel Image mirror: `$KIMG_MIRRORED` and initramfs:\n  `$INITRD_STATUS` (`copied …` \u002F `rebuilt` when triggered by\n  `kernel\u002FImage` or `rootfs\u002Flib\u002Fmodules\u002F*` writes; `skipped …`\n  otherwise).\n- First \u002F last paths copied (omit if both `COPIED` totals are 0).\n- Resolved `\u003Csource.root_path>`, `\u003Cbsp_image.root_path>`.\n- Next step: `\u002Fjetson-flash-image` (or `\u002Fjetson-validate-image` if\n  the user only wanted bsp_image refreshed for inspection \u002F static\n  validation).\n\n## Limitations\n\n- **Two channels, one destination.** `bsp_image\u002FLinux_for_Tegra\u002F`\n  is written by both passes. Overlay carries customize-* outputs\n  (overlay-only edits like nvfancontrol.conf); manifest carries\n  rebuilt binaries (kernel\u002FOOT\u002FDT). The two are intentionally\n  disjoint by construction: build outputs don't go into the\n  overlay, and customize-* edits to non-build files don't enter\n  the manifest.\n- **Build manifest is the trace-to-dirty contract.** Anything in\n  the manifest came from a dirty source repo (per\n  `jetson-build-source`'s \"Write the build manifest\" step trace policy). Promoting the\n  manifest is therefore safe: every entry is a customization-bearing\n  artifact, not toolchain-divergence noise. The skill does not\n  re-derive the trace — it trusts the manifest.\n- **Manifest entries can outlive their build outputs.** If the\n  user wipes `Source\u002F.build\u002F` or `bsp_sources\u002F`'s build artifacts\n  between `jetson-build-source` and `jetson-promote-image`, the\n  manifest will reference missing files. The \"Enumerate sources (both channels)\" step refuses in that\n  case and points the user at `\u002Fjetson-build-source` to rebuild.\n- **Manifest absence is fine when only overlay edits happened.**\n  A purely overlay-side customization (e.g. `customize-fan`)\n  produces no build outputs and writes no manifest — the \"Enumerate sources (both channels)\" step is a\n  no-op, the \"Diff-aware copy into bsp_image\" step promotes only overlay files. The skill prints\n  \"manifest: (absent)\" in the summary and continues.\n- **Diff-aware, idempotent.** Re-running with no overlay commits\n  or manifest changes since the last promote is a no-op (all\n  files identical). Use this to confirm bsp_image is in sync\n  without side effects.\n- **Symlink-mount transparency.** When\n  `source.repos.Linux_for_Tegra` was overridden in\n  `jetson-init-source`, the canonical mount is a symlink into\n  `\u003Csource.root_path>\u002F.repos\u002FLinux_for_Tegra\u002F\u003Csubdir>`. `git -C`,\n  `cp -p`, and `cmp -s` all follow it transparently — no special\n  handling needed at this layer. Manifest `src` paths are\n  absolute, so symlinks under `bsp_sources\u002F` don't matter for the\n  manifest channel.\n- **`sudo` is scoped to `rootfs\u002F` destinations.** Files under\n  `rootfs\u002F` were extracted with `sudo tar xpjf` by\n  `jetson-init-image`, so they carry root ownership and special\n  mode bits the flashing toolchain reads back. `sudo cp -p`\n  preserves them. Everything else (`bootloader\u002F`, `kernel\u002F`,\n  `kernel\u002Fdtb\u002F`, `tools\u002F`, etc.) is user-owned and does not need\n  `sudo`. This applies to both channels.\n- **Channel-overlap precedence.** If the same `dst` appears in\n  both overlay and manifest, manifest wins (later in the \"Diff-aware copy into bsp_image\" step's\n  loop). This is the desired semantic — manifest entries are\n  freshly built, overlay entries may be older state. Hand-editing\n  binary files into the overlay is discouraged (Build's job\n  is to rebuild them); the precedence rule makes such mistakes\n  recoverable.\n- **`bsp_image` is read-only outside Deploy.** This skill is the\n  only writer in the normal flow (matches the workflow invariant).\n  Hand-edits to `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` outside\n  Deploy will be silently overwritten on the next promote run if\n  the same path exists in either channel; conversely they will\n  *not* be reverted if no entry shadows them. Both behaviors are\n  wrong for the diff trail — never hand-edit upstream.\n- **Scope is overlay HEAD only (channel A).** Named tags \u002F\n  manifests \u002F commit ranges are deferred (see below). To promote\n  a historical state, `git -C $LFT_SRC checkout \u003Cref>` first,\n  then re-run. The manifest channel has no ranged scope — it\n  reflects whatever `jetson-build-source`'s last run produced.\n- **No automatic rollback on partial failure.** If `cp` fails\n  partway through, `bsp_image` is left in an intermediate state.\n  Fix the underlying cause (usually permissions \u002F disk full) and\n  re-run — the \"Diff-aware copy into bsp_image\" step will resume by skipping already-promoted files.\n- **Kernel `Image` mirror + initramfs refresh.** Gated on copy-pass\n  writes to `kernel\u002FImage` or `rootfs\u002Flib\u002Fmodules\u002F*`; the mirror\n  feeds the refresh's chroot. Both are diff-aware and skipped on\n  pure-overlay edits. `tools\u002Fl4t_update_initrd.sh` must exist in\n  `bsp_image` (ships with `apply_binaries.sh`); a missing tool\n  refuses and routes to `\u002Fjetson-init-image`. See\n  [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md)\n  for the full contract and failure modes.\n\n## Troubleshooting\n\n| Error | Cause | Solution |\n|---|---|---|\n| `Overlay has uncommitted changes at \u003CLFT_SRC>` | Customize-* edits not committed before promote | Run `git -C $LFT_SRC commit` (or stash), then re-run. |\n| `origin has N unpulled commits on \u003Cupstream>` | Remote overlay diverged from local | `git -C $LFT_SRC pull`, resolve conflicts, then re-run. |\n| `Both overlay and manifest are empty — nothing to promote` | No Customize-* commits and no Build manifest | Run a customize-* skill or `\u002Fjetson-build-source` first. |\n| `Kernel-side source(s) changed since last \u002Fjetson-build-source` | Freshness gate detected unprocessed customize-* edits under `Source\u002Fbsp_sources\u002F` | Commit pending edits, run `\u002Fjetson-build-source`, re-run promote. |\n| `Manifest entry references missing build output: \u003Csrc>` | `bsp_sources\u002F` build outputs wiped or stale manifest | Re-run `\u002Fjetson-build-source` to regenerate. |\n| `Build manifest at \u003CMANIFEST> is not valid YAML` | Manifest hand-edited or partially written | Re-run `\u002Fjetson-build-source` to rewrite the manifest. |\n| `cp: permission denied` under `rootfs\u002F` | Missing `sudo` privilege on the host | Run on an account that can `sudo cp`; re-run resumes via diff-aware copy. |\n| Profile lacks `bsp_image:` \u002F `source:` | Workspace not bootstrapped | Run `\u002Fjetson-init-image` and\u002For `\u002Fjetson-init-source`. |\n| `tool not found at \u003CLFT_DST>\u002Ftools\u002Fl4t_update_initrd.sh` | `tools\u002F` was pruned, or bsp_image extracted from a non-NVIDIA tarball | Re-run `\u002Fjetson-init-image` to repopulate. |\n| `l4t_update_initrd.sh exited non-zero` | Insufficient sudo, broken rootfs (missing `lib\u002Fmodules\u002F\u003Cver>\u002Fmodules.dep`), or out-of-space `\u002Ftmp` | Run `depmod -a -b \u003CLFT_DST>\u002Frootfs \u003Cver>` against the rootfs first; verify `\u002Ftmp` headroom; rerun promote. |\n| DUT boots with stale kernel \u002F modules after promote, modules fail to load with `disagrees about version of symbol …`, or initramfs ships pre-customize modules even after the refresh ran | The mirror \u002F refresh gate didn't fire (manual hand-edit under `\u003CLFT_DST>` outside the skill), or `rootfs\u002Fboot\u002FImage` drifted from `kernel\u002FImage` so the chrooted refresh built against the stale kernel | Force the gate by `sudo touch \u003CLFT_DST>\u002Fkernel\u002FImage` + re-run promote, or run the two steps manually: `sudo cp -p \u003CLFT_DST>\u002Fkernel\u002FImage \u003CLFT_DST>\u002Frootfs\u002Fboot\u002FImage && cd \u003CLFT_DST> && sudo .\u002Ftools\u002Fl4t_update_initrd.sh`. Then re-flash. See [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md). |\n\n## Spec status\n\n**Locked in for v0.2.0:**\n\n- **Two-channel scope** — overlay HEAD + build manifest, both\n  diff-aware, both copying into `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F`.\n- **Channel-overlap precedence** — manifest wins on `dst` collision.\n- **Source-repo collision check** — overlay only; manifest has no\n  remote concept and source repos under `bsp_sources\u002F` are not\n  fetched (their state was sealed when `jetson-build-source`\n  wrote the manifest).\n- **Atomicity** — fail-fast, no rollback. Diff-aware copy makes\n  resume natural.\n- **Audit trail** — stdout-only at promote time. The overlay\n  tracker's git log is the canonical record for channel A; the\n  manifest itself is the canonical record for channel B.\n- **Kernel Image mirror + initramfs refresh.** Locked in as a\n  paired step. The mirror copies `kernel\u002FImage` →\n  `rootfs\u002Fboot\u002FImage` whenever the copy pass touched\n  `kernel\u002FImage`; the refresh runs\n  `tools\u002Fl4t_update_initrd.sh` whenever `kernel\u002FImage` or any\n  `rootfs\u002Flib\u002Fmodules\u002F*` was promoted, rebuilding both\n  `bootloader\u002Fl4t_initrd.img` and `rootfs\u002Fboot\u002Finitrd`.\n  Inseparable because the refresh chroots into `rootfs\u002F` and\n  resolves the kernel through `\u002Fboot\u002FImage` — the mirror has to\n  run first. Closes both module-shadowing and vermagic-skew\n  failure modes; both diff-aware, both skipped on overlay-only\n  edits. Full contract in\n  [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md).\n\n**Still deferred:**\n\n- **Named-tag \u002F commit-range scope** for the overlay channel.\n  Revisit when a \"promote release X\" use case appears.\n- **Manifest history.** Currently only the last build's manifest\n  exists; if a user wants to roll bsp_image back to a previous\n  build state, they'd need to re-run `\u002Fjetson-build-source` at\n  the prior commit. A manifest archive (saved per-build-mode or\n  per-commit) would enable rollback without rebuild.\n- **Sidecar manifest in `bsp_image`.** Revisit when promotion\n  happens on a host that does not have access to the overlay\n  tracker repo (or the workspace's manifest file).\n\n## References\n\n- [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md) — full contract for the kernel `Image` mirror + `l4t_update_initrd.sh` refresh: shell snippets, failure modes, tool semantics, output filenames.\n- [`..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md`](..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md) — target-platform contract.\n- [`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md#workflow-invariants) — workspace edit protocol (this skill is the promote leg of Deploy).\n- [`..\u002Fjetson-init-source\u002FSKILL.md`](..\u002Fjetson-init-source\u002FSKILL.md) — Setup; materializes the overlay tracker this skill reads (channel A) and authors `source.toolchain`.\n- [`..\u002Fjetson-build-source\u002FSKILL.md`](..\u002Fjetson-build-source\u002FSKILL.md) — Build builder; writes the `.build-manifest.yaml` this skill reads (channel B).\n- [`..\u002Fjetson-flash-image\u002FSKILL.md`](..\u002Fjetson-flash-image\u002FSKILL.md) — next leg; flashes the just-promoted bsp_image to the DUT.\n- [`..\u002Fjetson-validate-image\u002FSKILL.md`](..\u002Fjetson-validate-image\u002FSKILL.md) — final leg; static + on-target validation.\n","# Promote BSP Image\n\n## Purpose\n\nStage every Customize-* and Build output into `bsp_image` so it is\nready for `\u002Fjetson-flash-image`. This is the **promote leg of\nDeploy** — it copies files, never flashes and never builds.\n\n## Prerequisites\n\n- Active target-platform profile with both `source:` and `bsp_image:`\n  resolved (run `\u002Fjetson-init-source` and `\u002Fjetson-init-image` first).\n- `\u003Csource.root_path>\u002FLinux_for_Tegra\u002F` initialized as a git repo\n  (overlay tracker) with a clean working tree.\n- `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` extracted from a BSP\n  tarball + `apply_binaries.sh` already run.\n- `git`, `yq`, `cmp`, and `sudo` (for `rootfs\u002F*` destinations) on\n  the host.\n- `\u003Csource.root_path>\u002F.build-manifest.yaml` + `.build-state.yaml`\n  from `\u002Fjetson-build-source` (required when kernel-side repos\n  have customize-* commits).\n\n## Overview\n\nThis is the **promote leg of Deploy** — see\n[`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md)\nfor the pipeline view. The two channels this skill walks are:\n\n| Channel | Source | Carrier | Owner |\n|---|---|---|---|\n| **Overlay tracker** | `\u003Csource.root_path>\u002FLinux_for_Tegra\u002F` (git repo at HEAD) | Customize-* outputs that don't require a build (e.g. `nvfancontrol.conf`, `nvpmodel.conf`, BPMP DTB hand-edits) | Customize `customize-*` skills commit here |\n| **Build manifest** | `\u003Csource.root_path>\u002F.build-manifest.yaml` | Rebuilt kernel `Image`, in-tree `.ko`, OOT `.ko`, NVIDIA DTBs | Build [`jetson-build-source`](..\u002Fjetson-build-source\u002FSKILL.md) writes here |\n\nThe skill computes the union of files to copy and writes each into\n`\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` with diff-aware\nskip-if-identical logic. When the copy pass touches the kernel\n`Image` or anything under `rootfs\u002Flib\u002Fmodules\u002F`, it also rebuilds\nthe initramfs via NVIDIA's `tools\u002Fl4t_update_initrd.sh` so the\nfreshly promoted kernel + modules ship in the initrd the\nbootloader actually loads. After it returns, `bsp_image` carries\nevery Customize and Build output. The skill does **not** flash and\ndoes **not** modify the workspace.\n\n## When to invoke\n\n- First leg of the typical Deploy chain\n  `jetson-promote-image → jetson-flash-image → jetson-validate-image`.\n- Standalone, when the user wants `bsp_image` updated but isn't\n  ready to flash yet (e.g. to inspect resolved files, run an\n  out-of-band build that reads bsp_image, or hand bsp_image to a\n  separate flashing host).\n\n## Procedure\n\n### Resolve active target + paths\n\nResolve the active profile per the contract in\n[`..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md`](..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md).\n\nRefuse and route in these cases:\n\n| Condition | Refuse with |\n|---|---|\n| No active profile, or `active: NA` | Route to `\u002Fjetson-set-target` or `\u002Fjetson-init-target`. |\n| Profile lacks `bsp_image:` | Route to `\u002Fjetson-init-image`. |\n| `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` missing | Route to `\u002Fjetson-init-image`. |\n| `\u003Csource.root_path>\u002FLinux_for_Tegra\u002F` missing or not a git repo | Route to `\u002Fjetson-init-source`. |\n\nResolve paths:\n\n- `\u003Cworkspace>` = parent of the active profile's `target-platform\u002F`\n  directory (discovered at load time).\n- `\u003Cbsp_image.root_path>` from `bsp_image.root_path:` if present,\n  else `\u003Cworkspace>\u002FImage`.\n- `\u003Csource.root_path>` from `source.root_path:` if present, else\n  `\u003Cworkspace>\u002FSource`.\n\nBind shell variables for the rest of the procedure:\n\n```bash\nLFT_SRC=\"\u003Csource.root_path>\u002FLinux_for_Tegra\"   # overlay tracker\nLFT_DST=\"\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\"\nMANIFEST=\"\u003Csource.root_path>\u002F.build-manifest.yaml\"   # build outputs\n```\n\n### Validate the two channels\n\nThe skill needs at least one channel populated. Refuse if the\noverlay tracker has uncommitted changes (`status --porcelain`\nnon-empty), if `$MANIFEST` exists but doesn't parse as YAML, or\nif both channels are empty. Records `OVERLAY_HAS_COMMITS` \u002F\n`OVERLAY_HEAD` and `MANIFEST_PRESENT` for downstream steps.\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#validate-the-two-channels)\nfor the shell snippet and refuse messages.\n\n### Verify build-source freshness\n\nRefuse if `.build-state.yaml` shows any kernel-side repo in\n`Source\u002Fbsp_sources\u002F` dirty since the last `\u002Fjetson-build-source`\n— otherwise the copy pass would silently ship stale artifacts.\nDetection rules + shell snippet in\n[`references\u002Fbuild-source-freshness-gate.md`](references\u002Fbuild-source-freshness-gate.md).\nRecords `BUILD_FRESH=1`.\n\n### Pre-promote collision check (overlay only)\n\nWhen the overlay tracks a remote, refuse if upstream has commits\nnot yet pulled. Skip gracefully when no remote is configured\n(the default `git init` empty tracker from `jetson-init-source`).\nManifest channel has no git remote concept — this check is\noverlay-only. Records `COLLISION_CHECK` for the Summary.\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#pre-promote-collision-check-overlay-only)\nfor the shell snippet.\n\n### Enumerate sources (both channels)\n\n**Channel A — overlay**: `git ls-files` against `$LFT_SRC` is\nthe source of truth (transparent to symlink mounts when\n`source.repos.Linux_for_Tegra` was overridden, excludes\nuntracked \u002F `.gitignore`d files). Each entry maps\n`src = $LFT_SRC\u002F\u003Crel>` → `dst = $LFT_DST\u002F\u003Crel>`.\n\n**Channel B — manifest**: parse `artifacts[].{src,dst}` from\n`$MANIFEST`. Refuse if any `src` is missing on disk (build was\ninterrupted, or manifest stale — re-run `\u002Fjetson-build-source`).\nThe manifest schema is written by\n[`jetson-build-source` v0.2.0](..\u002Fjetson-build-source\u002Freferences\u002Fmanifest-schema.md).\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#enumerate-sources)\nfor both shell snippets and the manifest YAML schema.\n\n### Diff-aware copy into bsp_image\n\nIterate the union of overlay files and manifest entries. For\neach `dst`: if byte-identical, skip; otherwise `cp -p` (with\n`sudo` for `rootfs\u002F*` destinations, where the sample rootfs\nwas extracted as root). Tag `INITRD_DIRTY=1` on any\n`rootfs\u002Flib\u002Fmodules\u002F*` or `kernel\u002FImage` write — the\n\"Refresh initramfs\" step gates on this flag. Counts \u002F\n`FIRST` \u002F `LAST` are recorded for the Summary.\n\nFail-fast: if any `cp` fails, surface the failed path and stop.\n`bsp_image` may be left partially updated — re-running after\nfixing the cause resumes via the diff-aware skip. **Channel\norder** is overlay first, then manifest: on a `dst` collision\nthe manifest wins (freshly built artifact beats the older\noverlay copy).\n\nSee [`references\u002Fcopy-pass-snippets.md`](references\u002Fcopy-pass-snippets.md#diff-aware-copy-into-bsp_image)\nfor the `copy_one()` function and the two driving loops.\n\n### Mirror kernel Image into rootfs (when kernel changed)\n\nThe kernel `Image` lives in two paths inside `bsp_image`:\n`\u003CLFT_DST>\u002Fkernel\u002FImage` (read by the flash tool) and\n`\u003CLFT_DST>\u002Frootfs\u002Fboot\u002FImage` (the rootfs-side copy, visible as\n`\u002Fboot\u002FImage` from inside the rootfs chroot the refresh tool\nwill run in). The build manifest only carries the `kernel\u002FImage`\ndst, so this step mirrors `kernel\u002FImage` → `rootfs\u002Fboot\u002FImage`\n(diff-aware, no-op when already in sync) so the chrooted refresh\ntool resolves the kernel against the freshly promoted binary,\nnot the stale rootfs copy. The mirror also sets `INITRD_DIRTY=1`\nso a kernel-only promote (no `rootfs\u002Flib\u002Fmodules\u002F*` writes) still\ntriggers the refresh.\n\nSee [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md#mirror-semantics--kernel-image-lands-in-two-places)\nfor the shell snippet, the failure mode this prevents, and the\n`INITRD_DIRTY` corner case.\n\n### Refresh initramfs (when kernel or modules changed)\n\nRun `tools\u002Fl4t_update_initrd.sh` from `\u003CLFT_DST>\u002F` whenever\n`INITRD_DIRTY=1` (set by the diff-aware copy or the mirror step\nabove). The tool chroots into `rootfs\u002F`, runs NVIDIA's\n`nv-update-initrd`, and writes both\n`\u003CLFT_DST>\u002Fbootloader\u002Fl4t_initrd.img` (used by the flash tool)\nand `\u003CLFT_DST>\u002Frootfs\u002Fboot\u002Finitrd` (`\u002Fboot\u002Finitrd` on the DUT).\nIdempotent; ~30 s. Skip when `INITRD_DIRTY=0` (overlay-only\nedits). DUT-side workarounds (`update-initramfs -u` + manual\n`cp`) are out of scope — fix the gap here so flash ships a\ncoherent image.\n\nSee [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md#refresh-tool--l4t_update_initrdsh)\nfor the shell snippet, refuse paths, the \"module shadowing\" and\n\"vermagic skew\" failure modes the rebuild closes, and why\n`bootloader\u002Finitrd` (a different file) is left alone.\n\n### Summary\n\nReport:\n\n- Overlay scope: `overlay HEAD ($OVERLAY_HEAD)` or \"(empty)\".\n- Manifest scope: `mode=\u003C...>, bsp_version=\u003C...>, rebuilt_at=\u003C...>,\n  N artifacts` or \"(absent)\".\n- Collision check: `$COLLISION_CHECK`.\n- Counts:\n  - overlay: `$COPIED_OVERLAY copied, $IDENTICAL_OVERLAY identical`\n  - manifest: `$COPIED_MANIFEST copied, $IDENTICAL_MANIFEST identical`\n- Kernel Image mirror: `$KIMG_MIRRORED` and initramfs:\n  `$INITRD_STATUS` (`copied …` \u002F `rebuilt` when triggered by\n  `kernel\u002FImage` or `rootfs\u002Flib\u002Fmodules\u002F*` writes; `skipped …`\n  otherwise).\n- First \u002F last paths copied (omit if both `COPIED` totals are 0).\n- Resolved `\u003Csource.root_path>`, `\u003Cbsp_image.root_path>`.\n- Next step: `\u002Fjetson-flash-image` (or `\u002Fjetson-validate-image` if\n  the user only wanted bsp_image refreshed for inspection \u002F static\n  validation).\n\n## Limitations\n\n- **Two channels, one destination.** `bsp_image\u002FLinux_for_Tegra\u002F`\n  is written by both passes. Overlay carries customize-* outputs\n  (overlay-only edits like nvfancontrol.conf); manifest carries\n  rebuilt binaries (kernel\u002FOOT\u002FDT). The two are intentionally\n  disjoint by construction: build outputs don't go into the\n  overlay, and customize-* edits to non-build files don't enter\n  the manifest.\n- **Build manifest is the trace-to-dirty contract.** Anything in\n  the manifest came from a dirty source repo (per\n  `jetson-build-source`'s \"Write the build manifest\" step trace policy). Promoting the\n  manifest is therefore safe: every entry is a customization-bearing\n  artifact, not toolchain-divergence noise. The skill does not\n  re-derive the trace — it trusts the manifest.\n- **Manifest entries can outlive their build outputs.** If the\n  user wipes `Source\u002F.build\u002F` or `bsp_sources\u002F`'s build artifacts\n  between `jetson-build-source` and `jetson-promote-image`, the\n  manifest will reference missing files. The \"Enumerate sources (both channels)\" step refuses in that\n  case and points the user at `\u002Fjetson-build-source` to rebuild.\n- **Manifest absence is fine when only overlay edits happened.**\n  A purely overlay-side customization (e.g. `customize-fan`)\n  produces no build outputs and writes no manifest — the \"Enumerate sources (both channels)\" step is a\n  no-op, the \"Diff-aware copy into bsp_image\" step promotes only overlay files. The skill prints\n  \"manifest: (absent)\" in the summary and continues.\n- **Diff-aware, idempotent.** Re-running with no overlay commits\n  or manifest changes since the last promote is a no-op (all\n  files identical). Use this to confirm bsp_image is in sync\n  without side effects.\n- **Symlink-mount transparency.** When\n  `source.repos.Linux_for_Tegra` was overridden in\n  `jetson-init-source`, the canonical mount is a symlink into\n  `\u003Csource.root_path>\u002F.repos\u002FLinux_for_Tegra\u002F\u003Csubdir>`. `git -C`,\n  `cp -p`, and `cmp -s` all follow it transparently — no special\n  handling needed at this layer. Manifest `src` paths are\n  absolute, so symlinks under `bsp_sources\u002F` don't matter for the\n  manifest channel.\n- **`sudo` is scoped to `rootfs\u002F` destinations.** Files under\n  `rootfs\u002F` were extracted with `sudo tar xpjf` by\n  `jetson-init-image`, so they carry root ownership and special\n  mode bits the flashing toolchain reads back. `sudo cp -p`\n  preserves them. Everything else (`bootloader\u002F`, `kernel\u002F`,\n  `kernel\u002Fdtb\u002F`, `tools\u002F`, etc.) is user-owned and does not need\n  `sudo`. This applies to both channels.\n- **Channel-overlap precedence.** If the same `dst` appears in\n  both overlay and manifest, manifest wins (later in the \"Diff-aware copy into bsp_image\" step's\n  loop). This is the desired semantic — manifest entries are\n  freshly built, overlay entries may be older state. Hand-editing\n  binary files into the overlay is discouraged (Build's job\n  is to rebuild them); the precedence rule makes such mistakes\n  recoverable.\n- **`bsp_image` is read-only outside Deploy.** This skill is the\n  only writer in the normal flow (matches the workflow invariant).\n  Hand-edits to `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F` outside\n  Deploy will be silently overwritten on the next promote run if\n  the same path exists in either channel; conversely they will\n  *not* be reverted if no entry shadows them. Both behaviors are\n  wrong for the diff trail — never hand-edit upstream.\n- **Scope is overlay HEAD only (channel A).** Named tags \u002F\n  manifests \u002F commit ranges are deferred (see below). To promote\n  a historical state, `git -C $LFT_SRC checkout \u003Cref>` first,\n  then re-run. The manifest channel has no ranged scope — it\n  reflects whatever `jetson-build-source`'s last run produced.\n- **No automatic rollback on partial failure.** If `cp` fails\n  partway through, `bsp_image` is left in an intermediate state.\n  Fix the underlying cause (usually permissions \u002F disk full) and\n  re-run — the \"Diff-aware copy into bsp_image\" step will resume by skipping already-promoted files.\n- **Kernel `Image` mirror + initramfs refresh.** Gated on copy-pass\n  writes to `kernel\u002FImage` or `rootfs\u002Flib\u002Fmodules\u002F*`; the mirror\n  feeds the refresh's chroot. Both are diff-aware and skipped on\n  pure-overlay edits. `tools\u002Fl4t_update_initrd.sh` must exist in\n  `bsp_image` (ships with `apply_binaries.sh`); a missing tool\n  refuses and routes to `\u002Fjetson-init-image`. See\n  [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md)\n  for the full contract and failure modes.\n\n## Troubleshooting\n\n| Error | Cause | Solution |\n|---|---|---|\n| `Overlay has uncommitted changes at \u003CLFT_SRC>` | Customize-* edits not committed before promote | Run `git -C $LFT_SRC commit` (or stash), then re-run. |\n| `origin has N unpulled commits on \u003Cupstream>` | Remote overlay diverged from local | `git -C $LFT_SRC pull`, resolve conflicts, then re-run. |\n| `Both overlay and manifest are empty — nothing to promote` | No Customize-* commits and no Build manifest | Run a customize-* skill or `\u002Fjetson-build-source` first. |\n| `Kernel-side source(s) changed since last \u002Fjetson-build-source` | Freshness gate detected unprocessed customize-* edits under `Source\u002Fbsp_sources\u002F` | Commit pending edits, run `\u002Fjetson-build-source`, re-run promote. |\n| `Manifest entry references missing build output: \u003Csrc>` | `bsp_sources\u002F` build outputs wiped or stale manifest | Re-run `\u002Fjetson-build-source` to regenerate. |\n| `Build manifest at \u003CMANIFEST> is not valid YAML` | Manifest hand-edited or partially written | Re-run `\u002Fjetson-build-source` to rewrite the manifest. |\n| `cp: permission denied` under `rootfs\u002F` | Missing `sudo` privilege on the host | Run on an account that can `sudo cp`; re-run resumes via diff-aware copy. |\n| Profile lacks `bsp_image:` \u002F `source:` | Workspace not bootstrapped | Run `\u002Fjetson-init-image` and\u002For `\u002Fjetson-init-source`. |\n| `tool not found at \u003CLFT_DST>\u002Ftools\u002Fl4t_update_initrd.sh` | `tools\u002F` was pruned, or bsp_image extracted from a non-NVIDIA tarball | Re-run `\u002Fjetson-init-image` to repopulate. |\n| `l4t_update_initrd.sh exited non-zero` | Insufficient sudo, broken rootfs (missing `lib\u002Fmodules\u002F\u003Cver>\u002Fmodules.dep`), or out-of-space `\u002Ftmp` | Run `depmod -a -b \u003CLFT_DST>\u002Frootfs \u003Cver>` against the rootfs first; verify `\u002Ftmp` headroom; rerun promote. |\n| DUT boots with stale kernel \u002F modules after promote, modules fail to load with `disagrees about version of symbol …`, or initramfs ships pre-customize modules even after the refresh ran | The mirror \u002F refresh gate didn't fire (manual hand-edit under `\u003CLFT_DST>` outside the skill), or `rootfs\u002Fboot\u002FImage` drifted from `kernel\u002FImage` so the chrooted refresh built against the stale kernel | Force the gate by `sudo touch \u003CLFT_DST>\u002Fkernel\u002FImage` + re-run promote, or run the two steps manually: `sudo cp -p \u003CLFT_DST>\u002Fkernel\u002FImage \u003CLFT_DST>\u002Frootfs\u002Fboot\u002FImage && cd \u003CLFT_DST> && sudo .\u002Ftools\u002Fl4t_update_initrd.sh`. Then re-flash. See [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md). |\n\n## Spec status\n\n**Locked in for v0.2.0:**\n\n- **Two-channel scope** — overlay HEAD + build manifest, both\n  diff-aware, both copying into `\u003Cbsp_image.root_path>\u002FLinux_for_Tegra\u002F`.\n- **Channel-overlap precedence** — manifest wins on `dst` collision.\n- **Source-repo collision check** — overlay only; manifest has no\n  remote concept and source repos under `bsp_sources\u002F` are not\n  fetched (their state was sealed when `jetson-build-source`\n  wrote the manifest).\n- **Atomicity** — fail-fast, no rollback. Diff-aware copy makes\n  resume natural.\n- **Audit trail** — stdout-only at promote time. The overlay\n  tracker's git log is the canonical record for channel A; the\n  manifest itself is the canonical record for channel B.\n- **Kernel Image mirror + initramfs refresh.** Locked in as a\n  paired step. The mirror copies `kernel\u002FImage` →\n  `rootfs\u002Fboot\u002FImage` whenever the copy pass touched\n  `kernel\u002FImage`; the refresh runs\n  `tools\u002Fl4t_update_initrd.sh` whenever `kernel\u002FImage` or any\n  `rootfs\u002Flib\u002Fmodules\u002F*` was promoted, rebuilding both\n  `bootloader\u002Fl4t_initrd.img` and `rootfs\u002Fboot\u002Finitrd`.\n  Inseparable because the refresh chroots into `rootfs\u002F` and\n  resolves the kernel through `\u002Fboot\u002FImage` — the mirror has to\n  run first. Closes both module-shadowing and vermagic-skew\n  failure modes; both diff-aware, both skipped on overlay-only\n  edits. Full contract in\n  [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md).\n\n**Still deferred:**\n\n- **Named-tag \u002F commit-range scope** for the overlay channel.\n  Revisit when a \"promote release X\" use case appears.\n- **Manifest history.** Currently only the last build's manifest\n  exists; if a user wants to roll bsp_image back to a previous\n  build state, they'd need to re-run `\u002Fjetson-build-source` at\n  the prior commit. A manifest archive (saved per-build-mode or\n  per-commit) would enable rollback without rebuild.\n- **Sidecar manifest in `bsp_image`.** Revisit when promotion\n  happens on a host that does not have access to the overlay\n  tracker repo (or the workspace's manifest file).\n\n## References\n\n- [`references\u002Fkernel-image-and-initramfs.md`](references\u002Fkernel-image-and-initramfs.md) — full contract for the kernel `Image` mirror + `l4t_update_initrd.sh` refresh: shell snippets, failure modes, tool semantics, output filenames.\n- [`..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md`](..\u002F..\u002Fcontext\u002Ftarget-platform-contract.md) — target-platform contract.\n- [`..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md`](..\u002F..\u002Fcontext\u002Fbsp-customization-workflow.md#workflow-invariants) — workspace edit protocol (this skill is the promote leg of Deploy).\n- [`..\u002Fjetson-init-source\u002FSKILL.md`](..\u002Fjetson-init-source\u002FSKILL.md) — Setup; materializes the overlay tracker this skill reads (channel A) and authors `source.toolchain`.\n- [`..\u002Fjetson-build-source\u002FSKILL.md`](..\u002Fjetson-build-source\u002FSKILL.md) — Build builder; writes the `.build-manifest.yaml` this skill reads (channel B).\n- [`..\u002Fjetson-flash-image\u002FSKILL.md`](..\u002Fjetson-flash-image\u002FSKILL.md) — next leg; flashes the just-promoted bsp_image to the DUT.\n- [`..\u002Fjetson-validate-image\u002FSKILL.md`](..\u002Fjetson-validate-image\u002FSKILL.md) — final leg; static + on-target validation.\n",{"name":5,"license":15,"version":24,"metadata":25,"description":7},"0.0.1",{"tags":26,"team":30,"author":31,"domain":32,"data-classification":33},[27,28,29],"bsp","promote","deploy","pts","Jetson Team","meta","public","main","8859218955d9504cd18b59e7892100718039d3b4","data\u002Fskills\u002Fnvidia-skills\u002Fjetson-promote-image",1,"https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper","https:\u002F\u002Fgithub.com\u002Fom-scogo","SDE-1 @ Scogo ","2026-07-18 12:22:46",{"source":8,"skillName":5,"commands":43,"prompt":53,"zipAvailable":54},[44,47,50],{"tool":45,"command":46},"npx","npx skills add om-scogo\u002Fskillsh-scraper --skill jetson-promote-image",{"tool":48,"command":49},"bunx","bunx skills add om-scogo\u002Fskillsh-scraper --skill jetson-promote-image",{"tool":51,"command":52},"pnpm","pnpm dlx skills add om-scogo\u002Fskillsh-scraper --skill jetson-promote-image","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fnvidia-skills\u002Fjetson-promote-image\u002FSkill.md",true,[56],{"path":57,"resourceType":58,"resourceTypeDesc":59,"sizeBytes":60,"sourceHtmlUrl":61},"metadata.json","REFERENCE","参考文档",429,"https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fnvidia-skills\u002Fjetson-promote-image\u002Fmetadata.json",[63,71,76,83,88,95],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":19},"01M7D6MC9FAAEV4CMNYX8W7JTG","arxiv-search","Search arXiv physics, math, and computer science preprints using natural language queries. Powered by Valyu semantic search.","MIT","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fyorkeccak-scientific-skills\u002Farxiv-search\u002Fskills\u002Farxiv-search\u002FSKILL.md",[],[],{"skillNo":72,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":19},"01M7D6M85CKKN87TA98VCQV4H7","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fyorkeccak-scientific-skills\u002Farxiv-search\u002FSkill.md",[],[],{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":19},"01M7D4ZTCS4DR3CE4JY06X84T2","working-with-legacy-code","Safely change and test untested codebases using Feathers' \"Working Effectively with Legacy Code\". Use when the user mentions \"legacy code\", \"no tests\", \"untested codebase\", \"how do I test this\", \"seams\", \"characterization tests\", \"golden master\", \"sprout method\", \"afraid to change this code\", \"monster method\", \"dependency breaking\", or \"inherited a messy codebase\". Also trigger when changing code without tests safely, getting a class under test when constructors, statics, or singletons block it, adding features to tangled modules, or planning incremental test coverage for an old codebase. Covers the legacy-code change algorithm, seams, characterization tests, sprout\u002Fwrap, and dependency-breaking techniques. For refactoring code that already has tests, see refactoring-patterns. For day-to-day code quality, see clean-code.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fworking-with-legacy-code\u002Fworking-with-legacy-code\u002FSKILL.md",[],[],{"skillNo":84,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":19},"01M7D4ZHZKJD2RSNGAF63V14P4","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fworking-with-legacy-code\u002FSkill.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":19},"01M7D4ZB4CJBFW5JE67CPH2QRV","web-typography","Select, pair, and implement typefaces for web projects. Use when the user mentions \"font pairing\", \"which typeface\", \"line height\", \"responsive typography\", \"web font loading\", \"type hierarchy\", \"variable fonts\", \"FOUT\u002FFOIT\", \"typographic scale\", or \"the text is hard to read\". Also trigger when choosing between system fonts and web fonts, optimizing font-loading performance, or designing readable long-form content. Covers readability evaluation, CSS implementation, and performance optimization. For overall UI design systems, see refactoring-ui. For dramatic typographic experiences, see top-design.","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fweb-typography\u002Fweb-typography\u002FSKILL.md",[],[],{"skillNo":96,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":67,"licenseFileUrl":6,"sourceHtmlUrl":97,"categories":98,"keywords":99,"publishedAt":19},"01M7D4Z4MVYVY3NMJ18BNV6WNA","https:\u002F\u002Fgithub.com\u002Fom-scogo\u002Fskillsh-scraper\u002Fblob\u002Fmain\u002Fdata\u002Fskills\u002Fwondelai-skills\u002Fweb-typography\u002FSkill.md",[],[]]