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 07ccd484f1
refactor: restructure repository with tiered licensing 
Major restructuring of libertaria-sdk -> libertaria-stack:

FOLDER REORGANIZATION:
- core/          - L0-L3 layers (Commonwealth LCL-1.0)
  - l0-transport/
  - l1-identity/
  - l2_session/
  - l2-federation/
  - l2-membrane/
- sdk/           - L4+ and bindings (Sovereign LSL-1.0)
  - janus-sdk/
  - l4-feed/
- apps/          - Examples (Unbound LUL-1.0)
  - examples/
- legal/         - All license texts

LICENSES ADDED:
- LICENSE_COMMONWEALTH.md (LCL-1.0) - Viral reciprocity for Core
- LICENSE_SOVEREIGN.md (LSL-1.0) - Business-friendly for SDK
- LICENSE_UNBOUND.md (LUL-1.0) - Maximum freedom for docs/apps

BUILD.ZIG UPDATED:
- All paths updated to new structure
- Examples imports fixed

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

NO CLA REQUIRED - contributors keep copyright
 		2026-02-05 20:12:32 +01:00
..
README.md refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
manager.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
manifest.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +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: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
sequencer.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
store.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +01:00
trust_resolver.zig refactor: restructure repository with tiered licensing 2026-02-05 20:12:32 +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.