fix(build): auto-resolve snapshot dependency closure (#638)

[Ulrond]

Closes #638.

Problem

./build_modules.sh videosink --version 0.2.0.0 fails on a fresh checkout with fatal error: com/rdk/hal/PropertyValue.h: No such file or directory. The single-module snapshot path assumed its dependency headers were already staged in out/build/include and dependency libraries already installed in out/target/lib/halif — but only the manifest path arranged that. On a clean tree the compile fails (missing header), and even with headers the link would fail (missing lib<dep>-v<ver>-cpp.so). It "worked" only for anyone who had already run a full/manifest build.

Fix

Resolve the dependency closure before building the requested snapshot:

• snapshot_deps() reads the (comp, ver) pairs the snapshot already declares via its ${HALIF_INCLUDE_DIR}/<comp>/<ver>/include references in CMakeLists.txt — no new metadata.
• Each dependency is built through a recursive build_modules.sh invocation, so transitive deps resolve and an already-built dependency is skipped (the common diamond builds once).
• stage_snapshot_headers() copies each snapshot's committed include/ tree into out/build/include after a successful build, so dependents resolve it.

Test

From a wiped closure (removed staged headers + libs + build dirs for videosink/videodecoder/avclock/common 0.2.0.0):

$ ./build_modules.sh videosink --version 0.2.0.0
📸 Snapshot build: videosink/0.2.0.0
   ↳ building dependency avclock/0.2.0.0 ...
   ↳ building dependency common/0.2.0.0 ...   (leaf — compiles PropertyValue.cpp)
   ✓ dependency common/0.2.0.0 already built   (diamond reused)
   ↳ building dependency videodecoder/0.2.0.0 ...

Result: all four lib*-v0.2.0.0-cpp.so produced and all four header trees staged (incl. common/.../PropertyValue.h). bash -n clean.

[Copilot]

Pull request overview

This PR fixes fresh-checkout snapshot builds (non-current --version) by ensuring the dependency closure is built first and snapshot headers are staged so downstream snapshot builds can find required headers/libs (e.g., com/rdk/hal/PropertyValue.h from common).

Changes:

• Added snapshot_deps() to infer snapshot dependencies by parsing ${HALIF_INCLUDE_DIR}/<comp>/<ver>/include references in snapshot CMakeLists.txt.
• Added recursive dependency builds for snapshots prior to configuring/building the requested snapshot.
• Added stage_snapshot_headers() to copy each snapshot’s committed include/ tree into out/build/include after a successful snapshot build.

[Ulrond]

Addressed the review note on the smoke_test table: defined the <c> (component) / <v> (version) placeholders above the table, and reframed the dependency-closure row as a variant precondition ("the same build, but with <c>'s dependency snapshots deleted first") so it no longer reads as a duplicate of the row above.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated 2 comments.