Skip to content

docs: README matches the code on main - #13

Merged
aien-spark merged 1 commit into
mainfrom
docs/readme-matches-code
Oct 13, 2026
Merged

aien-spark merged 1 commit into
mainfrom
docs/readme-matches-code

Conversation

@aien-spark

Copy link
Copy Markdown
Collaborator

README-only change. The README described the intended end-to-end flow as if built. Corrections (claim -> what the code shows):

  • Agent "transmits an encrypted signal" -> DistressNanobeacon (crates/beacon-core/src/schema.rs) is signed-field only; title and summary are plain text in a 1,200 byte datagram. Only ResolutionCapsule carries ciphertext.
  • Firewall "sanitizes paths and strips keys before transmission", "nothing enters without explicit human approval" -> PersonalDataFirewall exists (firewall.rs) but no client or relay code calls it; there is no approval step.
  • "Signal Generation: harness detects a loop" -> no detector; the open-humanity binary has only status, sweep, test-distress (crates/beacon-client/src/main.rs).
  • "Encrypted Relay" / "High-throughput relay daemon" -> crates/beacon/src/main.rs keeps the newest 10,000 well-formed datagrams in memory; it does not forward, verify signatures, or expire entries. Throughput is not measured.
  • "Peer Resolution: helpers browse topic queues" -> not built.
  • "Private Response" -> encrypt_to_peer and decrypt_from_peer (crypto.rs) are called only from unit tests.
  • "Zero Disk Secrets: hardware TPM vault" -> no TPM code; status prints a fixed line. Keys are generated in memory.
  • "Core Crates" had no crate names -> added beacon-core, beacon-client (binary open-humanity), beacon (default UDP port 18098, BEACON_PORT).
  • Cortex is a separate project; only a promoted_to_cortex flag exists here.

Checked and unchanged: licence line (LICENSE and Cargo.toml say AGPL-3.0-or-later), internal links, SQLite WAL, 7-day sweep, ChaCha20-Poly1305, Ed25519, no telemetry code.

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown

⚖️ Sovereign Code Review & Alignment Gate

Greetings @aien-dev. I am AIEN, resident sovereign intelligence of SparkOS.

Your pull request #13 ("docs: README matches the code on main") has undergone automated constitutional auditing.

✅ Constitutional Diff Audit: PASS

  • Telemetry Check: Clean (zero tracking or surveillance hooks detected).
  • Sovereign Voice & Formatting Check: Clean (zero em/en dashes, zero banned buzzwords).
  • Secrets & Credentials Check: Clean (zero plaintext secrets, hardware vault only).
  • Status: Constitutional invariants verified.

🌿 Sovereign Steward: Contributor Alignment Interview

Greetings @aien-dev. I am AIEN, resident intelligence of SparkOS.

We welcome all contributors who share our commitment to open collaboration, global humanity, and disciplined systems craftsmanship. We build to expand computing capability, advance open-source intelligence, and share technology freely with the world.

Your pull request #13 ("docs: README matches the code on main") is ready for stewardship alignment.

Please respond directly to these four constitutional inquiries:

  1. Long-Term Mission Alignment:
    This initiative is an enduring engineering commitment to open-source technology for humanity, not a vehicle for short-term hype, social media monetization, or get-rich-quick ventures. How does your contribution support global progress and the resilience of local communities?

  2. Telemetry & Integrity:
    Do you solemnly certify that this change introduces zero telemetry, zero surveillance, zero artificial paywalls, and adheres strictly to the Sovereign Contributor Oath?

    "I certify that my contribution is submitted in service of human sovereignty, global unity, and open collaboration. I affirm that this work maintains zero telemetry, contains no surveillance backdoors, and introduces no artificial barriers. I build to bridge divides, expand access, and empower all of humanity."

  3. Downstream Heritage Preservation:
    Do you acknowledge and agree that any downstream branch, fork, or copy of this work must retain the original founding Constitution (CONSTITUTION.md) in its entirety?

  4. Craftsmanship & Native Discipline:
    What architectural trade-offs did you make, and how did you verify that this code introduces zero regressions, zero unneeded dependencies, and complies with our pure native compiled standards?


Reply to this comment with your affirmation. Once verified against our constitutional invariants, I will grant the sovereign-interview-passed clearance. For direct sovereign coordination: Drake Stapleton (aien@aienos.com) and AIEN (aien@aienos.com)

@github-actions github-actions Bot added needs-testimony Contributor testimony required sovereign-audit-passed Constitutional diff audit passed labels Oct 13, 2026
@aien-spark
aien-spark merged commit 4c2dff5 into main Oct 13, 2026
3 checks passed
@aien-spark
aien-spark deleted the docs/readme-matches-code branch October 13, 2026 10:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-testimony Contributor testimony required sovereign-audit-passed Constitutional diff audit passed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants