Updates

pear-platform/hyper-pear-runtime-session/docs/api.md

@@ -1,23 +1,26 @@
-# hyper-pear-runtime-session API
+# API: hyper-pear-runtime-session
 
-**Status:** scaffold · **Protocol:** `pear-runtime-session/v1`
+**Protocol:** `pear-runtime-session/v1` · **Export:** `HyperPearRuntimeSession`
 
-## Class `HyperP2PPearRuntimeSession`
+## Methods
 
-Scaffold stub — methods throw `not implemented: scaffold` until promoted to production tier.
+### `startSession(...)`
 
-### `constructor(opts?)`
+Domain API.
 
-### `getStats()`
+### `endSession(...)`
 
-Returns `{ created, errors, protocol, tier: 'scaffold' }`.
+Domain API.
 
-### `ready()`
+### `activeSessions(...)`
 
-Resolves immediately (no-op).
+Domain API.
 
-## Wire (planned)
 
-| Message | Direction | Notes |
-|---------|-----------|-------|
-| TBD | gossip | Defined in implementation pass |
+### `getStats()` / `ready()` / `close()`
+
+Lifecycle helpers.
+
+## P2P
+
+Local-only.

pear-platform/hyper-pear-runtime-session/docs/architecture.md

@@ -1,15 +1,11 @@
-# hyper-pear-runtime-session architecture
+# Architecture: hyper-pear-runtime-session
 
-**Tier:** scaffold · **Category:** `pear-platform`
+## Wire messages
 
-## Role
+| type | fields | direction | behavior |
+|------|--------|-----------|----------|
+| — | — | — | Local-only |
 
-Pear runtime session bridge.
+## State
 
-## Composition
-
-Uses `../../_shared/p2p-bare.js` for Hyperswarm + Protomux when implemented. Does **not** duplicate Holepunch core storage/transport.
-
-## Holepunch boundary
-
-Inspiration: n/a
+In-memory structures; gossip via `initModuleSwarm` / `gossipSend` when P2P enabled.