Repository navigation
Description
The repository now contains the production session_peer_relay package, the completed experiments/relay69 prototype, reusable deployment examples, the live KR deployment reference, and 105 documentation files in one flat documentation surface. All of these are intentional artifacts, but their current placement makes it easy to run obsolete prototype tests or mistake a generic/static-account unit for the authenticated production topology.
Current evidence on main after #109:
experiments/relay69: 19 files / about 1,857 lines, plustests/test_relay69.py; feat: add opt-in paired-device direct and E2EE relay transport #69 is closed and the production implementation lives insession_peer_relay/.deploy/session-peer-*.serviceanddeploy/kr/*.servicediffer materially in identity, auth state, watchdog, readiness, storage and sandbox semantics.docs/contains 105 files / about 12,057 lines but no repository-leveldocs/README.mdthat separates user, operator, development and historical material.- The translation integrity suite is healthy and must remain authoritative.
Proposed scope
-
Inventory every assertion in
tests/test_relay69.py; move still-relevant protocol/security coverage to product relay tests before removing it from the default suite. -
Retain only useful historical prototype evidence under an explicitly historical location such as
docs/history/relay69/, or rely on Git history where the files add no current value. -
Reorganize deployment material so reusable examples and Abruption's deployed KR reference cannot be confused, for example:
deploy/ examples/ static-account/ authenticated-control/ ops/ abruption-kr/ -
Add
docs/README.mdas the repository documentation entry point, categorizing user guides, operator runbooks, development/architecture, and historical validation records. -
Update all links, packaging allowlists and
docs/i18n-manifest.json; keep all translated documentation structurally aligned.
Acceptance criteria
- No unique replay, E2EE, pinning, lifecycle or relay framing regression coverage is lost.
- The default test suite no longer imports the completed prototype implementation.
- Generic units state their supported authentication mode and lifecycle assumptions in their path and README.
- KR files remain exact, secret-free operational references and are clearly marked as instance-specific rather than reusable defaults.
docs/README.mdprovides a short audience-based navigation surface in English, Korean, Japanese and Simplified Chinese.- Wheel/sdist contents remain intentional; prototype sources remain excluded.
- Full Python, control integration, packaging and documentation-i18n CI passes.
Non-goals
- Splitting the relay or control plane into a separate repository.
- Refactoring the 3,972-line standalone
session_peer.py; that needs a separate design because zero-install SSH deployment depends on a single-file artifact. - Changing live KR services, credentials, state, Caddy, OAuth or backup policy as part of repository moves.
Activity
abruption commentedon Sep 20, 2026
Follow-up boundaries are now tracked separately: #112 covers core modularization while preserving the generated/standalone SSH artifact, and #113 covers test and CI organization by subsystem. This issue remains limited to prototype history, deployment layout, and documentation navigation.
abruption commentedon Sep 20, 2026
Target release: v1.0.0-beta. Complete the prototype/deployment/docs layout cleanup before the stable test and core refactors in #113 and #112.