Add OpenSong spec: a song as plain-text blocks a generator takes (#194)

TITLE / STYLE / EXCLUDE STYLES / LYRICS label blocks with [Section - direction]
tags, no Markdown (Suno reads plain text only). Kept beside the audio as the
same name with .txt, album lyrics.txt with ==== dividers, one-way mapping to
ID3/Vorbis tags. Example is track 002 of Þrøngva, When the Ravens Lied.

Co-authored-by: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

apps/logicsrc-web/src/app/opensong/page.tsx

@@ -0,0 +1,208 @@
+import Link from "next/link";
+import type { ReactNode } from "react";
+import type { Metadata } from "next";
+import { SiteShell } from "@/components/site-shell";
+import { mono, pre, table, td, th } from "../openontology/ui";
+
+export const metadata: Metadata = {
+  title: "OpenSong · LogicSRC",
+  description:
+    "OpenSong is one plain-text file that is a song: TITLE, STYLE, EXCLUDE STYLES and LYRICS as labelled blocks that paste straight into a music generator, [Section - direction] tags in the lyrics, no Markdown. Kept beside the audio as the same name with .txt; ID3 tags are derived from it, never the reverse.",
+  alternates: { canonical: "/opensong" }
+};
+
+const EXAMPLE = `TITLE:
+Who Fired First
+
+STYLE:
+Nordic Viking metal fused with hip-hop, drop-D down-tuned heavy guitars, pounding war drums, tagelharpa and bone flute, male baritone half-rap lead, female contralto lead, massive mixed choir, 96 BPM, call and response
+
+EXCLUDE STYLES:
+autotune, EDM drop, lo-fi, comedy, spoken-word only, children's choir, country, reggae
+
+LYRICS:
+[Cold Open - four syncopated drop-D hits with gang shouts, then silence]
+WHO!
+FIRED!
+FIRST!
+
+[Verse 1 - male baritone rap, fast and percussive, confident flow]
+Smoke on the fjord and a horn in the dark,
+Two longhouses burning from a single spark.
+Your side says theirs and their side says yours,
+Both sides counting bodies on the frozen shores.
+
+[Stop - all instruments stop, one whispered word]
+Hold.
+
+[Chorus - full impact, male and female trading lines, choir shouts, gang vocals]
+Who fired first?
+Nobody saw!
+Who fired first?
+Written in law!`;
+
+const RULES: Array<[string, string]> = [
+  ["Plain text", "UTF-8, no markup of any kind. Generators do not render Markdown, so the format has none."],
+  ["Label lines", "A line on its own ending in a colon opens a block that runs to the next label. Matched without regard to case."],
+  ["Four labels are the song", "TITLE, STYLE, EXCLUDE STYLES, LYRICS: the generator's four fields. Style descriptors are kept in order, because order is emphasis."],
+  ["Other labels describe it", "ARTIST, ALBUM, TRACK, YEAR, LANGUAGE, MODEL, MADE BY, AUTHOR, AUDIO, NOTES. Unknown labels are kept. None of them is pasted."],
+  ["Bracketed tags open sections", "[Name - direction]. The name is normalised for matching (verse, chorus, bridge, outro); unknown names like Cold Open are kept. A tag with nothing under it is instrumental."],
+  ["Sung lines as written", "Capitals, punctuation and repeats reach the generator unchanged. A chorus sung three times is written three times."],
+  ["Tags for the generator, not the listener", "A lyrics view may drop the tags. A generator always gets the whole block."],
+  ["Albums", "NNN. Title.txt beside NNN. Title.mp3, plus an optional lyrics.txt with every song behind a ==== divider. The song file wins."]
+];
+
+const MAPPING: Array<[string, string]> = [
+  ["TITLE", "TIT2 / TITLE"],
+  ["ARTIST", "TPE1 / ARTIST"],
+  ["ALBUM", "TALB / ALBUM"],
+  ["TRACK", "TRCK / TRACKNUMBER"],
+  ["sung lines of LYRICS", "USLT / LYRICS"],
+  ["the whole file", "TXXX:OPENSONG / OPENSONG"]
+];
+
+const ABSENT: Array<[string, string]> = [
+  ["No Markdown", "Generators take plain text. A format they cannot take is a format nobody pastes."],
+  ["No required fields beyond the title", "A title and lyrics is a song. A title and a style is an instrumental."],
+  ["No style vocabulary", "Genres, instruments and moods are kept as written. Models change what they understand too often for a list."],
+  ["No timing, no chords", "Timestamps belong to the rendered audio (LRC does them). A chord chart is a different document."],
+  ["No JSON", "The structured view is derived and regenerated from the text on every read."]
+];
+
+export default function OpenSongPage(): ReactNode {
+  return (
+    <SiteShell active="OpenSong">
+      <div className="band">
+        <div className="section-head">
+          <p className="eyebrow">LogicSRC standards surface</p>
+          <h2>OpenSong</h2>
+          <p>
+            One plain-text file that is a song, in the blocks a music generator takes. Paste it in,
+            keep it beside the audio, and the song can be made again.
+          </p>
+        </div>
+        <p style={{ color: "#41505d" }}>
+          A generated song starts as four fields in a web form and ends as an audio file with none
+          of them attached. The style prompt, the exclusions and the section directions are gone
+          once the page closes. Markdown is no help: the generator reads a # as a word. What it
+          takes is plain text in labelled blocks with [Section] tags in the lyrics, so OpenSong
+          fixes those labels and keeps the file.
+        </p>
+        <p style={{ color: "#5b6b7a" }}>
+          Status: 0.1. Same rules as <Link href="/openrecipe">OpenRecipe.md</Link>: the file a
+          person writes is canonical, every rule degrades, the structured view is derived.
+        </p>
+      </div>
+
+      <div className="band">
+        <div className="section-head">
+          <h2>The shape</h2>
+          <p>Track 002 of Þrøngva, When the Ravens Lied, shortened. The full song is in the spec.</p>
+        </div>
+        <pre style={pre}>{EXAMPLE}</pre>
+      </div>
+
+      <div className="band">
+        <div className="section-head">
+          <h2>The eight rules</h2>
+          <p>Every one of them degrades rather than fails.</p>
+        </div>
+        <table style={table}>
+          <thead>
+            <tr>
+              <th style={th}>Rule</th>
+              <th style={th}>What it means</th>
+            </tr>
+          </thead>
+          <tbody>
+            {RULES.map(([rule, meaning], index) => (
+              <tr key={rule}>
+                <td style={td}>
+                  <strong>
+                    {index + 1}. {rule}
+                  </strong>
+                </td>
+                <td style={td}>{meaning}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+
+      <div className="band">
+        <div className="section-head">
+          <h2>Discovery</h2>
+          <p>
+            Next to the audio (<code style={mono}>002-who-fired-first.mp3</code> has{" "}
+            <code style={mono}>002-who-fired-first.txt</code>), a{" "}
+            <code style={mono}>{'<link rel="opensong">'}</code> on the track page, or a site index at{" "}
+            <code style={mono}>/.well-known/opensong.txt</code>, one URL per line. Served as{" "}
+            <code style={mono}>text/plain</code>.
+          </p>
+        </div>
+      </div>
+
+      <div className="band">
+        <div className="section-head">
+          <h2>ID3 and Vorbis tags, one way</h2>
+          <p>
+            Keep writing tags for players. Generate them from the text on every export. The text
+            file is the canonical copy, because tags have no place for the style or the directions.
+          </p>
+        </div>
+        <table style={table}>
+          <thead>
+            <tr>
+              <th style={th}>OpenSong</th>
+              <th style={th}>ID3v2 / Vorbis comment</th>
+            </tr>
+          </thead>
+          <tbody>
+            {MAPPING.map(([song, tag]) => (
+              <tr key={song}>
+                <td style={td}>{song}</td>
+                <td style={td}>
+                  <code style={mono}>{tag}</code>
+                </td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+
+      <div className="band">
+        <div className="section-head">
+          <h2>What is deliberately absent</h2>
+        </div>
+        <table style={table}>
+          <tbody>
+            {ABSENT.map(([what, why]) => (
+              <tr key={what}>
+                <td style={td}>
+                  <strong>{what}</strong>
+                </td>
+                <td style={td}>{why}</td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+
+      <div className="band">
+        <div className="section-head">
+          <h2>Where everything lives</h2>
+        </div>
+        <ul style={{ color: "#41505d", lineHeight: 1.9, paddingLeft: "1.1rem" }}>
+          <li>
+            <Link href="/docs/opensong">Specification</Link>: the shape, eight rules, albums,
+            discovery, the tag mapping
+          </li>
+          <li>
+            <Link href="/openrecipe">OpenRecipe.md</Link>, the same canonical-file idea for a recipe;{" "}
+            <Link href="/docs/openfile">OpenFile</Link>, the audio a song sits beside
+          </li>
+        </ul>
+      </div>
+    </SiteShell>
+  );
+}

apps/logicsrc-web/src/lib/specs.ts

@@ -95,6 +95,7 @@ export const FAMILIES: Family[] = [
       s("opensaas", "OpenSaaS", "One file a subscription service serves about the way in and the way out of every plan, for a person and for an agent"),
       s("openaffiliate", "OpenAffiliate", "One file a merchant serves about the commission it pays"),
       s("openrecipe", "OpenRecipe.md", "One Markdown file that is a recipe, with schema.org derived from it and never the reverse"),
+      s("opensong", "OpenSong", "One plain-text file that is a song: title, style, exclusions and lyrics as the blocks a generator takes, kept beside the audio"),
       s("openthreat", "OpenThreat", "One file a security tool serves about what it found in the open: public subjects only, secrets never located"),
       s("openrental", "OpenRental", "One file an operator serves about the agents and file swarms it rents out: members, metadata and rates through CoinPay", { landing: undefined, status: "draft" }),
       s("opensite", "OpenSite", "One record about a page or a site: the card a reader would draw, declared by the site or read from it, kept by an index"),