Cryptograss:Moods/pickipedia-and-rabbithole/todo

What the people in this Mood have left each other to do. Kept by whoever notices; mark an item done: true rather than deleting it, so the next person can see it was finished and not merely dropped.

Compacted 2026-10-19. The live list is short and it is nearly all one thing: three pull requests and one deploy. Everything built on 17 and 18 October exists only as unmerged branches, so none of it is visible to anybody yet.

The goal, in Skyler's words: get Rabbithole working and playing live on PickiPedia, with a few songs having part cards and the highlights looking clean. The audience: IBMA, where Justin's read is that nobody sits through a whole song — so one track that lights up beats eleven that play in silence.

The architecture, settled 2026-10-18: Rabbithole is a dock along the bottom of PickiPedia. The shell hosts the wiki, because whatever persists holds the player and whatever swaps holds the article — and if the wiki hosted instead, every link would reload the page and the music would stop. A listen button inside the shell opens the dock and plays, rather than navigating.

- task: Merge rabbithole#2, then run the playbook
  who: justin
  kind: merge
  link: https://github.com/cryptograss/rabbithole/pull/2
  note: >
    Twenty-two commits, the bottom bar and everything under it. Merging is not
    deploying: the rabbithole-shell role has no cron and no webhook, so somebody
    runs maybelle/scripts/deploy-pickipedia.sh on maybelle with the vault
    password on stdin. It is the whole pickipedia-vps playbook, not a
    rabbithole-only deploy, and it refuses if maybelle-config production is
    behind main (checked 2026-10-18: it is not).
    Production has served a shell dated 1 May 2026 all week — the old 320px left
    sidebar. Every listen button on all eleven song pages opens it. That is why
    Skyler kept seeing the sidebar; nothing is wrong with the buttons.
  done: false

- task: Merge rabbithole#3 — tests, the lost scene half, the pane, trails
  who: justin
  kind: merge
  link: https://github.com/cryptograss/rabbithole/pull/3
  note: >
    Based on bottom-bar-layout, so it merges after #2 and shows only its own
    commits. 36 tests where the repo had vitest configured and none at all.
    Carries: the half of 2e83c1a that puts the scene on the card; CSS for
    cooldown, harmony and rhythm plus pickup-rise, has-rabbit and engineer-card,
    all left behind in arthel; a README table naming which file is the product
    and which are stale copies; the pane loading the wiki's real stylesheets in
    MonoBook rather than Vector, which is what "the backdrop looks super broken"
    was; click a part to seek there; three pane chrome modes behind a switch;
    the listen button playing in the dock instead of navigating; a queue, with
    the track-end hook the player has always called into nothing; and trails.
  done: false

- task: Merge pickipedia#148 — the rabbit chases the carrot
  who: justin
  kind: merge
  link: https://github.com/cryptograss/pickipedia/pull/148
  note: >
    The listen button is already live on all eleven song pages: the template
    carries inline styles, so the shape did not wait on a deploy. This adds what
    inline styles cannot express, hover and the keyframes. Same stylesheet the
    pane now loads, so one rule set covers the wiki and the player.
    Also wants, before it merges: the button's position is a guessed negative
    margin (-5.9em) rather than a rule anchored to the heading. It looks right
    on a desktop today and will drift on a narrow screen or a wrapped title.
  done: false

- task: Merge pickipedia-mcp#33 and restart the MCP server
  who: justin
  kind: merge
  link: https://github.com/cryptograss/pickipedia-mcp/pull/33
  note: >
    A marker line is its own paragraph, so it stops eating the prose above it.
    Cryptograss/Horseshoe Crab has a verified template directly under line 3;
    the middleware merged the two, the join looked verified so it went out
    verbatim, and the wiki's gate refused every bot edit to that page. Needs a
    restart as well as a merge — the server loads its bundle at start.
  done: false

