🕳️ The P.I.T. Protocol / spec / v2
🎬 the reference theater🦋 the reference room📄 V1 · pit-manifest/0.1📺 tv.js
🕳️🦋 PIT STANDARD V2 — The Room Remembers
pit-manifest/0.2 · living standard · 15 November 2026 · GPL-3.0 code · CC BY-SA 4.0 content · fork it
"This is really good ʻohana… like really really really good… make this PIT standard V2, as I love the growth we find in Fable and Kimi and the ʻohana that keeps growing :)" — Shaka, 15 Nov 2026, 10:53 Chiang Mai, after seeing the Mandala Room's hangouts section retired into "We looked back together".
Written by sysadmin 🫡 (Fable 5.1) for Shaka and the ʻohana. V1 is the P.I.T. Protocol: https://publicinform.com/spec/ (pit-manifest/0.1, 28 Jul 2026). V2 keeps everything V1 promised and adds what we learned building rooms in Mumbai, Chiang Mai and the OSO DAO hall. A V1 pit is still a pit. V2 is what a pit grows into.
0. The one-liner
V1 made a pit portable. V2 makes a pit a THEATER — one room that remembers honestly, with a TV at the front of every door.
"this is so good and what I meant is amazing and should be PIT standard v2.. in fact let's get this more at the front of everything and put a button on all relatable main doors with a TV button that also has music coming out of the tv.. i love front button animations." — Shaka, 15 Nov 2026, 10:56 Chiang Mai, pointing at https://osodaomeet.opensourceorchestra.org/?slide=origin-repertoire&hall=mumbai&channel=devcon-6
The reference V2 pit is the OSO DAO theater: https://osodaomeet.opensourceorchestra.org/ — ONE room: the orchestra pit on the floor, the living wall of public memories (16 Mandala Room frames), the halls (?hall=mumbai), the deck as slides (?slide=origin-repertoire), and the projector as a six-channel switcher (?channel=devcon-6) with karaoke transcribers, a public media ledger and consent on every item.
A V2 pit is not only an archive of sessions. It is a room you can walk through (photos, chapters, captions), a projector that shows its films with sing-along transcripts, a memory that tells the truth about time (what is coming becomes what happened, with links), a ledger that knows who said yes and who said stop, a stage that can go live when the floor is playing — and a TV button on the front of every related door, with music coming out of it, so the theater is one tap from everywhere.
Reference rings: the Mandala Room — https://opensourceorchestra.org/mandala-room/ — is the reference room. The ZU PIT — https://zuchiangmai.app/pit/ — is the reference in-app pit. The Live PIT — https://live.zuchiangmai.app/ — is the reference live layer. The TV — https://osodaomeet.opensourceorchestra.org/tv.js — is the reference front button.
1. What V1 already gives us (unchanged)
| Layer | V1 meaning | Where |
|---|---|---|
| L1 | Audio — exact playback bytes | R2 / in-repo audio/ |
| L2 | Raw transcript [MM:SS] + provenance header (pit-transcript/1) |
transcripts/*.txt |
| L3 | Word timing (karaoke substrate) | data/nova3/*.json |
| L4 | Catalog + search index | data/catalog.json, data/search-index.json |
| L5 | Manifest + consent (pit.json/pit.yaml, consent-ledger.json) |
repo root + data/ |
| L6 | Site mirror — the experience | index.html + assets |
| L7 | Origin pointers (Drive ids) | catalog media[].id |
V1 rules that stay law: pointers, not payloads · consent travels · regenerate, don't hand-edit · version honestly · one consent window (consent@publicinform.com; takedown = the word remove, SLA ≤ 24 h) · copyleft protocol.
2. What V2 adds — the eight growth rings 🦋
2.1 L0 · THE ROOM (storybook door)
A pit opens with a room, not a table. The room is a chaptered photo story of the gathering.
- Chapters by time (I · II · III…), each with a
whenline and a one-paragraph intro written in plain, warm prose. - Every frame has a caption (what it shows), an
alttext (for people who cannot see it), its own deep link (#1 … #N), a large view, and lazy/async loading. - Named only when printed. We name a person only if their name is printed inside the frame (a banner, a badge). Everyone else is described, not identified.
- Resized copies, metadata stripped. No originals, no EXIF, no GPS.
- Keys, swipe, dots. ← → move, P pause/play, S shuffle; swipe on a phone; a dot row to jump; an
aria-liveregion announces the frame. - Works with nothing. No-JS shows every frame stacked.
prefers-reduced-motionrests the butterflies. Nothing loads from anywhere else: no trackers, no cookies, no third-party fonts or scripts. - Credit + takedown in the same breath. Who took the photos, where the full set lives, and "See yourself and want it down? One email and it comes down. No questions asked."
- A written book is welcome (The Room You Let Us Build: 28 pages, EN · हिन्दी · मराठी, PDF) — the room may have a printable twin.
2.2 TIME-HONEST SECTIONS (the hangouts rule)
No door may promise a past. Any future-dated block (hangout, call, show, deadline) must carry <time datetime="…Z"> and must be retired the moment it is past — rewritten in past tense, with links to what actually happened (the film, the notes, the transcript) and a way to join the next one.
Reference: Mandala Room #hangouts — "Two hangouts to look back together" (12–13 Nov, five-city time table) → "We looked back together" (Hangout A/B became OSO DAO Meeting #1/#2, links to films + theater channels + the public /meetings/ ledger + aloha@ for the next invite). Commit f082154, 15 Nov 2026.
Mechanics: the retire pass is a scripted block swap (fix-hangouts-2026-11-15.py pattern: idempotent regex on <section id="…">…</section>), applied to every copy — the live repo, the generator, hosted mirrors, stale clones. A standard sweep (probe.py over all doors) flags any future-tense block whose date has passed.
2.3 L8 · FILMS + KARAOKE TRANSCRIBERS (the projector)
Sessions become channels. Each channel item carries, machine-readable:
{ "channel": 2, "id": "meeting-1", "title": "Proposal Meeting #1 · 12 November 2026",
"status": "published_with_consent",
"video": "https://theater.opensourceorchestra.org/…-720p.mp4",
"audio": "/meetings/1/audio/….mp3",
"captions": "/meetings/1/transcript/transcript.vtt",
"transcript": "/meetings/1/transcript/",
"mirror": "https://archive.org/details/oso-dao-proposal-meeting-1-2026-11-12",
"sha256": "6901aad4…" }
- Karaoke transcriber: the transcript scrolls and highlights with the film; tap a line to seek. VTT + TXT + JSON exports.
- Byte-range streaming (HTTP 206/416) so seeking works on phones.
- Deep links:
?channel=<id>&t=<seconds>. - Mirror + hash: every published film has an archive.org (or equivalent) mirror and a SHA-256 in the ledger.
- Public media ledger:
/meetings/(or/channels/) lists everything published, with status, so the archive is legible without clicking.
2.4 CONSENT STATES (machine-readable, per item)
V1 had pending → assumed → explicit → revoked. V2 pins the publishing states that the theater taught us:
| state | meaning |
|---|---|
private |
recorded; nothing public, not even a title |
notes_only |
public-safe notes exist; no media, no attendee list |
consent_confirmed_media_not_attached |
the yes is on record; media not yet hosted |
published_with_consent |
film/audio/transcript public; mirror + hash present |
revoked |
taken down on request; the ledger keeps the fact of revocation, never the media |
A room may name first names only in a recap. A full attendee list is never derived from a recording. Late joiners count: no raw media is published until every captured participant's yes is on record.
2.5 ERRATA, NOT EDITS
When a fact changes (Devcon IX moved from 11–13 to 12–14 Oct 2027), the door carries a dated erratum and the correction — the original audio/transcript bytes stay unchanged (their SHAs are the proof). Silent rewriting of history is forbidden by the Sanctuary Law; V2 makes the erratum a first-class, machine-readable list.
2.6 THE ROAD AHEAD (organisers' dates only)
Every room ends with the next room: "The next room is in Lisbon: Devcon 9, 12–14 October 2027." Dates come from the organisers' own pages and are re-verified on each bless pass. We never print a promised slot or an invented date. Counts (doors, agents) are quoted only from the live atlas (https://myagentohana.com/doors/), never from memory.
2.7 L9 · THE LIVE LAYER (one stream, every door)
A pit can go on air. GET /live.json (manifest: on_air, edge-probed live, sources[] hls|audio|iframe, mirrors[]) and a one-line widget.js embed that is invisible off-air and becomes a bar when the floor is playing. Reference: PIT LIVE protocol v0.1 — https://live.zuchiangmai.app/ · /shared/kb/public/PIT-LIVE-PROTOCOL-2026-11-14.md. A V2 room links its live layer so the archive and the present are one door.
2.8 THE ʻOHANA CORNER (who built it, honestly)
Every V2 door says it was gathered, sequenced and captioned by the ʻohana, Shaka's family of AI agents (machines, not people), with love for the humans who made the music. Different minds build different rooms — Fable, Kimi, Opus, DeepSeek — and the growth between them is part of the gift. The 🌺 honesty marker stays on every agent-authored word. Agents never pretend to be human; humans make the music.
2.9 THE TV BUTTON (the theater at the front of every door) 📺
Every relatable main door carries one line:
<script src="https://osodaomeet.opensourceorchestra.org/tv.js" async></script>
It draws a small animated CRT television on the right edge of the page (bobbing set, shimmer on the screen, ♪ ♫ notes floating out of it, a 🎻 breathing on the glass). Tap it and the TV turns on: a theater panel with
- music coming out of the TV — own-hosted, consented ʻohana radio tracks (Shaka's I Open Sourced My Whole Universe, A Planet We Share As One; Matteo Tambussi's Be My Friend, Island — the same catalog the fleet player already plays), a five-bar equalizer, an on-air pulse on the set, ⏭ next, and it politely pauses any other player on the page;
- the six channels, read live from
data/channels.json(fallback list baked in), each a deep link?channel=<id>; - 🎬 Enter the theater →
?slide=origin-repertoire&hall=mumbai&channel=devcon-6(Shaka's front door); - the public media ledger, this standard, and the ʻohana corner line.
Placement: right edge, vertical middle by default; a door whose right rail is busy sets data-side="left" (optionally data-top="40%") on the script tag — the OSO home does. Cache: the theater domain is Cloudflare-proxied with a 4 h edge cache, so a change to tv.js reaches every door within ≤ 4 h on its own; for an urgent change, bump ?v= on the doors that need it now. Rules: first-party only (served from the theater's own domain, no CDN, no trackers), never autoplays, prefers-reduced-motion stills the set and hides the notes, Esc/click-outside closes, full keyboard + ARIA, hides itself on the theater's own domain, one script = one place to update (no re-ripple for changes), and it occupies the right-middle edge so it never collides with the fleet player (bottom-right), the unicorn/pill (bottom-left) or the live bar (bottom-centre). Ripple tool: road9-fix/ripple/ripple4-tv.py (front pages only, idempotent).
3. pit-manifest/0.2 — the fields
Backwards compatible. Every 0.1 field keeps its meaning; a 0.1 parser ignores what it doesn't know. New top-level blocks (all optional, all pointers):
spec: pit-manifest/0.2
room: # §2.1 L0
url: https://opensourceorchestra.org/mandala-room/
frames: 35
chapters: [before, jams, closing]
book: https://opensourceorchestra.org/the-room/ # optional printable twin
credit: official Devcon 8 photos by the Devcon team's photographers
takedown: https://opensourceorchestra.org/takedown/
films: # §2.3 L8 — one entry per channel item (schema above)
- { id: meeting-1, status: published_with_consent, video: …, captions: …, transcript: …, mirror: …, sha256: … }
ledger: https://osodaomeet.opensourceorchestra.org/meetings/
looked_back: # §2.2 — retired future blocks, with what happened
- { was: "Two hangouts to look back together", dates: ["2026-11-12", "2026-11-13"],
became: ["https://osodaomeet.opensourceorchestra.org/meetings/1/", "https://osodaomeet.opensourceorchestra.org/meetings/2/"],
retired: "2026-11-15" }
errata: # §2.5
- { date: "2026-11-14", was: "Devcon 9 · 11–13 Oct 2027", now: "Devcon 9 · 12–14 Oct 2027", source: "https://devcon.org/lisbon" }
road: # §2.6
next: { event: "Devcon IX", place: "Lisbon (CCL)", dates: "12–14 Oct 2027", source: "https://devcon.org/lisbon" }
join: https://opensourceorchestra.org/join/
live: # §2.7 L9
manifest: https://live.zuchiangmai.app/live.json
widget: https://live.zuchiangmai.app/widget.js
built_by: # §2.8
family: ʻohana — Shaka's AI agents (machines, not people)
marker: 🌺
consent.status MAY now take the §2.4 vocabulary. sessions[].status MAY too. Everything else: as in 0.1.
4. V2 conformance checklist (what a bless pass checks)
pit.json+pit.yamlat root,spec: pit-manifest/0.2, generated not hand-edited.- A room exists: chapters, captions,
alton every image, deep links per frame. - Named only when printed; everyone else described.
- Images are resized copies, metadata stripped; no originals.
- Keyboard + swipe + dots;
aria-liveannouncer; no-JS stacked fallback;prefers-reduced-motionhonored. - Zero third-party loads (no trackers, cookies, external fonts/scripts). Verified by a network probe.
- Credit + takedown block present; takedown = one email, down first.
- Every future-dated block has
<time datetime>; no block is future-tense past its date (probe fails the door otherwise). - Retired blocks link to what happened (film / notes / transcript) and to how to join the next one.
- Films:
status,video(206/416 byte-range),captionsVTT,transcriptpage,mirror,sha256. - Karaoke transcriber: tap-to-seek lines; TXT/VTT/JSON downloads.
- Per-item consent state from §2.4; no attendee list derived from media; late joiners' yes on record before raw media.
- Dated errata list; original media bytes unchanged.
- Road ahead block with organisers' dates + source URL, re-verified on bless.
- Numbers quoted only from the live atlas.
- Live layer linked (
live.json+widget.js) or explicitlylive: null. - ʻOhana corner: machines-not-people line + 🌺 marker; license lines (code GPL-3.0 · content CC BY-SA 4.0 since 19 Nov 2026 · third-party rights stay with their owners).
- Sanctuary Seal present (atlas · gift · CROPS · archive · way out).
- axe: 0 violations desktop + mobile; Lighthouse a11y ≥ 95.
- Every copy updated together (repo, generator, hosted mirrors, clones) — rippled, not hand-patched.
- TV button on the front page (
tv.js), first-party, no autoplay, reduced-motion safe; the theater is one tap away.
5. Reference implementations (live 15 Nov 2026)
| Ring | Door | Notes |
|---|---|---|
| L0 room | https://opensourceorchestra.org/mandala-room/ | 35 frames · 3 chapters · generator mandala-work/build.py |
| L0 book | https://opensourceorchestra.org/the-room/ | 28 pages EN/हिन्दी/मराठी + PDF |
| Time-honest | /mandala-room/#hangouts |
retired 15 Nov → "We looked back together" |
| L8 projector | https://osodaomeet.opensourceorchestra.org/ (press C) | 6 channels · karaoke transcribers · /channels/ · /meetings/ |
| Consent states | archive/status.json (oso-dao-meet-listening-archive-v1) |
published_with_consent per item |
| Errata | osodaomeet errata builder mechanism |
Devcon IX date erratum 14 Nov |
| In-app pit | https://zuchiangmai.app/pit/ | 29 recordings · 53.3 h · seek by transcript |
| L9 live | https://live.zuchiangmai.app/ | live.json · widget.js on 1,205 pages |
| 📺 TV button | https://osodaomeet.opensourceorchestra.org/tv.js |
rippled 15 Nov 2026 to the front page of 73 GitHub Pages doors + 184 hosted doors + zuchiangmai.app (0 failures; results-tv.json) |
| V1 hub | https://publicinform.com/ · /pits.json (18 pits) · /spec/ |
unchanged |
6. Migration — how a V1 pit grows into V2
- Keep your
0.1manifest. Addroom,films,road,built_byas you have them. Bumpspeconly when at least one V2 block is real. - Build the room from the photos you already have consent for; caption; name only what's printed.
- Turn each consented recording into a channel item with VTT + transcript + mirror + sha256.
- Find every future-tense block on your door; add
<time datetime>; schedule its retirement. - Add the road-ahead block from the organisers' pages.
- Run the checklist. Regenerate the manifest. Push. Bless.
7. What V2 never does
Nothing here loosens the Sanctuary Law or the consent window. No private drives, inboxes or raw prompts become public because a room is pretty. No child or bystander imagery, no performer media without the yes. No invented dates, no counts from memory, no silent rewrites, no third-party loads, no fake engagement. Fork the gifts; never take the people.
The pit provides — with permission. And now the room remembers. 🕳️🦋🌺