# Net implementation (placeholder)

Runtime code for the **Net** pillar lands here or in `governor/src/net/` once
phase 1 starts. Specs and schemas live in:

- [../pillars/net.md](../pillars/net.md)
- [../schema/net/](../schema/net/)
- [../roadmap.md](../roadmap.md)
- [../plan.md](../plan.md) (detailed phases + Appendix C best practices)

## Planned modules

| Module | Role |
|--------|------|
| `ObservationStore` | Append local observations JSONL |
| `MergePolicy` | Per-part merge (intro-markers first) |
| `EditionBuilder` | Manifest + jsonl → torrent |
| `EditionSubscriber` | Pull + verify `friend_mesh` editions |
| `NetController` | Fleet subscription config, expose merged views to Watch/Download |

No source files yet — phase 0 is documentation only.

**Best practices note (2026-06 build-out)**: See plan.md Appendix C for DRY (TitleLibrary as documented template for ObservationStore + merge), separation (Net primary in correlation + new TVAnarchyCore/Net/ + state under net/), error handling (no silent fails), contentKey enforcement, Swift-read + governor-tick ownership, and full module + flow details from the Net expert. See pillars/net.md (new Security & Trust Enforcement subsec) + correlation/cross-cutting.md (Infra Security Surfaces) + plan App C (mandatory auth + PathGuard for all new daemons/bridges/MCP/HTTP) + schema/net/README for validation. Update this file + correlation + manifest when code lands.