Updates

messaging-streams/hyper-p2p-stream-chunker/CHANGELOG.md

@@ -3,3 +3,7 @@
 ## [0.0.0-scaffold] — Wave 8
 
 - Registry scaffold: file tree, load smoke tests, docs stubs
+## [0.3.2] - 2026-05-21
+
+### Changed
+- Exhaustive documentation pass (api, architecture, README) per DOC_STANDARDS.md.

messaging-streams/hyper-p2p-stream-chunker/README.md

@@ -1,28 +1,41 @@
 # hyper-p2p-stream-chunker
 
-**Status:** scaffold (`0.0.0-scaffold`) · **Protocol:** `stream-chunker/v1` · **Wave:** 8
+Production p2p module: Hyperswarm discovery + Protomux when `topic` is set.
 
-Chunked stream framing.
+**Category:** General
 
-## Holepunch references (inspiration only)
+**Composes with:** 
 
-- `hyperbeam`
+**Protocol:** `stream-chunker/v1`
 
-> This module composes on Hyperswarm/Hypercore — it does **not** re-implement upstream packages.
+## When to use
 
-## Composes with
+Multi-peer apps that need general over a shared Hyperswarm topic.
 
-- `hyper-p2p-multipath-fanout`
+## When not to use
 
-## Planned API
+Single-process tools with no P2P topic (use local APIs only or skip `ready()`).
 
-- `constructor(opts)` — topic, optional keyPair
-- `getStats()` — scaffold counters
-- `ready()` — no-op until implemented
-- Domain methods — throw `not implemented: scaffold` until Wave 8+ pass
+## Quick start
 
-## Layout
+```js
+const { HyperP2PStreamChunker } = require('hyper-p2p-stream-chunker')
+const topic = process.argv[2] // 64-char hex or string
+const mod = new HyperP2PStreamChunker({ topic, enableBackgroundTimers: false })
+await mod.ready()   // joins swarm when topic set
+// ... application logic ...
+await mod.close()
+```
 
-`modules/messaging-streams/hyper-p2p-stream-chunker/`
+## Docs
 
-See [`modules/_shared/MODULE_SYSTEM.md`](../../_shared/MODULE_SYSTEM.md).
+- [docs/api.md](docs/api.md) — constructor, methods, events, errors
+- [docs/architecture.md](docs/architecture.md) — wire types, state, composition
+- [../../_shared/PRODUCTION.md](../../_shared/PRODUCTION.md) — production checklist
+- [../../_shared/DOC_STANDARDS.md](../../_shared/DOC_STANDARDS.md) — documentation standards
+
+## Test
+
+```bash
+npm install && npm test
+```

messaging-streams/hyper-p2p-stream-chunker/docs/api.md

@@ -1,23 +1,73 @@
-# hyper-p2p-stream-chunker API
+# API: hyper-p2p-stream-chunker
 
-**Status:** scaffold · **Protocol:** `stream-chunker/v1`
+**Protocol:** `stream-chunker/v1`
 
-## Class `HyperP2PStreamChunker`
+**Export:** `HyperP2PStreamChunker`
 
-Scaffold stub — methods throw `not implemented: scaffold` until promoted to production tier.
+## Overview
 
-### `constructor(opts?)`
+Production p2p module: Hyperswarm discovery + Protomux when `topic` is set.
 
-### `getStats()`
+## Constructor
 
-Returns `{ created, errors, protocol, tier: 'scaffold' }`.
+```js
+const mod = new HyperP2PStreamChunker(opts)
+```
 
-### `ready()`
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `topic` | `string` | `Buffer` | `null` | Hyperswarm topic; required for P2P `ready()` |
+| `keyPair` | KeyPair | random | Ed25519 key pair |
+| `chunkSize` | number | 4096 | chunkSize |
 
-Resolves immediately (no-op).
+## Methods
 
-## Wire (planned)
+### `push(data)`
 
-| Message | Direction | Notes |
-|---------|-----------|-------|
-| TBD | gossip | Defined in implementation pass |
+- **Returns:** `value`
+- **Throws:** — (none documented in method body)
+
+### `flush(—)`
+
+- **Returns:** `value`
+- **Throws:** — (none documented in method body)
+
+### `getStats(—)`
+
+- **Returns:** `object`
+- **Throws:** — (none documented in method body)
+
+### `ready(—)`
+
+- **Returns:** `Promise`
+- **Throws:** — (none documented in method body)
+
+### `close(—)`
+
+- **Returns:** `Promise<void>`
+- **Throws:** — (none documented in method body)
+
+## Events
+
+| Event | Payload |
+|-------|---------|
+| `chunk` | tail |
+
+## getStats()
+
+Returns `{ ...this._stats }` — typically `ops`, `errors`, and module-specific counters (`created`, `relays`, `open`, `peers`, etc.).
+Library-only modules may include `mode: 'local'`.
+
+## Errors
+
+Stable message substrings: see [`../../_shared/ERROR_CODES.md`](../../_shared/ERROR_CODES.md).
+
+## P2P
+
+When `topic` is set, `ready()` joins Hyperswarm and opens Protomux `stream-chunker/v1`.
+
+## Testing
+
+```bash
+npm install && npm test
+```

messaging-streams/hyper-p2p-stream-chunker/docs/architecture.md

@@ -1,15 +1,27 @@
-# hyper-p2p-stream-chunker architecture
+# Architecture: hyper-p2p-stream-chunker
 
-**Tier:** scaffold · **Category:** `messaging-streams`
+**Category:** General
 
-## Role
+```mermaid
+flowchart LR
+  App[Application] --> Mod[HyperP2PStreamChunker]
+  Mod --> Mux[Protomux stream-chunker/v1]
+  Mux --> Swarm[Hyperswarm]
+```
 
-Chunked stream framing.
+## Wire messages
+
+| type | fields | direction | behavior |
+|------|--------|-----------|----------|
+| *(local only)* | — | — | No gossip wire types |
+
+## State model
+
+- In-memory `Map` / `Set` structures for hot path
+- Optional Hyperbee/Hypercore persistence when `storageDir` or `memoryOnly` is configured
+- `close()` tears down swarm, timers, and clears ephemeral state
 
 ## Composition
 
-Uses `../../_shared/p2p-bare.js` for Hyperswarm + Protomux when implemented. Does **not** duplicate Holepunch core storage/transport.
+Composes with: see MODULE_CATEGORIES.md.
 
-## Holepunch boundary
-
-Inspiration: n/a