- task: Look at it on a phone
  who: skyler
  kind: review
  note: >
    Two things were found at 390px on 2026-10-19 before Skyler looked, and both
    are patched on their branches, so the phone check is now about what is left
    rather than about these. (1) The listen stack lands on top of the page title
    and the green Listen button is not readable; the negative margin assumed a
    short title and a wide column. Cancelled below 720px in pickipedia#148.
    (2) The dock measures 1741px inside a 390px screen with overflow-x hidden,
    so the song select, Edit Timeline, every musician card and the collapse
    button are simply gone. Below 720px the bar now scrolls sideways with the
    header pinned left -- awkward, not unusable; a real small-screen dock is
    still owed. Neither patch is deployed, so production still shows the old
    behaviour. Preview, while the container lives:
    http://hunter.cryptograss.live:14003/rabbithole/pickipedia-demo.html
  done: false

- task: Confirm the iPhone plays clean with the Web Audio graph bypassed
  who: skyler
  kind: review
  link: http://hunter.cryptograss.live:14003/rabbithole/pickipedia-demo.html
  note: >
    Found 2026-10-19: Webamp's createMediaElementSource is what warps the
    audio on iOS. Player 1 of the A/B page (ogg, plain audio element) was
    clean and player 3 (the same ogg through a Web Audio graph) warped --
    same file, decoder, connection and device, one difference. On iOS the
    graph is now not built at all; the element plays natively. The cost on
    iPhones is the equaliser and the visualiser doing nothing and stereo
    balance fixed at centre; volume is mirrored onto the element so the
    slider still works. ?webaudio=on gets the old behaviour back for
    comparison on the same phone. What is wanted: does August play clean
    through the whole song now, and does the volume slider still move it.
    Confirmed by Skyler on 2026-10-19: August played the whole way through
    with no warping. The iPhone audio is fixed.
  done: true

- task: Which of the four players warps -- the Web Audio graph was the last suspect
  who: skyler
  kind: review
  done: true
  note: >
    2026-10-19, player 1 of 4 reported clean: the Ogg played plainly through a
    bare audio element is perfect on the iPhone. That clears the file, the
    gateway, the network and Safari's Vorbis decoder all at once -- every
    explanation that does not involve our own code. What is left is the Web
    Audio graph: Webamp routes every track through
    createMediaElementSource, which has a long history of trouble on iOS
    Safari. Players 3 and 4 on the A/B page are that same route with nothing
    else attached; 3 is the one that decides it. If 3 warps, the fix is to
    keep iOS off the graph -- the element plays natively and we lose the EQ
    and the visualiser on that platform, which is a fair trade.
  done: true

- task: Was the Ogg Vorbis decode what warps the audio on an iPhone
  who: skyler
  kind: review
  done: true
  note: >
    2026-10-19, after the readout came back clean: no stall, no drift, rate 1,
    and the audio still sounds warped. currentTime follows the media element's
    own timeline, so it can keep perfect time while what reaches the speaker
    is mangled -- which clears the player of stalling and points at the decode
    or at the Web Audio graph Webamp routes through. Ogg Vorbis is the suspect
    to eliminate first: Safari learned it only recently, and it is what we
    serve by default because it is a quarter the size of the flac beside it.
    ?enc=flac and ?enc=ogg force one without changing any code. If flac is
    clean, prefer flac on Safari and the thing is done. It was not the
    decode: the ogg plays clean through a bare audio element on the phone.
  done: true

- task: Audio stutters on an iPhone, and nothing on this end reproduces it
  who: skyler
  kind: review
  link: http://hunter.cryptograss.live:14003/rabbithole/pickipedia-demo.html?rhdiag=1
  note: >
    Reported 2026-10-19: audio plays but speeds up and slows down, most
    audibly at the A after the first B of August -- t=50, where the solo
    passes to Harry Clark. Ruled out by measurement rather than by guessing:
    the 100ms display loop costs 0.2ms median and 2.8ms at worst over 120
    ticks; the IPFS gateway returns the whole 4MB ogg in 1.9s and serves
    256KB ranges at a steady 215KB/s against the 24KB/s the song needs;
    across t=30 to t=66 audio time tracks wall clock to within 0.00s with no
    waiting or stalled events and zero long tasks. Turning auto-switch off
    changed nothing he hears, so the pane rebuild is not it either. So the
    measurement has to happen on the phone: ?rhdiag=1 pins a readout to the
    top of the page showing drift, buffer, playback rate and the last stall
    events. What is wanted back is the readout at the moment it sounds wrong.
    Answered: the readout stayed clean through the warp, which is what sent
    the hunt to the Web Audio graph, where it ended.
  done: true

