Refactor Rust raw service organization

Author: ktsaou

.agents/sow/current/SOW-0014-20260603-maintainability-hotspots.md

@@ -53,6 +53,14 @@ src/
         posix.rs              # L1: UDS, SHM
         windows.rs            # L1: Named Pipe, SHM
       service/                # L2/L3: typed client/server helpers
+        raw.rs                # Internal raw helper wrapper/re-exports
+        raw/                  # Shared raw infrastructure plus per-method helpers
+          client.rs           # Shared raw client lifecycle, retry, send/receive
+          server.rs           # Shared managed-server lifecycle
+          cgroups_snapshot.rs # cgroups-snapshot raw call/dispatch
+          cgroups_lookup.rs   # cgroups-lookup raw call/dispatch
+          apps_lookup.rs      # apps-lookup raw call/dispatch
+          cgroups_cache.rs    # cgroups-snapshot Level 3 cache
 
   go/pkg/netipc/              # Go library (Go package)
     protocol/                 # Codec
@@ -155,6 +163,13 @@ Each service module should correspond to one service kind. The public
 L2/L3 shape must not drift into “one server exports many unrelated
 request kinds”.
 
+Internal raw helpers may share connection lifecycle, retry policy,
+transport send/receive, managed server accept/session loops, and
+generic envelope validation. Custom typed client calls, typed handler
+aliases, dispatch adapters, and Level 3 cache logic for one service
+kind must live in service-kind-specific files so adding new service
+kinds does not expand a shared catch-all module.
+
 Service modules must NOT contain:
 
 - Transport implementation details (no direct socket/pipe/SHM code)

docs/code-organization.md

@@ -97,6 +97,7 @@ Relevant implementation roots:
   - [src/go/pkg/netipc/service/apps_lookup/](../src/go/pkg/netipc/service/apps_lookup/)
 - Internal raw helpers used to build public typed services:
   - [src/crates/netipc/src/service/raw.rs](../src/crates/netipc/src/service/raw.rs)
+  - [src/crates/netipc/src/service/raw/](../src/crates/netipc/src/service/raw/)
   - [src/go/pkg/netipc/service/raw/](../src/go/pkg/netipc/service/raw/)
 
 Important current limitation:
@@ -805,11 +806,16 @@ Once the codec exists:
 - add typed raw client call support
 - add typed dispatch support on the server side
 - add envelope validation for the new method code
+- in Rust, put dedicated typed raw call and dispatch adapter code in a
+  service/method-specific file under `src/crates/netipc/src/service/raw/`;
+  keep shared retry, transport send/receive, and managed-server
+  infrastructure in shared raw files
 
 Patterns to mirror:
 
 - Rust raw client/server:
   - [src/crates/netipc/src/service/raw.rs](../src/crates/netipc/src/service/raw.rs)
+  - [src/crates/netipc/src/service/raw/](../src/crates/netipc/src/service/raw/)
 - Go raw client/server:
   - [src/go/pkg/netipc/service/raw/](../src/go/pkg/netipc/service/raw/)
 - C managed server / typed call path: