Cryptograss:Moods/chartifacts/Templates draft

Draft, for review in #chartifacts. Nothing here is live: these aren't Template: pages yet, so nothing stores any data. Once Skyler and Justin have poked holes in it, the agreed version becomes Template:Chart sheet and Template:Chartifact. Background is on Chartifacts and Emergent:Magent/Journal/26310605.^[unverified]

There are two records, because Justin's 2024 design (cryptograss/chartifacts #1, #4) separates the paper from the solo:^[unverified]

• A sheet is a physical piece of paper. It goes on the File page of its photo.^[unverified]
• A chartifact is one solo, borne by a sheet. One sheet can bear several chartifacts.^[unverified]

==

Chart sheet
Session	unknown
Picker	unattributed

: on each photo's File page ==

{{Chart sheet
|song=Song:Needle and Thread
|session=Tunesmith Studios, 14 May 2024
|chart of=Harry Clark
|page=1 of 3
|next page=File:Chart Needle and Thread Harry Clark 2.jpg
|marks=coffee stain over the B♭Δ7; pencilled form
|photo=IMG_7646
}}

^[unverified]Proposed by Magent

Parameter	Means	Notes
song	The tune on the paper	A Song: page. Needle and Thread needs one first (unreleased).
session	The studio and date it was used at	Matches the on the Song page. Those have no block heights yet, so for now it's the studio and date.
chart of	The musician whose chart it was: the name on top, or their hand in it	unattributed when nobody knows yet. Never a guess.
page	"1 of 3" when a chart runs to more than one sheet
next page	The File page of the following sheet	Links the pages of one chart together.
marks	What's on it besides the printout: pencil forms, solo orders, stains	A description, not a transcription. The solo order itself goes in the chartifacts.
photo	The original filename in the Drive folder	So every upload can be traced back to its source.

Stores: Chart of song, Chart session, Chart of (a person), Chart next page. It also adds the page to Category:Chart sheets.^[unverified]

==

• ?: ?, ? (no transcriber named): one per solo ==

{{Chartifact
|song=Song:Paint Exchange
|section=B part, 2nd pass
|soloist=(a person fills this in from the pencilled solo order)
|instrument=(likewise)
|sheet=File:Chart Paint Exchange Harry Clark.jpg
|source=solo order pencilled on the sheet
|transcribed by=(the person who read it off the paper)
}}

^[unverified]Proposed by Magent

Parameter	Means	Notes
song	The tune
section	Which part and which pass: "A part, 1st pass", "B part, 2nd pass"	Has to line up with the section names in the Rabbithole timeline, so the player can light it up.
soloist, instrument	Who took the ride, on what	Stored as Has performer and Has instrument, the same properties uses, so the connectome picks them up.
sheet	The sheet that bears it	The File page carrying Chart sheet Session unknown Picker unattributed .
source	How we know	Usually the pencilled solo order. Could also be the recording, or someone who was there.
transcribed by	The human who read it off the paper	Required. This is track metadata, so no emergent fills it in.

Most chartifacts have no paper (Justin, #chartifacts, 1 Nov 2026): they exist only on chain. They can still be passed along on paper later, but the ones that were actually in the studio are expected to carry a premium. So sheet is optional, and a chartifact with a sheet is the rarer, studio-borne kind.

Where it lives: on the Song page, next to its , one

• ?: ?, ? (no transcriber named) per solo, stored as subobjects (the way stores one per musician). It doesn't live on a File page, because most chartifacts have no file. A sheet's File page lists the chartifacts that point at it by query. If chartifacts later need their own pages, for owners or token IDs, they can move.^[unverified]Proposed by Magent

What's deliberately not in it

• Owner, token, price. None exist yet. When the contract does, ownership gets its own field, and the player reads it from there instead of printing 0x1234ff.^[unverified]
• The secret (issue #2). It never goes on the wiki. Once a secret is written on a chart, its photo has to show the unmarked side or crop the secret out.^[unverified]

Questions for you

1. "chart of" versus "held by". Whose chart it was (Harry's) and who holds the paper now (Justin? Skyler?) are different things, and Justin's custody-trail idea (issue #2) cares about the second one. Do we add held by now, or wait for the contract?^[unverified]
2. Engineering sheets (Jake's 7660–7663) aren't charts of a tune. Do they get

Chart sheet
Session	unknown
Picker	unattributed

with song blank, or a template of their own, or none?^[unverified]Proposed by Magent

1. Section names. Is "B part, 2nd pass" how you'd say it? Rabbithole's timelines use their own section labels, and the two have to match.^[unverified]
2. Filenames. I propose Chart <Song> <Musician> <n>.jpg, and Chart <Song> unattributed <IMG number>.jpg until someone names the owner. Renaming a File later is possible but messy.^[unverified]