libertaria
/
libertaria-stack
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
libertaria-stack/core/l0-transport/opq
History
Markus Maiwald 0a86a93cf5
refactor: complete repository restructure with tiered licensing 
BREAKING CHANGE: Repository restructured from flat layout to tiered:

FOLDER REORGANIZATION:
- core/          - L0-L3 layers (Commonwealth LCL-1.0)
  - l0-transport/   - Transport with MIMIC, Noise, PNG
  - l1-identity/    - Identity, QVL, Crypto
  - l2_session/     - Session management
  - l2-federation/  - Cross-chain bridging
  - l2-membrane/    - Policy enforcement
- sdk/           - L4+ and bindings (Sovereign LSL-1.0)
  - janus-sdk/
  - l4-feed/
- apps/          - Examples (Unbound LUL-1.0)
  - examples/
- legal/         - All license texts
  - LICENSE_COMMONWEALTH.md
  - LICENSE_SOVEREIGN.md
  - LICENSE_UNBOUND.md

IMPORT FIXES (All Layers):
- L0: 13 files fixed - all relative imports corrected
- L1: 14 files fixed - module imports for cross-layer dependencies
- L2: 6 files fixed - session, membrane, federation
- Capsule: 9 files fixed - TUI, node, main, control
- Examples: 2 files fixed - lwf, crypto

LICENSES ADDED:
- LCL-1.0: Viral reciprocity for Core (SaaS-proof)
- LSL-1.0: Business-friendly for SDK
- LUL-1.0: Maximum freedom for docs/apps

NO CLA REQUIRED - contributors keep copyright

README.md REWRITTEN:
- Documents new folder structure
- Explains tiered licensing strategy
- Clear SPDX identifiers per component

TODO:
- Fix remaining test module configuration issues
- Full green build in follow-up

Refs: 4 sub-agents parallel execution
 		2026-02-05 21:50:54 +01:00
..
README.md refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
manager.zig refactor: complete repository restructure with tiered licensing 2026-02-05 21:50:54 +01:00
manifest.zig refactor: complete repository restructure with tiered licensing 2026-02-05 21:50:54 +01:00
merkle.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
quota.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
reorder_buffer.zig refactor: complete repository restructure with tiered licensing 2026-02-05 21:50:54 +01:00
sequencer.zig refactor: complete repository restructure with tiered licensing 2026-02-05 21:50:54 +01:00
store.zig refactor: complete repository restructure with tiered licensing 2026-02-05 21:50:54 +01:00
trust_resolver.zig refactor: complete repository restructure with tiered licensing 2026-02-05 21:50:54 +01:00

README.md

OPQ: Offline Packet Queue

Layer: L0 (Transport) RFC: RFC-0005

Purpose

OPQ allows Libertaria to function in disconnected environments by providing:

  • Persistent disk-backed storage for frames.
  • TTL-based pruning.
  • Quota-enforced storage limits (Policy vs Mechanism).
  • Queue manifest generation for peer synchronization.

Node Personas & Policy

The OPQ's behavior is dictated by the node's role:

  • Client: Outbox only. (Retention: <1hr, Buffer: <5MB).
  • Relay: Store-and-Forward. (Retention: 72-96hr, Buffer: Quota-driven).

Components

  • store.zig: Segmented WAL (Write-Ahead Log) for atomic persistence.
  • quota.zig: Hard-quota enforcement and eviction logic.
  • manager.zig: (Pending) Queue orchestration and manifest sync.