Skip to content

Commit f3ff0de

Browse files
committed
docs: replace prd with public specification
1 parent 7160ba5 commit f3ff0de

4 files changed

Lines changed: 8 additions & 8 deletions

File tree

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
Moss is an embeddable P2P mesh core written in Go and exported through CGO as a C-shared library. This repository is the runtime layer, not the end-user chat application.
77

8-
The current implementation covers the `PRD.md` scope with a pragmatic v1 runtime:
8+
The current implementation follows the public technical specification in [docs/SPECIFICATION.md](docs/SPECIFICATION.md) with a pragmatic v1 runtime:
99

1010
- tracker-based bootstrapping via BEP 15 UDP and BEP 3 HTTP announces
1111
- encrypted peer transport with Noise XX (`25519_ChaChaPoly_BLAKE2s`) plus identity binding

docs/KNOWN_LIMITATIONS.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,8 @@ This document exists to keep repository claims aligned with current runtime beha
1010

1111
## Specification parity
1212

13-
- The repository tracks the `PRD.md` scope with a practical v1 implementation.
14-
- Some production-grade goals from the PRD are only partially proven by automated tests and not by broad public telemetry.
13+
- The repository tracks [docs/SPECIFICATION.md](SPECIFICATION.md) with a practical v1 implementation.
14+
- Some production-grade goals from the specification are only partially proven by automated tests and not by broad public telemetry.
1515

1616
## Performance and scale
1717

PRD.md renamed to docs/SPECIFICATION.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11

2-
# Product Requirements Document (PRD): Project Moss
2+
# Moss Technical Specification
33

44
**Document Version:** 2.0
55
**Last Updated:** March 2026
6-
**Project Codename:** Moss
6+
**Project:** Moss
77
**Core Technologies:** Go 1.22+, CGO (`-buildmode=c-shared`), BitTorrent UDP/HTTP Trackers (BEP 15), GossipSub v1.1+, Noise Protocol Framework, Autonomous NAT Traversal (STUN/TURN/ICE-lite).
88

99
---
1010

1111
## 1. Executive Summary
1212

13-
**Project Moss** is a zero-infrastructure, embeddable Peer-to-Peer (P2P) networking core written in Go. Compiled via CGO into C-shared libraries (`.dll`, `.so`, `.dylib`), Moss allows any application — written in C, C++, C#, Python, Rust, or any language with C FFI support — to seamlessly join a decentralized data-exchange mesh with a single function call.
13+
**Moss** is a zero-infrastructure, embeddable Peer-to-Peer (P2P) networking core written in Go. Compiled via CGO into C-shared libraries (`.dll`, `.so`, `.dylib`), Moss allows any application — written in C, C++, C#, Python, Rust, or any language with C FFI support — to join a decentralized data-exchange mesh with a small host integration layer.
1414

15-
The defining characteristic of Moss is its **complete elimination of centralized infrastructure**:
15+
The defining characteristic of Moss is its **minimization of centralized infrastructure requirements**:
1616

1717
1. **Bootstrapping** — Public BitTorrent trackers (BEP 15 UDP, BEP 3 HTTP) serve as zero-cost, high-availability rendezvous points for initial peer discovery.
1818
2. **NAT Traversal** — An autonomous SuperNode promotion system turns publicly reachable peers into distributed STUN/TURN relays, guaranteeing connectivity across all NAT types including Symmetric NAT and Carrier-Grade NAT (CGNAT).

examples/python_chat/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ For a second machine on the same LAN, use the first machine's hostname or LAN IP
4141
python examples\python_chat\moss_chat.py --nickname Pi --listen-port 41030 --peer rpi1.local:41030 --room lobby
4242
```
4343

44-
For autonomous bootstrap closer to the PRD, start nodes without `--no-trackers`. In that mode the chat uses the default public tracker set and peers should discover each other without manual `/connect`.
44+
For autonomous bootstrap closer to the Moss specification, start nodes without `--no-trackers`. In that mode the chat uses the default public tracker set and peers should discover each other without manual `/connect`.
4545

4646
Or launch both demo windows automatically:
4747

0 commit comments

Comments
 (0)