Add: [H2] serialize immutable HBG packets for HostArgs

[TaoZQY]

A leased Host build cannot outlive workspace reuse. Serialize it into an independently owned immutable packet containing pristine images of the frozen working regions, relative region descriptors and per-invocation identity. Relocate heap and Definition references while preserving caller tensor addresses and scalar values.

Produce a private writable HostArgs copy for every submission and bridge its single placeholder to CANN on the dedicated AICPU stream. Compact kernel layouts reserve bounded ready queues; each nonempty image includes the full frozen capacity and zeroed unused tails. The outer K1 header remains 64 bytes.

Validation

• Both HBG C++ suites passed (44 cases per architecture), together with context and contract tests at this milestone.
• Full rebased stack at H3 Add: [H3] seal and validate HBG execution slots #2175: 147 C++ test executables and 159 Python tests passed (4 hardware-marked skips), covering ABI, task interfaces and simulator DMA workspace.
• Full-stack simulation with the pinned PTO ISA required: A2/A3 74 passed, 8 skipped; A5 71 passed.
• Runtime libraries rebuilt; repository pre-commit checks passed. Each earlier milestone was independently compiled and tested.
• mkdocs build --strict passed separately at all five PR heads. The HBG contract page is included in navigation from H1; the execution-slot page is included from H3.

The transport tests model CANN copy/patch behavior. Registered device entry points, independent execution-slot admission, semantic restore and the enclosing three-stream protocol are separate integration work; public kernel launch remains disabled.

Dependency and review scope

Draft 4/5: H2. Depends on #2173.

• Original stage commit (before squash): 531586a2.
• Isolated implementation diff.
• Review order: K1 Add: kernel-mode C ABI skeleton, state machine, and wire headers #2064 → H1 Refactor: [H1] separate HBG host build from device upload #2171 → 2B Add: [2B] declare HBG resource and stream contracts #2172 → context prepare/freeze Add: [Context Prepare] prepare and freeze kernel resources #2173 → H2 Add: [H2] serialize immutable HBG packets for HostArgs #2174 → H3 Add: [H3] seal and validate HBG execution slots #2175.

This draft is rebased onto main at a1aa7fddf42b2d28849bc3fb6fe1eb50ab891324 and squashed to one commit. The rebase retains the upstream documentation-theme update. Source and test files match the previous PR head exactly; the squash preserves the complete rebased tree. Applicable pre-commit checks passed again.

All five HBG drafts target main. Each PR has exactly one commit, containing K1 plus all HBG milestones through the stage in its title. Squashing changes commit history, not the cumulative code scope. The original isolated diff above remains available to review this stage alone. Rebase in dependency order after prerequisites land.

The K1 snapshot originally carried from 21fb15c0 is included in this squashed commit, with its human author retained as co-author. Upstream #2064 remains open and has advanced; alignment with its final version remains public execution integration work.

No idle onboard devices were available. Simulation golden checks cover existing program-mode regression; mixed ACLGraph capture/replay, DSV4 CSA device accuracy and comparative performance remain unvalidated.

[coderabbitai]

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

• Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}