Skip to content

README.md

Latest commit

 

History

History
214 lines (150 loc) · 5.86 KB

README.md

File metadata and controls

214 lines (150 loc) · 5.86 KB
Raw

Crowsong 🐦‍⬛

What the passive listeners hear.

A protocol suite for signals that must survive.

What this is

Crowsong is a family of Internet-Drafts defining a layered communications architecture that remains interpretable, verifiable, and transmissible even when reduced to manual transcription over non-binary channels.

This is not a fallback property. It is a design constraint.

The problem

When infrastructure fails, the channels that remain — fax, Morse, printed page, human relay — cannot reliably carry binary data.

Most “resilient” protocols assume a degraded IP network.

Crowsong assumes the network may not exist at all.

The stack

L5  Content    →  Meridian Protocol
L4  Trust      →  SHARD-BUNDLE · MIRROR-ATTESTATION
L3  Routing    →  Delay-Tolerant Networking (RFC 4838)
L2  Encoding   →  Fox Decimal Script (FDS / UCS-DEC)
L1  Physical   →  LoRa · Morse · Fax · RF · Kite-borne relay · Print · Human relay

The drafts

draft-darley-meridian-protocol-01
  ↑ consumes
draft-darley-crowsong-00
  ↑ composes
draft-darley-fds-00           draft-darley-shard-bundle-00
  ↑ implements                  ↑ implements
tools/ucs-dec/ucs_dec_tool.py
Draft Description
draft-darley-fds-00 Encoding — human-transcribable Unicode decimal
draft-darley-shard-bundle-00 Trust — threshold key distribution
draft-darley-crowsong-00 Architecture — how the system composes
draft-darley-meridian-protocol-01 Content — continuity of web artifacts

Repository layout

drafts/                       Internet-Drafts
drafts/meridian-protocol/     Meridian Protocol (submodule)
tools/ucs-dec/                reference implementation (FDS)
docs/                         supporting material and guides
archive/                      canonical test vectors
tests/roundtrip/              verification scripts
bible/                        structural principles (design doctrine)

Quick start

# Encode
echo "Signal survives." | python tools/ucs-dec/ucs_dec_tool.py --encode
00083  00105  00103  00110  00097  00108
00032  00115  00117  00114  00118  00105
00118  00101  00115  00046  00010  00000

# Decode
echo "00083  00105  00103  00110  00097  00108 00032  00115  00117  00114  00118  00105 00118  00101  00115  00046  00010  00000" | python tools/ucs-dec/ucs_dec_tool.py --decode
Signal survives.

# Decode the canonical test vector
cat archive/flash-paper-SI-2084-FP-001-payload.txt | \
  python tools/ucs-dec/ucs_dec_tool.py --decode

# Regenerate canonical test vector payload
python tools/ucs-dec/ucs_dec_tool.py -e \
  < archive/second-law-blues.txt \
  > archive/flash-paper-SI-2084-FP-001-payload.txt

# Regenerate framed canonical test vector artifact
python tools/ucs-dec/ucs_dec_tool.py -e \
  --frame --ref SI-2084-FP-001 --med FLASH --attribution '桜稲荷' \
  < archive/second-law-blues.txt \
  > archive/flash-paper-SI-2084-FP-001-framed.txt

# Roundtrip check canonical test vector
python tools/ucs-dec/ucs_dec_tool.py -e \
  < archive/second-law-blues.txt | \
  diff - archive/flash-paper-SI-2084-FP-001-payload.txt
# Expected: silence

# Verify the framed canonical test vector artifact
python tools/ucs-dec/ucs_dec_tool.py -v \
  < archive/flash-paper-SI-2084-FP-001-framed.txt
# Expected: 531 OK, E8DC9BF3 OK

# Verify full test suite
bash tests/roundtrip/run_tests.sh
=== Crowsong FDS Roundtrip Test Suite ===
    Artifact: SI-2084-FP-001

[1] Decode canonical payload
  PASS: decoded output is non-empty (543 bytes)
[2] Attribution encoding (first three values → 桜稲荷)
  PASS: 26716 · 31282 · 33655 → 桜稲荷
[3] Verify token count and format
  PASS: zero invalid tokens
[4] Roundtrip encode/diff
  PASS: re-encoded output matches canonical payload byte-for-byte
[5] Framed artifact structural integrity
  PASS: framed artifact contains header, trailer, and attribution
[6] Framed artifact frame verification (count + CRC32)
  PASS: declared 531 VALUES · CRC32:E8DC9BF3 — verified
[7] Decode framed artifact (frame-aware)
  PASS: framed artifact decodes identically to bare payload
[8] Corruption detection
  PASS: corrupted artifact correctly rejected (non-zero exit)

=== Results: 8 passed, 0 failed ===

531 VALUES · CRC32:E8DC9BF3 · VERIFIED
Signal survives.

The design in one sentence

Every layer of the system must be operable by a human with patience and appropriate reference material.

The test vector

The canonical test vector is a poem:

archive/flash-paper-SI-2084-FP-001-framed.txt
archive/flash-paper-SI-2084-FP-001-payload.txt
archive/second-law-blues.txt

cat archive/flash-paper-SI-2084-FP-001-payload.txt | \
  python3 tools/ucs-dec/ucs_dec_tool.py --decode

Expected result: legible text.

Where to go next

  • Start here (implementation): drafts/draft-darley-fds-00.txt

  • Architecture: drafts/draft-darley-crowsong-00.txt

  • Trust layer: drafts/draft-darley-shard-bundle-00.txt

  • Content continuity: drafts/meridian-protocol/draft-darley-meridian-protocol-01.txt

  • Design doctrine: bible/structural-principles.md

  • Full suite overview: docs/crowsong-suite-overview.md

On the name

In the Aeolian Layer — a kite-borne delay-tolerant mesh network, described in the in-progress draft-darley-aeolian-dtn-arch-01 — the passive listeners are called Crows.

A crowsong is what they hear.

Status

Early drafts. Subject to revision.

Feedback welcome via:

"The signal strains, but never gone — I fought Entropy, and I forged on."