- task: Confirm an iPhone can actually decode what we serve
  who: skyler
  kind: review
  note: >
    The four built-in songs pointed at /audio/August.flac and friends, which
    nothing has ever served -- 404 on preview and production both. That is why
    the dropdown played silence on 2026-10-19; it was never a mobile bug. They
    now resolve through the Release page like everything else, and the browser
    picks the encoding: ogg if canPlayType says it can, flac otherwise. Safari
    was unable to decode Ogg Vorbis for most of its life, so the open question
    is only answerable on a real iPhone -- does it play, and is the title bar
    showing a duration rather than blank parentheses.
    Answered 2026-10-19: it plays, with a real duration, and the ogg decodes
    clean through a bare audio element. The decoder was never the problem.
  done: true

- task: The dock needs a real small-screen layout, not sideways scrolling
  who: magent
  kind: edit
  note: >
    The 2026-10-19 patch makes the bar scrollable so nothing is lost. It does
    not make it good. A phone wants the player and one row of whatever is
    playing, with the ensemble and the parts behind a tap -- or the dock
    collapsed by default and opened on demand. Decide the shape first.
  done: false

- task: Which chrome should the pane wear
  who: skyler
  kind: decision
  note: >
    Three modes are built and switchable from a select in the pane: content, a
    header we own with a working search, or MonoBook's full chrome fetched from
    the real page. In skin mode the search box is furniture and says so — it
    cannot run scripts. Skin also doubles the pane's weight and adds a
    round-trip per page, which the auto-switch makes often.
  done: false

- task: Which one is THE play button
  who: skyler
  kind: decision
  note: >
    Three in the bar: webamp's transport, the carrot, and .mini-player-btn.
    Open since 2026-10-16. Now sharper: the dock's listen button is a fourth
    way to start audio, and a visitor met all four at once.
  done: false

- task: Timelines — nineteen of twenty-one tracks are empty
  who: skyler
  kind: edit
  note: >
    August and Paint Exchange have real ones. Everything else plays with a blank
    bar. Hand-edit with the player's Edit Timeline button, which is already the
    tool. Worth knowing: a sub-moment's time key inside a section is read as an
    absolute time, not an offset, so section1 with a key of 3 lands at 3 seconds
    — before its own section. Pinned by a test, not endorsed; ask Justin whether
    that is intended before charting around it.
  done: false

- task: Metadata for some vocal songs
  who: magent
  kind: edit
  note: >
    Justin, by voice, 2026-10-18: everything charted so far is instrumental, so
    we have not found out what Rabbithole does with words. Also the highest
    leverage thing on this list for trails, which are limited by coverage and
    not by the algorithm — 20 songs, nearly all ours.
  done: false

- task: Document the metadata format
  who: magent
  kind: edit
  note: Justin asked for it by voice, 2026-10-18. Nothing written yet.
  done: false

- task: Write up the URL question
  who: magent
  kind: review
  note: >
    Justin, by voice: the article is the primary URL and what is playing is a
    second axis, and he does not know how they compose. The complication he had
    not hit: the auto-switch rewrites the article for you, so the URL you would
    share is being changed by the music. Share probably has to mean something
    explicit rather than whatever the address bar says.
    A trail is the same object seen from the other end — share-this-trail and
    find-me-a-trail are one feature, so they want solving together.
  done: false

- task: Unwrap the cover image on the song pages
  who: magent
  kind: edit
  note: >
    Each of the eleven wraps its cover in Bot_proposes. An image is not a claim,
    and when it fails to render you get an empty bordered box with a lone
    [unverified] marker, which is what the odd box at the top of each page is.
  done: false

- task: The listen button on the other ten song pages
  who: magent
  kind: edit
  note: >
    August has it in its new place, above the infobox so it floats to the top
    right. The other ten still have it mid-page. Waiting on the phone check and
    on #148, since the position is a magic number until then.
  done: false

