Home /Modules/http-7.0/README.md

README.md

http-7.0/README.md · 153 line(s) · markdown

<img align="right" src="https://github.com/mearvk/SLeeLa/blob/master/images/debian/debian-logo.png" width="75" height="75" alt="SLeeLa">

<img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-logo-004.jpg" alt="SLeeLa">

SLeeLa HTTP 7.0

Status: Experimental SLeeLa application-protocol reference server with Reality Assertion layer; not production-ready.

Platforms: Linux · macOS · Windows 10+

HTTP 7.0 introduces a Reality Assertion layer for carrying statements as explicitly classified application claims. The protocol separates the fact that a statement is transmitted from the separate question of whether that statement is established by evidence. An HTTP 7.0 packet does not make a claim true merely because it carries that claim. It is not an IETF HTTP/7 standard.

Build and test

make            # build protocol objects + server
make test       # run server self-test
make server     # build just the portable server
make demo       # build the original http70.c / http70.cpp demos
make syntax     # syntax-only check of all sources
make clean

Platform notes

PlatformSocket layerCompilerLink flags
LinuxPOSIX sockets via sleela_netcc / gcc(none)
macOSPOSIX sockets via sleela_netcc / clang(none)
Windows 10+Winsock2 via sleela_netMSVC / MinGW-lws2_32

Running the server

./http7_server --port 8086

Options: --port N (default 8086), --bind HOST (default 127.0.0.1), --allow-fallback (off by default), --self-test, --help.

Frame model — 24 types

32-byte big-endian header. HTTP 6.0's 20 types plus 4 assertion frames:

TypeCodeDescription
OPEN – RECIPIENT_LABEL1–20Inherited from HTTP 6.0
ASSERTION21Reality assertion with classified payload
ASSERTION_SOURCE22Source/provenance for an assertion
ASSERTION_STATUS23Classification status update
ASSERTION_AUTHOR24Authorship metadata

Flags include FACTUAL (0x80) for documented assertions and USER_AUTHORED (0x40) inherited from HTTP 6.0.

Assertion model

Each assertion carries:

FieldDescription
statusClassification (see below)
statementThe assertion text
sourceSource used to classify it
source_dateDate of the source
authorWho authored the assertion
document_referenceOptional supporting document

Assertion status values

StatusMeaning
FACTUAL_DOCUMENTEDEstablished by documented evidence
USER_AUTHOREDAuthored by a user, not independently verified
FICTIONALKnown to be fictional
COUNTERFACTUALContradicts established evidence
DISPUTEDSubject of active dispute
UNVERIFIEDNot yet verified

Serialised form (tab-delimited)

STATUS\tSTATEMENT\tSOURCE\tSOURCE_DATE\tAUTHOR\tDOCUMENT_REFERENCE\n

Built-in endpoints

PathMethodDescription
/__sleela/healthGETReturns SLeeLa HTTP/7.0 OK
/__sleela/statusGETJSON: 24 frame types, assertion statuses
/__sleela/negotiateGETVersion negotiation result (JSON)
/__sleela/h7POSTH7 frame endpoint — binary frames

SLeeLa application headers

X-SLeeLa-Version: 7.0
X-SLeeLa-Accept: 7.0, 6.0, 5.0, 4.0, 3.0, 2.1, 1.1, 1.0

Provenance

Applications should preserve who authored an assertion, when, the source used to classify it, and whether it is documented, disputed, fictional, counterfactual, or unverified.

See SPEC.md for the wire contract and SECURITY.md for implemented controls and release blockers. The server rejects malformed framing and assertion metadata, defaults to loopback, and applies socket inactivity timeouts. It remains experimental: TLS, authentication/authorization, total request deadlines, rate limiting, a complete stream state machine, and runtime /logger integration remain incomplete.

Security boundary

Reality assertions are information-exchange data. They do not grant authority, change physical reality, authorize action against people or systems, establish legal status, or provide instructions for constructing weapons. The protocol treats assertions as data with provenance and classification.

File inventory

FileDescription
http7_server.hServer API, HTTP types, frame handler
http7_server.cFull server with H7 frame endpoint + self-test
http7_main.cCLI entry point with echo handler
http7_protocol.h24 frame types, assertion struct, serialise/parse API
http7_protocol.cFrame encode/decode, assertion serialise/parse (new)
http70.cOriginal C demo (assertions via printf)
http70.cppOriginal C++ demo
http_negotiation.*Negotiation (C + C++, reformatted)
Makefileall, server, proto, demo, syntax, test

Dependencies

ModulePathRole
sleela_netimpl/core/sleela_net.{c,h}Portable TCP sockets
preferred_routerpreferred-routers/Routing-tier policy
resolverresolver/DNS / event policy

Unified route data

VM identity: /impl Core, /1 Foundation, /2 Operator, /3 Specialist, /4 Supervisor, /5 Manager, /6 Director, /7 Administrator, /8 Executive, /9 Authority, /10 Principal, /11 Sovereign.


SLeeLa

<p align="center"><img src="images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>