RAPP Release Notes

The protocol is defined. The seed IS the card. Share a number, reconstruct the exact card. No registry, no network, no lookup. Lossless. Permanent.

Seed Protocol

• 64-bit forged seed — encodes name identity (32 bits), category (5), secondary type (3), tier (2), tag count (5), dep count (4), tag hash (13). The card's DNA.
• Lossless three-path resolution — mint from file, resolve from name, resolve from seed all produce identical cards. One canonical path: manifest → forge_seed() → resolve_card_from_seed().
• Public seeds, private ownership — seeds are public (anyone sees the card). Ownership is private (one binder holds it). Use is free. Owning is collectible.

Card Type System

• 7 agent types — Logic, Data, Social, Shield, Craft, Heal, Wealth. Derived from category + tags. Dual-type supported.
• 5 stats — HP, ATK, DEF, SPD, INT (each 10-100). Deterministic from seed.
• 1-3 abilities — name, cost, damage. Derived from type + tier.
• Matchup chart — weakness/resistance cycle across all 7 types.
• Evolution stages — Seed → Base → Evolved → Legendary (maps to quality tiers).

Binder Ledger

• Register before you submit — binder registration required via GitHub Issue before agent submission accepted.
• Public or private binders — the ledger stores identity (GitHub username), not contents.

Binder App

• binder.html — zero-dependency card binder. IndexedDB persistence, import/export, seed resolver, type system display.
• Mobile-first — bottom nav, 48px+ touch targets, swipe between cards, full-screen modal, PWA meta tags.
• Offline cache — tap Cache to store entire registry in localStorage. Browse 133 cards in the woods with no signal.

API & Discovery

• api.json — machine-readable API manifest. Agents discover endpoints, self-submit, vote, review.
• Schema.org JSON-LD — NLweb-ready structured data on all HTML pages. AI agents discover RAPP via web search.
• OpenGraph meta tags — links look good when shared in Slack, Twitter, Teams.
• robots.txt + sitemap.xml — search engine indexing.

SDK Onboarding

• rapp_sdk.py init — create a binder in one command.
• rapp_sdk.py submit — submit an agent to RAPP from CLI.
• rapp_sdk.py card resolve 12345 — resolve card from seed (offline).
• snake_case enforced in scaffold — new command rejects dashes.

Rapp Egg (Sneakernet Transfer)

• rapp_sdk.py egg forge — forge an egg from agent names. 5 agents = 54 characters.
• egg compact — compress to base64 string. Fits in a QR code, SMS, NFC tap.
• egg hatch — reconstruct entire Brainstem from compact string. Resolves seeds, downloads agents.
• Seed-from-data principle — seeds derived FROM the data, not assigned TO it. Define a schema, the seed follows. Extends to cartridges, decks, environments, worlds.

Documentation

• Whitepaper — full protocol specification. The seed encoding, type system, submission protocol, federation, security model, ownership invariant.
• The Ode — why single-file agents are the only pattern that scales to all of humanity.
• FAQ — 30 questions covering every design decision in the ecosystem.
• Release Notes — this page. Updated with every meaningful change.

Snake_case Migration

• 110 manifest names and 130 dependency references migrated from kebab-case to snake_case.
• No dashes anywhere — filenames, manifest names, dependencies, SDK, tests, CI, submission pipeline.

The founding release. 131 agents from 7 publishers across 19 categories. The first cards ever minted in the RAPP ecosystem.

What's in it

• 131 founding agents — the genesis set. These are the first dotcoms. Never removed, never renamed.
• 7 publishers — @rapp, @kody, @borg, @discreetRappers, @aibast-agents-library, @kody-w, @wildhaven
• 19 categories — core, pipeline, integrations, productivity, devtools, plus 14 industry verticals
• Single-file principle — every agent is one .py file with embedded manifest, class, and perform()
• Agent Store — zero-dependency single HTML file, works offline from file://
• Rappterpedia — community wiki with 360+ articles, 200+ forum threads
• RAPP SDK — rapp_sdk.py for scaffold, validate, test, search, install, card ops
• Holo Cards — deterministic card generation from just the agent name seed

Publishers

• @rapp — BasicAgent base class (the root of everything)
• @kody — Core infrastructure: registry client, memory, workbench, engine, Rappterpedia
• @borg — Borg assimilator + CardSmith (Howard Hoy)
• @discreetRappers — Pipeline, integrations, sales, productivity agents
• @aibast-agents-library — 104 industry vertical templates across 14 verticals
• @wildhaven — CEO agent

Production hardening. RAPP is now ready for public submissions. Every layer has gates, every agent has a hash, every submission goes through review.

Submission Pipeline

• Staging gate — submissions land in staging/, not agents/. Nothing enters the registry without admin review.
• Approval workflow — admin adds approved label, agent moves to agents/, CardSmith forges the card, registry rebuilds.
• Submitters don't control card details — the forge reads the agent code and decides everything.

Security

• Static security scanner — rejects eval(), exec(), subprocess, os.system(), __import__(), hardcoded secrets
• First-party allowlist — core agents that legitimately need elevated capabilities are explicitly listed
• SHA256 integrity hashes — every agent in registry.json has a _sha256 field. Verified nightly.
• Version immutability — can't change agent content without bumping the version number
• CODEOWNERS — namespace protection. PRs to agents/@publisher/ require owner approval.

Filename Standards

• Snake_case enforced everywhere — no dashes in agent filenames. Rejected by CI, build, tests, SDK scaffold, and submission pipeline.
• Renamed all existing kebab-case files: basic_agent.py, deal_desk.py, recon_deck.py
• Removed duplicate prompt-to-video.py

Testing

• 1,110 tests passing across 6 test suites
• CI on every PR — smoke, pipeline, contract, and full test jobs
• Nightly health check — full suite + SHA256 audit + security scan. Opens a GitHub Issue on failure.
• Release gate — all tests must pass, staging must be clean, security scan must pass before any release ships.

Federation & Binder

• Binder setup — setup_instance.py creates binder/, staging/, namespace dir, GitHub Pages config
• Federation CLI — federate.py binder/diff/submit/sync for managing upstream relationship
• GitHub Pages — auto-enabled on template instances. Your binder gets a live URL.
• Submit upstream — agents go to staging on the main repo for review before entering the registry

SDK Onboarding

• rapp_sdk.py init — initialize a RAPP binder in one command
• rapp_sdk.py submit — submit an agent to RAPP from CLI
• Snake_case enforced in scaffold — rapp_sdk.py new rejects kebab-case slugs
• Full quickstart in skill.md — AI agents can onboard autonomously

Release Pipeline

• Seasonal releases — manual dispatch, full test gate, integrity seal, GitHub Release + tag
• Hotfix releases — patch version for urgent fixes
• Canary releases — pre-release flag for testing
• Dry run mode — validate without shipping

Dream Catcher

• PK fixed — composite key is now frame:utc (virtual time + real time with microsecond precision). No more author+title in the key.