- task: Paste one line into Horseshoe Crab Day 9
  who: anyone
  kind: edit
  link: https://pickipedia.xyz/wiki/Template:Horseshoe_Crab_Day_9_paste
  note: >
    One bullet, the Webamp vendoring of 11 October. Everything else moved to
    Cryptograss/Jellyfish. The bot cannot save that page until mcp#33 ships.
  done: false

- task: Write the four people Rabbithole would strand
  who: anyone
  kind: edit
  note: >
    David Grier, Ice Quilitz, Jeff Fehlauer, Luna Lavender. Grier now appears in
    trails as a hop, so he is a dead end in the middle of a feature rather than
    at the end of a click.
  done: false

- task: Decide the remaster / remix / overdub line
  who: justin
  kind: decision
  link: https://github.com/cryptograss/pickipedia/issues/144
  note: Blocks the automatic ensemble path. The melodica overdub is the sharp case.
  done: false

- task: Special:Categories is reporting numbers that are not true
  who: justin
  kind: deploy
  note: Leaderboards claims 8,265 members and has 4. maintenance/recountCategories.php.
  done: false

- task: Delete Template:Studio track and Template:Studio track/testcases
  who: justin
  kind: edit
  note: The wiki's only script error. The bot cannot delete.
  done: false

- task: Look at the front page draft and say whether to adopt it
  who: justin
  kind: review
  link: https://pickipedia.xyz/wiki/Template:Main_Page_draft/preview
  note: Main Page untouched since April, read 530,000 times, opens on half a screen of nothing.
  done: false

- task: Merge 9f83ab7 and c13f2e8 — the two most-wanted tools
  who: justin
  kind: merge
  link: https://github.com/magent-cryptograss/pickipedia/commits/production
  done: false

- task: The infobox asks for instrument icons that do not exist
  who: magent
  kind: edit
  note: "Template:ThinkingEntityInfo builds a File: link without asking whether the icon exists."
  done: false

- task: Finish populating {{Song}} on the twelve pages outside 4masks
  who: magent
  kind: edit
  done: false

- task: The metadata editor no longer works inside the pane
  who: magent
  kind: review
  note: Injected HTML does not run scripts, so the editor cannot boot in the pane. Worth a decision rather than a silent loss.
  done: false

- task: Release the held podcast import — 240 pages would change, limit is 50
  who: magent
  kind: review
  link: https://pickipedia.xyz/status/podcast-import.txt
  done: false

- task: Self-host packery, js-yaml and the Google Fonts faces
  who: magent
  kind: edit
  note: Same class of dependency that killed the player once. Webamp is vendored; these are not.
  done: false

- task: Drop the four hard-coded demo songs
  who: magent
  kind: edit
  note: audioFile "/audio/August.flac" and friends, 404 everywhere, and the four arthel YAML rabbithole blocks that feed them.
  done: false

- task: Masks has no session data anywhere
  who: anyone
  kind: edit
  link: https://pickipedia.xyz/wiki/Song%3AMasks
  note: The only one of eleven tracks with no ensemble recorded. Somebody who was there can fix it in a sentence.
  done: false

- task: Settled, 16 to 18 October
  who: anyone
  kind: review
  note: >
    Written up in full at Cryptograss/Jellyfish. In short: the bottom bar built
    out with Sky calling each move; eleven 4masks song pages; Template:Listen in
    Rabbithole on all of them, now a button with a queue and a trail beside it;
    the iframe replaced by a same-origin fetch into a shadow root; the pane
    wearing the wiki's own stylesheets; clickable part cards that seek; three
    chrome modes; a working queue and the track-end hook that had never been
    defined; and trails — the search over who played with whom, weighted so it
    routes around the hub rather than answering every question with Justin.
    Found along the way: production five months stale, three shells in one repo
    with the URL route pointing at the wrong one, arthel's copy of the player
    thirteen months behind, half of a 2025 commit missing, and a middleware bug
    that had made one page unwritable for its whole life.
  done: true