[Pedro Henrique Penna (ppenna)]

Summary

Correct two rows in the component responsibility map that still describe directory-only aggregate shares and treat every single share as a direct attachment.

The implementation now exports individual regular files without their parent directories. Keep this slice architectural: name the components and their contracts, and link to their implementations rather than copy code.

NVX base: 6020d5d49e2e4839feb46cbadbc8db7e8cf334e2.
Pinned OpenVMM: 2130f24b5a51561cc6224fe5a0aff93cb121ac32 (unchanged).

Changes

• OpenVMM filesystem responsibility: Describe named directory or regular-file children under a read-only synthetic root, per-child access modes, path policies for directory children only, and file exports that exclude their parent directories. Evidence: the microVM filesystem profile, attachment validation, and aggregate filesystem tests.
• NVX launcher responsibility: Distinguish one directly attached directory from multiple shares or even one regular file, which use an aggregate. Evidence: launcher selection, argument construction, and guest tokens, single-file and mixed-share tests, python scripts\nvx.py run --help, and python scripts\nvx.py sandbox provision --help.

The map's previous edit pinned OpenVMM at 7bf0ee28b826374a2d386067df0456b81bcae818. The three commits through the current pin add regular-file children, explicit child kinds, and the required file flag. No code, gitlink, or public option changes are included.

Follow-ups

• Relocate the tracked host bootstrap guide from the scripts tree into the documentation tree, updating its links in a separate documentation-only PR. This run prioritizes the incorrect sharing contract over relocation.
• Leave the detailed filesystem, runtime, usage, and snapshot chapters touched by open test-microvm: pause and resume a microVM through OpenVMM state control #405, Adopt bind-once microVM image slots #406, and Support filesystem-only streamed microVM snapshots #417 unchanged. This PR only corrects the responsibility map.

Validation

• python -m unittest scripts.test_nvx_tools.CliTests scripts.test_performance.PerformanceTests — pass, 117 tests run, one skipped.
• External throwaway Python checker, kept outside the repository — pass: all 22 relative links/anchors in the changed file and its incoming-link file resolve; the changed file has one H1 and balanced code fences; the design index links all 16 design chapters.
• git diff --check — pass.
• python scripts\nvx.py verify — pass, both before and after editing; the submodule checkout matches the recorded pin.
• Full maintainer-style diff review — pass: one topic, one Markdown file, two lines added and two removed, claims checked against the pinned source and tests, no files touched by open PRs, and a clean submodule.
• git verify-commit HEAD — pass using the repository's SSH signing configuration.

[Copilot]

🟢 Approval recommended

The documentation accurately matches the pinned OpenVMM and NVX behavior.

0 open findings

What changed in this PR

Updates the component responsibility map to reflect regular-file host shares and aggregate attachment behavior.

Changes:

• Documents directory and regular-file children in OpenVMM aggregates.
• Clarifies when NVX uses direct versus aggregate attachments.
• Links responsibilities to their implementations.

File	Description
doc/​design/​code-ownership-map.md	Corrects filesystem-sharing responsibilities and adds implementation links.

🧠 Review effort: Balanced

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.